battery low

This block is part of the globals group and was last modified in core v15.0.0.

battery low v15.0.0

Starts the flow when a device's battery drops below the threshold, or reports its own low-battery flag.

In pins 3
  • device v15.0.0
    value

    Only fire for this device. Leave empty for every battery device.

  • room v15.0.0
    value

    Only fire for devices in this room. Leave empty for every room.

  • below % v15.0.0
    number

    Fire when the battery crosses below this percentage.

    Default 20

Out pins 9 + flow
  • flow v15.0.0
    flow
  • device v15.0.0
    object

    The full device: id, name, room, type, capabilities, current state.

  • device id v15.0.0
    value

    Stable platform id, e.g. zigbee:0x00158d0007e1a2b3.

  • name v15.0.0
    value

    The device's friendly name.

  • room v15.0.0
    value

    The room the device is assigned to, empty if none.

  • type v15.0.0
    value

    sensor, light, switch, climate, cover, lock or button.

  • capability v15.0.0
    value

    Which capability changed, e.g. occupancy, contact, power.

  • value v15.0.0
    value

    The new value.

  • previous v15.0.0
    value

    The value before this change, empty on the first report.

  • at v15.0.0
    number

    Unix seconds the device reported.

Start-of-flow trigger for device health. Fires when battery percentage crosses below `below` (default 20), OR when a device raises its own battery_low flag. Both dialects are handled because devices implement one or the other, rarely both.

zigbee
zwave
matter
battery
maintenance
trigger

A typical wiring for battery low: the flow out pin feeds debug.

Studio canvas example for the battery low block: typical wiring for battery low.

Used in these guides

These documentation pages use or explain this block:

Version history

Introduced in v15.0.0.


Back to globals Return to the main group to view all sub-groups Back to home Return to the group to view all blocks within this group