SberDevices: различия между версиями

Материал из Wiren Board
(Добавил про установку gpg)
(Новая страница: «{{Draft}} == Описание == {{note|note|Это решение от SberDevices, которое мы не успели опробовать сами, поэтому пока используйте инструкцию от разработчиков.}} Вы можете установить на контроллер приложение-агент от SberDevices и управлять контроллером через облако Сбер: * Запр...»)
(не показана 51 промежуточная версия 2 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Интеграция контроллера Wiren Board и умного дома Sber}}
{{Draft}}
[[Image: Sber Mobile.jpg |300px|thumb|right| Диммер WB-MRGBW-D в приложении Салют ]]
== Описание ==
== Описание ==
Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]].
{{note|note|Это решение от SberDevices, которое мы не успели опробовать сами, поэтому пока используйте инструкцию от разработчиков.}}
Вы можете установить на контроллер приложение-агент от SberDevices и управлять контроллером через облако Сбер:
* Запросите уникальный код у компании-интегратора.
* Настройте по [https://sberdevices.ru/help/smarthome/third-party-how-to-add-integrator/ инструкции].


Облачную платформу и агента для интеграции (SberDevices IoT Agent) разрабатывает компания Sber и у них есть активное коммунити разработчиков [https://t.me/smartmarket_community SmartMarket Community]. Подробные инструкции от производителя решения:
Вопросы можно задать в [https://t.me/smartmarket_community Коммунити SberDevices].
* [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''. По умолчанию у вас будет создано ''Личное пространство'', его мы и будем использовать.
# Нажмите слева '''+ Создать проект'''.
# Пролистайте вниз и выберите '''Smart Home'''.
# Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''.
# Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''.
# Нажмите кнопку '''Получить данные для подключения''' и запишите их.
 
<gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика">
Image: Sber-Cloud-1.png | Страница регистрации
Image: Sber-Cloud-2.png | Вход по Сбер ID
Image: Sber-Cloud-3.png | Вход по Сбер ID
Image: Sber-Cloud-4.png | Соглашение
Image: Sber-Cloud-5.png | Личный кабинет разработчика
Image: Sber-Cloud-6.png | Создание проекта
Image: Sber-Cloud-7.png | Выбор типа интеграции
Image: Sber-Cloud-8.png | Данные для входа
</gallery>
 
=== Добавление модели устройства ===
Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.
 
Создадим модель, например, типовой переключатель:
# Перейдите на вкладку '''Модели'''.
# Нажмите '''Создать модель'''.
# Заполните поля:
#* Идентификатор модели — switch
#* Производитель — Wiren Board
#* Название модели — Switch
#* Категория устройства — Реле
#* Список функций — on_off, online. online выбирать обязательно.
# Нажмите кнопку '''Создать модель'''.
 
Переходим к установке и настройке агента на контроллере.
 
<gallery mode="packed" heights="100px" caption="Создание модели">
Image: Sber-Model-1.png | Кнопка Создать модель
Image: Sber-Model-2.png | Идентификатор, производитель и название
Image: Sber-Model-3.png | Категория устройства и список функций
</gallery>
 
== Установка и настройка агента ==
=== Установка ===
{{Wbincludes:Installing Software In Console}}
 
Устанавливаем агента SberDevices IoT Agent:
# Установите GPG — программу для работы с ключами шифрования.
#:<syntaxhighlight lang="bash">
apt install gpg
</syntaxhighlight>
# Добавьте GPG ключ нового репозитория:
#:<syntaxhighlight lang="bash">
wget -q -O - https://nexus.iot.sberdevices.ru/repository/gpg-wirenboard/public.gpg.key | apt-key add -
</syntaxhighlight>
# Добавьте ссылку на репозиторий в список apt:
#:<syntaxhighlight lang="bash">
echo "deb https://nexus.iot.sberdevices.ru/repository/wirenboard/ main main" | tee -a /etc/apt/sources.list.d/sberdevices-iot.list
</syntaxhighlight>
# Обновите список пакетов и установите SberDevices IoT Agent:
#:<syntaxhighlight lang="bash">
apt update && apt install sberdevices-iot-agent
</syntaxhighlight>
# Закройте консоль контроллера.
 
Зайдите в веб-интерфейс агента, для этого откройте браузер и введите [[How to find IP address | IP-адрес своего контроллера]] в сети и порт 8083. Например: http://192.168.42.1:8083/
 
=== Настройка подключения ===
Агент настраивается через свой веб-интерфейс:
# Перейдите в веб-интерфейс SberDevices IoT Agent.
# В разделе '''Соединение''' нажмите кнопку '''Изменить'''.
# Введите адрес MQTT-брокера, логин и пароль для подключения, которые вы получили в личном кабинете.
# Сохраните настройки подключения.
# Нажмите кнопку '''Обновить'''.
# Проверьте, что в разделе '''Статус''' написано '''В сети'''. Если это не так, проверьте подключение к интернету и правильнось введённых данных.
 
<gallery mode="packed" heights="100px" caption="Настройка соединения с облаком">
Image: Sber-Controller-1.png | Веб-интерфейс агента
Image: Sber-Controller-2.png | Настройка соединения с облаком
Image: Sber-Controller-3.png | Соединение настроено, статус ''Не в сети''
Image: Sber-Controller-4.png | После нажатия на кнопку ''Обновить''
</gallery>
 
=== Добавление устройств ===
Вам понадобятся адреса MQTT-топиков, которые можно посмотреть в [[Wiren Board Web Interface#mqtt-channels | стандартном веб-интерфейсе контроллера]].
 
Добавьте новое устройство, например, Buzzer контроллера:
# Нажмите на кнопку '''Добавить устройство'''.
# Если на этапе настройки личного кабинета вы создали модель, выберите её.
# Придумайте и впишите наименование устройства.
# На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board:
#* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code>
#* on_off → Объект команды — <code>/devices/buzzer/controls/enabled</code>
#* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code>
# Нажмите кнопку '''Сохранить'''.
# Повторите действия выше для каждого устройства.
 
После добавления устройств нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber. Перейдите в приложении «Салют» в раздел «Мой дом» и сдвиньте экран вниз, чтобы обновился список.
 
<gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)">
Image: Sber-Controller-Device-1.png | Buzzer: Описание
Image: Sber-Controller-Device-2.png | Buzzer: Функции
</gallery>
 
<gallery mode="packed" heights="100px" caption="Создание светодиодного диммера">
Image: Sber-Controller-Device-WB-MRGBW-D-1.png | WB-MRGBW-D: Описание
Image: Sber-Controller-Device-WB-MRGBW-D-2.png | WB-MRGBW-D: Функции
Image: Sber-Controller-Device-WB-MRGBW-D-3.png | WB-MRGBW-D: Функции
</gallery>
 
== Настройка мобильного приложения ==
Установите мобильное приложение [https://sberdevices.ru/app/ Салют] и авторизуйтесь в нём.
 
Соданные выше устройства будут доступны в разделе '''Умный дом'''.
 
<gallery mode="packed" heights="350px" caption="Мобильное приложение Салют">
Image: Sber Mobile-1.jpg | Кнопка ''Умный дом''
Image: Sber Mobile-2.jpg | Список устройств
Image: Sber Mobile-3.jpg | Диммер WB-MRGBW-D
</gallery>
 
== Удаление агента ==
Если ''SberDevices IoT Agent'' больше не нужен, его можно удалить:
# Удалите пакет:
#:<syntaxhighlight lang="bash">
apt remove sberdevices-iot-agent
</syntaxhighlight>
# Удалите файл со ссылкой на репозиторий:
#:<syntaxhighlight lang="bash">
rm /etc/apt/sources.list.d/sberdevices-iot.list
</syntaxhighlight>
# Обновите список доступных системе пакетов:
#:<syntaxhighlight lang="bash">
apt update
</syntaxhighlight>


== Полезные ссылки ==
== Полезные ссылки ==
* [https://developers.sber.ru/docs/ru/smarthome/mqtt-integrators/mqtt-to-integrators Инструкция для интеграторов],
* [https://sberdevices.ru/help/smarthome/third-party-how-to-add-integrator/ Инструкция по настройке]
* [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}}

Версия 17:07, 12 мая 2022

Это черновик страницы. Последняя правка сделана 12.05.2022 пользователем A.Degtyarev.

Описание

Это решение от SberDevices, которое мы не успели опробовать сами, поэтому пока используйте инструкцию от разработчиков. Вы можете установить на контроллер приложение-агент от SberDevices и управлять контроллером через облако Сбер:

  • Запросите уникальный код у компании-интегратора.
  • Настройте по инструкции.

Вопросы можно задать в Коммунити SberDevices.

Полезные ссылки