Интеграция контроллера Wiren Board и умного дома Sber

From Wiren Board
This is the approved revision of this page, as well as being the most recent.
Диммер WB-MRGBW-D в приложении Салют

Описание

Контроллеры Wiren Board можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через MQTT.

Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков SmartMarket Community. Подробные инструкции от производителя решения:

Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой.

Кабинет разработчика

Создание

Создадим кабинет разработчика и получим данные для подключения, нам понадобится Сбер ID:

  1. Зарегистрируйтесь на сайте SmartMarket Studio с помощью Сбер ID. По умолчанию у вас будет создано Личное пространство, его мы и будем использовать.
  2. Нажмите слева + Создать проект.
  3. Пролистайте вниз и выберите Smart Home.
  4. Введите название проекта, выберите MQTT-to-Cloud для DIY и нажмите кнопку Создать проект.
  5. Придумайте название контроллера и введите его в поле Доступ к облаку умного дома Sber.
  6. Нажмите кнопку Получить данные для подключения и запишите их.

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

Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.

Создадим модель, например, типовой переключатель:

  1. Перейдите на вкладку Модели.
  2. Нажмите Создать модель.
  3. Заполните поля:
    • Идентификатор модели — switch
    • Производитель — Wiren Board
    • Название модели — Switch
    • Категория устройства — Реле
    • Список функций — on_off, online. online выбирать обязательно.
  4. Нажмите кнопку Создать модель.

Переходим к установке и настройке агента на контроллере.

Установка и настройка агента

Установка

Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.

Устанавливаем агента SberDevices IoT Agent:

  1. Добавьте GPG ключ нового репозитория:
    wget -q -O - https://nexus.iot.sberdevices.ru/repository/gpg-wirenboard/public.gpg.key | apt-key add -
    
  2. Добавьте ссылку на репозиторий в список apt:
    echo "deb https://nexus.iot.sberdevices.ru/repository/wirenboard/ main main" | tee -a /etc/apt/sources.list.d/sberdevices-iot.list
    
  3. Обновите список пакетов и установите SberDevices IoT Agent:
    apt update && apt install sberdevices-iot-agent
    
  4. Закройте консоль контроллера.

Зайдите в веб-интерфейс агента, для этого откройте браузер и введите IP-адрес своего контроллера в сети и порт 8083. Например: http://192.168.42.1:8083/

Настройка подключения

Агент настраивается через свой веб-интерфейс:

  1. Перейдите в веб-интерфейс SberDevices IoT Agent.
  2. В разделе Соединение нажмите кнопку Изменить.
  3. Введите адрес MQTT-брокера, логин и пароль для подключения, которые вы получили в личном кабинете.
  4. Сохраните настройки подключения.
  5. Нажмите кнопку Обновить.
  6. Проверьте, что в разделе Статус написано В сети. Если это не так, проверьте подключение к интернету и правильнось введённых данных.

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

Вам понадобятся адреса MQTT-топиков, которые можно посмотреть в стандартном веб-интерфейсе контроллера.

Добавьте новое устройство, например, Buzzer контроллера:

  1. Нажмите на кнопку Добавить устройство.
  2. Если на этапе настройки личного кабинета вы создали модель, выберите её.
  3. Придумайте и впишите наименование устройства.
  4. На вкладке Функции укажите топики устройства в контроллере Wiren Board:
    • online → Объект статуса — /devices/buzzer/controls/enabled: OK
    • on_off → Объект команды — /devices/buzzer/controls/enabled
    • on_off → Объект статуса — /devices/buzzer/controls/enabled
  5. Нажмите кнопку Сохранить.
  6. Повторите действия выше для каждого устройства.

После добавления устройств нажмите кнопку Перезапустить — данные о них будут отправлены в облако Sber. Перейдите в приложении «Салют» в раздел «Мой дом» и сдвиньте экран вниз, чтобы обновился список.

Настройка мобильного приложения

Установите мобильное приложение Салют и авторизуйтесь в нём.

Соданные выше устройства будут доступны в разделе Умный дом.

Удаление агента

Если SberDevices IoT Agent больше не нужен, его можно удалить:

  1. Удалите пакет:
    apt remove sberdevices-iot-agent
    
  2. Удалите файл со ссылкой на репозиторий:
    rm /etc/apt/sources.list.d/sberdevices-iot.list
    
  3. Обновите список доступных системе пакетов:
    apt update
    

Полезные ссылки