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.

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"
}