Xiaomi Gateway 3 — подключение к Home Assistant

Шлюз Gateway 3 наверняка знаком вам, если у вас есть умные дома на устройствах Xiaomi и Aqara. Эта маленькая белая коробочка служит настоящим центром управления, подключающим лампочки, выключатели и датчики с помощью фирменного приложения Mi Home. Но что, если вы хотите выйти за рамки одного бренда и объединить все в единую систему?

Именно здесь на помощь приходит Home Assistant — популярная платформа для автоматизации, которая ставит во главу угла локальную работу и вашу приватность. Подключив шлюз Xiaomi Gateway 3 к Home Assistant, вы получаете полный контроль над своими устройствами прямо из одного интерфейса, без необходимости полагаться на облачные сервисы и с гораздо более широкими возможностями для создания сложных сценариев.

Процессы интеграции могут показаться довольно техническими, но даже новички могут справиться с ними. Всё, что вам понадобится, это сам шлюз, Home Assistant и несколько минут времени. Давайте поговорим о том, как эти две системы могут работать вместе, чтобы ваш умный дом был действительно умным и автономным.

Версии прошивок

До прошивки версии v.1.4.6_0030 достаточно было только установить компонент в Home Assistant и получить токен устройства. Начиная с версии v.1.4.6_0043 прошивки на telnet был установлен пароль, который необходимо сбросить или снизить версию прошивки. Это было выполнено паяльно-термальным методом, что уже неудивительно. На данный момент все новые устройства поставляются с заводскими прошивками, не ниже версии v.1.4.6_0043.

Автор компонента рекомендует установку модифицированной прошивки версии v.1.4.6_0012 как основной метод работы с устройством, как следует из объяснения:

  • Прошивка версии v.1.4.6 стабильнее прошивок v.1.4.7
  • Отсутствует пароль на telnet
  • Улучшена работа с BLE устройствами
  • Основную работу над компонентом он ведет для прошивки версии v.1.4.6

Устройства с заводской прошивкой v.1.4.7_0063 могут использовать только метод понижения до измененной прошивки.

Прошивка устройства

ВНИМАНИЕ! Все, что вы делаете, делаете только на свой страх и риск, и автор статьи не несет никакой ответственности за любые последствия, которые могут возникнуть в результате действий, описанных в этой статье.

Требуется приложить немного усилий, чтобы восстановить устройство без повреждений. Подробные инструкции по сборке устройства доступны на YouTube-канале автора проекта.

Мы подключаемся к техническим контактам на плате шлюза, таким как TP8 — GND, TP11 — TX и TP4 — RX.

Скачайте необходимый PO:

  • Загрузчик из каталога, автор рекомендует этот (rtkboot_115200)
  • Скачиваем файл прошивки mgl03_xxxxx.uart из каталога.
  • Скачиваем файл mgl03_uart_recovery.ttl
  • Скачиваем и устанавливаем программу Tera Term для Windows

Запускаем Tera Term, выбираем Serial, затем выбираем порт UART адаптера и убедитесь, что все хорошо.

Выбираем «Контроль» — «Макро», а затем выбираем файл mgl03_uart_recovery.ttl, который был загружен ранее. Открывается новое окно.

Нажимаем «ОК» в появившемся окне.

Чтобы подключить шлюз к USB2TTL, следуйте инструкциям в сообщении ниже:

USB-to-TTL Xiaomi Gateway 3
GND GND
RX TX
TX RX

Предупреждение! Не подключайте адаптер UART к 3.3V или 5V.

Закройте информационное окно и подключите штатное питание к шлюзу через провод micro-USB. Появится требование выбрать файл rtkboot_xxxxxx.bin. Затем нажимаем OK и выбираем скачанный файл.

По завершении загрузки файла появится сообщение о необходимости выбрать файл прошивки mgl03_xxxxx.uart. Закройте сообщение и выберите скачанный файл. Ждите, пока загрузится прошивка; это займет время.

По завершении прошивки появится сообщение об успешном завершении. Чтобы перезагрузить шлюз, нажмите «ОК», и он сам перезагрузится.

Чтобы сбросить шлюз к заводским настройкам, десять раз нажимаем единственную кнопку. После того, как шлюз будет перезапущен, он издаст звуковой сигнал и моргнет зеленым диодом. Теперь вы можете подключиться к Mi Home из приложения штатными средствами. Если шлюз уже был включен в Mi Home раньше, его необходимо удалить. Проверяем, установлена ли необходимая нам прошивка в свойствах шлюза. Вместо этого программа предложит обновиться.

Если необходимо собирать шлюз, закрываем Tera Term и отключаем шлюз от питания и USB-2-TTL адаптера. Мы подключаем пищу. Чтобы проверить работу telnet, выполните следующее в командной строке:

telnet <strong>gateway_ip_address</strong>

Gateway_ip_address — адрес Интернет-протокола шлюза в локальной сети. Пользователь: менеджер

Мы получаем токен устройства в качестве дополнительного бонуса.

Безопасно! Рекомендуется ограничить доступ к устройству как из внешней, так и из локальной сети, поскольку пароль telnet не установлен. Лучше всего вывести все устройства умного дома в отдельную подсеть с ограниченным доступом, если это возможно.

Подключение к Home Assistant

Вариант #1. Установка из HACS.

Читай статью Установка HACS в помощника дома, если у вас еще не установлен HACS.

Перейдите к HACS, интеграции, меню и персонализированным хранилищам в помощнике дома.

В поле Add custom repository URL пишем AlexxIT/XiaomiGateway3, в разделе Categoty выбираем Integration. При нажатии кнопки ADD будет найден компонент (возможно, что репозиторий уже будет добавлен).

Находим и устанавливаем добавленный репозиторий в разделе HACS -> Integration, а затем перезагружаем помощника дома.

Вариант #2. Ручная установка компонента.

Если установка компонента из HACS невозможна по каким-либо причинам, компонент можно установить вручную.

Скачиваем архив со страницы компонента на GitHub и помещаем папку xiaomi_gateway3 в.homeassistant/custom_components, если ее нет. На момент написания статьи самый последний релиз компонента был v.0.11.0. Системы Linux/Unix будут выглядеть следующим образом:

$ sudo mkdir -p /home/homeassistant/.homeassistant/custom_components/ $ sudo wget https://github.com/AlexxIT/XiaomiGateway3/archive/v0.11.0.zip $ sudo unzip v0.11.0.zip $ sudo cp -R XiaomiGateway3-0.11.0/custom_components/xiaomi_gateway3/ /home/homeassistant/.homeassistant/custom_components/ $ sudo chown -R homeassistant:homeassistant /home/homeassistant/.homeassistant/custom_components/xiaomi_gateway3/

Пожалуйста, передайте архив, а также распакованные файлы и папки:

$ sudo rm -R XiaomiGateway3-0.11.0/ $ sudo rm -R v0.11.0.zip

Добавление интеграции Xiaomi Gateway 3 в Home Assistant

В Home Assistant переходим Configuration -> Integrations -> + Add integration, находим и добавляем интеграцию Xiaomi Gateway 3.

Компонент поддерживает автоматическое получение токена устройства из учетной записи Xiaomi, а также ввод вручную токена. После выбора второго варианта мы получаем токен, подключившись к шлюзу через telnet, как показано выше.

В статье «Получение токена для доступа к Xiaomi miio» описаны наиболее эффективные методы получения токена.

Вводим IP-адрес шлюза и токен устройства. Не забываем сделать статический адрес шлюза в настройках DHCP сервера, чтобы шлюз всегда получал постоянный адрес после перезагрузки.

Следующие две настройки будут доступны для шлюза после завершения настройки интеграции в Home Assistant:

  • Блокировка установки новых обновлений
  • Перевод в режим подключения новых ZigBee устройств

После включения блокировки обновления прошивки устройство пытается обновиться через приложение Mi Home, но процесс находится на стадии 0%.

Включите режим Pair, чтобы подключить ZigBee-устройства к Home Assistant. В Home Assistant и Mi Home появится новое устройство, подключенное к ним.

Xiaomi Gateway 3 — это умная колонка, которая может стать центральным звеном вашей умной квартиры, особенно если вы используете Home Assistant. Подключив её правильно, вы получаете возможность управлять множеством устройств Xiaomi без привязки к облаку, быстро и стабильно. Главное — прошить шлюз модифицированной прошивкой, чтобы открыть доступ к локальному управлению, и настроить в Home Assistant через специальный интеграционный плагин. После настройки вы увидите все подключённые датчики и устройства в интерфейсе Home Assistant и сможете включать их в сценарии, как будто они работают изначально с этой системой.

Найденные проблемы

Датчик температуры и влажности Bluetooth (LYWSDCGQ/01ZM) не появился в программе Mi Home в разделе BLE устройств. Добавлено.

Итак, подключение шлюза Xiaomi Gateway 3 к Home Assistant открывает перед тобой новые горизонты автоматизации. Ты превращаешь обычное устройство в мощный центр управления, который может общаться с огромным количеством датчиков и устройств из экосистемы Xiaomi и не только. Главное — пройти настройку внимательно, особенно этапы с получением ключа и выбором режима работы.

Если что-то пошло не так быстро, не пугайтесь. Многие люди сталкиваются с проблемами с этим процессом, но получить хороший результат будет стоить своего времени. Сообщество Home Assistant огромно, и форумы решают почти любую проблему.

Наконец, у вас будет умный, надежный и, что более важно, локально работающий хаб, который позволит вашим устройствам переставать зависеть от облачных серверов и реагировать мгновенно. Добро пожаловать в мир настоящей домашней автоматизации, где вы сможете управлять каждым процессом!

Поделиться с друзьями
Алексей Волков

Инженер систем автоматизации. Более 8 лет проектирую и внедряю системы умного дома для жилых и коммерческих объектов.

Оцените автора
Добавить комментарий