Installer et configurer la PiZiGate sur Pi 4

Le 04/04/2021, mise à jour de l’article en ajoutant l’installation de l’Intégration ZHA

Pour utiliser les différents capteurs, appareils, interrupteur compatibles avec le protocole ZigBee, tu auras besoin d’installer une passerelle pour que tout cela communique avec Home Assistant qui est installé sur le Raspberry Pi 4.

Je précise bien le modèle de Raspberry, n’ayant pas de Pi 3, je n’ai pas pu tester les opérations dessus, si quelqu’un peut me faire un retour, ce serait avec plaisir.

Je vais utiliser la PiZiGate qui particulièrement bien adaptée pour l’utilisation sur le Raspberry et la mise en place d’une passerelle pour le protocole ZigBee, elle va venir se placer sur le port GPIO.

Tout d’abord, de quoi auras-tu besoin :

• Un Raspberry Pi 4 et tout le nécessaire
• Home Assistant installé sur un Raspberry Pi 4
• Un lecteur de carte micro-SD
• La fameuse PiZiGate

Mise en place de la PiZiGate

Bon, j’avoue ne pas être très courageux mais aussi bien, il a fallu que je recherche pas mal d’éléments sur différents sites ou forum pour les chapitres qui suivent mais pour la mise en place, je te conseille de lire cet article mais reviens après, car leur documentation n’est pas tout à fait à jour (à l’heure à laquelle j’écris, on est le 28/03/2021).

Préparation du Raspberry Pi 4

Si ton système fonctionne déjà, tu vas devoir l’arrêter proprement

Retires la carte SD et places-la dans ton lecteur de carte.

Sur la partition contenant le Boot, recherches le fichier config.txt (se trouve en /boot/config.txt).

Avec un éditeur, décommentes la ligne enable_uart=1 ou bien rajoute-là.

Sauvegarde et quitte le fichier.

Maintenant, dans le fichier cmdline.txt (en /boot/cmdline.txt).

Supprimes, si présente car dans mon cas je n’avais rien à faire, console=serial0,115200.

Tu peux remettre la carte SD dans le Pi et tout redémarrer.

Prise en compte de PiZigate dans Home Assistant

Je vais proposer deux méthodes, la première sera par l’intégration ZHA que je recommande, je la trouve bien plus simple à prendre en main. La seconde consistera en utilisant la bibliothèque proposée par Doudz, j’avoue que j’ai bien plus de difficulté avec celle-ci mais je pense qu’il s’agit plus de mon côté néophyte qui parle.

Installation de l’intégration ZHA

Installation de l’intégration

L’avantage de cette méthode est qu’elle est accessible pour tout le monde, elle ne nécessite pas ou peu de connaissance informatique (en même temps, si tu es ici, c’est que tu en as un minimum).

Il s’agit d’une intégration officielle, tu peux lire sa page ici.

Dans la page Configuration, va sur Intégrations puis cliques sur Ajouter l’intégration.

Dans le champs de recherche, tape ZHA puis cliques sur soumettre.

Dans la fenêtre qui s’affiche, tape le chemin qui correspond à la méthode de branchement de la PiZigate : /dev/serial0 puis sur Soumettre.

Dans la nouvelle fenêtre, tu dois choisir le type radio utilisé, dans notre cas, il s’agit de Zigate puis Soumettre.

Une fois, l’installation terminée, tu dois redémarrer le système.

Home Assistant Zigate

Installation Home Assistant Zigate

A présent, nous allons installer les bibliothèques pour l’utilisation de la Zigate. Pour faire cette partie, je te conseille de suivre cette page pour l’installation de Samba Share, qui va grandement te faciliter la tâche.

Tu vas commencer par télécharger le dossier sur le dépôt git en cliquant sur ce lien.

Dézippes le dossier et tu colles le dossier custom_components dans le partage au niveau de HOMEASSISTANT/config/, tu devrais obtenir cela :

Configuration de Zigate

On en voit la fin, je te rassure. Maintenant, on va juste configurer rapidement Zigate dans Home Assistant.

Si tu as installer File Editor, tu auras finis dans 30 secondes, sinon je te conseille de l’installer en suivant cette page.

Maintenant, ajoute dans le fichier configuration.yaml (que tu peux trouver dans config) cela :

# PiZiGate
zigate:
  gpio: true
  #port: /dev/ttyAMA0
  port: /dev/serial0

Dans mon cas, le port utilisé par le Raspberry est le Serial0.

Sauvegardes puis redémarres ton Pi.

Au prochain démarrage, la led Bleu de la PiZiGate doit être en bleu fort, si ce n’est pas le cas, essaie de changer le port.

Sur ta page d’accueil, la ZiGate a dû apparaître :

Conclusion

Voilà pour ce qui est de l’installation de la ZiGate. Maintenant, tu pourras installer un grand nombre d’équipements compatible avec le protocole ZigBee.