hub

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

Хаб — центр управления умным домом. Передает в умный дом Sber сведения о своем статусе — онлайн или офлайн. По этому статусу умный дом Sber понимает, доступны ли устройства, подключенные через хаб: если хаб офлайн, то и все подключенные через него устройства будут иметь тот же статус.

У устройств, подключаемых к умному дому через хаб, должно быть заполнено поле parent_id — в нем должен быть указан ID хаба в системе вендора.

Обратите внимание, что если хаб умеет не только подключать устройства к умному дому, но и сам обладает функциями умного устройства, например, является лампочкой или розеткой, то описывать хаб нужно структурой этого устройства: light, socket или др. Если же хаб только подключает устройства или его дополнительные функции еще не поддерживаются умным домом Sber, описывайте его структурой hub.

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

Функция	Обязательная?	Описание
online	✔︎	Доступность устройства: офлайн или онлайн

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

Модель описывается в соответствии со структурой model. Описан хаб, умеющий только подключать другие устройства к умному дому.

{
    "id": "QWERTY124",
    "manufacturer": "Xiaqara",
    "model": "SM1123456789",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "description": "Умный хаб Xiaqara",
    "category": "hub",
    "features": [
        "online",
    ]
}

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

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