DrvVUSBRootHub.cpp revision 82bcaaf8077ba892f39afb721dca149353c63d2c
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Virtual USB - Root Hub Driver.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Copyright (C) 2006-2007 Sun Microsystems, Inc.
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * available from http://www.virtualbox.org. This file is free software;
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * you can redistribute it and/or modify it under the terms of the GNU
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * General Public License (GPL) as published by the Free Software
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
82bcaaf8077ba892f39afb721dca149353c63d2cvboxsync * additional information or have any questions.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @page pg_dev_vusb VUSB - Virtual USB
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @todo read thru this and correct typos. Merge with old docs.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The Virtual USB component glues USB devices and host controllers together.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The VUSB takes the form of a PDM driver which is attached to the HCI. USB
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * devices are created by, attached to, and managed by the VUSB roothub. The
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * VUSB also exposes an interface which is used by Main to attach and detach
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * proxied USB devices.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @section sec_dev_vusb_urb The Life of an URB
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The URB is created when the HCI calls the roothub (VUSB) method pfnNewUrb.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * VUSB has a pool of URBs, if no free URBs are availabe a new one is
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * allocated. The returned URB starts life in the ALLOCATED state and all
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * fields are initalized with sensible defaults.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The HCI then copies any request data into the URB if it's an host2dev
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * transfer. It then submits the URB by calling the pfnSubmitUrb roothub
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * pfnSubmitUrb will start by checking if it knows the device address, and if
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * it doesn't the URB is completed with a device-not-ready error. When the
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * device address is known to it, action is taken based on the kind of
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * transfer it is. There are four kinds of transfers: 1. control, 2. bulk,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * 3. interrupt, and 4. isochronous. In either case something eventually ends
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * up being submitted to the device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * If an URB fails submitting, may or may not be completed. This depends on
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * heuristics in some cases and on the kind of failure in others. If
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * pfnSubmitUrb returns a failure, the HCI should retry submitting it at a
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * later time. If pfnSubmitUrb returns success the URB is submitted, and it
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * can even been completed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The URB is in the IN_FLIGHT state from the time it's successfully submitted
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * and till it's reaped or cancelled.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * When an URB transfer or in some case submit failure occurs, the pfnXferError
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * callback of the HCI is consulted about what to do. If pfnXferError indicates
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * that the URB should be retried, pfnSubmitUrb will fail. If it indicates that
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * it should fail, the URB will be completed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Completing an URB means that the URB status is set and the HCI
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * pfnXferCompletion callback is invoked with the URB. The HCI is the supposed
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * to report the transfer status to the guest OS. After completion the URB
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * is freed and returned to the pool, unless it was cancelled. If it was
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * cancelled it will have to await reaping before it's actually freed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @subsection subsec_dev_vusb_urb_ctrl Control
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The control transfer is the most complex one, from VUSB's point of view,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * with its three stages and being bi-directional. A control transfer starts
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * with a SETUP packet containing the request description and two basic
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * parameters. It is followed by zero or more DATA packets which either picks
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * up incoming data (dev2host) or supplies the request data (host2dev). This
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * can then be followed by a STATUS packet which gets the status of the whole
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * transfer.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * What makes the control transfer complicated is that for a host2dev request
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * the URB is assembled from the SETUP and DATA stage, and for a dev2host
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * request the returned data must be kept around for the DATA stage. For both
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * transfer directions the status of the transfer has to be kept around for
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * the STATUS stage.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * To complicate matters futher, VUSB must intercept and in some cases emulate
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * some of the standard requests in order to keep the virtual device state
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * correct and provide the correct virtualization of a device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @subsection subsec_dev_vusb_urb_bulk Bulk and Interrupt
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The bulk and interrupt transfer types are relativly simple compared to the
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * control transfer. VUSB is not inspecting the request content or anything,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * but passes it down the device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @subsection subsec_dev_vusb_urb_bulk Isochronous
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * This kind of transfers hasn't yet been implemented.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @page pg_dev_vusb_old VUSB - Virtual USB Core
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The virtual USB core is controlled by the roothub and the underlying HCI
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * emulator, it is responsible for device addressing, managing configurations,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * interfaces and endpoints, assembling and splitting multi-part control
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * messages and in general acts as a middle layer between the USB device
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * emulation code and USB HCI emulation code.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * All USB devices are represented by a struct vusb_dev. This structure
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * contains things like the device state, device address, all the configuration
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * descriptors, the currently selected configuration and a mapping between
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * endpoint addresses and endpoint descriptors.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Each vusb_dev also has a pointer to a vusb_dev_ops structure which serves as
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * the virtual method table and includes a virtual constructor and destructor.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * After a vusb_dev is created it may be attached to a hub device such as a
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * roothub (using vusbHubAttach). Although each hub structure has cPorts
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * and cDevices fields, it is the responsibility of the hub device to allocate
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * a free port for the new device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Devices can chose one of two interfaces for dealing with requests, the
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * synchronous interface or the asynchronous interface. The synchronous
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * interface is much simpler and ought to be used for devices which are
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * unlikely to sleep for long periods in order to serve requests. The
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * asynchronous interface on the other hand is more difficult to use but is
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * useful for the USB proxy or if one were to write a mass storage device
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * emulator. Currently the synchronous interface only supports control and bulk
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * endpoints and is no longer used by anything.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * In order to use the asynchronous interface, the queue_urb, cancel_urb and
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * pfnUrbReap fields must be set in the devices vusb_dev_ops structure. The
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * queue_urb method is used to submit a request to a device without blocking,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * it returns 1 if successful and 0 on any kind of failure. A successfully
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * queued URB is completed when the pfnUrbReap method returns it. Each function
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * address is reference counted so that pfnUrbReap will only be called if there
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * are URBs outstanding. For a roothub to reap an URB from any one of it's
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * devices, the vusbRhReapAsyncUrbs() function is used.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * There are four types of messages an URB may contain:
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# Control - represents a single packet of a multi-packet control
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * transfer, these are only really used by the host controller to
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * submit the parts to the usb core.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# Message - the usb core assembles multiple control transfers in
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * to single message transfers. In this case the data buffer
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * contains the setup packet in little endian followed by the full
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * buffer. In the case of an host-to-device control message, the
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * message packet is created when the STATUS transfer is seen. In
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * the case of device-to-host messages, the message packet is
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * created after the SETUP transfer is seen. Also, certain control
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * requests never go the real device and get handled synchronously.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# Bulk - Currently the only endpoint type that does error checking
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * and endpoint halting.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# Interrupt - The only non-periodic type supported.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Hubs are special cases of devices, they have a number of downstream ports
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * that other devices can be attached to and removed from.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * After a device has been attached (vusbHubAttach):
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The hub attach method is called, which sends a hub status
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * change message to the OS.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The OS resets the device, and it appears on the default
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * address with it's config 0 selected (a pseudo-config that
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * contains only 1 interface with 1 endpoint - the default
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * message pipe).
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The OS assigns the device a new address and selects an
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * appropriate config.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The device is ready.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * After a device has been detached (vusbDevDetach):
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# All pending URBs are cancelled.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The devices address is unassigned.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The hub detach method is called which signals the OS
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * of the status change.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# The OS unlinks the ED's for that device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * A device can also request detachment from within its own methods by
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * calling vusbDevUnplugged().
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Roothubs are responsible for driving the whole system, they are special
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * cases of hubs and as such implement attach and detach methods, each one
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * is described by a struct vusb_roothub. Once a roothub has submitted an
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * URB to the USB core, a number of callbacks to the roothub are required
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * for when the URB completes, since the roothub typically wants to inform
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * the OS when transfers are completed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * There are four callbacks to be concerned with:
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# prepare - This is called after the URB is successfully queued.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# completion - This is called after the URB completed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# error - This is called if the URB errored, some systems have
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * automatic resubmission of failed requests, so this callback
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * should keep track of the error count and return 1 if the count
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * is above the number of allowed resubmissions.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * -# halt_ep - This is called after errors on bulk pipes in order
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * to halt the pipe.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/*******************************************************************************
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync* Header Files *
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync*******************************************************************************/
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Attaches a device to a specific hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * This function is called by the vusb_add_device() and vusbRhAttachDevice().
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @returns VBox status code.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pHub The hub to attach it to.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pDev The device to attach.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @thread EMT
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic int vusbHubAttach(PVUSBHUB pHub, PVUSBDEV pDev)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync LogFlow(("vusbHubAttach: pHub=%p[%s] pDev=%p[%s]\n", pHub, pHub->pszName, pDev, pDev->pUsbIns->pszName));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync AssertMsg(pDev->enmState == VUSB_DEVICE_STATE_DETACHED, ("enmState=%d\n", pDev->enmState));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* noone else ever messes with the default pipe while we are attached */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- PDMUSBHUBREG methods -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc PDMUSBHUBREG::pfnAttachDevice */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbPDMHubAttachDevice(PPDMDRVINS pDrvIns, PPDMUSBINS pUsbIns, uint32_t *piPort)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pThis = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Allocate a new VUSB device and initialize it.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBDEV pDev = (PVUSBDEV)RTMemAllocZ(sizeof(*pDev));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc PDMUSBHUBREG::pfnDetachDevice */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbPDMHubDetachDevice(PPDMDRVINS pDrvIns, PPDMUSBINS pUsbIns, uint32_t iPort)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The hub registration structure.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- VUSBIROOTHUBCONNECTOR methods -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Finds an device attached to a roothub by it's address.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @returns Pointer to the device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @returns NULL if not found.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pRh Pointer to the root hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param Address The device address.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic PVUSBDEV vusbRhFindDevByAddress(PVUSBROOTHUB pRh, uint8_t Address)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync for (PVUSBDEV pDev = pRh->apAddrHash[iHash]; pDev; pDev = pDev->pNextHash)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Callback for freeing an URB.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pUrb The URB to free.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(void) vusbRhFreeUrb(PVUSBURB pUrb)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Assert sanity.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = (PVUSBROOTHUB)pUrb->VUsb.pvFreeCtx;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync for (PVUSBURB pCur = pRh->pAsyncUrbHead; pCur; pCur = pCur->VUsb.pNext)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Free the URB description (logging builds only).
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Put it into the LIFO of free URBs.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * (No ppPrev is needed here.)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Assert(pRh->pFreeUrbs->enmState == VUSBURBSTATE_FREE);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Worker routine for vusbRhConnNewUrb() and vusbDevNewIsocUrb().
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncPVUSBURB vusbRhNewUrb(PVUSBROOTHUB pRh, uint8_t DstAddress, uint32_t cbData, uint32_t cTds)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Reuse or allocate a new URB.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /** @todo try find a best fit, MSD which submits rather big URBs intermixed with small control
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * messages ends up with a 2+ of these big URBs when a single one is sufficient. */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /** @todo The allocations should be done by the device, at least as an option, since the devices
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * frequently wish to associate their own stuff with the in-flight URB or need special buffering
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * (isochronous on Darwin for instance). */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Assert(!pUrb->VUsb.pNext || pUrb->VUsb.pNext->enmState == VUSBURBSTATE_FREE);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* allocate a new one. */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync uint32_t cbDataAllocated = cbData <= _4K ? RT_ALIGN_32(cbData, _1K)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pUrb = (PVUSBURB)RTMemAlloc( RT_OFFSETOF(VUSBURB, abData[cbDataAllocated + 16])
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pUrb->Hci.paTds = (VUSBURB::VUSBURBHCI::VUSBURBHCITD *)(&pUrb->abData[cbDataAllocated + 16]);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * (Re)init the URB
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pUrb->VUsb.pDev = vusbRhFindDevByAddress(pRh, DstAddress);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pUrb->pUsbIns = pUrb->VUsb.pDev ? pUrb->VUsb.pDev->pUsbIns : NULL;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnNewUrb */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(PVUSBURB) vusbRhConnNewUrb(PVUSBIROOTHUBCONNECTOR pInterface, uint8_t DstAddress, uint32_t cbData, uint32_t cTds)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync return vusbRhNewUrb(pRh, DstAddress, cbData, cTds);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnSubmitUrb */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhSubmitUrb(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBURB pUrb, PPDMLED pLed)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Total and per-type submit statistics.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Assert(pUrb->enmType >= 0 && pUrb->enmType < (int)RT_ELEMENTS(pRh->aTypes));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_INC(&pRh->aTypes[pUrb->enmType].StatUrbsSubmitted);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->Total.StatReqBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->Total.StatReqReadBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqReadBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->Total.StatReqWriteBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->aTypes[pUrb->enmType].StatReqWriteBytes, pUrb->cbData);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->StatIsocReqPkts, pUrb->cIsocPkts);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->StatIsocReqReadPkts, pUrb->cIsocPkts);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync STAM_COUNTER_ADD(&pRh->StatIsocReqWritePkts, pUrb->cIsocPkts);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The device was resolved when we allocated the URB.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Submit it to the device if we found it, if not fail with device-not-ready.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pLed->Asserted.s.fReading = pLed->Actual.s.fReading = 1;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pLed->Asserted.s.fWriting = pLed->Actual.s.fWriting = 1;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync LogFlow(("vusbRhSubmitUrb: freeing pUrb=%p\n", pUrb));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Log(("vusb: pRh=%p: SUBMIT: Address %i not found!!!\n", pRh, pUrb->DstAddress));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnReapAsyncUrbs */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(void) vusbRhReapAsyncUrbs(PVUSBIROOTHUBCONNECTOR pInterface, RTMSINTERVAL cMillies)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync vusbUrbDoReapAsync(pRh->pAsyncUrbHead, RT_MIN(cMillies >> 8, 10));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnCancelAllUrbs */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(void) vusbRhCancelAllUrbs(PVUSBIROOTHUBCONNECTOR pInterface)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Cancel the URBS.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Reap any URBs which now are ripe.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pRipe = pUrb->pUsbIns->pReg->pfnUrbReap(pUrb->pUsbIns, 0);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnAttachDevice */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhAttachDevice(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync return vusbHubAttach(&pRh->Hub, (PVUSBDEV)pDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/** @copydoc VUSBIROOTHUBCONNECTOR::pfnDetachDevice */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhDetachDevice(PVUSBIROOTHUBCONNECTOR pInterface, PVUSBIDEVICE pDevice)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = VUSBIROOTHUBCONNECTOR_2_VUSBROOTHUB(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- VUSB Device methods (for the root hub) -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @copydoc VUSBIDEVICE::pfnReset
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhDevReset(PVUSBIDEVICE pInterface, bool fResetOnLinux, PFNVUSBRESETDONE pfnDone, void *pvUser, PVM pVM)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync return pRh->pIRhPort->pfnReset(pRh->pIRhPort, fResetOnLinux); /** @todo change rc from bool to vbox status everywhere! */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @copydoc VUSBIDEVICE::pfnPowerOn
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhDevPowerOn(PVUSBIDEVICE pInterface)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Assert( pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_DETACHED
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync && pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_RESET);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync if (pRh->Hub.Dev.enmState == VUSB_DEVICE_STATE_ATTACHED)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @copydoc VUSBIDEVICE::pfnPowerOff
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhDevPowerOff(PVUSBIDEVICE pInterface)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Assert( pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_DETACHED
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync && pRh->Hub.Dev.enmState != VUSB_DEVICE_STATE_RESET);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Cancel all URBs and reap them.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pRh->Hub.Dev.enmState = VUSB_DEVICE_STATE_ATTACHED;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @copydoc VUSBIDEVICE::pfnGetState
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncDECLCALLBACK(VUSBDEVICESTATE) vusbRhDevGetState(PVUSBIDEVICE pInterface)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = RT_FROM_MEMBER(pInterface, VUSBROOTHUB, Hub.Dev.IDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- VUSB Hub methods -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Attach the device to the hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Port assignments and all such stuff is up to this routine.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @returns VBox status code.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pHub Pointer to the hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pDev Pointer to the device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic int vusbRhHubOpAttach(PVUSBHUB pHub, PVUSBDEV pDev)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Assign a port.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync int iPort = ASMBitFirstSet(&pRh->Bitmap, sizeof(pRh->Bitmap) * 8);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Call the HCI attach routine and let it have its say before the device is
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * linked into the device list of this hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync int rc = pRh->pIRhPort->pfnAttach(pRh->pIRhPort, &pDev->IDevice, iPort);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync LogRel(("VUSB: attached '%s' to port %d\n", pDev->pUsbIns->pszName, iPort));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync LogRel(("VUSB: failed to attach '%s' to port %d, rc=%Rrc\n", pDev->pUsbIns->pszName, iPort, rc));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Detach the device from the hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @returns VBox status code.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pHub Pointer to the hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pDev Pointer to the device.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic void vusbRhHubOpDetach(PVUSBHUB pHub, PVUSBDEV pDev)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Check that it's attached and unlink it from the linked list.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Detach the device and mark the port as available.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pRh->pIRhPort->pfnDetach(pRh->pIRhPort, &pDev->IDevice, uPort);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The Hub methods implemented by the root hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- PDM Base interface methods -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @interface_method_impl{PDMIBASE,pfnQueryInterface}
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(void *) vusbRhQueryInterface(PPDMIBASE pInterface, const char *pszIID)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMIBASE_RETURN_INTERFACE(pszIID, PDMIBASE, &pDrvIns->IBase);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMIBASE_RETURN_INTERFACE(pszIID, VUSBIROOTHUBCONNECTOR, &pRh->IRhConnector);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMIBASE_RETURN_INTERFACE(pszIID, VUSBIDEVICE, &pRh->Hub.Dev.IDevice);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync/* -=-=-=-=-=- PDM Driver methods -=-=-=-=-=- */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Destruct a driver instance.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Most VM resources are freed by the VM. This callback is provided so that any non-VM
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * resources can be freed correctly.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @param pDrvIns The driver instance data.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(void) vusbRhDestruct(PPDMDRVINS pDrvIns)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pRh = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Free all URBs.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Construct a root hub driver instance.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * @copydoc FNPDMDRVCONSTRUCT
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsyncstatic DECLCALLBACK(int) vusbRhConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PVUSBROOTHUB pThis = PDMINS_2_DATA(pDrvIns, PVUSBROOTHUB);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Validate configuration.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Check that there are no drivers below us.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync AssertMsgReturn(PDMDrvHlpNoAttach(pDrvIns) == VERR_PDM_NO_ATTACHED_DRIVER,
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync ("Configuration error: Not possible to attach anything to this driver!\n"),
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Initialize the critical section.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Initialize the data members.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pDrvIns->IBase.pfnQueryInterface = vusbRhQueryInterface;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* the usb device */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.Dev.enmState = VUSB_DEVICE_STATE_ATTACHED;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.Dev.u8NewAddress = VUSB_INVALID_ADDRESS;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.Dev.IDevice.pfnPowerOn = vusbRhDevPowerOn;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.Dev.IDevice.pfnPowerOff = vusbRhDevPowerOff;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.Dev.IDevice.pfnGetState = vusbRhDevGetState;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* the hub */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync //pThis->hub.cPorts - later
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* the connector */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->IRhConnector.pfnSubmitUrb = vusbRhSubmitUrb;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->IRhConnector.pfnReapAsyncUrbs= vusbRhReapAsyncUrbs;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->IRhConnector.pfnCancelAllUrbs= vusbRhCancelAllUrbs;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->IRhConnector.pfnAttachDevice = vusbRhAttachDevice;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->IRhConnector.pfnDetachDevice = vusbRhDetachDevice;
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Resolve interface(s).
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->pIRhPort = PDMIBASE_QUERY_INTERFACE(pDrvIns->pUpBase, VUSBIROOTHUBPORT);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync AssertMsgReturn(pThis->pIRhPort, ("Configuration error: the device/driver above us doesn't expose any VUSBIROOTHUBPORT interface!\n"), VERR_PDM_MISSING_INTERFACE_ABOVE);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Get number of ports and the availability bitmap.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * ASSUME that the number of ports reported now at creation time is the max number.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->Hub.cPorts = pThis->pIRhPort->pfnGetAvailablePorts(pThis->pIRhPort, &pThis->Bitmap);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Log(("vusbRhConstruct: cPorts=%d\n", pThis->Hub.cPorts));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Get the USB version of the attached HC.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * ASSUME that version 2.0 implies high-speed.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync pThis->fHcVersions = pThis->pIRhPort->pfnGetUSBVersions(pThis->pIRhPort);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync Log(("vusbRhConstruct: fHcVersions=%u\n", pThis->fHcVersions));
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Register ourselves as a USB hub.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * The current implementation uses the VUSBIRHCONFIG interface for communication.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync rc = PDMDrvHlpUSBRegisterHub(pDrvIns, pThis->fHcVersions, pThis->Hub.cPorts, &g_vusbHubReg, &pHlp);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Statistics. (It requires a 30" monitor or extremely tiny fonts to edit this "table".)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs submitted.", "/VUSB/%d/UrbsSubmitted", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsSubmitted/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsSubmitted/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsSubmitted/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsSubmitted/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs cancelled. (included in failed)", "/VUSB/%d/UrbsCancelled", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsCancelled/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsCancelled/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsCancelled/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsCancelled/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs failing.", "/VUSB/%d/UrbsFailed", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Bulk transfer.", "/VUSB/%d/UrbsFailed/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Control transfer.", "/VUSB/%d/UrbsFailed/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Interrupt transfer.", "/VUSB/%d/UrbsFailed/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Isochronous transfer.", "/VUSB/%d/UrbsFailed/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested transfer.", "/VUSB/%d/ReqBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested read transfer.", "/VUSB/%d/ReqReadBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqReadBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqReadBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqReadBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqReadBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Total requested write transfer.", "/VUSB/%d/ReqWriteBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ReqWriteBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ReqWriteBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ReqWriteBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ReqWriteBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total transfer.", "/VUSB/%d/ActBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total read transfer.", "/VUSB/%d/ActReadBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActReadBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActReadBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActReadBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActReadBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->Total.StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Actual total write transfer.", "/VUSB/%d/ActWriteBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Bulk transfer.", "/VUSB/%d/ActWriteBytes/Bulk", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Control transfer.", "/VUSB/%d/ActWriteBytes/Ctrl", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Interrupt transfer.", "/VUSB/%d/ActWriteBytes/Intr", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Isochronous transfer.", "/VUSB/%d/ActWriteBytes/Isoc", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Bulk/Urbs", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Bulk/UrbsFailed", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Bulk/UrbsFailed/Cancelled", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transfered.", "/VUSB/%d/Bulk/ActBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Bulk/ActBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Bulk/ActBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Bulk/ReqBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Bulk/ReqBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_BULK].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Bulk/ReqBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* control */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Ctrl/Urbs", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Ctrl/UrbsFailed", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Ctrl/UrbsFailed/Cancelled", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transfered.", "/VUSB/%d/Ctrl/ActBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Ctrl/ActBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Ctrl/ActBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Ctrl/ReqBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Ctrl/ReqBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_CTRL].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Ctrl/ReqBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* interrupt */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Intr/Urbs", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Intr/UrbsFailed", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Intr/UrbsFailed/Cancelled", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transfered.", "/VUSB/%d/Intr/ActBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Intr/ActBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Intr/ActBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Intr/ReqBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Intr/ReqBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_INTR].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Intr/ReqBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* isochronous */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsSubmitted, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of submitted URBs.", "/VUSB/%d/Isoc/Urbs", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsFailed, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of failed URBs.", "/VUSB/%d/Isoc/UrbsFailed", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatUrbsCancelled, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of cancelled URBs.", "/VUSB/%d/Isoc/UrbsFailed/Cancelled", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of bytes transfered.", "/VUSB/%d/Isoc/ActBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Isoc/ActBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatActWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Isoc/ActBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Requested number of bytes.", "/VUSB/%d/Isoc/ReqBytes", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqReadBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Read.", "/VUSB/%d/Isoc/ReqBytes/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aTypes[VUSBXFERTYPE_ISOC].StatReqWriteBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Write.", "/VUSB/%d/Isoc/ReqBytes/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Number of isochronous packets returning data.", "/VUSB/%d/Isoc/ActPkts", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActReadPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Read.", "/VUSB/%d/Isoc/ActPkts/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocActWritePkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Write.", "/VUSB/%d/Isoc/ActPkts/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Requested number of isochronous packets.", "/VUSB/%d/Isoc/ReqPkts", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqReadPkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Read.", "/VUSB/%d/Isoc/ReqPkts/Read", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatIsocReqWritePkts, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "Write.", "/VUSB/%d/Isoc/ReqPkts/Write", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync for (unsigned i = 0; i < RT_ELEMENTS(pThis->aStatIsocDetails); i++)
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Pkts, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Ok, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Ok", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Ok0, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Ok0", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataUnderrun, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataUnderrun", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataUnderrun0, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataUnderrun0", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].DataOverrun, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/DataOverrun", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].NotAccessed, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/NotAccessed", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Misc, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_COUNT, ".", "/VUSB/%d/Isoc/%d/Misc", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->aStatIsocDetails[i].Bytes, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_BYTES, ".", "/VUSB/%d/Isoc/%d/Bytes", pDrvIns->iInstance, i);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync 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);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatSubmitUrb, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Profiling the vusbRhSubmitUrb body.", "/VUSB/%d/SubmitUrb", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->cUrbsInPool, STAMTYPE_U32, STAMVISIBILITY_ALWAYS, STAMUNIT_COUNT, "The number of URBs in the pool.", "/VUSB/%d/cUrbsInPool", pDrvIns->iInstance);
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * VUSB Root Hub driver registration record.
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* u32Version */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* szName */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync "VUSBRootHub",
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* szRCMod */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* szR0Mod */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pszDescription */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync "VUSB Root Hub Driver.",
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* fFlags */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* fClass. */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* cMaxInstances */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* cbInstance */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnConstruct */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnDestruct */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnRelocate */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnIOCtl */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnPowerOn */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnReset */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnSuspend */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnResume */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnAttach */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnDetach */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnPowerOff */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* pfnSoftReset */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync /* u32EndVersion */
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * Local Variables:
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * c-file-style: "bsd"
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * c-basic-offset: 4
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * tab-width: 4
cb4a18edeb5422163b264fe5a66276769cfe864dvboxsync * indent-tabs-mode: s