SberDevices: различия между версиями
Matveevrj (обсуждение | вклад) |
|||
| (не показаны 32 промежуточные версии 1 участника) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Интеграция контроллера Wiren Board | {{DISPLAYTITLE: Интеграция контроллера Wiren Board и умного дома Sber}} | ||
[[Image: Sber Mobile.jpg |300px|thumb|right| Диммер WB-MRGBW-D в приложении Салют ]] | [[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''' и нажмите кнопку '''Создать проект'''. | ||
| Строка 37: | Строка 32: | ||
=== Добавление модели устройства === | === Добавление модели устройства === | ||
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики. | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | Создадим модель, например, типовой переключатель: | ||
# Перейдите на вкладку '''Модели'''. | |||
# Нажмите '''Создать модель'''. | |||
# Заполните поля: | # Заполните поля: | ||
#* Идентификатор модели — switch | #* Идентификатор модели — switch | ||
| Строка 45: | Строка 42: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online. online выбирать обязательно. | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Переходим к установке и настройке агента на | Переходим к установке и настройке агента на контроллере. | ||
<gallery mode="packed" heights="100px" caption="Создание модели"> | <gallery mode="packed" heights="100px" caption="Создание модели"> | ||
| Строка 60: | Строка 57: | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
Устанавливаем агента: | Устанавливаем агента SberDevices IoT Agent: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
| Строка 71: | Строка 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="Настройка соединения с облаком"> | <gallery mode="packed" heights="100px" caption="Настройка соединения с облаком"> | ||
| Строка 91: | Строка 90: | ||
</gallery> | </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> | ||
| Строка 100: | Строка 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 (Реле)"> | <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | ||
| Строка 144: | Строка 144: | ||
== Полезные ссылки == | == Полезные ссылки == | ||
* [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}} | |||
Текущая версия на 11:40, 15 февраля 2023
Описание
Контроллеры Wiren Board можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через MQTT.
Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков SmartMarket Community. Подробные инструкции от производителя решения:
Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой.
Кабинет разработчика
Создание
Создадим кабинет разработчика и получим данные для подключения, нам понадобится Сбер ID:
- Зарегистрируйтесь на сайте SmartMarket Studio с помощью Сбер ID. По умолчанию у вас будет создано Личное пространство, его мы и будем использовать.
- Нажмите слева + Создать проект.
- Пролистайте вниз и выберите Smart Home.
- Введите название проекта, выберите MQTT-to-Cloud для DIY и нажмите кнопку Создать проект.
- Придумайте название контроллера и введите его в поле Доступ к облаку умного дома Sber.
- Нажмите кнопку Получить данные для подключения и запишите их.
- Настройка кабинета разработчика
Страница регистрации
Вход по Сбер ID
Вход по Сбер ID
Соглашение
Личный кабинет разработчика
Создание проекта
Выбор типа интеграции
Данные для входа
Добавление модели устройства
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.
Создадим модель, например, типовой переключатель:
- Перейдите на вкладку Модели.
- Нажмите Создать модель.
- Заполните поля:
- Идентификатор модели — switch
- Производитель — Wiren Board
- Название модели — Switch
- Категория устройства — Реле
- Список функций — on_off, online. online выбирать обязательно.
- Нажмите кнопку Создать модель.
Переходим к установке и настройке агента на контроллере.
- Создание модели
Кнопка Создать модель
Идентификатор, производитель и название
Категория устройства и список функций
Установка и настройка агента
Установка
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.
Устанавливаем агента SberDevices IoT Agent:
- Добавьте GPG ключ нового репозитория:
wget -q -O - https://nexus.iot.sberdevices.ru/repository/gpg-wirenboard/public.gpg.key | apt-key add -
- Добавьте ссылку на репозиторий в список apt:
echo "deb https://nexus.iot.sberdevices.ru/repository/wirenboard/ main main" | tee -a /etc/apt/sources.list.d/sberdevices-iot.list
- Обновите список пакетов и установите SberDevices IoT Agent:
apt update && apt install sberdevices-iot-agent
- Закройте консоль контроллера.
Зайдите в веб-интерфейс агента, для этого откройте браузер и введите IP-адрес своего контроллера в сети и порт 8083. Например: http://192.168.42.1:8083/
Настройка подключения
Агент настраивается через свой веб-интерфейс:
- Перейдите в веб-интерфейс SberDevices IoT Agent.
- В разделе Соединение нажмите кнопку Изменить.
- Введите адрес MQTT-брокера, логин и пароль для подключения, которые вы получили в личном кабинете.
- Сохраните настройки подключения.
- Нажмите кнопку Обновить.
- Проверьте, что в разделе Статус написано В сети. Если это не так, проверьте подключение к интернету и правильнось введённых данных.
- Настройка соединения с облаком
Веб-интерфейс агента
Настройка соединения с облаком
Соединение настроено, статус Не в сети
После нажатия на кнопку Обновить
Добавление устройств
Вам понадобятся адреса MQTT-топиков, которые можно посмотреть в стандартном веб-интерфейсе контроллера.
Добавьте новое устройство, например, Buzzer контроллера:
- Нажмите на кнопку Добавить устройство.
- Если на этапе настройки личного кабинета вы создали модель, выберите её.
- Придумайте и впишите наименование устройства.
- На вкладке Функции укажите топики устройства в контроллере Wiren Board:
- online → Объект статуса —
/devices/buzzer/controls/enabled: OK - on_off → Объект команды —
/devices/buzzer/controls/enabled - on_off → Объект статуса —
/devices/buzzer/controls/enabled
- online → Объект статуса —
- Нажмите кнопку Сохранить.
- Повторите действия выше для каждого устройства.
После добавления устройств нажмите кнопку Перезапустить — данные о них будут отправлены в облако Sber. Перейдите в приложении «Салют» в раздел «Мой дом» и сдвиньте экран вниз, чтобы обновился список.
- Создание Buzzer (Реле)
Buzzer: Описание
Buzzer: Функции
- Создание светодиодного диммера
WB-MRGBW-D: Описание
WB-MRGBW-D: Функции
WB-MRGBW-D: Функции
Настройка мобильного приложения
Установите мобильное приложение Салют и авторизуйтесь в нём.
Соданные выше устройства будут доступны в разделе Умный дом.
- Мобильное приложение Салют
Кнопка Умный дом
Список устройств
Диммер WB-MRGBW-D
Удаление агента
Если SberDevices IoT Agent больше не нужен, его можно удалить:
- Удалите пакет:
apt remove sberdevices-iot-agent
- Удалите файл со ссылкой на репозиторий:
rm /etc/apt/sources.list.d/sberdevices-iot.list
- Обновите список доступных системе пакетов:
apt update
Полезные ссылки
- Инструкция для интеграторов,
- Инструкция для частных разработчиков.
- Коммунити SberDevices
- Статья про интеграцию на Хабре