Как добавить устройства Xiaomi в Home Assistant: полное руководство с примерами

4. Интеграция Zigbee-устройств (Aqara, MiJia)

Первый способ проще: подключите Aqara Hub к Home Assistant через токен (как в способе 2), затем добавьте в configuration.yaml:

aqara:
discovery_retry: 3
gateways:
- key: YOUR_AQARA_KEY

Ключ (key) можно найти на задней стороне хаба или получить через приложение Mi Home (раздел "Об устройстве"). После перезагрузки все подключённые к хабу датчики появятся в Home Assistant автоматически.

Для опытных пользователей второй способ даёт больше гибкости: вы сможете управлять Zigbee-сетью напрямую, без зависимости от облака Xiaomi. Однако он требует дополнительной настройки Zigbee2MQTT и ручного сопряжения устройств.

miio inspect --ip 192.168.1.100 --token YOUR_TOKEN

5. Решение распространённых ошибок

Даже при правильной настройке вы можете столкнуться с проблемами. Вот самые частые ошибки и их решения:

Если устройство подключается, но данные обновляются редко, добавьте в конфигурацию параметр scan_interval:

xiaomi_miio:
scan_interval: 60  # Опрос каждые 60 секунд

Для устройств, которые требуют частого опроса (например, датчики движения), можно уменьшить интервал до 10 секунд, но это увеличит нагрузку на сеть.

6. Автоматизация и примеры использования

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

• 💡 Умное освещение: Включать Yeelight при обнаружении движения датчиком Aqara и выключать через 5 минут без движения.
• 🌡️ Климат-контроль: Автоматически включать Xiaomi Air Purifier, если датчик Mi Temperature & Humidity Sensor показывает PM2.5 > 50.
• 🚪 Безопасность: Отправлять уведомление в Telegram, если датчик открытия двери срабатывает в ваше отсутствие.
• 🧹 Уборка: Запускать Roborock по расписанию или когда никто не дома (по данным геолокации).

Пример автоматизации для освещения (добавляется в automations.yaml):

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

Для устройств с поддержкой Zigbee (например, Aqara Button) можно настроить мультиклики:

- alias: "Управление светом с кнопки"
trigger:
platform: event
event_type: zha_event
event_data:
device_id: 01:23:45:67:89:ab:cd:ef
command: single
action:
service: light.toggle
entity_id: light.living_room

Не забывайте тестировать автоматизации в ручном режиме перед сохранением! Для этого используйте инструмент Developer Tools → Services в интерфейсе Home Assistant.

7. Оптимизация и безопасность

После настройки интеграции стоит позаботиться о безопасности и производительности:

• 🔒 Ограничьте доступ к токенам: Храните их в secrets.yaml, а не в основном файле конфигурации.
• 🔄 Обновляйте Home Assistant: Новые версии часто добавляют поддержку для устройств Xiaomi.
• 📡 Настройте локальную сеть: Привяжите IP-адреса устройств в роутере, чтобы избежать проблем при изменении DHCP.
• 📊 Мониторьте нагрузку: Чрезмерное количество опросов устройств может замедлить систему.

Для устройств, которые поддерживают локальное управление (например, Yeelight), отключите облачную синхронизацию в настройках Mi Home. Это уменьшит задержки и повысит надёжность.

⚠️ Внимание: Если вы используете Xiaomi Camera в Home Assistant, никогда не exposeйте поток видео в интернет без защиты! Настройте auth для камеры и используйте NGINX с SSL для удалённого доступа.

Часто задаваемые вопросы