Blind — blind v1
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.
| Capability | Type | Default | Meaning |
|---|---|---|---|
invert_position | bool | false | Device reports 0 as fully closed rather than fully open |
supports_position | bool | false | Can be commanded to an intermediate position |
supports_stop | bool | true | |
supports_tilt | bool | false | Slats tilt independently of position |
travel_time_ms | u32 | 0 | Full open→closed time; lets core estimate position without an encoder |
Commands
close
No parameters.
open
No parameters.
set_position
Only present when
supports_positionis declared true.
0 = fully closed, 100 = fully open
| Parameter | Type | Notes |
|---|---|---|
position | u8 0–100 |
set_tilt
Only present when
supports_tiltis declared true.
| Parameter | Type | Notes |
|---|---|---|
tilt | u8 0–100 |
stop
Only present when
supports_stopis declared true.
No parameters.
Notifications
moving_changed
| Parameter | Type | Notes |
|---|---|---|
moving | one of opening · closing · stopped |
online_changed
| Parameter | Type | Notes |
|---|---|---|
online | bool |
position_changed
| Parameter | Type | Notes |
|---|---|---|
position | u8 0–100 |
tilt_changed
Only present when
supports_tiltis declared true.
| Parameter | Type | Notes |
|---|---|---|
tilt | u8 |
State
Last-known values core keeps for a binding of this proxy.
| Key | Type | Meaning |
|---|---|---|
moving | string | |
online | bool | |
position | u8 | |
tilt | u8 |