Hoe u NetRelay instelt met Home Assistant
NetRelay kan worden gebruikt met Home Assistant via MQTT. Zodra de installatie is voltooid, kunt u de NetRelay-relaisuitgangen in- en uitschakelen, de status van digitale ingangen controleren en deze gebruiken in Home Assistant-automatiseringen.
Deze handleiding is geschreven voor gebruikers die weinig of geen ervaring hebben met Home Assistant of MQTT.
Belangrijk: NetRelay wordt niet rechtstreeks aan Apple Home of Google Home toegevoegd. Verbind eerst NetRelay met Home Assistant. Apple Home- of Google Home-integratie kan indien nodig later worden toegevoegd.
Voordat je begint
Je hebt nodig:
- Een werkende Home Assistant installatie
- Een NetRelay-apparaat
- NetRelay en Home Assistant verbonden met hetzelfde lokale netwerk
- Het IP-adres van Home Assistant
- Toegang tot de NetRelay-webinterface
Voorbeeld:
- Home Assistant-IP:
192.168.1.20 - NetRelay IP:
192.168.1.50
Uw IP-adressen kunnen verschillen. Deze adressen zijn slechts voorbeelden.
1. Installeer Mosquitto MQTT Broker
De communicatie tussen NetRelay en Home Assistant wordt afgehandeld via MQTT.
Je kunt MQTT zien als het communicatiekanaal waarmee NetRelay en Home Assistant berichten kunnen uitwisselen.
Open Home Assistant en volg deze stappen:
- Open Instellingen.
- Ga naar Add-ons.
- Open de Add-onwinkel.
- Zoek naar 'Mosquitto'.
- Selecteer Mosquitto-makelaar.
- Klik op Installeren.
- Schakel Start bij opstarten na installatie in.
- Klik op Start.
De Mosquitto-add-on zou nu moeten laten zien dat deze actief is.
2. Maak een MQTT-gebruiker aan
NetRelay heeft een gebruikersnaam en wachtwoord nodig om verbinding te maken met Home Assistant.
In Thuisassistent:
- Ga naar Instellingen → Mensen.
- Open het tabblad Gebruikers.
- Selecteer Gebruiker toevoegen.
- Voer een gebruikersnaam in, bijvoorbeeld
netrelay. - Maak een wachtwoord aan.
- Sla de gebruiker op.
Noteer de gebruikersnaam en het wachtwoord, want u zult deze later in de NetRelay-webinterface invoeren.
De MQTT-gebruiker heeft geen beheerdersrechten nodig.
3. Voeg de MQTT-integratie toe
Nu moet Home Assistant worden geconfigureerd om MQTT te gebruiken.
- Ga naar Instellingen → Apparaten en diensten.
- Klik op Integratie toevoegen.
- Zoek naar
MQTT. - Selecteer de MQTT-integratie.
Home Assistant zal de Mosquitto Broker doorgaans automatisch detecteren.
Als er om een gebruikersnaam en wachtwoord wordt gevraagd, voert u de MQTT-gebruikersgegevens in die u eerder hebt aangemaakt.
Voorbeeld:
- Gebruikersnaam:
netrelay - Wachtwoord: uw MQTT-wachtwoord
Als Home Assistant de makelaar niet automatisch detecteert, gebruik dan het Home Assistant IP-adres als makelaarsadres.
Voorbeeld:
- Makelaar:
192.168.1.20 - Poort:
1883
4. Zoek het IP-adres van de Home Assistant
U moet het Home Assistant IP-adres invoeren in NetRelay.
Als je Home Assistant bijvoorbeeld opent met:
http://192.168.1.20:8123
dan is het Home Assistant IP-adres:
192.168.1.20
Wees voorzichtig met het poortnummer:
8123is de Home Assistant-webinterfacepoort.- Voer '8123' niet in als de MQTT-poort op NetRelay.
- De MQTT-poort moet
1883zijn.
5. Open de NetRelay-webinterface
Configureer nu de NetRelay-kant.
Voer het NetRelay IP-adres in uw webbrowser in.
Voorbeeld:
http://192.168.1.50
Meld u aan bij de NetRelay-webinterface.
6. Geef uw NetRelay een apparaatnaam
Deze stap is optioneel maar aanbevolen, vooral als u meerdere NetRelay-apparaten heeft.
Open het gedeelte Instellingen van NetRelay.
Voorbeeld instellingen:
- Hostnaam:
Huiskamerrelais - Apparaat-ID:
1000
Als u meer dan één NetRelay-apparaat heeft, moet elk apparaat een andere Apparaat-ID hebben.
U kunt de in- en uitgangen ook betekenisvolle namen geven.
Bijvoorbeeld:
- Uitgang 1:
Woonkamerlicht - Uitgang 2:
Tuinlicht - Ingang 1:
Deursensor
Sla de instellingen op.
7. Configureer NetRelay MQTT-instellingen
Open het gedeelte MQTT Client van de NetRelay-webinterface.
Configureer de instellingen als volgt:
- MQTT-server: Home Assistant IP-adres
- MQTT-poort:
1883 - MQTT User: MQTT username created in Home Assistant
- MQTT-wachtwoord: MQTT-gebruikerswachtwoord
- MQTT TLS: Uitgeschakeld
- MQTT-clientmodus: ingeschakeld
- Thuisassistent: Ingeschakeld
Voorbeeld:
MQTT-server: 192.168.1.20
MQTT-poort: 1883
MQTT-gebruiker: netrelay
MQTT-wachtwoord: **********
MQTT TLS: uitgeschakeld
MQTT-clientmodus: ingeschakeld
Thuisassistent: ingeschakeld
Wijzig de velden Onderwerp of Subonderwerp niet tijdens de eerste installatie.
Sla de instellingen op. NetRelay wordt mogelijk opnieuw opgestart.
Nadat het opnieuw is gestart, opent u de MQTT-pagina.
Je zou het volgende moeten zien:
MQTT UP
in het groen.
8. Zoek NetRelay in Home Assistant
Ga terug naar Home Assistant.
- Open Instellingen → Apparaten en diensten.
- Selecteer de MQTT-integratie.
- Open de apparatenlijst.
Uw NetRelay zou moeten verschijnen met de hostnaam die u heeft geconfigureerd.
Bijvoorbeeld:
Huiskamerrelais
Het NetRelay-apparaat zou normaal gesproken het volgende moeten bevatten:
- 4 schakelaars: NetRelay-relaisuitgangen
- 4 binaire sensoren: NetRelay digitale ingangen
9. Test de relais
Open het NetRelay-apparaat in Home Assistant.
Schakel de eerste relaisschakelaar in.
Het corresponderende relais op NetRelay zou moeten activeren en u hoort mogelijk een klik van het relais.
Activeer vervolgens een van de digitale ingangen.
De overeenkomstige status van de binaire sensor in Home Assistant zou moeten veranderen.
Als beide tests werken, is de installatie voltooid.
Home Assistant-compatibele NetRelay-firmware
U kunt de Home Assistant-compatibele NetRelay-firmware downloaden via de onderstaande link:
NetRelay-firmware v3.3.5 HA downloaden
Wat moet ik doen als MQTT UP niet verschijnt?
Als NetRelay MQTT DOWN weergeeft, controleer dan de volgende items in volgorde:
- Is de MQTT-server ingesteld op het juiste Home Assistant IP-adres?
- Is de MQTT-poort ingesteld op
1883? - Zijn de MQTT-gebruikersnaam en het wachtwoord correct?
- Draait Mosquitto Broker in Home Assistant?
- Zitten NetRelay en Home Assistant op hetzelfde netwerk?
- Is MQTT Client Mode ingeschakeld op NetRelay?
MQTT is UP maar NetRelay verschijnt niet in Home Assistant
Als MQTT is aangesloten maar het apparaat niet verschijnt:
- Zorg ervoor dat de optie Home Assistant is ingeschakeld op NetRelay.
- Controleer of de MQTT-integratie is geïnstalleerd in Home Assistant.
- Vernieuw de Home Assistant-pagina.
- Start NetRelay opnieuw.
Kan ik Apple Home of Google Home gebruiken?
Ja, maar NetRelay is niet rechtstreeks verbonden met Apple Home of Google Home.
De juiste verbindingsstroom is:
NetRelay → Home Assistant → Apple Home / Google Home
Voor Apple Home kunt u de HomeKit Bridge-integratie in Home Assistant gebruiken.
Voor Apple Home- en Google Home-ondersteuning kan ook een passende Matter Hub-oplossing worden gebruikt.
Deze stap is optioneel. Apple Home of Google Home is niet vereist om NetRelay met Home Assistant te gebruiken.
Samenvatting van de snelle installatie
Hier is de volledige installatie in een paar eenvoudige stappen:
- Verbind NetRelay en Home Assistant met hetzelfde netwerk.
- Installeer Mosquitto Broker in Home Assistant.
- Maak een MQTT-gebruiker.
- Voeg de MQTT-integratie toe aan Home Assistant.
- Noteer het IP-adres van de Home Assistant.
- Open de NetRelay-webinterface.
- Voer het Home Assistant IP-adres in als de MQTT-server.
- Stel de MQTT-poort in op
1883. - Voer de MQTT-gebruikersnaam en het wachtwoord in.
- Enable MQTT Client Mode.
- Schakel Home Assistant in.
- Sla de instellingen op en controleer op MQTT UP.
- Zoek NetRelay onder MQTT-apparaten in Home Assistant.
- Test de relaisuitgangen en digitale ingangen.
Zodra de installatie is voltooid, kunt u de NetRelay-relaisuitgangen bedienen vanuit Home Assistant, digitale ingangen bewaken en zowel ingangen als uitgangen gebruiken in uw Home Assistant-automatiseringsscenario's.