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