Skip to main content

Blind — blind

A window covering: shade, blind, drape, or shutter. The common relay-driven case declares supports_position = false and two relay control connections; a motor with a position encoder declares supports_position = true.

Capabilities​

Declared in the driver manifest under [[proxy]] capabilities. Anything not declared takes the default below.

CapabilityTypeDefaultMeaning
invert_positionboolfalseDevice reports 0 as fully closed rather than fully open
supports_positionboolfalseCan be commanded to an intermediate position
supports_stopbooltrue
supports_tiltboolfalseSlats tilt independently of position
travel_time_msu320Full open→closed time; lets core estimate position without an encoder

Commands​

close​

No parameters.

open​

No parameters.

set_position​

Only present when supports_position is declared true.

0 = fully closed, 100 = fully open

ParameterTypeNotes
positionu8 0–100

set_tilt​

Only present when supports_tilt is declared true.

ParameterTypeNotes
tiltu8 0–100

stop​

Only present when supports_stop is declared true.

No parameters.

Notifications​

moving_changed​

ParameterTypeNotes
movingone of opening · closing · stopped

online_changed​

ParameterTypeNotes
onlinebool

position_changed​

ParameterTypeNotes
positionu8 0–100

tilt_changed​

Only present when supports_tilt is declared true.

ParameterTypeNotes
tiltu8

State​

Last-known values core keeps for a binding of this proxy.

KeyTypeMeaning
movingstring
onlinebool
positionu8
tiltu8