Access Restricted

This page contains internal documentation that is not publicly available.


DHWCtrl.UsbHostWaitPortStatus

Block until the attach state on Index matches State, or until TimeoutMs milliseconds elapse. Always returns OK with the current Speed (NoDevice if no device is attached, Low / Full / High otherwise) - the host compares the response against its requested State to decide whether the wait condition was met. Use TimeoutMs = 0 to probe.

Properties

Parameters (request frame)

Name Type/Size Description
Index Integer (8 bits) Zero-based instance index within this peripheral category. The valid range is firmware / hardware-variant specific; discoverable via ListPeripherals.
State Enumeration (8 bits) Desired attach state to wait for.
Attach state of a USB host port. Used as the target state for UsbHostWaitPortStatus.
Values (2):
  • Disconnected (0x00)
  • Connected (0x01)
TimeoutMs Integer (16 bits) Maximum time the firmware will wait for the operation to complete, in milliseconds.

Returned values (response frame)

Name Type/Size Description
Speed Enumeration (8 bits) Current bus speed of the attached USB device.
Values (4):
  • NoDevice (0x00)
    No device attached to the port.
  • Low (0x01)
    Low-Speed (1.5 Mbit/s).
  • Full (0x02)
    Full-Speed (12 Mbit/s).
  • High (0x03)
    High-Speed (480 Mbit/s).