Добавление типовых устройств в SberDevices IoT Agent
Обобщенный процесс добавления устройств
Для добавления устройства в веб-интерфейсе агента SberDevices IoT Agent нажмите кнопку Добавить устройство. Затем заполните поля:
- Название — пользовательское название устройства, например «Ночник», «Торшер» и т. д.
- Категория — категория устройства. Все категории перечислены в справочнике поддерживаемых умным домом Sber устройств.
- Комната — место расположения устройства в доме клиента.
После на вкладке Функции укажите топики для обязательных функций — примеры для разных типов устройств приведены ниже. Подходящие для устройства функции можно посмотреть, выбрав нужный девайс в списке устройств. Все функции устройств умного дома приведены в общем справочнике функций.
Подробно о добавлении устройств читайте в разделе Добавление устройств в приложении SberDevices IoT Agent.
Осветительный прибор
Обязательные функции для устройства light — online и on_off. В качестве примера приведен осветительный прибор, подключенный к диммеру WB-MDM3 со slaveID 57, а именно к выходу первого каналу O1:
-
Для функции online необходимо указать топик в поле Объект статуса. Рекомендуем использовать объекты с суффиксом
OK
— они сообщают об отсутствии ошибок, относящихся топикам настраиваемого устройства. Для диммера из примера нужно указать топик/devices/wb-mdm3_57: OK
.Также объект может передавать постоянный статус
true
илиfalse
. Для этого введите__true
или__false
. -
Для функции on_off необходимо указать топики в полях Объект команды и Объект статуса. Для диммера из примера нужно указать топик
/devices/wb-mdm3_57/controls/K1
в обоих полях.

Осветительный прибор с регулировкой яркости
Обязательные функции для устройства light — online и on_off. В качестве примера приведен осветительный прибор, подключенный к диммеру WB-MDM3 со slaveID 57, а именно к выходу первого каналу O1:
-
Для функции online необходимо указать топик в поле Объект статуса. Рекомендуем использовать объекты с суффиксом
OK
— они сообщают об отсутствии ошибок, относящихся топикам настраиваемого устройства. Для диммера из примера нужно указать топик/devices/wb-mdm3_57: OK
.Также объект может передавать постоянный статус
true
илиfalse
. Для этого введите__true
или__false
. -
Для функции on_off необходимо указать топики в полях Объект команды и Объект статуса. Для диммера из примера нужно указать топик
/devices/wb-mdm3_57/controls/K1
в обоих полях. -
За управление яркостью отвечает функция light_brightness. Чтобы добавить ее, нужно нажать на поле Выберите функцию, найти функцию light_brightness и нажать Добавить. После необходимо заполнить поля:
-
В полях Объект команды и Объект статуса нужно вписать топик
/devices/wb-mdm3_57/controls/Chanel 1
. -
Так как диапазон значений функции в облаке Sber и диапазон значений у устройства в контроллере различаются, необходимо создать правило трансформации. В карточке функции light_brightness нужно выбрать трансформацию integer_scale и указать соответствие минимального значения в облаке Sber (50) минимальному значению в контроллере (1), а также максимального значения в облаке Sber (1000) максимальному значению в контроллере (100).
Чтобы добавить правило, нажмите Сохранить на форме правила трансформации, а затем — кнопку Добавить на форме функции light_brightness.
-
Светодиодная лента
Обязательные функции для устройства led_strip — online и on_off. В качестве примера приведена лента, подключенная к диммеру WB-LED со slaveID 39 и с режимом работы RGB + W:
-
Для функции online необходимо указать топик в поле Объект статуса. Рекомендуем использовать объекты с суффиксом
OK
— они сообщают об отсутствии ошибок, относящихся топикам настраиваемого устройства. Для диммера из примера нужно указать топик/devices/wb-led_39: OK
.Также объект может передавать постоянный статус
true
илиfalse
. Для этого введите__true
или__false
. -
Для функции on_off необходимо указать топики в полях Объект кома нды и Объект статуса. Для диммера из примера нужно указать топик
/devices/wb-led_39/controls/RGB Strip
в обоих полях. -
За управление яркостью отвечает функция light_brightness. Чтобы добавить ее, нужно нажать на поле Выберите функцию, найти функцию light_brightness и выбрать Добавить. После необходимо заполнить поля:
-
В полях Объект команды и Объект статуса нужно вписать топик
/devices/wb-led_39/controls/RGB Brightness
. -
Так как диапазон значений функции в облаке Sber и диапазон значений у устройства в контроллере различаются, необходимо создать правило трансформации. В карточке функции light_brightness нужно выбрать трансформацию integer_scale и указать соответствие минимального значения в облаке Sber (50) минимальному значению в контроллере (1), а также максимального значения в облаке Sber (1000) максимальному значению в контроллере (100).
Чтобы добавить правило, нажмите Сохранить на форме правила трансформации, а затем — кнопку Добавить на форме функции light_brightness.
-
-
За управление цветом отвечает функция light_colour. Чтобы добавить ее, нужно нажать на поле Выберите функцию, найти функцию light_brightness и выбрать Добавить. После в полях Объект команды и Объект статуса необходимо вписать топик
/devices/wb-led_39/controls/RGB Palette
.