Как добавить устройства Xiaomi в Home Assistant: 3 рабочих способа + решение ошибок

• ❌ Не все устройства поддерживаются официально (например, некоторые камеры Xiaomi требуют отдельных интеграций).
• ❌ Для роботов-пылесосов (например, Mi Robot Vacuum) может потребоваться дополнительная настройка valetudo.
• ❌ Если устройство использует BLE (например, датчики Aqara), потребуется Bluetooth-прокси (разберём ниже).

Способ 2: Получение Mi Home Token (для устройств без официальной поддержки)

Если ваше устройство не поддерживается официальной интеграцией, или вы хотите использовать MQTT для более гибкой настройки, потребуется токен доступа (Mi Home Token). Это уникальный ключ, который позволяет Home Assistant взаимодействовать с устройством напрямую.

Есть два способа получить токен:

Метод 1: Через приложение Mi Home (Android)

Для этого понадобится:

• 📱 Android-смартфон с установленным Mi Home (версия 6.0.100 или старше).
• 💻 Компьютер с ADB (Android Debug Bridge).
• 🔗 Утилита mihome-bin для извлечения токена.

Пошаговая инструкция:

1. Включите режим разработчика на Android: перейдите в Настройки → О телефоне → Номер сборки и нажмите 7 раз.
2. Вернитесь в Настройки → Система → Для разработчиков и включите Отладка по USB.
3. Подключите телефон к компьютеру и выполните команду:

   adb backup -f mihome.ab -noapk com.xiaomi.smarthome

   На телефоне подтвердите создание резервной копии (пароль не устанавливайте!).

4. Используйте утилиту mihome-bin для извлечения токена:

   java -jar mihome-bin.jar mihome.ab

   В результате вы получите файл mihome.db с токенами всех ваших устройств.

Метод 2: Через пакетный сниффер (для iOS или без ADB)

Если у вас iPhone или нет возможности использовать ADB, можно перехватить токен через анализ сетевого трафика:

• 📡 Установите на компьютер Wireshark или Fiddler.
• 🔍 Настройте прокси на телефоне (вручную или через Charles Proxy).
• 📱 Откройте Mi Home и обновите данные устройства (например, включите/выключите лампу).
• 🔎 В сниффере ищите запросы к домену api.io.mi.com — токен будет в заголовке Authorization.

1. Перезагрузить устройство Xiaomi (вынуть батарейку на 10 секунд для датчиков).

2. Убедиться, что в Mi Home устройство привязано к тому же региону (Китай/Европа/Россия), что и ваш аккаунт.

3. Обновить прошивку устройства до последней версии.

-->

Важно! Токен действует до тех пор, пока вы не сбросите устройство или не измените пароль в Mi Home. Храните его в надёжном месте (например, в менеджере паролей).

Способ 3: Подключение через MQTT (для опытных пользователей)

Протокол MQTT позволяет организовать обмен данными между устройствами Xiaomi и Home Assistant через брокер (например, Mosquitto). Это полезно, если:

• 🔄 Вы хотите уменьшить нагрузку на Home Assistant (устройства отправляют данные напрямую в брокер).
• 🌐 У вас распределённая система с несколькими серверами.
• 🛠️ Вам нужны кастомные топики и формат данных.

Для настройки потребуется:

1. Установить MQTT-брокер (например, через аддон Mosquitto в Home Assistant).
2. Настроить устройство Xiaomi на отправку данных в MQTT (для этого часто используется прошивка Tasmota или ESPHome для устройств на ESP8266/ESP32).
3. Добавить интеграцию MQTT в Home Assistant и настроить подписки на топики.

Пример конфигурации для датчика температуры Aqara в configuration.yaml:

mqtt:
sensor:
- name:"Aqara Temperature"
state_topic:"home/sensor/aqara/temperature"
unit_of_measurement:"°C"
value_template:"{{ value_json.temperature }}"
- name:"Aqara Humidity"
state_topic:"home/sensor/aqara/humidity"
unit_of_measurement:"%"
value_template:"{{ value_json.humidity }}"

Для устройств, которые не поддерживают MQTT"из коробки" (например, лампы Yeelight), можно использовать промежуточный скрипт на Python с библиотекой python-miio, который будет перенаправлять данные из Miio в MQTT.

Подключение BLE-устройств (датчики Aqara, Mi Band и др.)

Многие устройства Xiaomi и Aqara (например, датчики открытия дверей, термометры, браслеты Mi Band) используют протокол Bluetooth Low Energy (BLE). Для их интеграции в Home Assistant потребуется Bluetooth-прокси — устройство, которое будет сканировать эфир и передавать данные серверу.

Варианты реализации:

Для настройки ESP32 с ESPHome:

1. Установите аддон ESPHome в Home Assistant.
2. Создайте новую конфигурацию для ESP32 с компонентом esp32_ble_tracker.
3. Добавьте устройства в список сканирования:

   esp32_ble_tracker:
   scan_parameters:
   interval: 300ms
   window: 30ms
   active: true
   
   sensor:
   - platform: xiaomi_lywsd03mmc
   mac_address:"XX:XX:XX:XX:XX:XX"
   temperature:
   name:"Temperature"
   humidity:
   name:"Humidity"
   battery_level:
   name:"Battery"

4. Загрузите прошивку на ESP32 и разместите её рядом с датчиками.

Решение типичных ошибок при подключении Xiaomi к Home Assistant

Даже при точном следовании инструкциям могут возникать ошибки. Рассмотрим самые распространённые и способы их устранения.

Ошибка:"Cannot connect to device"

Причины и решения:

• 🔌 Устройство не в сети: Проверьте, что устройство включено и подключено к тому же Wi-Fi, что и сервер Home Assistant. Для датчиков на батарейках убедитесь, что заряд не разряжен.
• 🔒 Неверный токен: Убедитесь, что токен скопирован полностью (без пробелов). Попробуйте получить его заново.
• 🌍 Региональные ограничения: Некоторые устройства (например, Aqara) требуют привязки к серверам Китая. В Mi Home измените регион на Mainland China (но учтите, что это может сбросить все устройства!).
• 🔄 Устаревшая прошивка: Обновите прошивку устройства через Mi Home. Для роботов-пылесосов может потребоваться ручное обновление через Mi Home Token.

Ошибка:"Unsupported device"

Если устройство не поддерживается официальной интеграцией:

• 🔍 Проверьте список поддерживаемых устройств в документации.
• 🛠️ Используйте MQTT или кастомные компоненты (например, xiaomi_ble для BLE-устройств).
• 📦 Для роботов-пылесосов установите Valetudo (альтернативная прошивка с открытым API).

Ошибка:"Timeout while connecting"

Возникает при медленном ответе устройства. Решения:

• ⚡ Проверьте качество Wi-Fi (устройства Xiaomi плохо работают на частоте 5 GHz — используйте 2.4 GHz).
• 📡 Уменьшите расстояние между устройством и роутером.
• ⏳ Увеличьте таймаут в конфигурации Home Assistant:

  xiaomi_miio:
  devices:
  192.168.1.100:
  token: YOUR_TOKEN
  timeout: 15

Оптимизация работы Xiaomi-устройств в Home Assistant

После успешного подключения устройств стоит настроить их для максимальной эффективности. Вот несколько рекомендаций:

1. Настройка опроса устройств

По умолчанию Home Assistant опрашивает устройства каждые 30 секунд, что может создавать нагрузку на сеть. Оптимизируйте интервал в зависимости от типа устройства:

• 🌡️ Датчики температуры/влажности: достаточно опрашивать раз в 5-10 минут.
• 💡 Лампы и розетки: можно оставить 30 секунд (для быстрого реагирования).
• 🚪 Датчики открытия: используйте binary_sensor с триггером по событию (не требует постоянного опроса).

Пример настройки в configuration.yaml:

xiaomi_miio:
devices:
192.168.1.100:
token: YOUR_TOKEN
scan_interval: 300 # 5 минут

2. Локальное управление vs. облако

По возможности используйте локальное управление (через Miio или BLE), чтобы:

• ⚡ Снизить задержки (команды выполняются мгновенно).
• 🔒 Исключить зависимость от серверов Xiaomi (актуально при проблемах с интернетом).
• 🛡️ Повысить конфиденциальность (данные не уходят в облако).

Исключение: камеры Xiaomi (например, Mi Home Security Camera) часто требуют облачного подключения через интеграцию Xiaomi Camera или FFmpeg.

3. Автоматизации с устройствами Xiaomi

Примеры полезных автоматизаций:

• 🌅 Умное освещение: включение ламп Yeelight при закате (используйте триггер sun.sun).
• 🚪 Безопасность: уведомление в Telegram при срабатывании датчика открытия двери.
• 🌡️ Климат-контроль: включение кондиционера Mi Air Conditioning при температуре выше 25°C.
• 🤖 Уборка по расписанию: запуск робота-пылесоса Mi Robot Vacuum по будням в 10:00.

Пример автоматизации для датчика движения:

automation:
- alias:"Включить свет при движении"
trigger:
platform: state
entity_id: binary_sensor.motion_sensor_158d000xxxxxx
to:"on"
condition:
- condition: sun
after: sunset
before: sunrise
action:
service: light.turn_on
target:
entity_id: light.yeelight_color1
data:
brightness: 255
color_temp: 400

FAQ: Частые вопросы по интеграции Xiaomi и Home Assistant