hvac_ac
An air conditioner is a device capable of changing temperature and other characteristics of the air in the 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 |
| humidity | Current humidity | |
| hvac_air_flow_direction | Air flow direction | |
| hvac_air_flow_power | Fan speed | |
| hvac_humidity_set | Desired air humidity | |
| hvac_ionization | Ionization mode | |
| hvac_night_mode | Night mode | |
| hvac_temp_set | ✔︎ | Desired air temperature |
| hvac_work_mode | Air conditioner operation mode | |
| on_off | ✔︎ | Turning the device on and off remotely |
| online | ✔︎ | Device availability: offline or online |
| temperature | Current temperature |
Air conditioner model description example
The model shall be described in accordance with the model structure. The example describes an air conditioner equipped with all functions except for the ionization mode.
Besides, allowed values for the hvac_air_flow_power function (fan speed) of the model are changed: the quiet mode is not supported by the model and therefore deleted.
{
"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"
],
"allowed_values": {
"hvac_air_flow_power": {
"type": "ENUM",
"enum_values": {
"values": [
"auto",
"high",
"low",
"medium",
"turbo"
]
}
}
}
}
User's air conditioner description example
The device shall be describe in accordance with the device structure. The example contains no air conditioner model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).
{
"id": "ABCD_004",
"name": "My air conditioner",
"default_name": "Smart air conditioner",
"nicknames": ["Controlled air conditioner", "Manageable air conditioner"],
"home": "My home",
"room": "Living room",
"groups": ["Climate", "Cooling"],
"model_id": "QWERTY124",
"hw_version": "3.1",
"sw_version": "5.6",
"partner_meta": {
"internal-id": 1234,
"specificity": "microchip 2A"
},
}