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.