sensor_gas

Обновлено 20 декабря 2023

Датчик газа.

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

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

Некоторые функции обязательные: они должны быть у всех датчиков газа.

Функция	Обязательная?	Описание
alarm_mute		Выключено ли звуковое оповещение при срабатывании датчика
battery_low_power		Разряжена ли батарея или нет
battery_percentage		Уровень заряда батареи
gas_leak_state	✔︎	Обнаружена ли утечка газа
online	✔︎	Доступность устройства: офлайн или онлайн
sensor_sensitive		Чувствительность датчика
signal_strength		Сила сигнала

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

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

Кроме того, у модели изменены доступные значения для функции signal_strength (сила сигнала): эта модель поддерживает только два уровня силы сигнала. Средний уровень medium не поддерживается и исключен.

{
    "id": "QWERTY124",
    "manufacturer": "Xiaqara",
    "model": "SM1123456789",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "description": "Умный датчик газа Xiaqara",
    "category": "sensor_gas",
    "features": [
        "alarm_mute",    
        "battery_low_power",
        "battery_percentage",
        "gas_leak_state",
        "online",
        "sensor_sensitive",
        "signal_strength",
    ],
    "allowed_values": {
        "signal_strength": {
            "type": "ENUM",
            "enum_values": {
                "values": [
                    "low",
                    "high",
                ]
            }
        }
    }
}

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

Устройство описывается в соответствии со структурой 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",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A"
    },
}