SberDevices: различия между версиями
Matveevrj (обсуждение | вклад) |
|||
(не показано 10 промежуточных версий 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]]. | ||
Облачную платформу и агента для интеграции (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]. | ||
Строка 14: | Строка 16: | ||
Создадим кабинет разработчика и получим данные для подключения, нам понадобится ''Сбер ID'': | Создадим кабинет разработчика и получим данные для подключения, нам понадобится ''Сбер 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''' и нажмите кнопку '''Создать проект'''. | ||
Строка 32: | Строка 34: | ||
=== Добавление модели устройства === | === Добавление модели устройства === | ||
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом | Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом простопрописываете MQTT-топики. | ||
Создадим модель, например, типовой переключатель: | Создадим модель, например, типовой переключатель: | ||
# Перейдите на вкладку '''Модели''' | # Перейдите на вкладку '''Модели''' | ||
# Нажмите '''Создать модель''' | # Нажмите '''Создать модель''' | ||
# Заполните поля: | # Заполните поля: | ||
#* Идентификатор модели — switch | #* Идентификатор модели — switch | ||
Строка 42: | Строка 44: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Строка 68: | Строка 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> | ||
# Закройте консоль контроллера. | # Закройте консоль контроллера. | ||
Строка 78: | Строка 80: | ||
# Перейдите в веб-интерфейс SberDevices IoT Agent. | # Перейдите в веб-интерфейс SberDevices IoT Agent. | ||
# В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | # В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | ||
# Введите адрес | # Введите адрес, логин и пароль для подключения к облачному MQTT. | ||
# Нажмите кнопку '''Обновить'''. | # Нажмите кнопку '''Обновить'''. | ||
# Проверьте, что в разделе '''Статус''' написано '''В сети'''. Если это не так, проверьте подключение к интернету и правильнось введённых данных. | # Проверьте, что в разделе '''Статус''' написано '''В сети'''. Если это не так, проверьте подключение к интернету и правильнось введённых данных. | ||
Строка 104: | Строка 105: | ||
# Повторите действия выше для каждого устройства. | # Повторите действия выше для каждого устройства. | ||
После | После того, как вы завершили добавление устройств, нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber и они автоматически появятся в мобильном приложении «Салют». | ||
<gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | ||
Строка 148: | Строка 149: | ||
* [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:42, 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 и они автоматически появятся в мобильном приложении «Салют».
Настройка мобильного приложения
Установите мобильное приложение Салют и авторизуйтесь в нём.
Соданные выше устройства будут доступны в разделе Умный дом.
Удаление агента
Если SberDevices IoT Agent больше не нужен, его можно удалить:
- Удалите пакет:
apt remove sberdevices-iot-agent
- Удалите файл со ссылкой на репозиторий:
rm /etc/apt/sources.list.d/sberdevices-iot.list
- Обновите список доступных системе пакетов:
apt update