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

← Предыдущая правка

SberDevices (просмотреть исходный код)

Версия 11:40, 15 февраля 2023

939 байт добавлено , 1 год назад

Нет описания правки

Matveevrj

translator, wb_editors

4251

правка

@@ Строка 1: / Строка 1: @@
-{{DISPLAYTITLE: Интеграция контроллера Wiren Board в умный дом Sber}}
+{{DISPLAYTITLE: Интеграция контроллера Wiren Board и умного дома Sber}}
-{{Draft}}
 [[Image: Sber Mobile.jpg |300px|thumb|right| Диммер WB-MRGBW-D в приложении Салют ]]
 == Описание ==
-Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение или с помощью голосового ассистента «Салют». Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]].
+Контроллеры [[Wiren Board]] можно интегрировать в систему умного дома от Sber и управлять вашей системой автоматизации через мобильное приложение, с помощью семейства виртуальных ассистентов «Салют» или через сценарии. Взаимодействие с контроллером и подключёнными устройствами происходит через [[MQTT]].
-Облачную платформу и агента для интеграции разрабатывает компания Sber и у них есть живое [https://t.me/smartmarket_community Коммунити SberDevices].
+Облачную платформу и агента для интеграции (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-diy/mqtt-to-diy MQTT-to-Cloud для DIY].
-Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета у вас будет другой.
+Мы опишем настройку со стороны частного разработчика (DIY), если вы интегратор — процесс создания кабинета и личного пространства у вас будет другой.
 == Кабинет разработчика ==
 === Создание ===
-Первым этапом надо создать кабинет разработчика и получить данные для подключения, нам понадобится ''Сбер ID'':
+Создадим кабинет разработчика и получим данные для подключения, нам понадобится ''Сбер ID'':
-# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''.
+# Зарегистрируйтесь на сайте [https://developers.sber.ru/studio/ SmartMarket Studio] с помощью ''Сбер ID''. По умолчанию у вас будет создано ''Личное пространство'', его мы и будем использовать.
-# Нажмите '''Создать проект'''.
+# Нажмите слева '''+ Создать проект'''.
 # Пролистайте вниз и выберите '''Smart Home'''.
 # Введите название проекта, выберите '''MQTT-to-Cloud для DIY''' и нажмите кнопку '''Создать проект'''.
 # Придумайте название контроллера и введите его в поле '''Доступ к облаку умного дома Sber'''.
 # Нажмите кнопку '''Получить данные для подключения''' и запишите их.
-По умолчанию у нас будет создано ''Личное пространство'', его мы и будем использовать.
 <gallery mode="packed" heights="100px" caption="Настройка кабинета разработчика">
@@ Строка 37: / Строка 32: @@
 === Добавление модели устройства ===
-Чтобы нам было проще добавлять устройства в контроллере, создадим модель, например, типовой переключатель:
+Этот шаг необязателен, но так удобнее: вы сразу задаёте набор функций устройства и потом просто прописываете MQTT-топики.
-# Перейдите на вкладку '''Модели'''
-# Нажмите '''Создать модель'''
+Создадим модель, например, типовой переключатель:
+# Перейдите на вкладку '''Модели'''.
+# Нажмите '''Создать модель'''.
 # Заполните поля:
 #* Идентификатор модели — switch
@@ Строка 45: / Строка 42: @@
 #* Название модели — Switch
 #* Категория устройства — Реле
-#* Список функций — on_off, online
+#* Список функций — on_off, online. online выбирать обязательно.
 # Нажмите кнопку '''Создать модель'''.
-Переходим к установке и настройке агента на контроллер.
+Переходим к установке и настройке агента на контроллере.
 <gallery mode="packed" heights="100px" caption="Создание модели">
@@ Строка 60: / Строка 57: @@
 {{Wbincludes:Installing Software In Console}}
-Устанавливаем агента:
+Устанавливаем агента SberDevices IoT Agent:
 # Добавьте GPG ключ нового репозитория:
 #:<syntaxhighlight lang="bash">
@@ Строка 71: / Строка 68: @@
 # Обновите список пакетов и установите SberDevices IoT Agent:
 #:<syntaxhighlight lang="bash">
-apt-get update && apt-get install sberdevices-iot-agent
+apt update && apt install sberdevices-iot-agent
 </syntaxhighlight>
 # Закройте консоль контроллера.
-Чтобы зайти в веб-интерфейс агента, откройте браузер и введите [[How to find IP address | IP-адрес своего контроллера]] в сети и порт 8083. Например: http://192.168.42.1:8083/
+Зайдите в веб-интерфейс агента, для этого откройте браузер и введите [[How to find IP address | IP-адрес своего контроллера]] в сети и порт 8083. Например: http://192.168.42.1:8083/
-=== Настройка ===
+=== Настройка подключения ===
-Перейдите в веб-интерфес агента:
+Агент настраивается через свой веб-интерфейс:
+# Перейдите в веб-интерфейс SberDevices IoT Agent.
 # В разделе '''Соединение''' нажмите кнопку '''Изменить'''.
-# Введите адрес, логин и пароль для подключения к облачному MQTT.
+# Введите адрес MQTT-брокера, логин и пароль для подключения, которые вы получили в личном кабинете.
+# Сохраните настройки подключения.
 # Нажмите кнопку '''Обновить'''.
-# Проверьте, что в разделе '''Статус''' написано '''В сети'''.
+# Проверьте, что в разделе '''Статус''' написано '''В сети'''. Если это не так, проверьте подключение к интернету и правильнось введённых данных.
 <gallery mode="packed" heights="100px" caption="Настройка соединения с облаком">
@@ Строка 91: / Строка 90: @@
 </gallery>
-Дальше вам понадобятся адреса MQTT-топиков, которые можно посмотреть в [[Wiren Board Web Interface#mqtt-channels | стандартном веб-интерфейсе контроллера]].
+=== Добавление устройств ===
+Вам понадобятся адреса MQTT-топиков, которые можно посмотреть в [[Wiren Board Web Interface#mqtt-channels | стандартном веб-интерфейсе контроллера]].
 Добавьте новое устройство, например, Buzzer контроллера:
-# Выберите модель, которую мы создали выше и впишите наименование.
+# Нажмите на кнопку '''Добавить устройство'''.
+# Если на этапе настройки личного кабинета вы создали модель, выберите её.
+# Придумайте и впишите наименование устройства.
 # На вкладке '''Функции''' укажите топики устройства в контроллере Wiren Board:
 #* online → Объект статуса — <code>/devices/buzzer/controls/enabled: OK</code>
@@ Строка 100: / Строка 102: @@
 #* on_off → Объект статуса — <code>/devices/buzzer/controls/enabled</code>
 # Нажмите кнопку '''Сохранить'''.
-# Нажмите кнопку '''Перезапустить''', чтобы данные об устройствах были отправлены в облако.
+# Повторите действия выше для каждого устройства.
-После этого устройства будут доступны в приложении Салют.
+После добавления устройств нажмите кнопку '''Перезапустить''' — данные о них будут отправлены в облако Sber. Перейдите в приложении «Салют» в раздел «Мой дом» и сдвиньте экран вниз, чтобы обновился список.
-Другие устройства добавляются аналогично.
 <gallery mode="packed" heights="150px" caption="Создание Buzzer (Реле)">
@@ Строка 148: / Строка 148: @@
 * [https://t.me/smartmarket_community Коммунити SberDevices]
 * [https://habr.com/ru/company/sberdevices/news/t/659555/ Статья про интеграцию на Хабре]
+{{Wbincludes: Supported Devices}}