contact opened

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

contact opened v15.0.0

Starts the flow when a door or window is opened.

In pins 2
  • device v15.0.0
    value

    Only fire for this device. Leave empty to fire for every matching device.

  • room v15.0.0
    value

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

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. Fires when the contact capability transitions to true, which means OPEN. Note the platform normalises this: Zigbee and Matter both report contact TRUE for a CLOSED door on the wire, and that inversion is corrected at the adapter, so `value` here is true when the door is open.

zigbee
zwave
matter
thread
smart home
home assistant
trigger

A typical wiring for contact opened: the flow out pin feeds debug.

Studio canvas example for the contact opened block: typical wiring for contact opened.

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