|
|
(не показано 9 промежуточных версий 3 участников) |
Строка 1: |
Строка 1: |
| {{DISPLAYTITLE: Интеграция контроллера Wiren Board и умного дома Sber}} | | {{DISPLAYTITLE: Интеграция контроллера Wiren Board и «Салют! Умный дом»}} |
| [[Image: Sber Mobile.jpg |300px|thumb|right| Диммер WB-MRGBW-D в приложении Салют ]]
| |
| == Описание == | | == Описание == |
| Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]]. | | Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]]. |
|
| |
|
| Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков [https://t.me/smartmarket_community SmartMarket Community]. Подробные инструкции от производителя решения: | | Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков [https://t.me/smartmarket_community SmartMarket Community]. |
| * [https://developers.sber.ru/docs/ru/smarthome/mqtt-integrators/mqtt-to-integrators MQTT-to-Cloud для интегратора],
| |
| * [https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy MQTT-to-Cloud для DIY].
| |
|
| |
|
| Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой.
| | С августа 2024 года решение доступно только для интеграторов, подробнее [https://developers.sber.ru/docs/ru/smarthome/about/overview Об интеграции с умным домом Sber]. Все существующие инсталляции продолжат работать как и прежде, но DIY-любитель не сможет добавить новую. |
|
| |
|
| == Кабинет разработчика == | | == Полезные ссылки == |
| === Создание ===
| |
| Создадим кабинет разработчика и получим данные для подключения, нам понадобится ''Сбер ID'':
| |
| # Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''. По умолчанию у вас будет создано ''Личное пространство'', его мы и будем использовать.
| |
| # Нажмите слева '''+ Создать проект'''.
| |
| # Пролистайте вниз и выберите '''Smart Home'''.
| |
| # Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''.
| |
| # Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''.
| |
| # Нажмите кнопку '''Получить данные для подключения''' и запишите их.
| |
| | |
| <gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика">
| |
| Image: Sber-Cloud-1.png | Страница регистрации
| |
| Image: Sber-Cloud-2.png | Вход по Сбер ID
| |
| Image: Sber-Cloud-3.png | Вход по Сбер ID
| |
| Image: Sber-Cloud-4.png | Соглашение
| |
| Image: Sber-Cloud-5.png | Личный кабинет разработчика
| |
| Image: Sber-Cloud-6.png | Создание проекта
| |
| Image: Sber-Cloud-7.png | Выбор типа интеграции
| |
| Image: Sber-Cloud-8.png | Данные для входа
| |
| </gallery>
| |
| | |
| === Добавление модели устройства ===
| |
| Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.
| |
| | |
| Создадим модель, например, типовой переключатель:
| |
| # Перейдите на вкладку '''Модели'''.
| |
| # Нажмите '''Создать модель'''.
| |
| # Заполните поля:
| |
| #* Идентификатор модели — switch
| |
| #* Производитель — Wiren Board
| |
| #* Название модели — Switch
| |
| #* Категория устройства — Реле
| |
| #* Список функций — on_off, online
| |
| # Нажмите кнопку '''Создать модель'''.
| |
|
| |
|
| Переходим к установке и настройке агента на контроллере.
| | {{Wbincludes: Supported Devices}} |
| | |
| <gallery mode="packed" heights="100px" caption="Создание модели">
| |
| Image: Sber-Model-1.png | Кнопка Создать модель
| |
| Image: Sber-Model-2.png | Идентификатор, производитель и название
| |
| Image: Sber-Model-3.png | Категория устройства и список функций
| |
| </gallery>
| |
| | |
| == Установка и настройка агента ==
| |
| === Установка ===
| |
| {{Wbincludes:Installing Software In Console}} | |
| | |
| Устанавливаем агента SberDevices IoT Agent:
| |
| # Добавьте GPG ключ нового репозитория:
| |
| #:<syntaxhighlight lang="bash">
| |
| wget -q -O - https://nexus.iot.sberdevices.ru/repository/gpg-wirenboard/public.gpg.key | apt-key add -
| |
| </syntaxhighlight>
| |
| # Добавьте ссылку на репозиторий в список apt:
| |
| #:<syntaxhighlight lang="bash">
| |
| echo "deb https://nexus.iot.sberdevices.ru/repository/wirenboard/ main main" | tee -a /etc/apt/sources.list.d/sberdevices-iot.list
| |
| </syntaxhighlight>
| |
| # Обновите список пакетов и установите SberDevices IoT Agent:
| |
| #:<syntaxhighlight lang="bash">
| |
| apt-get update && apt-get install sberdevices-iot-agent
| |
| </syntaxhighlight>
| |
| # Закройте консоль контроллера.
| |
| | |
| Зайдите в веб-интерфейс агента, для этого откройте браузер и введите [[How to find IP address | IP-адрес своего контроллера]] в сети и порт 8083. Например: http://192.168.42.1:8083/
| |
| | |
| === Настройка подключения ===
| |
| Агент настраивается через свой веб-интерфейс:
| |
| # Перейдите в веб-интерфейс SberDevices IoT Agent.
| |
| # В разделе '''Соединение''' нажмите кнопку '''Изменить'''.
| |
| # Введите адрес MQTT-брокера, логин и пароль для подключения, которые вы получили в личном кабинете.
| |
| # Сохраните настройки подключения.
| |
| # Нажмите кнопку '''Обновить'''.
| |
| # Проверьте, что в разделе '''Статус''' написано '''В сети'''. Если это не так, проверьте подключение к интернету и правильнось введённых данных.
| |
| | |
| <gallery mode="packed" heights="100px" caption="Настройка соединения с облаком">
| |
| Image: Sber-Controller-1.png | Веб-интерфейс агента
| |
| Image: Sber-Controller-2.png | Настройка соединения с облаком
| |
| Image: Sber-Controller-3.png | Соединение настроено, статус ''Не в сети''
| |
| Image: Sber-Controller-4.png | После нажатия на кнопку ''Обновить''
| |
| </gallery>
| |
| | |
| === Добавление устройств ===
| |
| Вам понадобятся адреса MQTT-топиков, которые можно посмотреть в [[Wiren Board Web Interface#mqtt-channels | стандартном веб-интерфейсе контроллера]].
| |
| | |
| Добавьте новое устройство, например, Buzzer контроллера:
| |
| # Нажмите на кнопку '''Добавить устройство'''.
| |
| # Если на этапе настройки личного кабинета вы создали модель, выберите её.
| |
| # Придумайте и впишите наименование устройства.
| |
| # На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board:
| |
| #* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code>
| |
| #* on_off → Объект команды — <code>/devices/buzzer/controls/enabled</code>
| |
| #* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code>
| |
| # Нажмите кнопку '''Сохранить'''.
| |
| # Повторите действия выше для каждого устройства.
| |
| | |
| После добавления устройств нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber и они автоматически появятся в мобильном приложении «Салют».
| |
| | |
| <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)">
| |
| Image: Sber-Controller-Device-1.png | Buzzer: Описание
| |
| Image: Sber-Controller-Device-2.png | Buzzer: Функции
| |
| </gallery>
| |
| | |
| <gallery mode="packed" heights="100px" caption="Создание светодиодного диммера">
| |
| Image: Sber-Controller-Device-WB-MRGBW-D-1.png | WB-MRGBW-D: Описание
| |
| Image: Sber-Controller-Device-WB-MRGBW-D-2.png | WB-MRGBW-D: Функции
| |
| Image: Sber-Controller-Device-WB-MRGBW-D-3.png | WB-MRGBW-D: Функции
| |
| </gallery>
| |
| | |
| == Настройка мобильного приложения ==
| |
| Установите мобильное приложение [https://sberdevices.ru/app/ Салют] и авторизуйтесь в нём.
| |
| | |
| Соданные выше устройства будут доступны в разделе '''Умный дом'''.
| |
| | |
| <gallery mode="packed" heights="350px" caption="Мобильное приложение Салют">
| |
| Image: Sber Mobile-1.jpg | Кнопка ''Умный дом''
| |
| Image: Sber Mobile-2.jpg | Список устройств
| |
| Image: Sber Mobile-3.jpg | Диммер WB-MRGBW-D
| |
| </gallery>
| |
| | |
| == Удаление агента ==
| |
| Если ''SberDevices IoT Agent'' больше не нужен, его можно удалить:
| |
| # Удалите пакет:
| |
| #:<syntaxhighlight lang="bash">
| |
| apt remove sberdevices-iot-agent
| |
| </syntaxhighlight>
| |
| # Удалите файл со ссылкой на репозиторий:
| |
| #:<syntaxhighlight lang="bash">
| |
| rm /etc/apt/sources.list.d/sberdevices-iot.list
| |
| </syntaxhighlight>
| |
| # Обновите список доступных системе пакетов:
| |
| #:<syntaxhighlight lang="bash">
| |
| apt update
| |
| </syntaxhighlight>
| |
| | |
| == Полезные ссылки ==
| |
| * [https://developers.sber.ru/docs/ru/smarthome/mqtt-integrators/mqtt-to-integrators Инструкция для интеграторов],
| |
| * [https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy Инструкция для частных разработчиков].
| |
| * [https://t.me/smartmarket_community Коммунити SberDevices]
| |
| * [https://habr.com/ru/company/sberdevices/news/t/659555/ Статья про интеграцию на Хабре]
| |