H2 carrier

ZigCreate OTA — Bridge Zigbee pour ventilateur de plafond

Transformez votre ventilateur Tuya en appareil Zigbee natif, pilotable depuis votre box domotique favorite.

---

Ce que vous pouvez contrôler

---

Fonctionnalités

Contrôle complet depuis l'interface domotique

Toutes les commandes sont disponibles depuis Zigbee2MQTT ou toute box compatible Zigbee :

• Ventilateur — marche/arrêt indépendant de la vitesse ; la vitesse peut être réglée de 1 à 6 sans éteindre le ventilateur. La dernière vitesse est mémorisée et restaurée à la prochaine mise en marche.
• Lumière — marche/arrêt avec mémorisation de l'état. Température de couleur : cycle uniquement — le matériel ne permet pas de choisir une couleur absolue, on ne peut qu'avancer d'un cran (Froid→Neutre→Chaud→…) comme avec la télécommande. La valeur remontée par le MCU est découplée de la couleur réelle, donc aucun état couleur fiable n'est exposé.
• Minuterie — déclenche l'extinction automatique après 1 h, 2 h ou 4 h. Le décompte restant (en minutes) est visible en temps réel dans l'interface. Le préréglage repasse automatiquement à off lorsque le décompte atteint zéro.
• Son (bip) — active ou désactive le bip sonore émis par l'appareil lors de chaque commande.
• Direction — inverse le sens de rotation du ventilateur pour le mode Hiver.

Synchronisation en temps réel

Utiliser la télécommande physique (vitesse, on/off, direction…) met à jour l'état dans l'interface domotique instantanément. L'état est également resynchronisé automatiquement à chaque redémarrage du module.

Comportement après coupure de courant

Il est possible de définir ce que fait chaque appareil au redémarrage après une coupure de courant. Ce réglage est disponible séparément pour la lumière et le son :

La température de couleur n'est PAS restaurée (cycle uniquement / découplée — voir ci-dessus). Par défaut, le bip démarre toujours désactivé.

Mises à jour sans fil (OTA)

Le firmware se met à jour par liaison radio depuis Zigbee2MQTT, sans démontage ni câble. Les mises à jour sont proposées automatiquement dès qu'une nouvelle version est disponible dans l'index OTA de ce dépôt.

Rôle routeur Zigbee

Le module fonctionne en tant que routeur Zigbee : il peut relayer les communications d'autres appareils Zigbee du réseau, contribuant ainsi à améliorer la portée et la robustesse du maillage.

Indicateur LED

La LED RGB intégrée indique l'état du module en temps réel :

Réinitialisation

• Bouton BOOT (5 s) — maintenir le bouton BOOT appuyé 5 secondes remet l'appareil en configuration d'usine : effacement du réseau Zigbee mémorisé, des préférences et de l'historique de diagnostics. L'appareil redémarre ensuite en mode appairage.
• GPIO externe — un signal bas sur le GPIO de reset externe provoque un redémarrage simple (sans effacement). Consultez le guide de câblage.

Récupération automatique

Si la connexion Zigbee échoue 3 fois de suite au démarrage, le module efface automatiquement sa configuration réseau corrompue et redémarre proprement.

Si le ventilateur ne répond plus pendant 15 secondes, le module passe en mode dégradé (LED ambre) : les commandes sont suspendues jusqu'au rétablissement de la communication, puis le fonctionnement reprend automatiquement.

---

Câblage

Consultez le guide de câblage pour connaître les GPIOs à connecter selon votre carte :

• Pinout Waveshare ESP32-H2-Zero

---

Installation dans Zigbee2MQTT

Le converter externe expose toutes les entités de l'appareil dans Z2M : ventilateur, lumière, minuterie, bip, direction, température de couleur, et capteurs de température / humidité.

→ Guide d'installation Z2M complet

---

Installation dans ZHA (Home Assistant)

Le quirk custom permet à ZHA de reconnaître l'appareil et d'exposer les entités natives Home Assistant.

→ Guide d'installation ZHA complet

---

Dépannage

En cas de problème en fonctionnement (LED ambre, commandes sans effet, bootloop, capteur DHT muet…), consultez le guide dédié :

→ Guide de dépannage