Skip to content
CC2 Device Documentation

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.

Physical LED layout

Section titled “Physical LED layout”

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

Physical LED Green channel Red channel
LED 1 led0 led1
LED 2 led2 led3

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.

led0

Section titled “led0”

LED 0 behaviour (LED 1, green channel).

Configuration variables

  • Type: string (LED command)
  • Default: "P100"
Code Meaning
S0 Set ON
S1 Set OFF
B1 Blink fast
B0 Blink slow
F1 Flash long
F0 Flash short
P + number Pulse for number × 10 ms (e.g., P100 = 1 s)

led1

Section titled “led1”

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",
    },
  },
}

led2

Section titled “led2”

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",
    },
  },
}

led3

Section titled “led3”

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",
    },
  },
}
Section titled “Related”