ym88659208ym87991671
Устройство sensor_door | Документация для разработчиков

sensor_door

Обновлено 30 августа 2023

Датчик открытия.

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

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

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

ФункцияОбязательная?Описание
battery_low_powerРазряжена ли батарея или нет
battery_percentageУровень заряда батареи
doorcontact_state✔︎Показывает, разомкнуты или сомкнуты контакты датчика. Если контакты разомкнуты, значит, створки двери, окна или другой подобной конструкции открыты. Сомкнутые контакты означают, что створки закрыты
online✔︎Доступность устройства: офлайн или онлайн
sensor_sensitiveЧувствительность датчика
signal_strengthСила сигнала
tamper_alarmСигнализация о вскрытии датчика

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

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

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

{
"id": "QWERTY124",
"manufacturer": "Xiaqara",
"model": "SM1123456789",
"hw_version": "3.1",
"sw_version": "5.6",
"description": "Умный датчик открытия Xiaqara",
"category": "sensor_door",
"features": [
"online",
"doorcontact_state",
"battery_low_power",
"battery_percentage",
"sensor_sensitive",
"signal_strength",
"tamper_alarm"
],
"allowed_values": {
"sensor_sensitive": {
"type": "ENUM",
"enum_values": {
"values": [
"auto",
"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"
},
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.