translator, wb_editors
4251
правка
SberDevices: различия между версиями
Нет описания правки
Matveevrj (обсуждение | вклад) |
|||
| (не показано 45 промежуточных версий 1 участника) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Интеграция контроллера Wiren Board | {{DISPLAYTITLE: Интеграция контроллера Wiren Board и умного дома Sber}} | ||
[[Image: Sber Mobile.jpg |300px|thumb|right| Диммер WB-MRGBW-D в приложении Салют ]] | |||
== Описание == | == Описание == | ||
Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и | Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]]. | ||
Облачную платформу и агента для интеграции разрабатывает компания Sber | Облачную платформу и агента для интеграции (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), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой. | |||
== Кабинет разработчика == | == Кабинет разработчика == | ||
=== Создание === | === Создание === | ||
Создадим кабинет разработчика и получим данные для подключения, нам понадобится ''Сбер ID'': | |||
# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''. По умолчанию у вас будет создано ''Личное пространство'', его мы и будем использовать. | |||
# Нажмите слева '''+ Создать проект'''. | |||
# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''. | |||
# Нажмите '''Создать проект'''. | |||
# Пролистайте вниз и выберите '''Smart Home'''. | # Пролистайте вниз и выберите '''Smart Home'''. | ||
# Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''. | # Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''. | ||
# Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | # Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | ||
# Нажмите кнопку '''Получить данные для подключения''' и запишите их. | # Нажмите кнопку '''Получить данные для подключения''' и запишите их. | ||
<gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | <gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | ||
| Строка 32: | Строка 32: | ||
=== Добавление модели устройства === | === Добавление модели устройства === | ||
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики. | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | Создадим модель, например, типовой переключатель: | ||
# Перейдите на вкладку '''Модели'''. | |||
# Нажмите '''Создать модель'''. | |||
# Заполните поля: | # Заполните поля: | ||
#* Идентификатор модели — switch | #* Идентификатор модели — switch | ||
| Строка 40: | Строка 42: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online. online выбирать обязательно. | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Переходим к установке и настройке агента на | Переходим к установке и настройке агента на контроллере. | ||
<gallery mode="packed" heights="100px" caption="Создание модели"> | <gallery mode="packed" heights="100px" caption="Создание модели"> | ||
| Строка 55: | Строка 57: | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
Устанавливаем агента: | Устанавливаем агента SberDevices IoT Agent: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
| Строка 66: | Строка 68: | ||
# Обновите список пакетов и установите SberDevices IoT Agent: | # Обновите список пакетов и установите SberDevices IoT Agent: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt | apt update && apt install sberdevices-iot-agent | ||
</syntaxhighlight> | </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 контроллера: | Добавьте новое устройство, например, Buzzer контроллера: | ||
# | # Нажмите на кнопку '''Добавить устройство'''. | ||
# Если на этапе настройки личного кабинета вы создали модель, выберите её. | |||
# Придумайте и впишите наименование устройства. | |||
# На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | # На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | ||
#* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | #* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | ||
| Строка 85: | Строка 102: | ||
#* 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:// | * [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://t.me/smartmarket_community Коммунити SberDevices] | ||
* [https://habr.com/ru/company/sberdevices/news/t/659555/ Статья на Хабре] | * [https://habr.com/ru/company/sberdevices/news/t/659555/ Статья про интеграцию на Хабре] | ||
{{Wbincludes: Supported Devices}} | |||