Добавление устройств на контроллере Wiren Board

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

1. В браузере откройте адрес http://<IP-адрес контроллера>:8083/.

2. Внизу экрана нажмите Добавить устройство.

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

   Подробнее о том, как описать устройство, читайте ниже.

4. На вкладке Функции опишите функции устройства:

   • Если на вкладке Устройства вы не указали модель, проверьте список функций устройства. Если есть лишние функции — удалите их.
   • Для каждой функции опишите группы адресов для получения команд и отправки статуса.

   Ниже написано, как описывать функции устройств.

5. Сохраните устройство: нажмите кнопку Сохранить внизу формы.

Как описать устройство

На вкладке Устройство заполните поля:

• Категория. Выберите категорию устройства. Выбрать можно только категорию, которую поддерживает умный дом Sber. Если ваше устройство относится к другой категории, управлять им через устройства и ассистента от Сбера не получится.

• Модель. Если вы описывали модели своих устройств, выберите нужную модель. Шаблонный список функций подставится автоматически, и при описании функций вам не придется выбирать функции устройства вручную.

• Название. Название устройства в вашем умном доме. Должно быть на русском языке.

• Алиасы. Синонимы — альтернативные названия устройства. Будут использоваться в голосовых командах. Должны быть на русском языке.

• Дом. Название группы помещений, в которой расположено устройство. Должно быть на русском языке. Если в вашем умном доме Sber есть дом с таким же названием, устройство будет импортировано туда. Если дома с совпадающим названием нет, устройство будет импортировано в дом Sber, который вы создали самым первым (по умолчанию он называется «Мой дом»).

  Подробнее о домах см. в разделе Зачем нужны дома справки для пользователей.

• Комната. Название помещения, в котором расположено устройство. Должно быть на русском языке. Если в вашем умном доме Sber есть комната с таким же названием, устройство будет импортировано туда. Если комнаты с совпадающим названием нет, устройство будет импортировано в раздел «Без комнаты».

  Подробнее о комнатах написано в разделе Зачем нужны комнаты справки для пользователей.

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

  Если для нескольких устройств вы укажете одну и ту же группу, при импорте устройств в умный дом Sber эта группа будет создана. Если в вашем умном доме Sber уже есть группа с совпадающим названием, устройства добавятся в нее. Группа с названием не на русском не будет импортирована.

  Обратите внимание, что в группы можно объединять только устройства одной или схожих категорий. Например, в группу можно объединить светодиодную ленту и лампу, а розетку и лампу — уже нельзя. Также учитывайте, что группа умеет выполнять только те команды, которые поддерживают все входящие в нее устройства. Если устройство, в котором недоступна какая-то функция, добавить в группу, то эта функция будет недоступна для всей группы.

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

Пример описания устройства. В примере описано реле, указана его модель — QWERTY124.

Категория: relay
Модель: QWERTY124
Название: Мое реле
Алиасы: Смарт-реле, Умный переключатель
Дом: Мой дом
Комната: Гостиная
Группы: Видеотехника, Проводка

Как описать функции устройства

1. Перейдите на вкладку Функции.

2. Если при описании устройства вы не выбирали его модель, проверьте список функций на форме. Все они будут отображаться в вашем умном доме Sber, поэтому удалите те функции, которые не относятся к устройству и не будут работать. Для этого нажмите

   
   в блоке каждой ненужной функции.

   Если для устройства выбрана модель, на форму автоматически добавятся все функции модели — вручную удалять ненужное не придется.

3. Для каждой функции выберите соответствующий топик, более подробная информация о внутреннем представлении устройств Wiren Board доступна в документации.

   • Объект команды. Топик для отправки команд.

     Например, если вы описываете функции реле, то объект команды должен соответствовать топику настраиваемого канала реле. Пример топика: /devices/wb-gpio/controls/EXT1_K1.

   • Объект статуса. Топик для получения статуса устройства.

     Например, если вы описываете функции реле, то объект статуса должен соответствовать топику настраиваемого канала реле. Пример топика: /devices/wb-gpio/controls/EXT1_K1.

     Для функции online рекомендуется использовать объекты с суффиксом OK, они сообщают об отсутствии ошибок, относящихся к соответствующему топику.

     Также объект может передавать постоянный статус true или false. Для этого введите __true или __false.

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

     Например, вы описываете умную лампу, которая принимает команды на изменение яркости в диапазоне 0-100. Умный дом Sber же отправляет команды на изменение яркости в диапазоне от 10 до 1000. Получается несоответствие шкал: если в приложении Салют клиент отдаст команду сделать яркость на 50%, облако умного дома Sber отправит на объект команды значение 500. Лампа, получив это значение, не сможет корректно обработать его, т. к. ожидает значение от 0 до 100.

     Чтобы избежать подобной ошибки, для функции яркости нужно задать правило преобразования из формата умного дома Sber в формат объекта команды. Для этого найдите описание функции в справочнике API и посмотрите диапазон ее допустимых значений.

     Если диапазон умного дома Sber отличается от диапазона объекта адреса, создайте правило: в поле Трансформация выберите integer_scale. Под полем отобразится формат записи правила — введите правило в поле Аргументы в указанном формате.

     Например, для функции яркости light_brightness правило будет иметь такой вид: 10,1000->0,100.

Пример описания функции. В примере описана функция light_colour_temp — температура цвета.

Объект команды: /devices/wb-mrgbw-d-fw3_101/controls/RGB Strip Brightness
Объект статуса: /devices/wb-mrgbw-d-fw3_101/controls/RGB Strip Brightness
Трансформация: integer_scale
Аргументы: 0,1000->0,100