Интеграция устройств экосистемы Xiaomi в платформу Home Assistant открывает перед пользователем колоссальные возможности для создания сложных сценариев автоматизации. Умная розетка, будь то модель Mi Smart Plug или более продвинутая версия с мониторингом энергопотребления, становится не просто выключателем, а полноценным датчиком, передающим данные о потреблении электричества в реальном времени. Процесс установки может показаться сложным новичку, но при правильной подготовке он занимает не более 15-20 минут.
Основная сложность заключается в том, что стандартный протокол Mi Home не поддерживает прямую локальную интеграцию без использования облачных сервисов, что нарушает принцип приватности и автономности умного дома. Именно поэтому мы будем использовать проверенные методы локального подключения, которые обеспечивают мгновенный отклик устройств и работу даже при отсутствии доступа к интернету. Вам потребуется стабильная сеть WiFi 2.4 ГГц и доступ к интерфейсу вашего сервера автоматизации.
В этой статье мы подробно разберем два основных способа подключения: через официальную интеграцию Xiaomi Miio и через сторонние аддоны, такие как Xiaomi Gateway 3. Мы затронем вопросы получения токенов доступа, настройки статических IP-адресов и создания эффективных автоматизаций для экономии электроэнергии. Готовность следовать инструкциям и внимание к деталям — ключ к успеху в настройке вашей инфраструктуры.
⚠️ Внимание: Убедитесь, что ваша розетка и сервер Home Assistant находятся в одной подсети (одинаковый диапазон IP-адресов), иначе локальное обнаружение устройства будет невозможным.
Подготовка оборудования и сети
Перед началом программной настройки необходимо выполнить ряд физических действий, которые часто игнорируются, но являются критически важными. Во-первых, умные устройства Xiaomi работают исключительно в диапазоне частот 2.4 ГГц. Если ваш роутер транслирует сети 2.4 ГГц и 5 ГГц под одним именем (функция Smart Connect), могут возникнуть проблемы с первоначальным сопряжением. В таком случае рекомендуется временно разделить сети или создать гостевую сеть только для IoT-устройств.
Во-вторых, для стабильной работы интеграции Miio настоятельно рекомендуется закрепить за розеткой статический IP-адрес в настройках вашего роутера. Это предотвратит ситуацию, когда после перезагрузки маршрутизатора устройство получит новый адрес, и Home Assistant потеряет с ним связь. Зарезервируйте адрес по MAC-адресу устройства, который можно найти на наклейке снизу розетки или в приложении Mi Home.
- 📡 Убедитесь, что смартфон подключен к сети WiFi 2.4 ГГц перед началом настройки.
- 🔌 Вставьте розетку в сеть и дождитесь мигания индикатора (режим сопряжения).
- 🌐 Зарезервируйте статический IP-адрес для MAC-адреса розетки в интерфейсе роутера.
- 📱 Установите официальное приложение Mi Home и привяжите устройство к аккаунту для первичной проверки.
Важным этапом является определение модели вашего устройства, так как разные модификации розеток используют разные протоколы команд. Например, модели серии ZNCZ05CM и SP-M5 могут требовать различных параметров в конфигурационных файлах. Точная модель обычно указана на нижней грани устройства или на коробке.
⚠️ Внимание: Интерфейсы роутеров и версии прошивок устройств Xiaomi регулярно обновляются, меняя расположение меню. Если вы не можете найти настройку резервирования IP, сверьтесь с официальной документацией производителя вашего роутера.
Получение токена доступа Mi Cloud
Самым сложным и важным этапом интеграции является получение уникального токена устройства. Токен — это ключ шифрования, который позволяет Home Assistant отправлять команды непосредственно на розетку, минуя облачные сервера Xiaomi. Без этого ключа локальное управление невозможно, так как протокол Miio использует AES-шифрование для всех передаваемых пакетов данных.
Существует несколько методов извлечения токена. Самый простой и современный способ — использование интеграции Xiaomi Cloud Token Extractor, которая требует только ввода логина и пароля от вашего аккаунта Mi Cloud. Альтернативный, более сложный метод, предполагает использование сниффера трафика (например, mitmproxy) на компьютере, подключенном к той же WiFi сети, что и розетка, однако он требует глубоких знаний сетевых протоколов.
После ввода данных аккаунта в инструмент extraction, вы получите список всех устройств, привязанных к вашему региону. Найдите в списке вашу розетку по имени или MAC-адресу и скопируйте длинную строку символов — это и есть искомый токен. Сохраните его в надежном месте, так как он действует бессрочно, пока вы не сбросите устройство или не измените пароль акка Mi.
Device Name: Mi Smart Plug
Token: 3a4b5c6d7e8f9g0h1i2j3k4l5m6n7o8p
IP Address: 192.168.1.55
Model: zcu.zcu03.zncz05cm
Что делать, если токен не подходит?
Если после ввода токена устройство не добавляется, проверьте регион аккаунта. Токен действителен только для того сервера (Китай, Европа, Россия, США), к которому привязано устройство. Попробуйте сменить регион в настройках интеграции.
Установка и настройка HACS
Для расширения функционала Home Assistant и установки специализированных интеграций, таких как Xiaomi Miio (если она не встроена в вашу версию) или Xiaomi Gateway 3, необходим пакетный менеджер HACS (Home Assistant Community Store). Это неофициальный магазин дополнений, созданный сообществом, который значительно упрощает установку кастомных компонентов.
Установка HACS производится через терминал или File Editor, если у вас есть доступ к файловой системе сервера. Процесс включает в себя скачивание архива репозитория и его распаковку в папку custom_components. После перезагрузки сервера в настройках появится новый раздел, где можно будет искать и устанавливать необходимые плагины.
- 📥 Откройте терминал Home Assistant и перейдите в директорию конфигурации.
- 📂 Создайте папку
custom_components, если она отсутствует. - ⬇️ Скачайте последнюю версию HACS с официального GitHub репозитория.
- 🔄 Перезагрузите сервер через меню
Настройки → Система → Перезагрузка.
После успешной установки HACS, перейдите в раздел Интеграции и нажмите кнопку добавления новой. В поиске введите"Xiaomi Miio" или название конкретного плагина, который вы планируете использовать. Следуйте инструкциям мастера настройки, вводя ранее полученный токен и IP-адрес розетки.
☑️ Проверка перед установкой HACS
Добавление устройства через интеграцию Miio
Официальная интеграция Xiaomi Miio является наиболее стабильным способом подключения розеток. Она поддерживает большинство популярных моделей, включая Mi Smart Plug (WiFi) и версии с USB-портами. После установки компонента через HACS или активации встроенной интеграции, перейдите в раздел Настройки → Устройства и службы → Добавить интеграцию.
В появившемся окне выберите Xiaomi Miio. Вам будет предложено ввести IP-адрес устройства и токен. Если данные введены верно, Home Assistant мгновенно обнаружит устройство и начнет опрашивать его статус. В отличие от облачных решений, статус в интерфейсе будет обновляться практически без задержек, а команда на включение/выключение будет выполняться мгновенно.
Важно отметить, что для некоторых моделей может потребоваться ручное указание типа устройства в конфигурации configuration.yaml, если автоматическое определение не сработало. В этом случае необходимо добавить запись с параметром model, соответствующим идентификатору вашей розетки (например, zncz05cm).
| Параметр | Значение | Описание |
|---|---|---|
| platform | xiaomi_miio | Тип платформы интеграции |
| host | 192.168.1.XX | Статический IP-адрес розетки |
| token | 32 символа | Ключ доступа устройства |
| name | Living Room Plug | Имя устройства в системе |
⚠️ Внимание: При изменении конфигурации через YAML-файл обязательна полная перезагрузка Home Assistant, а не просто перезагрузка интеграции, иначе изменения не вступят в силу.
Настройка сенсоров и мониторинг энергии
Одной из главных причин покупки умной розетки является возможность мониторинга энергопотребления. Модели с поддержкой этой функции (обычно имеют маркировку"Power" или"Energy") передают данные о текущей мощности, напряжении, силе тока и накопленной энергии. В Home Assistant эти данные автоматически создаются как отдельные сенсоры.
Вы можете увидеть сущности вроде sensor.living_room_plug_power (текущая мощность в Ваттах) и sensor.living_room_plug_energy (потребление в кВт*ч). Эти данные можно использовать для построения графиков в Loevlace или Energy Dashboard, чтобы анализировать, сколько электричества потребляет подключенный прибор в разное время суток.
Для корректного отображения данных в панели энергии Home Assistant, убедитесь, что сенсоры имеют правильные единицы измерения. Обычно интеграция сама присваивает атрибуты unit_of_measurement: W для мощности и unit_of_measurement: kWh для энергии. Если это не так, можно использовать шаблонные сенсоры (template) для преобразования значений.
Создание автоматизаций и сценариев
После успешного добавления розетки в систему открывается мир безграничных возможностей автоматизации. Вы больше не ограничены простым расписанием. Например, вы можете создать сценарий, который выключает розетку с обогревателем, если окно в комнате открыто (используя датчик открытия окна Xiaomi).
Другой популярный сценарий — имитация присутствия. Настройте розетку с лампой включаться и выключаться в случайные промежутки времени вечером, создавая эффект того, что дома кто-то есть. Также можно использовать таймеры: выключать зарядное устройство через 2 часа после подключения, чтобы сохранить ресурс аккумулятора.
Для создания автоматизации перейдите в раздел Настройки → Автоматизация и создайте новую. В качестве триггера можно выбрать время, состояние другого устройства или событие в системе. Действием будет вызов сервиса switch.turn_on или switch.turn_off для вашей розетки.
- ⏰ Запускайте кофеварку за 15 минут до вашего пробуждения по будильнику.
- 💡 Включайте свет в коридоре при срабатывании датчика движения ночью.
- 🔌 Отключайте неиспользуемую технику (ТВ, монитор) при переходе в режим"Никого нет дома".
- 📉 Отслеживайте пиковое потребление и отключайте мощные приборы при превышении лимита.
Решение проблем и FAQ
В процессе эксплуатации могут возникать различные технические сложности, связанные с обновлением прошивок роутеров или изменением политики безопасности Xiaomi. Часто пользователи сталкиваются с потерей связи с устройством или ошибками авторизации. Большинство проблем решается проверкой статичности IP-адреса и актуальности токена.
Если розетка перестала реагировать на команды, попробуйте перезагрузить саму розетку (выключить из сети на 10 секунд). В редких случаях помогает перепривязка устройства в приложении Mi Home и получение нового токена, так как старый мог быть деактивирован сервером при смене пароля аккаунта.
Почему Home Assistant не видит розетку после перезагрузки роутера?
Скорее всего, розетка получила новый IP-адрес, а в интеграции прописан старый. Зайдите в настройки роутера и закрепите IP-адрес за MAC-адресом розетки (Static Lease / DHCP Reservation). После этого перенастройте интеграцию в Home Assistant с новым адресом.
Можно ли управлять розеткой без интернета?
Да, при использовании локальной интеграции Miio управление происходит напрямую по локальной сети. Интернет нужен только для первоначальной настройки и получения токена. После настройки розетка будет работать даже при отключенном внешнем канале связи.
Как сбросить розетку Xiaomi до заводских настроек?
Зажмите кнопку на корпусе розетки (если она есть) или используйте скрепку для надавливания на скрытую кнопку сброса в течение 5-7 секунд, пока индикатор не начнет быстро мигать. После этого устройство нужно будет настроить заново.
Поддерживает ли интеграция работу с несколькими розетками?
Да, вы можете добавить неограниченное количество устройств. Каждое устройство будет иметь свои уникальные сущности (switch, sensor). Рекомендуется давать им понятные имена сразу при добавлении, чтобы не запутаться в списке устройств.
Что означает ошибка"Unable to discover device"?
Эта ошибка указывает на проблемы с сетью. Проверьте, находятся ли сервер Home Assistant и розетка в одной подсети (VLAN). Также убедитесь, что фаервол не блокирует UDP-порт 54321, который используется протоколом Miio для обнаружения.