Zigbee protocole incontournable de la domotique nécessite de brancher un dongle USB sur un ordinateur afin de pouvoir avoir un réseau Zigbee à son domicile.
Zigbee est un protocole de haut niveau permettant la communication d’équipements personnels ou domestiques équipés de petits émetteurs radios à faible consommation ; il est basé sur la norme IEEE 802.15.4 pour les réseaux à dimension personnelle (Wireless Personal Area Networks : WPAN)
Wikipédia
Si comme moi, vous avez fait le choix d’installer Home Assistant en machine virtuelle avec Proxmox sur un ordinateur et que vous avez acheter un dongle USB Zigbee, je vais vous expliquer maintenant comme faire pour que votre dongle USB soit passé à votre Home Assistant pour ensuite utiliser Z2H ou ZHA.
SONOFF ZigBee 3.0 USB Dongle Plus
SONOFF ZigBee 3.0 USB Dongle Plus, EFR32MG21 Coordinator, Universelle USB ZigBee Hub, Passerelle ZigBee pour Home Assistant
SONOFF ZBDONGLE-E
SONOFF ZBDONGLE-E – CLÉ USB DONGLE ZIGBEE 3.0 + ANTENNE EXTERNE 20DBM (V2)
SONOFF-Dongle USB Z750ongle-P
SONOFF-Dongle USB universel Zigbee Dongle-E 3.0, passerelle Zigequation via ZHA ou Zigbee2MQTT, prise en charge SONOFF ZBMINI S26ZBR2 SNZB
Brancher le dongle USB sur l’ordinateur
Pour ma part voici une photo du dongle SONOFF que je vais brancher :
Je vais mettre le dongle sur un port USB à l’arrière, celui du haut.
Le dongle SONOFF est branché au MINI PC.
Cette étape n’est pas très compliquer, on va maintenant aller dans Proxmox pour mapper le port USB à la machine virtuelle Home Assistant.
BMAX Mini PC Intel N100
Mini PC 16 Go DDR4 512 Go SSD Intel Alder Lake N100 Windows 11 Pro 3,4 GHz 4 cœurs 4 Fils Extensible SSD 4K 60 Hz Tipo-C (Fonction complète) HDMI*2/USB*4/Wi-FI 5/2.4 +5G/BT4. 2
NiPoGi Mini PC N100
NiPoGi Mini PC Alder Lake N100 (jusqu’à 3.4GHz,6W) 16Go DDR4/512Go M.2 NVMe SSD,Ordinateur de Bureau, Tour PC 4K@60HZ HD Dual Display,WiFi 2.4G/5G, RJ45 Gigabit Ethernet, BT4.2, VESA Supporté
BMAX Mini PC Intel N95
BMAX Mini PC Intel N95 (jusqu’à 3,4 GHz) 16 Go DDR4 RAM 512 Go M.2 SSD B4 Mini Ordinateur de Bureau Compatible avec HDMI Dual 4K UHD WiFi 5, Bluetooth4.2
Mapper le dongle USB à Home Assistant dans Proxmox
Depuis l’interface d’administration de Proxmox, sélectionner la machine virtuelle Home Assistant 1 puis aller sur Hardware 2.
Cliquer sur le bouton Add 1 puis sur USB Device 2.
Pour le mappage vous avez deux solutions :
- Mapper le périphérique USB à Home Assistant (Use USB Vendor/Device ID)
- Mapper le port USB à la machine virtuelle Home Assistant (Use USB Port)
Dans les deux cas, cela fonctionne, la principale différence, c’est qu’avec la deuxième solution, si vous changez le périphérique sur le port USB, celui-ci sera mappé à la VM.
Sélectionner la méthode de mappage 1.
Sélectionner le dongle Zigbee 1.
Le périphérique USB sélectionné, cliquer sur Add 1.
Le périphérique est ajoutée à la machine virtuelle.
Pour ma part, pour la prise en compte dans Home Assistant, j’ai du le redémarrer.
Sur l’interface Home Assistant, cliquer sur Paramètres 1.
Cliquer ensuite sur Système 1.
Cliquer sur l’icone 1 en haut à droite.
Afficher les Options avancées 1 et cliquer sur Redémarrer 2.
Confirmer en cliquant sur REDEMARRER 1.
Home Assistant redémarré, retourner dans les Paramètres / Système et cliquer sur Matériel 1.
Cliquer sur TOUT LE MATERIEL 1 pour afficher la liste.
Ensuite dans la liste, rechercher le périphérique USB comme ci-dessous.
Si vous installez un dongle Zigbee, il y a de grande chance que la prochaine étape soit l’installation de Zigbee2MQTT pour éviter de faire plusieurs aller/retour dans Home Assistant, copier le chemin d’accès au périphérique /dev/ttyUSBX et ID /dev/serial/by-id/usb-xyz
Le tutoriel Zigbee2MQTT est prévu pour la semaine prochaine (13/07).
Vous savez maintenant comment brancher et utiliser un dongle USB Zigbee pour Home Assistant sur une machine virtuelle sous Proxmox.
Si vous utilisez VMware c’est quasiment la même chose par contre Hyper-V ne prend pas en charge les périphériques USB.