So richten Sie NetRelay mit Home Assistant ein

So richten Sie NetRelay mit Home Assistant ein

NetRelay kann mit Home Assistant über MQTT verwendet werden. Sobald die Einrichtung abgeschlossen ist, können Sie die NetRelay-Relaisausgänge ein- und ausschalten, den Status digitaler Eingänge überwachen und sie in Home Assistant-Automatisierungen verwenden.

Dieses Handbuch richtet sich an Benutzer, die wenig oder keine Erfahrung mit Home Assistant oder MQTT haben.

Wichtig: NetRelay wird nicht direkt zu Apple Home oder Google Home hinzugefügt. Verbinden Sie zunächst NetRelay mit Home Assistant. Die Integration von Apple Home oder Google Home kann bei Bedarf später hinzugefügt werden.

Bevor Sie beginnen

Sie benötigen:

• Eine funktionierende Home Assistant-Installation
• Ein NetRelay-Gerät
• NetRelay und Home Assistant sind mit demselben lokalen Netzwerk verbunden
• Die IP-Adresse von Home Assistant
• Zugriff auf die NetRelay-Weboberfläche

Beispiel:

• Home Assistant-IP: „192.168.1.20“.
• NetRelay-IP: „192.168.1.50“.

Ihre IP-Adressen können unterschiedlich sein. Bei diesen Adressen handelt es sich lediglich um Beispiele.

1. Installieren Sie den Mosquitto MQTT Broker

Die Kommunikation zwischen NetRelay und Home Assistant erfolgt über MQTT.

Sie können sich MQTT als den Kommunikationskanal vorstellen, der es NetRelay und Home Assistant ermöglicht, Nachrichten auszutauschen.

Öffnen Sie Home Assistant und befolgen Sie diese Schritte:

1. Öffnen Sie Einstellungen.
2. Gehen Sie zu Add-ons.
3. Öffnen Sie den Add-on-Store.
4. Suchen Sie nach „Mosquitto“.
5. Wählen Sie Mosquitto-Broker.
6. Klicken Sie auf Installieren.
7. Aktivieren Sie Beim Booten starten nach der Installation.
8. Klicken Sie auf Start.

Das Mosquitto-Add-on sollte nun anzeigen, dass es ausgeführt wird.

2. Erstellen Sie einen MQTT-Benutzer

NetRelay benötigt einen Benutzernamen und ein Passwort, um sich mit Home Assistant zu verbinden.

Im Heimassistenten:

1. Gehen Sie zu Einstellungen → Personen.
2. Öffnen Sie die Registerkarte Benutzer.
3. Wählen Sie Benutzer hinzufügen.
4. Geben Sie einen Benutzernamen ein, z. B. „netrelay“.
5. Erstellen Sie ein Passwort.
6. Speichern Sie den Benutzer.

Notieren Sie sich den Benutzernamen und das Passwort, da Sie diese später in die NetRelay-Weboberfläche eingeben werden.

Der MQTT-Benutzer benötigt keine Administratorrechte.

3. Fügen Sie die MQTT-Integration hinzu

Jetzt muss Home Assistant für die Verwendung von MQTT konfiguriert werden.

1. Gehen Sie zu Einstellungen → Geräte & Dienste.
2. Klicken Sie auf Integration hinzufügen.
3. Suchen Sie nach „MQTT“.
4. Wählen Sie die MQTT-Integration aus.

Home Assistant erkennt den Mosquito Broker normalerweise automatisch.

Wenn ein Benutzername und ein Passwort angefordert werden, geben Sie die MQTT-Benutzeranmeldeinformationen ein, die Sie zuvor erstellt haben.

Beispiel:

• Benutzername: „netrelay“.
• Passwort: Ihr MQTT-Passwort

Wenn Home Assistant den Broker nicht automatisch erkennt, verwenden Sie die IP-Adresse von Home Assistant als Broker-Adresse.

Beispiel:

• Broker: „192.168.1.20“.
• Hafen: 1883

4. Suchen Sie die IP-Adresse des Home Assistant

Sie müssen die IP-Adresse des Home Assistant in NetRelay eingeben.

Wenn Sie beispielsweise Home Assistant öffnen mit:

„http://192.168.1.20:8123“.

dann lautet die IP-Adresse des Home Assistant:

„192.168.1.20“.

Seien Sie vorsichtig mit der Portnummer:

• „8123“ ist der Home Assistant-Webschnittstellen-Port.
• Geben Sie nicht „8123“ als MQTT-Port auf NetRelay ein.
• Der MQTT-Port sollte „1883“ sein.

5. Öffnen Sie die NetRelay-Weboberfläche

Konfigurieren Sie nun die NetRelay-Seite.

Geben Sie die NetRelay-IP-Adresse in Ihren Webbrowser ein.

Beispiel:

„http://192.168.1.50“.

Melden Sie sich bei der NetRelay-Weboberfläche an.

6. Geben Sie Ihrem NetRelay einen Gerätenamen

Dieser Schritt ist optional, wird jedoch empfohlen, insbesondere wenn Sie über mehrere NetRelay-Geräte verfügen.

Öffnen Sie den Abschnitt Einstellungen von NetRelay.

Beispieleinstellungen:

• Hostname: „Wohnzimmer-Relay“.
• Geräte-ID: „1000“.

Wenn Sie mehr als ein NetRelay-Gerät haben, sollte jedes Gerät eine andere Geräte-ID haben.

Sie können den Ein- und Ausgängen auch aussagekräftige Namen geben.

Zum Beispiel:

• Ausgang 1: „Wohnzimmerlicht“.
• Ausgang 2: „Gartenlicht“.
• Eingang 1: „Türsensor“.

Speichern Sie die Einstellungen.

7. Konfigurieren Sie die NetRelay MQTT-Einstellungen

Öffnen Sie den Abschnitt MQTT-Client der NetRelay-Weboberfläche.

Konfigurieren Sie die Einstellungen wie folgt:

• MQTT-Server: Home Assistant IP-Adresse
• MQTT-Port: 1883
• MQTT-Benutzer: MQTT-Benutzername, der in Home Assistant erstellt wurde
• MQTT-Passwort: MQTT-Benutzerpasswort
• MQTT TLS: Deaktiviert
• MQTT-Client-Modus: Aktiviert
• Heimassistent: Aktiviert

Beispiel:

„Text MQTT-Server: 192.168.1.20 MQTT-Port: 1883 MQTT-Benutzer: netrelay MQTT-Passwort: ******** MQTT TLS: Deaktiviert MQTT-Client-Modus: Aktiviert Heimassistent: Aktiviert „

Ändern Sie während der Ersteinrichtung nicht die Felder Thema oder Unterthema.

Speichern Sie die Einstellungen. NetRelay wird möglicherweise neu gestartet.

Öffnen Sie nach dem erneuten Start die MQTT-Seite.

Sie sollten Folgendes sehen:

MQTT UP

in grün.

Wenn MQTT UP angezeigt wird, hat NetRelay erfolgreich eine Verbindung zum Home Assistant MQTT-Broker hergestellt.

8. Finden Sie NetRelay im Home Assistant

Kehren Sie zum Home Assistant zurück.

1. Öffnen Sie Einstellungen → Geräte & Dienste.
2. Wählen Sie die MQTT-Integration aus.
3. Öffnen Sie die Geräteliste.

Ihr NetRelay sollte mit dem von Ihnen konfigurierten Hostnamen angezeigt werden.

Zum Beispiel:

„Wohnzimmer-Relais“.

Das NetRelay-Gerät sollte normalerweise Folgendes enthalten:

• 4 Schalter: NetRelay-Relaisausgänge
• 4 binäre Sensoren: NetRelay-Digitaleingänge

9. Testen Sie die Relais

Öffnen Sie das NetRelay-Gerät im Home Assistant.

Schalten Sie den ersten Relaisschalter ein.

Das entsprechende Relais auf NetRelay sollte aktiviert werden und Sie hören möglicherweise ein Klicken vom Relais.

Dann lösen Sie einen der digitalen Eingänge aus.

Der entsprechende Binärsensorstatus im Home Assistant sollte sich ändern.

Wenn beide Tests funktionieren, ist die Einrichtung abgeschlossen.

Home Assistant-kompatible NetRelay-Firmware

Sie können die mit Home Assistant kompatible NetRelay-Firmware über den folgenden Link herunterladen:

NetRelay-Firmware v3.3.5 HA herunterladen

Was soll ich tun, wenn MQTT UP nicht angezeigt wird?

Wenn NetRelay MQTT DOWN anzeigt, überprüfen Sie die folgenden Elemente der Reihe nach:

1. Ist der MQTT-Server auf die richtige Home Assistant-IP-Adresse eingestellt?
2. Ist der MQTT-Port auf „1883“ eingestellt?
3. Sind der MQTT-Benutzername und das Passwort korrekt?
4. Läuft Mosquitto Broker in Home Assistant?
5. Befinden sich NetRelay und Home Assistant im selben Netzwerk?
6. Ist der MQTT-Client-Modus auf NetRelay aktiviert?

MQTT ist aktiv, aber NetRelay erscheint nicht im Home Assistant

Wenn MQTT verbunden ist, das Gerät aber nicht angezeigt wird:

1. Stellen Sie sicher, dass die Option Home Assistant auf NetRelay aktiviert ist.
2. Überprüfen Sie, ob die MQTT-Integration im Home Assistant installiert ist.
3. Aktualisieren Sie die Home Assistant-Seite.
4. Starten Sie NetRelay neu.

Kann ich Apple Home oder Google Home verwenden?

Ja, aber NetRelay ist nicht direkt mit Apple Home oder Google Home verbunden.

Der richtige Verbindungsablauf ist:

NetRelay → Home Assistant → Apple Home / Google Home

Für Apple Home können Sie die HomeKit Bridge-Integration in Home Assistant verwenden.

Für die Unterstützung von Apple Home und Google Home kann auch eine entsprechende Matter Hub-Lösung verwendet werden.

Dieser Schritt ist optional. Für die Verwendung von NetRelay mit Home Assistant ist weder Apple Home noch Google Home erforderlich.

Kurze Zusammenfassung der Einrichtung

Hier ist die komplette Einrichtung in wenigen einfachen Schritten:

1. Verbinden Sie NetRelay und Home Assistant mit demselben Netzwerk.
2. Installieren Sie Mosquito Broker in Home Assistant.
3. Erstellen Sie einen MQTT-Benutzer.
4. Fügen Sie die MQTT-Integration zu Home Assistant hinzu.
5. Notieren Sie sich die IP-Adresse des Home Assistant.
6. Öffnen Sie die NetRelay-Weboberfläche.
7. Geben Sie die IP-Adresse des Home Assistant als MQTT-Server ein.
8. Stellen Sie den MQTT-Port auf „1883“ ein.
9. Geben Sie den MQTT-Benutzernamen und das Passwort ein.
10. Aktivieren Sie den MQTT-Client-Modus.
11. Aktivieren Sie Home Assistant.
12. Speichern Sie die Einstellungen und prüfen Sie, ob MQTT UP vorhanden ist.
13. Suchen Sie NetRelay unter MQTT-Geräte im Home Assistant.
14. Testen Sie die Relaisausgänge und Digitaleingänge.

Sobald die Einrichtung abgeschlossen ist, können Sie NetRelay-Relaisausgänge über Home Assistant steuern, digitale Eingänge überwachen und sowohl Ein- als auch Ausgänge in Ihren Home Assistant-Automatisierungsszenarien verwenden.