sensor_temp

Датчик температуры и влажности.

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

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

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

Если же вы описываете датчик температуры и влажности, обязательно нужно перечислить все три функции: online, humidity, temperature.

Функция Обязательная? Описание
air_pressure Атмосферное давление
battery_low_power Разряжена ли батарея или нет
battery_percentage Уровень заряда батареи
humidity ✔︎ Влажность. Функция обязательна для датчиков влажности и датчиков температуры и влажности. Для датчиков температуры, которые влажность не измеряют, её указывать не нужно
online ✔︎ Доступность устройства: офлайн или онлайн
sensor_sensitive Чувствительность датчика
signal_strength Сила сигнала
temp_unit_view Температурная шкала, в которой датчик сейчас выводит информацию о температуре на свой экран: °C или °F. Используйте только для датчиков с экраном, которые умеют показывать температуру в разных температурных шкалах
temperature ✔︎ Температура. Функция обязательна для датчиков температуры и датчиков температуры и влажности. Для датчиков влажности, которые температуру не измеряют, её указывать не нужно

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

Модель описывается в соответствии со структурой model. В примере описан датчик температуры и влажности, который умеет сообщать о температуре, влажности и атмосферном давлении. Также датчик сообщает о силе сигнала, уровне заряда батареи и разряжена ли батарея, имеет настройку чувствительности. Датчик оснащён экраном, умеет показывать на экране температуру в °C и °F.

{
    "id": "QWERTY124",
    "manufacturer": "Xiaqara",
    "model": "SM1123456789",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "description": "Умный датчик температуры и влажности Xiaqara",
    "category": "sensor_temp",
    "features": [
        "online",
        "humidity",
        "temperature",
        "air_pressure",
        "battery_low_power",
        "battery_percentage",
        "sensor_sensitive",
        "signal_strength",
        "temp_unit_view",
    ]
}

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

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

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

{
    "id": "ABCD_004",
    "parent_id": "A_002",
    "name": "Мой датчик температуры и влажности",
    "default_name": "Умный датчик температуры и влажности",
    "nicknames": [
        "Датчик микроклимата",
        "Температурный датчик",
    ],
    "home": "Мой дом",
    "room": "Гостиная",
    "model_id": "QWERTY124",
    "hw_version": "3.1",
    "sw_version": "5.6"
}

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней