Skip to main content
Version: V3.0

Standard Device Model


Device Basic Ability Control

Control TypeAbility Descriptionlightswitchbuttoncoverclimatelocksensorbinary_sensor
turn_onTurn on
turn_offTurn off
toggleToggle
pressPress
lockLock
unlockUnlock
openOpen
closeClose
stopStop


Device Basic State

State TypeState Descriptionlightswitchbuttoncoverclimatelocksensorbinary_sensor
onOn
offOff
pressPress
releaseRelease
openOpen
openingOpening
closedClose
closingClosing
lockedLocked
unlockedUnlocked
{value}Value


Device Additional Attribute Information

Additional Attribute ParameterTypeAdditional Attribute DescriptionAdditional Attribute ControlAdditional Attribute StateMatch-able Device Type
typeStringSensor type:
infrared
smoke
gas
flood
motion
tamper
door
co
safety
binary_sensor
typeStringSensor type:
battery
temperature
humidity
brightness
energy
power
sensor
brightnessIntegerBrightness, scope: 0-255light
brightness_percentIntegerBrightness percentage,
scope: 0-100
light
brightness_levelStringBrightness level:
low: low brightness level
medium: medium brightness level
high: high brightness level
light
min_miredsIntegerMinimum color temperature, scope: 153-500light
max_miredsIntegerMaximum color temperature, scope: 153-500light
color_temperatureIntegerColor temperature, scope from min_mireds to max_miredslight
hs_color[]IntegerColor gamut based on HSV.
Parameter format: [h, s]
h: 0-360
s: 0-100
light
white_valueIntegerWhite value, scope: 0-100light
preset_modeStringPreset mode:
home
away
sleep
standby
comfort
eco
protect
auto
energy_saving
performance
climate
support_preset_mode[]StringSupported preset mode:
home
away
sleep
standby
comfort
eco
protect
auto
energy_saving
performance
climate
preset_temperatureFloatPreset temperature,
scope: 5.0-35.0
climate
hvac_modeStringAir conditioning mode:
unknown
off
heat
cool
auto
floor_heat
fan_only
dry
manual
program
auxiliary_heat
heat_and_auxiliary_heat
holiday
temp_manual
climate
support_hvac_mode[]StringSupported air conditioning mode:
unknown
off
heat
cool
auto
floor_heat
fan_only
dry
manual
program
auxiliary_heat
heat_and_auxiliary_heat
holiday
temp_manual
climate
fan_modeStringFan mode:
unknown
off
auto
very_low
low
medium
high
top
auto_medium
climate
support_fan_mode[]StringSupported fan mode:
unknown
off
auto
very_low
low
medium
high
top
auto_medium
climate
position_percentIntegerPosition percent, scope: 0-100cover
tilt_angle_percentIntegerTilt angle percent, scope: 0-100cover
support_statusBooleanSupported in-progress state:
true: support opening and closing state
false: not support opening and closing state
cover
doorbellStringDoorbell:
on
off
lock