Access Restricted
This page contains internal documentation that is not publicly available.
DHWCtrl command group
Hardware-test commands for production-line bring-up of
BALTECH readers. Peripheral-agnostic: bundles Ethernet, GPIO,
USB host, and flash test commands behind one opaque BRP
group. Commands address peripherals by name, so the same
firmware binary serves every hardware variant in a family.
WARNING: This command set is not available in all Baltech reader firmware variants.
Status codes
| BRP status | BRP Library Error Code | Mnemonic | Description |
|---|---|---|---|
| 0x01 | 0xE101 (57601) | DHWCtrl.ErrInvalidIndex | Peripheral instance Index is out of range for this firmware. The valid range per category is discoverable via ListPeripherals. |
| 0x02 | 0xE102 (57602) | DHWCtrl.ErrNotActive | Peripheral instance is not activated. |
| 0x03 | 0xE103 (57603) | DHWCtrl.ErrAlreadyActive | Peripheral instance is already active. Call Deactivate first to change pinset or MAC. |
| 0x04 | 0xE104 (57604) | DHWCtrl.ErrInvalidParam | Parameter out of range (e.g. unknown pinset, bad enum value, wrong direction bit in a control SETUP). |
| 0x05 | 0xE105 (57605) | DHWCtrl.ErrTimeout | Operation did not complete within the requested timeout. |
| 0x10 | 0xE110 (57616) | DHWCtrl.ErrEthFrameTooBig | Ethernet frame longer than 1518 bytes (excluding CRC). |
| 0x20 | 0xE120 (57632) | DHWCtrl.ErrUsbNotConnected | No device on this USB host port. |
| 0x21 | 0xE121 (57633) | DHWCtrl.ErrUsbStall | Endpoint returned STALL. |
| 0x22 | 0xE122 (57634) | DHWCtrl.ErrUsbTransfer | Transfer-level error (CRC, invalid PID, framing). |
| 0x23 | 0xE123 (57635) | DHWCtrl.ErrUsbBufferOverflow | Device returned more data than the requested in_len / max_len. |
| 0x30 | 0xE130 (57648) | DHWCtrl.ErrFlashRange | Sector + count outside slot bounds, or len(data) % sector_size != 0 on FlashWrite. |
| 0x31 | 0xE131 (57649) | DHWCtrl.ErrFlashWrite | Programming failed (driver-reported verify mismatch or NACK). |
| 0x32 | 0xE132 (57650) | DHWCtrl.ErrFlashErase | Erase failed. |
| 0xFF | 0xE1FF (57855) | DHWCtrl.ErrHardware | Underlying driver returned an unrecoverable error. |