Skip to content

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

ColorPatternMeaning
GreenSolidPowered on, idle
MagentaSolidScript running
CyanSolidAutostart script running
Orange3 blinksScript execution canceled
Red3 blinks after scriptWrong USB port or charge-only cable on USB
RedSolidFile-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.