Алиса, IoBroker и MQTT

Введение

Предлагаемый способ:

• Подойдёт тем, кто не хочет или не может использовать готовый драйвер, или в готовом оказалось недостаточно функционала.
• Позволяет поделиться (расшарить) свои устройства на другие аккаунты Яндекса: например, для нескольких членов семьи.

В статье использована только функция "включить/выключить". На самом деле в документации УДЯ намного больше поддерживаемых устройств и их возможностей.

Требования и ресурсы

Нам понадобятся:

1. Домен + публичный IP с пробросом порта
2. SSL-сертификат к этому домену.
3. Плагин y2mqtt (ссылка на гит + там описан процесс установки)
4. Драйвер mqtt в роли "сервер/брокер"
5. Платформа Яндекса Диалоги (мы будем создавать приватный навык).

Если не испугали необходимые требования и ресурсы - приступаем к настройке.

За основу взята эта статья, только я не использую прокси. Мой сервер крутится на Raspberry за NATом

Домен и SSL

Первое, что понадобится - это домен. Я выбрал себе домен третьего уровня, alice.domain.ru. Затем необходимо получить SSL-сертификат к этому домену (достаточно Let`s Encrypt).

Необходимо запомнить/записать пути к полученным сертификатам, это понадобится позже.

После того, как Вы зарегистрировали домен и получили сертификат, проверьте его валидность. Если проверка завершилась успешно - двигаемся к следующему шагу.

Настройка драйвера MQTT Broker/Client

Из списка драйверов Iobroker устанавливаем "MQTT Broker/Client". Открываем настройки:

• Тип - сервер/брокер
• Порт - произвольный. Главное, чтобы не совпадал с теми, что уже заняты (например, дефолтный порт брокера совпадает с устройствами sonoff).
• Данные аутентификации: логин, пароль. Галочку "SSL" не ставим, логин и пароль также понадобятся позже.

Настройка окончена!

Чтобы проверить доступность, можно запустить, например, Windows-клиент и попробовать подключиться по указанным параметрам. В случае успеха иконка mqtt.0 драйвера загорится зелёным.

Настройка плагина y2mqtt

Используем этот плагин (ссылка на Git). Шаги по его установке описаны во многих статьях, так что укажем только тонкости, на которые стоит обратить внимание:

1. После установки (npm install) не запускайте пост. Нужно настроить конфиг, добавить в автозагрузку. Всё согласно мануалу.
2. НЕ редактируйте конфиг из консоли! Лучше скачать файл на компьютер (например, WinScp), отредактировать (в np++) и вернуть обратно.

Настройки конфиг файла (/mnt/data/root/yandex2mqtt/config.js) и комментарии:

блок mqtt

Сюда прописываете адрес сервера, где крутится Iobroker, порт, логин и пароль, запомненные раньше при настройке драйвера MQTT Broker/Client:

mqtt: {
       host: '192.168.1.2',
       port: 1234,
       user: 'test',
       password: 'test'
},

блок https

Здесь нужно прописать пути к SSL-сертификатам, которые Вы получили в пункте Домен и SSL, а также указать еще один свободный порт - для работы этого плагина.

https: {
       privateKey: '/etc/letsencrypt/live/alice.domain.ru/privkey.pem',
       certificate: '/etc/letsencrypt/live/alice.domain.ru/fullchain.pem',
       port: 4321
},

блок clients

Впишем произвольные данные, которые потом укажем при создании навыка на платформе Яндекс.диалоги

   clients: [
   {
       id: '1',
       name: 'Yandex',
       clientId: 'login',
       clientSecret: 'password',
       isTrusted: false
       },
   ],

блок users

Отвечает за шаринг устройств на другие аккаунты Яндекса. Создаём нужное количество профилей.

   users: [{
           id: '1',
           username: 'user-1',
           password: 'password',
           name: 'Administrator'
       },
       {
           id: '2',
           username: 'user-2',
           password: 'password',
           name: 'Administrator'
       },
   ],

блок devices

Здесь описываем устройства, которыми планируем управлять. Комментарии поясняют, где, что и как будет обзываться и появляться.

   devices: [
   //_______________Первое устройство______________//свет зал
       {
           name: 'свет',   // имя устройства, которое отобразится в квазаре Яндекса, после объединения списка устройств. обозвать можно как угодно.
           room: 'склад',  // имя комнаты, в которую по-умолчанию будут помещаться устройства. можно сразу указать нужную, я кладу всё на склад, а потом из квазара распределяю.
           type: 'devices.types.light',   //тип устройства, которые описаны в доке.
           mqtt: [
                {
                   type: 'on',
                   set: '/devices/yandex/controls/svet_zal/on',  //эти стейты появляются в  mqtt брокере (svet_zal заменять на свои)
                   stat: '/devices/yandex/controls/svet_zal'
               },
               
           ],
           capabilities: [
               {
                   type: 'devices.capabilities.on_off',
                   retrievable: true,
                   state: {
                       instance: 'on',
                       value: true
                   }
               },
               
           ]
       },
   //__________Конец первого устройства__________//

После того, как файл /скачали, отредактировали и вернули в исходную папку/, вернемся к мануалу по настройке плагина и выполним npm start.

В мануале плагина об этом не сказано, но чтобы проверить его доступность, нужно открыть домен по порту, указанному в блоке "https" (где указывали пути к сертификатам), пример:
https://alice.domain.ru:4321

Если плагин корректно встал и работает, Вы должны увидеть ответ (спасибо @Habaaaa за важное дополнение):

OAuth 2.0 Server

Без этого сообщения дальнейшие действия бессмысленны. Если оно не появилось, то проверьте:

• Корректность установки плагина
• Доступность портов, указанных в конфиг-файле
• Корректность ssl сертификатов

Если сообщение есть - переходим к приватному навыку:

Создание приватного навыка

Переходим на платформу Диалоги и создаем диалог, выбрав пункт "умный дом":

• Название - на ваш вкус
• Backend - Endpoint URL - указываем ваш домен + порт (из блока https, откуда получили "OAuth 2.0 Server"), и страницу https://alice.domain.ru:4321/provider
• Тип доступа - приватный.
• Остальные обязательные поля (имя, подзаголовок, описание, иконка) - так же на ваш вкус.

Далее, в самом низу есть пункт "Связка аккаунтов", также создаём:

• Идентификатор приложения - указываем из конфига: блок "clients" - "clientId"
• Секрет приложения - указываем из конфига: блок "clients" - "clientSecret"
• URL авторизации - https://alice.domain.ru:4321/dialog/authorize
• URL для получения токена - https://alice.domain.ru:4321/oauth/token
• URL для обновления токена - https://alice.domain.ru:4321/oauth/token

Везде жмём "Сохранить", затем "Опубликовать".

Объединяем навык и платформу Iobroker

Здесь же, в навыке, есть вкладка "тестирование" - открываем её, жмём "плюсик", добавить "другое устройство" там будет единственный наш навык, выбираем его, откроется страница авторизации.

Теперь вводим логин/пароль от учетки, созданные в конфиге, в блоке "users". Везде разрешаем-предоставляем доступ.

Далее, обновить список устройств. И если всё прошло удачно, Вы увидите список устройств!

Перейдя в квазар, их можно переименовать, переместить по комнатам.

стейты в mqtt

После того, как устройства появились в квазаре, в mqtt брокере появятся виртуальные стейты, на каждое устройство, которое мы создали. В моем примере это "svet_zal". В моем примере будет всего одно состояние: on/off. Дальше, применяя скрипты, наращиваем управление нужными устройствами. Всё предельно просто: следим за изменением стейта и активируем нужное устройство.

Важное замечание: на тех скриптах, которые включают устройства иными способами: кнопками, из телеграма, по крону, иными способами, желательно прописать так же изменение стейта для брокера. У меня бывали сбои, когда устройство было включено с кнопки, и уже mqtt отказывался включать его повторно, поэтому я везде поставил заглушки, которые меняют стейты в брокере.

Предоставить доступ другим учёткам Яндекса

Очень часто, пользователей колонок Яндекса мучает вопрос: как предоставить доступ к своим устройствам другим членам семьи? В этой статье я уже отмечал, что в конфиг-файле плагина есть настройка нескольких учетных записей. После того, как Вы полностью настроили интеграцию Iobroker и "Алисы", у Вас всё отзывается на голос и включаются устройства, можно перейти к "шарингу" своих устройств.

• Создаем в блоке "users" нужное количество учетных записей;
• В том аккаунте, которому хотим предоставить доступ, переходим на платформу Яндекс.диалоги и создаем приватный навык, по аналогии с основным;
• После сохранения и публикации навыка, открываем вкладку "тестирование", добавляем наш навык, но авторизовываемся уже под другой учёткой, которую создали отдельно;
• Обновляем список устройств и можем по-своему переименовать устройства и комнаты;
• Если сильно разобраться и запотеть, я думаю, возможно даже заведомо указать, какие устройства будут доступны в каждом аккаунте. (например, чтобы дети не включали свет у родителей)

gl, hf