Universal Tuya docsHomeSupported devicesRequest a deviceFAQChangelogArchitectureKnowledge baseCreditsSourcesContributing

Couche clusters ZCL (P2931, 2026-10-21)

Module : lib/zigbee/cluster/ (accès paresseux via index.js). Tests : test/zcl-cluster-layer.test.js.

Manques trouvés

  1. Double enregistrement 0xEF00 : Cluster.addCluster() de zigbee-clusters 2.6 écrase par ID et par NAME (« le dernier gagne »). 26 drivers enregistrent au chargement l'ancienne classe lib/TuyaSpecificCluster.js (11 commandes) par-dessus la canonique lib/clusters/TuyaSpecificCluster.js (20 commandes : mcuSyncTime, sceneWakeup, dpStatusUpdate, 0x0B–0x0F…). Selon l'ordre de chargement, la synchro d'heure et le réveil de scène disparaissaient.
  2. La canonique onMcuSyncTime appelle this.timeSync(); les écouteurs de l'événement legacy timeSync n'étaient plus servis avec la canonique.
  3. pollControl (pas de checkIn/checkInResponse) et ota (aucune commande client) sont incomplets dans zigbee-clusters 2.6.
  4. Aucun BoundCluster pour colorControl, windowCovering, groups, pollControl, ota, time ; une commande inconnue est rejetée (unknown_command_received) sans être capturée.
  5. Pas de planificateur de liaisons borné, ni de repli « polling » borné quand configureReporting échoue, ni de décodeur de trames brutes indépendant du registre.

Correctifs

Sources (réécrites)

zigbee-clusters (Cluster/BoundCluster/Endpoint) et doc SDK Athom ; spec ZCL 07-5123 ; zigbee-herdsman (types, presets de reporting) ; ZHA/zigpy quirks (repli code fabricant, liaison au réveil) ; deCONZ ; app de Johan (un BoundCluster par cluster) ; Z2M #26078 (séquence mcuSyncTime).

Reste à faire

Brancher RoutedBoundCluster.bindAll, BindingPlanner et ReportingPlan dans les classes de base (aujourd'hui bibliothèque opt-in), après observation de la fusion du registre sur un vrai appareil.

P2935 — branchement (2026-10-21)

← Knowledge base index · source