SberDevices: различия между версиями
Matveevrj (обсуждение | вклад) |
|||
(не показано 40 промежуточных версий 1 участника) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Интеграция контроллера Wiren Board | {{DISPLAYTITLE: Интеграция контроллера Wiren Board в умный дом Sber}} | ||
{{Draft}} | |||
== Описание == | == Описание == | ||
Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и | Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и упаравлять вашей системой автоматизации через мобильное приложение или с помощью голосового ассистента Салют. | ||
Облачную платформу и агента для интеграции | Облачную платформу и агента для интеграции разрабатывает компания Sber, вопросы можно задавать в [https://t.me/smartmarket_community Коммунити SberDevices]. | ||
== Кабинет разработчика == | == Кабинет разработчика == | ||
=== Создание === | === Создание === | ||
Первым этапом надо создать кабинет разработчика и получить данные для подключения. Кабинеты бывают корпоративные для интеграторов и личные для частных разработчиков. | |||
# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID'' | |||
# Нажмите | Мы будем использовать личный кабинет разработчика, для этого нам понадобится ''Сбер ID'': | ||
# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''. | |||
# Нажмите '''Создать проект'''. | |||
# Пролистайте вниз и выберите '''Smart Home'''. | # Пролистайте вниз и выберите '''Smart Home'''. | ||
# Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''. | # Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''. | ||
# Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | # Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''. | ||
# Нажмите кнопку '''Получить данные для подключения''' и запишите их. | # Нажмите кнопку '''Получить данные для подключения''' и запишите их. | ||
Если вы интегратор, используйте [https://developers.sber.ru/docs/ru/smarthome/mqtt-integrators/mqtt-to-integrators инструкцию от SverDevices]. | |||
<gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | <gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика"> | ||
Строка 32: | Строка 32: | ||
=== Добавление модели устройства === | === Добавление модели устройства === | ||
Чтобы нам было проще добавлять устройства в контроллере, создадим модель, например, типовой переключатель: | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | |||
# Перейдите на вкладку '''Модели''' | |||
# Нажмите '''Создать модель''' | |||
# Заполните поля: | # Заполните поля: | ||
#* Идентификатор модели — switch | #* Идентификатор модели — switch | ||
Строка 42: | Строка 40: | ||
#* Название модели — Switch | #* Название модели — Switch | ||
#* Категория устройства — Реле | #* Категория устройства — Реле | ||
#* Список функций — on_off, online | #* Список функций — on_off, online | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Переходим к установке и настройке агента на | Переходим к установке и настройке агента на контроллер. | ||
<gallery mode="packed" heights="100px" caption="Создание модели"> | <gallery mode="packed" heights="100px" caption="Создание модели"> | ||
Строка 57: | Строка 55: | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
Устанавливаем агента | Устанавливаем агента: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
Строка 68: | Строка 66: | ||
# Обновите список пакетов и установите 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="Настройка соединения с облаком"> | ||
Строка 89: | Строка 85: | ||
Image: Sber-Controller-4.png | После нажатия на кнопку ''Обновить'' | Image: Sber-Controller-4.png | После нажатия на кнопку ''Обновить'' | ||
</gallery> | </gallery> | ||
Добавьте новое устройство, например, Buzzer контроллера: | Добавьте новое устройство, например, Buzzer контроллера: | ||
# | # Выберите модель, которую мы создали выше и впишите наименование. | ||
# На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | # На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | ||
#* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | #* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | ||
Строка 102: | Строка 93: | ||
#* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | #* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | ||
# Нажмите кнопку '''Сохранить'''. | # Нажмите кнопку '''Сохранить'''. | ||
# | # Нажмите кнопку Перезапустить, чтобы устройства были отправлены в облако. | ||
После этого устройства будут доступны в приложении Салют. | |||
<gallery mode="packed" heights=" | <gallery mode="packed" heights="150px" caption="Создание устройства"> | ||
Image: Sber-Controller-Device | Image: Sber-Controller-Device-1.png | Описание | ||
Image: Sber-Controller-Device | Image: Sber-Controller-Device-2.png | Функции | ||
</gallery> | </gallery> | ||
Строка 124: | Строка 109: | ||
<gallery mode="packed" heights="350px" caption="Мобильное приложение Салют"> | <gallery mode="packed" heights="350px" caption="Мобильное приложение Салют"> | ||
Image: Sber Mobile-1.jpg | Кнопка ''Умный дом'' | Image: Sber Mobile-1.jpg | Кнопка ''Умный дом'' | ||
Image: Sber Mobile-2.jpg | | Image: Sber Mobile-2.jpg | Реле | ||
</gallery> | </gallery> | ||
Строка 144: | Строка 128: | ||
== Полезные ссылки == | == Полезные ссылки == | ||
* [https:// | * [https://sberdevices.ru/help/smarthome/third-party-how-to-add-integrator/ Инструкция по настройке] | ||
* [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/ Статья на Хабре] | ||
Версия 13:25, 26 мая 2022
Это черновик страницы. Последняя правка сделана 26.05.2022 пользователем A.Degtyarev.
Описание
Контроллеры Wiren Board можно интегрировать в систему умного дома от Sber и упаравлять вашей системой автоматизации через мобильное приложение или с помощью голосового ассистента Салют.
Облачную платформу и агента для интеграции разрабатывает компания Sber, вопросы можно задавать в Коммунити SberDevices.
Кабинет разработчика
Создание
Первым этапом надо создать кабинет разработчика и получить данные для подключения. Кабинеты бывают корпоративные для интеграторов и личные для частных разработчиков.
Мы будем использовать личный кабинет разработчика, для этого нам понадобится Сбер ID:
- Зарегистрируйтесь на сайте SmartMarket Studio с помощью Сбер ID.
- Нажмите Создать проект.
- Пролистайте вниз и выберите Smart Home.
- Введите название проекта, выберите MQTT-to-Cloud для DIY и нажмите кнопку Создать проект.
- Придумайте название контроллера и введите его в поле Доступ к облаку умного дома Sber.
- Нажмите кнопку Получить данные для подключения и запишите их.
Если вы интегратор, используйте инструкцию от SverDevices.
Добавление модели устройства
Чтобы нам было проще добавлять устройства в контроллере, создадим модель, например, типовой переключатель:
- Перейдите на вкладку Модели
- Нажмите Создать модель
- Заполните поля:
- Идентификатор модели — 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.
- Нажмите кнопку Обновить.
- Проверьте, что в разделе Статус написано В сети.
Добавьте новое устройство, например, 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