Vous avez commandé une ZiGate. C’est super ! mais comment s’en servir ? A quoi sert-elle ? comment faire les premiers tests ? C’est sur cette page que je vais répondre à vos premières questions.
Déballage de la ZiGate
Normalement, si vous avez commandé une ZiGate (peu importe l’option) , vous devriez avoir reçu cette boite :
Emballage pack ZiGate
Une fois la pastille argenté retiré, vous pourrez ouvrir la boite contenant la ZiGate. La boite comprend :
- Option TTL:
- Un module Radio ZigBee
- Un module USB-TTL
- Un boitier avec ses deux vis de fixation
- Option Wifi:
- Un module Radio ZigBee
- Un module Wifi
- Un module USB-TTL
- Un boitier avec ses deux vis de fixation
Boite ouverte avec le pack ZiGate
Boitier ZiGate
Le pack ZiGate option TTL ou Wifi est livré sous forme de Kit. Ce principe permet de rendre hommage au « Faire soi-même » (point de départ du projet) mais l’assemblage est très simple à réaliser. Vous n’aurez besoin que d’un tournevis cruciforme pour fermer le boitier.
Pour assembler votre ZiGate, il vous suffit de suivre les instructions sur la page « Montage du module ZiGate« .
A quoi sert la ZiGate ?
La ZiGate est une passerelle ZigBee® universelle. Branché sur un ordinateur, une box domotique ou en mode autonome sur une prise électrique (option Wifi), elle vous permet d’interconnecter et converger plusieurs objets communiquant (en ZigBee®) de différentes marques vers votre système domotique existant.
L’objectif de la ZiGate est de:
- Éviter d’utiliser plusieurs passerelles ZigBee
- Être compatible avec toutes les box domotiques
- Être le plus ouvert possible
- Éviter le système de cloud
- Offrir une meilleure portée
Comment utiliser la ZiGate ?
Une fois votre ZiGate prête, vous avez 2 façons de l’utiliser
Option USB-TTL :
Voici le schéma de fonctionnement en mode USB-TTL.
Dans cette méthode, il suffit de brancher votre ZiGate sur un port USB.
Option Wifi :
Voici le schéma de fonctionnement en mode Wifi.
ZiGate USB-TTL
Les premiers tests de fonctionnement
Une fois branché, il vous faut un logiciel pour contrôler la passerelle :
Pour plus d’informations sur le langage de la ZiGate suivez ces instructions.
Sous Windows :
Installez les pilotes de la ZiGate (si nécessaire) sur la page « Description de la ZiGate »
Télécharger cette application : TestGUI
Cette application cliente fonctionne sous Windows XP,7,8,10 et a été développé par NXP.
Cet outil va vous permettre d’effectuer des tests sur la ZiGate. Grâce à cet utilitaire, vous pourrez vérifier le bon fonctionnement de votre passerelle mais il vous aidera aussi à simplifier vos développements.
Voici les étapes à suivre :
Décompressez le fichier ZIP et lancer ZGWUI
Cliquez sur « Settings »
Un popup apparaît:
- Sélectionnez le bon port COM
- Changez la vitesse pour 115200
- Cliquez sur OK
Cliquez sur « Open »
Si pour le moment vous n’avez pas d’erreur, vous pouvez continuer l’étape suivante pour vérifier le dialogue entre votre ordinateur et le module.
- Cliquez sur « Get Version ». Si tout est correct, vous verrez apparaître le protocole de communication dans la fenêtre « Raw Data ». Attention, vérifiez bien qu’il y ait 3 lignes lors du clic (communication bidirectionnelle). Si c’est le cas, vous pouvez passer à la suite sinon cela signifie que le port de communication n’est pas bien paramétré.
Passons au paramétrage :
- Paramétrer le canal 11 et cliquez sur « Set CMSK »
- Choisir « COORDINATOR » puis cliquez sur « Set Type »
- Cliquez sur « Start NWK »
Ok, votre passerelle est paramétrée. Testons désormais l’ajout d’un objet :
Rentrez les informations : FFFC (masque) FE (nombre de secondes en hexadécimal pour l’ouverture) puis cliquez sur « Permit Join »
Saisissez vous d’un objet communiquant en ZigBee et commencer la procédure d’appairage de l’appareil. Si vous voyez apparaître des informations dans la fenêtre « Raw Data », c’est gagné !
Pour plus d’informations sur les commandes veuillez vous rendre dans la section développeur
Sous linux :
En cours
Vous pouvez aussi lire l’exemple API (full web) qui peut fonctionner sous Linux
ZiGate WiFi
Les premiers tests de fonctionnement
Après avoir assemblé la ZiGate WiFi en suivant la description et les instructions de montage, vous pouvez brancher la ZiGate WiFi sur une alimentation de téléphone portable. Puis brancher l’ensemble sur une prise 220VAC.
Paramétrage :
Une fois alimentée, la ZiGate WiFi va démarrer en mode « point d’accès » avec le SSID : ZIGATE-XXXX (XXXX représentant les derniers chiffres de la MAC de votre ZiGate)
Connectez-vous sur ce SSID puis entrez le mot de passe suivant : adminXXXX (XXXX représentant les derniers chiffres de la MAC de votre ZiGate)
Une fois connectée, ouvrez votre navigateur préféré et tapez l’adresse suivante : http://192.168.4.1
La page des paramétrages se lance et vous pourrez :
- Configurer votre connexion WiFi (SSID + mode de passe)
- Paramétrer votre adressage IP fixe (pas de DHCP)
- Mettre à jour la ZiGate WiFi (hors module Radio ZigBee)
- Redémarrer
Une fois que vous avez paramétré votre ZiGate WiFi, il ne vous reste plus qu’à vérifier sa connexion sur votre réseau en effectuant un ping sur votre adresse IP paramétrée.
ping aaa.bbb.ccc.ddd
- Si l’adresse IP répond vous pouvez passer à l’étape suivante.
- Si votre requête ne répond pas, vérifiez que la ZiGate WiFi n’est pas encore en mode point d’accès. En effet, si le paramétrage réseau n’est pas correct ou que la connexion est perdue, la ZiGate WiFi bascule automatiquement en mode point d’accès. Vérifiez donc votre configuration et retenter la connexion.
Connexion TCP
La connexion à la ZiGate WiFi se fait par le port TCP/IP 9999. Il n’est pour le moment pas paramétrable.
Pour initier une connexion, il vous faut donc un client TCP capable de lire de l’hexadécimal.
Sous Windows :
Sous windows, j’ai choisi cet utilitaire pour la démonstration mais il doit en exister plein d’autres:
PacketSender
Cet outil permet de créer des sessions TCP et de lire les données en Héxadécimal:
Une fois téléchargé et installé, vérifiez que votre machine soit bien sur le même réseau que la ZiGate.
Rentrez les paramètres de votre ZiGate WiFi (dans mon cas je l’ai laissé en mode Point d’Accès mais utilisez le plutôt sur votre réseau).
Entrez des données à envoyer. Dans l’exemple, c’est la commande « Get Version » : 01 02 10 10 02 10 02 10 10 03
Cliquez ensuite sur le bouton SEND. Une nouvelle fenêtre apparait.
Si vous avez des hiéroglyphes, c’est déjà bon signe. Cliquez ensuite sur ASCII pour voir apparaître les informations en « clair ».
En bleu, vous avez la commande que vous avez envoyé et en noir la réponse de la ZiGate WiFi
Une fois testé, vous pouvez vous entrainer à envoyer des commandes à la ZiGate et récupérer la Réponse
Sous android :
Voici la démarche à suivre pour tester votre ZiGate WiFi sous Android. Tout comme Windows j’ai choisi l’outil TCP Telnet Terminal
Une fois installé sur votre tablette ou téléphone, lancez l’application et entrez l’adresse IP et le port TCP de la ZiGate WiFi.
Une fois connecté sur votre ZiGate, cliquez en haut à droite pour faire passer l’application en mode hexadécimal.
Pour lancer une commande sur la ZiGate, sélectionnez un bouton ‘BTN1″
- Donnez un nom
- Sélectionnez « HEX »
- Entrez la commande « 01 02 10 49 02 10 02 14 B0 FF FC FE 02 10 03 » (par exemple)
- Cliquez sur « Save »
- Cliquez sur votre bouton fraichement créé
- La commande envoyée s’affiche juste au-dessus
- La réponse de la ZiGate apparait dans la console
Sous Linux :
Sous linux, c’est un peu plus « barbu » mais beaucoup plus court. Voici la démarche à suivre.
- Si ce n’est pas déjà fait, installer « socat » (sudo apt-get install socat)
- Exécuter la commande : mkfifo /tmp/ZiGateSend
- Puis : socat -d -d -x pty,raw,echo=0,link=/tmp/ZiGateSend tcp:192.168.4.1:9999
Ouvrez une autre console :
- Tapez la commande suivante : echo -ne ‘\x01\x02\x10\x49\x02\x10\x02\x14\xb0\xff\xfc\xfe\x02\x10\x03’ >/tmp/ZiGateSend
Vous verrez apparaître dans la première fenêtre la réponse de la ZiGate WiFi