Библиотека Python и CLI-инструмент miiocli для управления устройствами умного дома Xiaomi по протоколам miIO и MIoT.
XiaoMi/ha_xiaomi_home
Официальная интеграция Xiaomi для управления IoT-устройствами Xiaomi в Home Assistant через Xiaomi Cloud или локальный шлюз центрального хаба Xiaomi.
Open source альтернатива:Mi Home
- Звёзды
- 22,240
- Форки
- 1,193
- Открытые issues
- 157
- Последний коммит
- 26 дней назад
Что это?
Xiaomi Home Integration — это кастомный компонент для Home Assistant, который поддерживает Xiaomi и который добавляет IoT-устройства Xiaomi в Home Assistant. Пользователи входят с помощью аккаунта Xiaomi через OAuth 2.0, выбирают дом, и устройства в нём создаются как сущности Home Assistant.
Устройства сопоставляются со спецификацией MIoT-Spec-V2. Свойства, доступные для записи, становятся сущностями Switch, Number, Select или Text, свойства только для чтения — сущностями Sensor, события — сущностями Event, а действия — сущностями Button или Notify. Правила преобразования сущностей можно настраивать с помощью локальных файлов фильтров спецификации и переводов. В один экземпляр Home Assistant можно добавить несколько аккаунтов Xiaomi.
Обычно управление происходит через Xiaomi Cloud. Если в системе есть шлюз центрального хаба Xiaomi или устройство со встроенным хабом, команды и обновления состояния могут передаваться локально по MQTT. Для некоторых устройств, подключённых по IP, доступно управление по LAN, однако проект не рекомендует его использовать.
Ключевые возможности
- 01Добавляет IoT-устройства Xiaomi в Home Assistant после входа в аккаунт Xiaomi
- 02Преобразует свойства, события и действия MIoT-Spec-V2 в сущности Home Assistant
- 03Поддерживает локальное управление через шлюз центрального хаба Xiaomi или устройства со встроенным хабом
- 04Позволяет использовать несколько аккаунтов и регионов Xiaomi в одном экземпляре
- 05Предлагает 13 языков интерфейса и настраиваемые правила преобразования сущностей
Сценарии использования
- Управление светильниками, розетками и датчиками Xiaomi с панели Home Assistant
- Создание автоматизаций, объединяющих устройства Xiaomi с устройствами других производителей умного дома
- Локальное управление в первую очередь с помощью шлюза центрального хаба Xiaomi в материковом Китае
Темы
Частые вопросы
- Что такое ha_xiaomi_home?
- Официальная интеграция Xiaomi для управления IoT-устройствами Xiaomi в Home Assistant через Xiaomi Cloud или локальный шлюз центрального хаба Xiaomi. Xiaomi Home Integration — это кастомный компонент для Home Assistant, который поддерживает Xiaomi и который добавляет IoT-устройства Xiaomi в Home Assistant. Пользователи входят с помощью аккаунта Xiaomi через OAuth 2.0, выбирают дом, и устройства в нём создаются как сущности Home Assistant.
- ha_xiaomi_home можно использовать бесплатно? Какая у него лицензия?
- ha_xiaomi_home распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- ha_xiaomi_home всё ещё поддерживается?
- Активно поддерживается. Последний коммит в ha_xiaomi_home — 28 сент. 2026 г..
- Для чего можно использовать ha_xiaomi_home?
- Управление светильниками, розетками и датчиками Xiaomi с панели Home Assistant Создание автоматизаций, объединяющих устройства Xiaomi с устройствами других производителей умного дома Локальное управление в первую очередь с помощью шлюза центрального хаба Xiaomi в материковом Китае
- Где скачать ha_xiaomi_home?
- Исходный код и инструкции по установке — на GitHub: https://github.com/XiaoMi/ha_xiaomi_home
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Настольный клиент для Windows, позволяющий управлять устройствами умного дома Xiaomi Mijia через графический интерфейс, системный трей и виджет рабочего стола; построен на библиотеке mijiaAPI.
Приложение для строки меню Mac и iPhone, которое показывает дом в виде интерактивной 3D-модели и управляет освещением и кондиционерами через Smart Life, Home Assistant, Hue и Apple Home.
Платформа автоматизации умного дома с открытым исходным кодом: работает локально и ставит во главу угла контроль и приватность, часто — на Raspberry Pi или локальном сервере.
Мост для подключения устройств умного дома Zigbee к MQTT, чтобы они работали без фирменного хаба или шлюза производителя.
Открытая прошивка для ESP32, позволяющая управлять адресными RGB-лентами, 2D-матрицами и панелями HUB75 по WiFi.