yandex2mqtt

Мост из Яндекс УД в MQTT на Node.js

Форк Проекта и Статья на Хабре к оригиналу.

Важно

Те, кто пользуется оригинальным проектом (или его форками), обратите внимание на то, что немного изменились настройки устройств (блок devices в файле конфигурации).

На данный момент проверено получение температуры и влажности с датчиков (датчики дверей и движения пока в бета-тесте), и включение/выключение света (вкл./выкл. других устройств по аналогии тоже должно работать).

Прочий функционал (изменение громкости, каналов, отключение звука), поидее, так же должны работать.

ChangeLog

16.05.2021

Добавлено логирование некоторых событий.

13.05.2021

Добавлена поддержка API уведомлений об изменении состояний устройств.

31.03.2021

Добавлена поддрежка разделения доступа пользователей к устройствам.

Release

Проведён рефакторинг кода и, местами, внесены значительные правки.

Добавлена поддержка датчиков (устройств devices.types.sensor)

Требования

• "Белый" IP адрес и домен. Если нет своего домена и белого IP адреса можно воспользоваться Dynamic DNS сервисами (например, noip.com).
• SSL сертификат (самоподписанный сертификат не подойдёт). Для получения сертификата можно воспользоваться https://letsencrypt.org.

Установка

Настройка репозитория Node JS

curl -sL https://deb.nodesource.com/setup_10.x | bash -

Устанавка необходимых пакетов

apt-get install -y nodejs git make g++ gcc build-essential

Копирование файлов y2m с git

git clone https://github.com/lasthead0/yandex2mqtt.git /opt/yandex2mqtt

Установка прав на директорию

chown -R root:root /opt/yandex2mqtt

Установка необходимых модулей nodejs

cd /opt/yandex2mqtt
npm install

Запуск моста (выполняется после настройки)

npm start

Настройка yandex2mqtt

Все основные настройки моста прописываются в файл config.js. Перед запуском обязательно отредактируйте его.

mv config.orig.js config.js

Файл конфигурации

module.exports = {
  notification: [
    {
      ...
    },
    ...
  ]
  mqtt: {
    ...
  },

  https: {
    ...
  },

  clients: [
    {
      ...
    },
    ...
  ],

  users: [
    {
      ...
    },
    ...
  ],

  devices: [
    {
      ...
    },
    ...
  ]
}

Блок настройки mqtt клиента

Указать данные Вашего MQTT сервера

mqtt: {
    host: 'localhost',
    port: 1883,
    user: 'user',
    password: 'password',
},

Блок настройки https сервера

Указать порт, на котором будет работать мост, а так же пути к сертификату ssl.

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

Блок настройки клиентов

Здесь используются произвольные данные, далее они понадобятся для подключения к УД Yandex.

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

Блок настройки пользователей

users: [
    {
        id: '1',
        username: 'admin',
        password: 'admin',
        name: 'Administrator',
    },
    {
        id: '2',
        username: 'user1',
        password: 'user1',
        name: 'User',
    },
],

Блок настройки устройств

devices: [
    {
        id: 'haw-002-switch',
        name: 'Свет в коридоре',
        room: 'Коридор',
        type: 'devices.types.light',
        allowedUsers: ['2'],
        mqtt: [
            {
                instance: 'on',
                set: '/yandex/controls/light_HaW_002/on',
                state: '/yandex/controls/light_HaW_002/on/state',
            },
        ],
        capabilities: [
            {
                type: 'devices.capabilities.on_off',
                retrievable: true,
            },
        ],
    },

    {
        id: 'lvr-003-switch',
        name: 'Основной свет',
        room: 'Гостиная',
        type: 'devices.types.light',
        allowedUsers: ['2'],
        mqtt: [
            {
                instance: 'on',
                set: '/yandex/controls/light_LvR_003/on',
                state: '/yandex/controls/light_LvR_003/on/state',
            },
        ],
        valueMapping: [
            {
                type: 'on_off',
                mapping: [[false, true], [0, 1]], // [yandex, mqtt]
            },
        ],
        capabilities: [
            {
                type: 'devices.capabilities.on_off',
                retrievable: true,
            },
        ],
    },

    {
        id: 'lvr-001-weather',
        name: 'В гостиной',
        room: 'Гостиная',
        type: 'devices.types.sensor',
        allowedUsers: ['2'],
        mqtt: [
            {
                instance: 'temperature',
                state: '/yandex/sensors/LvR_001_Weather/temperature',
            },
            {
                instance: 'humidity',
                state: '/yandex/sensors/LvR_001_Weather/humidity',
            },
        ],
        properties: [
            {
                type: 'devices.properties.float',
                retrievable: true,
                parameters: {
                    instance: 'temperature',
                    unit: 'unit.temperature.celsius',
                },
            },
            {
                type: 'devices.properties.float',
                retrievable: true,
                parameters: {
                    instance: 'humidity',
                    unit: 'unit.percent',
                },
            },
        ],
    },

    {
        id: 'plug-001-flower',
        name: 'Розетка для цветка',
        room: 'Гостиная',
        type: 'devices.types.socket',
        allowedUsers: ['2'],
        mqtt: [
            {
                instance: 'on',
                set: '/yandex/controls/socket_LvR_002/on',
                state: '/yandex/controls/socket_LvR_002/on/state',
            },
            {
                instance: 'power',
                state: '/yandex/controls/socket_LvR_002/power',
            },
        ],
        capabilities: [
            {
                type: 'devices.capabilities.on_off',
                retrievable: true,
            },
        ],
        properties: [
            {
                type: 'devices.properties.float',
                retrievable: true,
                parameters: {
                    instance: 'power',
                    unit: 'unit.watt',
                },
            },
        ],
    },
    {
        id: 'haw-001-motion',
        name: 'Движение',
        room: 'Коридор',
        type: 'devices.types.sensor',
        allowedUsers: ['2'],
        mqtt: [
            {
                instance: 'motion',
                state: '/yandex/sensors/HaW_001_Motion/motion',
            },
        ],
        valueMapping: [
            {
                type: 'event',
                mapping: [['not_detected', 'detected'], ['false', 'true']], // [yandex, mqtt]
            },
        ],
        properties: [
            {
                type: 'devices.properties.event',
                retrievable: true,
                reportable: true,
                parameters: {
                    instance: 'motion',
                    events: [{
                        value: 'detected'
                    },
                    {
                        value: 'not_detected'
                    }]
                },
            },
        ],
    },
    /* --- end */
],

Рекомендую указывать id в конфиге, чтобы исключить "наложение" новых устройств на "старые", которые уже добавлены в навык.

В случае отсутсвия id в конфиге, он будет назначен автоматически по индексу в массиве.

Уведомление об изменении состояний устройств

Платформа УД Яндекс предоставляет сервис уведомлений об изменении состояний устройств. При изменении состояния устройства (например, изменение влажности) yandex2mqtt будет отправлять запрос с новым состоянием.

В настройках предусмотрен блок notification.

notification: [
    {
        skill_id: '6fca0a54-a505-4420-b774-f01da95e5c31',
        oauth_token: 'AQA11AAPv-V2BAT7o_ps6gEtrtNNjlE2ENYt96w',
        user_id: '2'
    },
]

Если к yandex2mqtt "подключено" несколько навыков УД, то в массиве необходимо указать настройки для каждого навыка УД, который должен получать уведомления.

skill_id (идентификатор вызываемого навыка, присвоенный при создании) и oauth_token (авторизационный токен владельца навыка) можно узнать из документации на Уведомление об изменении состояний устройств, а user_id - id пользователя в файле конфигурации yandex2mqtt.

Важно. Уведомления будут отправляться при изменнии mqtt топика хранящего состояние устройства. Соответственно, если для устройства не задан топик state, то уведомление для устройтва отправляться не будет.

Разрешенные пользователи для устройств (allowedUsers)

В блоке конфигурации можно указать пользователей (id пользователей), для которых будет доступно устройство.

В опции allowedUsers указыватся массив (строковых значений) id. Если данная опция не указана, то для неё будет назначено значение ['1'];

Mapping значений

Блок valueMapping позволяет настроить конвертацию значений между yandex api и MQTT. Это может быть актуально для умений типа devices.capabilities.on_off и devices.capabilities.toggle.

Например, если в УД состояние влючено/выключено соответствует значениям 1/0, то Вам понадобиться их конвертировать, т.к. в навыках Yandex значения true/false.

valueMapping: [
    {
        type: 'on_off',
        mapping: [[false, true], [0, 1]], // [yandex, mqtt]
    },
],

В mapping указывается миссив массивов. Первый массив - значения в yandex, второй - в MQTT.

Документация Яндекс

• Типы устройств
• Типы умений устройства
• Типы встроенных датчиков

Логирование

Добавлено две "стратегии" логирования: сообщений об ошибках в файл log/error.log (аргумент запуска --log-error) и всех сообщений в консоль (--log-info). Для запуска y2m с логирование необходимо добавить аргумент запуска в команду запуска в файле настройки служба (раздел ниже) или запустить из консоли.

Создание службы

В папке /etc/systemd/system/ создать файл yandex2mqtt.service со следующим содержанем:

[Unit]
Description=yandex2mqtt
After=network.target

[Service]
ExecStart=/usr/bin/node app.js --log-error
WorkingDirectory=/opt/yandex2mqtt
StandardOutput=inherit
StandardError=inherit
Restart=always
User=root

[Install]
WantedBy=multi-user.target

Для включения службы использовать команду:

systemctl enable yandex2mqtt.service

Для управления службой использовать команды:

service yandex2mqtt start

service yandex2mqtt stop

service yandex2mqtt restart

Создание навыка (в Яндекс Диалоги)

Заходим в Яндекс Диалоги => Создать диалог => Умный дом

Основные настройки

• Название Любое
• Backend Endpoint URL и указываем https://your.domain.ru:port/provider
• Тип доступа Приватный

Публикация в каталоге

• Подзаголовок Любой текст
• Имя разработчика Ваше имя
• Официальный навык Нет
• Описание Любой текст
• Иконка Своя иконка

Связка аккаунтов

• Авторизация Кнопка "Создать"

Создание связки аккаунтов

• Идентификатор приложения Файл конфигурации clients.clientId
• Секрет приложения Файл конфигурации clients.clientSecret
• URL авторизации https://your.domain.ru:port/dialog/authorize
• URL для получения токена https://your.domain.ru:port/oauth/token
• URL для обновления токена https://your.domain.ru:port/oauth/token

Сохраняем навык. Далее можно работать с черновиком (тестировать навык) или опубликовать его (кнопка "Опубликовать").

На вкладке Тестирование (далее кнопка +(плюс)) необходимо Привязать к Яндексу наш мост, используя имя пользователя и пароль из файла конфигурации (блок users). После этого можно получить список устройств.

Известные "особенности поведения" ioBroker (iob)

Не изменяются и не читаются топики MQTT

Если случается такое, что Алиса получает голосовую команду и не сообщает об ошибке, но при этом топик не меняет своего значения или, при изменении стейта (объекта iob) MQTT топик не публикуется (Алиса не получает нового значения, а сообщает старое) необходимо перезапустить адаптер mqtt.

Аналогичная ситуация может возникнуть, если в качестве топика использовать объект iob созданный вручную. В данном случает адаптер mqtt не будет "знать", что данный объект является топиком mqtt. Для исправления этой ошибки необходимо отредактировать объект iob: зайти в редактирование объекта и на вкладке RAW (EXPERTS ONLY) в json в поле native добавить topic. Пример:

"native": {
  "topic": "/yandex/controls/light_BdR_002/state"
}