Access Restricted
This page contains internal documentation that is not publicly available.
DHWCtrl.UsbHostTransferIn
IN transfer on (Addr, Ep). Attr selects pipe type; Mps
is the endpoint's wMaxPacketSize. Firmware reads up to
MaxLen bytes; returns the bytes actually read in Data.
Properties
- Command code: 0xE128
- Command timeout: 100 ms
- Possible status codes: General status codes, DHWCtrl.ErrInvalidIndex, DHWCtrl.ErrNotActive, DHWCtrl.ErrUsbNotConnected, DHWCtrl.ErrUsbStall, DHWCtrl.ErrUsbTransfer, DHWCtrl.ErrUsbBufferOverflow, DHWCtrl.ErrTimeout, DHWCtrl.ErrInvalidParam, DHWCtrl.ErrHardware
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. | |
| Addr | Integer (8 bits) |
USB device address on the host port.
(Minimum value: 0, maximum value: 127) |
|
| Ep | Integer (8 bits) |
USB endpoint number. Direction is implied by the command.
(Minimum value: 0, maximum value: 15) |
|
| Attr | Enumeration (8 bits) |
Endpoint type for a USB host data transfer.
Values (3):
|
|
| Mps | Integer (16 bits) | Endpoint's wMaxPacketSize (16-bit field per USB descriptor). | |
| MaxLen | Integer (16 bits) | Maximum number of bytes to read from the endpoint. | |
| 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 |
|---|---|---|
| Length of Data | Integer (16 bits) |
Length of Data in bytes |
| Data | Raw data | Bytes returned by the device on the IN endpoint. |