Vous faites déjà tourner Zigbee2MQTT sur votre propre clé ? Vous la reliez alors à FairGrow en quatre étapes. Votre matériel reste le vôtre, et vous n’avez rien à ouvrir dans votre pare-feu.
Quatre étapes, une seule fois
Ensuite, votre coordinateur apparaît sous forme de carte dans FairGrow, comme n’importe quel autre appareil.
Téléchargez le pont
Un installeur pour Windows, macOS ou votre Raspberry Pi. Il est juste en dessous et se charge du reste.Obtenez un code d’appairage
Un code de huit caractères, depuis le panneau Afficher les appareils, à usage unique et valable un quart d’heure. Voir comment plus bas.Saisissez le code une fois
Le pont l’échange contre une clé qui reste sur votre propre machine. Le code expire aussitôt après.
Appairez votre premier appareil
Ouvrez Réseau sur votre coordinateur. Vous y trouverez Ouvrir la fenêtre d’appairage pour un nouvel appareil et Adopter les appareils pour ceux qui y étaient déjà.
L’installation prend une minute
Choisissez votre système et lancez l’installeur. Il prépare tout, demande votre code d’appairage et fait en sorte que le pont démarre ensuite automatiquement.
Pont FairGrow
Fonctionne avec votre propre Zigbee2MQTT ou directement avec ZHA dans Home Assistant. Il communique avec votre coordinateur et avec FairGrow, et avec rien d’autre.
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.shAttention : le pont ne s’installe pas sur Home Assistant lui-même. Ce n’est ni une intégration ni un add-on, et sous Home Assistant OS vous ne pouvez pas ajouter Python. Installez-le sur une autre machine du même réseau qui reste allumée : votre PC, un Raspberry Pi, un NAS ou une machine virtuelle. Avec ZHA, il rejoint Home Assistant par le réseau depuis cette machine.
Ce que fait exactement l’installeur
- Vérifie si Python 3 est installé sur votre machine et, sinon, vous indique où le trouver.
- Crée son propre dossier avec son propre environnement Python, à l’écart de votre système.
- Récupère le pont et compare l’empreinte avec ce que dit la plateforme. Si elle ne correspond pas, rien ne démarre.
- Demande votre code d’appairage et l’endroit où tourne votre Zigbee2MQTT ou votre Home Assistant.
- Appaire une fois et fait en sorte que le pont démarre avec la machine.
Tout tient dans son propre dossier et rien n’est modifié dans votre Python système. Pour le désinstaller : fairgrow-brug.bat /verwijderen ou sh fairgrow-brug.sh --verwijderen ; l’appairage lui-même se supprime depuis la carte de votre coordinateur. Vous préférez tout faire à la main ? Le pont seul reste disponible : fgzb_brug.py.
Pour passer à une version plus récente : fairgrow-brug.bat /bijwerken ou sh fairgrow-brug.sh --bijwerken. Votre appairage et vos réglages sont conservés : vous n’avez donc pas besoin d’un nouveau code d’appairage.
Comment obtenir votre code d’appairage
Trois clics dans FairGrow. Le code est à usage unique et valable un quart d’heure.
1. Panneau Afficher les appareils
2. Choisissez votre coordinateur
3. Votre code
Par où passent vos mesures
Chaque connexion part de chez vous vers l'extérieur. Rien n'entre.
Chaque flèche pointe vers l'extérieur. Votre coordinateur et vos appareils restent dans votre propre réseau.
Trois choses
Un coordinateur pris en charge
Toute clé prise en charge par Zigbee2MQTT : SONOFF ZBDongle-E ou P, SLZB-06, ConBee III.
Un Zigbee2MQTT qui tourne
Version 2.x avec un serveur MQTT dans votre propre réseau. Votre installation existante continue de fonctionner normalement.
Une machine qui reste allumée
Le pont est un petit programme Python. Un Raspberry Pi à côté de votre coordinateur suffit.
Un nouvel appareil Zigbee attend votre feu vert
Rien n'apparaît automatiquement sur votre tableau de bord.
Il est en quarantaine
L'appareil attend. Pas de mesures, pas de tableau de bord, rien encore.
Nous lui demandons qui il est
Marque, modèle, fonctions. Sur la carte, vous voyez ce qui a été mesuré et ce qui a été recherché.
C'est vous qui décidez
Ajouter ou refuser. Refuser retire l'appareil et l'empêche de revenir.
Ce que votre coordinateur Zigbee peut faire ici
Un coordinateur d'une autre marque ne vaut pas moins. Il est juste construit autrement.
Fonctionne
- Ouvrir la fenêtre d'appairage depuis FairGrow
- Lire la marque, le modèle et les fonctions d'un appareil
- Dire si un appareil peut relayer le trafic des autres
- Retirer un appareil et l'empêcher de revenir
- Lancer une analyse du réseau : quels appareils passent par quels autres, et avec quelle force
- Reconnaître votre adaptateur et son firmware, et vous avertir d'une combinaison que nous savons défaillante
Ne fonctionne pas
- Zigbee2MQTT ne peut pas obtenir ce qu'un appareil refuse de communiquer. Pour cela, nous nous appuyons sur notre propre bibliothèque d'appareils.
- Tous les appareils ne proposent pas la fonction « clignoter pour identifier » via Zigbee2MQTT.
Ce que nous n'avons pas pu mesurer nous-mêmes, la carte l'indique. Nous ne faisons jamais passer une valeur reprise d'ailleurs pour une mesure.
Voyez où en est votre réseau Zigbee
Zigbee est un réseau maillé : vos appareils relaient les messages les uns des autres. Depuis votre coordinateur, vous lancez une analyse du réseau et voyez qui passe par qui.
Le plan
Chaque appareil, chaque liaison et sa qualité. Vous repérez un maillon faible avant qu'un capteur ne lâche.
Ce qui cloche
Un appareil avec un seul voisin, une liaison trop faible, quelque chose de trop loin du coordinateur. Avec la règle qui a déclenché l'avertissement.
L'historique
Nous gardons chaque analyse. Vous voyez ainsi une liaison s'affaiblir ou un appareil changer sans cesse de voisin, au lieu de découvrir seulement qu'il s'est tu.
Une analyse interroge chaque routeur sur sa table de voisins et occupe du temps d'antenne : elle ne se lance donc jamais automatiquement. Et un routeur qui ne répond pas n'est pas discrètement déclaré isolé : la carte indique simplement que nous ne savons pas.
Si ça ne fonctionne pas, vous voyez pourquoi
L'installeur examine votre système et consigne ce qui se passe.
Mesurer d'abord, appairer ensuite
Ports, droits, pilotes, tâche de démarrage : presque tous les blocages se situent en dehors du pont.
Nous voyons notre moitié
Chaque tentative reçoit une référence, sous laquelle nous enregistrons ce qui s'est passé de votre côté, même si l'appairage n'a jamais abouti.
Un seul bouton pour envoyer
Sous Vos coordinateurs, vous trouvez Envoyer le journal. Les mots de passe sont masqués dès réception.
Quel matériel Zigbee fonctionne. Ce qui pose problème avec les adaptateurs et les marques du commerce, et ce que nous corrigeons. Voir ce qui fonctionne
Votre coordinateur Zigbee est appairé. Voici la suite. Ajouter un appareil, l'accepter et savoir où il apparaît. Et ce que nous surveillons ensuite pour vous. Ajoutez votre premier appareil
Questions fréquentes
Quels coordinateurs puis-je connecter ?
Zigbee2MQTT et Home Assistant ZHA, dès aujourd'hui et tous deux en autonomie : téléchargez le pont, indiquez lequel des deux vous utilisez pendant l'installation, obtenez un code, c'est fait. Si vous utilisez ZHA, vous n'avez pas besoin d'installer Zigbee2MQTT et rien ne change dans votre installation. Pour les deux, nous finalisons encore les essais sur du vrai matériel : dites-nous si vous rencontrez un problème. deCONZ / Phoscon suivra ; celui-là, vous ne pouvez pas encore le choisir. Le vôtre n'y figure pas ? Dites-nous lequel vous avez.
Qu'est-ce qui sort de mon réseau ?
Les données de votre coordinateur, et des appareils qui s'appairent pendant votre session : adresse, marque, modèle et leurs mesures. Les appareils déjà présents dans votre Zigbee2MQTT et qui ne s'appairent pas restent en dehors.
Dois-je ouvrir un port ?
Non. Le pont n'établit que des connexions vers l'extérieur. Rien n'entre dans votre réseau depuis chez nous.
Comment arrêter ?
Déconnectez le coordinateur dans FairGrow. La clé devient aussitôt inutilisable. Vos appareils restent dans la liste, ils ne reçoivent simplement plus de nouvelles mesures.
Et si mon pont reste éteint un moment ?
Rien ne casse. Les mesures s'arrêtent et reprennent dès que le pont revient. Sur la carte, vous voyez augmenter le temps écoulé depuis le dernier message.
Que se passe-t-il si un appareil décroche ?
Votre pont signale toutes les cinq minutes ce que voit votre coordinateur. Si un appareil se tait, cela apparaît au niveau de votre coordinateur, avec la raison : l'appareil lui-même, ou le routeur auquel il était rattaché. Si le pont cesse d'émettre, nous le signalons en premier, car tout semble alors perdu alors que seul le pont s'est arrêté.
Connectez votre propre coordinateur
Dites-nous quelle clé vous utilisez et ce que vous voulez mesurer. Nous faisons l'appairage avec vous.