LED
LED overrides a status LED or returns it to the box's status display. Each chip has one green LED. Fire-and-forget.
LEDOverride or restore a status LED
LED forces a chip's green LED to a pattern or returns it to auto status display. Opcode 0x09.
LED 0x09 · payload 3 bytes
Fire-and-forget
| Offset | Field | Type | Notes |
|---|---|---|---|
| 0 | target | u8 | which chip's LED (see below) |
| 1 | mode | u8 | drive mode (see below) |
| 2 | level | u8 | brightness 0-255; used by solid and blink, ignored for off and auto |
| Target | Value | LED |
|---|---|---|
| device | 0 | Device chip LED. |
| host | 1 | Host chip LED, relayed over the inter-chip link. |
| both | 2 | Both LEDs. |
| Mode | Value | Effect |
|---|---|---|
| auto | 0 | Box status display (see below). |
| off | 1 | LED dark. |
| solid | 2 | Lit steadily at level brightness. |
| blink | 3 | Blinks at level brightness. |
In auto (the default), each chip's LED shows that chip's state.
Device chip: solid with link, mouse, and clone all up. Slow blink with the link up but the mouse or clone missing. Off with no link.
Host chip: solid while the mouse streams, off otherwise.
An override holds until auto, control-PC silence (the same ~1 s timeout that clears injection), RESET, or inter-chip link loss.
Invisible to the game PC: a host or both override travels only over the inter-chip link. Library binding: led.
Both LEDs to blink at level = 200 (0xC8):