ym88659208ym87991671
Шаг 3. Добавление моделей устройств DIY | Документация для разработчиков

Шаг 3. Добавление моделей устройств

Обновлено 22 декабря 2024

Для устройств, которыми вы хотите управлять через облако умного дома Sber, нужно описать модели. Вы будете использовать их при добавлении устройств в агенте или на контроллере.

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

Чтобы добавить модель:

  1. В Studio откройте проект интеграции.

  2. На вкладке

    Модели устройств
    в правом верхнем углу нажмите Создать модель.

  3. В поля формы введите характеристики и функции модели:

    • Идентификатор модели. Идентификатор модели (часто product_id).

    • Производитель. Производитель устройства.

    • Название модели. Название модели у производителя.

    • Версия оборудования. Версия аппаратного модуля.

    • Версия прошивки. Версия прошивки аппаратного модуля.

    • Описание. Произвольное описание устройства.

    • Категория устройства. К какой категории относится модель устройства.

    • Список функций. Функции модели устройства: что устройства этой модели умеют делать. Набор доступных функций зависит от категории устройства, подробнее смотрите в разделе Функции устройств.

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

      В списке Функция выберите зависимую функцию — ее доступность зависит от другой функции. В списке зависит от выберите определяющую функцию — от ее состояния зависит зависимая функция. В последнем раскрывающемся списке выберите значения определяющей функции, при которых зависимая функция становится доступной.

      Подробнее о зависимостях см. в разделе Зависимость функций (dependencies).

  4. Нажмите Создать модель.

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

В примере описан датчик температуры и влажности, который умеет сообщать о температуре, также нам известен его статус: онлайн или офлайн.

Идентификатор модели: my_temp_sensor
Производитель: Xiaqara
Название модели: SM1123456789
Описание: Temperature and humidity sensor
Категория устройства: Датчик температуры и влажности
Список функций: online, temperature
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.