Transformez votre ventilateur Tuya en appareil Zigbee natif, pilotable depuis votre box domotique favorite.
| Fonction | Contrôles disponibles |
|---|---|
| Ventilateur | Marche/arrêt · 6 niveaux de vitesse |
| Lumière | Marche/arrêt · Température de couleur en cycle (cran suivant : Froid→Neutre→Chaud→…) |
| Minuterie | Préréglages 1h / 2h / 4h · Décompte visible en temps réel · Réinitialisation automatique à off en fin de décompte |
| Son | Activation / désactivation du bip de confirmation |
| Direction | Mode Été (brassage vers le bas) · Mode Hiver (remontée d'air chaud) |
| Comportement après coupure | État de la lumière et du son configurables (éteint / allumé / bascule / restauration) |
| Température / Humidité | Lecture de la température et de l'humidité ambiante — nécessite un capteur DHT11/DHT22 (optionnel, voir câblage) |
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 à
offlorsque 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.
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.
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 :
| Valeur | Comportement |
|---|---|
off |
Toujours éteint au démarrage |
on |
Toujours allumé au démarrage |
toggle |
Inverse l'état précédent |
previous (défaut lumière) |
Restaure l'état avant la coupure |
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é.
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.
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.
La LED RGB intégrée indique l'état du module en temps réel :
| Couleur / comportement | Signification |
|---|---|
| 🟠 Orange (ramping) | Démarrage en cours |
| 🔵 Cyan clignotant (0,5 s) | Recherche d'un réseau Zigbee (appairage) |
| 🟢 3 flashes verts | Appairage réussi |
| 🔴 Rouge clignotant rapide | Échec de connexion, nouvelle tentative |
| 🟡 Ambre (1 s on / 2 s off) | Mode dégradé — MU ventilateur injoignable |
| 🟠 Orange clignotant | Réinitialisation en attente (bouton maintenu) |
| ⚫ Éteinte | Fonctionnement normal |
- 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.
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.
Consultez le guide de câblage pour connaître les GPIOs à connecter selon votre carte :
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
Le quirk custom permet à ZHA de reconnaître l'appareil et d'exposer les entités natives Home Assistant.
→ Guide d'installation ZHA complet
En cas de problème en fonctionnement (LED ambre, commandes sans effet, bootloop, capteur DHT muet…), consultez le guide dédié :