Контроллер LogicMachine
В браузере откройте веб-интерфейс LogicMachine и перейдите в каталог установленных приложений.
Откройте приложение SberDevices IoT Agent и внизу экрана нажмите Добавить устройство.
На вкладке Устройства опишите устройство: категорию, название, его местоположение в умном доме и др. Если предварительно вы описали модели своих устройств, выберите модель, к которой относится устройство. Это поможет описать его функции на следующем шаге: шаблонный набор функций подставится автоматически.
Подробнее о том, как описать устройство, читайте ниже.
На вкладке Функции опишите функции устройства:
- Если на вкладке Устройства вы не указали модель, проверьте список функций устройства. Если есть лишние функции — удалите их.
- Для каждой функции опишите группы адресов для получения команд и отправки статуса.
Ниже написано, как описывать функции устройств.
Сохраните устройство: нажмите кнопку Сохранить внизу формы.
Как описать устройство
На вкладке Устройство заполните поля:
Категория. Выберите категорию устройства. Выбрать можно только категорию, которую поддерживает умный дом Sber. Если ваше устройство относится к другой категории, управлять им через устройства и ассистентов от Сбера не получится.
Модель. Если вы описывали модели своих устройств, выберите нужную модель. Шаблонный список функций подставится автоматически, и при описании функций вам не придется выбирать функции устройства вручную.
Название. Название устройства в вашем умном доме. Должно быть на русском языке.
Алиасы. Синонимы — альтернативные названия устройства. Будут использоваться в голосовых командах. Должны быть на русском языке.
Дом. Название группы помещений, в которой расположено устройство. Должно быть на русском языке. Если в вашем умном доме Sber есть дом с таким же названием, устройство будет импортировано туда. Если дома с совпадающим названием нет, устройство будет импортировано в дом Sber, который вы создали самым первым (по умолчанию он называется «Мой дом»).
Подробнее о домах см. в разделе Зачем нужны дома справки для пользователей.
Комната. Название помещения, в котором расположено устройство. Должно быть на русском языке. Если в вашем умном доме Sber есть комната с таким же названием, устройство будет импортировано туда. Если комнаты с совпадающим названием нет, устройство будет импортировано в раздел «Без комнаты».
Подробнее о комнатах написано в разделе Зачем нужны комнаты справки для пользователей.
Группы. Названия групп, в которые входит устройство. Должны быть на русском языке.
Если для нескольких устройств вы укажете одну и ту же группу, при импорте устройств в умный дом Sber эта группа будет создана. Если в вашем умном доме Sber уже есть группа с совпадающим названием, устройства добавятся в нее. Группа с названием не на русском не будет импортирована.
Обратите внимание, что в группы можно объединять только устройства одной или схожих категорий. Например, в группу можно объединить светодиодную ленту и лампу, а розетку и лампу — уже нельзя. Также учитывайте, что группа умеет выполнять только те команды, которые поддерживают все входящие в нее устройства. Если устройство, в котором недоступна какая-то функция, добавить в группу, то эта функция будет недоступна для всей группы.
Подробнее о группах см. в разделе Зачем нужны группы справки для пользователей.
Пример описания устройства. В примере описано реле, указана его модель — QWERTY124.
Категория: relay
Модель: QWERTY124
Название: Мое реле
Алиасы: Смарт-реле, Умный переключатель
Дом: Мой дом
Комната: Гостиная
Группы: Видеотехника, Проводка
Как описать функции устройства
Перейдите на вкладку Функции.
Если при описании устройства вы не выбирали его модель, проверьте список функций на форме. Все они будут отображаться в вашем умном доме Sber, поэтому удалите те функции, которые не относятся к устройству и не будут работать. Для этого нажмите
в блоке каждой ненужной функции.
Если для устройства выбрана модель, на форму автоматически добавятся все функции модели — вручную удалять ненужное не придется.
Для каждой функции выберите групповые адреса и, при необходимости, правило трансформации значений. Групповые адреса импортируются в форму из контроллера, если вы не понимаете, для чего предназначен конкретный адрес, посмотрите его свойства в интерфейсе LogicMachine.
Объект команды. Групповой адрес, с которого ваше устройство получает команды.
В терминах коммуникационной шины KNX объект команды — это групповой адрес, на который отправляет телеграммы сенсор, и который слушает актуатор.
Например, если вы описываете функции умной лампы, то она является актуатором, должна слушать этот адрес и выполнять пришедшие на него от сенсора (например, настенного выключателя) команды.
Объект статуса. Групповой адрес, на который ваше устройство отправляет сведения о своем статусе или команды на смену статуса для других устройств.
В терминах коммуникационной шины KNX объект статуса — это групповой адрес, на который отправляет телеграммы актуатор. Например, если вы описываете функции умной лампы, она должна отправлять на этот адрес сведения о своем статусе: включилась, выключилась, поменяла цвет на зеленый и т. п.
Если устройство не умеет оповещать о своем статусе, можно указать, что оно всегда сообщает статус true или false. Для этого введите
__trueили__false.Трансформация. Если на объект команды приходят численные значения, может оказаться так, что в умном доме Sber для этой команды используется один диапазон допустимых значений, а в контроллере — другой. Тогда команды, которые будет отправлять на объект команды умный дом Sber, не будут выполнены или будут выполнены не так, как ожидается.
Например, вы описываете умную лампу, которая принимает команды на изменение яркости в формате byte, т. е. яркость может быть установлена в диапазоне от 0 до 255. Умный дом Sber же отправляет команды на изменение яркости в диапазоне от 10 до 1000. Получается несоответствие шкал: если вы в приложении Салют отдадите команду сделать яркость на 50%, облако умного дома Sber отправит на объект команды значение 500. Лампа, получив это значение, не сможет корректно обработать его, т. к. ожидает значение от 0 до 255.
Чтобы избежать подобной ошибки, для функции яркости нужно задать правило преобразования из формата умного дома Sber в формат объекта команды. Для этого найдите описание функции в справочнике API и посмотрите диапазон ее допустимых значений.
Затем в веб-интерфейсе LogicMachine найдите групповой адрес объекта команды, на который должна отправляться команда, перейдите к его свойствам и посмотрите тип данных в поле Data type — этот формат и определяет границы диапазона.
Если диапазон умного дома Sber отличается от диапазона объекта адреса, создайте правило: в поле Трансформация выберите
integer_scale. Под полем отобразится формат записи правила — введите правило в поле Аргументы в указанном формате.Например, для функции яркости light_brightness правило будет иметь такой вид:
10,1000->0,255.
Пример описания функции. В примере описана функция light_colour_temp — температура цвета.
Объект команды: 0/0/1
Объект статуса: 0/0/2
Трансформация: integer_scale
Аргументы: 0,1000->0,255