VirtualBox

source: vbox/trunk/src/VBox/Devices/USB/DrvVUSBRootHub.cpp@ 86405

Last change on this file since 86405 was 83617, checked in by vboxsync, 5 years ago

VUSB: Avoid too large URBs (see bugref:9697).
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 73.9 KB
Line 
1/* $Id: DrvVUSBRootHub.cpp 83617 2020-04-08 09:21:02Z vboxsync $ */
2/** @file
3 * Virtual USB - Root Hub Driver.
4 */
5
6/*
7 * Copyright (C) 2005-2020 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18
19/** @page pg_dev_vusb VUSB - Virtual USB
20 *
21 * @todo read thru this and correct typos. Merge with old docs.
22 *
23 *
24 * The Virtual USB component glues USB devices and host controllers together.
25 * The VUSB takes the form of a PDM driver which is attached to the HCI. USB
26 * devices are created by, attached to, and managed by the VUSB roothub. The
27 * VUSB also exposes an interface which is used by Main to attach and detach
28 * proxied USB devices.
29 *
30 *
31 * @section sec_dev_vusb_urb The Life of an URB
32 *
33 * The URB is created when the HCI calls the roothub (VUSB) method pfnNewUrb.
34 * VUSB has a pool of URBs, if no free URBs are available a new one is
35 * allocated. The returned URB starts life in the ALLOCATED state and all
36 * fields are initialized with sensible defaults.
37 *
38 * The HCI then copies any request data into the URB if it's an host2dev
39 * transfer. It then submits the URB by calling the pfnSubmitUrb roothub
40 * method.
41 *
42 * pfnSubmitUrb will start by checking if it knows the device address, and if
43 * it doesn't the URB is completed with a device-not-ready error. When the
44 * device address is known to it, action is taken based on the kind of
45 * transfer it is. There are four kinds of transfers: 1. control, 2. bulk,
46 * 3. interrupt, and 4. isochronous. In either case something eventually ends
47 * up being submitted to the device.
48 *
49 *
50 * If an URB fails submitting, may or may not be completed. This depends on
51 * heuristics in some cases and on the kind of failure in others. If
52 * pfnSubmitUrb returns a failure, the HCI should retry submitting it at a
53 * later time. If pfnSubmitUrb returns success the URB is submitted, and it
54 * can even been completed.
55 *
56 * The URB is in the IN_FLIGHT state from the time it's successfully submitted
57 * and till it's reaped or cancelled.
58 *
59 * When an URB transfer or in some case submit failure occurs, the pfnXferError
60 * callback of the HCI is consulted about what to do. If pfnXferError indicates
61 * that the URB should be retried, pfnSubmitUrb will fail. If it indicates that
62 * it should fail, the URB will be completed.
63 *
64 * Completing an URB means that the URB status is set and the HCI
65 * pfnXferCompletion callback is invoked with the URB. The HCI is the supposed
66 * to report the transfer status to the guest OS. After completion the URB
67 * is freed and returned to the pool, unless it was cancelled. If it was
68 * cancelled it will have to await reaping before it's actually freed.
69 *
70 *
71 * @subsection subsec_dev_vusb_urb_ctrl Control
72 *
73 * The control transfer is the most complex one, from VUSB's point of view,
74 * with its three stages and being bi-directional. A control transfer starts
75 * with a SETUP packet containing the request description and two basic
76 * parameters. It is followed by zero or more DATA packets which either picks
77 * up incoming data (dev2host) or supplies the request data (host2dev). This
78 * can then be followed by a STATUS packet which gets the status of the whole
79 * transfer.
80 *
81 * What makes the control transfer complicated is that for a host2dev request
82 * the URB is assembled from the SETUP and DATA stage, and for a dev2host
83 * request the returned data must be kept around for the DATA stage. For both
84 * transfer directions the status of the transfer has to be kept around for
85 * the STATUS stage.
86 *
87 * To complicate matters further, VUSB must intercept and in some cases emulate
88 * some of the standard requests in order to keep the virtual device state
89 * correct and provide the correct virtualization of a device.
90 *
91 * @subsection subsec_dev_vusb_urb_bulk Bulk and Interrupt
92 *
93 * The bulk and interrupt transfer types are relativly simple compared to the
94 * control transfer. VUSB is not inspecting the request content or anything,
95 * but passes it down the device.
96 *
97 * @subsection subsec_dev_vusb_urb_isoc Isochronous
98 *
99 * This kind of transfers hasn't yet been implemented.
100 *
101 */
102
103
104/** @page pg_dev_vusb_old VUSB - Virtual USB Core
105 *
106 * The virtual USB core is controlled by the roothub and the underlying HCI
107 * emulator, it is responsible for device addressing, managing configurations,
108 * interfaces and endpoints, assembling and splitting multi-part control
109 * messages and in general acts as a middle layer between the USB device
110 * emulation code and USB HCI emulation code.
111 *
112 * All USB devices are represented by a struct vusb_dev. This structure
113 * contains things like the device state, device address, all the configuration
114 * descriptors, the currently selected configuration and a mapping between
115 * endpoint addresses and endpoint descriptors.
116 *
117 * Each vusb_dev also has a pointer to a vusb_dev_ops structure which serves as
118 * the virtual method table and includes a virtual constructor and destructor.
119 * After a vusb_dev is created it may be attached to a hub device such as a
120 * roothub (using vusbHubAttach). Although each hub structure has cPorts
121 * and cDevices fields, it is the responsibility of the hub device to allocate
122 * a free port for the new device.
123 *
124 * Devices can chose one of two interfaces for dealing with requests, the
125 * synchronous interface or the asynchronous interface. The synchronous
126 * interface is much simpler and ought to be used for devices which are
127 * unlikely to sleep for long periods in order to serve requests. The
128 * asynchronous interface on the other hand is more difficult to use but is
129 * useful for the USB proxy or if one were to write a mass storage device
130 * emulator. Currently the synchronous interface only supports control and bulk
131 * endpoints and is no longer used by anything.
132 *
133 * In order to use the asynchronous interface, the queue_urb, cancel_urb and
134 * pfnUrbReap fields must be set in the devices vusb_dev_ops structure. The
135 * queue_urb method is used to submit a request to a device without blocking,
136 * it returns 1 if successful and 0 on any kind of failure. A successfully
137 * queued URB is completed when the pfnUrbReap method returns it. Each function
138 * address is reference counted so that pfnUrbReap will only be called if there
139 * are URBs outstanding. For a roothub to reap an URB from any one of it's
140 * devices, the vusbRhReapAsyncUrbs() function is used.
141 *
142 * There are four types of messages an URB may contain:
143 * -# Control - represents a single packet of a multi-packet control
144 * transfer, these are only really used by the host controller to
145 * submit the parts to the usb core.
146 * -# Message - the usb core assembles multiple control transfers in
147 * to single message transfers. In this case the data buffer
148 * contains the setup packet in little endian followed by the full
149 * buffer. In the case of an host-to-device control message, the
150 * message packet is created when the STATUS transfer is seen. In
151 * the case of device-to-host messages, the message packet is
152 * created after the SETUP transfer is seen. Also, certain control
153 * requests never go the real device and get handled synchronously.
154 * -# Bulk - Currently the only endpoint type that does error checking
155 * and endpoint halting.
156 * -# Interrupt - The only non-periodic type supported.
157 *
158 * Hubs are special cases of devices, they have a number of downstream ports
159 * that other devices can be attached to and removed from.
160 *
161 * After a device has been attached (vusbHubAttach):
162 * -# The hub attach method is called, which sends a hub status
163 * change message to the OS.
164 * -# The OS resets the device, and it appears on the default
165 * address with it's config 0 selected (a pseudo-config that
166 * contains only 1 interface with 1 endpoint - the default
167 * message pipe).
168 * -# The OS assigns the device a new address and selects an
169 * appropriate config.
170 * -# The device is ready.
171 *
172 * After a device has been detached (vusbDevDetach):
173 * -# All pending URBs are cancelled.
174 * -# The devices address is unassigned.
175 * -# The hub detach method is called which signals the OS
176 * of the status change.
177 * -# The OS unlinks the ED's for that device.
178 *
179 * A device can also request detachment from within its own methods by
180 * calling vusbDevUnplugged().
181 *
182 * Roothubs are responsible for driving the whole system, they are special
183 * cases of hubs and as such implement attach and detach methods, each one
184 * is described by a struct vusb_roothub. Once a roothub has submitted an
185 * URB to the USB core, a number of callbacks to the roothub are required
186 * for when the URB completes, since the roothub typically wants to inform
187 * the OS when transfers are completed.
188 *
189 * There are four callbacks to be concerned with:
190 * -# prepare - This is called after the URB is successfully queued.
191 * -# completion - This is called after the URB completed.
192 * -# error - This is called if the URB errored, some systems have
193 * automatic resubmission of failed requests, so this callback
194 * should keep track of the error count and return 1 if the count
195 * is above the number of allowed resubmissions.
196 * -# halt_ep - This is called after errors on bulk pipes in order
197 * to halt the pipe.
198 *
199 */
200
201
202/*********************************************************************************************************************************
203* Header Files *
204*********************************************************************************************************************************/
205#define LOG_GROUP LOG_GROUP_DRV_VUSB
206#include <VBox/vmm/pdm.h>
207#include <VBox/vmm/vmapi.h>
208#include <VBox/err.h>
209#include <iprt/alloc.h>
210#include <VBox/log.h>
211#include <iprt/time.h>
212#include <iprt/thread.h>
213#include <iprt/semaphore.h>
214#include <iprt/string.h>
215#include <iprt/assert.h>
216#include <iprt/asm.h>
217#include <iprt/uuid.h>
218#include "VUSBInternal.h"
219#include "VBoxDD.h"
220
221
222
223/**
224 * Attaches a device to a specific hub.
225 *
226 * This function is called by the vusb_add_device() and vusbRhAttachDevice().
227 *
228 * @returns VBox status code.
229 * @param pHub The hub to attach it to.
230 * @param pDev The device to attach.
231 * @thread EMT
232 */
233static int vusbHubAttach(PVUSBHUB pHub, PVUSBDEV pDev)
234{
235 LogFlow(("vusbHubAttach: pHub=%p[%s] pDev=%p[%s]\n", pHub, pHub->pszName, pDev, pDev->pUsbIns->pszName));
236 return vusbDevAttach(pDev, pHub);
237}
238
239
240/* -=-=-=-=-=- PDMUSBHUBREG methods -=-=-=-=-=- */
241
242/** @interface_method_impl{PDMUSBHUBREG,pfnAttachDevice} */
243static DECLCALLBACK(int) vusbPDMHubAttachDevice(PPDMDRVINS pDrvIns, PPDMUSBINS pUsbIns, const char *pszCaptureFilename, uint32_t *piPort)
244{
245 PVUSBROOTHUB pThis = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
246
247 /*
248 * Allocate a new VUSB device and initialize it.
249 */
250 PVUSBDEV pDev = (PVUSBDEV)RTMemAllocZ(sizeof(*pDev));
251 AssertReturn(pDev, VERR_NO_MEMORY);
252 int rc = vusbDevInit(pDev, pUsbIns, pszCaptureFilename);
253 if (RT_SUCCESS(rc))
254 {
255 pUsbIns->pvVUsbDev2 = pDev;
256 rc = vusbHubAttach(&pThis->Hub, pDev);
257 if (RT_SUCCESS(rc))
258 {
259 *piPort = UINT32_MAX; /// @todo implement piPort
260 return rc;
261 }
262
263 RTMemFree(pDev->paIfStates);
264 pUsbIns->pvVUsbDev2 = NULL;
265 }
266 vusbDevRelease(pDev);
267 return rc;
268}
269
270
271/** @interface_method_impl{PDMUSBHUBREG,pfnDetachDevice} */
272static DECLCALLBACK(int) vusbPDMHubDetachDevice(PPDMDRVINS pDrvIns, PPDMUSBINS pUsbIns, uint32_t iPort)
273{
274 RT_NOREF(pDrvIns, iPort);
275 PVUSBDEV pDev = (PVUSBDEV)pUsbIns->pvVUsbDev2;
276 Assert(pDev);
277
278 /*
279 * Deal with pending async reset.
280 * (anything but reset)
281 */
282 vusbDevSetStateCmp(pDev, VUSB_DEVICE_STATE_DEFAULT, VUSB_DEVICE_STATE_RESET);
283
284 /*
285 * Detach and free resources.
286 */
287 if (pDev->pHub)
288 vusbDevDetach(pDev);
289
290 vusbDevRelease(pDev);
291 return VINF_SUCCESS;
292}
293
294/**
295 * The hub registration structure.
296 */
297static const PDMUSBHUBREG g_vusbHubReg =
298{
299 PDM_USBHUBREG_VERSION,
300 vusbPDMHubAttachDevice,
301 vusbPDMHubDetachDevice,
302 PDM_USBHUBREG_VERSION
303};
304
305
306/* -=-=-=-=-=- VUSBIROOTHUBCONNECTOR methods -=-=-=-=-=- */
307
308
309/**
310 * Finds an device attached to a roothub by it's address.
311 *
312 * @returns Pointer to the device.
313 * @returns NULL if not found.
314 * @param pRh Pointer to the root hub.
315 * @param Address The device address.
316 */
317static PVUSBDEV vusbRhFindDevByAddress(PVUSBROOTHUB pRh, uint8_t Address)
318{
319 unsigned iHash = vusbHashAddress(Address);
320 PVUSBDEV pDev = NULL;
321
322 RTCritSectEnter(&pRh->CritSectDevices);
323 for (PVUSBDEV pCur = pRh->apAddrHash[iHash]; pCur; pCur = pCur->pNextHash)
324 if (pCur->u8Address == Address)
325 {
326 pDev = pCur;
327 break;
328 }
329
330 if (pDev)
331 vusbDevRetain(pDev);
332 RTCritSectLeave(&pRh->CritSectDevices);
333 return pDev;
334}
335
336
337/**
338 * Callback for freeing an URB.
339 * @param pUrb The URB to free.
340 */
341static DECLCALLBACK(void) vusbRhFreeUrb(PVUSBURB pUrb)
342{
343 /*
344 * Assert sanity.
345 */
346 vusbUrbAssert(pUrb);
347 PVUSBROOTHUB pRh = (PVUSBROOTHUB)pUrb->pVUsb->pvFreeCtx;
348 Assert(pRh);
349
350 Assert(pUrb->enmState != VUSBURBSTATE_FREE);
351
352 /*
353 * Free the URB description (logging builds only).
354 */
355 if (pUrb->pszDesc)
356 {
357 RTStrFree(pUrb->pszDesc);
358 pUrb->pszDesc = NULL;
359 }
360
361 /* The URB comes from the roothub if there is no device (invalid address). */
362 if (pUrb->pVUsb->pDev)
363 {
364 PVUSBDEV pDev = pUrb->pVUsb->pDev;
365
366 vusbUrbPoolFree(&pUrb->pVUsb->pDev->UrbPool, pUrb);
367 vusbDevRelease(pDev);
368 }
369 else
370 vusbUrbPoolFree(&pRh->Hub.Dev.UrbPool, pUrb);
371}
372
373
374/**
375 * Worker routine for vusbRhConnNewUrb().
376 */
377static PVUSBURB vusbRhNewUrb(PVUSBROOTHUB pRh, uint8_t DstAddress, PVUSBDEV pDev, VUSBXFERTYPE enmType,
378 VUSBDIRECTION enmDir, uint32_t cbData, uint32_t cTds, const char *pszTag)
379{
380 RT_NOREF(pszTag);
381 PVUSBURBPOOL pUrbPool = &pRh->Hub.Dev.UrbPool;
382
383 if (RT_UNLIKELY(cbData > (32 * _1M)))
384 {
385 LogFunc(("Bad URB size (%u)!\n", cbData));
386 return NULL;
387 }
388
389 if (!pDev)
390 pDev = vusbRhFindDevByAddress(pRh, DstAddress);
391 else
392 vusbDevRetain(pDev);
393
394 if (pDev)
395 pUrbPool = &pDev->UrbPool;
396
397 PVUSBURB pUrb = vusbUrbPoolAlloc(pUrbPool, enmType, enmDir, cbData,
398 pRh->cbHci, pRh->cbHciTd, cTds);
399 if (RT_LIKELY(pUrb))
400 {
401 pUrb->pVUsb->pvFreeCtx = pRh;
402 pUrb->pVUsb->pfnFree = vusbRhFreeUrb;
403 pUrb->DstAddress = DstAddress;
404 pUrb->pVUsb->pDev = pDev;
405
406#ifdef LOG_ENABLED
407 const char *pszType = NULL;
408
409 switch(pUrb->enmType)
410 {
411 case VUSBXFERTYPE_CTRL:
412 pszType = "ctrl";
413 break;
414 case VUSBXFERTYPE_INTR:
415 pszType = "intr";
416 break;
417 case VUSBXFERTYPE_BULK:
418 pszType = "bulk";
419 break;
420 case VUSBXFERTYPE_ISOC:
421 pszType = "isoc";
422 break;
423 default:
424 pszType = "invld";
425 break;
426 }
427
428 pRh->iSerial = (pRh->iSerial + 1) % 10000;
429 RTStrAPrintf(&pUrb->pszDesc, "URB %p %s%c%04d (%s)", pUrb, pszType,
430 (pUrb->enmDir == VUSBDIRECTION_IN) ? '<' : ((pUrb->enmDir == VUSBDIRECTION_SETUP) ? 's' : '>'),
431 pRh->iSerial, pszTag ? pszTag : "<none>");
432#endif
433 }
434
435 return pUrb;
436}
437
438
439/**
440 * Calculate frame timer variables given a frame rate.
441 */
442static void vusbRhR3CalcTimerIntervals(PVUSBROOTHUB pThis, uint32_t u32FrameRate)
443{
444 pThis->nsWait = RT_NS_1SEC / u32FrameRate;
445 pThis->uFrameRate = u32FrameRate;
446 /* Inform the HCD about the new frame rate. */
447 pThis->pIRhPort->pfnFrameRateChanged(pThis->pIRhPort, u32FrameRate);
448}
449
450
451/**
452 * Calculates the new frame rate based on the idle detection and number of idle
453 * cycles.
454 *
455 * @returns nothing.
456 * @param pThis The roothub instance data.
457 * @param fIdle Flag whether the last frame didn't produce any activity.
458 */
459static void vusbRhR3FrameRateCalcNew(PVUSBROOTHUB pThis, bool fIdle)
460{
461 uint32_t uNewFrameRate = pThis->uFrameRate;
462
463 /*
464 * Adjust the frame timer interval based on idle detection.
465 */
466 if (fIdle)
467 {
468 pThis->cIdleCycles++;
469 /* Set the new frame rate based on how long we've been idle. Tunable. */
470 switch (pThis->cIdleCycles)
471 {
472 case 4: uNewFrameRate = 500; break; /* 2ms interval */
473 case 16:uNewFrameRate = 125; break; /* 8ms interval */
474 case 24:uNewFrameRate = 50; break; /* 20ms interval */
475 default: break;
476 }
477 /* Avoid overflow. */
478 if (pThis->cIdleCycles > 60000)
479 pThis->cIdleCycles = 20000;
480 }
481 else
482 {
483 if (pThis->cIdleCycles)
484 {
485 pThis->cIdleCycles = 0;
486 uNewFrameRate = pThis->uFrameRateDefault;
487 }
488 }
489
490 if ( uNewFrameRate != pThis->uFrameRate
491 && uNewFrameRate)
492 {
493 LogFlow(("Frame rate changed from %u to %u\n", pThis->uFrameRate, uNewFrameRate));
494 vusbRhR3CalcTimerIntervals(pThis, uNewFrameRate);
495 }
496}
497
498
499/**
500 * The core frame processing routine keeping track of the elapsed time and calling into
501 * the device emulation above us to do the work.
502 *
503 * @returns Relative timespan when to process the next frame.
504 * @param pThis The roothub instance data.
505 * @param fCallback Flag whether this method is called from the URB completion callback or
506 * from the worker thread (only used for statistics).
507 */
508DECLHIDDEN(uint64_t) vusbRhR3ProcessFrame(PVUSBROOTHUB pThis, bool fCallback)
509{
510 uint64_t tsNext = 0;
511 uint64_t tsNanoStart = RTTimeNanoTS();
512
513 /* Don't do anything if we are not supposed to process anything (EHCI and XHCI). */
514 if (!pThis->uFrameRateDefault)
515 return 0;
516
517 if (ASMAtomicXchgBool(&pThis->fFrameProcessing, true))
518 return pThis->nsWait;
519
520 if ( tsNanoStart > pThis->tsFrameProcessed
521 && tsNanoStart - pThis->tsFrameProcessed >= 750 * RT_NS_1US)
522 {
523 LogFlowFunc(("Starting new frame at ts %llu\n", tsNanoStart));
524
525 bool fIdle = pThis->pIRhPort->pfnStartFrame(pThis->pIRhPort, 0 /* u32FrameNo */);
526 vusbRhR3FrameRateCalcNew(pThis, fIdle);
527
528 uint64_t tsNow = RTTimeNanoTS();
529 tsNext = (tsNanoStart + pThis->nsWait) > tsNow ? (tsNanoStart + pThis->nsWait) - tsNow : 0;
530 pThis->tsFrameProcessed = tsNanoStart;
531 LogFlowFunc(("Current frame took %llu nano seconds to process, next frame in %llu ns\n", tsNow - tsNanoStart, tsNext));
532 if (fCallback)
533 STAM_COUNTER_INC(&pThis->StatFramesProcessedClbk);
534 else
535 STAM_COUNTER_INC(&pThis->StatFramesProcessedThread);
536 }
537 else
538 {
539 tsNext = (pThis->tsFrameProcessed + pThis->nsWait) > tsNanoStart ? (pThis->tsFrameProcessed + pThis->nsWait) - tsNanoStart : 0;
540 LogFlowFunc(("Next frame is too far away in the future, waiting... (tsNanoStart=%llu tsFrameProcessed=%llu)\n",
541 tsNanoStart, pThis->tsFrameProcessed));
542 }
543
544 ASMAtomicXchgBool(&pThis->fFrameProcessing, false);
545 LogFlowFunc(("returns %llu\n", tsNext));
546 return tsNext;
547}
548
549
550/**
551 * Worker for processing frames periodically.
552 *
553 * @returns VBox status code.
554 * @param pDrvIns The driver instance.
555 * @param pThread The PDM thread structure for the thread this worker runs on.
556 */
557static DECLCALLBACK(int) vusbRhR3PeriodFrameWorker(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
558{
559 RT_NOREF(pDrvIns);
560 int rc = VINF_SUCCESS;
561 PVUSBROOTHUB pThis = (PVUSBROOTHUB)pThread->pvUser;
562
563 if (pThread->enmState == PDMTHREADSTATE_INITIALIZING)
564 return VINF_SUCCESS;
565
566 while (pThread->enmState == PDMTHREADSTATE_RUNNING)
567 {
568 while ( !ASMAtomicReadU32(&pThis->uFrameRateDefault)
569 && pThread->enmState == PDMTHREADSTATE_RUNNING)
570 {
571 /* Signal the waiter that we are stopped now. */
572 rc = RTSemEventMultiSignal(pThis->hSemEventPeriodFrameStopped);
573 AssertRC(rc);
574
575 rc = RTSemEventMultiWait(pThis->hSemEventPeriodFrame, RT_INDEFINITE_WAIT);
576 RTSemEventMultiReset(pThis->hSemEventPeriodFrame);
577
578 /*
579 * Notify the device above about the frame rate changed if we are supposed to
580 * process frames.
581 */
582 uint32_t uFrameRate = ASMAtomicReadU32(&pThis->uFrameRateDefault);
583 if (uFrameRate)
584 vusbRhR3CalcTimerIntervals(pThis, uFrameRate);
585 }
586
587 AssertLogRelMsgReturn(RT_SUCCESS(rc) || rc == VERR_TIMEOUT, ("%Rrc\n", rc), rc);
588 if (RT_UNLIKELY(pThread->enmState != PDMTHREADSTATE_RUNNING))
589 break;
590
591 uint64_t tsNext = vusbRhR3ProcessFrame(pThis, false /* fCallback */);
592
593 if (tsNext >= 250 * RT_NS_1US)
594 {
595 rc = RTSemEventMultiWaitEx(pThis->hSemEventPeriodFrame, RTSEMWAIT_FLAGS_RELATIVE | RTSEMWAIT_FLAGS_NANOSECS | RTSEMWAIT_FLAGS_UNINTERRUPTIBLE,
596 tsNext);
597 AssertLogRelMsg(RT_SUCCESS(rc) || rc == VERR_TIMEOUT, ("%Rrc\n", rc));
598 RTSemEventMultiReset(pThis->hSemEventPeriodFrame);
599 }
600 }
601
602 return VINF_SUCCESS;
603}
604
605
606/**
607 * Unblock the periodic frame thread so it can respond to a state change.
608 *
609 * @returns VBox status code.
610 * @param pDrvIns The driver instance.
611 * @param pThread The send thread.
612 */
613static DECLCALLBACK(int) vusbRhR3PeriodFrameWorkerWakeup(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
614{
615 RT_NOREF(pThread);
616 PVUSBROOTHUB pThis = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
617 return RTSemEventMultiSignal(pThis->hSemEventPeriodFrame);
618}
619
620
621/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnSetUrbParams} */
622static DECLCALLBACK(int) vusbRhSetUrbParams(PVUSBIROOTHUBCONNECTOR pInterface, size_t cbHci, size_t cbHciTd)
623{
624 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
625
626 pRh->cbHci = cbHci;
627 pRh->cbHciTd = cbHciTd;
628
629 return VINF_SUCCESS;
630}
631
632
633/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnNewUrb} */
634static DECLCALLBACK(PVUSBURB) vusbRhConnNewUrb(PVUSBIROOTHUBCONNECTOR pInterface, uint8_t DstAddress, PVUSBIDEVICE pDev, VUSBXFERTYPE enmType,
635 VUSBDIRECTION enmDir, uint32_t cbData, uint32_t cTds, const char *pszTag)
636{
637 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
638 return vusbRhNewUrb(pRh, DstAddress, (PVUSBDEV)pDev, enmType, enmDir, cbData, cTds, pszTag);
639}
640
641
642/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnFreeUrb} */
643static DECLCALLBACK(int) vusbRhConnFreeUrb(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBURB pUrb)
644{
645 RT_NOREF(pInterface);
646 pUrb->pVUsb->pfnFree(pUrb);
647 return VINF_SUCCESS;
648}
649
650
651/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnSubmitUrb} */
652static DECLCALLBACK(int) vusbRhSubmitUrb(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBURB pUrb, PPDMLED pLed)
653{
654 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
655 STAM_PROFILE_START(&pRh->StatSubmitUrb, a);
656
657#ifdef VBOX_WITH_STATISTICS
658 /*
659 * Total and per-type submit statistics.
660 */
661 Assert(pUrb->enmType >= 0 && pUrb->enmType < (int)RT_ELEMENTS(pRh->aTypes));
662 STAM_COUNTER_INC(&pRh->Total.StatUrbsSubmitted);
663 STAM_COUNTER_INC(&pRh->aTypes[pUrb->enmType].StatUrbsSubmitted);
664
665 STAM_COUNTER_ADD(&pRh->Total.StatReqBytes, pUrb->cbData);
666 STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqBytes, pUrb->cbData);
667 if (pUrb->enmDir == VUSBDIRECTION_IN)
668 {
669 STAM_COUNTER_ADD(&pRh->Total.StatReqReadBytes, pUrb->cbData);
670 STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqReadBytes, pUrb->cbData);
671 }
672 else
673 {
674 STAM_COUNTER_ADD(&pRh->Total.StatReqWriteBytes, pUrb->cbData);
675 STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqWriteBytes, pUrb->cbData);
676 }
677
678 if (pUrb->enmType == VUSBXFERTYPE_ISOC)
679 {
680 STAM_COUNTER_ADD(&pRh->StatIsocReqPkts, pUrb->cIsocPkts);
681 if (pUrb->enmDir == VUSBDIRECTION_IN)
682 STAM_COUNTER_ADD(&pRh->StatIsocReqReadPkts, pUrb->cIsocPkts);
683 else
684 STAM_COUNTER_ADD(&pRh->StatIsocReqWritePkts, pUrb->cIsocPkts);
685 }
686#endif
687
688 /* If there is a sniffer on the roothub record the URB there. */
689 if (pRh->hSniffer != VUSBSNIFFER_NIL)
690 {
691 int rc = VUSBSnifferRecordEvent(pRh->hSniffer, pUrb, VUSBSNIFFEREVENT_SUBMIT);
692 if (RT_FAILURE(rc))
693 LogRel(("VUSB: Capturing URB submit event on the root hub failed with %Rrc\n", rc));
694 }
695
696 /*
697 * The device was resolved when we allocated the URB.
698 * Submit it to the device if we found it, if not fail with device-not-ready.
699 */
700 int rc;
701 if ( pUrb->pVUsb->pDev
702 && pUrb->pVUsb->pDev->pUsbIns)
703 {
704 switch (pUrb->enmDir)
705 {
706 case VUSBDIRECTION_IN:
707 pLed->Asserted.s.fReading = pLed->Actual.s.fReading = 1;
708 rc = vusbUrbSubmit(pUrb);
709 pLed->Actual.s.fReading = 0;
710 break;
711 case VUSBDIRECTION_OUT:
712 pLed->Asserted.s.fWriting = pLed->Actual.s.fWriting = 1;
713 rc = vusbUrbSubmit(pUrb);
714 pLed->Actual.s.fWriting = 0;
715 break;
716 default:
717 rc = vusbUrbSubmit(pUrb);
718 break;
719 }
720
721 if (RT_FAILURE(rc))
722 {
723 LogFlow(("vusbRhSubmitUrb: freeing pUrb=%p\n", pUrb));
724 pUrb->pVUsb->pfnFree(pUrb);
725 }
726 }
727 else
728 {
729 vusbDevRetain(&pRh->Hub.Dev);
730 pUrb->pVUsb->pDev = &pRh->Hub.Dev;
731 Log(("vusb: pRh=%p: SUBMIT: Address %i not found!!!\n", pRh, pUrb->DstAddress));
732
733 pUrb->enmState = VUSBURBSTATE_REAPED;
734 pUrb->enmStatus = VUSBSTATUS_DNR;
735 vusbUrbCompletionRh(pUrb);
736 rc = VINF_SUCCESS;
737 }
738
739 STAM_PROFILE_STOP(&pRh->StatSubmitUrb, a);
740 return rc;
741}
742
743
744static DECLCALLBACK(int) vusbRhReapAsyncUrbsWorker(PVUSBDEV pDev, RTMSINTERVAL cMillies)
745{
746 if (!cMillies)
747 vusbUrbDoReapAsync(&pDev->LstAsyncUrbs, 0);
748 else
749 {
750 uint64_t u64Start = RTTimeMilliTS();
751 do
752 {
753 vusbUrbDoReapAsync(&pDev->LstAsyncUrbs, RT_MIN(cMillies >> 8, 10));
754 } while ( !RTListIsEmpty(&pDev->LstAsyncUrbs)
755 && RTTimeMilliTS() - u64Start < cMillies);
756 }
757
758 return VINF_SUCCESS;
759}
760
761/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnReapAsyncUrbs} */
762static DECLCALLBACK(void) vusbRhReapAsyncUrbs(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice, RTMSINTERVAL cMillies)
763{
764 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface); NOREF(pRh);
765 PVUSBDEV pDev = (PVUSBDEV)pDevice;
766
767 if (RTListIsEmpty(&pDev->LstAsyncUrbs))
768 return;
769
770 STAM_PROFILE_START(&pRh->StatReapAsyncUrbs, a);
771 int rc = vusbDevIoThreadExecSync(pDev, (PFNRT)vusbRhReapAsyncUrbsWorker, 2, pDev, cMillies);
772 AssertRC(rc);
773 STAM_PROFILE_STOP(&pRh->StatReapAsyncUrbs, a);
774}
775
776
777/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnCancelUrbsEp} */
778static DECLCALLBACK(int) vusbRhCancelUrbsEp(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBURB pUrb)
779{
780 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
781 AssertReturn(pRh, VERR_INVALID_PARAMETER);
782 AssertReturn(pUrb, VERR_INVALID_PARAMETER);
783
784 /// @todo This method of URB canceling may not work on non-Linux hosts.
785 /*
786 * Cancel and reap the URB(s) on an endpoint.
787 */
788 LogFlow(("vusbRhCancelUrbsEp: pRh=%p pUrb=%p\n", pRh, pUrb));
789
790 vusbUrbCancelAsync(pUrb, CANCELMODE_UNDO);
791
792 /* The reaper thread will take care of completing the URB. */
793
794 return VINF_SUCCESS;
795}
796
797/**
798 * Worker doing the actual cancelling of all outstanding URBs on the device I/O thread.
799 *
800 * @returns VBox status code.
801 * @param pDev USB device instance data.
802 */
803static DECLCALLBACK(int) vusbRhCancelAllUrbsWorker(PVUSBDEV pDev)
804{
805 /*
806 * Cancel the URBS.
807 *
808 * Not using th CritAsyncUrbs critical section here is safe
809 * as the I/O thread is the only thread accessing this struture at the
810 * moment.
811 */
812 PVUSBURBVUSB pVUsbUrb, pVUsbUrbNext;
813 RTListForEachSafe(&pDev->LstAsyncUrbs, pVUsbUrb, pVUsbUrbNext, VUSBURBVUSBINT, NdLst)
814 {
815 PVUSBURB pUrb = pVUsbUrb->pUrb;
816 /* Call the worker directly. */
817 vusbUrbCancelWorker(pUrb, CANCELMODE_FAIL);
818 }
819
820 return VINF_SUCCESS;
821}
822
823/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnCancelAllUrbs} */
824static DECLCALLBACK(void) vusbRhCancelAllUrbs(PVUSBIROOTHUBCONNECTOR pInterface)
825{
826 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
827
828 RTCritSectEnter(&pRh->CritSectDevices);
829 PVUSBDEV pDev = pRh->pDevices;
830 while (pDev)
831 {
832 vusbDevIoThreadExecSync(pDev, (PFNRT)vusbRhCancelAllUrbsWorker, 1, pDev);
833 pDev = pDev->pNext;
834 }
835 RTCritSectLeave(&pRh->CritSectDevices);
836}
837
838/**
839 * Worker doing the actual cancelling of all outstanding per-EP URBs on the
840 * device I/O thread.
841 *
842 * @returns VBox status code.
843 * @param pDev USB device instance data.
844 * @param EndPt Endpoint number.
845 * @param enmDir Endpoint direction.
846 */
847static DECLCALLBACK(int) vusbRhAbortEpWorker(PVUSBDEV pDev, int EndPt, VUSBDIRECTION enmDir)
848{
849 /*
850 * Iterate the URBs, find ones corresponding to given EP, and cancel them.
851 */
852 PVUSBURBVUSB pVUsbUrb, pVUsbUrbNext;
853 RTListForEachSafe(&pDev->LstAsyncUrbs, pVUsbUrb, pVUsbUrbNext, VUSBURBVUSBINT, NdLst)
854 {
855 PVUSBURB pUrb = pVUsbUrb->pUrb;
856
857 Assert(pUrb->pVUsb->pDev == pDev);
858
859 /* For the default control EP, direction does not matter. */
860 if (pUrb->EndPt == EndPt && (pUrb->enmDir == enmDir || !EndPt))
861 {
862 LogFlow(("%s: vusbRhAbortEpWorker: CANCELING URB\n", pUrb->pszDesc));
863 int rc = vusbUrbCancelWorker(pUrb, CANCELMODE_UNDO);
864 AssertRC(rc);
865 }
866 }
867
868 return VINF_SUCCESS;
869}
870
871
872/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnAbortEp} */
873static DECLCALLBACK(int) vusbRhAbortEp(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice, int EndPt, VUSBDIRECTION enmDir)
874{
875 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
876 if (&pRh->Hub != ((PVUSBDEV)pDevice)->pHub)
877 AssertFailedReturn(VERR_INVALID_PARAMETER);
878
879 RTCritSectEnter(&pRh->CritSectDevices);
880 PVUSBDEV pDev = (PVUSBDEV)pDevice;
881 vusbDevIoThreadExecSync(pDev, (PFNRT)vusbRhAbortEpWorker, 3, pDev, EndPt, enmDir);
882 RTCritSectLeave(&pRh->CritSectDevices);
883
884 /* The reaper thread will take care of completing the URB. */
885
886 return VINF_SUCCESS;
887}
888
889
890/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnAttachDevice} */
891static DECLCALLBACK(int) vusbRhAttachDevice(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice)
892{
893 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
894 return vusbHubAttach(&pRh->Hub, (PVUSBDEV)pDevice);
895}
896
897
898/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnDetachDevice} */
899static DECLCALLBACK(int) vusbRhDetachDevice(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice)
900{
901 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
902 if (&pRh->Hub != ((PVUSBDEV)pDevice)->pHub)
903 AssertFailedReturn(VERR_INVALID_PARAMETER);
904 return vusbDevDetach((PVUSBDEV)pDevice);
905}
906
907
908/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnSetPeriodicFrameProcessing} */
909static DECLCALLBACK(int) vusbRhSetFrameProcessing(PVUSBIROOTHUBCONNECTOR pInterface, uint32_t uFrameRate)
910{
911 int rc = VINF_SUCCESS;
912 PVUSBROOTHUB pThis = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
913
914 /* Create the frame thread lazily. */
915 if ( !pThis->hThreadPeriodFrame
916 && uFrameRate)
917 {
918 ASMAtomicXchgU32(&pThis->uFrameRateDefault, uFrameRate);
919 pThis->uFrameRate = uFrameRate;
920 vusbRhR3CalcTimerIntervals(pThis, uFrameRate);
921
922 rc = RTSemEventMultiCreate(&pThis->hSemEventPeriodFrame);
923 AssertRCReturn(rc, rc);
924
925 rc = RTSemEventMultiCreate(&pThis->hSemEventPeriodFrameStopped);
926 AssertRCReturn(rc, rc);
927
928 rc = PDMDrvHlpThreadCreate(pThis->pDrvIns, &pThis->hThreadPeriodFrame, pThis, vusbRhR3PeriodFrameWorker,
929 vusbRhR3PeriodFrameWorkerWakeup, 0, RTTHREADTYPE_IO, "VUsbPeriodFrm");
930 AssertRCReturn(rc, rc);
931
932 VMSTATE enmState = PDMDrvHlpVMState(pThis->pDrvIns);
933 if ( enmState == VMSTATE_RUNNING
934 || enmState == VMSTATE_RUNNING_LS)
935 {
936 rc = PDMR3ThreadResume(pThis->hThreadPeriodFrame);
937 AssertRCReturn(rc, rc);
938 }
939 }
940 else if ( pThis->hThreadPeriodFrame
941 && !uFrameRate)
942 {
943 /* Stop processing. */
944 uint32_t uFrameRateOld = ASMAtomicXchgU32(&pThis->uFrameRateDefault, uFrameRate);
945 if (uFrameRateOld)
946 {
947 rc = RTSemEventMultiReset(pThis->hSemEventPeriodFrameStopped);
948 AssertRC(rc);
949
950 /* Signal the frame thread to stop. */
951 RTSemEventMultiSignal(pThis->hSemEventPeriodFrame);
952
953 /* Wait for signal from the thread that it stopped. */
954 rc = RTSemEventMultiWait(pThis->hSemEventPeriodFrameStopped, RT_INDEFINITE_WAIT);
955 AssertRC(rc);
956 }
957 }
958 else if ( pThis->hThreadPeriodFrame
959 && uFrameRate)
960 {
961 /* Just switch to the new frame rate and let the periodic frame thread pick it up. */
962 uint32_t uFrameRateOld = ASMAtomicXchgU32(&pThis->uFrameRateDefault, uFrameRate);
963
964 /* Signal the frame thread to continue if it was stopped. */
965 if (!uFrameRateOld)
966 RTSemEventMultiSignal(pThis->hSemEventPeriodFrame);
967 }
968
969 return rc;
970}
971
972
973/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnGetPeriodicFrameRate} */
974static DECLCALLBACK(uint32_t) vusbRhGetPeriodicFrameRate(PVUSBIROOTHUBCONNECTOR pInterface)
975{
976 PVUSBROOTHUB pThis = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
977
978 return pThis->uFrameRate;
979}
980
981/** @interface_method_impl{VUSBIROOTHUBCONNECTOR,pfnUpdateIsocFrameDelta} */
982static DECLCALLBACK(uint32_t) vusbRhUpdateIsocFrameDelta(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice,
983 int EndPt, VUSBDIRECTION enmDir, uint16_t uNewFrameID, uint8_t uBits)
984{
985 PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
986 AssertReturn(pRh, 0);
987 PVUSBDEV pDev = (PVUSBDEV)pDevice;
988 PVUSBPIPE pPipe = &pDev->aPipes[EndPt];
989 uint32_t *puLastFrame;
990 int32_t uFrameDelta;
991 uint32_t uMaxVal = 1 << uBits;
992
993 puLastFrame = enmDir == VUSBDIRECTION_IN ? &pPipe->uLastFrameIn : &pPipe->uLastFrameOut;
994 uFrameDelta = uNewFrameID - *puLastFrame;
995 *puLastFrame = uNewFrameID;
996 /* Take care of wrap-around. */
997 if (uFrameDelta < 0)
998 uFrameDelta += uMaxVal;
999
1000 return (uint16_t)uFrameDelta;
1001}
1002
1003/* -=-=-=-=-=- VUSB Device methods (for the root hub) -=-=-=-=-=- */
1004
1005
1006/**
1007 * @interface_method_impl{VUSBIDEVICE,pfnReset}
1008 */
1009static DECLCALLBACK(int) vusbRhDevReset(PVUSBIDEVICE pInterface, bool fResetOnLinux,
1010 PFNVUSBRESETDONE pfnDone, void *pvUser, PVM pVM)
1011{
1012 RT_NOREF(pfnDone, pvUser, pVM);
1013 PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
1014 Assert(!pfnDone);
1015 return pRh->pIRhPort->pfnReset(pRh->pIRhPort, fResetOnLinux); /** @todo change rc from bool to vbox status everywhere! */
1016}
1017
1018
1019/**
1020 * @interface_method_impl{VUSBIDEVICE,pfnPowerOn}
1021 */
1022static DECLCALLBACK(int) vusbRhDevPowerOn(PVUSBIDEVICE pInterface)
1023{
1024 PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
1025 LogFlow(("vusbRhDevPowerOn: pRh=%p\n", pRh));
1026
1027 Assert( pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_DETACHED
1028 && pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_RESET);
1029
1030 if (pRh->Hub.Dev.enmState == VUSB_DEVICE_STATE_ATTACHED)
1031 pRh->Hub.Dev.enmState = VUSB_DEVICE_STATE_POWERED;
1032
1033 return VINF_SUCCESS;
1034}
1035
1036
1037/**
1038 * @interface_method_impl{VUSBIDEVICE,pfnPowerOff}
1039 */
1040static DECLCALLBACK(int) vusbRhDevPowerOff(PVUSBIDEVICE pInterface)
1041{
1042 PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
1043 LogFlow(("vusbRhDevPowerOff: pRh=%p\n", pRh));
1044
1045 Assert( pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_DETACHED
1046 && pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_RESET);
1047
1048 /*
1049 * Cancel all URBs and reap them.
1050 */
1051 VUSBIRhCancelAllUrbs(&pRh->IRhConnector);
1052 RTCritSectEnter(&pRh->CritSectDevices);
1053 PVUSBDEV pDev = pRh->pDevices;
1054 while (pDev)
1055 {
1056 VUSBIRhReapAsyncUrbs(&pRh->IRhConnector, (PVUSBIDEVICE)pDev, 0);
1057 pDev = pDev->pNext;
1058 }
1059 RTCritSectLeave(&pRh->CritSectDevices);
1060
1061 pRh->Hub.Dev.enmState = VUSB_DEVICE_STATE_ATTACHED;
1062 return VINF_SUCCESS;
1063}
1064
1065/**
1066 * @interface_method_impl{VUSBIDEVICE,pfnGetState}
1067 */
1068static DECLCALLBACK(VUSBDEVICESTATE) vusbRhDevGetState(PVUSBIDEVICE pInterface)
1069{
1070 PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
1071 return pRh->Hub.Dev.enmState;
1072}
1073
1074
1075static const char *vusbGetSpeedString(VUSBSPEED enmSpeed)
1076{
1077 const char *pszSpeed = NULL;
1078
1079 switch (enmSpeed)
1080 {
1081 case VUSB_SPEED_LOW:
1082 pszSpeed = "Low";
1083 break;
1084 case VUSB_SPEED_FULL:
1085 pszSpeed = "Full";
1086 break;
1087 case VUSB_SPEED_HIGH:
1088 pszSpeed = "High";
1089 break;
1090 case VUSB_SPEED_VARIABLE:
1091 pszSpeed = "Variable";
1092 break;
1093 case VUSB_SPEED_SUPER:
1094 pszSpeed = "Super";
1095 break;
1096 case VUSB_SPEED_SUPERPLUS:
1097 pszSpeed = "SuperPlus";
1098 break;
1099 default:
1100 pszSpeed = "Unknown";
1101 break;
1102 }
1103 return pszSpeed;
1104}
1105
1106/* -=-=-=-=-=- VUSB Hub methods -=-=-=-=-=- */
1107
1108
1109/**
1110 * Attach the device to the hub.
1111 * Port assignments and all such stuff is up to this routine.
1112 *
1113 * @returns VBox status code.
1114 * @param pHub Pointer to the hub.
1115 * @param pDev Pointer to the device.
1116 */
1117static int vusbRhHubOpAttach(PVUSBHUB pHub, PVUSBDEV pDev)
1118{
1119 PVUSBROOTHUB pRh = (PVUSBROOTHUB)pHub;
1120
1121 /*
1122 * Assign a port.
1123 */
1124 int iPort = ASMBitFirstSet(&pRh->Bitmap, sizeof(pRh->Bitmap) * 8);
1125 if (iPort < 0)
1126 {
1127 LogRel(("VUSB: No ports available!\n"));
1128 return VERR_VUSB_NO_PORTS;
1129 }
1130 ASMBitClear(&pRh->Bitmap, iPort);
1131 pHub->cDevices++;
1132 pDev->i16Port = iPort;
1133
1134 /*
1135 * Call the HCI attach routine and let it have its say before the device is
1136 * linked into the device list of this hub.
1137 */
1138 int rc = pRh->pIRhPort->pfnAttach(pRh->pIRhPort, &pDev->IDevice, iPort);
1139 if (RT_SUCCESS(rc))
1140 {
1141 RTCritSectEnter(&pRh->CritSectDevices);
1142 pDev->pNext = pRh->pDevices;
1143 pRh->pDevices = pDev;
1144 RTCritSectLeave(&pRh->CritSectDevices);
1145 LogRel(("VUSB: Attached '%s' to port %d on %s (%sSpeed)\n", pDev->pUsbIns->pszName,
1146 iPort, pHub->pszName, vusbGetSpeedString(pDev->pUsbIns->enmSpeed)));
1147 }
1148 else
1149 {
1150 ASMBitSet(&pRh->Bitmap, iPort);
1151 pHub->cDevices--;
1152 pDev->i16Port = -1;
1153 LogRel(("VUSB: Failed to attach '%s' to port %d, rc=%Rrc\n", pDev->pUsbIns->pszName, iPort, rc));
1154 }
1155 return rc;
1156}
1157
1158
1159/**
1160 * Detach the device from the hub.
1161 *
1162 * @returns VBox status code.
1163 * @param pHub Pointer to the hub.
1164 * @param pDev Pointer to the device.
1165 */
1166static void vusbRhHubOpDetach(PVUSBHUB pHub, PVUSBDEV pDev)
1167{
1168 PVUSBROOTHUB pRh = (PVUSBROOTHUB)pHub;
1169 Assert(pDev->i16Port != -1);
1170
1171 /*
1172 * Check that it's attached and unlink it from the linked list.
1173 */
1174 RTCritSectEnter(&pRh->CritSectDevices);
1175 if (pRh->pDevices != pDev)
1176 {
1177 PVUSBDEV pPrev = pRh->pDevices;
1178 while (pPrev && pPrev->pNext != pDev)
1179 pPrev = pPrev->pNext;
1180 Assert(pPrev);
1181 pPrev->pNext = pDev->pNext;
1182 }
1183 else
1184 pRh->pDevices = pDev->pNext;
1185 pDev->pNext = NULL;
1186 RTCritSectLeave(&pRh->CritSectDevices);
1187
1188 /*
1189 * Detach the device and mark the port as available.
1190 */
1191 unsigned uPort = pDev->i16Port;
1192 pRh->pIRhPort->pfnDetach(pRh->pIRhPort, &pDev->IDevice, uPort);
1193 LogRel(("VUSB: Detached '%s' from port %u on %s\n", pDev->pUsbIns->pszName, uPort, pHub->pszName));
1194 ASMBitSet(&pRh->Bitmap, uPort);
1195 pHub->cDevices--;
1196}
1197
1198
1199/**
1200 * The Hub methods implemented by the root hub.
1201 */
1202static const VUSBHUBOPS s_VUsbRhHubOps =
1203{
1204 vusbRhHubOpAttach,
1205 vusbRhHubOpDetach
1206};
1207
1208
1209
1210/* -=-=-=-=-=- PDM Base interface methods -=-=-=-=-=- */
1211
1212
1213/**
1214 * @interface_method_impl{PDMIBASE,pfnQueryInterface}
1215 */
1216static DECLCALLBACK(void *) vusbRhQueryInterface(PPDMIBASE pInterface, const char *pszIID)
1217{
1218 PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
1219 PVUSBROOTHUB pRh = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
1220
1221 PDMIBASE_RETURN_INTERFACE(pszIID, PDMIBASE, &pDrvIns->IBase);
1222 PDMIBASE_RETURN_INTERFACE(pszIID, VUSBIROOTHUBCONNECTOR, &pRh->IRhConnector);
1223 PDMIBASE_RETURN_INTERFACE(pszIID, VUSBIDEVICE, &pRh->Hub.Dev.IDevice);
1224 return NULL;
1225}
1226
1227
1228/* -=-=-=-=-=- PDM Driver methods -=-=-=-=-=- */
1229
1230
1231/**
1232 * Destruct a driver instance.
1233 *
1234 * Most VM resources are freed by the VM. This callback is provided so that any non-VM
1235 * resources can be freed correctly.
1236 *
1237 * @param pDrvIns The driver instance data.
1238 */
1239static DECLCALLBACK(void) vusbRhDestruct(PPDMDRVINS pDrvIns)
1240{
1241 PVUSBROOTHUB pRh = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
1242 PDMDRV_CHECK_VERSIONS_RETURN_VOID(pDrvIns);
1243
1244 vusbUrbPoolDestroy(&pRh->Hub.Dev.UrbPool);
1245 if (pRh->Hub.pszName)
1246 {
1247 RTStrFree(pRh->Hub.pszName);
1248 pRh->Hub.pszName = NULL;
1249 }
1250 if (pRh->hSniffer != VUSBSNIFFER_NIL)
1251 VUSBSnifferDestroy(pRh->hSniffer);
1252
1253 if (pRh->hSemEventPeriodFrame)
1254 RTSemEventMultiDestroy(pRh->hSemEventPeriodFrame);
1255
1256 if (pRh->hSemEventPeriodFrameStopped)
1257 RTSemEventMultiDestroy(pRh->hSemEventPeriodFrameStopped);
1258
1259 RTCritSectDelete(&pRh->CritSectDevices);
1260}
1261
1262
1263/**
1264 * Construct a root hub driver instance.
1265 *
1266 * @copydoc FNPDMDRVCONSTRUCT
1267 */
1268static DECLCALLBACK(int) vusbRhConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
1269{
1270 RT_NOREF(fFlags);
1271 PDMDRV_CHECK_VERSIONS_RETURN(pDrvIns);
1272 LogFlow(("vusbRhConstruct: Instance %d\n", pDrvIns->iInstance));
1273 PVUSBROOTHUB pThis = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
1274
1275 /*
1276 * Validate configuration.
1277 */
1278 if (!CFGMR3AreValuesValid(pCfg, "CaptureFilename\0"))
1279 return VERR_PDM_DRVINS_UNKNOWN_CFG_VALUES;
1280
1281 /*
1282 * Check that there are no drivers below us.
1283 */
1284 AssertMsgReturn(PDMDrvHlpNoAttach(pDrvIns) == VERR_PDM_NO_ATTACHED_DRIVER,
1285 ("Configuration error: Not possible to attach anything to this driver!\n"),
1286 VERR_PDM_DRVINS_NO_ATTACH);
1287
1288 /*
1289 * Initialize the critical sections.
1290 */
1291 int rc = RTCritSectInit(&pThis->CritSectDevices);
1292 if (RT_FAILURE(rc))
1293 return rc;
1294
1295 char *pszCaptureFilename = NULL;
1296 rc = CFGMR3QueryStringAlloc(pCfg, "CaptureFilename", &pszCaptureFilename);
1297 if ( RT_FAILURE(rc)
1298 && rc != VERR_CFGM_VALUE_NOT_FOUND)
1299 return PDMDrvHlpVMSetError(pDrvIns, rc, RT_SRC_POS,
1300 N_("Configuration error: Failed to query value of \"CaptureFilename\""));
1301
1302 /*
1303 * Initialize the data members.
1304 */
1305 pDrvIns->IBase.pfnQueryInterface = vusbRhQueryInterface;
1306 /* the usb device */
1307 pThis->Hub.Dev.enmState = VUSB_DEVICE_STATE_ATTACHED;
1308 pThis->Hub.Dev.u8Address = VUSB_INVALID_ADDRESS;
1309 pThis->Hub.Dev.u8NewAddress = VUSB_INVALID_ADDRESS;
1310 pThis->Hub.Dev.i16Port = -1;
1311 pThis->Hub.Dev.cRefs = 1;
1312 pThis->Hub.Dev.IDevice.pfnReset = vusbRhDevReset;
1313 pThis->Hub.Dev.IDevice.pfnPowerOn = vusbRhDevPowerOn;
1314 pThis->Hub.Dev.IDevice.pfnPowerOff = vusbRhDevPowerOff;
1315 pThis->Hub.Dev.IDevice.pfnGetState = vusbRhDevGetState;
1316 /* the hub */
1317 pThis->Hub.pOps = &s_VUsbRhHubOps;
1318 pThis->Hub.pRootHub = pThis;
1319 //pThis->hub.cPorts - later
1320 pThis->Hub.cDevices = 0;
1321 pThis->Hub.Dev.pHub = &pThis->Hub;
1322 RTStrAPrintf(&pThis->Hub.pszName, "RootHub#%d", pDrvIns->iInstance);
1323 /* misc */
1324 pThis->pDrvIns = pDrvIns;
1325 /* the connector */
1326 pThis->IRhConnector.pfnSetUrbParams = vusbRhSetUrbParams;
1327 pThis->IRhConnector.pfnNewUrb = vusbRhConnNewUrb;
1328 pThis->IRhConnector.pfnFreeUrb = vusbRhConnFreeUrb;
1329 pThis->IRhConnector.pfnSubmitUrb = vusbRhSubmitUrb;
1330 pThis->IRhConnector.pfnReapAsyncUrbs = vusbRhReapAsyncUrbs;
1331 pThis->IRhConnector.pfnCancelUrbsEp = vusbRhCancelUrbsEp;
1332 pThis->IRhConnector.pfnCancelAllUrbs = vusbRhCancelAllUrbs;
1333 pThis->IRhConnector.pfnAbortEp = vusbRhAbortEp;
1334 pThis->IRhConnector.pfnAttachDevice = vusbRhAttachDevice;
1335 pThis->IRhConnector.pfnDetachDevice = vusbRhDetachDevice;
1336 pThis->IRhConnector.pfnSetPeriodicFrameProcessing = vusbRhSetFrameProcessing;
1337 pThis->IRhConnector.pfnGetPeriodicFrameRate = vusbRhGetPeriodicFrameRate;
1338 pThis->IRhConnector.pfnUpdateIsocFrameDelta = vusbRhUpdateIsocFrameDelta;
1339 pThis->hSniffer = VUSBSNIFFER_NIL;
1340 pThis->cbHci = 0;
1341 pThis->cbHciTd = 0;
1342 pThis->fFrameProcessing = false;
1343#ifdef LOG_ENABLED
1344 pThis->iSerial = 0;
1345#endif
1346 /*
1347 * Resolve interface(s).
1348 */
1349 pThis->pIRhPort = PDMIBASE_QUERY_INTERFACE(pDrvIns->pUpBase, VUSBIROOTHUBPORT);
1350 AssertMsgReturn(pThis->pIRhPort, ("Configuration error: the device/driver above us doesn't expose any VUSBIROOTHUBPORT interface!\n"), VERR_PDM_MISSING_INTERFACE_ABOVE);
1351
1352 /*
1353 * Get number of ports and the availability bitmap.
1354 * ASSUME that the number of ports reported now at creation time is the max number.
1355 */
1356 pThis->Hub.cPorts = pThis->pIRhPort->pfnGetAvailablePorts(pThis->pIRhPort, &pThis->Bitmap);
1357 Log(("vusbRhConstruct: cPorts=%d\n", pThis->Hub.cPorts));
1358
1359 /*
1360 * Get the USB version of the attached HC.
1361 * ASSUME that version 2.0 implies high-speed.
1362 */
1363 pThis->fHcVersions = pThis->pIRhPort->pfnGetUSBVersions(pThis->pIRhPort);
1364 Log(("vusbRhConstruct: fHcVersions=%u\n", pThis->fHcVersions));
1365
1366 rc = vusbUrbPoolInit(&pThis->Hub.Dev.UrbPool);
1367 if (RT_FAILURE(rc))
1368 return rc;
1369
1370 if (pszCaptureFilename)
1371 {
1372 rc = VUSBSnifferCreate(&pThis->hSniffer, 0, pszCaptureFilename, NULL, NULL);
1373 if (RT_FAILURE(rc))
1374 return PDMDrvHlpVMSetError(pDrvIns, rc, RT_SRC_POS,
1375 N_("VUSBSniffer cannot open '%s' for writing. The directory must exist and it must be writable for the current user"),
1376 pszCaptureFilename);
1377
1378 MMR3HeapFree(pszCaptureFilename);
1379 }
1380
1381 /*
1382 * Register ourselves as a USB hub.
1383 * The current implementation uses the VUSBIRHCONFIG interface for communication.
1384 */
1385 PCPDMUSBHUBHLP pHlp; /* not used currently */
1386 rc = PDMDrvHlpUSBRegisterHub(pDrvIns, pThis->fHcVersions, pThis->Hub.cPorts, &g_vusbHubReg, &pHlp);
1387 if (RT_FAILURE(rc))
1388 return rc;
1389
1390 /*
1391 * Statistics. (It requires a 30" monitor or extremely tiny fonts to edit this "table".)
1392 */
1393#ifdef VBOX_WITH_STATISTICS
1394 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs submitted.", "/VUSB/%d/UrbsSubmitted", pDrvIns->iInstance);
1395 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsSubmitted/Bulk", pDrvIns->iInstance);
1396 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsSubmitted/Ctrl", pDrvIns->iInstance);
1397 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsSubmitted/Intr", pDrvIns->iInstance);
1398 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsSubmitted/Isoc", pDrvIns->iInstance);
1399
1400 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs cancelled. (included in failed)", "/VUSB/%d/UrbsCancelled", pDrvIns->iInstance);
1401 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsCancelled/Bulk", pDrvIns->iInstance);
1402 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsCancelled/Ctrl", pDrvIns->iInstance);
1403 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsCancelled/Intr", pDrvIns->iInstance);
1404 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsCancelled/Isoc", pDrvIns->iInstance);
1405
1406 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs failing.", "/VUSB/%d/UrbsFailed", pDrvIns->iInstance);
1407 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsFailed/Bulk", pDrvIns->iInstance);
1408 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsFailed/Ctrl", pDrvIns->iInstance);
1409 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsFailed/Intr", pDrvIns->iInstance);
1410 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsFailed/Isoc", pDrvIns->iInstance);
1411
1412 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested transfer.", "/VUSB/%d/ReqBytes", pDrvIns->iInstance);
1413 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqBytes/Bulk", pDrvIns->iInstance);
1414 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqBytes/Ctrl", pDrvIns->iInstance);
1415 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqBytes/Intr", pDrvIns->iInstance);
1416 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqBytes/Isoc", pDrvIns->iInstance);
1417
1418 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested read transfer.", "/VUSB/%d/ReqReadBytes", pDrvIns->iInstance);
1419 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqReadBytes/Bulk", pDrvIns->iInstance);
1420 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqReadBytes/Ctrl", pDrvIns->iInstance);
1421 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqReadBytes/Intr", pDrvIns->iInstance);
1422 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqReadBytes/Isoc", pDrvIns->iInstance);
1423
1424 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested write transfer.", "/VUSB/%d/ReqWriteBytes", pDrvIns->iInstance);
1425 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqWriteBytes/Bulk", pDrvIns->iInstance);
1426 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqWriteBytes/Ctrl", pDrvIns->iInstance);
1427 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqWriteBytes/Intr", pDrvIns->iInstance);
1428 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqWriteBytes/Isoc", pDrvIns->iInstance);
1429
1430 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total transfer.", "/VUSB/%d/ActBytes", pDrvIns->iInstance);
1431 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActBytes/Bulk", pDrvIns->iInstance);
1432 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActBytes/Ctrl", pDrvIns->iInstance);
1433 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActBytes/Intr", pDrvIns->iInstance);
1434 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActBytes/Isoc", pDrvIns->iInstance);
1435
1436 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total read transfer.", "/VUSB/%d/ActReadBytes", pDrvIns->iInstance);
1437 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActReadBytes/Bulk", pDrvIns->iInstance);
1438 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActReadBytes/Ctrl", pDrvIns->iInstance);
1439 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActReadBytes/Intr", pDrvIns->iInstance);
1440 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActReadBytes/Isoc", pDrvIns->iInstance);
1441
1442 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total write transfer.", "/VUSB/%d/ActWriteBytes", pDrvIns->iInstance);
1443 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActWriteBytes/Bulk", pDrvIns->iInstance);
1444 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActWriteBytes/Ctrl", pDrvIns->iInstance);
1445 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActWriteBytes/Intr", pDrvIns->iInstance);
1446 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActWriteBytes/Isoc", pDrvIns->iInstance);
1447
1448 /* bulk */
1449 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Bulk/Urbs", pDrvIns->iInstance);
1450 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Bulk/UrbsFailed", pDrvIns->iInstance);
1451 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Bulk/UrbsFailed/Cancelled", pDrvIns->iInstance);
1452 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transferred.", "/VUSB/%d/Bulk/ActBytes", pDrvIns->iInstance);
1453 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Bulk/ActBytes/Read", pDrvIns->iInstance);
1454 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Bulk/ActBytes/Write", pDrvIns->iInstance);
1455 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Bulk/ReqBytes", pDrvIns->iInstance);
1456 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Bulk/ReqBytes/Read", pDrvIns->iInstance);
1457 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Bulk/ReqBytes/Write", pDrvIns->iInstance);
1458
1459 /* control */
1460 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Ctrl/Urbs", pDrvIns->iInstance);
1461 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Ctrl/UrbsFailed", pDrvIns->iInstance);
1462 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Ctrl/UrbsFailed/Cancelled", pDrvIns->iInstance);
1463 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transferred.", "/VUSB/%d/Ctrl/ActBytes", pDrvIns->iInstance);
1464 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Ctrl/ActBytes/Read", pDrvIns->iInstance);
1465 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Ctrl/ActBytes/Write", pDrvIns->iInstance);
1466 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Ctrl/ReqBytes", pDrvIns->iInstance);
1467 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Ctrl/ReqBytes/Read", pDrvIns->iInstance);
1468 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Ctrl/ReqBytes/Write", pDrvIns->iInstance);
1469
1470 /* interrupt */
1471 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Intr/Urbs", pDrvIns->iInstance);
1472 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Intr/UrbsFailed", pDrvIns->iInstance);
1473 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Intr/UrbsFailed/Cancelled", pDrvIns->iInstance);
1474 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transferred.", "/VUSB/%d/Intr/ActBytes", pDrvIns->iInstance);
1475 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Intr/ActBytes/Read", pDrvIns->iInstance);
1476 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Intr/ActBytes/Write", pDrvIns->iInstance);
1477 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Intr/ReqBytes", pDrvIns->iInstance);
1478 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Intr/ReqBytes/Read", pDrvIns->iInstance);
1479 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Intr/ReqBytes/Write", pDrvIns->iInstance);
1480
1481 /* isochronous */
1482 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Isoc/Urbs", pDrvIns->iInstance);
1483 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Isoc/UrbsFailed", pDrvIns->iInstance);
1484 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Isoc/UrbsFailed/Cancelled", pDrvIns->iInstance);
1485 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transferred.", "/VUSB/%d/Isoc/ActBytes", pDrvIns->iInstance);
1486 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Isoc/ActBytes/Read", pDrvIns->iInstance);
1487 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Isoc/ActBytes/Write", pDrvIns->iInstance);
1488 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Isoc/ReqBytes", pDrvIns->iInstance);
1489 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Isoc/ReqBytes/Read", pDrvIns->iInstance);
1490 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Isoc/ReqBytes/Write", pDrvIns->iInstance);
1491 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of isochronous packets returning data.", "/VUSB/%d/Isoc/ActPkts", pDrvIns->iInstance);
1492 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActReadPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Read.", "/VUSB/%d/Isoc/ActPkts/Read", pDrvIns->iInstance);
1493 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActWritePkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Write.", "/VUSB/%d/Isoc/ActPkts/Write", pDrvIns->iInstance);
1494 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Requested number of isochronous packets.", "/VUSB/%d/Isoc/ReqPkts", pDrvIns->iInstance);
1495 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqReadPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Read.", "/VUSB/%d/Isoc/ReqPkts/Read", pDrvIns->iInstance);
1496 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqWritePkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Write.", "/VUSB/%d/Isoc/ReqPkts/Write", pDrvIns->iInstance);
1497
1498 for (unsigned i = 0; i < RT_ELEMENTS(pThis->aStatIsocDetails); i++)
1499 {
1500 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Pkts, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d", pDrvIns->iInstance, i);
1501 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Ok, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Ok", pDrvIns->iInstance, i);
1502 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Ok0, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Ok0", pDrvIns->iInstance, i);
1503 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataUnderrun, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataUnderrun", pDrvIns->iInstance, i);
1504 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataUnderrun0, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataUnderrun0", pDrvIns->iInstance, i);
1505 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataOverrun, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataOverrun", pDrvIns->iInstance, i);
1506 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].NotAccessed, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/NotAccessed", pDrvIns->iInstance, i);
1507 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Misc, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Misc", pDrvIns->iInstance, i);
1508 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Bytes, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_BYTES, ".", "/VUSB/%d/Isoc/%d/Bytes", pDrvIns->iInstance, i);
1509 }
1510
1511 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatReapAsyncUrbs, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Profiling the vusbRhReapAsyncUrbs body (omitting calls when nothing is in-flight).", "/VUSB/%d/ReapAsyncUrbs", pDrvIns->iInstance);
1512 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatSubmitUrb, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Profiling the vusbRhSubmitUrb body.", "/VUSB/%d/SubmitUrb", pDrvIns->iInstance);
1513 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatFramesProcessedThread, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Processed frames in the dedicated thread", "/VUSB/%d/FramesProcessedThread", pDrvIns->iInstance);
1514 PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatFramesProcessedClbk, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Processed frames in the URB completion callback", "/VUSB/%d/FramesProcessedClbk", pDrvIns->iInstance);
1515#endif
1516 PDMDrvHlpSTAMRegisterF(pDrvIns, (void *)&pThis->Hub.Dev.UrbPool.cUrbsInPool, STAMTYPE_U32, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs in the pool.", "/VUSB/%d/cUrbsInPool", pDrvIns->iInstance);
1517
1518 return VINF_SUCCESS;
1519}
1520
1521
1522/**
1523 * VUSB Root Hub driver registration record.
1524 */
1525const PDMDRVREG g_DrvVUSBRootHub =
1526{
1527 /* u32Version */
1528 PDM_DRVREG_VERSION,
1529 /* szName */
1530 "VUSBRootHub",
1531 /* szRCMod */
1532 "",
1533 /* szR0Mod */
1534 "",
1535 /* pszDescription */
1536 "VUSB Root Hub Driver.",
1537 /* fFlags */
1538 PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
1539 /* fClass. */
1540 PDM_DRVREG_CLASS_USB,
1541 /* cMaxInstances */
1542 ~0U,
1543 /* cbInstance */
1544 sizeof(VUSBROOTHUB),
1545 /* pfnConstruct */
1546 vusbRhConstruct,
1547 /* pfnDestruct */
1548 vusbRhDestruct,
1549 /* pfnRelocate */
1550 NULL,
1551 /* pfnIOCtl */
1552 NULL,
1553 /* pfnPowerOn */
1554 NULL,
1555 /* pfnReset */
1556 NULL,
1557 /* pfnSuspend */
1558 NULL,
1559 /* pfnResume */
1560 NULL,
1561 /* pfnAttach */
1562 NULL,
1563 /* pfnDetach */
1564 NULL,
1565 /* pfnPowerOff */
1566 NULL,
1567 /* pfnSoftReset */
1568 NULL,
1569 /* u32EndVersion */
1570 PDM_DRVREG_VERSION
1571};
1572
1573/*
1574 * Local Variables:
1575 * mode: c
1576 * c-file-style: "bsd"
1577 * c-basic-offset: 4
1578 * tab-width: 4
1579 * indent-tabs-mode: s
1580 * End:
1581 */
1582
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette