Главная / Интеграции / Xiaomi Home
🏠 Интеграция

Xiaomi Home

Полное руководство по интеграции устройств Xiaomi в HomeAssistant. Поддержка всех умных устройств Xiaomi: от ламп до роботов-пылесосов.

Что такое Xiaomi Home?

Xiaomi Home - это официальная интеграция HomeAssistant для подключения умных устройств экосистемы Xiaomi. Эта интеграция обеспечивает стабильную работу с устройствами через облачный сервис Xiaomi или локально через Mi Home.

💡 Важно: Xiaomi Home поддерживает работу как через облако, так и локально, что обеспечивает быстродействие и надежность даже при отсутствии интернета.

Возможности интеграции

🌐

Облачное управление

Управление устройствами через облачный сервис Xiaomi из любой точки мира.

🏠

Локальное управление

Быстрое локальное управление без задержек через ваш Mi Hub.

⚡

Автоматизация

Создание сложных сценариев и автоматизации на основе состояний устройств.

📱

Широкая совместимость

Поддержка сотен устройств Xiaomi: ламп, розеток, датчиков, камер и многого другого.

Установка интеграции

Шаг 1: Установка через HACS

Самый простой способ установки - через HACS (Home Assistant Community Store):

  1. Откройте HACS в HomeAssistant
  2. Перейдите в раздел "Интеграции"
  3. Нажмите "Обзор и загрузки интеграций"
  4. Поищите "Xiaomi Home"
  5. Нажмите "Загрузить"
  6. Перезапустите HomeAssistant

Шаг 2: Настройка интеграции

После установки:

  1. Перейдите в "Настройки" → "Устройства и службы"
  2. Нажмите "Добавить интеграцию"
  3. Поищите "Xiaomi Home"
  4. Следуйте инструкциям на экране для входа в аккаунт Xiaomi
# Пример конфигурации configuration.yaml
xiaomi_home:
  username: your_xiaomi_email@example.com
  password: your_password
  country: cn

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

💡
Умные лампы
🔌
Розетки
🌡️
Датчики температуры
💧
Датчики влажности
🚪
Датчики открытия
🎥
Камеры
🧹
Роботы-пылесосы
❄️
Кондиционеры
🌬️
Очистители воздуха
🔒
Умные замки
⏰
Чайники
🍳
Кухонные приборы

Продвинутая настройка

Локальное управление

Для более быстрого отклика устройств рекомендуется настроить локальное управление через Xiaomi Gateway:

# Локальная конфигурация
xiaomi_home:
  gateways:
    - mac: AA:BB:CC:DD:EE:FF
      token: your_token_here
      host: 192.168.1.100

Автоматизация устройств

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

# automation.yaml
- alias: "Включить свет вечером"
  trigger:
    - platform: sun
      event: sunset
      offset: "-00:30:00"
  action:
    - service: light.turn_on
      target:
        entity_id: light.xiaomi_lamp
      data:
        brightness_pct: 70
        color_temp: 400

Устранение проблем

🔄

Устройства не обнаруживаются

Проверьте подключение к интернету и убедитесь, что устройства добавлены в приложение Mi Home.

⚠️

Ошибки подключения

Убедитесь, что логин и пароль Xiaomi верны. Возможно, требуется двухфакторная аутентификация.

🐌

Медленный отклик

Настройте локальное управление через Gateway для более быстрого отклика устройств.

🔑

Проблемы с токеном

Используйте инструмент извлечения токена для получения ключа от вашего устройства.

Альтернативная интеграция: Xiaomi Miot Auto

Если вы испытываете проблемы с официальной интеграцией Xiaomi Home, рекомендуем попробовать Xiaomi Miot Auto - альтернативную интеграцию с расширенными возможностями.

Xiaomi Miot Auto предлагает:

  • Более широкую совместимость с устройствами
  • Дополнительные функции и настройки
  • Лучшую поддержку локального управления
  • Активное развитие сообщества

⚠️ Внимание: Не рекомендуется устанавливать обе интеграции одновременно. Выберите одну: Xiaomi Home или Xiaomi Miot Auto.

Полезные ссылки

📖
Документация Xiaomi Home
Официальная документация
🔧
HACS
Установка через HACS
💬
Форум сообщества
Помощь и поддержка
🎨
UI дизайн
Настройка интерфейса

О руководстве

Это руководство является частью документации Home AssistantOS - проекта, направленного на снижение порога входа в мир HomeAssistant для русскоязычных пользователей. Мы создаём подробные учебники и инструкции, которые помогут вам настроить умный дом с нуля.

📚 Главная 🔧 HACS 🎨 UI дизайн