kettle

Обновлено 13 апреля 2025

Чайник.

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

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

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

Функция	Обязательная?	Описание
child_lock		Блокировка от детей
kitchen_water_level		Количество воды в устройстве в литрах
kitchen_water_low_level		Закончилась ли вода в устройстве
kitchen_water_temperature		Текущая температура воды в устройстве
kitchen_water_temperature_set		Температура, до которой нужно нагреть воду
on_off	✔︎	Удаленное включение и выключение устройства
online	✔︎	Доступность устройства: офлайн или онлайн

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

Модель описывается в соответствии со структурой model. В примере описан чайник, который обладает всеми функциями.

У модели изменены доступные значения для функции kitchen_water_temperature_set (температура, до которой нужно нагреть воду): у этой модели минимальная температура нагрева — 60 °C, а шаг изменения температуры — 10 °C.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный чайник Xiaqara",
   "category": "kettle",
   "features": [
      "child_lock",
      "kitchen_water_level",
      "kitchen_water_low_level",
      "kitchen_water_temperature",
      "kitchen_water_temperature_set",
      "on_off",
      "online",
   ],
   "allowed_values": {
      "kitchen_water_temperature_set": {
         "type": "INTEGER",
         "integer_values": {
            "min": "60",
            "max": "100",
            "step": "10"
         }
      }
   }
}

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

Устройство описывается в соответствии со структурой 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"
   },
}