ym88659208ym87991671
Устройство socket | Документация SmartMarket
Skip to main content

socket

Разъем для подключения к электросети. Примеры:

  • Розетка
  • Удлинитель

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

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

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

ФункцияОбязательная?Описание
child_lockБлокировка кнопки питания от детей
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": "socket",
"features": [
"online",
"on_off",
"sleep_timer",
"child_lock",
"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"
}
Обновлено 15 июня 2022

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

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