Как подключить любые гаджеты в умный дом Apple HomeKit через Raspberry Pi
Продолжаем строить умный дом вместе.
После того, как мы создали специальный хаб HomeBridge на основе компьютера Raspberry Pi, пришло время подключать умные устройства с его помощью к HomeKit.
Для начала потребуется произвести еще несколько манипуляций с нашим мостом, чтобы потом можно было легко решать возникающие проблемы.
Как настроить SSH на Raspberry Pi
SSH — это сетевой протокол для удаленного управления системой. С его помощью больше не потребуется подключать наш хаб к монитору или телевизору для внесения изменений или конфигурации ПО.
Не пренебрегайте данным шагом, ведь в процессе дальнейшей настройки вы неоднократно столкнетесь с неработоспособностью плагинов, неверно составленным файлом конфигурации, другими сбоями и проблемами, которые удобнее решать удаленно.
1. На Raspberry Pi необходимо перейти в консоль и ввести команду:
sudo raspi-config
2. В открывшемся меню конфигурации следует перейти в раздел Advanced Options.
3. Находим пункт SSH и активируем его.
4. Проверить успешную активацию протокола можно следующей командой в терминале:
sudo service ssh status
5. Для доступа по SSH используются такие учетные данные:
логин: pi
пароль: raspberry
6. В настройках Raspberry можно изменить эти данные.
Как подключиться по SSH
После того, как SSH подключение настроено, к «малинке» можно подключаться с других устройств внутри локальной сети. Монитор и клавиатура для Rasperry больше не потребуется.
Нужно лишь узнать IP-адрес устройства в сети. Сделать это можно из графического интерфейса микрокомпьютера, через приложение своего роутера, его веб-интерфейс или любым другим доступным способом.
Для получения доступа по SSH на Windows делаем следующее:
1. Устанавливаем приложение PuTTY.
2. В приложении на вкладке Session указываем IP-адрес Raspberry и порт 22.
3. Подключаемся, используя установленный логин и пароль для авторизации.
Для получения доступа по SSH на macOS делаем следующее:
1. Запускаем приложение Терминал.
2. Вводим команду (используя IP-адрес своей «малинки»):
ssh [email protected]
3. Подтверждаем желание подключиться и вводим установленный пароль.
Для получения доступа по SSH на iOS делаем следующее:
1. Устанавливаем приложение Termius — SSH client из App Store.
2. Создаем новое подключение, указывая IP-адрес, порт, логин и пароль.
3. Подключаемся по настроенному соединению.
Теперь можно удаленно посылать команды «малинке», перезагружать её и менять файл конфигурации HomeBridge.
Запоминаем нужные команды:
sudo reboot— для перезагрузки Raspberry (SSH-соединение будет прервано)sudo -n systemctl restart homebridge— для перезапуска сервера HomeBridgenano ~/.homebridge/config.json— для открытия файла конфигурации HomeBridge
Как подключить умные устройства
Для работы умного девайса с 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. Не забывайте периодически сохранять удачные версии конфигурации.
