Läuft Zigbee2MQTT schon auf deinem eigenen Stick? Dann schließt du ihn in vier Schritten an FairGrow an. Deine Hardware bleibt deine, und in deiner Firewall musst du nichts öffnen.
Vier Schritte, einmalig
Danach steht dein Koordinator als Karte in FairGrow, wie jedes andere Gerät.
Brücke herunterladen
Ein Installer für Windows, macOS oder deinen Raspberry Pi. Er steht weiter unten und regelt den Rest selbst.Kopplungscode holen
Ein achtstelliger Code aus dem Fenster „Geräte anzeigen“, einmalig und eine Viertelstunde gültig. Wie das geht, siehst du unten.Den Code einmal eingeben
Die Brücke tauscht ihn gegen einen Schlüssel, der auf deinem eigenen Rechner bleibt. Der Code verfällt danach sofort.
Dein erstes Gerät koppeln
Öffne Netzwerk bei deinem Koordinator. Dort findest du Kopplungsfenster öffnen für ein neues Gerät und Geräte übernehmen für die, die schon darauf liefen.
Die Installation dauert eine Minute
Wähle dein System und starte den Installer. Er richtet alles ein, fragt nach deinem Kopplungscode und sorgt dafür, dass die Brücke künftig von selbst mitstartet.
FairGrow-Brücke
Arbeitet mit deinem eigenen Zigbee2MQTT oder direkt mit ZHA in Home Assistant. Spricht mit deinem Koordinator und mit FairGrow, und sonst mit nichts.
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shAchtung: Die Brücke läuft nicht auf Home Assistant selbst. Sie ist keine Integration und kein Add-on, und unter Home Assistant OS kannst du kein Python nachinstallieren. Nimm einen anderen Rechner im selben Netzwerk, der dauerhaft läuft: deinen PC, einen Raspberry Pi, ein NAS oder eine virtuelle Maschine. Bei ZHA erreicht sie Home Assistant von dort über das Netzwerk.
Was der Installer genau tut
- Prüft, ob Python 3 auf deinem Rechner ist, und sagt sonst, wo du es bekommst.
- Legt einen eigenen Ordner mit einer eigenen Python-Umgebung an, getrennt von deinem System.
- Holt die Brücke und vergleicht den Fingerabdruck mit dem, was die Plattform sagt. Stimmt er nicht, startet nichts.
- Fragt nach deinem Kopplungscode und danach, wo dein Zigbee2MQTT oder Home Assistant läuft.
- Koppelt einmal und sorgt dafür, dass die Brücke beim Hochfahren mitstartet.
Alles liegt in einem eigenen Ordner, und an deinem System-Python wird nichts geändert. Entfernen kannst du es mit fairgrow-brug.bat /verwijderen oder sh fairgrow-brug.sh --verwijderen; die Kopplung selbst hebst du auf deiner Koordinatorkarte auf. Lieber von Hand? Die Brücke gibt es auch als einzelne Datei: fgzb_brug.py.
Auf eine neuere Version bringst du sie mit fairgrow-brug.bat /bijwerken oder sh fairgrow-brug.sh --bijwerken. Deine Kopplung und deine Einstellungen bleiben erhalten, du brauchst also keinen neuen Kopplungscode.
So holst du deinen Kopplungscode
Drei Klicks in FairGrow. Der Code gilt einmal und eine Viertelstunde lang.
1. Fenster Geräte anzeigen
2. Wähle deinen Koordinator
3. Dein Code
Welchen Weg deine Messwerte nehmen
Jede Verbindung wird von deiner Seite nach außen aufgebaut. Es kommt nichts herein.
Jeder Pfeil zeigt nach außen. Dein Koordinator und deine Geräte bleiben in deinem eigenen Netz.
Drei Dinge
Ein unterstützter Koordinator
Jeder Stick, den Zigbee2MQTT unterstützt: SONOFF ZBDongle-E oder P, SLZB-06, ConBee III.
Ein laufendes Zigbee2MQTT
Version 2.x mit einem MQTT-Server in deinem eigenen Netz. Dein bestehender Aufbau läuft einfach weiter.
Ein Rechner, der dauerhaft läuft
Die Brücke ist ein kleines Python-Programm. Ein Raspberry Pi neben deinem Koordinator reicht.
Ein neues Zigbee-Gerät wartet auf dich
Auf deinem Dashboard erscheint nichts von allein.
Es steht in Quarantäne
Das Gerät wartet. Keine Messwerte, kein Dashboard, noch nichts.
Wir fragen, wer es ist
Marke, Modell, was es kann. Auf der Karte siehst du, was gemessen und was nachgeschlagen wurde.
Du entscheidest
Aufnehmen oder ablehnen. Ablehnen entfernt das Gerät und hält es draußen.
Was dein Zigbee-Koordinator hier kann
Ein Koordinator einer anderen Marke ist nicht schlechter. Er ist nur anders gebaut.
Geht
- Das Kopplungsfenster aus FairGrow heraus öffnen
- Marke, Modell und die Fähigkeiten eines Geräts auslesen
- Erkennen, ob ein Gerät Daten für andere weiterleiten kann
- Ein Gerät entfernen und draußen halten
- Eine Netzwerkabfrage starten: welches Gerät über welches funkt und wie stark die Verbindung ist
- Deinen Adapter und die Firmware erkennen und vor einer Kombination warnen, die wir als kaputt kennen
Geht nicht
- Zigbee2MQTT kann nicht abfragen, was ein Gerät nicht preisgibt. Dafür stützen wir uns auf unsere eigene Gerätebibliothek.
- Nicht jedes Gerät bietet über Zigbee2MQTT eine Blinkfunktion zum Wiederfinden an.
Was wir nicht selbst messen konnten, sagt die Karte dazu. Einen übernommenen Wert geben wir nie als Messung aus.
Sieh, wie dein Zigbee-Netz dasteht
Zigbee ist ein Mesh: Deine Geräte leiten Signale füreinander weiter. Von deinem Koordinator aus forderst du eine Netzwerkabfrage an und siehst, wer über wen läuft.
Der Grundriss
Jedes Gerät, jede Verbindung und wie stark sie ist. Ein schwaches Glied erkennst du, bevor ein Sensor ausfällt.
Was daran hakt
Ein Gerät mit nur einem Nachbarn, eine zu schwache Verbindung, etwas, das zu weit vom Koordinator entfernt ist. Jeweils mit der Regel, auf der der Hinweis beruht.
Der Verlauf
Wir bewahren jede Abfrage auf. So siehst du, wenn eine Verbindung nachlässt oder ein Gerät ständig den Nachbarn wechselt, und merkst es nicht erst, wenn es verstummt.
Eine Abfrage bittet jeden Router um seine Nachbartabelle und kostet Funkzeit, also läuft sie nie von allein. Und einen Router, der nicht antwortet, erklären wir nicht einfach für isoliert: Dann steht dort, dass wir es nicht wissen.
Wenn es nicht klappt, sehen wir warum
Die Installation prüft dein System und protokolliert, was passiert.
Erst messen, dann koppeln
Ports, Rechte, Treiber, die Startaufgabe. Fast alles, was schiefgeht, geht außerhalb der Brücke schief.
Unsere Hälfte des Protokolls haben wir selbst
Jeder Versuch bekommt eine Referenz. Darunter steht, was von deiner Seite ankam, auch wenn das Koppeln nie geklappt hat.
Senden per Knopfdruck
Unter „Deine Koordinatoren“ findest du „Protokoll senden“. Passwörter werden beim Eingang maskiert.
Welche Zigbee-Hardware funktioniert. Was bei Adaptern und Marken aus dem Handel schiefgeht und wie wir das abfangen. Sieh dir an, was läuft
Dein Zigbee-Koordinator ist verbunden. So geht es weiter. Ein Gerät hinzufügen, freigeben und wissen, wo es landet. Und was wir danach für dich im Auge behalten. Füge dein erstes Gerät hinzu
Häufige Fragen
Welche Koordinatoren kann ich anschließen?
Zigbee2MQTT und Home Assistant ZHA, beide schon heute und beide in Eigenregie: Brücke herunterladen, bei der Installation wählen, welchen der beiden du hast, Kopplungscode holen, fertig. Läuft bei dir ZHA, dann musst du Zigbee2MQTT gar nicht installieren und an deinem Aufbau ändert sich nichts. Bei beiden schließen wir die Prüfung auf echter Hardware noch ab, sag also Bescheid, wenn dir etwas auffällt. deCONZ / Phoscon steht als Nächstes an; den kannst du noch nicht wählen. Deiner ist nicht dabei? Sag uns, welchen du hast.
Was verlässt mein Netz?
Die Daten deines Koordinators und der Geräte, die während deiner Sitzung koppeln: Adresse, Marke, Modell und ihre Messwerte. Geräte, die schon in deinem Zigbee2MQTT stehen und nicht koppeln, bleiben außen vor.
Muss ich einen Port öffnen?
Nein. Die Brücke baut nur Verbindungen nach außen auf. Von uns kommt nichts in dein Netz.
Wie höre ich wieder auf?
Trenne den Koordinator in FairGrow. Der Schlüssel ist dann sofort wertlos. Deine Geräte bleiben in der Liste stehen, sie bekommen nur keine neuen Messwerte mehr.
Was, wenn meine Brücke eine Weile aus ist?
Es geht nichts kaputt. Die Messungen setzen aus und laufen weiter, sobald die Brücke wieder da ist. Auf der Karte siehst du die Zeit seit der letzten Meldung wachsen.
Was passiert, wenn ein Gerät ausfällt?
Deine Brücke meldet alle fünf Minuten, was dein Koordinator sieht. Verstummt ein Gerät, steht das bei deinem Koordinator, mit dem Grund daneben: das Gerät selbst oder der Router, an dem es hing. Meldet sich die Brücke nicht mehr, sagen wir das zuerst, denn dann wirkt alles ausgefallen, obwohl nur die Brücke nicht läuft.
Schließ deinen eigenen Koordinator an
Sag uns, welchen Stick du nutzt und was du messen willst. Wir gehen das Koppeln mit dir durch.