Большинство устройств Xiaomi Miio поддерживают настройку с помощью пользовательского интерфейса Home Assistant, за исключением трекера устройств Xiaomi и ИК-пульта Xiaomi. Дополнительные сведения см. в связанных разделах для этих устройств.
Устройства необходимо настраивать с помощью приложения Mi Home, а не приложений конкретного поставщика (например, Roborock).
Дополнительную информацию о более сложных настройках сети (например, VLAN) см. в следующей документации.
Добавить Xiaomi Miio в свой экземпляр Home Assistant можно через пользовательский интерфейс с помощью этой кнопки «Мой»:
Home Assistant может автоматически обнаружить Xiaomi Miio. Если экземпляр был найден, он будет отображаться как Обнаружено, и вы можете выбрать его, чтобы сразу настроить.
Если ничего не было обнаружено автоматически, не волнуйтесь! Вы можете настроить запись интеграции вручную:
Рекомендуется предоставить свои учетные данные для облака Xiaomi во время настройки, чтобы автоматически подключаться к вашим устройствам. Вам нужно указать облачный сервер, который вы использовали в приложении Xiaomi Home (где вы изначально настраивали устройство). Есть 6 серверов: cn, de, i2, ru, sg и us; см. эту страницу, чтобы узнать, какой сервер использовать для каждой страны.
Интеграция шлюза xiaomi_miio позволяет управлять шлюзом и подключенными к нему подустройствами.
Некоторые шлюзы (lumi.gateway.mieu01) не поддерживают локальное получение подключенных субустройств. Для этих шлюзов облачные учетные данные можно указать во время процесса настройки, а «Использовать облако для подключения подустройств» можно включить в потоке параметров (после настройки интеграции нажмите «Конфигурация» на боковой панели, затем нажмите «Интеграции», а затем нажмите «Параметры»). на уже настроенной интеграции Xiaomi Miio Gateway). Затем подключенные подустройства будут извлекаться из облака Xiaomi Miio (Интернет), а управление и обновления состояния этих подустройств будут осуществляться через подключение к локальной сети. Поток повторной аутентификации может быть запущен, когда учетные данные облака еще не предоставлены и необходимы для этой конкретной модели шлюза.
Эти подустройства распознаются кодом python-miio, но над ними все еще ведется работа (еще не реализовано).
| Имя подустройства | Идентификатор Zigbee | модель |
|---|
< td>Кнопка | lumi.sensor_switch | WXKG01LM |
| Кнопка | lumi.sensor_switch.aq2 | WXKG11LM 2015 |
| Кнопка | lumi.sensor_switch.aq3 | WXKG12LM |
| Кнопка | lumi.remote.b1acn01 | WXKG11LM 2018 |
| Куб | lumi.sensor_cube.v1 | MFKZQ01LM |
| Cube | lumi.sensor_cube.aqgl01 | MFKZQ01LM |
| Датчик движения | lumi.sensor_motion | RTCGQ01LM |
| Датчик движения | lumi.sensor_motion.aq2 | RTCGQ11LM |
| датчик двери | lumi.sensor_magnet | MCCGQ01LM |
| Датчик двери | lumi.sensor_magnet.aq2 | MCCGQ11LM |
< td>Датчик вибрации | lumi.vibration.aq1 | DJT11LM |
| Детектор дыма Honeywell | lum i.sensor_smoke | JTYJ-GD-01LM/BW |
| Детектор природного газа Honeywell | lumi.sensor_natgas | < td>JTQJ-BF-01LM/BW
| Датчик утечки воды | lumi.sensor_wleak.aq1 | SJCGQ11LM |
| Дистанционный переключатель одинарный | lumi.sensor_86sw1.v1 | WXKG03LM 2016 |
| Дистанционный переключатель один | lumi.remote.b186acn01 | WXKG03LM 2018 |
| Дистанционный переключатель D1 одинарный | lumi.remote .b186acn02 | WXKG06LM |
| Двойной дистанционный переключатель | lumi.sensor_86sw2.v1 | WXKG02LM 2016 |
| Двойной дистанционный переключатель | lumi.remote.b286acn01 | WXKG02LM 2018 |
| Двойной дистанционный выключатель D1 | lumi.remote.b286acn02 | WXKG07LM |
| Curtain | lumi.curtain< /td> | ZNCLDJ11LM |
| Занавес | lumi.curtain.aq2 | ZNGZDJ11LM |
| Занавес B1 | lumi.curtain.hagl04 | ZN CLDJ12LM |
| Дверной замок S1 | lumi.lock.aq1 | ZNMS11LM |
< td>Дверной замок S2 | lumi.lock.acn02 | ZNMS12LM |
| Дверной замок S2 pro | lumi.lock.acn03 | ZNMS13LM |
| Цилиндровый замок Vima | lumi.lock.v1 | A6121 |
| Термостат S2 | lumi.airrtc.tcpecn02 | KTWKQ03ES |
Отслеживание устройств Xiaomi (Xiaomi Mi WiFi Repeater 2)
Платформа отслеживания устройств xiaomi_miio отслеживает ваш Xiaomi Mi WiFi Repeater 2 и сообщает обо всех связанных клиентах WiFi.
Следуйте инструкциям по получению токена доступа, чтобы получить токен API.
Платформа датчиков xiaomi_ble позволяет отслеживать выходные данные устройств Xiaomi Bluetooth Low Energy с помощью концентратора ESP32 Bluetooth Low Energy Tracker Hub. Этот компонент будет отслеживать, например, температуру, влажность, влажность, проводимость, освещенность, формальдегид, таблетку от комаров и уровень заряда батареи устройства каждый раз, когда датчик отправляет трансляцию BLE. В отличие от других реализаций, xiaomi_ble пассивно прослушивает рекламные пакеты и не подключается к устройству. Следовательно, ESPHome не влияет на срок службы батареи.
Поддерживаемые устройства¶
HHCCJCY01¶
MiFlora, Huahuacaocao, измеряет температуру, влажность, окружающее освещение и уровень питательных веществ в почве.
![../../_images/xiaomi_hhccjcy01.jpg]()
Более новые версии HHCCJCY01 поставляются с прошивкой 3.2.1 и больше не отправляют данные об уровне заряда батареи.
GCLS002¶
VegTrug Grow Care Garden, Takasho, подходит для выращивания на открытом воздухе, аналогичен MiFlora.
![../../_images/xiaomi_gcls002.jpg]()
HHCCPOT002¶
FlowerPot, Huahuacaocao, RoPot, пропускают влагу и обеспечивают проводимость
![../../_images/xiaomi_hhccpot002.jpg]()
LYWSDCGQ¶
Гигротермометр, круглый корпус, сегментный ЖК-дисплей, транслирует температуру, влажность и уровень заряда батареи.
![../../_images/xiaomi_lywsdcgq.jpg]()
LYWSD02¶
Гигротермометр, прямоугольный корпус, дисплей на электронных чернилах, транслирует температуру, влажность и уровень заряда батареи.
Уровень заряда батареи, нужна прошивка xiaomi 1.1.2_0085
Cleargrass (Qingping): гигрометр, круглый корпус, дисплей на электронных чернилах.
Новая прошивка требует ключ привязки для расшифровки полученных данных (см. Получение ключа привязки ) и перестала транслировать уровень заряда батареи.
![../../_images/xiaomi_cgg1.jpg]()
LYWSD03MMC¶
Гигротермометр, небольшой квадратный корпус, сегментный ЖК-дисплей, зашифрованный, транслирует температуру, влажность и состояние батареи.
![../../_images/xiaomi_lywsd03mmc.jpg]()
Существуют следующие возможности управления этим датчиком:
Стандартная прошивка Xiaomi (требуется ключ привязки для расшифровки полученных данных, см. Получение ключа привязки )
Устройство прошито пользовательской прошивкой ATC MiThermometer
Устройство прошито кастомной прошивкой PVVX MiThermometer
Реклама «Мне нравится» (требуется фиктивный ключ привязки)
«Пользовательская» реклама (привязка не требуется)
Пользовательское объявление «pvvx» (привязка не требуется, только прошивка PVVX)
Пример конфигурации для стоковой прошивки Xiaomi или прошивки ATC MiThermometer, настроенной на рекламу «Мне нравится»:
Пример конфигурации прошивки ATC MiThermometer с установленным рекламным объявлением «Custom»:
Пример конфигурации для микропрограммы PVVX MiThermometer, настроенной на «Пользовательскую» рекламу:
MHO-C303¶
Гигротермометр с будильником, прямоугольный корпус, дисплей на электронных чернилах, трансляция температуры, влажности и состояния батареи. Не зашифровано.
![../../_images/xiaomi_mhoc303.jpg]()
Аналогично LYWSD02, но с дополнительными функциями часов (будильник, таймер помидора). Работает от двух батареек ААА.
MHO-C401¶
Гигротермометр, квадратный корпус, дисплей на электронных чернилах, шифрование, трансляция температуры, влажности и состояния батареи. Требуется ключ привязки для расшифровки полученных данных (см. Получение ключа привязки ).
![../../_images/xiaomi_mhoc401.jpg]()
( MHO-C201 не имеет BT)
Подобно LYWSD03MMC, для этого устройства доступна специальная прошивка, поэтому есть следующие возможности для работы с этим датчиком:
Стандартная прошивка Xiaomi (требуется ключ привязки для расшифровки полученных данных, см. Получение ключа привязки )
Устройство прошито кастомной прошивкой PVVX MiThermometer
Реклама «Мне нравится» (требуется фиктивный ключ привязки)
Пользовательское объявление «pvvx» (привязка не требуется, только прошивка PVVX)
Пример конфигурации для микропрограммы PVVX MiThermometer, настроенной на «Пользовательскую» рекламу:
Будильник Cleargrass (Qingping), сегментный ЖК-дисплей, зашифрованный, транслирует температуру, влажность и состояние батареи. Требуется ключ привязки для расшифровки полученных данных (см. Получение ключа привязки ).
![../../_images/xiaomi_cgd1.jpg]()
CGDK2¶
Cleargrass (Qingping) Temp & RH Lite, круглый корпус, сегментный ЖК-дисплей, шифрование, трансляция температуры, влажности и состояния батареи. Требуется ключ привязки для расшифровки полученных данных (см. Получение ключа привязки). Измерения транслируются каждые 10-15 минут.
![../../_images/xiaomi_cgdk2.jpg]()
JQJCY01YM¶
Датчик формальдегида Xiaomi (Honeywell), OLED-дисплей, транслирует информацию о температуре, влажности, концентрации формальдегида (мг/м³) и состоянии батареи.
![../../_images/xiaomi_jqjcy01ym.jpg]()
WX08ZM¶
Умная версия Mosquito Repellent, транслирует уровень ресурсов планшета, состояние включения/выключения и уровень заряда батареи, реализована в виде гибридного датчика, требует наличия как датчика, так и двоичного_сенсора в конфигурации.
![../../_images/xiaomi_wx08zm.jpg]()
MUE4094RT¶
Ночной свет Xiaomi Philips BLE, транслирует обнаружение движения (обнаружено/сброшено, вкл/выкл), время ожидания по умолчанию – 5 с, реализовано как гибридный датчик, в конфигурации требуется как датчик, так и бинарный_сенсор.
![../../_images/xiaomi_mue4094rt.jpg]()
MJYD02YL-A¶
Ночник Xiaomi Yeelight, замена MJYD02YL с BLE, транслирует статус включения/выключения света, обнаружение движения, время простоя с момента последнего события движения и состояние батареи. Требуется ключ привязки для расшифровки полученных данных (см. Получение ключа привязки). Реализован как гибридный датчик, в конфигурации требуется и датчик, и двоичный_сенсор.
![../../_images/xiaomi_mjyd02yla.jpg]()
CGPR1¶
Датчик движения и освещенности Qingping. Передает обнаружение движения, время простоя с момента последнего события движения, уровень освещенности и состояние батареи. Требуется ключ привязки для расшифровки полученных данных (см. Получение ключа привязки ).
![../../_images/xiaomi_cgpr1.jpg]()
Настройка устройств¶
mac_address (MAC-адрес): MAC-адрес устройства.
bindkey (строка, 32 символа, без учета регистра): ключ для расшифровки объявлений BLE для зашифрованных типов датчиков
Необязательно с именем, идентификатором ( ID ) и всеми другими параметрами датчика :
температура
влажность
влага
освещенность
проводимость
планшет
формальдегид
уровень_батареи
Чтобы найти MAC-адрес, чтобы ESPHome мог идентифицировать устройство, вы можете создать простую конфигурацию без каких-либо записей датчика:
После загрузки ESP32 немедленно попытается найти устройства BLE. Когда он обнаружит новый датчик, он автоматически проанализирует сообщение BLE и напечатает сообщение, подобное этому:
Иногда получение первой трансляции BLE может занять некоторое время. Как только устройство будет найдено, скопируйте адрес A4:C1:38:4E:16:78 в новую запись платформы, как показано в примерах конфигураций.
Получение Bindkey¶
Чтобы настроить зашифрованное устройство, такое как LYWSD03MMC (со стандартной прошивкой Xiaomi) и CGD1, сначала необходимо получить ключ привязки. Компонент датчика xiaomi_ble не может автоматически генерировать ключ привязки, поэтому необходимы другие обходные пути.
LYWSD03MMC/MHO-C401¶
Если датчик LYWSD03MMC или MHO-C401 работает со стандартной прошивкой Xiaomi, вы можете использовать приложение TeLink flasher, чтобы легко сгенерировать новый ключ привязки и загрузить ключ на устройство без необходимости прошивать новую прошивку (см. фигура). Для этого вы загружаете веб-страницу флешера в поддерживаемом браузере и подключаете устройство, нажав «Подключиться». После того, как соединение установлено, вы нажимаете кнопку «Do Activation» и новый ключ отобразится в поле «Mi Bind Key». Ключ можно скопировать непосредственно в YAML-конфигурацию датчика.
![../../_images/telink_flasher.jpg]()
Прошивальщик Telink. ¶
Новый ключ привязки будет работать с ESPHome, но приложение Mi Home больше не будет распознавать датчик, как только устройство будет активировано приложением TeLink flasher. Чтобы снова использовать датчик с приложением Xiaomi Mi Home, устройство необходимо удалить, а затем снова добавить в приложение Mi Home.
CGDK2¶
Метод получения нового ключа привязки для датчика CGDK2 аналогичен методу для датчика LYWSD03MMC, за исключением того, что используется модифицированная версия приложения-прошивальщика.
Для этого вы загружаете приложение в поддерживаемом браузере и подключаете устройство, нажав «Подключиться». После того, как соединение установлено, вы нажимаете кнопку «Do Activation» и новый ключ отобразится в поле «Mi Bind Key». Ключ можно скопировать непосредственно в YAML-конфигурацию датчика.
Другие зашифрованные устройства¶
<р>1. Самый простой метод (подтверждено, что он работает для LYWSD03MMC) — использовать метод прошивальщика Telink. В сопроводительном видео показано, как прошить LYWSD03MMC без проводов или как получить ключ привязки стоковой прошивки (смотреть примерно до 13:10). Кастомная прошивка позволяет изменить несколько настроек устройства, в том числе смайлик и рекламный интервал. Имейте в виду, что при прошивке пользовательской прошивки вам необходимо включить «Тип рекламы» на «Mi Like» и предоставить ESPHome фиктивный ключ привязки, поскольку он все еще ожидает его, даже если пользовательская прошивка не шифрует данные.
<р>2. Другой вариант — использовать оригинальное приложение Mi Home, чтобы добавить датчик один раз. При добавлении устройства генерируется новый ключ, который загружается в облако Xiaomi и на само устройство. В настоящее время необходимо выбрать китайский сервер, так как остальной мир еще не поддерживает большинство этих устройств. После создания ключ не изменится снова, пока устройство не будет удалено и повторно добавлено в приложение Xiaomi.
2а. Самый простой способ получить ключ привязки из облака — использовать экстрактор облачных токенов, написанный одним из пользователей Home Assistant. Если вы предпочитаете не использовать исполняемый файл, прочитайте здесь.
2б. Другой вариант — использовать анализатор пакетов SSL. Его можно настроить как на телефоне Android, так и на iPhone. Хороший выбор для Android — Remote PCAP в сочетании с Wireshark. Учебное пособие по настройке анализатора пакетов Remote PCAP можно найти здесь и здесь. Инструкции по получению ключа с помощью iPhone находятся здесь. Как только трафик между приложением Mi Home и серверами Xiaomi будет записан, ключ привязки будет отображаться открытым текстом:
bind_key — это 32-значный элемент «значение» в приведенном выше выводе, который необходимо вставить в файл конфигурации.
Интеграция xiaomi_aqara позволяет интегрировать устройства, совместимые с Xiaomi Aqara, в Home Assistant.
Обратите внимание, что существует две версии концентратора: v1 и v2. v1 можно использовать с Home Assistant без каких-либо проблем, однако v2 может быть менее простым, когда речь идет о включении локального API, и может даже потребовать, чтобы вы открыли свое устройство, чтобы сделать это. Xiaomi предположила, что это находится в стадии разработки.
Поддерживаемые устройства
- Aqara Air Conditioning Companion (lumi.acpartner.v3)
- Интеллектуальный дверной замок Aqara (lock.aq1)
- Настенный выключатель Aqara (двойной)
- Настенный выключатель Aqara (одиночный)
- Настенный выключатель Aqara LN (двойной)
- Настенный выключатель Aqara LN (одинарный)
- Беспроводной переключатель Aqara (двойной)
- Беспроводной коммутатор Aqara (одиночный)
- Батарея
- Кнопка 1-го поколения (одиночное, двойное, длительное нажатие)
- Кнопка 2-го поколения (одинарная, двойная)
- Куб
- Датчик двери и окна (1-го и 2-го поколения)
- Детектор утечки газа (сообщает о тревоге и плотности)
- Шлюз (освещение, датчик освещенности, воспроизведение рингтона)
- Умный занавес
- Датчик движения (1-го и 2-го поколения)
- Plug aka Socket (версия Zigbee, отчеты о потребляемой мощности, нагрузке, состоянии и использовании устройства)
- Детектор дыма (сообщает о тревоге и плотности)
- Датчик температуры и влажности (1-го и 2-го поколения)
- Датчик вибрации
- Сетевая розетка (отчеты о потребляемой мощности, нагрузке и состоянии)
- Датчик утечки воды
- Шлюз Xiaomi Mijia (lumi.gateway.v2, lumi.gateway.v3)
Неподдерживаемые устройства
- Xiaomi Aqara Gateway (lumi.gateway.aqhm01), так как невозможно активировать режим разработки в приложении Mi Home.
- Радио шлюза
- Кнопка шлюза
- Xiaomi Mi Air Conditioning Companion (lumi.acpartner.v2)
- Контроллер интеллектуального кондиционера Aqara (lumi.acpartner.v1)
- Раздельный режим настенных выключателей Aqara (одиночный и двойной)
- Дополнительные тревожные события детектора газа и дыма: аналоговая тревога, тревога о неисправности батареи (только для дымовых извещателей), тревога о неисправности чувствительности, сбой связи I2C.
Настройка
Следуйте процессу установки с помощью телефона и приложения Mi-Home. Отсюда вы сможете получить ключ (пароль) из приложения, следуя этому руководству.
Чтобы включить Xiaomi Gateway (Aqara) в своей установке, перейдите в раздел «Конфигурация» на боковой панели и нажмите «Устройства и службы». Шлюзы Xiaomi Aqara должны обнаруживаться автоматически и отображаться в обзоре. Нажмите «Настроить» и выполните шаги, чтобы указать дополнительные параметры. Если ваш шлюз aqara не отображается автоматически, щелкните значок + в правом нижнем углу. Затем найдите «xiaomi_aqara» и войдите в настройки. Можно настроить несколько шлюзов, просто повторив настройку несколько раз.
Сопряжение устройства Bluetooth с вашим Xiaomi Mi 9 Android 9.0
Bluetooth – это беспроводное соединение, которое можно использовать для подключения к другим устройствам, таким как беспроводная гарнитура или клавиатура.
<р>1. Найдите "Bluetooth"
![]()
< бр />
![]()
< бр />
![]()
< бр />
<р>1. Найдите "Bluetooth"
![]()
< бр />
![]()
< бр />
![]()
< бр />
<р>2. Включите Bluetooth
Нажмите индикатор рядом с "Bluetooth", чтобы включить эту функцию.
![]()
< бр />
![]()
< бр />
![]()
< бр />
<р>3. Соедините Bluetooth-устройство с телефоном
Нажмите Редко используемые устройства .
![]()
< бр />
![]()
< бр />
![]()
< бр />
<р>3. Соедините Bluetooth-устройство с телефоном
Нажмите на нужное устройство Bluetooth и следуйте инструкциям на экране, чтобы связать устройство с телефоном.
Читайте также:
< бр />
< бр />
< бр />
< бр />