Domain Reference

HOS organizes devices into five domains. Each domain defines a set of device types, standard state fields, and commands.

For the full list of deviceType values, tag conventions, and property schemas, see Entity & Type Reference.

---

Lighting

Device Types

• light — Smart bulb, LED strip
• switch — On/off switch (no dimming)
• dimmer — Dimmable switch/controller

State Fields

Field	Type	Description
power	boolean	Whether the light is on or off
brightness	number	Brightness level (0-100)
color	string	Color value (hex string, e.g. "#FF0000")
colorTemperature	number	Color temperature in Kelvin

Commands

• turn_on
• turn_off
• set_brightness
• set_color
• set_color_temperature

---

AV/Media

Device Types

• tv — Television
• receiver — Audio/video receiver
• speaker — Smart speaker, soundbar
• media_player — Streaming device, set-top box

State Fields

Field	Type	Description
power	boolean	Whether the device is on or off
volume	number	Volume level (0-100)
playback	string	Playback state: "playing", "paused", "stopped"
title	string	Currently playing media title
artist	string	Currently playing artist
track	string	Currently playing track name

Commands

• turn_on
• turn_off
• set_volume
• mute
• unmute
• play
• pause
• stop
• set_input

---

Climate

Device Types

• thermostat — Temperature controller
• hvac — HVAC system
• fan — Fan, ventilation

State Fields

Field	Type	Description
power	boolean	Whether the system is on or off
temperature	number	Current temperature reading
targetTemperature	number	Desired temperature setpoint
mode	string	Operating mode: "heat", "cool", "auto", "off"
humidity	number	Current humidity percentage

Commands

• turn_on
• turn_off
• set_temperature
• set_mode
• set_fan_speed

---

Security

Device Types

• lock — Door lock, smart lock
• sensor — Motion sensor, door/window sensor
• camera — Security camera
• alarm — Alarm panel

State Fields

Field	Type	Description
locked	boolean	Whether the lock is engaged
armed	boolean	Whether the alarm/sensor is armed
triggered	boolean	Whether the sensor has been triggered
battery	number	Battery level percentage (0-100)

Commands

• lock
• unlock
• arm
• disarm

---

Robot Vacuums

Device Types

• robot_vacuum — Robot vacuum cleaner

State Fields

Field	Type	Description
status	string	Current state: "cleaning", "docked", "returning", "error"
battery	number	Battery level percentage (0-100)
errorCode	string	Error code if status is "error"

Commands

• start
• stop
• dock
• find

---

What's Next

• Entity & Type Reference — Complete deviceType values, commandCatalog schema, tag conventions, and target object
• Driver Manifest — Package your driver as an OS-local ZIP upload
• Troubleshooting — Common errors and solutions