Credits & Acknowledgments
Core Framework
- Athom BV - Homey SDK3, node-homey-zigbeedriver, node-zigbee-clusters
- Homey Developer Documentation - apps.developer.homey.app
SVG Icons & Image Assets
- athombv/homey-vectors-public - Official Homey SVG vector icons for device capabilities and UI elements
- Joolee/Homey-SVG-Icons - Community-maintained SVG capability icons for Homey devices
Tuya Protocol References
- JohanBendz/com.tuya.zigbee - Original Tuya Zigbee app for Homey (TuyaSpecificClusterDevice, DP constants, sub-devices)
- Koenkk/zigbee-herdsman-converters - Z2M device definitions and Tuya converters (P3066 DP tables: TS0601_din_2, BAC-001, TS0601_knob_dimmer_switch, EcoDim ED-10032 whiteLabel; facts only, own code)
- zigpy/zha-device-handlers - ZHA Tuya quirks (zhaquirks/tuya/)
- jasonacox/tinytuya - Tuya local protocol implementation
- make-all/tuya-local - Tuya Local for Home Assistant (YAML config DP mappings)
- rospogrigio/localtuya and forks (e.g. xZetsubou/hass-localtuya) (GPL-3.0) - localtuya and forks: inspiration only, no code copied. Behaviour notes in our own words:
docs/automation/localtuya-study.md. - dresden-elektronik/deconz-rest-plugin - deCONZ Tuya support and Data Point Protocol documentation
Community Contributors
- Bastien house diagnostics, 2026-11-06/07 (redacted, P3265) — ideas only, no log text copied into the repo. Repeated
JSON.parseout-of-memory on a two-byte source while the heap sat near 56MB (file not named by the stack), and a sleepy_TZ3000_vsxvaj9i+TS0043remote whose Basic read failed locally and was then followed by a raw frame. Ours: nativeJSON.parsekept; a bounded label/size note on large loads; nosendFrameafter that failure on an exact sleepy-button profile. The crash cause is not claimed fixed. - AreAArseth/com.hobeian - Hobeian Zigbee devices
- drenso/com.tuya2 - TypeScript Tuya cloud app (OAuth2 patterns)
- JohanBendz — develop-0.4 engineering notes, reimplemented in our own code (no code copied): unknown-DP log flood guard (#1501), colour-temperature safe range + best-effort vendor RGB mode (#1502), read-only relay power-on sync (#1503), TH05Z identity without sleepy Basic reads (commit 71fc1e29), TH01Z MCU time requests (commit d78ab90a), knob Level Control bound cluster (commit 9045a3c4).
- P3065 Flow uplift (2026-10-26), ideas only, no code copied — Homey SDK docs (device-filter, dropdown, titleFormatted card model); Johan Bendz's Tuya Zigbee app (card families); Home Assistant device automations and the community adaptive-lighting integration (pause / is-active / chosen colour temperature); ZHA quirks (
zhaquirks/const.pypress-type vocabulary: short/double/long press, long release, scene recall); Zigbee2MQTT exposes (per-button1_single/1_double/1_holdaction enums, TS0215A alarm remotearm_*/disarm/emergency). All reimplemented as our own generic, brand-free, local cards. - gpmachado (
gpmachado/com.gpm.homesuite, GPL-3.0, ideas only — no code copied) — availability last-seen persist + boot grace, rejoin vs timeout (device_rejoined), lifecycleonUninitteardown, Poll Control skip on sleepy nodes, Homey settings over ZCL dump, jitter/TX pacing (no thundering herd), inching/power-on/backlight re-apply, interview-driven sacred couples, settings-as-labels, connected-devices grouping, rejoin-history settings tab, hide dead firmware settings. Dual-app tags in.ai/KNOWLEDGE_CACHE.json→recentDiscoveries.homesuite. HomeSuite itself credits StyraHem / s-dimaio (Homey.Sonoff.Zigbee) and JohanBendz — acknowledged as HomeSuite’s upstream, not copied here. - Rick_D (SHS Device Watchdog, Homey Community topic 157537, ideas only — no code copied, P3028) — learned per-device reporting gap with a minimum observation period (posts 781378, 781761, 783688), buttons/remotes excluded from silence staleness (773003, 772612), flap + many-devices-at-once hints (760791, 760906), old battery reading = device quiet, not battery low (773565), transient 1 % low-battery dips (770561). Ours: frame-level last seen, raise-only and capped timeouts, bounded per-device stats in
lib/managers/availability-learning.js. - makleso6, Jan_Z and TedTolboom (Homey Community topic 156, posts 791200, 791317, 791557; athombv/node-homey-zigbeedriver#194, P3029) — makleso6 and Jan_Z found that per-cluster ZCL sequence numbers restart at 1 on every app start and that some firmwares then drop frames silently; TedTolboom confirmed it. Ours: one counter per device continued across restarts in
lib/zigbee/ZclTsnContinuity.js, own code. - Cadabi (Homey Community topic 160757, post 788018, P3029) — tested couple
_TZB210_3zfp8mki+ TS0505B, kept on a single driver (pin test); topic added to the read-only forum scan. - andiwirz - Protocol auto-detect, DP discovery tool
- iBush (Switcher app for Homey, community t/160624) - ideas only, our own code: timer-for-a-set-time card, time-left token / timer-running trigger, auto-shutdown, child-lock, correct-known-AC-state.
- Steve_Wilson (t/101901 #8) - interview of the Zemismart 214C valve (
_TZE284_vuwtqx0t); with Kigrou (zigbee-herdsman-converters#10636, Z2MTS0601_water_valve) and Zemismart (zemismart-zha-quirks214c.py) as the DP sources for P2864. DP tables only, no code copied. - Istvan_Mag, Kizabgd, marosk, Dragan_Todorovic (topics 140352 / 26439) - Developer Tools / interview data for
_TZE284_gnpflcoq,_TZE284_9ern5sfh,_TZE200_fl8cuafl,_TZE200_crq3r3la; julianjwong (zha-device-handlers#5286) for the corrected gnpflcoq DP table. - seikossss (t/140352 #2268) - request and fingerprint for the NEO NAS-WV05B2-L sprinkler timer (
_TZE284_z7a2jmyy/ TS0601), matched to the Z2Mneo.tsdefinition. - rebtor - TuyAPI local control
- jurgenheine - Cloud API patterns
- robertklep/homey-tuya-zigbee - Community Tuya Zigbee
- codetheweb/tuyapi - Node.js Tuya API
- blakadder/zigbee - Zigbee device database
Flow card inspiration (inspiration, no code copied)
Public app.json flow card lists were read to decide which generic cards to offer (P2775). The cards are our own implementation.
- JohanBendz/com.tuya.zigbee (MIT) - siren/window/button card set
- Drenso/com.tuya2 - per-channel on/off triggers and conditions, child lock and night-mode actions
- shaarkys/com.xiaomi-miio - "no motion for N minutes", "value is between" and button-gesture cards
- chaosfish/com.xiaomi-mi-zigbee (fork of the Xiaomi/Aqara Zigbee app) - device information action
- athombv/com.ikea.tradfri-example - reference structure for Zigbee driver flow cards
Homey Community Forum Contributors
- dlnraja - App author, primary maintainer, TITAN Protocol architect
- Peter - Issue #2090 (HOBEIAN water leak sensor), active device reporter
- JohanBendz - Original Tuya Zigbee app author (com.tuya.zigbee), foundational patterns. His 2026 issue triage ("Batch" consolidation comments with exact device identities, acceptance objectives and known regressions, e.g. #423/#424 click-window request) is indexed as leads in
data/leads/johan-canonical-index.json(read-only, links kept); thanks also to every reporter whose Homey interviews he preserved. - Community members - All forum contributors who reported issues #2091, #5472, #388, #383, #420, #417 and requested device support
- Reddit communities - r/homey, r/zigbee, r/homeautomation for cross-platform device knowledge
Forum-Based Device Reporters
- P3144: Homey Community Apps category (https://community.homey.app/c/apps/7), read-only digests. "Smart Garage Control" thread (https://community.homey.app/t/149230) — report that a TS0603
_TZE608_xkr8gep3opener pairs but does not move; fixed per Zigbee2MQTTtuya.ts(DP1 = raw trigger). Inspiration only, no code copied.
- motren — device interview of the TS0044 scene remote
_TZ3000_pd9mpyh4(JohanBendz/com.tuya.zigbee#1534); placed onscene_switch_42026-10-25 - OMGatito — Meian TS0224 siren
_TZ3000_cipibmnp(JohanBendz#465); placed onsiren2026-10-12 - Peter - HOBEIAN ZG-222Z water leak sensor (Issue #2090)
- Community - MMWave radar motion sensor (Issue #420)
- Community - Bed sensor verification (Issue #383)
- Community - Rain sensor _TZ3210_tgvtvdoc (Issue #388)
- Community - Multiple fingerprint additions (Issue #417)
Multi-Manufacturer Device Support
- Tuya ecosystem - One manufacturer produces thousands of device variants
- Z2M/ZHA communities - Cross-reference database for DP mappings
- Homey Community Forum - Real-world device reports and testing
Repositories Studied
- JohanBendz/com.tuya.zigbee - TuyaSpecificClusterDevice, DP constants, sub-devices
- Koenkk/zigbee-herdsman-converters - Z2M Tuya converters, modernExtend patterns
- zigpy/zha-device-handlers - ZHA Tuya quirks (zhaquirks/tuya/)
- jasonacox/tinytuya - Tuya local protocol implementation
- make-all/tuya-local - Tuya Local for Home Assistant (YAML config DP mappings)
- dresden-elektronik/deconz-rest-plugin - deCONZ Tuya Data Point Protocol
- athombv/node-homey-zigbeedriver - Official Zigbee driver framework
- athombv/node-zigbee-clusters - ZCL cluster implementations
- athombv/com.ikea.tradfri - Reference Homey Zigbee app
- athombv/homey-apps-sdk-issues - SDK issue tracker and workarounds
- athombv/homey-vectors-public - Official SVG vector icons
- Joolee/Homey-SVG-Icons - Community SVG capability icons
- codetheweb/tuyapi - Node.js Tuya local API
- blakadder/zigbee - Cross-platform Zigbee device database
- gpmachado/com.gpm.homesuite - GPL-3.0 study only (no code copied): availability, rejoin, onUninit teardown, Poll Control skip, settings-as-labels, connected-devices grouping, jitter / no mesh flood
Device Database
- zigbee.blakadder.com - Cross-platform device fingerprints
- Zigbee2MQTT Supported Devices - 5473+ devices from 577+ vendors
- CSA IoT - Zigbee certified products (csa-iot.org)
- Zigbee2MQTT - 5473+ device definitions from 577+ vendors
Advanced Feature Inspirations
- Bayesian presence scoring - Academic research on multi-sensor fusion for occupancy detection
- Battery health monitoring - NASA Battery Health Management research (capacity fade, RUL estimation)
- Zigbee mesh topology - Zigbee Alliance mesh networking specifications; Zigbee2MQTT network map (LQI colour bands, coordinator/router/end-device roles, graphviz map_options) — ideas only
- Homey Community thread “Zigbee Route map” (Martijn Poppen
com.homey.map.mesh) — last-used routes on Homey Pro 2016–2019 only; not available on Homey Pro 2023, so this app’s settings spider is a passive last-hop / inferred layout, not a ZDO neighbor dump - Energy monitoring - Smart meter standards (DLMS/COSEM) for consumption tracking
- Signal triangulation - Indoor positioning research using RSSI-based localization
Documentation Sources
- Homey SDK3 Documentation - apps.developer.homey.app
- Zigbee Cluster Library (ZCL) - Zigbee Alliance specifications
- Tuya Developer Platform - developer.tuya.com
- Node.js Best Practices - Node.js official documentation and community patterns
Smart Features Ecosystem (v9.0.4xx, P92.10x)
- zigbee2mqtt availability feature — device online/offline monitoring with per-power-source timeouts, adapted as passive
DeviceAvailabilityManager(flow triggersdevice_became_unavailable/device_back_online, condition, report action) - ZHA availability timeouts — mains/battery timeout model (2 h / 6 h), cross-checked against our 15 min / 24 h choice
- Philips Hue / Hue Zigbee app (JohanBendz sdk3) — adaptive lighting, natural light emulation, wakeup ramps (
AdaptiveLightingManager,TransitionEngine) ; flow actions Alert/Blink (notrelight_alert_blinkvia ZCL Identify + fallback impulsions avec restauration d'état) et suppress_sensor (notreSensorSuppressionManagercentralisé, avec filtrage motion-only et auto-expiration) - SmartThings Edge drivers — device health/watchdog patterns for predictive alerts (
PredictiveHealthEngine)
Device coordinator (spec 003) — ideas only, no code copied
- JohanBendz Tuya Zigbee apps — per-device debounce of repeated Tuya reports and scene/onOff button duality observed in user threads
- Koenkk/zigbee-herdsman-converters — ZCL transaction-sequence based duplicate detection and per-device debounce options
- zigpy/zha-device-handlers — Tuya quirks handling duplicate DP reports and remote press types
- dresden-elektronik/deconz-rest-plugin — button event de-duplication across clusters
- rospogrigio/localtuya (GPL-3.0, study only) — DP update coalescing behaviour
Our implementation (lib/coordinator/*, data/coordinator-profiles.json) is original MIT code.
Upstream thread intelligence (spec 009) — ideas only
- Johan Bendz and the reporters of JohanBendz/com.tuya.zigbee #797, #1246, #1284, #964/#1423, #1291/#1214, #1461 — physical interviews and triage of standard-ZCL temperature/RH sensors (exact-pair matching, TS0601 without 0xEF00, unknown battery cells). Our rules:
docs/rules/JOHAN_797_STANDARD_ZCL_TEMP_RH.md. - Johan Bendz and the reporters of JohanBendz/com.tuya.zigbee #1298, #414, #1486, #1315 (PR #1508) — interviews of HOBEIAN ZG-102ZL /
_TZE200_pay2byaxcontact+lux sensors; Koenkk/zigbee-herdsman-convertershobeian.tsfor the DP layout. Our rules:docs/rules/JOHAN_1298_CONTACT_LUX.md. - Johan Bendz and the reporters of JohanBendz/com.tuya.zigbee #1113, #1475, #1008, #925 — physical interviews showing one eWeLink/SNZB-03 identity used by a PIR and a water detector, and the "disambiguate by IAS zoneType" approach. Our rules:
docs/rules/JOHAN_1113_AMBIGUOUS_IAS_IDENTITY.md. - Johan Bendz, Mariano Colmenarejo (SmartThings Edge window-treatment), KiwiHC16/Abeille, kkossev / RamSet (Hubitat Zemismart blind) and Koenkk (zigbee-herdsman-converters) — identification of
_TZ3000_4uuaja4aas a TS130F curtain module. Our rules:docs/rules/FP_TZ3000_4UUAJA4A_CURTAIN_MODULE.md. - Johan Bendz (#473, #1288, #1172, PR #1505), zigpy/zha, u236/homed, ioBroker.zigbee — identification of
_TZ3000_o9f2zqln(IAS rain),_TZ3000_p26flek3(TS0001 relay) and_TZ3210_iystcadi(Lidl light bar). Our notes:docs/rules/JOHAN_GAPS_2026-10-04.md. - Koenkk/zigbee-herdsman-converters (nous.ts SZ-T04, tuya.ts iHseno ZC-W1 / ZY-ZTH02) and Johan Bendz (lcdtemphumidsensor_3 time sync) — facts only:
locansqnclock answers from 1970, Zbeacon TS0201/TS0202/TS0203 are temperature/humidity sensors (P3080, our own code). - Homey community forum users of T140352 / T26439 — device reports distilled into
data/forum/forum-leads-ssot.json(links only). - Tuya Smart Life app — inching/pulse relay mode (
device_pulseavec restauration d'état), random timing anti-cambriolage (notrePresenceSimulationManager), countdown timers (notredevice_countdown_offavec fallback minuteur logiciel), cycle timing (notredevice_cycleON/OFF ×N avec restauration), power-on behavior - Hubitat Mode Manager / SmartThings location modes — home modes day/evening/night/away (
HomeModeManager), en version pilotée par l'élévation solaire réelle avec priorité au choix manuel - ZCL standard (Zigbee Cluster Library) — Identify cluster (
light_alert_blink), LevelControlmoveToLevelWithOnOff(light_smooth_dim) — chaîne de fallback systématique natif → Tuya DP → émulation logicielle (FeatureFallbackRouter) couvrant les 431 drivers - TinyTuya (jasonacox) — protocoles 3.1-3.5 (AES-GCM v3.5), scanner UDP ports 6666/6667/6668/7000, modèle de retry de connexion — base de notre WiFi local-first et du pairing automatique 1 clic
- codetheweb/tuyapi — client TCP Tuya (sessions, heartbeat, commandes DP)
- Hubitat Rule Machine — generic condition/trigger composition inspiration (
ConditionEngine,condition_all_met) - openHAB Zigbee binding (EPL-2.0) — attribute reporting intervals research
- Jeedom / Home Assistant — availability and energy dashboard UX patterns
Community Forks & Contributors (audited 2026-08)
- packetninja/com.tuya.zigbee — backlight control methods v5.5.929 (DP15/DP16/DP101-104, countdown DP7-9), Bseed switches — integrated
- Diddern / onesilop / map1981 — 2026-08 JohanBendz PRs #1439 Wing TS0203, #1437
_TZ3000_k6fvknrrdual outlet, #1435 HOBEIAN ZG-305Z; Dooya DP1 command path reimplemented in UnifiedCoverBase (P217) - ErnieV/com.tuya.zigbee — Quoya M515EGBZTN curtain support (position inversion, DP16 upper/lower limits) + Zbeacon TS011F plug energy routing — integrated
- map1981/com.tuya.zigbee — Dooya curtain driver exploration
- onesilop, MalmFredrik, arjanlemmers, MartijnEisses, macmonty, pixelwiese, Robsta86, pkuijpers, bmalkow — forks audited for device additions
- gpmachado/com.gpm.homesuite (GPL-3.0, studied — original reimplementation only) — Zemismart/NovaDigital/Sonoff field behaviour: availability last-seen, rejoin, onUninit teardown, Poll Control skip, settings-over-dump
- Jocke_Wallen — Moes TS0044
_TZ3000_kfu8zapdremote (forum #2098-2104) - blutch32 — HOBEIAN ZG-303Z soil sensor pairing variants (forum #2101)
- Nigel_Scott — HOBEIAN ZG-204ZP/ZK presence
_TZE200_ka8l86iu(forum #2112, issue #382) - Br0kk85 (forum #5538) + Koenkk/zigbee-herdsman-converters
hobeian.ts+ zigpy/zha-device-handlerstuya_motion.py+ kkossev Hubitat mmWave — HOBEIAN ZG-204ZMHOBEIAN/_TZE200_2aaelwxk/_TZE200_tyffvoij/_TZE200_yflzeeqjDP types (DP107 bool, DP122 enum) (P3141) - Johan Bendz — JohanBendz/com.tuya.zigbee PR #631 / issue #604:
_TZ3000_bjawzodf/TY0201 LCD sensor rejects configureReporting (P3141) - Koenkk/zigbee-herdsman-converters
src/devices/hobeian.ts— ZG-204ZMstatic_detection_distancestep 0.01 m (DP4 divideBy100); indicator/backlight DPs =valueConverter.onOffon ZG-204ZV/ZH/ZE/ZQ/ZK/ZX and ZG-302ZM/ZL;anti_interferenceonOff on ZG-204ZK DP122 / ZG-204ZX DP103; ZG-204ZX DP108 indicator (P3155) - Joep_Vullings — Insoma 2-way irrigation valve
_TZE284_fhvpaltk(forum #2102/#2105, issue #260) - FrankP — TS0042 2-button remote
_TZ3000_tzvbimpqrouting (forum #1689/#1745) - thierry_arguimbau —
_TZE204_dhotiauwdual energy meter (forum #2115) - Tobias-B, Lucas360, Rikjes, tlink, Or36, vikino, Cam, Haadeess, Lachee, Mikko_Vayrynen, Ronald_Bok, xfiler, DominikPL, robertklep — diagnostic reports that drove crash fixes
Tooling & Free Data Channels (integrated 2026-08)
- Panniantong/agent-reach (MIT) — free agent channel layer; its web channel routes to Jina Reader, RSS channel powers our forum RSS cross-check workflow (
agent-reach.yml) - Jina AI Reader (r.jina.ai) — keyless free web reader, tier-1 fallback of
lib/scraper/reader-fallback.js - firecrawl/firecrawl-mcp-server (MIT) — scrape/search; used as budget-capped tier-2 fallback (FIRECRAWL_DAILY_MAX, free tier protected) and keyless MCP endpoint
- Exa (via mcporter MCP) — free keyless semantic search channel
- yt-dlp — media metadata channel (Agent Reach backend)
- homey-api / Athom Apps API — build/crash statistics, delegation token flow (mapped in
docs/HOMEY_DEV_PORTAL_MAP.md) - Kimi Code CLI + WebBridge — autonomous CI repair, portal cartography, forum operations
Tuya Wi-Fi Local-First (Smart Life / white-label, 2026-10)
Sources actually used or consulted for the Wi-Fi local stack (lib/tuya-local/):
- tuya/tuya-device-sharing-sdk (MIT, © 2023 Tuya) — ported to JavaScript in
TuyaSharingClient.js: Smart Life "User Code + QR" login, request signing and AES-GCM envelope. Lets users fetch local keys without a Tuya IoT developer account. - make-all/tuya-local (MIT, Jason Rumney and contributors) — consulted: QR flow (
cloud.py,config_flow.py), public client id /haauthorizeschema, QR payload format, device fields. - Home Assistant core – Tuya integration (Apache-2.0) — consulted: sharing client id / schema constants (facts only).
- codetheweb/tuyapi (MIT) — runtime dependency: LAN protocol 3.1–3.5 including 3.4/3.5 session-key negotiation.
- jasonacox/tinytuya (MIT) — consulted: 6699 frame layout and optional return code (
message_helper.py), UDP discovery keys, scanner/wizard behaviour. - tuya/tuya-connector-nodejs — consulted for the OpenAPI signature string format (empty optional-headers line, sorted query). No code copied.
- andiwirz/com.tuyalocal (MIT) — Homey Tuya-local app: frequency-first protocol order, command gap, stale-data watchdog patterns (reimplemented earlier, credited in code).
- Drenso/com.tuya2, jurgenheine/com.tuya.cloud (MIT), rebtor/nl.rebtor.tuya (MIT) — earlier Homey Tuya apps whose cloud/LAN patterns informed the original design.
- Wi-Fi repair UX (P3072, 2026-10-27) — ideas only, written in our own words, no code copied: make-all/tuya-local (MIT), rospogrigio/localtuya / xZetsubou/hass-localtuya (GPL-3.0, study only) and jasonacox/tinytuya (MIT) all treat a DHCP IP change as normal: follow the device's UDP broadcast, keep one IP per device, and show reachability before asking for a new key. Our versions:
lib/tuya-local/LocalIpSettings.js,lib/wifi/LanRebindRouter.js,lib/tuya-local/LanRepairStatus.js(seedocs/knowledge/P3072_WIFI_UX.md).
IR blasters — Zigbee Zosung + Tuya Wi-Fi (P3063, 2026-10-26)
Own implementation in lib/ir/ZosungIRProtocol.js, lib/ir/TuyaWifiIRProtocol.js and lib/ir/IRFormatConverter.js; no upstream code copied:
- Koenkk/zigbee-herdsman-converters (MIT, Koen Kanters and the
zosung.tscontributors) — consulted: 0xED00 frame layout (msgpart + msgpartcrc), chunk sizes, Code00 resend, ZG-IR01 seq 0,{key_num,key1}message. - mildsunrise — Tuya IR code format notes — consulted: FastLZ-style block layout of Tuya
key_code. - jbouwh — Home Assistant Tuya IR encoder gist — consulted: literal-only encoding is the safe choice for cheap Tuya IR chips.
- jasonacox/tinytuya (MIT) — consulted:
IRRemoteControlDevicecontrol types 1/2,send_ir/study/study_exit/study_key, learned code on DP202 or DP2. - make-all/tuya-local (MIT, Jason Rumney and contributors) — consulted: single-DP
send_irJSON with"1"raw prefix, multi-DP send, split of long gaps.
Reports and automation (P3069, 2026-10-26) — ideas only, written in our own words
- GitHub — the job summary feature (
$GITHUB_STEP_SUMMARY) and its docs gave us the "one short page per run" format. - The Renovate and Dependabot maintainers — their PR bodies taught us to fold long detail into collapsed blocks and keep the top short.
- rhysd (actionlint) — static checks for every workflow; our hygiene and report ratchets follow the same "fail only on new debt" spirit.
- The Homey Community forum moderators and the Zigbee2MQTT / ZHA trackers — their habit of linking to a post instead of pasting it is the rule our reports now follow: ID, link, author, then a summary in our words (
scripts/lib/report-writer.js). - GitHub Actions docs (concurrency groups) — the one-running, one-waiting rule behind our Node 22 setting: pushes let the running job finish, PRs still cancel (
docs/knowledge/CI_CONCURRENCY.md); now also on the seven push-triggered checks listed there. - Athom Homey SDK docs, "Zigbee firmware updates" page (Athom docs team, https://apps.developer.homey.app/wireless/zigbee/zigbee-firmware-updates) — the line about firmware files being stored apart from the app and fetched only when an update starts is now told in our own words in
docs/knowledge/OTA_AUDIT_P2932.md, not pasted. - Community commenters on our issues (john1v, pemikalsen-sudo, Ssssneak, late4marshmellow, dalobalo and others) —
reports/COMMUNITY-INTELLIGENCE.mdno longer reproduces their comments; each entry keeps the author, the issue link and a one-line topic, so the original stays where they wrote it. Thank you for the reports. - No code was copied from these projects; the helper and the ratchet (
scripts/ci/report-structure-ratchet.js) are our own.
Licenses (SPDX)
| Project | License | Usage |
|---|---|---|
| JohanBendz/com.tuya.zigbee (upstream) | MIT | Origine du fork — attribution dans NOTICE |
| Koenkk/zigbee-herdsman-converters (Z2M) | MIT | Données factuelles DPs/empreintes |
| zigpy/zha-device-handlers (ZHA) | Apache-2.0 | Quirks Tuya, IDs corrompus documentés |
| dresden-elektronik/deconz-rest-plugin | BSD-3-Clause | DDF, Tuya Data Point Protocol |
| jasonacox/tinytuya | MIT | Protocole local Tuya (WiFi) |
| codetheweb/tuyapi | MIT | API locale Tuya |
| make-all/tuya-local | MIT | Mappings DP (YAML) |
| tuya/tuya-device-sharing-sdk | MIT | Porté en JS (TuyaSharingClient.js) — login QR Smart Life |
| home-assistant/core (Tuya) | Apache-2.0 | Constantes client id / schéma (faits) |
| andiwirz/com.tuyalocal | MIT | Patterns Homey Tuya local (réimplémentés) |
| jurgenheine/com.tuya.cloud | MIT | Patterns cloud Homey |
| rebtor/nl.rebtor.tuya | MIT | Patterns tuyapi Homey |
| blakadder/zigbee | MIT | Base de données d'empreintes |
| athombv (SDK3, zigbeedriver, zigbee-clusters) | MIT | Framework |
| OpenHAB Zigbee binding | EPL-2.0 | Recherche intervalles de reporting |
| SmartThings Edge drivers | Apache-2.0 | Patterns Tuya DP |
| gpmachado/com.gpm.homesuite | GPL-3.0 | Study only — no code copied; behaviour reimplemented under MIT |
| tesseract-ocr/tesseract | Apache-2.0 | CI only — OCR local et gratuit des captures d'écran (boucle de feedback), installé sur le runner, non embarqué |
| ImageMagick | ImageMagick License | CI only — prétraitement des images avant OCR (niveaux de gris, agrandissement, seuil), non embarqué |
| arendst/Tasmota | GPL-3.0 | CI only — recherche d'issues publiques pour le jeu de données de quirks firmware ; aucun code repris |
| ioBroker/ioBroker.zigbee | MIT | CI only — recherche d'issues publiques (quirks firmware) ; aucun code repris |
Voir NOTICE à la racine pour les attributions complètes. Les empreintes, numéros de datapoint et comportements protocolaires sont des données factuelles d'interopérabilité (non copyrightables) ; tout le code original de ce dépôt est sous MIT (voir LICENSE).
Inspiration
- All community members who reported issues and requested devices
- The Homey community forum contributors
- Home Assistant, Hubitat, SmartThings, openHAB and Jeedom community forums — public device-behaviour reports read (capped, read-only) to build the firmware-quirk dataset
- Drenso and Athom (athombv) — public Homey app CI workflows (validate / publish / version actions) studied as workflow patterns
- Reddit r/homey, r/zigbee, r/homeautomation communities
- GitHub issue reporters who help improve device compatibility
- The open-source Zigbee community for protocol documentation and device databases
- romasku/tuya-zigbee-switch device_db, pvvx (Zbeacon TS0001 notes), lsroka76/Z2S_Library supported-devices list — couple evidence (2026-10-04)
- Athom B.V. — Matter Bridge app (github.com/athombv/com.athom.matter-bridge, GPL-3.0): class/capability to Matter device-type mapping summarised in our own words in
data/matter-bridge-mapping.json(read 2026-10-04, commit 045787d). No code copied. - Source registry (W10, 2026-10-04): Koen Kanters + zigbee2mqtt / zigbee-herdsman-converters contributors, zigpy (ZHA, zha-device-handlers), dresden elektronik (deCONZ), rospogrigio + xZetsubou (localtuya), Jason Rumney (tuya-local), blakadder, Mariano (SmartThings Edge), Krassimir Kossev (Hubitat), KiwiHC16 (Jeedom Abeille), u236 (HOMEd), Athom B.V., Johan Bendz and fork authors, Homey Community Forum, Tuya developer docs — identifiers and our own summaries only, see data/sources/registry.json.
- X scan 2026-10-04 (our own summaries in
docs/knowledge/FIELD_NOTES_2026-10_X_SCAN.md, no code copied): Somfy developer docs (Somfy-Developer/Somfy-TaHoma-Developer-Mode), Mick Vleeshouwer / iMicknl (pyoverkiz, MIT) and the Home Assistant Overkiz integration (Apache-2.0) — "My" position and cover behaviour ideas; LiXee / Akila, faire-ca-soi-meme.fr (ZLinky_TIC, LiXee-Box v2.22 notes); devbis (z03mmc); Gonzague Dambricourt; Jasmine Mannan (XDA); J. Stabentheiner; Home Assistant blog (ubisys); zhaoxuya520 (reverse-skill routing pattern →skills/ROUTING.md); home-assistant-libs/tuya-device-handlers (MIT, source registry); the "everything-claude-code" (ECC) Claude Code setup as described by @S0N_IA (agent-config scan idea -> P2800 gate, own implementation). - Covers P2801/P2802 (2026-10-04, own implementation, no code copied): paced execution queue, closure+orientation step and Identify ideas from Mick Vleeshouwer / iMicknl (pyoverkiz, MIT) and the Home Assistant Overkiz integration (Apache-2.0); ZCL Identify 0x0003 / Window Covering 0x0102 (Connectivity Standards Alliance spec) —
lib/covers/CoverCommandQueue.js,lib/covers/CoverTahomaActions.js. - Covers P3030 (2026-10-25, own implementation, no code copied): Adrian Rockall (AdyRock/com.somfy.tahoma, Homey community topic 35206, all 2792 posts read 25/10/2026) — "Is moving" condition and per-device "command complete" trigger with a success flag (#511, #761, #824, #2157), newer command replaces an unfinished one, duplicate suppression and retry of failed commands (v2.1.69, v4.0.68 notes, #826), delayed final position read after a move (#1079-#1087), string/number value mismatch (#244, #258, #1626) ->
lib/covers/CoverMotionTracker.js,lib/covers/CoverCommandQueue.js,lib/covers/normalizeDpScalar.js. - #108 placements (2026-10-04, own implementation): couples and DP layouts from zigbee-herdsman-converters by Koen Kanters and contributors (tuya.ts TOQCB2-80 / TS0601_6gang_switch / GX03, lonsonho.ts TS130F, moes.ts ADCBZI01, rtx.ts ZVG1); 8-byte phase struct layout from valueConverter.phaseVariant2WithPhase (Z2M #18603, #32995) ->
lib/tuya/TuyaPhaseStruct.js. - #109/#108 exact-pair drivers and long-name couples (2026-10-04, own implementation): DP layouts and couples from zigbee-herdsman-converters by Koen Kanters and contributors (tuya.ts presence switches _TZE28C1000000_jlbsptkl/jaunkx9g/usmqzgdm and Semicom _TZE200_rgeapp2c, nous.ts D4Z, weten.ts PCI E, zemismart.ts, moes.ts, saswell.ts, onenuo.ts, neo.ts, avatto.ts, manhot.ts, iotperfect.ts) -> drivers/switch_presence_tuya, drivers/panel_switch_cover_tuya, lib/devices/TuyaDpProfileDevice.js, lib/tuya/TuyaDpProfileCodec.js.
- #100 source proposals (2026-10-04, own implementation): ZY-N1 sound sensor DP layout from zigbee-herdsman-converters tuya.ts (Koen Kanters and contributors) and zha-device-handlers PR #5386 (zigpy) -> drivers/sound_sensor_tuya; RGBCW floodlight DPs from Z2M issue #32498 (tigum27, andrei-lazarov); TS0002 startUpOnOff finding from Z2M issue #32627 (lucasbissaro); Zosung TS1201 couple from zha-device-handlers PR #5282.
- Gledopto GL-SPI-206P exact driver and safe-math repairs (2026-10-04, own implementation): DP layout and DP61 colour frame from zigbee-herdsman-converters gledopto.ts (Koen Kanters and contributors) -> drivers/led_controller_spi_tuya, lib/tuya/SpiPixelColour.js.
- PCr2-1 (2026-10-04): SONOFF MINI-ZBRBS (sonoff.ts) and HEIMAN RC-EF-3.0 / HM1RC-2-E (heiman.ts) identifiers from zigbee-herdsman-converters (Koen Kanters and contributors).
- P3080 (2026-10-27): dedicated driver
curtain_sonoff_mini_zbrbsfor SONOFF|MINI-ZBRBS — couple, standard Window Covering 0x0102 lift and spec orientation (coverInverted false) from zigbee-herdsman-converters sonoff.ts (Koen Kanters and contributors); clusters from the interview docs/data/interviews/MINI-ZBRBS__SONOFF.json. Own implementation, no code copied. - Spec 010 T0 notes (2026-10-04, own words): Homey Apps SDK v3 docs (Athom: app lifecycle, Node.js runtime table, Node 22 upgrade guide), athombv/node-homey-zigbeedriver and athombv/node-zigbee-clusters (Athom), JohanBendz/com.tuya.zigbee (Johan Bendz) -> docs/rules/R22_ARCHITECTURE_SOURCES.md.
- zigbee library backports (2026-10-04, own implementation): Time cluster 0x000A attribute ids from athombv/node-zigbee-clusters #216/#217 (Athom); finite transition duration and dim read-back grace from athombv/node-homey-zigbeedriver 2.2.18 (Athom) -> lib/zigbee/ZigbeeLibBackports.js.
- PCr2-2/PCr2-4 interview facts (2026-10-04): normalized from device interviews shared on the Homey community forum and GitHub issues (JohanBendz/com.tuya.zigbee and dlnraja/com.tuya.zigbee reporters); cluster names for 0xFC00 (Philips) from zigbee-herdsman-converters (Koen Kanters and contributors) -> docs/data/interviews, data/native-matrix.json.
- PCr2 #43 Johan PR evaluation (2026-10-04): OWON THS317-ET-TY couple from JohanBendz/com.tuya.zigbee issue #1007 interview and PR #1230 (Jerome) -> drivers/temphumidsensor.
- P2810 placements (2026-10-10, identifiers and interviews only, own wording): JohanBendz/com.tuya.zigbee issues #15, #163, #211, #614, #830, #1013, #1030/#1145, #1035, #1165, #1265/#1366, #1330, #1484 (Johan Bendz and the reporters of those threads, incl. Batch 62/96/105/107 triage); zigbee-herdsman-converters by Koen Kanters and contributors (lonsonho.ts, tuya.ts, hobeian.ts, zemismart.ts); blakadder (Lonsonho QS-Zigbee-D02-TRIAC-2C-LN page); Mariano (Mariano-Github/Edge-Drivers-Beta fingerprints, Livarno TS0505A). Free forum screenshot OCR uses tesseract-ocr (Apache-2.0) as an external tool.
- Daily resume 2026-10-11 (own implementation and wording): forum topic 140352 reports by VicHY (#2246–#2255, MTG075 Flow lag), Peter (#2238/#2239, Smartbutton History), EdP (#2258, AOYAN AY-303Z soil) and Michaelp (#2253, ZG253 TRV) — https://community.homey.app/t/140352; identifiers and DP layouts cross-checked in zigbee-herdsman-converters
hobeian.ts(CS-201Z with AOYAN AY-303Z/AY-302Z white-labels, ZG-106Z) andtuya.ts(TS0222 light sensor, TS0601_thermostat_3) by Koen Kanters and contributors. - Issue #560 TRV06 (2026-10-18, own wording): artisare (GitHub issue dlnraja/com.tuya.zigbee#560) and zigbee-herdsman-converters tuya.ts TS0601_thermostat_3 (Koen Kanters and contributors); Koenkk/zigbee2mqtt#25093 comments by MichaelHainbach and Jonstep101010 (DP35 fault bitmap, DP102 unconfirmed). bjawzodf/TY0201: Wilhelm Dall (Homey app suggestion 2026-10-17) and Z2M WSD500A. No code copied.
- P2868/P2869 (2026-10-19, own implementation and wording): ZG-101ZD knob behaviour from zigbee-herdsman-converters hobeian.ts and lib/tuya.ts (Koen Kanters and contributors), zha-device-handlers ts004f.py (zigpy), deCONZ smart-knob DDF (dresden elektronik), JohanBendz/com.tuya.zigbee smart_knob_switch (Johan Bendz); RSH-HS03
_TZE284_9ern5sfhfrom Z2M tuya.ts, zigbee-herdsman-converters #10167 (r-e-t-e-p), JohanBendz #1328 (AGabriel) and forum 140352 #2263 (Kizabgd). - P2870/P2871 (2026-10-19, own implementation and wording): BoundCluster dispatch behaviour from athombv/node-zigbee-clusters (Athom); ERS-10TZBVK-AA /
_TZ3000_4fjiwwebknob identity from zigbee-herdsman-converters tuya.ts (Koen Kanters and contributors), zha-device-handlers ts004f.py (zigpy) and the deCONZ smart-knob DDF (dresden elektronik).
- P2890 (2026-10-19): the 6-button Tuya scene remote
_TZ3000_nrfkrgf4/ TS0046 was identified thanks to the Zigbee2MQTT project (generic TS0046 six-button definition with single/double/hold per button) and the deCONZ project (a dedicated device file and button map for this exact maker: buttons on endpoints 1 to 6, press type carried by the Tuya OnOff command). Requested by a Homey Pro 2023 user. - P2910 (2026-10-20, own implementation and wording):
_TZ3000_rco1yzb1click behaviour from JohanBendz/com.tuya.zigbee #423/#424 (reporters RogerGorissen, Tanjis, fransjvos; maintainer Johan Bendz, Batch 89b) and Zigbee2MQTTlidl.tsHG08164 (Koen Kanters and contributors); Flow argument lookup from the Homey Apps SDK v3 docs (Athom). Couples: LoraTap SS6400ZB and Lidl HG06338 from zigbee-herdsman-converterstuya.ts/lidl.ts;_TZ3000_5ftkaulgfrom zigpy/zha-device-handlers#2090 (amiraizat124) and u236/homed-service-zigbee#146 (yaadyaad); Alecto SMARTCOA10 interview on JohanBendz #977 (Maxjong30201); Nedis CO sensor from the SmartThings Edge driver by Mariano_Colmenarejo (report by Ville_Rahkonen); Lidl strip symptom on JohanBendz #127 (jellelambers, martijnpieters). No code copied. - P2919 (2026-10-21, own wording): exact native couples read from Homey interviews and device settings posted on JohanBendz/com.tuya.zigbee #190 (HEIMAN SmokeSensor-EF-3.0, interview relayed by Johan Bendz from forum 26439#2296), #284 (Samotech SM311, HenryMD18) and #422 (eWeLight ZB-DL01, keesverruijt). No code copied.
- HEIMAN HM1RC-2-E keyfob (
HEIMAN/RC-EF-3.0, driverheiman_keyfob): ids and button meaning from Koenkk/zigbee-herdsman-converters PR #2182 by arnaud-gouder (https://github.com/Koenkk/zigbee-herdsman-converters/pull/2182) and dresden-elektronik/deconz-rest-plugin #3828. Own implementation (P2921). - HEIMAN HS2WD-E siren (
HEIMAN/HeimanxWarningDevice/WarningDevice-EF-3.0, driverheiman_siren): genBasic dump in Koenkk/zigbee-herdsman-converters #3429 (https://github.com/Koenkk/zigbee-herdsman-converters/issues/3429), Koenkk/zigbee2mqtt #1416, deCONZ DDF #6400 by BabaIsYou (https://github.com/dresden-elektronik/deconz-rest-plugin/pull/6400). Own implementation (P2921). - Aqara RTCGQ13LM precision motion sensor (
LUMI/lumi.motion.agl04, drivermotion_sensor, native Occupancy Sensing 0x0406): interview from dlnraja/com.tuya.zigbee issue #25; model name and cluster use from Koenkk/zigbee-herdsman-converterssrc/devices/lumi.ts(RTCGQ13LM). Own implementation (P2929). - P2922 (2026-10-21, own wording):
3A Smart Home DE/LXN59-2S7LX1.0(Zemismart ZW-EU-02) from the Homey interview on JohanBendz/com.tuya.zigbee #575, model confirmed by Zigbee2MQTT (Koenkk/zigbee2mqtt #3905, lostpoint-ru);iHorn/LH02121motion sensor from the Homey interview on forum 26439#4851. No code copied.
- P2923 (2026-10-21):
_TZE2841000000_8se38w3c/ TS0601 (TZ-ZT01_GA4 long-name variant) added to climate_sensor; DP3 battery_state enum mapping shared with ZT08. Reported by okidoki, Homey Community topic 140352 post #2265 (https://community.homey.app/t/140352/2265); DP layout from Zigbee2MQTT tuya.ts TZ-ZT01_GA4 (Koenkk).
P2930 — WiFi/local and protocol versions (2026-10-21)
- make-all/tuya-local (Jason Rumney, MIT, commit 95300d05ac) — product_id → DP facts extracted by our own script; source config recorded per product.
- jasonacox/tinytuya (MIT) — protocol 3.1–3.5 and the 3.22 alias, wizard export format.
- codetheweb/tuyapi (MIT) — CONTROL_NEW / DP_QUERY_NEW for 3.4+.
- rospogrigio/localtuya, xZetsubou/hass-localtuya (GPL-3.0, study only) — single-client limit, sub-device cid.
- rospogrigio/localtuya, xZetsubou/hass-localtuya (GPL-3.0, ideas only, own code, P3080 2026-10-27) — opt-in LAN options in
lib/tuya-local/LocalTuyaOptions.js:reset_dpids(re-ask listed DPs after a failed status, bounded + cooldown),restore_on_reconnect(re-send mapped DP values after a reconnect, opt-in),manual_dps(ask for DP ids missing from status, opt-in),passive_start(wait for the device UDP broadcast before connecting, opt-in, 10 min fallback). Keys are read from device settings or store; declared off by default in the shared settings template.homeycompose/drivers/settings/localtuya_advanced.json("Advanced" group, en/fr/de/nl,$extendsin the 31 TuyaLocalDevice Wi-Fi drivers). - PlusPlus-ua/ha_tuya_ble — BLE protocol versions (documentation only).
- Koenkk/zigbee-herdsman-converters (MIT) — EF00 command ids, appVersion layout.
Details: docs/knowledge/WIFI_LOCAL_PROTOCOLS_P2930.md.
- zigpy/zha-device-handlers (Apache-2.0) and dresden-elektronik/deconz-rest-plugin (BSD-3) — Tuya time answer / MCU version behaviour (P2933, own code).
- P2932 (2026-10-21) OTA audit, own implementation: Tuya EF00 MCU OTA frame layout from Koenkk/zigbee-herdsman
src/zspec/zcl/definition/cluster.ts(manuSpecificTuya 0x12-0x15); image index and SHA512 from Koenkk/zigbee-OTAindex.json; provider and validation order compared with zigpyzigpy/ota/providers.py; Tuya MCU serial OTA 0x0A/0x0B from Tuya developer docs (MCU standard protocol, "MCU OTA Update"); Homey SDK "Zigbee Firmware Updates" for the server role and manifest rules. - Aqara DJT11LM vibration sensor (
LUMI/lumi.vibration.aq1, drivervibration_sensor, native Closures 0x0101 attributes 0x0055 event, 0x0503 angle, 0x0505 strength): attribute meaning from Koenkk/zigbee-herdsman-converterssrc/lib/lumi.ts(lumi_vibration_analog, DJT11LM insrc/devices/lumi.ts) and the ZHA xiaomi vibration quirk (zigpy/zha-device-handlers). Optional overlay, own implementation (P2934).
- P2951 (2026-10-21)
_TZ3000_dfgbtub0/TS0042→button_wireless_2(2-button wireless): identity from Koenkk/zigbee-herdsman-converterssrc/devices/tuya.ts(TS0042 whitelabel Marmitek Push_LO), blakadder/zigbee Eardatek ESW-0ZAC-EU, JohanBendz/com.tuya.zigbeewall_remote_2_gang. The sacred_TZ3000_dfgbtub0/TS0044 couple stays onbutton_wireless_4(forum 156967#12); TS0042 was matched by no driver before. Fingerprints only; own code.
Knowledge base sources (P-KB)
Facts (ids, DP numbers, model names) indexed with commit-pinned links; no prose or code copied. Full list and licences: docs/knowledge/KB_SOURCES.md.
- Koenkk — zigbee2mqtt.io docs (GPL-3.0), zigbee-herdsman-converters (MIT), zigbee-OTA index
- zigpy — zha-device-handlers (Apache-2.0); dresden-elektronik — deCONZ DDFs (BSD-3-Clause); blakadder — zigbee templates (MIT)
- make-all — tuya-local (MIT); jasonacox — tinytuya (MIT); rospogrigio — localtuya (GPL-3.0); JohanBendz — com.tuya.zigbee (GPL-3.0)
- Athom — node-zigbee-clusters, Homey Apps SDK docs; Tuya — developer docs (MCU/Zigbee serial protocol)
- P2958 (2026-10-21): dedicated drivers for Z2M padded fingerprints AOYAN AY204T / AY222Z and BlitzWolf BW-IS9
_TZ3000_eit7p838(Koenkk/zigbee-herdsman-converters: hobeian.ts, tuya.ts PR #12488 by zyjsmile857, blitzwolf.ts). - P2970 (2026-10-24) Beca BAC-006AZB fan-coil thermostat (
_TZE204_dzuqwsyg/TS0601, sibling_TZE200_dzuqwsyg) moved towall_thermostatwith a BAC-002 DP profile (DP16 setpoint in whole °C, DP4 preset, DP101 schedule blob): reported by Umberto Maffii (Homey app store suggestion); DP meanings from Koenkk/zigbee-herdsman-converterssrc/devices/tuya.ts(BAC-002-ALZB, whitelabel Beca BAC-003) and Koenkk/zigbee2mqtt discussion #25308 (BAC-006AZB identity). Own code. - P2971 (2026-10-24) Issue #560 TRV06
_TZE200_rxq4iti9"No active query method available" / "0/12 queries sent": diag by artisare (GitHub issue dlnraja/com.tuya.zigbee#560). Single query-all Tuya 0x03 dataQuery fallback (empty payload per Tuya MCU serial protocol and zigbee-herdsmanmanuSpecificTuya.dataQuery), never sent after a sleepy skip. Own code. - P3045 (2026-10-25) Issue #560 TRV06
_TZE200_rxq4iti9: artisare (GitHub issue dlnraja/com.tuya.zigbee#560) kept testing every build and reported the humidity tile that would not go away, the whole-degree readings and the missing battery value. Proof that this valve has no humidity sensor and only a low-battery flag: zigbee-herdsman-converters TS0601_thermostat_3 (Koen Kanters and contributors) and Koenkk/zigbee2mqtt discussion #24659 participants (whole-degree firmware). Own code and wording, nothing copied. - P3244 (2026-11-02) Issue #560 TRV06
_TZE200_rxq4iti9: artisare (GitHub issue dlnraja/com.tuya.zigbee#560) reported the setpoint and temperature stuck on whole degrees ("should be 21.3 / 21.7"). The earlier 1 °C snap was reverted to a 0.5 °C default learned per device from the setpoint echo. Sources: zigbee-herdsman-converters tuya.ts TS0601_thermostat_3 (Koen Kanters and contributors, setpoint step 0.5, DP4/DP5 divideBy10) and zha-device-handlers tuya_trv.py (tenths). Own code, nothing copied. - P3051 (2026-10-25) Issue #576 BSEED TS0601 curtain switch
_TZE200_yenbr4om(siblings_TZE200_bdblidq3,_TZE204_bdblidq3): thank you migueleap (GitHub issue dlnraja/com.tuya.zigbee#576) for the report. DP layout (DP1 state, DP2 position, DP3 arrived position, DP5/DP7 config, DP105 motor speed) from Koenkk/zigbee-herdsman-converterssrc/devices/bseed.ts(BSEED_TS0601_cover) and zigpy/zha-device-handlerszhaquirks/tuya/ts0601_cover.py;_TZE204_ogkdpgy2CO2 optional DP18 temperature struct / DP19 humidity from zigpy/zha-device-handlerszhaquirks/tuya/tuya_co.py. Facts only, code rewritten. - P2972 (2026-10-24) payload normalizer (COBS per Cheshire & Baker, "Consistent Overhead Byte Stuffing", IEEE/ACM ToN 1999; hex/base64/length-prefixed/BE-LE) and rain DP decoder: RB-SRAIN01 DP layout from Koenkk/zigbee-herdsman-converters
src/devices/tuya.ts; legacy TS0601 layout from issue #326. Own code. - P3010 (2026-10-24) Zigbee2MQTT Sep–Oct 2026 upstream couples, additive (Koenkk/zigbee-herdsman-converters):
_TZE200_gt1gge3xrain_sensor (PR #13340, jomders),_TZE284_uqzwwjas/_TZE284_zeeqkb0psmoke_sensor2 + DP15 battery % (avatto ZSD20, PR #13187, alblcl),_TZ3000_w5s3mbynswitch_1gang,_TZ3210_mldzab8wcurtain_motor,_TZ3008_avdpejnssmartplug; Mowe MW811D/MW794Z/MW815R (PRs #13132/#13209/#13130), ECODO PSL-24V/GU10/ECD-48V-MGT (PRs #13179/#13170/#13172) by Kenny Roger, Ledisons LDN22 (PR #13141, TheLexus), LUUMR 10010339 (PR #13243, Kai Stian Olstad). rain_sensor layout matcher fixed (substring containsCI instead of array includesCI) so the ZG-223Z and RB-SRAIN01 layouts are reachable. - P3011/P3012 (2026-10-24): includesCI(array,value) misuse fixed at 6 sites (Z2M hobeian.ts ZG-102ZL DP1 inverse; tuya.ts TS0601_soil DP5 raw);
_TZE28C1000000_rzdkn5rxre-claimed on boiler_switch_energy (Koenkk/zigbee-herdsman-converters #13211, Andy, 2026-09-16; Homey forum t/26439/5484, Michael_Hadjicosta). - P3013 (2026-10-24): dedicated master-only drivers rewritten from Koenkk/zigbee-herdsman-converters
src/devices/tuya.ts—sauna_thermostat_ae5503(_TZE204_eaasry7v, AE-5503-S-H-ZIGBEE, PR #13225 by Vadim Surpin, 2026-09-18),siren_moes_mg_bjq002(_TZE20C_tjz9ad5g, Moes MG-BJQ002, PR #13201 by Paap, 2026-09-16),switch_wall_6gang_metering(_TZE284_hbxadcl0, TS0601_6gang_switch_2, PR #13085 by hammondses, 2026-09-04),valve_novato_zpv01(_TZE284_zm8zpwas, Novato ZPV-01, tuya.ts ZPV-01 definition). - P3014 (2026-10-24) one driver per couple (owner decision): TS0049
_TZ3000_cjfmu5he/_TZ3000_mq4wujmp(Moes ZWV-YC, Koenkk/zigbee-herdsman-converterssrc/devices/moes.ts) and_TZ3000_kz1anoi8(Haozee HZ-WT02,src/devices/tuya.ts) kept on water_valve_garden, removed from smart_garden_irrigation_control; TS0601_TZE284_la2c2uo9kept on wall_dimmer_tuya with its Z2M TS0601 1-gang dimmer family (_TZE200_la2c2uo9Moes MS-105Z,src/devices/tuya.ts), removed from dimmer_1_gang_tuya. Recorded in curated-couple-removals + couple pins; paired devices keep their driver. - P3015 (2026-10-24) caseless kept drivers + runtime catalogue fix: TS0049 Moes ZWV-YC
_TZ3000_cjfmu5he/_TZ3000_mq4wujmp/_TZ3000_5af5r192/_TZ3000_ogjpfoyn(Koenkk/zigbee-herdsman-converterssrc/devices/moes.ts, commit eb823146c7) and Haozee HZ-WT02_TZ3000_kz1anoi8(src/devices/tuya.ts) on water_valve_garden with canonical/lower/UPPER forms;lib/tuya/fingerprints.jsonentries that pointed these ids to motion_sensor/climate_sensor/device_plug_smart (and_TZE200_la2c2uo9to dimmer_wall_1gang) now point to the compose owner, shards rebuilt;TuyaNormalizer.normalizestrips zero-width chars. Novato ZPV-01 (src/devices/tuya.ts"Battery powered smart valve":_TZE204_dsagrkvg,_TZE284_zm8zpwas,_TZE284_sdvbnmj5) grouped on valve_novato_zpv01, battery 4 x AA from the Novato catalogue (novato.com.tr) and the ZHA quirk shared by SimoHDK on community.home-assistant.io (thread 892596). me167 dpProfile condition now reads the manufacturer (AR331Pro layout fromsrc/devices/tuya.ts)._TZ3000_5af5r192forms removed from climate_sensor (no hardware source; Z2M lists it only as the Moes TS0049 valve), curated so bots do not re-add. - P3017 (2026-10-24) unknown commands + method chains: decoders from JohanBendz/com.tuya.zigbee#619 (
_TZ3210_cwamkvuaTS0202 DP101 press / DP102 dark-bright), private Tuya commands from Koenkk/zigbee-herdsman-converterssrc/lib/tuya.ts(eb823146c7) and zigpy/zha-device-handlers tuya quirks (1d6598c32a, TSN dedup, rotate stop); DP-name catalogue from Z2M tuyaDatapoints; fallback/polling/magic/time-sync methods studied in deCONZ, tuya-local, localtuya, tinytuya, kkossev Hubitat (ideas only), SmartThings Edge, ioBroker, Domoticz, Tasmota, ESPHome — all rewritten (docs/knowledge/KB/CROSS_APP_METHODS.md). - P3019 (2026-10-24) coverage review: ZS-SF00 decoder rewritten from Koenkk/zigbee-herdsman-converters
src/devices/tuya.ts(@1c90116); sinxpbrl DP2/DP6/DP7/DP101/DP102 from the Tuya schema posted by YoshiWalsh in Koenkk/zigbee2mqtt#31445 (reported by wiwill61) and JohanBendz/com.tuya.zigbee#1504 (martinheie-ui); HZ-WT02 TS0049 countdown (0xE001 cmd 0xFE) from Z2M tuya.ts; TS004F 0x8004 mode from Z2M and ZHATuyaSmartRemoteOnOffCluster; cluster 0x1888 checked against ZHATuyaZB1888Cluster(PR #2592, TheJulianJES). All rewritten. - P3018 (2026-10-24) every DP + every endpoint: per-couple DP names and value converters harvested from Koenkk/zigbee-herdsman-converters
src/devices/*.tstuyaDatapoints (MIT, commit cff1de4731; facts only — tokens like div:10 / trueFalse / lookup, decoder rewritten in lib/zigbee/DpCatalogDecoder.js); ZHA quirk DP numbers from zigpy/zha-device-handlers (Apache-2.0, 1d6598c32a); ZCL scaling (measuredValue/100, lux = 10^((v-1)/10000)) from the ZCL specification. air_purifier_soil DP5 ÷10 per Z2M TS0601_soil. Own code (docs/knowledge/KB/DP_ENDPOINT_COVERAGE.md).
GitHub issue reporters (P3020, 2026-10-24)
Reporters of dlnraja/com.tuya.zigbee issues not credited elsewhere in this file. Their reports (logs, fingerprints, symptoms) fed fixes and locks; issue numbers listed for traceability.
- @askseb — #30, #31
- @avanderwulp — #417
- @azkysmarthome — #126
- @bartagergely — #94
- @clementloridan — #198
- @cristianoisaac — #168, #169, #206
- @csmobiel — #101
- @dalobalo — #161, #162
- @DaPicardos — #328, #355, #360, #363, #367, #371, #378, #383, #388
- @DAVID9SE — #121
- @denis-papin — #571
- @Didiervu91 — #75
- @djfry134 — #92
- @Domingoso — #135, #275
- @draqlek — #554
- @DVMasters — #98
- @edwinvdp — #570
- @elgato7 — #117, #122
- @Ernst02507 — #113
- @eskilask-maker — #89, #107, #109
- @fcarrozzo — #99
- @finnamu — #513, #516
- @ftrueck — #338
- @gfi63 — #26, #27, #33, #108
- @gore- — #35
- @GXA064 — #25
- @Haellos07 — #77
- @HiepSVG — #547, #550
- @JeffreyOtten1234 — #95
- @jocke-sve-62 — #76
- @john1v — #188, #193, #194
- @johnx1971 — #165
- @kikosenra — #546
- @kircuvaloglu — #34
- @kodalissri — #28, #29, #32
- @kringloper — #324
- @l-i-n-k — #24
- @laborhexe0210 — #37
- @Lalla80111 — #114, #115, #124, #137, #314, #316, #333, #506, #559
- @late4marshmellow — #163, #164
- @luuk0412-wq — #23
- @MarceloSilvaLeite — #19, #20, #21, #536
- @migueleap — #540, #541, #542, #543, #544, #545, #551, #552, #553
- @MitchV94 — #129
- @mjolink — #96
- @Necka44 — #93
- @neeerd — #549
- @Nespouique — #531
- @NoroddH — #97
- @Patrickske1 — #79
- @PDominikPL — #305, #308, #331, #332
- @pemikalsen-sudo — #184, #302
- @pjmpessers — #102, #103, #104, #105
- @Pollepa — #110
- @Rickert1993 — #44
- @RidderGH — #420
- @ronaldbok — #172
- @rsalinger — #22
- @salvagr — #533
- @sinan92 — #43
- @Snacker80 — #183
- @snorro80 — #91
- @sondregjessing-blip — #428
- @speerke — #329
- @squizzeak — #424
- @Ssssneak — #170
- @stephanmaastricht — #511
- @Tauno20 — #127
- @telenut — #80
- @tencoo — #200
- @theunissendave — #88
- @tjoepatjoep — #260, #312
- @tknapstad — #78
- @vbesteiro — #171
- @Verectra — #87
- @vikinos — #276
- @vladivdv-bot — #317
- @Wuma68 — #128, #173, #174, #548
- @xDMcGee — #532
- @xSondreBx — #82, #83
- P3018b (2026-10-24) one couple = one driver: 21 TS0601/7016 couples that two drivers served now have one owner each, chosen from the exposes in Koenkk/zigbee-herdsman-converters (commit cff1de4731): HOBEIAN ZG-223Z rain
src/devices/hobeian.ts→ rain_sensor; Tuya DP dimmers_TZE200_4mh6tyyo/_TZE204_dcnsggvz/_TZE204_9qhuzgo0(tuya.ts) and AVATTO ZDMS16-1_TZE204_5cuocqty(avatto.ts) → dimmer_1_gang_tuya; covers_TZE200_bjzrowv2/_TZE284_r3szw0xrand KnockautX PIMS3028_TZE200_eqpaxqdv→ curtain_motor; Nous SZ-T04_TZE200_locansqn(nous.ts) → lcdtemphumidsensor; smoke_TZE200_ntcy3xu1→ smoke_sensor2; Semicom panel_TZE200_rgeapp2c→ panel_switch_cover_tuya;_TZE200_zl1kmjqxtemp/humidity → lcdtemphumidsensor_3; WETEN PCI E_TZE204/284_6fk3gewc(weten.ts) → wall_switch_1gang_1way; Tongou TOQCB2-80_TZE204/284_mrffaamu,_TZE284_9xstqowh→ smart_breaker; Nous D4Z_TZE204/284_loejka0i→ energy_meter_3phase; HOBEIAN ZG-205Z/ACK-BL702-MWS-01(7016)(hobeian.ts, ZHAtuya_motion.py) off vibration_sensor. Siterwell GS361A-H04_TYST11_jeaxp72v/ zigbeeModeleaxp72v(siterwell.ts) placed on device_radiator_valve. TS130F_TZ3000_cet6ch1rEP2 0x0102 = "to close" calibration per Z2Msrc/lib/tuya.tscover_options (EP1 to_open / EP2 to_close, time ÷10 s); listened passively. All rewritten, recorded in curated-couple-removals + couple pins. - P3018b soil (2026-10-24): real Zigbee soil sensors moved to soil_sensor from generic drivers — Tuya TS0601_soil
_TZE200_9cqcpkgb, TS0601_soil_3_TZE284_33bwcga2/_TZE284_3urschql(GIEX GX06)/_TZE284_ap9owrsa/_TZE284_nhgdf6qr(GIEX GX04)/_TZE284_wckqztdq, Arteco ZS-300Z/302Z/304Z_TZE284_k7p2q5d9/_TZE284_65gzcss7/_TZE284_yzr43ayq(Koenkk/zigbee-herdsman-converterssrc/devices/tuya.ts, cff1de4731). Facts only, rewritten. - P3018b DP sources (2026-10-25, own parsers, facts only — no code copied): per-quirk Tuya DP ids, attribute names and scalings from zigpy/zha-device-handlers (Apache-2.0, commit 1d6598c32a,
zhaquirks/**QuirkBuilder chains anddp_to_attributetables) and Tuya dpid/item/scaling rows from the dresden elektronik deCONZ REST plugin DDF files (BSD-3-Clause, commit a4c17adfa0,devices/**/*.json). They only fill DPs or converters Zigbee2MQTT (Koen Kanters and contributors) does not document for the exact couple.
Daily KB refresh 2026-10-25 (ideas and leads, no code copied)
- bkbartk — Tuya fan optimistic/typed-default write idea, esphome/esphome#18525
- make-all/tuya-local contributors (ozgurclcc PR #6308, surfnterd PR #6067 and others in 7169307…c6ea798) — Wi-Fi product ids and the signed RSSI byte rule (commit 0002e83), Wi-Fi leads only
- Koenkk/zigbee-OTA — OTA index checked at df5e8e1 (no new image)
Forum ideas pass 2026-10-25 (P3037, own words, no code copied)
- seikossss — NEO sprinkler
_TZE284_z7a2jmyyinterview and wrong-driver report, forum 140352 #2268; DP map facts from Koenkk/zigbee-herdsman-converterssrc/devices/neo.ts(commit eb77ec10e6, L145-256) - okidoki — exact long-prefix mfr
_TZE2841000000_8se38w3cseen on a climate sensor, forum 140352 #2265 - @migueleap —
_TZE200_yenbr4omcurtain module interview, GitHub #576 - Rick_D — Device Watchdog idea: no "device lost" notice during the startup grace period and at most one per day, forum 157537
Thank you — the projects behind the coverage matrix (P3039, 2026-10-25)
This app exists because many people documented Tuya devices long before we did, and shared it openly. The coverage matrix (scripts/kb/z2m-coverage.js, report docs/knowledge/Z2M_COVERAGE.md) reads only facts from their work: manufacturer + model identifiers, the capabilities a device offers and the Tuya datapoint numbers. Every couple keeps a link to where we found it. No code is copied; decoders are written in our own words. A heartfelt thank you to:
- Koenkk and the hundreds of Zigbee2MQTT / zigbee-herdsman-converters contributors: the most complete open map of Tuya devices there is, kept current almost daily. Most of what this app knows about Tuya datapoints started from your work (MIT).
- The zigpy / ZHA team and the zha-device-handlers quirk authors: careful, well-tested quirks that often confirmed or corrected what we thought a device did (Apache-2.0).
- dresden elektronik and the deCONZ DDF contributors: clear device description files that are a joy to read (BSD-3-Clause).
- Johan Bendz and everyone who contributed to the original com.tuya.zigbee Homey app and its forks: this app grew out of yours, and your issue tracker is still where many users first report a new device.
- blakadder and the contributors of the Zigbee device compatibility repository: the cross-platform catalogue that answers "who else supports this?" in one page (MIT).
- kkossev (Krassimir Kossev) and the Hubitat community drivers: patient, detailed reverse-engineering of Tuya radars, TRVs and sensors, with fingerprints we could trust.
- The SmartThings Edge driver authors, Mariano Colmenarejo in particular, and the SmartThings Community drivers team.
- The ioBroker.zigbee maintainers, the Zigbee for Domoticz team and the authors of the z4d-certified-devices catalogue, and arendst / the Tasmota Zigbee contributors for the Zigbee device templates.
- Projects we read for the separate Wi-Fi/LAN matrix (leads only here): make-all/tuya-local, rospogrigio/localtuya and its forks, jasonacox/tinytuya and the ESPHome community.
- Batch P3039b/c (nine new TS0601 drivers): the zigbee-herdsman-converters authors of the MakeGood (MG-AU03, MG-GPO02Z), Daewoo (WKE502Z keypad), Box (EWS1154-Z), Beca (BVRF-L001 VRF thermostat), AutomatOn (CH8Z) definitions, and the
tuya.tscontributors for the Tervix Pro Line X10 underfloor controller, the 3-channel bidirectional meter (p3g8xiug) and the TS0601 smoke sensor (yh7aoahi). Datapoints were reimplemented from your descriptions; no code copied. - Batch P3039d (class moves, one couple one driver): the
tuya.tscontributors of the DCR-CO carbon monoxide detector (7bztmfm1) and of the AVATTO ME168 radiator valve (cxakecfo): thanks to your definitions these devices now pair on a CO detector and a TRV driver instead of a plug and a contact sensor. - Batch P3039d lot B (one couple, one driver; truth key = exact manufacturer + product id): the
tuya.tscontributors of TS0601_smoke_4 (_TZE200_t5p1vj8r,uebojraa,vzekyi4c,dq1mfjug), TS0601_smoke_1 (_TZE204_ntcy3xu1, tamper DP), the TS0202 PIR_TZ3000_mwd3c2atand the Excellux ZG-104PLV PIR (PIRIV01): thank you, these smoke and motion sensors now pair on smoke / motion drivers instead of a wireless switch, a power strip, an irrigation valve and a motion relay. Thanks also to Koen Kanters and the Zigbee2MQTT community for the per-device fingerprints that let us check every couple one by one (own implementation, no upstream code copied). - Batch P3040 (smarter pairing): Anders_Bee (Homey forum topic 154959) for the advice to avoid bursts of radio traffic right after a device joins: the first-start reads, binds and reporting setups are now deduplicated, cached and paced. Thanks also to the Zigbee2MQTT
configureMagicPacketauthors for the read order of the Tuya basic attributes (own implementation, no upstream code copied). - Batch P3050 (Fingerbot Plus): Yannis Assael (iassael), a big thank you for PR #577. You tracked down why every command to the Moes Fingerbot Plus (
_TZ3210_j4pdtz9v/ TS0001) timed out: invalidsendDataarguments, a send cascade that keeps a sleeping device waiting, and a settings replay that blocks startup. You also tested the fix on your own Homey Pro. Your commit is merged as-is, and the same idea now covers the other Fingerbot Plus ids. Thanks also to the Zigbee2MQTT (TS0001_fingerbot), ZHA (tuya_fingerbot.py) and deCONZ (_TZ3210_dse8ogfy_fingerbot) authors for the DP matrix we checked against, and to dalobalo (#161, #162) and Joep_K (forum 140352) for the reports (own implementation, no upstream code copied). - Koen Kanters and the zigbee-herdsman-converters contributors - the second negative power encoding (plain 24-bit two's complement above 0x99999A, seen on some
_TZE200_nslr42ttunits) in packed phase DPs, used by P3060lib/tuya/TuyaNegPower24.js(own implementation, no code copied). - Batch P3064 (family uplift): Koen Kanters and the zigbee-herdsman-converters contributors for the datapoint layouts of the Tuya dual smoke & CO alarm (
TS0601_smoke_co, Moes JKD-513COM-Z), PA-44Z and GSKS-ZB smoke detectors, the MG-DIM02Z dimmer module, the SWS6TZ-WHITE 6-gang switch, the TOQCB2-80 breaker temperature and the Moes ZM7LT3 three-phase meter (own implementation, no upstream code copied). - Batch P3067 (smoke / CO family): Koen Kanters and the zigbee-herdsman-converters contributors (
moes.tsZSS-HM-SSD01), the zigpy/zha-device-handlers contributors (zhaquirks/tuya/tuya_smoke.py), blakadder (Moes ZSS-HM-SSD01 page) and the Hubitat Tuya Zigbee Smoke Detector driver authors, whose datapoint facts show_TZE200/_TZE204/_TZE284_vawy74yhis a smoke detector (own implementation, no upstream code copied). - Batch P3067 (radiator valves): Koen Kanters and the zigbee-herdsman-converters contributors (
avatto.tsME168_AVATTO) and Deennoo and the Domoticz Zigbee for Domoticz contributors (TS0601-ME168 model), whose datapoint facts show the ME168 layout of_TZE200_cxakecfo/ybsqljjg/4aijvczq/r5ksy7qo(own implementation). - Batch P3067 (covers): Koen Kanters and the zigbee-herdsman-converters contributors (
tuya.tsTS0601_cover_4, Moes AM43-0.45/40-ES-EB), whose datapoint list shows DP101/102 are opening mode / factory reset on the AM43. - Batch P3067 (buttons / keypads): Koen Kanters and the zigbee-herdsman-converters contributors (
daewoo.tsWKE502Z: hub-mode DP101, arm ACK DP23, start-up arm mode DP25, options DP103-111, user DP112;tuya.tsTS0601_vibration_sensor) and the zigpy/zha-device-handlers contributors (_TZE200_kzm5w4izDP1/3/10) (own implementation, no upstream code copied). - Batch P3067 (lights): Koen Kanters and the zigbee-herdsman-converters contributors (
gledopto.tsGL-SPI-206P: DP3 white brightness, DP61 paint colour frame, DP53 pixel count, DP101 bead order, DP102 chip type, DP103 do not disturb;tuya.tsMG-DIM02Z DP143/144/146 and TS0601_knob_dimmer_switch DP106/141) (own implementation). - Batch P3067 (soil, breaker): Koen Kanters and the zigbee-herdsman-converters contributors (
hobeian.tsCS-201Z / ZG-303Z DP102/104/105/110-112 device-side calibration and sampling;tuya.tsZBN-DJ-63 DP1/6/9/15/16/103/110) (own implementation). - Batch P3067 (adaptive lighting): iGen (article of 26/10/2026 on sun-following lighting: inspiration only) and the Home Assistant adaptive_lighting custom component authors (idea of pausing after a manual change); colour temperature physical range from the ZCL Color Control cluster spec (own implementation, no code copied).
- Batch P3067 (energy estimates): the Home Assistant powercalc authors (idea of a per-brightness lookup table and standby power); default watts are our own approximations, each with its reason in
data/energy/default-power.json. - Batch P3067 (thermostat metering): the zigbee-herdsman-converters contributors (
tuya.tsAETZ01_AC, TWC-R01, TH-P1Z metering DPs and scales). - Batch P3068 (one couple, one driver): the zigbee-herdsman-converters contributors (
tuya.tsAETZ01_AC, ZG-103V, TS0601_fan_5_levels_and_light_5_levels;mercator.tsSISWD11-ZB) and Mercator Ikuü (SISWD11-ZB specification sheet). Facts only, own implementation. - Batch P3071 (DIN energy meters): the zigbee-herdsman-converters contributors (
tuya.tsTS0601_din_1, SPM01V1-GT, SDM01V1-GT, SDM02V1-GT, ATMS10013Z3 datapoint layouts). Facts only, own implementation. - Batch P3071c (HOCH RCBO): the zigbee-herdsman-converters contributors (
legacy.tshoch_din datapoints,tuya.tsTS0601_rcbo). Facts only, own decoder. - Batch P3077 (phantom couples, one couple one driver): the zigbee-herdsman-converters contributors (
miboxer.tsFUT038Z/FUT089Z,skydance.tsWZ5_rgb_1,lonsonho.tsTS130F_dual,zemismart.tsKES-606US-L4), the zigpy ZHA quirks contributors (lidl/TS0501A.py,tuya/ts0501bs.py) and Johan Bendz (rgb_bulb_E27, rgb_mood_light, rgb_led_strip_controller, lcdtemphumidluxsensor, dimmer_2_gang, plug lists). Batch 2: zigbee-herdsman-converterslidl.ts/tuya.ts/hobeian.ts, PR #3076 dmaasland and #3107 kloknibor, zigbee2mqtt issue reporters activa73 (#26084), jocamane (#11663), 1iverea9er (#7881), snp88 (#8500). Batch 4: zigbee-herdsman-converterstuya.tsTS130F whitelabels (LoraTap, BSEED, Zemismart, Danor, QA). Batch 5: the vendor string HOBEIAN from zigbee-herdsman-convertershobeian.ts(Koenkk and contributors) and the Homey community forum topic 140352 (heobian seen only as a typo). Batch 6: snp88 (zigbee2mqtt #8500), Johan Bendz (SDK3 README, 1 Gang Wall Remote), erickvneri (SmartThings edge fingerprints) for pzui3skt as a TS0041 button; zigbee-herdsman-convertershobeian.tsfor the ZG-101ZD knob. Batch 7: Koen Kanters (zigbee-herdsman-converters commit a118719) and the deCONZ DDF authors for the real Lidl blind id_TZB000_42ha4rsc. Batch 8: zigbee-herdsman-converterstuya.tsZG-101Z (Loginovo SOS button, DP26/DP29) and kkossev (Hubitat TS004F driver,_TZE200_nojsjtj2SOS button). Facts only, own implementation. Batch 9: zigbee-herdsman-converterstuya.tsTS0601_smoke_1 (Nous E8 smoke sensor, DP1/DP4/DP14) and TS0601_dimmer_5 (_TZE200_dcnsggvshort id), Koen Kanters and contributors. Facts only, own implementation. Batch 10: zigbee-herdsman-converterstuya.tsTS0601 dimmer list (_TZE200_4mh6tyyo) and the zigpy ZHA quirks contributors (tuya/ts0601_switch.py,_TZE200_amp6tsvy). Batch 11: the zigbee-herdsman-converters contributors (tuya.tsExcellux ZG-102MV/ZG-101K,sonoff.tsZbeacon TH01/DS01 whitelabels,lumi.tsWSDCGQ11LM/WSDCGQ12LM). Batch 12: the zigbee-herdsman-converters contributors (tuya.tsTS0502A whitelabels: Aldi LIGHTWAY, Mercator Ikuü SMI7040, MiBoxer PZ2/E2-ZR). Batch 13: the zigbee-herdsman-converters contributors (hobeian.tsZG-101ZD smart knob zigbeeModel and its TS004F fingerprints). Batch 14: the zigbee-herdsman-converters contributors (tuya.tsNEO NAS-WR01B TS011F plug) and the reporter of zigbee2mqtt #28729. Batch 15: the zigbee-herdsman-converters contributors (tuya.tsMarmitek Push LO TS0042) and the Homey forum topic 156967 reporter (dfgbtub0 TS0044 4-button). Batch 16: the zigpy/zha-device-handlers contributors (ts0601_switch.pyTuyaSingleSwitchTO, amp6tsvy 1-gang). Batch 17: the zigbee-herdsman-converters contributors (tuya.tsLUUMR C35 E14 tunable-white whitelabel, claeh5ds). Batch 18: PhilbyD (TS0013 3-gang interview, JohanBendz/com.tuya.zigbee#1330) and the zigbee-herdsman-converters contributors (lonsonho.tsQS-Zigbee-D02-TRIAC-2C-LN,tuya.tsNous A7Z). Batch 19: dresden elektronik deCONZ contributors (TS0207 water leak DDF, fxvjhdyl) and the zigbee-herdsman-converters contributors (Meian SW02, Aubess IH-K665); b20 Lidl HG06463A and Mercator SMFL20W-ZB (samuelabj, PR #6401; Rickert1993 on the Homey forum), Avatto ZDMS16-1 dimmer family. Stepyon (Zigbee2MQTT discussion #28060) and cruelacid (zigbee2mqtt.io PR #4205) for the _TZ3290_ixd9mvv4 TS0049 LYAI-14 valve id (kept as decided in batch 2). - And every forum member and GitHub issue reporter who sent a fingerprint, a diagnostic or a "this works now": you are listed by handle in the sections above, and new names are added with each batch.
Learning loop and upstream watch (P3073, 2026-10-26) — ideas only, no code copied
- Agent Reach (Panniantong, MIT) — the idea of reading many public channels through one read-only fallback; used only on the maintainer box, never in CI.
- Powercalc (Home Assistant community) — the idea of learning a device profile from repeated readings before trusting it.
- Zigbee2MQTT / zigbee-herdsman-converters, ZHA quirks, deCONZ, tuya-local, localtuya, tinytuya, Hubitat (kkossev), Home Assistant, Johan Bendz and the fork maintainers, Athom SDK — public projects followed "since last time"; anything found is rewritten in our words and credited before use.
Compose-faithful app.json resync (P3086, 2026-10-27) — idea only, no code copied
- Athom BV, homey CLI (
homey/lib/HomeyCompose.js) — the list of compose placeholders the composer replaces ({{driverId}}, {{driverPath}}, {{driverAssetsPath}}, {{driverName}});scripts/maintenance/sync-appjson-zigbee.jsnow applies the same substitution, written in our own code.
#585 wrong-driver couples (P3129 -> corrected by P3131, 2026-11-01) — fingerprint facts only, no code copied
- Koenkk, zigbee-herdsman-converters (
src/devices/tuya.ts) — hardware identity used to keep each couple on its right driver:_TZ3000_46vasa5hTS011F 2-gang wall outlet (double_power_point_2),_TZ3000_cehuw1lwTS011F/TS0121 plug (smartplug),_TZE284_xpq2rzhqTS0601 human presence sensor (presence_sensor_radar),_TZ3000_dfgbtub0TS0042 Marmitek Push_LO 2-button (button_wireless_2; TS0044 on button_wireless_4 is a user-attested couple, P2293). P3129 had wrongly listed dfgbtub0 under TS0043/button_wireless_3; P3131 removes it.
- P2936 cross-research (2026-11-01): exact couples placed from user evidence confirmed by public references (fingerprints only, own code, no copied converter logic): _TZE204_0hhou4yj/TS0601 → climate_sensor (github.com/Koenkk/zigbee-herdsman-converters/blob/7462b541b367c301057aee995e6e6756e5f7e985/src/devices/tuya.ts#L22073).
- SSOT couple-sources ledger (P3136) -
data/ssot/couple-sources.jsonrecords, per exact mfr+pid couple, links to the sources that confirm it: Koenkk/zigbee-herdsman-converters (src/devices/tuya.tsfingerprints and whiteLabel entries), zigpy/zha-device-handlers (zhaquirks/tuyasignatures) and JohanBendz/com.tuya.zigbee (driver listings, read-only). Only ids, model and vendor names are recorded; no code copied. - zigpy/zha-device-handlers #1746 / PR #2288 (evlo, MattWestb, javicalle, TheJulianJES, cordvision, Rojoss) - TS0042 signatures for
_TZ3000_dfgbtub0and_TZ3000_5e235jpa, the 0xFD press-type mapping and the no-bind battery rule, recorded as facts indata/ssot/curated-facts.json(P3136b). No code copied.
#585 runtime hints (P3134, 2026-11-01) — fingerprint facts only, no code copied
- Koenkk, zigbee-herdsman-converters (
src/devices/tuya.ts) — model ids used for the corrected hints:_TZ3000_46vasa5hTS011F,_TZ3000_cehuw1lwTS011F/TS0121,_TZE284_xpq2rzhqTS0601,_TZ3000_dfgbtub0TS0042.
- P3134 couple-removal guard: scripts/ci/couple-removal-guard.js + validate.yml step; a maker leaving a driver must keep every source-confirmed pid (data/kb/couples.json, reviewed duals) matched (#585, per exact couple).
- P3134 removal evidence (t730u): scripts/maintenance/couple-removal-evidence.js gathers Z2M/ZHA/deCONZ/Blakadder/Hubitat/Johan/forum/diags/git history/sibling pids into data/couple-removal-evidence.json; the guard (pre-push + validate.yml) blocks a removal without an entry. Rules: docs/rules/COUPLE_REMOVAL_EVIDENCE.md. _TZ3000_dfgbtub0|TS0044 marked unverified (forum 156967#12 lists TS0044 as _TZ3000_wkai4ga5).
- P3143: knob press dedup inspired by community reports in Johan Bendz's Tuya Zigbee forum topic 26439 (#5526-5537, _TZ3000_qja6nq5z/TS004F).
- P3170 power estimation models (linear / LUT / fixed vocabulary, left-Riemann integration idea): PowerCalc for Home Assistant by bramstroker — https://github.com/bramstroker/homeassistant-powercalc (concept re-implemented, no code or profile copied). Homey SDK Energy docs — https://apps.developer.homey.app/the-basics/devices/energy
- P3146 forum-table artifacts: forum 156967#12 and 150690#1 tables were cross-multiplied by the harvester. Removed per exact couple with evidence: _TZ3000_dfgbtub0|TS0044 (button_wireless_4), _TZ3000_wkai4ga5|TS0042 (button_wireless_2), _TZ3000_gbm10jnj|TS0044 (button_wireless_4). Kept the real couples dfgbtub0|TS0042 (button_wireless_2, Blakadder Eardatek ESW-0ZAC-EU), wkai4ga5|TS0044 (scene_switch_4, Rob_G interview 89271#653), gbm10jnj|TS0043 (button_wireless_3). New scan: scripts/maintenance/forum-table-crossproduct-scan.js. Thanks SunBeech, Relax_swe and Rob_G.
- P3190 _TZE2xx_iwn0gpzz|TS0601 moved climate_sensor -> power_meter (Tuya SPM01V2.5): Zigbee2MQTT/zigbee-herdsman-converters tuya.ts (DP map + polling, #30506), deCONZ devices/tuya/_TZE284_iwn0gpzz_energy_meter.json, make-all/tuya-local. Evidence in data/couple-removal-evidence.json.
- P3252 wrong-class moves (KB daily 2026-11-03):
_TZE200_ojzhk75b|TS0601to wall_dimmer_tuya (Zigbee2MQTT/zigbee-herdsman-converters tuya.ts TS0601_dimmer_1_gang_1, JohanBendz/com.tuya.zigbee wall_dimmer_tuya),_TZE200_wzk0x7fq|TS0601to vibration_sensor (zigbee-herdsman-converters hobeian.ts ZG-102ZM),_TZE284_qoi1aqxg|TS0601to curtain_motor (zigbee-herdsman-converters moes.ts FWJZCEH18A001). - P3253 wrong-class moves (KB daily 2026-11-03):
_TZE204_sdykkwsu|TS0601to dimmer_2_gang_tuya (Zigbee2MQTT/zigbee-herdsman-converters avatto.ts AVATTO ZDMS16-US-W2),_TZE204_zxkwaztm|TS0601to wall_thermostat (Zigbee2MQTT/zigbee-herdsman-converters moes.ts Moes ZHT-S03). - P3254 GitHub reply-language rule (all GitHub replies in English) requested by dlnraja.
- P3191 _TZE2xx_wbhaespm|TS0601 moved climate_sensor -> smart_breaker (SUTON STB3L-125-ZJ): zigbee-herdsman-converters tuya.ts, zigpy/zha device test tze204-wbhaespm, zha-device-handlers ts0601_power.py. Evidence in data/couple-removal-evidence.json.
- P3192 _TZE284_aao3yzhs|TS0601 battery 0 %: DP15 zero ignored while DP14 battery_state is not low. Sources: zigpy/zha-device-handlers #4288, #4519, #5126 (quirk uses DP15), Zigbee2MQTT #26215, deCONZ DDF (DP14 lowbattery). Thanks to the reporters.
- P3193 deCONZ DDF reader: dresden-elektronik/deconz-rest-plugin devices/tuya DDF files (read-only, per-path cursor). Thanks to the deCONZ contributors.
- P3194 test hygiene: mkdtemp dirs in p2920/p2437/p3048/p3019d tests removed on exit.
Pairing reports (P3200, 2026-11)
- hogseto (GH#581):
_TZ3000_yupc0pb7/ TS0201 listed but Unknown — exposed couples dropped by publish compaction. - stephanmaastricht (GH#584):
_TZE284_awepdiwi/ TS0601 soil sensor, diag 8742e6bd. - oletorv (GH#598):
_TZE284_9ern5sfh/ TS0601 LCD sensor, interview from Homey Self-Hosted + Bridge showing the node serves only 0, 4, 5, 0xED00, 0xEF00 (P3204: owner moved to lcdtemphumidsensor_3 so pairing binds only clusters the node has).
Publish baseline narrowing + driver continuations (P3206, 2026-11-02) — facts only, no code copied
- Homey SDK Zigbee docs (exact manufacturerName/productId matching) and the Homey community thread t/51187 (no productId wildcard) — basis for "no fallback driver" and for continuation drivers.
- Forum/GitHub reporters of #584, #581, #598 and the kb-compaction-losses couples — couples kept in the payload.
- P3223 (2026-11-02): lead/KB writers and the dual-couple audit read driver chains through DriverContinuations (firstNonFull / rootOf) — internal wiring, no new couples.
- P3227 (2026-11-02): zero-parasite packing plan (report only) — sources: data/kb, diag-ids, sacred-keep, P3055 attestations, mfs_db; rule 3 of DRIVER_CONTINUATIONS.md.
- P3228 (2026-11-02): climate_sensor_2 continuation (271 TS0601-only strong-sourced mfrs), held and folded back into climate_sensor while held — sources: data/kb, diag-ids, sacred-keep, P3055 attestations; rules 1-3 of DRIVER_CONTINUATIONS.md.
- P3229 (02/11/2026): climate_sensor_2 zero perte à la release — continuation réduite aux 3 fabricants dont le seul couple sourcé (toutes sources, mfs_db inclus) est TS0601 ; les continuations sont repliées avant compaction et re-séparées après à la release (budget inchangé) ; test p3229 release-loss = 0 pour chaque continuation tenue. Sources : data/mfs_db.json, couples sourcés, fixture Test package.
- P3236 (02/11/2026): toutes les continuations (climate_sensor_2, curtain_motor_2) aliasent leurs propres cartes flow vers les handlers du driver racine (ContinuationFlowAlias.contCardId, règle de nommage testée) ; test p3236
- P3233 (02/11/2026): curtain_motor_2 continuation — 2 fabricants (_TZE200_eegnwoyw, _TZE200_cpbo62rn) dont le seul couple sourcé (toutes sources, mfs_db inclus) est TS0601, tenue (hold) ; cartes flow propres aliasées vers le code racine (lib/drivers/ContinuationFlowAlias) ; test p3233
Dynamic adaptation (P3207, 2026-11)
- oletorv (GH#598):
_TZE284_9ern5sfh/ TS0601 "Unable to connect" — bindings on clusters the node lacks; led to runtime, descriptor-gated bindings for all drivers. - P3213: diag Log ID backfill + metering silence watchdog — thanks to the reporters of Homey diags fb5be1fe, 8742e6bd, c05db40d (Peter), af98752d, 6eabd9c4 (Michaelp); refs Z2M/ZHA metering & Tuya dataQuery.
- P3212 (2026-11-02): Saswell SEA801 TRV DP profile + fingerprints — Koenkk/zigbee-herdsman-converters saswell.ts
- P3213b (2026-11-02): MFR-ENSURE no longer persists driver manifest[0] placeholder (_TZE200_pay2byax on TS0203, diag c05db40d); MTG radar DP113/115/116 mapped per Z2M MTG075-ZB-RL (diag af98752d, VicHY). Source: Koenkk/zigbee-herdsman-converters tuya.ts.
- P3218 (2026-11-02): Moes SFL02 TS0601 switch fingerprints — Koenkk/zigbee-herdsman-converters moes.ts
- P3220 (2026-11-02): ZG-204ZX DP109 temperature_unit °F→°C — Koenkk/zigbee-herdsman-converters hobeian.ts
- P3237 (2026-11-02): deprecated (ids kept) device_plug_energy_monitor and sensor_lcdtemphumidsensor_temphumidsensor — no couple of their own; every sourced couple attributed to them (data/mfs_db.json sacredCouples) is owned by another driver compose. Pattern: Athom
deprecateddriver flag (apps.developer.homey.app). Test p3237. - P3238 (2026-11-02): CI gate scripts/ci/driver-signature-dup-gate.js — new driver with identical class+capabilities rejected unless a registered continuation or publish-hold driver; 225 existing drivers baselined. Test p3238.
- P3239 (2026-11-02): contact_sensor_2 held continuation — lumi.sensor_magnet / lumi.sensor_magnet.aq2 (6 spellings), whose only sourced couple among contact_sensor pids is TS0203 (data/mfs_db.json + sourced-couple corpus), moved with short pids TS0203/TY0203/DS01 (-228 combos). Test p3239.
- hogseto (GH#581): humidity 10x too low (4.27 % vs 42.7 %) on drivers bypassing the x10 quirk — P3245 shared ZclHumidityScale.
- P3243 (2026-11-02): CI learnings of 02/11 — full Node 22 suite incl. test/critical in pre-push + CI (tools/ci/mocha-flaky-retry.js: stale .homeybuild/build cleaned, --expose-gc, one isolated retry for the P2914/P3065 heap-flake allowlist, also in node-test-strict); scripts/ci/manifest-budget.js (app.json bytes, drivers, never-published, combos, P3227 parasite count; ratchet budget config/ci/manifest-budget.json) in ci-self-check + publish workflows; publish-hold-bisect records the Athom manifest-size-limit hypothesis (any never-published driver refused alone) + manifest trend + bounded learning ledger (P3097); scripts/ci/chain-route-new-couples.js in safe-auto-commit routes new mfrs of a full root to firstNonFull (P3206/P3223). Patterns: GitHub Actions docs, Mocha retries idea (mochajs), Athom app store limits question forum 161681. Test p3243.
- P3246 (2026-11-02): diy_custom_zigbee generic fallback — 18 coordinator/gateway productIds (ConBee/RaspBee/SLZB/ZigStar/ZZH/CC2531/Hue bridge…) with no sourced couple removed (coordinators never join Homey as end devices); generic DIY ids and all 306 mfrs kept, universal_zigbee untouched (generic TS ids). -5508 combos. Test p3246.
- P3243b/c (2026-11-03): hook git env (GIT_DIR/GIT_WORK_TREE...) stripped for the full suite (pre-push env -u, mocha root hook, runners) — test fixtures had written core.bare/core.worktree and commits into the shared repo; post-Test write-back changelog names subject items + P/GH refs instead of a vague family line (P3075). Tests p3243b, p3243c.
- finnamu (GH#516): _TZ3000_isw9u95y / TS0201 dropped by publish compaction — P3248 pinned; all 2026 reported couples now in survival gate.
- P3249 (2026-11-03): EF00 direct-cluster Buffer encoding from PR #558 (martinheie-ui, Aipin MC101Z) locked by a regression test; numeric bitmap/raw now big-endian bytes.
CI gate adopts a code-identical tip (P3256, 2026-11-03)
- Own work, no external code. Root cause found while unblocking master publishing: bot
[skip ci]commits that touch.jsleft no code-identical CI run and kept moving the tip, so the P3036 gate held every upload as "CI superseded". The gate now counts the tip's CI when the tip has the same code as the gated SHA.
- P3258 (03/11/2026): publish gate counts only shipped build inputs when adopting a bot-moved tip, and primes CI on the tip when it holds as superseded.
- P3263 (03/11/2026): master Athom probe swap (user OK) — placeholder-only device_radiator_valve_thermostat removed (its one payload couple _tze200_9xfjixap/TS0601 stays on thermostatic_radiator_valve), water_leak_aoyan_ay222z released from the publish hold; payload stays at 347 drivers to test the observed driver-count ceiling. Own work.
- P3343 (2026-11-16) KB daily: the zigbee-herdsman-converters contributors (
tuya.tsNova Digital SA-6 #13815,bseed.tsBSEED_TS0601_cover #13822,girier.tsTS0601_GIRIER #13824,tuya.tsTS0726_1_gang and TS0505B_2 / MiBoxer FUTC04ZR) for five exact couples. Facts only, own implementation. - P3345 (2026-11-16) weekly upstream: the zigbee-herdsman-converters contributors (
tuya.ts,hobeian.ts,nova_digital.ts,nous.ts,neo.ts) for 19 exact couples and 5 class corrections, and JohanBendz/com.tuya.zigbee for the 4-gang class of_TZE204_iik0pquw. Facts only, own implementation.
Also see sources.