Skip to content
CC2 Device Documentation

Dynamic devdata Widgets

Many DVs show real‑time device information by binding a widget’s name directly to a devdata.* key. No portal, MQTT command, or user action is needed — the device updates these values automatically.

How they work:

  • The widget’s name field is set to the exact devdata key path (e.g., devdata.power.gauge).
  • The widget’s interaction is dynamic.
  • The value field is only a placeholder shown before the first real value arrives.

Recognised devdata keys

Section titled “Recognised devdata keys”
Key What it shows Used in
devdata.power.voltage Battery voltage (e.g. 3.8) sysinfo
devdata.power.gauge Battery percentage sysinfo, allocated_home, unallocated_home
devdata.power.isCharged Battery full (YES/NO) sysinfo
devdata.power.isPowered External power present (YES/NO) sysinfo
devdata.accel.orient Orientation (UK, FU, FD, etc.) sysinfo, allocated_home, unallocated_home
devdata.trust.level Trust level (stars graphic) sysinfo
devdata.fw.ver_str Firmware version sysinfo
devdata.fw.rel Firmware release string sysinfo
devdata.fw.device_id Device ID sysinfo, allocated_home, unallocated_home
devdata.fw.device_type Device type string sysinfo
devcfg.wifi.mac WiFi MAC address sysinfo
devcfg.ble.mac BLE (nRF53) MAC address sysinfo
devcfg.bleperi.mac BLE peripheral (nRF52) MAC address sysinfo

Formatters used

Section titled “Formatters used”
  • number — raw value, optional decimal places (dp).
  • percentage — appends %, integer only.
  • bool — shows YES/NO (or localized equivalents via dicts).
  • stars — renders a star rating for trust level.
  • qr — renders the device ID as a QR code.
Section titled “Related”