USB_DEVICE_ActiveSpeedGet Function

The USB device stack supports both high speed and full speed operations. This function returns the current operation speed of the USB bus. This function should be called after the USB_DEVICE_EVENT_RESET event has occurred.

USB_SPEED USB_DEVICE_ActiveSpeedGet(
    USB_DEVICE_HANDLE usbDeviceHandle
);

Preconditions

The USB device layer must have been initialized and a valid handle to USB device layer must have been opened.

Parameters

Parameters	Description
usbDeviceHandle	Pointer to device layer handle that is returned from USB_DEVICE_Open

Returns

USB_SPEED_LOW - USB module is at low-speed USB_SPEED_FULL - USB module is at full-speed USB_SPEED_HIGH - USB module is at high-speed

Remarks

None.

Example

// This code example shows how the 
// USB_DEVICE_GetDeviceSpeed function can be called to obtain
// the current device speed. This information is also
// available in the USB_DEVICE_EVENT_CONFIGURED event.

if(USB_DEVICE_ActiveSpeedGet(usbDeviceHandle) == USB_SPEED_FULL)
{
    // This means the device attached at full speed.
} 
else if(USB_DEVICE_ActiveSpeedGet(usbDeviceHandle) == USB_SPEED_HIGH)
{
    // This means the device attached at high speed.
}

USB Libraries Help > USB Device Libraries > USB Device Layer Library > Library Interface > d) Device Management Functions > USB_DEVICE_ActiveSpeedGet Function

MPLAB Harmony USB Stack

Contents | Home

Previous | Up | Next

Documentation Feedback
Microchip Support