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.