SberDevices: различия между версиями
(Добавил про установку gpg) |
|||
(не показано 7 промежуточных версий 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]]. | ||
Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания 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-integrators/mqtt-to-integrators MQTT-to-Cloud для интегратора], | ||
* [https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy MQTT-to-Cloud для DIY]. | * [https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy MQTT-to-Cloud для DIY]. | ||
Строка 42: | Строка 44: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Строка 58: | Строка 60: | ||
Устанавливаем агента SberDevices IoT Agent: | Устанавливаем агента SberDevices IoT Agent: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
Строка 72: | Строка 70: | ||
# Обновите список пакетов и установите SberDevices IoT Agent: | # Обновите список пакетов и установите SberDevices IoT Agent: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt update && apt install sberdevices-iot-agent | apt-get update && apt-get install sberdevices-iot-agent | ||
</syntaxhighlight> | </syntaxhighlight> | ||
# Закройте консоль контроллера. | # Закройте консоль контроллера. | ||
Строка 108: | Строка 106: | ||
# Повторите действия выше для каждого устройства. | # Повторите действия выше для каждого устройства. | ||
После добавления устройств нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber | После добавления устройств нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber и они автоматически появятся в мобильном приложении «Салют». | ||
<gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | ||
Строка 152: | Строка 150: | ||
* [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/ Статья про интеграцию на Хабре] | ||
Версия 14:49, 26 мая 2022
Описание
Контроллеры 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
- Нажмите кнопку Создать модель.
Переходим к установке и настройке агента на контроллере.
- Создание модели
Установка и настройка агента
Установка
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш 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-get update && apt-get 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