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

relay

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

Реле — устройство, которое по команде включает или выключает питание присоединенного прибора: светильника, розетки и др. Обычно подключается к электропроводке.

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

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

У устройства есть две обязательные функции: online, on_off. Они должны быть у всех реле.

ФункцияОбязательная?Описание
currentТекущий ток, мА
on_off✔︎Удаленное включение и выключение устройства
online✔︎Доступность устройства: офлайн или онлайн
powerТекущая мощность, Вт
voltageТекущее напряжение, В

Пример описания модели реле

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

Кроме того, у модели изменены доступные значения для функции power (потребляемая мощность): указано, что устройства этой модели умеют измерять мощность в диапазоне от 10 до 45000 ватт с шагом в 1 ватт.

{
"id": "QWERTY124",
"manufacturer": "Xiaqara",
"model": "SM1123456789",
"hw_version": "3.1",
"sw_version": "5.6",
"description": "Умное реле Xiaqara",
"category": "relay",
"features": [
"online",
"on_off",
"current",
"power",
"voltage"
],
"allowed_values": {
"power": {
"type": "INTEGER",
"integer_values": {
"min": "10",
"max": "45000",
"step": "1"
}
}
}
}

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

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

{
"id": "ABCD_004",
"name": "Мое реле",
"default_name": "Умное реле",
"nicknames": ["Смарт-реле", "Умный переключатель"],
"home": "Мой дом",
"room": "Гостиная",
"groups": ["Видеотехника", "Проводка"],
"model_id": "QWERTY124",
"hw_version": "3.1",
"sw_version": "5.6",
"partner_meta": {
"internal-id": 1234,
"specificity": "microchip 2A"
},
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.