hvac_ac
An air conditioner is a device that can change the temperature and other air characteristics in a room.
Available device functions
The device may have all the following functions or just some of them. For example, if an air conditioner cannot regulate the humidity in a room, there is no need to include the hvac_humidity_set
function in the description of its model.
A device complies with three mandatory functions: online
, on_off
, hvac_temp_set
. All air conditioners must have this functions.
Function | Mandatory? | Description |
hvac_air_flow_direction | Direction of the air flow | |
hvac_air_flow_power | Fan speed | |
hvac_humidity_set | Air humidity setting | |
hvac_ionization | Ionization mode | |
hvac_night_mode | Night mode | |
hvac_temp_set | ✔︎ | Air temperature setting |
hvac_work_mode | Work mode of the air conditioner | |
on_off | ✔︎ | Switching the device on and off remotely |
online | ✔︎ | Device availability: offline or online |
A sample description of an air conditioner model
The model is described in accordance with the model structure. An air conditioner described in the sample has all functions except for the ionization mode.
{
"id": "QWERTY124",
"manufacturer": "Xiaqara",
"model": "SM1123456789",
"hw_version": "3.1",
"sw_version": "5.6",
"description": "Xiaqara smart air conditioner",
"category": "hvac_ac",
"features": [
"online",
"on_off",
"hvac_temp_set",
"hvac_air_flow_direction",
"hvac_air_flow_power",
"hvac_humidity_set",
"hvac_night_mode",
"hvac_work_mode"
]
}
A sample description of an air conditioner of a user
The model is described in accordance with the device structure. In the sample there is no description of the air conditioner model, therefore we believe that the models are described in a separate file and it is sufficient to specify only the model ID (in this case, QWERTY124).
{
"id": "ABCD_004",
"name": "My air conditioner",
"default_name": "Smart air conditioner",
"nicknames": [
"Intelligent air conditioner",
"Controlled air conditioner",
],
"home": "My home",
"room": "Living room",
"groups": [
"Climate",
"Cooling",
],
"model_id": "QWERTY124",
"hw_version": "3.1",
"sw_version": "5.6"
}