ZeroTrace HID
RGB LED Control
Drive the on-board RGB LED from scripts
The on-board RGB LED is the device's primary feedback channel for in-the-field operation (no display needed). Control it from scripts with the led primitives.
Primitives
led color "#ff00ff" # solid magenta
led pulse "#00ff88" 1000 # pulse green, 1 s period
led blink "#ffaa00" 200 200 # blink amber, 200 ms on / 200 ms off
led off # all LEDs off
led brightness 50 # 0-100
Default firmware patterns
| Color | Pattern | Meaning |
|---|---|---|
| Green | Solid | Powered on, idle |
| Magenta | Solid | Script running |
| Cyan | Solid | Autostart script running |
| Orange | 3 blinks | Script execution canceled |
| Red | 3 blinks after script | Wrong USB port or charge-only cable on USB |
| Red | Solid | File-system error |
Recon mode interaction
recon mode on overrides all LED commands — the LED stays dark regardless of script state. recon mode off restores the prior color and pattern. See Recon Mode.
Use cases
- Ack-after-payload — flash green when a script finishes successfully.
- Visual handshake during plant-and-trigger — blink cyan to confirm autostart fired.
- Status badge for TraceNetwork agents — assign each device a distinct color via
identify.