Skip to content

LED Config

Controls the four LEDs on the device. Each LED can be set to ON, OFF, blink, flash, or pulse for a precise duration.

Key path: devcfg.led

{
"devcfg": {
"led": {
"led0": "P100",
"led1": "S0",
"led2": "F0",
"led3": "B0"
}
}
}

Note For one-shot LED commands, use the corresponding actions: {"a":"led0","p":"P100"} — see LED actions. The devcfg.led keys set the LED’s state/default directly; prefer the action form for one-off commands to keep behaviour consistent with the rest of the app/actions API.

The four led0led3 keys do not control four independent LEDs. The device has two physical bi-color LEDs, each with a green and a red channel:

Physical LEDGreen channelRed channel
LED 1led0led1
LED 2led2led3

Driving both channels of the same physical LED at once (e.g. led0 and led1 both set to the same state) affects that single LED’s apparent color, not two separate indicators. Keep this in mind when designing alert/status patterns.

Verification note The green/red channel mapping above (LED1 = led0/led1, LED2 = led2/led3) was confirmed by physical hardware testing. If you’re updating firmware or DV logic that assumes independent LEDs, confirm this mapping still holds for your hardware revision.

LED 0 behaviour (LED 1, green channel).

Configuration variables

  • Type: string (LED command)
  • Default: "P100"
CodeMeaning
S0Set ON
S1Set OFF
B1Blink fast
B0Blink slow
F1Flash long
F0Flash short
P + numberPulse for number × 10 ms (e.g., P100 = 1 s)

LED 1 behaviour (LED 1, red channel). Same command syntax as led0 — see the discrepancy note above.

Configuration variables

  • Type: string (LED command)
  • Default: "S1" (OFF)
{ "devcfg": { "led": { "led1": "B0" } } }

LED 2 behaviour (LED 2, green channel). Same command syntax as led0 — see the discrepancy note above.

Configuration variables

  • Type: string (LED command)
  • Default: "F0"
{ "devcfg": { "led": { "led2": "P50" } } }

LED 3 behaviour (LED 2, red channel). Same command syntax as led0 — see the discrepancy note above.

Configuration variables

  • Type: string (LED command)
  • Default: "B0"
{ "devcfg": { "led": { "led3": "S1" } } }