SberDevices: различия между версиями
Matveevrj (обсуждение | вклад) |
|||
(не показано 46 промежуточных версий 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 | ||
# Нажмите кнопку '''Создать модель'''. | # Нажмите кнопку '''Создать модель'''. | ||
Переходим к установке и настройке агента на | Переходим к установке и настройке агента на контроллер. | ||
== Установка и настройка агента == | == Установка и настройка агента == | ||
Строка 57: | Строка 49: | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
Устанавливаем агента | Устанавливаем агента: | ||
# Добавьте GPG ключ нового репозитория: | # Добавьте GPG ключ нового репозитория: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
Строка 68: | Строка 60: | ||
# Обновите список пакетов и установите 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> | ||
Интерфейс агента будет доступен по адресу http://192.168.42.1:8083/, где 192.168.42.1 — [[How to find IP address | IP-адрес вашего контроллера]], а 8083 — порт. | |||
=== Настройка | === Настройка === | ||
Перейдите в веб-интерфес агента: | |||
# В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | # В разделе '''Соединение''' нажмите кнопку '''Изменить'''. | ||
# Введите адрес | # Введите адрес, логин и пароль для подключения к облачному MQTT. | ||
# Нажмите кнопку '''Обновить'''. | # Нажмите кнопку '''Обновить'''. | ||
# Проверьте, что в разделе '''Статус''' написано '''В сети''' | # Проверьте, что в разделе '''Статус''' написано '''В сети'''. | ||
Добавьте новое устройство, например, Buzzer контроллера: | Добавьте новое устройство, например, Buzzer контроллера: | ||
# | # Выберите модель, которую мы создали выше и впишите наименование. | ||
# На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | # На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board: | ||
#* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | #* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code> | ||
Строка 102: | Строка 79: | ||
#* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | #* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code> | ||
# Нажмите кнопку '''Сохранить'''. | # Нажмите кнопку '''Сохранить'''. | ||
# | # Нажмите кнопку Перезапустить, чтобы устройства были отправлены в облако. | ||
После этого они будут доступны в приложении Салют. | |||
== Настройка мобильного приложения == | == Настройка мобильного приложения == | ||
== Полезные ссылки == | == Полезные ссылки == | ||
* [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/ Статья на Хабре] | ||
Версия 20:10, 25 мая 2022
Это черновик страницы. Последняя правка сделана 25.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
Интерфейс агента будет доступен по адресу http://192.168.42.1:8083/, где 192.168.42.1 — IP-адрес вашего контроллера, а 8083 — порт.
Настройка
Перейдите в веб-интерфес агента:
- В разделе Соединение нажмите кнопку Изменить.
- Введите адрес, логин и пароль для подключения к облачному MQTT.
- Нажмите кнопку Обновить.
- Проверьте, что в разделе Статус написано В сети.
Добавьте новое устройство, например, Buzzer контроллера:
- Выберите модель, которую мы создали выше и впишите наименование.
- На вкладке Функции укажите топики устройства в контроллере Wiren Board:
- online → Объект статуса —
/devices/buzzer/controls/enabled: OK
- on_off → Объект команды —
/devices/buzzer/controls/enabled
- on_off → Объект статуса —
/devices/buzzer/controls/enabled
- online → Объект статуса —
- Нажмите кнопку Сохранить.
- Нажмите кнопку Перезапустить, чтобы устройства были отправлены в облако.
После этого они будут доступны в приложении Салют.