sensor_air

Обновлено 23 июня 2026

Датчик качества воздуха.

Доступные функции устройства

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если датчик не умеет сообщать об уровне заряда батареи, включать функцию battery_percentage в описание его модели не нужно.

Для датчика обязательной является функция online. Также обязательно должна быть описана хотя бы одна из следующих функций: temperature, humidity, co2, pm1_0, pm2_5, pm10, tvoc_float, hcho_float.

Функция	Обязательная?	Описание
battery_low_power		Разряжена батарея или нет
battery_percentage		Уровень заряда батареи
online	✔︎	Доступность устройства: офлайн или онлайн
signal_strength		Сила сигнала
temp_unit_view		Температурная шкала, в которой датчик выводит информацию о температуре на свой экран
temperature	✔︎*	Текущая температура
humidity	✔︎*	Текущая влажность
co2	✔︎*	Текущая концентрация CO2
pm1_0	✔︎*	Текущая концентрация частиц PM1.0
pm2_5	✔︎*	Текущая концентрация частиц PM2.5
pm10	✔︎*	Текущая концентрация частиц PM10
tvoc_float	✔︎*	Текущая концентрация частиц летучих органических соединений TVOC
hcho_float	✔︎*	Текущая концентрация частиц формальдегида HCHO

Пример описания модели датчика качества воздуха

Модель описывается в соответствии со структурой model. В примере описан датчик качества воздуха, который умеет сообщать текущую температуру, влажность, концентрацию CO₂, а также уровни частиц PM1.0, PM2.5, PM10, летучих органических соединений (TVOC) и формальдегида (HCHO). Также датчик сообщает о силе сигнала, уровне заряда батареи и разряжена ли батарея.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный датчик качества воздуха Xiaqara",
   "category": "sensor_air",
   "features": [
      "battery_low_power",
      "battery_percentage",
      "online",
      "signal_strength",
      "co2",
      "humidity",
      "temp_unit_view",
      "temperature",
      "pm1_0",
      "pm2_5",
      "pm10",
      "hcho_float",
      "tvoc_float"
   ]
}

Пример описания датчика качества воздуха пользователя

Устройство описывается в соответствии со структурой device. В примере нет описания модели датчика — считаем, что модели описаны отдельно, поэтому достаточно указать только ID модели (здесь — QWERTY124).

Для датчика указан parent_id — идентификатор хаба, через который датчик подключен к умному дому.

{
    "id": "ABCD_004",
    "parent_id": "A_002",
    "name": "Мой датчик качества воздуха",
    "default_name": "Умный датчик качества воздуха",
    "home": "Мой дом",
    "room": "Спальня",
    "model_id": "QWERTY124",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A"
    },
}