socket

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

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

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

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

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если умная розетка не умеет измерять текущее энергопотребление, включать функции 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",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A"
    },
}