Интеграция увлажнителя Xiaomi в Home Assistant: полное руководство с примерами

Умные увлажнители воздуха от Xiaomi — одни из самых популярных устройств для создания комфортного микроклимата в доме. Однако их полный потенциал раскрывается только при интеграции с системами умного дома, такими как Home Assistant. В отличие от стандартного приложения Mi Home, Home Assistant позволяет гибко настраивать автоматизации, связывать увлажнитель с другими датчиками (например, гигрометрами или термостатами) и управлять им через голосовых помощников.

В этой статье мы разберём все возможные способы подключения увлажнителей Xiaomi (включая модели Mi Air Humidifier, Smartmi и Viomi) к Home Assistant — от получения токена до настройки автоматических сценариев. Особое внимание уделим решению типичных ошибок, таких как Unable to connect или проблемы с обновлением состояния. Если вы уже пытались интегрировать устройство, но столкнулись с трудностями, здесь вы найдёте проверенные решения.

Важно: процесс интеграции зависит от прошивки увлажнителя и версии Home Assistant. Мы актуализировали инструкцию для Home Assistant 2026.6+ и последних версий прошивок Xiaomi (включая устройства с поддержкой BLE и Wi-Fi).

1. Подготовка: что понадобится для интеграции

Прежде чем приступать к настройке, убедитесь, что у вас есть всё необходимое. Без некоторых компонентов интеграция будет невозможна.

• 📱 Увлажнитель Xiaomi с поддержкой Wi-Fi или BLE (список совместимых моделей см. ниже).
• 🖥️ Home Assistant версии 2023.12 или новее (рекомендуется 2026.6+).
• 📲 Приложение Mi Home (для получения токена устройства).
• 🌐 Стабильное интернет-соединение (увлажнитель должен быть подключён к той же сети, что и Home Assistant).
• 🔧 Дополнительные инструменты: Mi Home Token Extractor (для Android) или Python-скрипт для iOS.

Если ваш увлажнитель работает только по BLE (например, Smartmi Air Humidifier JSQ-S03), потребуется дополнительное оборудование — ESP32 с прошивкой ESPHome или Bluetooth Proxy в Home Assistant. Для Wi-Fi-моделей (например, Xiaomi Mi Air Humidifier CA1/CA4) достаточно токена из приложения Mi Home.

2. Получение токена устройства из Mi Home

Токен (token) — это уникальный идентификатор, который позволяет Home Assistant взаимодействовать с увлажнителем через облако Xiaomi. Без него интеграция невозможна. Существует несколько способов его получения, но самый надёжный — использование Mi Home Token Extractor (только для Android).

Если у вас iPhone, придётся воспользоваться обходными путями: либо временно установить Mi Home на Android-эмулятор (например, BlueStacks), либо использовать Python-скрипт для перехвата трафика. Мы подробно разберём оба метода.

Способ 1: Token Extractor для Android

1. Установите приложение Mi Home Token Extractor (доступно на GitHub).
2. Авторизуйтесь в Mi Home с тем же аккаунтом, к которому привязан увлажнитель.
3. Откройте Token Extractor, выберите ваше устройство из списка и скопируйте token.
4. Также запишите Device ID (понадобится для конфигурации).

Способ 2: Перехват трафика на iOS (через MITM-прокси)

Этот метод сложнее и требует навыков работы с Python и Charles Proxy:

git clone https://github.com/Maxmudjon/mihome_binary_protocol
cd mihome_binary_protocol
pip install -r requirements.txt
python miio_extractor.py

После запуска скрипта войдите в Mi Home и дождитесь появления токена в консоли.

Что делать, если токен не отображается?

Если скрипт не показывает токен, проверьте:

1. Версию приложения Mi Home (должна быть не новее 6.0.102 для Android или 6.0.4 для iOS).

2. Регион аккаунта (должен совпадать с регионом устройства, обычно China Mainland).

3. Наличие VPN (отключите его перед запуском скрипта).

⚠️ Внимание: Не делитесь своим токеном с постороними! Он предоставляет полный доступ к управлению устройством. Если токен скомпрометирован, немедленно сбросьте устройство к заводским настройкам и получите новый токен.

3. Настройка интеграции в Home Assistant

Существует три основных способа подключить увлажнитель Xiaomi к Home Assistant:

1. Официальная интеграция Xiaomi Miio (самый простой метод).
2. Через MQTT (для продвинутых пользователей).
3. Локальное управление по BLE (для устройств без Wi-Fi).

Мы рекомендуем начинать с первого способа. Если он не сработает (например, из-за региональных ограничений), переходите ко второму.

Метод 1: Официальная интеграция Xiaomi Miio

Добавьте следующий код в файл configuration.yaml:

miio:
devices:
- host: 192.168.1.100  # IP-адрес увлажнителя
token: YOUR_TOKEN_HERE  # Токен из предыдущего шага
model: zhimi.humidifier.ca1  # Модель устройства (см. таблицу ниже)

После сохранения файла перезагрузите Home Assistant. Увлажнитель появится в разделе Настройки → Устройства.

Метод 2: Интеграция через MQTT (альтернатива)

Если официальная интеграция не работает, используйте MQTT с промежуточным брокером (например, Mosquitto). Для этого:

1. Установите брокер MQTT в Home Assistant (через Настройки → Дополнения).
2. Настройте Mi Home MQTT Bridge (инструкция на GitHub).
3. Добавьте устройство в configuration.yaml:

   mqtt:
   broker: core-mosquitto
   discovery: true

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

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

• ❌ Unable to connect to the device — проверьте IP-адрес увлажнителя (он может меняться при перезагрузке роутера). Задайте статический IP в настройках роутера.
• ❌ Invalid token — токен мог измениться после обновления прошивки. Получите новый.
• ❌ Устройство отображается как unavailable — убедитесь, что увлажнитель и Home Assistant находятся в одной сети.
• ❌ Нет данных о влажности — обновите прошивку увлажнителя через Mi Home.

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

1. Перезагрузить устройство (отключите питание на 10 секунд).
2. Обновить Home Assistant до последней версии.
3. Проверить лог на ошибки:

   tail -f /config/home-assistant.log | grep -i miio

⚠️ Внимание: Увлажнители Smartmi JSQ-S03 и JSQ-S04 часто теряют связь при использовании BLE. Если устройство периодически отключается, установите Bluetooth Proxy на ESP32 и разместите его рядом с увлажнителем.

5. Настройка автоматизаций

После успешной интеграции можно создать автоматизации для умного управления увлажнителем. Например:

• 🌡️ Автоматическое включение при падении влажности ниже 40%.
• 🕒 Отключение ночью (если уровень шума критичен).
• 🔄 Связка с датчиком CO₂ (включать при высоком уровне углекислого газа).

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

alias: "Увлажнитель: поддержка влажности"
trigger:
- platform: numeric_state
entity_id: sensor.bedroom_humidity
below: 40
action:
- service: humidifier.turn_on
target:
entity_id: humidifier.xiaomi_humidifier
- service: humidifier.set_mode
target:
entity_id: humidifier.xiaomi_humidifier
data:
mode: "auto"

Критичный нюанс: увлажнители Xiaomi не поддерживают плавную регулировку влажности через Home Assistant. Вместо этого используйте режимы auto, medium или high, комбинируя их с внешними датчиками.

6. Продвинутые возможности: связка с другими устройствами

Home Assistant позволяет объединять увлажнитель с другими устройствами для создания комплексных сценариев. Например:

• 🌿 Умная теплица: увлажнитель включается, когда датчик почвы показывает низкую влажность.
• 🏠 Энергосбережение: отключать увлажнитель, когда никого нет дома (по данным геолокации).
• 📊 Визуализация данных: строить графики влажности в Grafana или Home Assistant Dashboard.

Для связки с датчиками используйте template sensors. Пример датчика, который учитывает и влажность, и температуру:

template:
- sensor:
- name: "Comfort Level"
state: >-
{% if states('sensor.bedroom_humidity')|float < 40 and states('sensor.bedroom_temperature')|float > 22 %}
Dry
{% elif states('sensor.bedroom_humidity')|float > 60 %}
Humid
{% else %}
Normal
{% endif %}

На основе этого датчика можно создавать более сложные автоматизации. Например, включать увлажнитель только если в комнате жарко и сухо, но не трогать его при нормальных условиях.

7. Обновление прошивки и безопасность

Xiaomi регулярно выпускает обновления прошивки для увлажнителей, которые могут ломать совместимость с Home Assistant. Чтобы избежать проблем:

• 🔄 Отключите автоматическое обновление в приложении Mi Home.
• 🛡️ Проверяйте совместимость новой прошивки на форумах (например, Home Assistant Community).
• 🔄 Создайте резервную копию токена и конфигурации перед обновлением.

Если после обновления увлажнитель перестал работать с Home Assistant:

1. Получите новый токен (старый мог измениться).
2. Проверьте, не изменился ли model в документации MiOT.
3. Откатните прошивку (если возможно) через Mi Home или сервисный режим.

⚠️ Внимание: Прошивки для китайского региона (China Mainland) часто содержат больше функций, чем глобальные. Однако их установка на устройства с прошивкой EU/RU может привести к блокировке. Используйте Mi Home на китайском языке для безопасной смены региона.

FAQ: Частые вопросы

Мой увлажнитель не отображается в Home Assistant после настройки. Что делать?

Проверьте:

1. Правильность IP-адреса и token.
2. Наличие устройства в одной сети с Home Assistant (используйте ping 192.168.1.100).
3. Логи Home Assistant на ошибки (Developer Tools → Logs).

Если используется BLE, убедитесь, что Bluetooth Proxy работает и находится в радиусе действия.

Можно ли управлять увлажнителем без облака Xiaomi?

Да, если устройство поддерживает локальное управление (LAN mode). Для этого:

1. В Mi Home переведите увлажнитель в режим China Mainland.
2. Включите опцию Local Network Control (если доступна).
3. Используйте miio: интеграцию в Home Assistant с параметром use_miot_auto: true.

Для BLE-устройств облако не требуется в принципе, но нужен Bluetooth Proxy.

Как сбросить увлажнитель к заводским настройкам?

Для большинства моделей:

1. Отключите питание.
2. Зажмите кнопку включения и подключите питание.
3. Удерживайте кнопку 5–10 секунд, пока не замигает индикатор.

Для Smartmi JSQ-S03: сброс выполняется через приложение Mi Home (раздел Настройки устройства → Сброс).

Поддерживаются ли увлажнители Viomi?

Да, но требуется указать правильную модель в конфигурации. Например:

• Viomi V-HUMID1: viomi.humidifier.v1
• Viomi V-HUMID2: viomi.humidifier.v2

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

Как уменьшить потребление воды?

Используйте следующие настройки:

1. Установите целевую влажность на уровне 50–55% (вместо 60%).
2. Активируйте режим silent (расход воды ниже на 30%).
3. Свяжите увлажнитель с датчиком открытия окон (отключайте при проветривании).