open_state

Last updated on June 17, 2024

Data type: ENUM.

Usage method: stores the device state without changing it.

Purpose: shows the device's opening status:

• open – opened.
• close – closed.
• opening – is opening.
• closing – is closing.

When describing the device model, the list of available operation modes of a function can be shortened.

Devices with this function

• curtain – curtains.
• gate – gates.
• valve – motorized valves.
• window_blind – louvered blinds, roll blinds.

Examples of voice commands

— Салют, что со шторами? (Salute, what's up with the curtains?)

— Салют, в каком положении ворота? (Salute, what is the position of the gate?)

— Салют, подняты ли жалюзи? (Salute, are the louvered blinds open?)

— Салют, проверь состояние крана в ванной (Salute, check the condition of the valve in the bathroom)

Function description for a device model

The function must be added to the model descriptions of all devices that support it.

"features": [
    "open_state",
    // ...
]

Function state description example

The example describes a device whose state is open.

{
    "states": [
        {
            "key": "open_state",
            "value": {
                "type": "ENUM",
                "enum_value": "open"
            }
        }
    ]
}