Method coverage (P3017): family × method
Generated by scripts/kb/method-coverage.js from lib/zigbee/MethodCoverage.js. ✅ = implemented and applied, — = not applicable (reason below), ❌ = missing.
| # | method | group | implementation |
|---|---|---|---|
| M1 | read.zcl_attr | read | lib/zigbee/MethodChain.js → standardReadSteps |
| M2 | read.ef00_dp | read | lib/zigbee/MethodCoverage.js → refreshCapability |
| M3 | read.private_cluster | read | lib/zigbee/MethodCoverage.js → PRIVATE_READS |
| M4 | read.alt_endpoint | read | lib/zigbee/MethodChain.js → standardReadSteps |
| M5 | read.polling | read | lib/zigbee/FallbackChains.js → readSensorWithFallbacks |
| M6 | read.dataquery_0x03 | read | lib/zigbee/MethodChain.js → standardReadSteps |
| M7 | read.derived | read | lib/zigbee/MethodCoverage.js → DERIVED |
| M8 | write.zcl_cmd_to_dp | write | lib/zigbee/CapabilityCommandRouter.js → writeCapabilityWithFallbacks |
| M9 | write.attr_vs_cmd | write | lib/zigbee/CapabilityCommandRouter.js → writeCapabilityWithFallbacks |
| M10 | write.mfr_specific | write | lib/zigbee/ZclFrameHeader.js → parseZclHeader |
| M11 | startup.magic_packet | startup | lib/zigbee/TuyaMagicPacket.js → sendTuyaMagicPacket |
| M12 | startup.time_sync_0x24 | startup | lib/zigbee/.tuya/TuyaMcuTimeService.js → buildEf00TimePayload |
| M13 | startup.reporting_to_polling | startup | lib/zigbee/FallbackChains.js → readSensorWithFallbacks |
| M14 | unknown.unsupported_memory | unknown | lib/zigbee/UnsupportedRegistry.js → getRegistry |
| M15 | unknown.interpreter | unknown | lib/zigbee/UnknownCommandInterpreter.js → interpretDp |
| M16 | unknown.learning | unknown | lib/zigbee/UnknownLearning.js → teach |
| M17 | unknown.flow_event | unknown | lib/zigbee/.flow/UnknownCommandFlowCards.js → register |
| M18 | chain.failover_winner | chain | lib/zigbee/MethodChain.js → runChain |
| M19 | chain.reprobe_backoff | chain | lib/zigbee/MethodChain.js → BACKOFF_MS |
| M20 | chain.never_remove_caps | chain | lib/zigbee/MethodChain.js → runChain |
| family | M1 | M2 | M3 | M4 | M5 | M6 | M7 | M8 | M9 | M10 | M11 | M12 | M13 | M14 | M15 | M16 | M17 | M18 | M19 | M20 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| switch_plug | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| dimmer_light | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| cover | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| thermostat_trv | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| climate_sensor | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| motion_presence | ✅ | ✅ | — | ✅ | ✅ | ✅ | — | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| ias_contact_water_smoke | ✅ | ✅ | — | ✅ | ✅ | ✅ | — | — | — | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| button_remote | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | — | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| meter_din | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| valve_irrigation | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| siren | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| lock | ✅ | ✅ | — | ✅ | ✅ | ✅ | — | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| fan | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| soil | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | — | — | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Why some cells are "—"
- Private-cluster read (M3): only where Z2M/ZHA define a private attribute for that capability (E001 power-on, genOnOff 0x5000 backlight, closures 0xF000 moving state, E002 alarm thresholds).
- Derived (M7): only computable capabilities (power = V × I, current = P / V, alarm_battery ≤ 20 %, onoff ⇐ power > 0.5 W). Never written back to the device.
- Write methods (M8–M10): sensor-only families (IAS, soil) have nothing to write; remotes only have the 0x8004 mode write (M9, P3019). Manufacturer-specific writes only exist where a private cluster exists.
- Write failover never races EF00 DPs against ZCL on multi-gang ZCL switches (cross-link lesson, P92.122/CapabilityCommandRouter).
P3019: per-cell justification
Every cell that is not ✅, and every ✅ that comes from a P3019 complementary layer (optional, never required at pairing, never removes anything). Re-checked against Z2M tuya.ts, ZHA quirks, deCONZ DDF, kkossev, SmartThings Edge, tuya-local/localtuya/tinytuya, Johan + forks.
| family | method | status | justification / source |
|---|---|---|---|
| cover | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| thermostat_trv | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| thermostat_trv | M10 write.mfr_specific | — | TRV settings are EF00 DPs (M8); no private-cluster write sourced |
| climate_sensor | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| motion_presence | M3 read.private_cluster | — | radar/PIR settings travel as EF00 DPs (M2), no private ZCL attribute in Z2M/ZHA |
| motion_presence | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| motion_presence | M10 write.mfr_specific | — | radar settings are EF00 DPs (M8); no private-cluster write sourced |
| ias_contact_water_smoke | M3 read.private_cluster | — | IAS zone only; Tuya extras (sensitivity DP9) are EF00 DPs, covered by M2 |
| ias_contact_water_smoke | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| ias_contact_water_smoke | M8 write.zcl_cmd_to_dp | — | sleepy IAS sensors; sensitivity DP9 is read-only in the drivers (no sourced write path) |
| ias_contact_water_smoke | M9 write.attr_vs_cmd | — | sleepy IAS sensors; no writable attribute used by Z2M for this family |
| ias_contact_water_smoke | M10 write.mfr_specific | — | no manufacturer-specific write found for this family in Z2M/ZHA/deCONZ |
| button_remote | M3 read.private_cluster | ✅ (P3019) | genOnOff 0x8004 tuyaOperationMode read (TS004F family, passive + one read for new devices); source: z2m tuya.ts TS004F operation_mode (genOnOff tuyaOperationMode 0x8004); ZHA TuyaSmartRemoteOnOffCluster |
| button_remote | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| button_remote | M8 write.zcl_cmd_to_dp | — | remotes have no capability to command; mode change is an attribute write (M9) |
| button_remote | M9 write.attr_vs_cmd | ✅ (P3019) | genOnOff 0x8004 attribute write when the user changes button_mode (writeAttributes, then raw fallback); source: z2m tuya.ts TS004F operation_mode (write genOnOff tuyaOperationMode) |
| button_remote | M10 write.mfr_specific | — | E001 0xD020 switch_mode belongs to wall switches (TS0726/TS0012), not remotes |
| meter_din | M10 write.mfr_specific | — | DIN meters use EF00 DPs or standard ZCL; no private-cluster write sourced |
| valve_irrigation | M10 write.mfr_specific | ✅ (P3019) | 0xE001 setCountdown 0xFE (HZ-WT02, TS0049 _TZ3000_kz1anoi8), opt-in setting ts0049_water_countdown; source: z2m tuya.ts HZ-WT02 manuSpecificTuyaE001 setCountdown 0xFE (tzLocal/fzLocal.ts0049_countdown) |
| siren | M10 write.mfr_specific | — | sirens use EF00 DPs or IAS WD; no private-cluster write sourced |
| lock | M3 read.private_cluster | — | Tuya locks use EF00 DPs (M2) or standard doorLock; no private ZCL attribute sourced |
| lock | M7 read.derived | — | none of the family capabilities can be computed from siblings (alarm_battery is not derived: project rule, never both alarm_battery and measure_battery) |
| lock | M10 write.mfr_specific | — | locks use EF00 DPs or doorLock; no private-cluster write sourced |
| fan | M10 write.mfr_specific | — | fans use EF00 DPs or fanControl; no private-cluster write sourced |
| soil | M7 read.derived | — | no derivable capability (moisture/temperature/battery are measured) |
| soil | M8 write.zcl_cmd_to_dp | — | calibration DPs exist (Z2M) but Homey soil settings are software offsets: writing them too would apply the offset twice |
| soil | M9 write.attr_vs_cmd | — | sleepy EF00-only sensor: no ZCL attribute to write |
| soil | M10 write.mfr_specific | — | no private-cluster write for soil sensors in Z2M/ZHA |
Write through another endpoint
Evaluated in P3019 and not added: no source (Z2M, ZHA, deCONZ, kkossev) needs a write on a second endpoint for a single-endpoint device, and on multi-gang devices a fallback endpoint could switch the wrong gang. Reads may use the alternate endpoint (M4); writes stay on the capability endpoint.
Chain order and behaviour
zcl-native → zcl-raw-numeric → tuya-dp → tuya-private → alt-endpoint → poll → magic-query → derived (lib/zigbee/MethodChain.js). Unsupported (0x81/0x84/0x86/0xC3) demotes at once; timeout demotes after 2 in a row; other errors fail over without demotion. A demoted method is re-probed after 15 min, 1 h, 4 h, 12 h, then every 24 h. The winner is remembered per device (store method_chain_state, at most 60 domains). Capabilities are never added or removed by the chain. Entry points: device.refreshCapabilityChain(cap), readSensorWithFallbacks(..., { failover: true }) (used by the reporting → polling fallback), writeCapabilityWithFallbacks.