Xiaomi Miot Auto
Полная интеграция устройств Xiaomi в HomeAssistant через протокол MIoT. Поддержка облачного и локального управления с автоматическим обнаружением устройств.
Возможности интеграции
Облачное управление
Управление устройствами через серверы Xiaomi
Локальное управление
Прямое подключение без использования облака
Автообнаружение
Автоматический поиск и добавление устройств
Широкая совместимость
Поддержка большинства устройств Xiaomi
Быстрый отклик
Минимальная задержка при локальном управлении
Гибкая настройка
Расширенные настройки для продвинутых пользователей
Поддерживаемые устройства
Умное освещение
Лампочки, люстры, LED ленты и другие световые устройства Xiaomi Yeelight и Miot.
Климат
Кондиционеры, увлажнители, очистители воздуха, обогреватели и термостаты.
Роботы-пылесосы
Roborock, Dreame, Xiaomi Vacuum - полное управление扫地机器人.
Телевизоры
Smart TV Xiaomi Mi TV с поддержкой управления и статуса.
Розетки и выключатели
Умные розетки, реле, выключатели и диммеры Xiaomi.
Замки и датчики
Умные замки, датчики открытия, движения, протечки и другие.
Установка через HACS
Установка HACS
Если у вас ещё не установлен HACS (Home Assistant Community Store), сначала установите его. HACS позволяет легко устанавливать интеграции и дополнения из сообщества.
- Откройте Home Assistant
- Перейдите в настройки → Добавления → Магазин Add-on
- Найдите и установите HACS
- Следуйте инструкциям по настройке
Добавление репозитория
После установки HACS добавьте репозиторий Xiaomi Miot Auto:
- Откройте HACS в боковом меню
- Перейдите в раздел "Интеграции"
- Нажмите кнопку с тремя точками в правом верхнем углу
- Выберите "Пользовательские репозитории"
- Добавьте репозиторий:
ALONEWORK/xiaomi_miot - Выберите категорию "Интеграция"
Установка интеграции
После добавления репозитория установите интеграцию:
- В списке интеграций найдите "Xiaomi Miot Auto"
- Нажмите кнопку установки
- Дождитесь завершения загрузки
- Перезапустите Home Assistant
Настройка интеграции
Добавление аккаунта Xiaomi
Настройте интеграцию в Home Assistant:
- Перейдите в Настройки → Устройства и службы
- Нажмите "Добавить интеграцию"
- Найдите и выберите "Xiaomi Miot Auto"
- Введите данные аккаунта Xiaomi
Используйте тот же аккаунт Xiaomi, что в приложении Mi Home. Для китайских устройств используйте сервер mainland China, для глобальных - Singapore.
Выбор режима работы
Xiaomi Miot Auto поддерживает два режима работы:
- Облачный режим: Управление через серверы Xiaomi. Требует интернет-подключения.
- Локальный режим: Прямое подключение к устройствам в локальной сети. Быстрее и работает без интернета.
Для лучшей производительности используйте локальный режим. Облачный режим подойдёт как резервный вариант или для устройств вне домашней сети.
Конфигурация YAML (опционально)
Для продвинутых пользователей доступна конфигурация через YAML. Добавьте в configuration.yaml:
xiaomi_miot:
username: !secret xiaomi_username
password: !secret xiaomi_password
server: cn
scan_interval: 30
filter_models:
- zhimi.humidifier.ca4
- roborock.vacuum.s5
Настройка локального режима
Получение токена устройства
Для локального управления необходим токен устройства:
- Способ 1: Использовать скрипт для получения токена из приложения Mi Home
- Способ 2: Перехватить токен через сетевой трафик
- Способ 3: Использовать инструменты разработчика в эмуляторе Android
После получения токена добавьте его в конфигурацию интеграции для каждого устройства.
Настройка автоподключения
Для автоматического обнаружения локальных устройств:
- Убедитесь, что Home Assistant и устройства Xiaomi в одной сети
- Отключите VPN на устройстве Home Assistant
- Разрешите multicast-трафик в настройках маршрутизатора
- Перезапустите интеграцию для сканирования сети
Устранение проблем
Устройства не обнаруживаются
Проверьте настройки сервера в конфигурации интеграции. Убедитесь, что используете правильный сервер (cn, sg, de, us и т.д.) для вашего региона.
Устройства постоянно отключаются
Попробуйте переключиться на локальный режим. Проверьте качество Wi-Fi соединения устройств и убедитесь, что они не уходят в спящий режим.
Ошибка аутентификации
Проверьте правильность логина и пароля Xiaomi. Если включена двухфакторная аутентификация, используйте специальный пароль приложения.
Локальный режим не работает
Убедитесь, что устройства и Home Assistant в одной сети. Проверьте, что токены устройств правильные и не истекли.
Полезные советы
Оптимизация производительности
Для снижения нагрузки на Home Assistant рекомендуется увеличить интервал сканирования устройств в настройках интеграции. Для большинства устройств достаточно интервала 30-60 секунд.
Группировка устройств
Создавайте группы для связанных устройств (например, все лампы в комнате) для удобного управления. Используйте возможности Home Assistant для создания сцен и автоматизаций.
Резервное копирование конфигурации
Регулярно сохраняйте конфигурацию интеграции и токены устройств. Это позволит быстро восстановить работу системы после переустановки Home Assistant.
Полезные ресурсы
Документация
Официальная документация Xiaomi Miot Auto на GitHub с подробными описаниями всех параметров.
Сообщество
Форум и чаты поддержки, где можно получить помощь от других пользователей и разработчиков.
HACS
Менеджер дополнений Home Assistant для установки и обновления интеграций.