Homebridge installeren op Raspberry Pi en Windows: 9 stappen

2024 Auteur: John Day | [email protected]. Laatst gewijzigd: 2024-01-30 11:16

Deze tutorial is bedoeld voor mensen die Homebridge op Raspberry Pi en Windows willen installeren.

Aanvankelijk was deze tutorial hier in Brazilië in het Portugees geschreven. Ik heb mijn best gedaan om het in het Engels te schrijven. Dus vergeef me voor enkele fouten die misschien in het schrijven staan.

Deze instructie was als volgt verdeeld:

Stap 1: Wat is Homekit?

Stap 2: Wat is Homebridge?

Stap 3: Homebridge installeren op Raspberry Pi

Stap 4: Homebridge starten op Raspbian Boot

Stap 5: De Homebridge Config UI X-plug-in (Raspberry Pi) installeren

Stap 6: Homebridge installeren op Windows

Stap 7: De Homebridge Config UI X-plug-in installeren (Windows)

Stap 8: Homebridge starten met Windows

Stap 9: Homebridge koppelen aan de Woning-app

Stap 1: Wat is Homekit?

Homekit is een ontwikkelpakket van Apple waarmee ontwikkelaars Internet of Things (IoT)-oplossingen kunnen bouwen. Met dit ontwikkelpakket kunnen door Apple gebouwde apparaten (bijvoorbeeld iPhone en iPad) andere apparaten aansturen, zoals lampen of sensorinformatie. Vanaf iOS 9 en Watch OS werd Homekit een native tool en dankzij alle technologie die door Apple is geïmplementeerd, is het mogelijk om met deze kit eenvoudig automatiseringssystemen te maken.

Om Homekit-compatibele apparaten die actief zijn op het netwerk te identificeren en deze apparaten te configureren en te bedienen, moet de Home-app op elk Apple-apparaat zijn geïnstalleerd (iPhone, iPad, iPod touch, Apple Watch, Apple TV, HomePod of Mac). Apparaten die met de Home-app kunnen worden geïntegreerd, kunnen een QR-code hebben waarmee ze kunnen worden gekoppeld met de Home-app op uw Apple-apparaat.

Na het configureren van het apparaat in de Home-app, kan de gebruiker het apparaat bedienen via een snelkoppeling die wordt gemaakt op het hoofdscherm van de app of Siri (spraakassistent geleverd door Apple) gebruiken en spraakopdrachten verzenden om het apparaat te activeren.

De hardware- en softwarevereisten van Apple voor het gebruik van Homekit zijn:

- iPhone, iPad of iPod touch (met iOS 10 of hoger);

- Apple Watch (met WatchOS 3 of hoger);

- Apple TV (4e generatie);

- Apple HomePod;

- Macs (met macOS 10.14 Mojave of hoger);

Als het gaat om domotica en IoT, zijn er een aantal kosteneffectieve oplossingen op de markt, maar de overgrote meerderheid is niet door Apple gecertificeerd en is daarom niet standaard compatibel met Homekit. Als je het zat bent om te wachten tot Apple deze oplossingen certificeert voor gebruik met Homekit, moet je Homebridge gebruiken.

Stap 2: Wat is Homebridge?

Homebridge, ontwikkeld door Nick Farina, is een NodeJS-server die de Homekit API emuleert en het mogelijk maakt om niet-Apple-gecertificeerde apparaten te gebruiken met de Home-app en Siri. De server is lichtgewicht, kan op een thuisnetwerk draaien en is modulair, wat betekent dat hij meerdere plug-ins ondersteunt die zijn gemaakt en beschikbaar gesteld door een extreem actieve gemeenschap om de tool te versterken.

De plug-ins zijn geïnstalleerd op Homebridge en de meeste zijn bedoeld om Homekit compatibel te maken met elk niet-Apple-gecertificeerd apparaat. Plug-ins voor gebruik met Homebridge worden rechtstreeks vanaf de NPM-website geïnstalleerd.

Homebridge-installatie kan op verschillende systemen worden gedaan, maar voor deze instructable zal Raspberry Pi 3 Model B + met Raspbian-besturingssysteem worden gebruikt, en ik zal ook uitleggen hoe te installeren op Windows.

Stap 3: Homebridge installeren op Raspberry Pi

Idealiter zou Homebridge beschikbaar moeten zijn wanneer je het nodig hebt, dus je moet de server 24/7 laten draaien. Hiervoor kun je de server op Raspberry Pi installeren en constant op je thuisnetwerk blijven draaien.

Als je Raspbian niet op de geheugenkaart hebt geïnstalleerd en geconfigureerd, raad ik je aan de Instructable Raspbian installeren en configureren op Raspberry Pi te lezen, de onderstaande stappen te volgen en dan terug te keren om door te gaan.

Terwijl je Raspberry Pi met Raspbian draait, open je in het startscherm van het systeem de terminal:

Typ in de terminal de eerste opdracht hieronder, druk op enter en als u wordt gevraagd om de actie te bevestigen, typt u Y en drukt u op enter. Dit type bevestiging verschijnt vaak bij het verwijderen of installeren van pakketten. Typ vervolgens de tweede opdracht, voer deze in, bevestig de opdracht als daarom wordt gevraagd en wacht. Deze commando's controleren en updaten het systeem indien nodig:

sudo apt-get update

sudo apt-get upgrade

Typ het onderstaande commando in de terminal en druk op enter:

ifconfig

Sommige informatie zal worden geretourneerd. Als je een netwerkkabel gebruikt om een netwerkverbinding met je Raspberry Pi tot stand te brengen, ga dan naar het informatiegedeelte na "eth0:" en zoek naar het MAC-adres van de achtcijferige netwerkkaart. Dit zal achter het woord "ether" staan. wifi-verbinding gebruikt om een netwerkverbinding aan uw kaart toe te wijzen, ga dan naar het informatiegedeelte na "wlan0:" en zoek naar het MAC-adres van de achtcijferige netwerkkaart die ook achter het woord "ether" zal staan:

Kopieer het achtcijferige MAC-adres van uw netwerkkaart en sla het op in Kladblok, aangezien dit adres later nodig is.

Zoals ik eerder meldde, is Homebridge een NodeJS-server en worden de plug-ins ervoor rechtstreeks vanaf de NPM-site geïnstalleerd. Raspbian wordt meestal geleverd met de NodeJS- en NPM-pakketten geïnstalleerd, maar er kan incompatibiliteit zijn tussen versies van beide pakketten, dus het is het beste om beide installaties te verwijderen en vervolgens opnieuw te installeren.

Om NPM te verwijderen, typt u de onderstaande opdracht op de terminal, voert u in, bevestigt u de opdracht als daarom wordt gevraagd en wacht u tot het verwijderen van het pakket is voltooid:

sudo apt --auto-remove purge npm

Om NodeJS te verwijderen, typt u de onderstaande opdracht op de terminal, voert u in, bevestigt u de opdracht als daarom wordt gevraagd en wacht u tot het verwijderen van het pakket is voltooid:

sudo apt --auto-remove purge nodejs

Na het verwijderen van NodeJS en NPM, kunnen we doorgaan met het installeren van de bijgewerkte pakketten. Om NodeJS te installeren, typt u de onderstaande opdracht in de terminal, voert u in, bevestigt u de opdracht als daarom wordt gevraagd en wacht u tot de installatie van het pakket is voltooid:

sudo apt install nodejs

Om NPM te installeren, typt u de onderstaande opdracht in de terminal, voert u in, bevestigt u de opdracht als daarom wordt gevraagd en wacht u tot de installatie van het pakket is voltooid:

curl -L https://www.npmjs.com/install.sh | sudo sh

Typ elk van de onderstaande opdrachten en druk na elke opdracht op enter om te bevestigen dat de installatie van het pakket is gelukt. Deze opdrachten retourneren de versie van elk pakket dat zojuist is geïnstalleerd:

knoop -v

npm -v

Installeer Avahi en zijn afhankelijkheden. Voer de onderstaande opdracht in, voer in, bevestig de opdracht als daarom wordt gevraagd en wacht tot de installatie is voltooid:

sudo apt-get install libavahi-compat-libdnssd-dev

Nadat deze procedures zijn voltooid, kunnen we de Homebridge installeren. Voer de onderstaande opdracht in, voer in, bevestig de opdracht als daarom wordt gevraagd en wacht tot de installatie is voltooid:

sudo npm install -g --unsafe-perm homebridge

Typ vervolgens de onderstaande opdracht en druk op enter om Homebridge op te starten:

thuisbrug

Homebridge zal wat informatie teruggeven:

1) Het bestand config.json is niet gevonden door Homebridge. Dit bestand bevat basisinstellingen voor het uitvoeren van Homebridge en eventuele geïnstalleerde plug-ins. Later zullen we het bestand config.json en de bijbehorende instellingen maken.

2) Geen plug-in geïnstalleerd. Homebridge zonder geïnstalleerde plug-ins is volledig nutteloos.

3) Om apparaten aan de Home-app te koppelen, kun je de QR-code lezen die je de informatie geeft die je nodig hebt om te koppelen. Aangezien het config.json-bestand niet is gemaakt en geconfigureerd en er geen plug-in is geïnstalleerd, is deze QR-code momenteel niet goed, hoewel u in de Home-app Homebridge al beschikbaar kunt vinden om te koppelen, maar dat doet u niet.

4) Een andere manier om apparaten aan de Woning-app te koppelen is via de optie "Access toevoegen", "Ik heb geen code of kan niet scannen", en onder "Accessoires in de buurt" wordt het apparaat geselecteerd en wordt u vervolgens gevraagd om de instelcode. Merk op dat de terminal de achtcijferige code wordt getoond en moet worden ingevoerd om met de toepassing overeen te komen.

U kunt later de QR-code of de achtcijferige code gebruiken om Homebridge te koppelen aan de Home-app op uw Apple-apparaat.

Druk op de CTRL + C-toetsen op de terminal om Homebridge af te sluiten en het bericht "Got SIGINT, shutdown Homebridge…" zal worden geretourneerd.

Om het bestand config.json te maken, typt u de onderstaande opdracht in de terminal en drukt u op enter. Het lege bestand wordt geopend:

sudo nano ~/.homebridge/config.json

Download onderstaand bestand. Open dit bestand, kopieer de inhoud en plak in het bestand dat geopend is in de terminal:

bestand01

1) Verwijder in “gebruikersnaam” de reeks XX: XX: XX: XX: XX: XX en voer het achtcijferige MAC-adres in van de netwerkkaart die u eerder had genoteerd. De letters van het adres dat u invoert, moeten allemaal hoofdletters zijn.

2) In "pin" kunt u de acht numerieke cijfers behouden of u kunt een reeks wijzigen die u wilt, waarbij u eraan denkt hetzelfde scheidingsformaat te behouden met de streepjes. Dit is de code die je moet invoeren op het moment dat je Homebridge aan de Home-app koppelt.

De andere bestandsinformatie kunt u behouden, terwijl u plug-ins en accessoires toevoegt, kunt u de vereiste informatie invoeren.

Om de bestandsbewerkingen op te slaan, drukt u op CTRL + O, drukt u op enter en vervolgens op CTRL + X om het bestand te sluiten.

Stap 4: Homebridge starten op Raspbian Boot

Homebridge handmatig starten elke keer dat u uw Raspberry Pi inschakelt, is niet erg praktisch, dus het is het beste om de server onmiddellijk te laten draaien nadat Raspbian is gestart.

Typ het onderstaande commando in de terminal en druk op enter. Het lege bestand wordt geopend:

sudo nano /etc/default/homebridge

Download onderstaand bestand. Open dit bestand, kopieer de inhoud en plak in het bestand dat geopend is in de terminal:

bestand02

Om de bestandsbewerkingen op te slaan, drukt u op CTRL + O, drukt u op enter en vervolgens op CTRL + X om het bestand te sluiten.

Typ het onderstaande commando in de terminal en druk op enter. Het lege bestand wordt geopend:

sudo nano /etc/systemd/system/homebridge.service

Download onderstaand bestand. Open dit bestand, kopieer de inhoud en plak in het bestand dat geopend is in de terminal:

bestand03

Om de bestandsbewerkingen op te slaan, drukt u op CTRL + O, drukt u op enter en vervolgens op CTRL + X om het bestand te sluiten.

Als u een gebruiker wilt maken die de service bij het opstarten automatisch uitvoert en hem de juiste machtigingen geeft, typt u elk van de volgende opdrachten en drukt u na elke opdracht op enter:

sudo useradd --systeem homebridge

sudo mkdir /var/homebridge

sudo cp ~/.homebridge/config.json /var/homebridge/

sudo cp -r ~/.homebridge/persist /var/homebridge

sudo chmod -R 0777 /var/homebridge

sudo systemctl daemon-reload

sudo systemctl activeer homebridge

sudo systemctl start homebridge

Om het systeem opnieuw op te starten, typt u de onderstaande opdracht en drukt u op enter:

sudo reboot

Nadat het systeem opnieuw is opgestart, opent u de terminal opnieuw, typt u de onderstaande opdracht en drukt u op enter om te controleren of de service al actief is:

systemctl-status homebridge

Als alles in orde is, wordt de service uitgevoerd en ziet u de tekst "actief (actief)" en onder de achtcijferige code die eerder in config.json is ingevoerd.

Druk op de CTRL + C-toetsen op de terminal. Typ de onderstaande opdracht en druk op enter om het logboek met gelogde informatie te controleren:

journalctl -f -u homebridge

Druk op de CTRL + C-toetsen op de terminal.

Stap 5: De Homebridge Config UI X-plug-in (Raspberry Pi) installeren

Om de installatie van een plug-in op Homebridge te demonstreren, heb ik ervoor gekozen om Homebridge Config UI X te gebruiken. Deze plug-in maakt het mogelijk om via een browser Homebridge te configureren, bewaken, back-uppen en opnieuw te starten.

Om de plug-in te installeren, typt u de onderstaande opdracht in de terminal, voert u in, bevestigt u de opdracht als daarom wordt gevraagd en wacht u tot de installatie is voltooid:

sudo npm install -g --unsafe-perm homebridge-config-ui-x

Typ het onderstaande commando in de terminal en druk op enter. Er wordt een bestand geopend:

sudo nano /etc/sudoers

Gebruik de pijl naar beneden op het toetsenbord of rol met de muis, blader naar het einde van het bestand en voeg de volgende regel toe:

homebridge ALL=(ALL) NOPASSWD: ALL

Om het bestand op te slaan, drukt u op CTRL + O en vervolgens op CTRL + X om het bestand te sluiten.

Typ het onderstaande commando in de terminal en druk op enter. Er wordt een bestand geopend:

sudo nano /etc/default/homebridge

Scroll met de pijltjestoetsen naar het einde van de regel HOMEBRIDGE_OPTS=-U /var/homebridge, geef een spatie en voeg in:

-L

Om het bestand op te slaan, drukt u op CTRL + O en vervolgens op CTRL + X om het bestand te sluiten.

U moet nu config.json bewerken en de plug-in-informatie toevoegen die aan Homebridge is toegevoegd.

Als je stap 4 hebt gemaakt om Homebridge meteen te laten werken nadat Raspbian is gestart, typ je de onderstaande opdracht en druk je op enter:

sudo nano /var/homebridge/config.json

Als je Homebridge niet met Raspbian hebt gestart, typ je de onderstaande opdracht en druk je op enter:

sudo nano ~/.homebridge/config.json

De config.json wordt geopend:

Binnen de "platform"-structuur moeten alle plug-ins die op Homebridge worden geïnstalleerd, worden geïnformeerd.

Voor Homebridge Config UI X moet u het volgende codefragment toevoegen dat in het onderstaande bestand staat. Download het, open het, kopieer de inhoud en plak het in het bestand dat geopend is op de terminal:

bestand04

Ga met de pijltjestoetsen naar "platforms" en voer het codefragment in dat u uit het bestand hebt gekopieerd. In de onderstaande afbeelding kunt u zien hoe de "platforms" -structuur eruit zal zien na het toevoegen van de informatie:

Als u de structuur van uw code na het bewerken wilt valideren, gaat u gewoon naar de JSONLint-site, plakt u alle config.json-code, klikt u op "JSON valideren" en als alles in orde is, wordt het bericht "Valid JSON" geretourneerd. Als uw code een fout bevat, wordt naar de regel met de fout verwezen en wordt een bericht geretourneerd waarin de fout wordt beschreven:

jsonlint.com/

Om het bestand op te slaan, drukt u op CTRL + O en vervolgens op CTRL + X om het bestand te sluiten.

Start het systeem opnieuw op door de onderstaande opdracht te typen, druk op enter en wacht op het opnieuw opstarten:

sudo reboot

Om Homebridge Config UI X via de browser rechtstreeks in Raspberry Pi te openen, moet u het adres openen:

localhost:8080/

Als u Homebridge Config UI X in een browser wilt openen vanaf een andere computer die is aangesloten op hetzelfde netwerk als het bord, vervangt u eenvoudig het localhost-woord van het bovenstaande adres door het IP-adres van uw Raspberry Pi. Om het aan uw Raspberry Pi toegewezen IP-adres te verifiëren, gaat u gewoon naar de terminal, voert u de onderstaande opdracht in en voert u in:

ifconfig

Waarschijnlijk begint het IP-adres dat aan je Raspberry Pi is toegewezen met "192.168…".

In mijn geval is het bord IP 192.168.2.129, dus ga gewoon naar de URL onder elke computer in mijn netwerk:

192.168.2.129:8080/

Er wordt een pagina geopend die lijkt op de afbeelding hieronder en u wordt gevraagd om een gebruikersnaam en wachtwoord. Voor zowel login als wachtwoord, typ admin en enter om toegang te krijgen:

Houd er rekening mee dat op de homepage de QR-code wordt getoond en daaronder de 8-cijferige pin die kan worden gebruikt om Homebridge aan de Home-app te koppelen. In de optie "Config" van de tool hebt u toegang tot config.json, kunt u deze bewerken als dat nodig is en vervolgens opslaan.

Blader door de functies die beschikbaar zijn in Homebridge Config UI X en maak uzelf vertrouwd met de tool.

Om de uitvoering van Homebridge te stoppen, kunt u de onderstaande opdracht in de terminal gebruiken:

sudo service homebridge stop

Om Homebridge opnieuw te starten, kunt u de onderstaande opdracht gebruiken:

sudo service homebridge opnieuw opstarten

Om de uitvoering van Homebridge te starten, kunt u de onderstaande opdracht gebruiken:

sudo service homebridge start

Terwijl de server draait, gaat u naar stap 9 om Homebridge te blijven koppelen met de Home-app op uw Apple-apparaat.

Stap 6: Homebridge installeren op Windows

Als u geen Raspberry Pi of ander geïntegreerd platform heeft waarop Homebridge kan worden uitgevoerd, kunt u uw server op Windows laten draaien.

U moet NodeJS en een alternatieve teksteditor voor Windows Kladblok installeren.

Download NodeJS via een van de onderstaande links en installeer het vervolgens:

nodejs.org/en/download/

Vink tijdens de installatie het selectievakje aan waarmee u automatisch de benodigde tools kunt installeren:

NodeJS is geen grafisch interfaceprogramma, dus alle acties worden erop uitgevoerd vanaf een opdrachtprompt.

Download Notepad ++ via een van de onderstaande links en installeer het vervolgens:

notepad-plus-plus.org/downloads/

Wanneer u met de rechtermuisknop op een bestand klikt, verschijnt in het Windows-optiemenu de optie "Bewerken met Kladblok ++" en u kunt deze optie selecteren wanneer u een tekstbestand of Homebridge-bestand moet bewerken.

Ga naar het Windows "Start"-menu, typ en zoek naar "Instellingen" en open de optie wanneer u deze hebt gevonden. Klik op "Netwerk en internet" en klik vervolgens op "Netwerkcentrum". Klik onder "Toegangstype" op uw actieve verbinding, klik op "Details" en kopieer het achtcijferige MAC-adres voor uw netwerkkaart en sla het op in Kladblok, aangezien dit adres later nodig is:

Typ en zoek in het Windows "Start"-menu naar "cmd" (opdrachtprompt) en wanneer u het vindt, klikt u er met de rechtermuisknop op en selecteert u "Als administrator uitvoeren":

Typ elk van de onderstaande opdrachten terwijl de terminal is geopend en druk na elke opdracht op enter om te bevestigen dat de installatie van NodeJS / NPM is gelukt. Deze opdrachten retourneren de versie van elk van de pakketten die zijn geïnstalleerd:

knoop -v

npm -v

Nadat deze procedures zijn voltooid, kunnen we de Homebridge installeren. Voer de onderstaande opdracht in, voer in en wacht tot de installatie is voltooid:

npm install -g --unsafe-perm homebridge

Typ vervolgens de onderstaande opdracht en druk op enter om Homebridge op te starten:

thuisbrug

Homebridge zal wat informatie teruggeven:

1) Het bestand config.json is niet gevonden door Homebridge. Dit bestand bevat basisinstellingen voor het uitvoeren van Homebridge en eventuele geïnstalleerde plug-ins. Later zullen we het bestand config.json en de bijbehorende instellingen maken.

2) Geen plug-in geïnstalleerd. Homebridge zonder geïnstalleerde plug-ins is volledig nutteloos.

3) Om apparaten aan de Home-app te koppelen, kun je de QR-code lezen die je de informatie geeft die je nodig hebt om te koppelen. Aangezien het config.json-bestand niet is gemaakt en geconfigureerd en er geen plug-in is geïnstalleerd, is deze QR-code momenteel niet goed, hoewel u in de Home-app Homebridge al beschikbaar kunt vinden om te koppelen, maar dat is niet het geval.

4) Een andere manier om apparaten aan de Woning-app te koppelen is via de optie "Access toevoegen", "Ik heb geen code of kan niet scannen", en onder "Accessoires in de buurt" wordt het apparaat geselecteerd en wordt u vervolgens gevraagd om de instelcode. Merk op dat de terminal de achtcijferige code wordt getoond en moet worden ingevoerd om overeen te komen met de toepassing.

Druk op de CTRL + C-toetsen op de terminal om Homebridge te sluiten. Het bericht "Got SIGINT, shutdown Homebridge …" wordt geretourneerd en u wordt om bevestiging gevraagd, waarbij u de letter Y moet typen en op enter moet drukken.

Om het config.json-bestand aan te maken, opent u Notepad ++, klikt u op het menu "Bestand", "Nieuw" en een nieuw venster wordt geopend. Klik op het menu "Taal", blader naar de letter J in de lijst en selecteer "JSON".

Download onderstaand bestand. Open dit bestand, kopieer de inhoud en plak het in het bestand dat geopend is in Kladblok ++:

bestand05

1) Verwijder in “gebruikersnaam” de reeks XX: XX: XX: XX: XX: XX en voer het achtcijferige MAC-adres in van de netwerkkaart die u eerder had genoteerd. De letters van het adres dat u invoert, moeten allemaal hoofdletters zijn.

2) In "pin" kunt u de acht numerieke cijfers behouden of u kunt een reeks wijzigen die u wilt, waarbij u eraan denkt hetzelfde scheidingsformaat te behouden met de streepjes. Dit is de code die je moet invoeren op het moment dat je Homebridge aan de Home-app koppelt.

De andere bestandsinformatie kunt u behouden, terwijl u plug-ins en accessoires toevoegt, kunt u de vereiste informatie invoeren.

Klik op het menu "Bestand", "Opslaan", noem het bestand config.json en sla het op in het pad "C:\Users\YOUR NAME OR DOCUMENTS\.homebridge":

Sluit Kladblok ++.

Stap 7: De Homebridge Config UI X-plug-in installeren (Windows)

Om de installatie van een plug-in op Homebridge te demonstreren, heb ik ervoor gekozen om Homebridge Config UI X te gebruiken. Deze plug-in maakt het mogelijk om via een browser Homebridge te configureren, bewaken, back-uppen en opnieuw te starten.

Om de plug-in te installeren, typt u de onderstaande opdracht in de terminal, drukt u op enter en wacht u tot de installatie is voltooid:

npm install -g --unsafe-perm homebridge-config-ui-x

OPMERKING: Als u tijdens de installatie van de plug-in een fout aantreft met de termen MSBUILD / VCBuild.exe, voert u gewoon elk van de volgende opdrachten afzonderlijk uit en probeert u vervolgens opnieuw te installeren vanaf de bovenstaande opdracht:

npm install -g node-gyp

npm install --global --production windows-build-tools

npm install --global --production windows-build-tools --vs2015

U moet nu config.json bewerken en de plug-in-informatie invoeren die aan Homebridge is toegevoegd. Ga naar het pad “C:\Users\YOUR NAME OR DOCUMENTS\.homebridge” en open via Notepad++ config.json dat eerder is aangemaakt:

Binnen de "platform"-structuur moeten alle plug-ins die op Homebridge worden geïnstalleerd, worden geïnformeerd.

Voor Homebridge Config UI X moet u het volgende codefragment toevoegen dat in het onderstaande bestand staat. Download, open, kopieer de inhoud en plak deze in het bestand dat geopend is in Kladblok ++:

bestand06

Ga naar "platforms" en voer het codefragment in dat u uit het bestand hebt gekopieerd. In de onderstaande afbeelding kunt u zien hoe de "platforms" -structuur eruit zal zien na het toevoegen van de informatie:

Als u de structuur van uw code na het bewerken wilt valideren, gaat u gewoon naar de JSONLint-site, plakt u alle config.json-code, klikt u op "JSON valideren" en als alles in orde is, wordt het bericht "Valid JSON" geretourneerd. Als uw code een fout bevat, wordt naar de regel met de fout verwezen en wordt een bericht geretourneerd waarin de fout wordt beschreven:

jsonlint.com/

Sla het bestand op, sluit Kladblok ++ en start Windows opnieuw.

Om Homebridge Config UI X via de browser te openen, gaat u naar:

localhost:8080/

Er wordt een pagina geopend die lijkt op de afbeelding hieronder en u wordt gevraagd om een gebruikersnaam en wachtwoord. Voor zowel login als wachtwoord, typ admin en enter om toegang te krijgen:

Houd er rekening mee dat op de homepage de QR-code wordt getoond en daaronder de 8-cijferige pin die kan worden gebruikt om Homebridge aan de Home-app te koppelen. In de optie "Config" van de tool hebt u toegang tot config.json, kunt u deze bewerken als dat nodig is en vervolgens opslaan.

Blader door de functies die beschikbaar zijn in Homebridge Config UI X en maak uzelf vertrouwd met de tool.

Stap 8: Homebridge starten met Windows

Homebridge Config UI X biedt een opdracht die kan worden gebruikt om Homebridge als een service te configureren, zodat de server samen met Windows kan worden opgestart. Typ de onderstaande opdracht bij de prompt, voer deze in en wacht tot de installatie is voltooid:

hb-service installeren

OPMERKING: Als uw Windows-firewall toestemming vraagt om toegang te krijgen tot het privénetwerk, verleen deze dan

Nadat de installatie is voltooid, sluit u de opdrachtprompt en start u Windows opnieuw.

Nadat het systeem is opgestart, drukt u op CTRL + ALT + DEL om Windows Taakbeheer te openen. Ga naar het tabblad "Services", zoek naar Homebridge in de lijst en kijk of "Status" op "Running" staat:

Als u met de rechtermuisknop op de Homebridge-service klikt, worden de opties geopend waar u de service kunt stoppen, opnieuw kunt starten en als de service is gestopt, kunt u beginnen:

Als u Homebridge van het opstarten van Windows wilt verwijderen, voert u eenvoudig de onderstaande opdracht in, voert u deze in en wacht u tot de verwijdering is voltooid:

hb-service verwijderen

OPMERKING: Afhankelijk van de antivirus die u gebruikt, kunt u Homebridge moeilijk vinden vanaf uw mobiele apparaat. Voor testdoeleinden, wanneer het tijd is om Homebridge aan de Home-app te koppelen, als de server niet binnen twee minuten wordt gevonden, schakel dan uw antivirus uit, schakel Windows Defender uit, start de Homebridge-service opnieuw via Windows Taakbeheer en probeer opnieuw om de server te vinden vanuit de Woning-app

Stap 9: Homebridge koppelen aan de Home-app

De volgende richtlijnen zijn geldig voor zowel Homebridge op Raspberry Pi als Windows. Zorg ervoor dat de server actief is, want de Home-app vindt Homebridge alleen als deze online is.

Ik heb een iPhone 8 Plus gebruikt voor dit bericht, dus vanaf hier zijn de stappen gebaseerd op iOS. Voor andere Apple Homekit-compatibele apparaten raad ik u aan de menu's te controleren op de volgende opties.

Ga naar het startscherm van je iPhone en zoek de Home-app in de apps. Als je het niet kunt vinden, ga dan naar de App Store en installeer de app:

Klik met de Home-app open op "Accessoire toevoegen":

Klik in het geopende scherm op "Ik heb geen code of kan niet scannen?":

Bij “Accessoires in de buurt” zie je de Homebridge. Klik erop om het koppelingsscherm te openen:

Er wordt een bericht geopend en u moet op "Toch toevoegen" klikken:

U wordt gevraagd om de "Homebridge Setup Code". Vul de code (PIN) in die je in config.json hebt ingesteld en wacht:

Als alles goed gaat krijg je een scherm te zien waarin staat dat Homebridge is toegevoegd en klaar is voor gebruik:

OPMERKING: Als u een bericht ontvangt waarin staat dat de code niet is geaccepteerd of niet kan worden toegevoegd, sluit u de Home-app, start u Homebridge opnieuw en probeert u de stappen opnieuw

Op het volgende scherm ziet u het bericht "Additional Setup Required" omdat er nog geen Homebridge-apparaat is. Klik op GEREED en de app keert terug naar het startscherm:

Klik op het startscherm op een huissymbool, klik in het volgende scherm op "Hubs & Bridges", klik op de nieuw toegevoegde Homebridge en u ziet wat informatie, en ALS u later de Homebridge-link moet verwijderen, klikt u gewoon op " Bridge uit huis verwijderen”:

Als u Homebridge uit de Home-app verwijdert en deze opnieuw wilt toevoegen, moet u de mappen "accessoires" en "persistent" van de server verwijderen.

In Raspberry Pi:

Beëindig Homebridge door de onderstaande opdracht in de terminal te typen en op enter te drukken:

sudo service homebridge stop

Als je stap 4 hebt gemaakt om Homebridge meteen te laten werken nadat Raspbian is gestart, typ je de onderstaande opdracht en druk je op enter:

cd /var/homebridge

Als je Homebridge niet met Raspbian hebt gestart, typ je de onderstaande opdracht en druk je op enter:

cd.homebridge/

Typ elk van de onderstaande opdrachten en druk na elke opdracht op enter om de mappen "accessoires" en "persistent" te verwijderen:

sudo rm -r persist/

sudo rm -r accessoires/

Digite o comando abaixo no terminal e dê enter para iniciar o Homebridge:

sudo service homebridge start

Voer de stappen opnieuw uit om Homebridge aan de Home-app te koppelen.

Op Windows:

Stop de Homebridge-service via Windows Taakbeheer, ga naar het pad "C:\Users\UW NAAM OF DOCUMENTEN\.homebridge", en verwijder de mappen "accessoires" en "persistent". Start de Homebridge-service via Windows Taakbeheer.

Voer de stappen opnieuw uit om Homebridge aan de Home-app te koppelen.

Het is belangrijk op te merken dat elk apparaat dat in de Home-app is ingebouwd, lokaal wordt gevoed. Om Home-app-apparaten te kunnen bedienen via een extern netwerk (bijvoorbeeld 3G / 4G-verbinding), moet u een automatiseringshub instellen vanaf een van de volgende Apple-apparaten: iPad (met iOS 10 of hoger), Apple TV (4e generatie) of HomePod. Op deze manier kunt u zelfs buitenshuis uw automatisering en IoT-apparaten die zijn geïntegreerd met de Home-app op afstand bedienen via Homebridge of Homekit.

Door Homebridge te koppelen aan de Completed Home-app kun je de functies van deze geweldige tool verkennen. In de onderstaande link ziet u de lijst met plug-ins die beschikbaar zijn voor gebruik met Homebridge en door op elke plug-in te klikken, kunt u hun informatie zien en hoe u ze kunt installeren:

www.npmjs.com/search?q=homebridge-plugin

Als je een IoT- of domotica-apparaat hebt en dit wilt integreren met Homebridge, zoek dan gewoon of er al een plug-in is gemaakt waarmee je dit apparaat in de Home-app kunt gebruiken.

Aangezien de rootgebruiker niet is ingeschakeld op Raspbian, moet u er voor plug-insinstallaties altijd aan denken om het woord sudo te gebruiken vóór de terminal install-opdracht. Als u sudo niet gebruikt, zal het systeem u altijd vragen om het systeemwachtwoord in te voeren om de actie uit te voeren of u kunt een bericht retourneren waarin staat dat u geen toestemming hebt.

In Windows moet de opdrachtprompt worden uitgevoerd als beheerder om de opdrachtregels te kunnen uitvoeren, en u moet het woord sudo niet gebruiken omdat het niet door het systeem wordt herkend.

Telkens wanneer u een plug-in installeert, moet u de informatie ervan toevoegen in config.json en Homebridge herstarten zodat de Home-app kan worden bijgewerkt met de informatie van de toegevoegde plug-ins. Evenzo, wanneer u een Homebridge-plug-in verwijdert, moet u ervoor zorgen dat u de config.json-informatie van de plug-in verwijdert, alsof u de server niet verwijdert, u mogelijk opstartproblemen hebt.

Hieronder staan enkele links die nuttig kunnen zijn bij het vinden van meer informatie over Homebridge en Homekit:

homebridge.io/

github.com/nfarina/homebridge

support.apple.com/pt-br/HT204893

Als je Sonoff-apparaten hebt en deze wilt gebruiken met de Home-app en Siri, raad ik je aan de instructieve Integrate Sonoff With Home-app (Apple IPhone IOS) te lezen.