Homebridge na Raspberry Pi
Urządzenia Smart Home bez certyfikatu HomeKit można nadal integrować z HomeKit za pomocą Homebridge. Pokazujemy, jak zainstalować Homebridge na Raspberry Pi.
12 minut czasu czytania | 11 maj 2022
W skrócie: Homebridge na Raspberry Pi
- Za pośrednictwem Homebridge można zintegrować z HomeKit liczne urządzenia Smart Home
- Po prostu zainstaluj Homebridge na Raspberry Pi
- Połącz się z urządzeniami inteligentnymi za pomocą wtyczek
- Połącz urządzenia Smart Home Hama z Homebridge za pośrednictwem platformy Tuya IoT
- W razie potrzeby podłącz inne produkty Smart Home
-
Czym jest Homebridge?
Homebridge to oprogramowanie dla inteligentnego domu łączące inteligentne urządzenia z HomeKit bez oficjalnej certyfikacji HomeKit. W ten sposób za pośrednictwem aplikacji Apple Home możesz sterować i automatyzować wiele inteligentnych urządzeń różnych producentów.
-
Co mogę podłączyć do Homebridge?
Za pomocą Homebridge do HomeKit możesz podłączyć szeroką gamę urządzeń Smart Home. Wtyczki zaprogramowane przez społeczność Homebridge nawiązują połączenie, możesz więc połączyć z Homebridge wiele różnych urządzeń: od gniazdek WiFi przez oczyszczacze powietrza i inteligentne oświetlenie aż po wallboxy dla samochodów elektrycznych.
-
Gdzie mogę zainstalować Homebridge?
Możesz zainstalować Homebridge na Raspberry Pi. Oprogramowanie jest również dostępne dla dystrybucji Linux, macOS, Windows i Docker na Synology DSM, QNAP i Unraid.
-
Gdzie znajduje się plik konfiguracyjny (config.json) Homebridge?
Plik konfiguracyjny Homebridge (config.json) znajdziesz w odpowiednim katalogu Homebridge. Jeśli zainstalowałeś Homebridge na Raspberry Pi, ścieżka to: /var/lib/homebridge/config.json Możesz wyświetlić plik w zakładce Config w interfejsie internetowym.
-
Czy można również używać urządzeń Smart Home Hama w Apple Home (HomeKit)?
Tak, w Apple Home (HomeKit) możesz także używać urządzeń Smart Home firmy Hama. Możesz to zrobić za pomocą oprogramowania Homebridge i wtyczki Homebridge Tuya. Nasze instrukcje pokazują dokładnie, jak działa to połączenie.
Czym jest Homebridge?
Homebridge to oprogramowanie dla Smart Home. Może być ono zainstalowane na przykład na Raspberry Pi i działa stale w tle. Twoje zadanie jest sprytne i proste: Homebridge sprawia, że urządzenia Smart Home są kompatybilne z Apple HomeKit.
Jeśli zainstalujesz Homebridge na Raspberry Pi, dostępne będą tak zwane wtyczki, których możesz używać do sterowania i automatyzacji urządzeń Smart Home za pośrednictwem HomeKit, które nie są oficjalnie certyfikowane przez Apple dla HomeKit. Za pośrednictwem HomeKit można zatem używać również urządzeć z innymi standardami Smart Home.
Jak sama nazwa wskazuje, Homebridge stanowi pomost między Apple HomeKit a innymi urządzeniami Smart Home. Homebridge może być również używany, na przykład, do łączenia inteligentnych urządzeń Hama z platformą Smart Home Apple i sterowania nimi.

Instalacja Homebridge: Instrukcja
Używasz HomeKit i chcesz zintegrować produkty Smart Home bez natywnej obsługi HomeKit? W takim razie wszystko, co musisz zrobić, to zainstalować Homebridge na Raspberry Pi. Załóż „świeże” Raspberry Pi, na którym nie jest zainstalowane żadne oprogramowanie. I postępuj w następujący sposób.
-
Krok 1: Uruchom Raspberry Pi Imager
Najłatwiejszym sposobem zainstalowania Homebridge na Raspberry Pi jest użycie narzędzia o nazwie Raspberry Pi Imager. Pobierz program na swój komputer, włóż kartę pamięci microSD Twojego Raspberry Pis do czytnika kart Twojego komputera i uruchom Raspberry Pi Imager.
-
Krok 2: Wybierz system operacyjny
Klikając Choose OS, możesz wybrać system operacyjny, który chcesz zainstalować. W wygodny sposób możesz wybrać Homebridge bezpośrednio tutaj. Znajdziesz go w polu Other specific purpose OS > Home assistants and home automation > Homebridge. Ewentualnie wybierz najnowszą wersję Homebridge.
-
Krok 3: Wybierz kartę pamięci
Użyj środkowego przycisku Choose Storage, aby wybrać teraz kartę pamięci, na której chcesz zainstalować Homebridge. Pamiętaj, aby nie pozostawiać na niej żadnych ważnych danych. W następnym kroku wszystkie dane na karcie pamięci zostaną z niej bowiem usunięte.
-
Krok 4: Zainstaluj Homebridge na Raspberry Pi
Po wybraniu karty pamięci kliknij Write, aby sflashować obraz Homebridge na kartę pamięci. Proces ten trwa kilka minut. Dokładny czas potrzebny na przygotowanie Homebridge do użycia na Raspberry Pi zależy od szybkości pobierania oraz szybkości zapisu na karcie pamięci.
-
Krok 5: Skonfiguruj połączenie sieciowe
Teraz połącz Raspberry Pi z routerem. Najlepiej wybierz w tym celu połączenie za pomocą kabla sieciowego. Po podłączeniu kabla między Raspberry Pi a routerem podłącz zasilacz do Raspberry Pi.
Jeśli chcesz podłączyć Raspberry Pi z Homebridge do swojej sieci przez WiFi, najpierw upewnij się, że Pi nie jest podłączone za pomocą kabla sieciowego. Następnie uruchom urządzenie i odczekaj kilka minut. Teraz użyj telefonu, aby wyszukać sieci WiFi w zasięgu. Połącz się z WiFi Homebridge WiFi Setup. Następnie możesz wprowadzić dane dostępu do domowej sieci WiFi, aby Pi mogło łączyć się bezprzewodowo.
-
Krok 6: Otwórz Homebridge na Raspberry Pi.
Teraz instalacja Homebridge jest ukończona. Otwórz przeglądarkę na swoim komputerze i wpisz http://homebridge.local w polu adresu. Alternatywnie możesz również użyć lokalnego adresu IP swojego Raspberry Pi. Znajdziesz go, logując się do routera i przeglądając listę połączonych urządzeń.
-
Krok 7: Ustaw nazwę użytkownika i hasło
Homebridge powita Cię kreatorem konfiguracji. Tam utwórz konto użytkownika z nazwą użytkownika i hasłem i przeprowadź wstępną konfigurację.
-
Krok 8: Połącz HomeKit z Homebridge
Teraz weź urządzenie z systemem iOS i otwórz aplikację Home, aby połączyć Homebridge z HomeKit. Dodaj nowe urządzenie za pomocą znaku plus, a następnie zeskanuj kod QR, który Homebridge wyświetla w przeglądarce. Po wyświetleniu powiadomienia, że Homebridge na Raspberry Pi jest urządzeniem bez certyfikatu, wybierz Dodaj mimo to.
Jeśli pojawi się również komunikat, że konieczne są dalsze ustawienia, nie ma problemu, ponieważ w Homebridge na Twoim Raspberry Pi nie skonfigurowano jeszcze żadnych integracji. Dodaj Homebridge do pomieszczenia i nadaj nowemu urządzeniu wybraną nazwę przed zakończeniem konfiguracji.
Instalacja i konfiguracja wtyczek Homebridge
W razie potrzeby możesz zainstalować wtyczki Homebridge. W tym celu przejdź do http://homebridge.local za pomocą przeglądarki na swoim komputerze, zaloguj się i przejdź do zakładki Plugins. Wprowadź tam nazwę producenta urządzenia, które chcesz połączyć z HomeKit przez Homebridge na swoim Raspberry Pi. Jeśli urządzenie jest obsługiwane, w rezultacie automatycznie pojawi się odpowiednia wtyczka Homebridge. Możesz zainstalować ją jednym kliknięciem, a następnie skonfigurować.

Wiele wtyczek Homebridge można teraz skonfigurować za pomocą interfejsu użytkownika jednym kliknięciem myszy. Inne musisz skonfigurować manualnie za pomocą Homebridge Config. W takim przypadku przejdź do zakładki Config, otwórz plik config.json i rozpocznij konfigurację. Homebridge automatycznie sprawdza zmiany w konfiguracji i ostrzega o wszelkich błędach przed zapisaniem.
Po zainstalowaniu i skonfigurowaniu wtyczki uruchom ponownie Homebridge na swoim Raspberry Pi, używając przycisku restartu w prawym górnym rogu. Takie ponowne uruchomienie jest wymagane przy każdej zmianie ustawień.
Zintegruj urządzenia Hama
Urządzenia Smart Home marki Hama można również zintegrować z HomeKit na Raspberry Pi za pomocą wtyczki w Homebridge. Można to zrobić za pomocą platformy IoT Tuya. W tym celu w pierwszej kolejności potrzebujesz konta Tuya, które musisz jednorazowo połączyć z Homebridge. Procedura jest prawie identyczna jak w przypadku instalacji Home Assistant na Raspberry Pi. Z naszymi instrukcjami poprowadzimy Cię krok po kroku do celu.
Podłącz urządzenia Hama do Tuya
-
Krok 1: Skonfiguruj urządzenia w aplikacji SmartLife
Jeśli jeszcze nie uruchomiłeś żadnych urządzeń Smart Home Hama, w pierwszym kroku zacznij od nich. Zainstaluj aplikację Tuya SmartLife (Android i iOS) na swoim smartfonie i użyj jej do skonfigurowania inteligentnego urządzenia domowego.
Jeśli korzystałeś już z urządzenia z aplikacją Smart Home Hama, zostanie ono usunięte z aplikacji Smart Home Hama po skonfigurowaniu w aplikacji SmartLife i nie będzie już dostępne za jej pośrednictwem.
-
Krok 2: Zarejestruj się w Tuya
Utwórz teraz darmowe konto Tuya na https://iot.tuya.com. Jeśli masz już konto Tuya, zaloguj się za pomocą swoich danych logowania.
-
Krok 3: Stwórz projekt Smart Home dla Homebridge
Teraz kliknij naCloud > Development, a następnie kliknij Create Cloud Project, aby utworzyć nowy projekt Tuya dla Homebridge na swoim Raspberry Pi. Przypisz nazwę projektu, na przykład Połączenie HomeKit, wybierz Development Method Smart Home w polu i Data Center wpis Central Europe Data Centrum.
Następnie kliknij Create i w następnym kroku zdefiniuj interfejs. Do Homebridge wymagany jest tylko interfejs (API) Device status notification. Wybierz go i na koniec kliknij Authorize.
-
Krok 4: Zintegruj urządzenia Hama
Teraz przejdź do zakładki Devices i przejdź do Link Tuya App Account. Tam kliknij Add App Account, po czym ujrzysz kod QR. Teraz weź swój smartfon i otwórz aplikację Tuya SmartLife. Dodaj nowe urządzenie i zeskanuj kod QR w przeglądarce za pomocą aplikacji Tuya SmartLife.
W przeglądarce otworzy się nowe okno. Tam wybierz elementy Automatic Link (recommended) i Read, write, and Manage. Kliknij OK, aby potwierdzić swój wybór.
Gotowe. Twoje urządzenia Smart Home Hama, które już skonfigurowałeś w aplikacji Tuya SmartLife, są teraz wyświetlane w zakładce All Devices.
-
Krok 5: Skopiuj klucz autoryzacyjny
Aby połączyć Tuya z Homebridge na swoim Raspberry Pi, potrzebujesz klucza autoryzacji, który składa się z Access ID i Access Secret. Oba klucze można znaleźć w Tuya w polu Project Overview. Skopiuj wartości, aby wkleić je bezpośrednio do Homebridge na swoim Raspberry Pi.
Łączenie Tuya z Homebridge
Instalację i konfigurację wtyczki Tuya możesz łatwo przeprowadzić za pośrednictwem interfejsu internetowego. W tym celu otwórz przeglądarkę, zaloguj się do Homebridge na swoim Raspberry Pi, a następnie przejdź do naszej instrukcji.
-
Krok 1: Zainstaluj wtyczkę Tuya Homebridge na Raspberry Pi
Przejdź do Plugins w górnym menu i wyszukaj Tuya. Prawidłowa wtyczka to Homebridge Tuya Platform. Kliknij Install na jego kafelku. Proces ten może potrwać kilka minut.
-
Krok 2: Dostosuj konfigurację Homebridge
Po pomyślnej instalacji w Homebridge na Twoim Raspberry Pi pojawi się nowe okno. Tam dokonujesz konfiguracji w następujący sposób:
Username: Twoja nazwa użytkownika aplikacji Tuya SmartLife
Password: Twoje hasło do aplikacji Tuya SmartLifeAccess-ID: Identyfikator dostępu do Twojego projektu Tuya Cloud
Access-Key: Klucz dostępu do Twojego projektu Tuya CloudLanguage Code: DE dla niemieckiego lub EN dla angielskiego
Project Type: PaaS
PaaS Platform: Smart LifeCountry Code: 49 dla Niemiec
Gotowe. Zapisz i zamknij plik konfiguracyjny.
-
Krok 3: Zrestartuj Homebridge na Raspberry Pi
Kliknij ikonę zasilania w prawym górnym rogu, aby ponownie uruchomić Homebridge na swoim Raspberry Pi i uruchomić wtyczkę Tuya. Jeśli wszystko zadziałało prawidłowo, zobaczysz wszystkie urządzenia Smart Home, które skonfigurowałeś za pomocą aplikacji Tuya SmartLife w pozycji menu Accessories w Homebridge.
Alexa, Home Assistant, Fritzbox
Homebridge zapewnia również pomost do wielu innych produktów i usług. Na przykład możesz połączyć ze sobą Homebridge i Alexę. Umożliwia to sterowanie urządzeniami HomeKit za pomocą poleceń głosowych wysyłanych do asystentów głosowych Amazon. Kolejna wtyczka łączy Homebridge z Twoim Fritzbox. Z jednej strony możesz kontrolować gościnną sieć WiFi za pośrednictwem HomeKit, z drugiej strony natomiast możesz także zintegrować urządzenia Smart Home AVM z HomeKit.
Od pewnego czasu powszechną metodą dla użytkowników Home Assistant jest również łączenie Home Assistant z Homebridge w celu połączenia platformy Apple z Home Assistant. W międzyczasie jednak Home Assistant sam opanował tę funkcję, dzięki czemu nie jesteś w takim przypadku zależny od Homebridge. W naszym przewodniku pokazujemy, jak zainstalować Home Assistant na Raspberry Pi.