Skip to content

Bridge from Yandex Smart Home to MQTT

License

Notifications You must be signed in to change notification settings

n0name45/yandex2mqtt

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yandex2mqtt

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

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

ATTENTION

Доступна бета-версия на ветке beta. Для установки выполнить команду git clone -b beta https://github.com/lasthead0/yandex2mqtt.git. Подробности изменений и документация в README ветки beta.

Важно

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

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

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

ChangeLog

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

Добавлена поддержка датчиков (устройств 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 = {
  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: "lvr-003-switch",
    name: "Основной свет",
    room: "Гостиная",
    type: "devices.types.light",
    mqtt: [
      {
        instance: "on",
        set: "/yandex/controls/light_LvR_003/state/on",
        state: "/yandex/controls/light_LvR_003/state"
      },
    ],
    /* mapping значений между yandex и УД */
    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",
    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"
        },
        /* Блок state указывать не обязательно */
        state: {
          instance: "humidity",
          value: 0
        }
      }
    ] 
  },
  /* --- end */
]

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

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

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.

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

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

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

[Unit]
Description=yandex2mqtt
After=network.target

[Service]
ExecStart=/usr/bin/npm start
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

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

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

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

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

На вкладке Тестирование (далее кнопка +(плюс)) необходимо Привязать к Яндексу наш мост, используя имя пользователя и пароль из файла конфигурации (блок 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"
}

Перезапустить адаптер mqtt

About

Bridge from Yandex Smart Home to MQTT

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 81.2%
  • CSS 15.6%
  • EJS 3.2%