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

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

• 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.

Related

• Identity widgets — user_name, user_role (not devdata)
• Device Views overview — list of all DVs