Как подключить любые гаджеты к системе умный дом Apple HomeKit через Raspberry Pi

Продолжаем строить умный дом вместе.

После того, как мы создали специальный хаб HomeBridge на основе компьютера Raspberry Pi, пришло время подключать умные устройства с его помощью к HomeKit.

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

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

Для работы умного девайса с HomeKit через мост в виде HomeBridge требуется две вещи:
  • установленный плагин
  • данные об устройстве в файле конфигурации
Искать плагин можно самостоятельно. На просторах GitHub можно найти файлы практически для любого умного устройства.

Или впишите в Google: mi air purifier 2 homebridge (для очистителя воздуха Xiaomi Mi Air Purifier 2) и по одной из первых ссылок найдете нужный плагин.

Альтернативным способом поиска плагинов является специальный раздел в веб-интерфейсе HomeBridge. Если устанавливали систему по инструкции, веб-интерфейс уже должен работать.
На специальной вкладке Плагины можно осуществить поиск нужного дополнения, аналогично поиску в Google. Вписываем название девайса (с китайскими гаджетами от всевозможных суб-брендов придется повозиться) и выбираем один из предложенных плагинов.

Установка нужного плагина:



На GitHub странице плагина или на другом сайте, где было найдено дополнение, первым делом описывается процесс установки.

Для установки непосредственно на Raspberry Pi или через SSH используется приведенная в описании плагина команда такого вида:

sudo npm install -g homebridge-mi-acpartner


Для установки через веб-интерфейс достаточно нажать кнопку Install возле найденного в поиске дополнения.

Изменение файла конфигурации:



Файл конфигурации тоже может быть изменен на самом устройстве с сервисом HomeBridge, через SSH или через веб-интерфейс. В первом случае редактируем файл config.json командой nano ~/.homebridge/config.json, а во втором переходим в визуальный редактор на вкладке веб-интерфейс.

На странице с описанием плагина находим пример конфигурации:

"platforms": [{
"platform": "XiaoMiAcPartner",
"devices":{
"192.168.31.120":"your_token_here"
}]

Нужно интегрировать данный код в уже имеющуюся конфигурацию.

В большинстве случаев плагины интегрируются в разделы “platforms” или “accessories”. Особо сложные дополнения могут иметь части кода в обоих разделах.

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

Заполнение параметров устройства:



Обратите внимание, что в большинстве случаев требуется указать два параметра подключаемого девайса: IP-адрес и токен. С поиском адреса в домашней сети проблем не возникнет (ищите через приложение роутера или его веб-интерфейс), а вот с токеном не так все просто.

Уникальный идентификатор умных устройств можно получить разными способами. Самый простой – воспользоваться модифицированным приложением Mi Home на Android. Если смартфона или планшета с нужной ОС на руках нет – устанавливаем эмулятор Android

1. Устанавливаем на Android модифицированное приложение Mi Home.
2. Авторизуемся в своей учетной записи с указанием правильного региона (в большинстве случаев это Материковый Китай).
3. Находим нужный девайс и в разделе Настройки – Общие параметры – Информация о сети видим поле с нужным нам токеном.



Здесь же можно найти IP-адрес.
Для устройств других производителей придется использовать другие способы добычи токенов.



Теперь можно заполнить данные девайса в конфигурации, сохранить файл и перезагрузить HomeBridge.

Если все было сделано верно, устройство появится в приложении Дом на iPhone и им можно будет управлять, как нативным девайсом с поддержкой HomeKit.

Проблемы и их решение:

Если файл конфигурации был изменен с ошибками, то HomeBridge повторно не запустится. Об этом вы поймете по зависшему веб-интерфейсу или по «отвалившимся» устройствам в приложении Дом.

Не стоит паниковать! Порядок действий следующий:

1. Подключаемся к Raspberry Pi по SSH.
2. Открываем файл config.json для редактирования.
3. Пытаемся найти ошибку или просто удаляем последний внесенный блок кода.
4. Сохраняем файл (Comman+X при работе в терминале или по SSH).
5. Перезапускаем HomeBridge командой: sudo -n systemctl restart homebridge.

Вот так происходит добавление всех умных устройств в HomeKit через HomeBridge. Не забывайте периодически сохранять удачные версии конфигурации.