ZeroTrace HID
RGB LED Control
Drive the on-board RGB LED from scripts and read the default status colors
The on-board single-pixel RGB LED is the device's primary feedback channel for in-the-field operation — no display needed. Control it from scripts with the led* commands. Colors are RGB integer triplets (0–255 each), not hex strings.
Script LED colors are three separate 0–255 integers (r g b). Hex strings (#RRGGBB) are accepted only for the startup color config, not for the script commands below.
Setting a color
Sets a solid color and leaves it on.
ledColor 255 0 255 # solid magenta
ledColor 0 128 0 # dim green
Brightness
ledBrightness takes a single 0–255 value; anything out of range is ignored (no-op). The default is 50 (100 on Ghost).
ledBrightness 128
Startup color
The color shown at boot is a config value (startup_led_color, default green). It accepts a preset name, a hex string, or rainbow:
red green blue yellow purple orange white cyan #RRGGBB rainbow
Default status colors
When you aren't overriding the LED from a script, the firmware drives it to reflect device state:
| State | Color |
|---|---|
| Idle / powered on | Green |
| Script running | Magenta |
| Autostart script | Cyan, then green |
| Script stopped / canceled | Orange, 3 blinks |
While Recon Mode is on, all LED output is suppressed — status colors and script led* commands alike. The device runs dark.
Use cases
- Ack-after-payload: flash green when a script finishes.
- Plant-and-trigger: blink cyan to confirm an autostart fired.
- Fleet locate: give each TraceNetwork device a distinct startup color and find it with the fleet Identify action from the mobile app.