Aeotec ZGA008 "Zi-Stick" - Dongle USB contrôleur ZigBee

Présentation

Zi-Stick a été développé pour contrôler des actionneurs et des capteurs dans un réseau Zigbee 3.0 en tant qu'adaptateur USB Zigbee 3.0 auto-alimenté.

Informations de sécurité importantes :

• Veuillez lire attentivement ce guide et les autres guides de l'appareil.
• Le non-respect des recommandations formulées par Aeotec Limited peut s'avérer dangereux ou constituer une violation de la loi.
• Le fabricant, l'importateur, le distributeur et/ou le revendeur ne seront pas tenus responsables de toute perte ou de tout dommage résultant du non-respect des instructions contenues dans ce guide ou dans d'autres documents.
• Tenir le produit à l'écart des flammes nues et de la chaleur extrême. Évitez l'exposition directe au soleil ou à la chaleur. Une mauvaise utilisation des piles peut endommager le produit.
• Zi-Stick est conçu pour être utilisé à l'intérieur, dans des endroits secs uniquement. Ne l'utilisez pas dans des endroits humides ou mouillés.

Démarrage rapide

Les instructions suivantes vous aideront à utiliser le Zi-Stick lorsqu'il est connecté à un contrôleur hôte (PC) en tant que contrôleur principal.

Assurez vous que le contrôleur hôte est préinstallé, cela inclut tous les pilotes dont le système d'exploitation correspondant peut avoir besoin
Dans la plupart des cas, le contrôleur hôte installe automatiquement les pilotes USB requis.

Si ce n'est pas le cas, le pilote USB peut être téléchargé à partir de www.silabs.com part CP2102N qui peut être trouvé ici : SiLabs CP2102N Driver. 

Étapes à suivre :

• Branchez le Zi-Stick sur un contrôleur hôte (qui peut être un PC, un Mac, un RPi, etc.)
  • Windows - Ouvrez « Ports (COM & LPT) » dans le Gestionnaire de périphériques. Le Zi-Stick apparaît comme un périphérique COMX (où X peut être une valeur numérique comprise entre 0 et 1000).
  • Linux - dans votre invite de commande, tapez « dmesg | grep tty », ce qui vous donnera une liste de tous les périphériques tty connectés. Le Zi-Stick apparaîtra comme un périphérique « ttyUSB0 ». (peut être affiché comme ttyUSB1, ttyUSB2, etc. en fonction du nombre de périphériques USB série que vous avez connectés).
  • OSX - Choisissez Apple > Préférences Système, puis cliquez sur « Réseau ». Vous pouvez trouver Zi-Stick en tant que périphérique modem USB.
    • Il peut être répertorié comme :
      • /dev/cu.usbmodem-XXXX (où XXXX peut être une combinaison de chiffres de 0 à 9, comme 1229) 
      • /dev/cu.usbserial-XXXX (où XXXX peut être une combinaison de chiffres de 0 à 9 comme 4211)
      • /dev/tty.usbserial-XXXX (où XXXX peut être une combinaison de chiffres de 0 à 9 comme 6921)
• Ouvrez le logiciel tiers sélectionné. Vous pouvez trouver des instructions pour certains logiciels tiers populaires ici :
  • Installation de Home Assistant
  • Installation d'OpenHAB
• Suivez les instructions de votre logiciel tiers pour connecter un adaptateur USB ZigBee. Sélectionnez le port COM ou le port virtuel auquel Zi-Stick est associé.
  • Configuration du Zi-Stick avec Home Assistant
  • Configuration du Zi-Stick avec OpenHAB

Dans la plupart des cas, tous les appareils déjà associés au réseau Zi-Stick apparaîtront automatiquement dans l'interface du logiciel.
Il se peut que vous deviez rescanner le Zi-Stick afin de redétecter les appareils qu'il n'a pas détectés auparavant.

Pilotes pour Zi-Stick

En général, vous n'avez pas besoin d'installer de pilotes, car la plupart des systèmes d'exploitation disposent des pilotes nécessaires pour faire fonctionner le Zi-Stick.
Mais dans certains cas, ces pilotes peuvent ne pas être installés sur certains systèmes d'exploitation.

Vous pouvez trouver les pilotes du pont série ici : https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers

Installation du Zi-Stick sur HomeAssistant

Ce tutoriel décrit comment installer le ZI-Stick dans Home Assistant et a été créé avec : Home Assistant Core V2023.2.5. 

Les versions ultérieures peuvent présenter de légères variations dans la configuration de votre réseau Zigbee avec le Zi-Stick.

Configurez le Zi-Stick avec l'intégration Zigbee :

• Ouvrez Home Assistant sur votre navigateur : http://homeassistant:8123/
• Dans le menu, cliquez sur Paramètres

• Cliquez sur Appareils et services

• Cliquez sur Ajouter une intégration

• Recherchez « Zigbee »
• Sélectionnez Zigbee Home Automation

• Sélectionnez le port (/dev/ttyUSB0) auquel votre Zi-Stick est connecté et appuyez sur Submit
  
  • Généralement, le Zi-Stick devrait être /dev/ttyUSB0 ou si vous avez d'autres périphériques série USB, il pourrait être /dev/ttyUSB1 par exemple si vous avez un Z-Stick 7 connecté en même temps.

• • • Sautez cette section si vous obtenez le menu de sélection du port série ci-dessus, sinon continuez avec la section ci-dessous :
      • Si vous n'obtenez pas cette sélection et qu'il vous est demandé d'utiliser un « Type de radio », choisissez « EZSP = protocole Silicon Labs EmberZNet »

• • • • Saisissez ensuite les paramètres de votre port série :

• • • • • Chemin du périphérique série = /dev/zigbee (ou /dev/ttyUSB0)
        • Vitesse du port = 115200
        • Contrôle du flux de données = logiciel
• Sélectionnez l'une des options en fonction de vos besoins :
  
  • Restaurer une sauvegarde automatique --> Si vous avez sauvegardé un réseau Zigbee précédent, vous pouvez le restaurer à l'aide de cette option.
  • Conserver les paramètres du réseau radio --> Intégration d'un réseau Zigbee existant dans Home Assistant.
  • Télécharger une sauvegarde manuelle --> Restaurer un réseau sans fil à partir d'un fichier de sauvegarde que vous avez enregistré.
  • Effacer les paramètres du réseau et créer un nouveau réseau --> Supprime tout réseau précédent et crée un nouveau réseau Zigbee. 
• La clé a été automatiquement détectée, ce qui est confirmé par la fenêtre contextuelle ci-dessous (et peut inclure d'autres appareils Zigbee en mode de balayage)

• • Confirmez en cliquant sur Terminer
• Vous pouvez maintenant commencer à appairer de nouveaux appareils Zigbee à votre propre réseau Zigbee.

Appairer les appareils Zigbee au Zi-Stick dans Home Assistant :

• Dans le menu, cliquez sur Paramètres
• Cliquez sur Appareils et services
• Cliquez sur Configurer (sous Domotique Zigbee)

• Cliquez sur + Ajouter un appareil

• Pendant que Home Assistant + Zi-Stick sont en train de scanner :
  • Mettez votre appareil Zigbee sous tension et suivez les instructions qui pourraient vous être demandées, par exemple en appuyant sur un bouton.
  • Si votre appareil Zigbee était déjà appairé à un autre réseau Zigbee, réinitialisez l'appareil Zigbee et il devrait automatiquement entrer en mode appairage/connexion après une réinitialisation d'usine de cet appareil. 
  • Si un appareil est trouvé, il vous indiquera qu'il est en train de s'initialiser et affichera que l'appareil est prêt à être utilisé. Vous pouvez configurer plusieurs appareils Zigbee pour qu'ils soient scannés en même temps pendant que vous scannez les appareils Zigbee pour les connecter :

Installation du Zi-Stick sur OpenHAB

Ce tutoriel décrit comment installer le ZI-Stick dans OpenHAB qui a été créé avec OpenHAB Stable 3.4.2.
Les versions ultérieures d'OpenHAB peuvent présenter de légères variations/changements par rapport aux instructions ci-dessous. 

Configurer le ZI-Stick avec l'intégration Zigbee :

• Ouvrez OpenHAB sur votre PC (http://localhost:8080)
• Installer openHAB ZigBee Binding
  • Pendant l'installation d'OpenHAB :

• • • Vous pouvez facilement installer l'addon dans l'assistant d'installation.
    • Recherchez « Zigbee » et sélectionnez « openHAB ZigBee Binding »
    • Cliquez ensuite sur « Installer 1 add-on »
    • Finalisez votre installation.
  • Si vous avez déjà installé OpenHAB, vous pouvez ultérieurement ajouter l'addon Zigbee depuis l'interface OpenHAB

• • • Cliquez sur « Settings » sous « Administration »
    • Cliquez sur « Bindings »
    • Cliquez sur « Show 338 more »
    • Appuyez sur CTRL + F pour rechercher « Zigbee » dans votre navigateur
    • Cliquez sur « Install » à côté de « OpenHAB ZigBee Binding »

• Cliquez maintenant sur « Settings -> Things » (Paramètres -> Choses)
• Appuyez sur le bouton + en bas à droite

• Cliquez sur « ZigBee Binding »
• Sélectionnez « Ember Coordinator »
• Changez le port pour refléter le port COM auquel votre Zi-Stick est associé :
  • Régler le port
  • Contrôle de flux = Aucun
  • Débit en bauds = 115200

• • • Vérifier le port et les paramètres du bâton Zi sur le PC Windows
      • Ouvrez le « Gestionnaire de périphériques » et développez « Ports (COM & LPT) », le Zi-Stick sera répertorié comme « USB-SERIAL CH340 (COMX) »

• • • • Faites un clic droit sur votre Zi-Stick (USB-SERIAL CH340) et cliquez sur Propriétés
      • Sélectionnez « Paramètres du port » et assurez vous que les configurations suivantes ont été définies, si ce n'est pas déjà le cas :

• • • • • Bits par seconde = 115200
        • Contrôle de flux = Aucun
• Descendez au bas de la page de création du coordinateur Ember et cliquez sur « Create Thing », donnez-lui une ou deux secondes pour s'initialiser en ligne.

Appairer les appareils Zigbee à Zi-Stick dans Home Assistant :

• Cliquez sur « Settings -> Thing »
• Cliquez sur le bouton +
• Cliquez sur « ZigBee Binding » (Liaison ZigBee)
• Cliquez sur « Scan »
• Mettez votre appareil Zigbee en mode connexion/appairage (si ce n'est pas déjà le cas, réinitialisez votre appareil Zigbee manuellement et il devrait s'appairer automatiquement)