Модуль Xiaomi miIO

Xiaomi miIO Комментариев нет

Модуль Xiaomi miIO

Описание

Модуль предназначен для интеграции Wi-Fi устройств из экосистемы Xiaomi Mihome, взаимодействующих по протоколу miIO.

miIO - проприетарный сетевой протокол Xiaomi с шифрованием, по которому взаимодействуют wifi-устройства из экосистемы Xiaomi и приложение Mihome на смартфоне. В качестве транспорта используется UDP и порт 54321. Содержимое пакетов шифруется. Ключи шифрования формируются на основе уникальных токенов. Для контроля корректности принимаемых пакетов используется контрольная сумма на основе алгоритма MD5.

Использование этого протокола позволяет управлять теми устройствами, которые не имеют открытого API (режима разработчика). Например, пылесосы, лампы, светильники, увлажнители и очистители воздуха, розетки и многие другие. Также позволяет расширить имеющиеся возможности открытого API у xiaomi-шлюза, в частности переводить его в режим сопряжения, привязывать и отвязывать zigbee-устройства, управлять радио и др.

В основе модуля лежит библиотека php-miio.

Обсуждение модуля на Форуме.
Исходный код модуля на Github.
Модуль в Connect.

Модуль Xiaomi miIO

Поддерживаемые устройства

* По состоянию на март 2019 года.

    1. Шлюз ZigBee Mi Smart Home Gateway 2
    2. Шлюз ZigBee Aqara AC Companion Gateway
    3. Розетка Mi Smart Socket Plug 2
    4. Розетка Mi Smart Socket Plug with USB
    5. Розетка Mi Smart Socket Plug with 2 USB
    6. Пылесос Mi Vacuum Cleaner
    7. Пылесос Mi Roborock S50/S51
    8. Настольная лампа Philips EyeCare Smart Desk Lamp 2
    9. Лампочка белая Е27 Philips Light Bulb
    10. Лампочка белая Е27 Yeelight White Bulb
    11. Лампочка цветная Е27 Yeelight Color Bulb
    12. Лампочки Philips Rui Chi Candle Light Bulb
    13. Настольная лампа Mi LED Desk Lamp
    14. Потолочный светильник Yeelight Ceiling Light
    15. Потолочный светильник Yeelight Square Ceiling Light
    16. Потолочный светильник Philips EyeCare Smart Ceiling Lamp
    17. Светодиодная лента Yeelight LED Lightstrip
    18. Удлинитель (5 розеток) Mi (Chingmi) Smart Power Strip 5 Plugs
    19. Удлинитель (6 розеток) Mi Smart Power Strip 6 Plugs
    20. Увлажнитель воздуха Mi Air Humidifier
    21. Увлажнитель воздуха Mi Air Humidifier 2
    22. Очиститель воздуха Mi Air Purifier v3
    23. Очиститель воздуха Mi Air Purifier 2S
    24. IR-контроллер Mi IR Remote 360
    25. WiFi-колонка Mi Internet Speaker
    26. Ночник Yeelight Bedside Lamp
    27. Светильник (спот) Philips Zhirui Downlight
    28. Напольный вентилятор Mi Smart Fan SA1

Требования

Сервер MajorDoMo и miIO-устройства должны находиться в одном сегменте локальной сети, в котором разрешен широковещательный UDP-трафик с портом назначения 54321.

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

Для всех устройств должны быть получены их уникальные токены! В большинстве случаев устройства не сообщают свой токен в ответных сообщениях, и модуль не может определить их автоматически, поэтому выяснять токены приходится вручную. Без токенов будет работать только поиск устройств в сети и определение статуса онлайн/оффлайн. Способы получения токенов описаны здесь.

Документация по модулю

  1. Установка, обновление, удаление модуля
  2. Интерфейс модуля
  3. Настройка модуля
  4. Протокол miIO
  5. Токены устройств
  6. Управление техникой по ИК-каналу
  7. Управление роботом-пылесосом

Ссылки на полезные материалы

  1. Команды управления пылесосом
  2. Еще команды управления пылесосом
  3. Команды управления FM-радио в шлюзе
  4. Команды управления wifi-колонкой
  5. Управление IR-шайбой
  6. Отчет о статусе пылесоса и отправка в Telegram
  7. Обновление свойств устройства по запросу (prop_update)
  8. Утилита MiHomeAdmin для Windows
  9. Кастомная сборка Mihome для простого получения токенов устройств
Поделитесь в соц сетях

Теги: