ym88659208ym87991671
hvac_ac | Documentation SmartMarket
Skip to main content

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.

FunctionMandatory?Description
hvac_air_flow_directionDirection of the air flow
hvac_air_flow_powerFan speed
hvac_humidity_setAir humidity setting
hvac_ionizationIonization mode
hvac_night_modeNight mode
hvac_temp_set✔︎Air temperature setting
hvac_work_modeWork 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"
}