SberDevices: различия между версиями
(Добавил про установку gpg) |
|||
(не показано 30 промежуточных версий 2 участников) | |||
Строка 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''' и нажмите кнопку '''Создать проект'''. | ||
# Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | # Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | ||
# Нажмите кнопку '''Получить данные для подключения''' и запишите их. | # Нажмите кнопку '''Получить данные для подключения''' и запишите их. | ||
<gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | <gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | ||
Строка 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 — программу для работы с ключами шифрования. | |||
#:<syntaxhighlight lang="bash"> | |||
apt install gpg | |||
</syntaxhighlight> | |||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
Строка 71: | Строка 72: | ||
# Обновите список пакетов и установите 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: | Строка 94: | ||
</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: | Строка 106: | ||
#* 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: | Строка 148: | ||
== Полезные ссылки == | == Полезные ссылки == | ||
* [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}} |
Текущая версия на 15:19, 17 июля 2024
Описание
Контроллеры Wiren Board можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через MQTT.
Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков SmartMarket Community. Подробные инструкции от производителя решения:
Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой.
Кабинет разработчика
Создание
Создадим кабинет разработчика и получим данные для подключения, нам понадобится Сбер ID:
- Зарегистрируйтесь на сайте SmartMarket Studio с помощью Сбер ID. По умолчанию у вас будет создано Личное пространство, его мы и будем использовать.
- Нажмите слева + Создать проект.
- Пролистайте вниз и выберите Smart Home.
- Введите название проекта, выберите MQTT-to-Cloud для DIY и нажмите кнопку Создать проект.
- Придумайте название контроллера и введите его в поле Доступ к облаку умного дома Sber.
- Нажмите кнопку Получить данные для подключения и запишите их.
- Настройка кабинета разработчика
Добавление модели устройства
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.
Создадим модель, например, типовой переключатель:
- Перейдите на вкладку Модели.
- Нажмите Создать модель.
- Заполните поля:
- Идентификатор модели — switch
- Производитель — Wiren Board
- Название модели — Switch
- Категория устройства — Реле
- Список функций — on_off, online. online выбирать обязательно.
- Нажмите кнопку Создать модель.
Переходим к установке и настройке агента на контроллере.
- Создание модели
Установка и настройка агента
Установка
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.
Устанавливаем агента SberDevices IoT Agent:
- Установите GPG — программу для работы с ключами шифрования.
apt install gpg
- Добавьте 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 (Реле)
- Создание светодиодного диммера
Настройка мобильного приложения
Установите мобильное приложение Салют и авторизуйтесь в нём.
Соданные выше устройства будут доступны в разделе Умный дом.
- Мобильное приложение Салют
Удаление агента
Если SberDevices IoT Agent больше не нужен, его можно удалить:
- Удалите пакет:
apt remove sberdevices-iot-agent
- Удалите файл со ссылкой на репозиторий:
rm /etc/apt/sources.list.d/sberdevices-iot.list
- Обновите список доступных системе пакетов:
apt update
Полезные ссылки
- Инструкция для интеграторов,
- Инструкция для частных разработчиков.
- Коммунити SberDevices
- Статья про интеграцию на Хабре