SberDevices: различия между версиями
Matveevrj (обсуждение | вклад) |
|||
(не показаны 23 промежуточные версии 1 участника) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Интеграция контроллера Wiren Board | {{DISPLAYTITLE: Интеграция контроллера Wiren Board в умный дом Sber}} | ||
{{Draft}} | |||
[[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 и у них есть живое [https://t.me/smartmarket_community Коммунити SberDevices]. | ||
Подробные инструкции по установке и настройке интеграции: | |||
* [https://developers.sber.ru/docs/ru/smarthome/mqtt-integrators/mqtt-to-integrators для интеграторов], | |||
* [https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy для частных разработчиков]. | |||
Инструкции отличаются процессом создания личного кабинета и пространств, а шаги по установке и настройке агента не отличаются. | |||
Здесь мы рассмотрим пример подключения контроллера Wiren Board к системе умного дома от Sber со стороны частного разработчика. | |||
== Кабинет разработчика == | == Кабинет разработчика == | ||
=== Создание === | === Создание === | ||
Первым этапом надо создать кабинет разработчика и получить данные для подключения, нам понадобится ''Сбер 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: | Строка 39: | ||
=== Добавление модели устройства === | === Добавление модели устройства === | ||
Чтобы нам было проще добавлять устройства в контроллере, создадим модель, например, типовой переключатель: | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | |||
# Заполните поля: | # Заполните поля: | ||
#* Идентификатор модели — switch | #* Идентификатор модели — switch | ||
Строка 42: | Строка 47: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Переходим к установке и настройке агента на | Переходим к установке и настройке агента на контроллер. | ||
<gallery mode="packed" heights="100px" caption="Создание модели"> | <gallery mode="packed" heights="100px" caption="Создание модели"> | ||
Строка 57: | Строка 62: | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
Устанавливаем агента | Устанавливаем агента: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
Строка 68: | Строка 73: | ||
# Обновите список пакетов и установите 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> | ||
# Закройте консоль контроллера. | # Закройте консоль контроллера. | ||
Чтобы зайти в веб-интерфейс агента, откройте браузер и введите [[How to find IP address | IP-адрес своего контроллера]] в сети и порт 8083. Например: http://192.168.42.1:8083/ | |||
=== Настройка | === Настройка === | ||
Перейдите в веб-интерфес агента: | |||
# В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | # В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | ||
# Введите адрес | # Введите адрес, логин и пароль для подключения к облачному MQTT. | ||
# Нажмите кнопку '''Обновить'''. | # Нажмите кнопку '''Обновить'''. | ||
# Проверьте, что в разделе '''Статус''' написано '''В сети''' | # Проверьте, что в разделе '''Статус''' написано '''В сети'''. | ||
<gallery mode="packed" heights="100px" caption="Настройка соединения с облаком"> | <gallery mode="packed" heights="100px" caption="Настройка соединения с облаком"> | ||
Строка 90: | Строка 93: | ||
</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> | ||
Строка 102: | Строка 102: | ||
#* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | #* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | ||
# Нажмите кнопку '''Сохранить'''. | # Нажмите кнопку '''Сохранить'''. | ||
# | # Нажмите кнопку '''Перезапустить''', чтобы данные об устройствах были отправлены в облако. | ||
После | После этого устройства будут доступны в приложении Салют. | ||
Другие устройства добавляются аналогично. | |||
<gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)"> | ||
Строка 148: | Строка 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:19, 26 мая 2022
Это черновик страницы. Последняя правка сделана 26.05.2022 пользователем A.Degtyarev.
Описание
Контроллеры Wiren Board можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение или с помощью голосового ассистента «Салют». Взаимодействие с контроллером и подключёнными устройствами происходит через MQTT.
Облачную платформу и агента для интеграции разрабатывает компания Sber и у них есть живое Коммунити SberDevices.
Подробные инструкции по установке и настройке интеграции:
Инструкции отличаются процессом создания личного кабинета и пространств, а шаги по установке и настройке агента не отличаются.
Здесь мы рассмотрим пример подключения контроллера Wiren Board к системе умного дома от Sber со стороны частного разработчика.
Кабинет разработчика
Создание
Первым этапом надо создать кабинет разработчика и получить данные для подключения, нам понадобится Сбер ID:
- Зарегистрируйтесь на сайте SmartMarket Studio с помощью Сбер ID.
- Нажмите Создать проект.
- Пролистайте вниз и выберите Smart Home.
- Введите название проекта, выберите MQTT-to-Cloud для DIY и нажмите кнопку Создать проект.
- Придумайте название контроллера и введите его в поле Доступ к облаку умного дома Sber.
- Нажмите кнопку Получить данные для подключения и запишите их.
По умолчанию у нас будет создано Личное пространство, его мы и будем использовать.
Добавление модели устройства
Чтобы нам было проще добавлять устройства в контроллере, создадим модель, например, типовой переключатель:
- Перейдите на вкладку Модели
- Нажмите Создать модель
- Заполните поля:
- Идентификатор модели — switch
- Производитель — Wiren Board
- Название модели — Switch
- Категория устройства — Реле
- Список функций — on_off, online
- Нажмите кнопку Создать модель.
Переходим к установке и настройке агента на контроллер.
Установка и настройка агента
Установка
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.
Устанавливаем агента:
- Добавьте 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/
Настройка
Перейдите в веб-интерфес агента:
- В разделе Соединение нажмите кнопку Изменить.
- Введите адрес, логин и пароль для подключения к облачному MQTT.
- Нажмите кнопку Обновить.
- Проверьте, что в разделе Статус написано В сети.
Дальше вам понадобятся адреса MQTT-топиков, которые можно посмотреть в стандартном веб-интерфейсе контроллера.
Добавьте новое устройство, например, Buzzer контроллера:
- Выберите модель, которую мы создали выше и впишите наименование.
- На вкладке Функции укажите топики устройства в контроллере Wiren Board:
- online → Объект статуса —
/devices/buzzer/controls/enabled: OK
- on_off → Объект команды —
/devices/buzzer/controls/enabled
- on_off → Объект статуса —
/devices/buzzer/controls/enabled
- online → Объект статуса —
- Нажмите кнопку Сохранить.
- Нажмите кнопку Перезапустить, чтобы данные об устройствах были отправлены в облако.
После этого устройства будут доступны в приложении Салют.
Другие устройства добавляются аналогично.
Настройка мобильного приложения
Установите мобильное приложение Салют и авторизуйтесь в нём.
Соданные выше устройства будут доступны в разделе Умный дом.
Удаление агента
Если SberDevices IoT Agent больше не нужен, его можно удалить:
- Удалите пакет:
apt remove sberdevices-iot-agent
- Удалите файл со ссылкой на репозиторий:
rm /etc/apt/sources.list.d/sberdevices-iot.list
- Обновите список доступных системе пакетов:
apt update