Frozen v0.3.1 reference — corrected submission continues in v0.3.2

[JohanBendz]

Corrected submission candidate: v0.3.2

The maintainer requested publication-copy corrections on 2026-10-04. Draft release PR #1514, branch release-0.3.2, is now the intended 0.3.x Live submission candidate. It preserves this frozen 0.3.1 runtime and changes only publication text, version metadata, packaging exclusions and maintenance guidance. This PR is retained as the unmerged frozen 0.3.1 reference; do not promote it in parallel or mix in 0.4 work. Actual Live remains 0.2.76 and Test remains 0.3.1 until a real Athom submission/promotion. Confirm 0.3.2 Live before 0.4.0 Test.

---

Release v0.3.1 — published to Test (2026-10-01)

Status: Test published (confirmed by maintainer) · 0.2.76 remains Live · PR Draft / unmerged while field acceptance is collected. Code is frozen at 7583b4bb2fa91600c2301eb142335312a6a7cac4. Base modernize-2026 is the previous 0.3.0 Test baseline, not the current Live/default branch (SDK3).

Review snapshot: 238 commits / 207 changed files versus modernize-2026, with no file deletions. GitHub reports the PR mergeable, without conflicts, and the head has a successful CI275 at this exact SHA: clean install, Homey Compose, committed generated manifest/index, repository/regression tests, Homey publish validation and whitespace. No submitted GitHub PR reviews at this checkpoint. CI establishes technical/repository validity, not physical acceptance of every Zigbee variant.

Scope and release safety

• Includes extensive 2026 issue/PR archaeology, physically grounded exact-fingerprint additions, new isolated drivers, fixes in existing remotes/sensors/switches/meters/lighting, and regression tests. Full itemized implementation ledger is preserved below and detailed classifications live in tracker 2026 backlog triage — PRs first, then issues #1469.
• The 0.3.0 Build 127 manual diagnostic identified incoming temphumidsensor4 DP4=49 left unprocessed. The 0.3.1 TH05Z correction from Device Request - [Temperature & Humidity sensor with backlight] - [Shenzhen One Nuoda Trading Co.] / [TH05Z] #867 uses Homey's cached node.manufacturerName rather than relying on a potentially timing-out Basic read; tests cover the exact DP4 path and generic DP3 separation. Physical validation on the same already-paired sensor after installing 0.3.1 Test remains to be recorded. The log did not itself establish the fingerprint of every individual sensor.
• Targeted Test checks before considering Live: app initialization and new crash reports; pre-existing paired-device recovery/restart; core switch/dimmer/plug metering and sensor reporting; Smart Knob bound-cluster behavior; Device Request - [Temperature & Humidity sensor with backlight] - [Shenzhen One Nuoda Trading Co.] / [TH05Z] #867 TH05Z battery; and representative physically available new drivers/Flow features. See the separately maintained 0.3.1 physical validation queue in 2026 backlog triage — PRs first, then issues #1469. An untested new identity is not automatically a global-release blocker unless the actual affected risk warrants it; distinguish profile-specific follow-up from broad regressions.
• Investigate high-frequency unhandled DP36 logging in wall_thermostat (0.3.0) #1501 (frequent unknown wall_thermostat DP36 logging) is still open for protocol/device evidence. Its logging-only mitigation exists in develop-0.4 commit 0cba5b5, not in published 0.3.1 Test. Do not claim that change as a 0.3.1 fix.
• All subsequent 0.4.0 changes, including eWeLink Device Request - eWeLink temp/humidity sensor - CK-TLSR8656-SS5-01(7014) #1284, remain isolated to develop-0.4. This release PR must not be retargeted to that branch.

Decision gate

Keep this PR Draft and the 0.3.1 head unchanged while Test evidence arrives. Review release-specific reports and actual Homey device behavior, then explicitly decide on Ready for Review/merge and a separate Live publication when support and recovery capacity are available. Monday 2026-10-05 is the earliest planned review point, not an automatic promotion date. A GitHub merge alone does not publish an Athom Live release. Avoid retargeting this release PR to legacy default SDK3; plan any eventual modernize-2026 → main transition separately.

---

Original adoption / triage ledger

Base: modernize-2026
Work branch: modernize-2026-issues

Historical note: implementation was frozen at CI275 for the 0.3.1 Test publication. Subsequent 0.4.0 development is separately tracked in #1469. Historical PR cleanup is complete: all external PRs have been reviewed, selectively reimplemented, closed as superseded, or converted into focused current issues. The only open PR left in the repository is this draft.

Adopted / reimplemented

• Add Ekaza 1/2/3 gang wall switches (TS0001/TS0002/TS0003) #1466 — verified Ekaza 1/2/3-gang wall-switch identities
• Add _TZ3210_ddigca5n (TS011F metering plug) to smartplug #1452 — _TZ3210_ddigca5n / TS011F metering smartplug identity
• Add Wing manufacturer name to TS0203 door/window sensor #1439 — Wing TS0203 contact sensor identity
• Add HOBEIAN ZG-305Z (2-channel USB switch) to switch_2_gang #1435 — HOBEIAN ZG-305Z 2-channel switch identity
• Add Zbeacon manufacturer to smartplug driver (TS011F) #1421 — Zbeacon TS011F smartplug identity
• add "manufacturerName": _TZ3000_kfu8zapd #1209 — _TZ3000_kfu8zapd wall-remote identity
• fixes #1059, RGB LED Strip Controller, _TZ3210_eejm8dcr / TS0505B #1075 — _TZ3210_eejm8dcr RGB LED-strip-controller identity
• Add _TZ3000_k6fvknrr support (double_power_point_2) and curtain_motor Open/Stop/Close control #1437 — safe _TZ3000_k6fvknrr / TS011F identity only; curtain behavior separated into Curtain motor family profiles: DP1 state, position direction and Quoya limits #1472
• Add Zemismart 6-gang, curtain_motor toggle, and new manufacturer ids #1428 — compatible identity-only portions only
• Added 3 new devices #1253 — _TZ3000_996rpfy6 / TS0203 contact sensor only
• Added support for GIRIER Contact Sensor & Benexmart 12V RGBCW Dimmable Spotlight  #1137 — GIRIER _TZ3000_c8zfad4a / TS0203 contact sensor only
• Add support for _TZE204_gkfbdvyx radar sensor #1465 — _TZE204_gkfbdvyx / TS0601 radar profile with verified DP103 illuminance / DP105 fading time; no global cluster-258 change
• Add MTG075 presence sensor with relay #1462 — MTG075 _TZE204_mtoaryre / TS0601 presence sensor with relay, cleanly reimplemented from the physically verified contribution
• Add Dooya RJ11 Zigbee curtain/roller module support (DC1545R family, TS0601) #1431 — dedicated Dooya driver for physically verified _TZE200_3ylew7b4 / TS0601 only
• Add support for _TZE200_t1blo2bj / TS0601 Siren #1333 — _TZE200_t1blo2bj / TS0601 added to existing NEO siren profile; DP5 volume labels corrected to 0=Low, 1=Medium, 2=High
• Add new Temperature and Humidity sensor brand and model : HOBEIAN ZG-227Z #1332 / Device Request - [Device name] - [manufacturerName] / [modelId] #1281 — exact standard-Zigbee HOBEIAN / ZG-227Z temperature/humidity profile using shared temphumidsensor2 runtime and 2×AAA metadata
• Update driver.compose.json #1220 — _TZ3000_mh9px7cq / TS0044 added to handheld_remote_4_buttons
• Update driver.compose.json #1221 — _TZ3000_wpueorev / TS0001 added to valvecontroller
• Update driver.compose.json #1231 — _TZ3000_zgyzgdua / TS0044 added to wall_remote_4_gang_3
• [Device Support Request] Tuya TS0001 – _TZ3000_gjrubzje (Single Relay + Metering) #1377 — exact _TZ3000_gjrubzje / TS0001 endpoint-1 metering profile; contributor physically verified on/off + W/V/A/kWh; isolated driver reuses existing metering runtime
• 3-button remote - _TZ3000_bi6lpsew / TS0043 #57 / 3 Gang Wall Remote _TZ3000_w4thianr #150 / Device Request - 3 Gang Wall Remote - _TZ3000_famkxci2 / TS0043 #1467 — _TZ3000_bi6lpsew, _TZ3000_w4thianr, _TZ3000_famkxci2 added to the existing wall_remote_3_gang TS0043 profile after endpoint/cluster verification
• Device Request: Tuya 2-Button Wireless Switch #1456 — _TZ3000_tzvbimpq / TS0042 added to existing wall_remote_2_gang profile
• Device Request -3 button switch - _TZ3000_bczr4e10 / [TS0043] #1190 — _TZ3000_bczr4e10 / TS0043 added to existing wall_remote_3_gang profile after Homey interview verification
• Device Request - [Contact/Door Sensor - 2xAAA battery] - _TZ3000_0hkmcrza / TS0203 #1158 — _TZ3000_0hkmcrza / TS0203 added to existing 2×AAA doorwindowsensor_3 profile; standard IAS runtime, correct battery metadata
• Device Request - [Tuya ZigBee UK Smart Wall Socket Power Monitor] - [_TZ3000_dvqt7qrw] / [TS011F] #1105 — _TZ3000_dvqt7qrw / TS011F added to existing metering smartplug after physical Homey cluster verification
• Wall Socket - _TZ3000_wxtp7c5y / TS011F #166 — _TZ3000_wxtp7c5y / TS011F added to on/off-only plug; deliberately kept out of metering driver
• Verify _TZ3000_air9m6af / TS011F 4-socket power strip profile #1485 — _TZ3000_air9m6af / TS011F added to existing 4-socket+USB power-strip profile after historical Homey + deCONZ/Zigbee2MQTT cross-verification
• Device Request - Tuya Zigbee Smart Socket - _TZ3000_uwaort14/TS011F #1296 — _TZ3000_uwaort14 / TS011F added to existing smartplug metering profile
• Device Request - [Nedis Smart Plug with Energy Meter] - [TS011F] #1277 / Device Request - Smart Plug - _TZ3000_iiacqpdz / TS011F #1252 — _TZ3000_iiacqpdz / TS011F added to existing smartplug metering profile
• Device Request - [Bseed Wall socket] - [_TZ3210_4ux0ondb] / [TS011F] #1326 — _TZ3210_4ux0ondb / TS011F added to existing smartplug metering profile
• Device Request - Switch module (with power measurement) - _TZ3000_cjrngdr3 / TS011F #428 / Zigbee switch metered is not recognized as such #261 — _TZ3000_cjrngdr3 / TS011F added to existing smartplug metering profile
• Device Request - Smart Socket IP-3010S - EMOS / IP-3010S #1168 / Device Request - [Nedis ZBP131FWT Smart plug] - [_TZ3000_zgtbi4oy] / [TS011F] #1138 / Device Request - FDTEK Smart Plug with metering - _TZ3000_rdfh8cfs / TS011F #409 / Device Request – Tuya Smart Socket with Energy Monitoring – _TZ3210_5ct6e7ye / TS011F #1388 — _TZ3000_npg02xft, _TZ3000_zgtbi4oy, _TZ3000_rdfh8cfs, _TZ3210_5ct6e7ye added to standard smartplug metering profile in 87e69ff
• TS0207 standard IAS water-leak family: verify battery profiles #1041/Device Request - [Smart Water Sensor Leak Detector] - [Tuya] / [TS0207] #1042 — _TZ3000_bfopm9ga / TS0207 mapped externally to WL08, battery verified as 1×CR2032, added to existing flood_sensor in 709a40a
• Device Request - Miucda Tuya Zigbee Slimme Deursensor - Miucda / ZDS16 #892 — _TZ3000_wut53hfm / TS0203 added to existing CR2032 doorwindowsensor profile after Homey interview + product battery verification
• Zigbee Door & window sensor #1304 — _TZ3000_zutizvyk / TS0203 added to existing 2×AAA doorwindowsensor_3 after Homey interview + external physical battery verification
• _TZ3210_zmy9hjay / TS0202 ZB003-X multisensor: IAS + temp/humidity/lux profile #207 — dedicated Fantem ZB003-X _TZ3210_zmy9hjay / TS0202 hybrid core driver: IAS motion/tamper + Tuya temp/humidity + standard lux, 2×CR123A
• Device Request - [Tuya] - [Tuya Zigbee 3.0 Temperature and Humidity Smart Home Thermometer Hygrometer] / [ZY-ZTH02] #1197 / Device Request - [Temperature And Humidity Sensor] - [_TZ3000_v1w2k9dd] / [TS0201] #1107 — _TZ3000_v1w2k9dd / TS0201 added to existing 2×AAA temphumidsensor3 after Homey interview + battery verification
• Device Request - LoraTap/Tuya Smart Zigbee Temperature And Humidity Sensor - _TZ3000_unw0hpdv / TS0201 #995 — _TZ3000_unw0hpdv / TS0201 added to existing CR2032 temphumidsensor after Homey interview + LoraTap battery verification
• Device Request - Temperature & Humidity Sensor - Wing / ZTH11-3.0 #1429 / Device Request - Temperature & Humidity Sensor - Wing / ZTH13-3.0 #1422 / Device Request - Temperature and Humidity sensor - Zbeacon / TS0201 #1299 — Wing / TS0201 (ZTH11/ZTH13) and Zbeacon / TS0201 added to existing 2×AAA temphumidsensor3
• Device Request - Water Leakage Sensor - Shenzen Xriver Technology / _TZ3000_baeiitad / TS0207 #1380 — _TZ3000_baeiitad / TS0207 added as dedicated 2×AAA flood_sensor_2 profile using the exact existing standard IAS flood runtime
• Device Request - Zigbee PIR Motion Sensor - [_TZ3000_hgu1dlak] / [TS0202] #613 — _TZ3000_hgu1dlak / TS0202 added as dedicated 2×AA pir_sensor_3 profile using the exact existing IAS PIR runtime
• Device Request - Heiman Smoke detector HS1SA TYZB01_tob46aoq #577 — Heiman HS1SA _TYZB01_tob46aoq / TS0205 added to existing CR123A standard-IAS smoke_sensor profile
• Doorbell - _TZ1800_ladpngdx / TS0211 (Silvercrest / Lidl) #161 — dedicated Lidl/Silvercrest HG06668 _TZ1800_ladpngdx / TS0211 doorbell_button driver: IAS press event + tamper/battery, CR2450; implementation green, physical Homey behavior verification still requested

Generated app.json and SUPPORTED_DEVICES.md are synchronized with the Compose sources.

• Device Request - PIR Motion Detector Zigbee - _TZ3040_o4mkahkc / TS0202 #1392/o4mkahkc TS0202 PIR family: verify battery profile and _TZ3000/_TZ3040 variants #1139 — _TZ3040_o4mkahkc / TS0202 Tuya ZP01 added as isolated 2×AAA pir_sensor_4 in bf62a61; standard IAS PIR runtime reused, existing _TZ3000_o4mkahkc untouched

• LKMSZ001 / _TZ3210_cwamkvua TS0202: motion + scene switch profile #619 — _TZ3210_cwamkvua / TS0202 LKMSZ001 moved from partial generic PIR matching to dedicated motion_scene_switch in 5974978; IAS motion + DP101 scene actions + DP102 dark/bright + 2×AAA; CI116 green, physical Homey validation still required

• Add outdoor motion sensor #1490 / _TZE200_mgxy2d9f motion sensor: verify DP1 motion, DP4 battery and tamper #1483 — _TZE200_mgxy2d9f / TS0601 physically verified by contributor @oskarirauta; isolated motion_sensor_3 uses DP1 motion (0=active), DP4 battery and DP5 tamper, with no startup reads or polling

• double_power_point: metering capabilities declared but not registered #1495 — double_power_point metering runtime repaired in 3db4fe1; all four already-declared W/V/A/kWh capabilities now map to endpoint 1, with profile/scaling unchanged; CI133 green

• Device Request - Mercator - Ikuu / SPPUSB02G #784 / Device Request - Tuya Zigbee double Wall Socket & USB Charger - _TZ3000_dd8wwzcy/TS011F #1295 — _TZ3210_pfbzs1an and _TZ3000_dd8wwzcy added to the repaired double_power_point profile after physical Homey interview/test evidence plus current external endpoint/scaling verification; CI137/141 green

• Device Request - 4 gang wall switch - _TZ3000_mmkbptmx / TS0004 #395 — _TZ3000_mmkbptmx / TS0004 four-gang metering profile repaired: endpoints 3/4 added to Compose to match physical Homey interview and existing runtime/subdevices; CI145 green

• Device Request - Zigbee PIR Sensor - ZG-204Z(L) /TS0601 / _TZE200_3towulqd #380 — _TZE200_3towulqd / TS0601 closed as missed historical completion; existing motion_sensor_2 support matches the submitted Homey interview

• Device Request - 2 gang wall switch - _TZ3000_ruxexjfz / TS0002 #394 — _TZ3000_ruxexjfz / TS0002 closed as missed historical completion; contributor had physically verified identity-only addition to the existing 2-gang driver

• Device Request - Bseed Double Switch - _TZ3000_mklgayek / TS0002 #355 — _TZ3000_mklgayek / TS0002 closed as historical supported BSEED Melody 2-gang profile

• Device Request - Formaldehyd, VOC, CO2, Temp, Hum Sensor - _TZE200_ryfmq5rl / TS0601 #359 — smart-air family repaired with manufacturer-specific DP maps; _TZE200_ryfmq5rl formaldehyde/VOC scaling corrected and formaldehyde capability changed to mg/m³; CI148 green

• Device Request - Zigbee Temp/Hum sensor - ZTH01 / TS0601 / _TZE200_yjjdcqsq  #381 — _TZE200_yjjdcqsq battery-state DP3 + Tuya reporting handling repaired; CI151 green

• Device Request - LCD Temperature and huminity sensor with external probe - _TZE200_qyflbnbj / TS0601 #639 — _TZE200_qyflbnbj LCD sensor family now has manufacturer-specific humidity scaling + signed negative temperature handling; CI153 green

• Device Request - Livarno LED Stimmungslicht - _TZ3210_r0xgkft5/TS0505B #556 — _TZ3210_r0xgkft5 / TS0505B closed as verified existing RGB Mood Light support

• Device Request - Smart switch dual - _TZ3000_s8r1qoyq / TS0012 #606 / Device Request - [Zemismart switch Zigbee US AU - in wall switch - 3 Gang with neutral] - [_TZ3000_empogkya] / [TS0003] #675 / Device Request - Zigbee 5 Gang Switch - _TZE200_jwsjbxjs/ TS0601 #694 / Device Request - [Zigbee 3.0 Radar Human Presence Motion Sensor 5.8G] - [_TZE204_mtoaryre] / [TS0601] #664 — historical supported requests closed after physical/structural verification

• Device Request - [ Tuya 4CH Smart Relais Switch ] - [_TZ3000_u3oupgdy] / [TS0004] #881 — _TZ3000_u3oupgdy / TS0004 closed after explicit physical Homey success report; power-on-state enhancement preserved separately as Feature Request - configurable power-on state for 4-channel relay board #1497

• Device Request - 2 gang switch module - _TZ3000_lmlsduws / TS0002 #1127 — _TZ3000_lmlsduws / TS0002 closed as verified existing two-endpoint switch support

• Device Request - [Device name] - [mSupport request: TS0012 – _TZ3000_e98krvvk (2‑gang switch, two real loads)anufacturerName] / [modelId] #1369 — _TZ3000_e98krvvk / TS0012 closed after physical + independent evidence confirmed standard endpoint-1/2 OnOff

• Device Request - [2 gang wall switch] - [TS0002] / [_TZ3000_zmy4lslw] #976 — _TZ3000_zmy4lslw / TS0002 closed after exact OnOff + Metering + Electrical Measurement contract verification

• Device Request - [Fingerbot Plus] - [_TZ3210_j4pdtz9v] / [TS0001] #869 — FingerBot Tuya settings repaired to use device-required MCU SEND_DATA 0x04; CI164 green; issue remains open for physical retest

• Device Request - Soil Sensor - HZ-SL01 / _TZE204_myd45weu / TS0601 #906 / Device Request - [Soil Moisture Tester] - [_TZE284_sgabhwa6] / [TS0601] #908 / Device Request - [Soil Sensor] - [Tuya] / [_TZE284_aao3yzhs TS0601] #1009 — soil sensor families verified; _TZE284_aao3yzhs moved to the correct DP5 /10 profile with backward-compatible legacy runtime handling; CI169 green

• Device Request - Tuya Smart Plant sensor - _TZE284_aao3yzhs / TS0601 #1341 — duplicate _TZE284_aao3yzhs request consolidated into Device Request - [Soil Sensor] - [Tuya] / [_TZE284_aao3yzhs TS0601] #1009

• Device Request - [Zigbee Temperature and Humidity sensor] - [ _TZE204_cirvgep4] / [TS0601] #896 / Device Request - [Zigbee Temperature & Humidify sensor] - [ShenZhen Forever Young Technology Co. Ltd] / [ZTH08] #836 — _TZE204_cirvgep4 / TS0601 reconciled with repaired DP1/DP2/DP3 temp/humidity family; both stale requests closed

• Device Request - Tuya Smart Zigbee Temperature And Humidity Sensor - _TZE200_a8sdabtg / TS0601 #992 — _TZE200_a8sdabtg / TS0601 closed after physical standard-Zigbee temp/humidity/battery interview verification

• Device Request - [Water Leak detector] - [_TZ3000_upgcbody] / [SNZB-05] #1211 — exact _TZ3000_upgcbody water profile added for TS0207 + SNZB-05 with verified 2×AAA metadata; CI181 green

• Water Leak Alarm - TS0601 / _TZE200_jthf7vb6 - (Tuya cluster) #117 — exact WLS-100z _TZE200_jthf7vb6 profile restored from historical Homey evidence: DP1 0=wet + DP4 battery; legacy pairings preserved; CI193 green

• Device Request - [Temperature & Humidity sensor with backlight] - [Shenzhen One Nuoda Trading Co.] / [TH05Z] #867 — exact TH05Z _TZE200_vvmbj46n profile split: DP4 battery percentage + physically verified 3×AAA; legacy pairings preserved; CI200 green

• CI pipeline — Homey Compose now generates app.json before manifest/index/tests; committed generated output is locked before validation continues; CI209 green

• Device Request - Tuya Zigbee 2 gang switch / TS0012 (This one is already supported in v0.2.73!) - Issue can be removed #1283 — _TZ3000_jl7qyupf / TS0012 closed as verified existing two-endpoint OnOff support

• Device Request - Gang Smart - _TZE200_amp6tsvy/ TS0601 #1000 — _TZE200_amp6tsvy / TS0601 exact 1-gang DP1 switch profile regression-locked; CI210 green; device request closed

• Device Request - [2CH Zigbee Dimmmer Module] - [_TZ3000_7ysdnebc] / [TS1101] #1311 — _TZ3000_7ysdnebc / TS1101 missed closure corrected after physical two-endpoint dimmer verification

• Device Request - AVATTO Tuya ZigBee 1-gang Smart Dimmer Switch Module - _TZE204_5cuocqty / TS0601 #944 — _TZE204_5cuocqty / TS0601 split into exact AVATTO no-6/8 physical endpoint profile while retaining shared Tuya-DP runtime; CI215 green; closed

• Device Request - Smart Human presence sensor - Loginov / TS0601 #803 — _TZE204_7gclukjs / TS0601 split into exact ZY-M100-24GV2 profile: DP104/DP1 presence, DP103 lux, DP9 /10 distance, DP105 fading; CI222 green; closed

• Bug report - Humidity Value excessively rounded (10x) #846 — _TZ3000_ywagc4rj / TS0201 humidity scaling corrected from standard /100 to exact /10 profile; CI236 green; closed

• 2 gang switch module does not report status back to the app when set in a flow #576 — _TZ3000_18ejxno0 / TS0012 persistent endpoint OnOff reporting configured; CI238 green; keep open for physical Flow/state retest

• _TZ3000_rco1yzb1 / TS004F: single-click regression and configurable gesture window #423 — Silvercrest _TZ3000_rco1yzb1 / TS004F moved from raw-frame interception to BoundCluster + Tuya event-mode/action parsing; CI242 green; keep open for physical single/double retest

• 4-button wall switch _TZ3000_wkai4ga5 bug ON/OFF #457 — _TZ3000_wkai4ga5 / TS0044 bypasses legacy alternating-frame debounce only for exact fingerprint; CI245 green; keep open for physical Alternate On/Off retest

• smart-air family — Basic cluster declared for profile detection and verified DP20 PM2.5 exposed

• standard temp/humidity family — explicit caught reporting configuration added for temperature/humidity/battery

• Device Request - MOES WiFi Smart Light Dimmer Touch Panel Switch - Moes House / ZS-EUD #689 candidate — exact _TZE200_fjjbhx9d / TS0601 dual Tuya-DP dimmer profile now isolated on branch; final closure depends on external/physical profile verification

• 4 gang wall switch issues #270 — _TZ3000_xabckq1v / TS004F: physical button-order mapping fixed fingerprint-specifically; CI250 green; keep open for duplicate-trigger retest

• Bug report - [Device Request - [Smoke Detector] - [_TZE200_m9skfctm] / [TS0601] #449 #716 — _TZE200_m9skfctm / TS0601: smoke-only family split from ntcy3xu1 battery/tamper family; CI256 green; keep open for physical smoke/test-button retest

Deliberately not absorbed / canonical follow-up

• 2 gang switch module does not report status back to the app when set in a flow #576 — physical Flow/state retest after exact OnOff reporting repair (CI238 green)

• _TZ3000_rco1yzb1 / TS004F: single-click regression and configurable gesture window #423 — physical Silvercrest single/double click retest after BoundCluster rewrite (CI242 green)

• 4-button wall switch _TZ3000_wkai4ga5 bug ON/OFF #457 — physical Alternate On/Off retest after fingerprint-scoped debounce repair (CI245 green)

• Bug report - _TZE200_amp6tsvy / TS0601 pairs but exposes no On/Off control #1319 — _TZE200_amp6tsvy / TS0601: implementation + CI are green; keep open only for physical retest of the historical no-control report

• Device Request - [Tuya Zigbee Human Presence Detector] - [TS0601] / [_TZE204_ztqnh5cg] #945 — _TZE204_ztqnh5cg moved to the exact no-0x0102 5.8 GHz radar profile; CI173 green; physical motion retest remains

• Device Request - [ZigBee Smart Siren] - [TS0601] / [_TZE204_t1blo2bj] #1018 — NEO _TZE204_t1blo2bj siren response/datapoint processing + awaited settings repaired; CI175 green; physical retest remains

• TS0207 rain detectors — existing solar RB-SRAIN01 DP105 regression + MOWE standard IAS candidate #1288 — solar rain sensor DP105 now drives both intensity and rain alarm (>100); CI183 green; physical wet/dry retest remains

• 1/2/3/4 gang wall switches and touch dimmer #128 — old mixed wall-switch issue remains open: six original fingerprints still lack current Homey interviews/external exact mappings

• Device Request - [Fingerbot Plus] - [_TZ3210_j4pdtz9v] / [TS0001] #869 — FingerBot physical verification remains required after SEND_DATA 0x04 protocol repair (CI164 green)

• Device Request - [LoraTap-Joli de commande sans fil Zigéquation 3.0, 4 boutons poussoirs] - _TZ3000_ee8nrt2l / TS0044 #1159 / Device Request - [LoraTap-Joli de commande sans fil Zigéquation 3.0, 6 boutons poussoirs] - _TZ3000_iszegwpd / TS0046 #1160 — TS0044/TS0046 remotes: endpoint profiles match, but action-frame semantics still need evidence

• Device Request - [Tuya 2 in 1 Zigbee Mini PIR Motion Detector +Bright Lux] - [_TZE200_3towulqd] / [TS0601] #1169 — _TZE200_3towulqd / TS0601 conflicting physical interview; do not merge with Device Request - Zigbee PIR Sensor - ZG-204Z(L) /TS0601 / _TZE200_3towulqd #380 profile without renewed hardware verification

• Device Request - [Radar Sensor] - [_TZE204_qasjif9e] / [TS0601] #643 — _TZE204_qasjif9e / TS0601: exact Homey pairing profile and ×10 timing runtime implemented (CI160 green); keep open for physical presence/stability retest and DP9 traffic assessment; duplicate Device Request - Radar Presence Sensor 5.8G - _TZE204_qasjif9e / TS0601 #1092 consolidated here

• TS0041 multi-endpoint one-button remotes: verify action endpoints and long press #1471 — canonical multi-endpoint TS0041 one-button remote family verification (_TZ3000_an5rjiwd, _TZ3000_b4awzgct, _TZ3000_mrpevh8p, _TZ3000_5bpeda8u, _TZ3000_vn88ezar; _TZ3000_kxaow5ki pending interview)

• Curtain motor family profiles: DP1 state, position direction and Quoya limits #1472 — curtain-family profiles, position direction and Quoya limits

• TS110E Level Control profile for _TZ3210_ngqk6jia without driver migration #1473 — TS110E proprietary Level Control without Homey driver migration

• LCD TS0601 profiles: response handling, humidity scaling and Tuya time sync #1474 — _TZE200_locansqn LCD response/humidity/time-sync profile

• eWeLink SQ510A / SNZB-03 water sensor: resolve ambiguous fingerprint safely #1475 — eWeLink SQ510A / SNZB-03 ambiguous fingerprint

• THS317 probe family: split native OWON and Tuya-firmware profiles #1476 — THS317 native OWON vs Tuya-firmware profiles

• EPTTECH TLC2206-ZB tank monitor: validate DP scaling, settings writes and traffic #1477 — TLC2206-ZB tank monitor: DP map/settings/time response now physically verified on Homey from current MIT implementation; ~200k Zigbee frames/day requires explicit user warning and final branch retest

• Moes SR-ZS TS0726: 3 relays, 6 button actions and switch/scene mode #1478 — Moes SR-ZS 3 relays + 6 button actions + mode

• BHT wall thermostat profiles: audit DP16 scaling and _TZE204_wc2w9t1s #1479 — BHT wall thermostat profile and DP16 scaling audit

• Verify _TZE284_gyzlwu5q smoke + temperature/humidity datapoints #1480 — _TZE284_gyzlwu5q smoke/temp/humidity verification

• Standard-ZCL IAS PIR + battery + illuminance — TZE200 and HOBEIAN exact physical identities #1481 — _TZE200_kb5noeto standard IAS motion/battery/lux profile

• HOBEIAN _TZE200_y8jijhba radar: verify presence, light and exact DP profile #1482 — HOBEIAN _TZE200_y8jijhba presence/light radar profile

• Device Request - 3 gang Dimmer Moes- TS0601 _TZE204_1v1dxkck #1055 — _TZE204_1v1dxkck / TS0601 3-gang dimmer; old add dimmer 3 gangs #1204 superseded by contributor's physically tested current MIT com.gpm.moes implementation, to be selectively ported onto our Tuya base

• Device Request - [Human presence detector] - [TZE200_2aaelwxk] / [TS0225] #1133 — _TZE200_2aaelwxk / TS0225 dedicated radar family

• Device Request - [Human presence detector] - [TZE204_dapwryy7] / [TS0601] #1146 — _TZE204_dapwryy7 distinct radar DP profile

• Radiator Valve - _TZE200_c88teujp / TS0601 - (Tuya cluster) #140 — reopened Saswell _TZE200_c88teujp / TS0601 TRV profile

• o4mkahkc TS0202 PIR family: verify battery profile and _TZ3000/_TZ3040 variants #1139 — reopened _TZ3000_o4mkahkc / TS0202; historical 'Added' closure was false

• Device Request - ZigBee Intelligent curtain motor - Autorail "_TZE204_bjzrowv2" / "TS0601" #1186 — _TZE204_bjzrowv2 curtain behavior verification

• Device Request - [Smart Led Light Bulb MR16 12V RGBCW Dimmable Spotlight] - [Benexmart] / [TS0505B] #1091 — Benexmart _TZ3210_bfwvfyx1 / TS0505B color behavior verification

• Standard IAS contact + Power profile — four eWeLink/Tuya/zbeacon exact pairs, per-device status #1013 — exact eWeLink / SNZB-04 IAS contact profile; avoid broad manufacturer matching in shared door/window driver

• IAS Warning Device sirens — two TS0219 identities + Heiman WarningDevice exact variant #1455 — dedicated TS0219 IAS Warning Device siren profile; requires custom IAS WD command implementation, keep separate from TS0601 Tuya-DP siren

• Heiman HS1CG _TYZB01_0w3d5uw3 / TS0204: IAS gas alarm without app-wide compatibility bump #965 — Heiman HS1CG _TYZB01_0w3d5uw3 / TS0204 standard IAS CO/gas alarm; Homey alarm_gas compatibility floor must be resolved before implementation

• Homey capability compatibility strategy: keep app >=5 while adding post-12.2 alarm types #1491 — Homey capability compatibility strategy for post-12.2 system alarms while app remains >=5

• Standard IAS vibration sensors — three TS0210 plus TS0601 exact variant; capability strategy #830 — canonical TS0210 IAS vibration family; depends on Homey capability compatibility strategy: keep app >=5 while adding post-12.2 alarm types #1491 plus battery/clear-behavior verification

• Verify _TZE200_pay2byax / TS0601 door sensor with illuminance #1486 — _TZE200_pay2byax / TS0601 door/contact + illuminance profile; requires fresh Homey interview and protocol/lux-source verification

• TS011F DIN-rail threshold family: _TZ3000_yi0n4xfd + _TZ3000_zv6x8bt2 #1419 — TS011F DIN-rail threshold/temperature family (_TZ3000_yi0n4xfd, _TZ3000_zv6x8bt2); existing DIN-rail baseline driver needs feature-scope decision

• double_power_point_2: remove/verify phantom metering capabilities #1496 — double_power_point_2 exposes phantom metering capabilities despite no metering clusters/runtime

• Smart Plug with 2 USB slots - _TZ3000_2xlvlnez / TS011F #210 / Device Request - Wall switch with plug and USB - _TZ3000_lqb7lcq9 / TS011F #1244 — on/off-only / four-output TS011F families remain separate and blocked on the relevant profile/runtime verification (double_power_point_2: remove/verify phantom metering capabilities #1496 for the two-output on/off case)

• TS011F single-outlet metering family — four exact identities, per-device reporting/scaling regressions #1300 — _TZ3210_fgwhjm9j / TS011F: high-load power-overflow quirk; physical Homey raw-value verification required

• Device Request - pcblab.io FS-E1 smart plug with metering - _TZ3210_xzhnra8x / TS011F #1348 — _TZ3210_xzhnra8x / TS011F: reported ~10× voltage/power scaling error; profile-specific verification required

• Verify _TZE284_6ycgarab / TS0601 combined smoke + CO detector #1487 — _TZE284_6ycgarab / TS0601 combined smoke + CO detector; external EF00 DP map known, Homey capture required

• HOBEIAN ZG-222Z: dedicated IAS water-leak profile #1488 — exact HOBEIAN ZG-222Z profile implemented in 983f237; keep open only for physical Homey leak/tamper/battery/wake verification

• Verify _TZE200_vrcfo4i0 / TS0601 air-monitor profile #1489 — _TZE200_vrcfo4i0 / TS0601 air-monitor profile; insufficient protocol evidence, fresh Homey interview required

• ZG-223Z hybrid IAS + EF00 + illuminance rain/lux family — two exact identities #1272 — _TZE200_u6x1zyv2 / TS0601 hybrid rain + illuminance profile

• Device Request - Tuya Smart Air Quality Monitor - _TZE200_dwcarsat / TS0601 #582 — _TZE200/_TZE204_dwcarsat / TS0601 air-quality monitor family

• _TZ3000_1o6x1bl0 / TS0201: verify 0xE002 temperature/buzzer profile #1235 — _TZ3000_1o6x1bl0 / TS0201 manufacturer-cluster 0xE002 temperature/buzzer profile; not compatible with generic temp/humidity runtime

• TS0222 single-endpoint illuminance sensors: dedicated lux + battery driver #913 — dedicated single-endpoint TS0222 illuminance + battery driver (_TZ3000_8uxxzz4b, _TZ3000_do6txrcw, _TZ3000_hy6ncvmw); do not reuse two-endpoint LCD temp/hum/lux driver

• o4mkahkc TS0202 PIR family: verify battery profile and _TZ3000/_TZ3040 variants #1139 — _TZ3040_o4mkahkc ZP01 is implemented separately as 2×AAA; verify the remaining _TZ3000_o4mkahkc hardware revision because external physical evidence conflicts between 2×AAA and 3×AAA

• LKMSZ001 / _TZ3210_cwamkvua TS0202: motion + scene switch profile #619 — dedicated LKMSZ001 motion + scene-switch profile implemented in 5974978; keep open only for physical Homey validation of motion, button dedupe/actions, dark/bright and battery

• _TZ3210_zmy9hjay / TS0202 ZB003-X multisensor: IAS + temp/humidity/lux profile #207 — core implemented in 9cd859d/407b500; keep open for physical Homey validation and later ZB003-X sensitivity/keep-time/calibration/PIR/LED/reporting settings

• TS0207 rain detectors — existing solar RB-SRAIN01 DP105 regression + MOWE standard IAS candidate #1288 — physically verify current _TZ3210_tgvtvdoc rain detection before closing request

• TS0207 standard IAS water-leak family: verify battery profiles #1041 — standard TS0207 IAS water-leak family; _TZ3000_baeiitad (2×AAA) and _TZ3000_bfopm9ga/WL08 (CR2032) implemented; _TZ3000_bzt33cyu, _TZ3000_4qaowtdo, _TZ3000_qhozxs2b still need exact battery type/count

• Device Request - Power Socket Zigbee - _TZ3210_cehuw1lw / TS011F #1312 — _TZ3210_cehuw1lw / TS011F fingerprint implemented in 657944d; keep open only for physical W/V/A/kWh validation

• _TZ3210_alxkwn0h / TS0201 identity conflict: fresh Homey interview required #1290 — _TZ3210_alxkwn0h / TS0201 identity conflict; external sources identify temp/humidity display sensor, fresh Homey interview required

• _TZ3000_ko6v90pg / TS011F: verify BSEED/WK35 metering scaling #1494 — _TZ3000_ko6v90pg / TS011F BSEED/WK35 metering scaling; exact standard metering clusters known, physical kWh/W/V/A verification required before adoption

• Bug report - 1 button Smart Remote Controller only works every other click #747 — _TZ3000_fa9mlvja / TS0041 every-other-click behavior bug

Review hygiene

• SDK3 is archive/history only and is not modified.
• Old PRs are treated as evidence, never merged wholesale.
• Commit 1b03dab removed incidental JSON reformatting so accepted identity diffs remain surgical.
• Installed-device behavior is preserved unless a protocol change is explicitly understood and tested.
• Closed historical issues are not considered proof of resolution; o4mkahkc TS0202 PIR family: verify battery profile and _TZ3000/_TZ3040 variants #1139 and Radiator Valve - _TZE200_c88teujp / TS0601 - (Tuya cluster) #140 were already found falsely closed and reopened.

Validation and release role — 2026-09-30

This PR is now the frozen 0.3.1 development/Test follow-up to the 0.3.0 modernization baseline.

Current release model:

• Live: SDK3 — 0.2.76
• Test: modernize-2026 — 0.3.0
• Development: modernize-2026-issues — 0.3.1 (this PR)

Validation checkpoint for this PR:

• HEAD 725d7b2
• 236 commits ahead, 0 behind modernize-2026
• CI273 fully green
• 92/92 repository tests passing
• Homey Compose/build green
• committed generated app.json matches Compose
• generated SUPPORTED_DEVICES.md current
• Homey publish validation green
• whitespace check green

The branch has also been tested locally on Homey and appears functionally as stable as 0.3.0, while adding the larger verified issue/device backlog.

Freeze

This PR intentionally remains draft and frozen while 0.3.0 receives Homey Test feedback.

Do not add further backlog work to this branch during the freeze.

Planned release sequence:

1. Verify 0.3.0 stability in Test.
2. Promote 0.3.0 to Live.
3. Publish 0.3.1 as Test.
4. Keep 0.3.1 frozen during its Test cycle.
5. Create the next development branch from this line, provisionally develop-0.4, and resume new development there.

Physical validation of the 0.3.1-specific changes remains tracked in #1469, including FingerBot #869 and the other retained hardware-retest items.

The old temporary 0.2.77 release-candidate plan is retired; 0.2.77 was never the intended App Store milestone in the final release sequence.

[JohanBendz]

Maintainer release-status signal — 2026-10-02

Reported 0.3.1 Test adoption exceeds 2,600 installations, with no crashes or errors reported as of this update. This is reported operational feedback rather than a guarantee that every physical device has been tested. The source branch and this PR remain frozen at 7583b4bb2fa91600c2301eb142335312a6a7cac4; no merge, branch update, Homey submission or Live promotion was performed.

Next development objective is 0.4.0 Test around 6–7 October 2026. Please explicitly review the 0.3.1 Live-promotion / occupied Test-channel decision before issuing the next Test release, so this well-exercised candidate is not silently superseded. The separate 0.4 Test-readiness plan now pins the full 0.3.1 compatibility baseline and protects sensitive legacy light source against unapproved changes. This PR remains Draft until a deliberate release decision.

[JohanBendz]

Maintainer release-sequence decision — 2026-10-04

Confirmed deployment order (hard dependency):

1. Current Live remains v0.2.76 while current Test v0.3.1 is finally reviewed; do not claim a promotion has happened.
2. FIRST promote exactly the existing tested v0.3.1 build to Live, using frozen branch modernize-2026-issues HEAD 7583b4bb2fa91600c2301eb142335312a6a7cac4. Complete 0.3.1 Test feedback and targeted release-safety review, check core existing device upgrades/flows, then submit for Athom certification and manually publish to Live once approved. This is the v0.2.76 → v0.3.1 Live step. Draft #1470 is the matching GitHub release lane; GitHub merge alone is NOT Homey publication, and do not redirect it into develop-0.4 or archived SDK3.
3. ONLY AFTER v0.3.1 is confirmed actually available in Live, complete the separate develop-0.4 final-SHA/pairing-assets/preflight sign-off and submit v0.4.0 to public Test, replacing v0.3.1 Test. Physical trials of 33 new 0.4 exact manufacturer/model rows are explicitly expected INSIDE public Test, not an artificial gate before Test publication.
4. No implicit permission to publish or merge was given by recording this release order. The app-version numbers must remain monotonic; if v0.4.0 Test later fails, submit higher-version corrective build such as v0.4.1 rather than expect republishing v0.3.1 to downgrade Test installs.

This updates the previously open Test-channel decision in docs/0.4.0_RELEASE_PREFLIGHT.md / tracker #1469: choose the v0.3.1-Live-first path. All code, manifests, PR state and Homey channel publication remain untouched by this coordination note. Athom documentation: https://apps.developer.homey.app/app-store/publishing and https://apps.developer.homey.app/app-store/updates .

[JohanBendz]

Frozen 0.3.1 Live-candidate review — 2026-10-04

Review evidence and remaining checks now committed via merged #1513. Exact release source is still 7583b4bb2fa91600c2301eb142335312a6a7cac4, unchanged; this PR remains OPEN/DRAFT/unmerged. CI275 remains SUCCESS; unchanged local source passed 95/95 tests. Structural audit against actual 0.2.76 SDK3 source found no removed driver, capability, setting or Flow-card IDs. The retained siren-volume action has corrected labels with unchanged numeric argument IDs.

Reviewed 650 GitHub conversation comments updated since September 30 and targeted existing-device issues. No new evidence in that retrieved feedback set establishes a 0.3.1 app crash or broad upgrade regression. Current-version physical confirmation is still missing for several targeted cases, including TH05Z battery, FingerBot and remote gestures. Forum/private diagnostics/current Athom telemetry were unavailable; do not describe this as exhaustive physical acceptance. DP36 thermostat logging remains a known 0.3.0/0.3.1 observation, with mitigation only in 0.4.

The release documents now pin 0.3.1 Live BEFORE 0.4.0 Test. develop-0.4 is the feature-frozen 0.4.0 stabilization lane, and develop-0.4.1 exists for new development from validated checkpoint 210ac20. No new code is justified in this frozen 0.3.1 candidate by the reviewed evidence. Complete final operational sign-off and actual Athom Live promotion using the existing tested build before replacing Test. No Homey publication or release-PR merge performed by this review.

[JohanBendz]

Post-Live hotfix note: #1517 exposed a regression in curtain_module_2_gang introduced when Flow action listeners were moved to driver level. The driver accidentally became Homey.Driver despite declaring Zigbee subdevice secondModule.

release-0.3.3 restores ZigBeeDriver while preserving the Flow routing fix and adds regression coverage. The runtime fix/test are also forward-ported to develop-0.4 and develop-0.4.1. Validation is tracked in #1518.