Knowledge base
Our notes, written in our own words, on devices, protocols, Homey SDK pitfalls and past fixes. Each page links to its source file and credits the references it used. Sources: sources.
Knowledge base (curated)
- KB changelog docs/knowledge/KB/CHANGELOG.md
- Code reference (generated) docs/knowledge/KB/CODE_REFERENCE.md
- How other apps handle unknown commands, fallbacks, polling, magic packets, time sync and reporting (P3017) docs/knowledge/KB/CROSS_APP_METHODS.md
- Documentation coverage (generated) docs/knowledge/KB/DOC_COVERAGE.md
- DP + endpoint coverage (P3018) docs/knowledge/KB/DP_ENDPOINT_COVERAGE.md
- docs/knowledge/KB/DP_ENDPOINT_COVERAGE.notes.md docs/knowledge/KB/DP_ENDPOINT_COVERAGE.notes.md
- Family completeness per gang / channel / phase (P3075) docs/knowledge/KB/FAMILY_COMPLETENESS.md
- Homey Tuya KB — index docs/knowledge/KB/INDEX.md
- Lessons P3001–P3016 (2026-10-24, Europe/Paris) docs/knowledge/KB/LESSONS_P3001_P3016.md
- Method coverage (P3017): family × method docs/knowledge/KB/METHOD_COVERAGE.md
- Core helpers, time sync and custom clusters (hand-written reference) docs/knowledge/KB/MODULES_CORE_AND_CLUSTERS.md
- Device helpers, base classes, diagnostics and discovery modules docs/knowledge/KB/MODULES_DEVICES_AND_DIAGNOSTICS.md
- Dynamic DP engines, eWeLink LAN, errors and gateway soft features docs/knowledge/KB/MODULES_DYNAMIC_AND_FEATURES.md
- Flow helpers, energy, pairing helpers and I/O layers (hand-written reference) docs/knowledge/KB/MODULES_FLOW_ENERGY_AND_LAYERS.md
- Managers, mixins, pairing helpers and small runtime pieces (hand-written reference) docs/knowledge/KB/MODULES_MANAGERS_MIXINS_AND_PAIRING.md
- Performance helpers, protocol helpers, profiles and pairing pieces (hand-written reference) docs/knowledge/KB/MODULES_PERFORMANCE_PROTOCOL_AND_PROFILES.md
- Held devices, sensors, smart features, temporal tools and Wi-Fi local helpers (hand-written reference) docs/knowledge/KB/MODULES_SMART_TEMPORAL_AND_LOCAL.md
- Wi-Fi local (tuya-local) helpers and Tuya Zigbee helpers (hand-written reference) docs/knowledge/KB/MODULES_TUYA_LOCAL_AND_TUYA_HELPERS.md
- Platform limits (P3026) docs/knowledge/KB/PLATFORM_LIMITS.md
- Unknown commands, clusters and DPs: what they mean and how we handle them (P3016) docs/knowledge/KB/UNKNOWN_COMMANDS.md
- Upstream daily, 2026-11-01 (light run after failed runs 28–31/10) docs/knowledge/KB/UPSTREAM_DAILY_2026-11-01.md
- Upstream daily, 2026-11-02 docs/knowledge/KB/UPSTREAM_DAILY_2026-11-02.md
- Upstream daily, 2026-11-03 docs/knowledge/KB/UPSTREAM_DAILY_2026-11-03.md
- Upstream daily 2026-11-16 (P3343) docs/knowledge/KB/UPSTREAM_DAILY_2026-11-16.md
- Upstream weekly 2026-11-16 (P3345) docs/knowledge/KB/UPSTREAM_WEEKLY_2026-11-16.md
- Work log 2026-10-24 → 2026-10-25 (master) — P3015 to P3030 docs/knowledge/KB/WORK_2026-10-24_25.md
- Athom build & publish lessons docs/knowledge/KB/athom-build.md
- Athom publish history — master (own summary, 21/10/2026) docs/knowledge/KB/athom-publish-history.md
- FAQ — recurring problems and fixes docs/knowledge/KB/faq.md
- Field notes by topic (pointers to our own write-ups, commit-pinned via repo history) docs/knowledge/KB/field-notes.md
- Forum patterns — topic 140352 (read 21/10/2026, posts #2204–#2265) docs/knowledge/KB/forum-patterns.md
- Homey SDK rules & pitfalls (our words) docs/knowledge/KB/homey-sdk.md
- Open leads docs/knowledge/KB/leads.md
- Lessons learned (P-numbers) docs/knowledge/KB/lessons.md
- People & credits docs/knowledge/KB/people.md
- Project rules & decisions docs/knowledge/KB/project-rules.md
- Protocols (summary in our words) docs/knowledge/KB/protocols.md
- Sources docs/knowledge/KB/sources.md
Engineering notes
- GitHub Actions — mesure et optimisation (10/10/2026) docs/knowledge/ACTIONS_OPTIMIZATION.md
- AOYAN padded manufacturerName (2026-10-12) docs/knowledge/AOYAN_PADDED_MANUFACTURER.md
- Athom AggregateError on master — bisect result (2026-10-10) docs/knowledge/ATHOM_AGGREGATEERROR_BISECT_2026-10-10.md
- P3340: what Athom's "AggregateError" is, and why master stops at 347 (16/11/2026, Paris) docs/knowledge/ATHOM_AGGREGATEERROR_P3340.md
- Athom / Homey publish limits — what we know (2026-10-10, Paris) docs/knowledge/ATHOM_LIMITS.md
- New driver ids rejected by Athom (AggregateError) — offline analysis 2026-10-11 (Paris) docs/knowledge/ATHOM_NEW_DRIVER_REJECTION_2026-10-11.md
- Athom "processing failed": diagnosis (20/10/2026, P2902) docs/knowledge/ATHOM_PROCESSING_FAILED_2026-10-20.md
- Athom processing_failed | socket hang up — evidence, conclusion, fixes (2026-10-19) docs/knowledge/ATHOM_SOCKET_HANGUP_ROOT_CAUSE_2026-10-19.md
- Athom "socket hang up" / processing_failed / AggregateError — root-cause study (P2930, 21/10/2026 Paris) docs/knowledge/ATHOM_SOCKET_HANGUP_ROOT_CAUSE_P2930.md
- Automation coverage without AI (P3048) docs/knowledge/AUTOMATION_COVERAGE.md
- Autonomy map — assistant routines vs GitHub Actions (P3097, 2026-10-31) docs/knowledge/AUTONOMY_MAP.md
- P2929 — Bastien app: crashes and failing Flow cards/buttons (21/10/2026, Paris) docs/knowledge/BASTIEN_CRASH_BUTTONS_P2929_2026-10-21.md
- Branch map and worktree hygiene (P3062, 2026-10-26) docs/knowledge/BRANCH_MAP_AND_WORKTREE_HYGIENE.md
- Button event router (P2926) — 2026-10-21 docs/knowledge/BUTTON_EVENT_ROUTER_P2926.md
- CI concurrency on a busy master (P3069) docs/knowledge/CI_CONCURRENCY.md
- Cross-research (P2936) — one full cross-check for every request docs/knowledge/CROSS_RESEARCH_P2936.md
- Fil « Device Capabilities » — synthèse pour notre app docs/knowledge/DEVICE_CAPABILITIES_THREAD.md
- device_plug_smart wildcard pids — decision (2026-10-20) docs/knowledge/DEVICE_PLUG_SMART_WILDCARD_DECISION_2026-10-20.md
- Device truth catalog (every AI prompt) docs/knowledge/DEVICE_TRUTH.md
- Disabled workflows (P2916, 20/10/2026) docs/knowledge/DISABLED_WORKFLOWS_P2916.md
- External analysis verification (2026-10-10) docs/knowledge/EXTERNAL_ANALYSIS_VERIFY_2026-10-10.md
- Field notes — curtain_motor "doesn't move" + mmWave class flip (2026-10-10) docs/knowledge/FIELD_NOTES_2026-10_CURTAIN_MMWAVE.md
- Field notes — X/Twitter scan (2026-10-04) docs/knowledge/FIELD_NOTES_2026-10_X_SCAN.md
- Homey forum — Apps category + zigbee tag digest (2026-10) docs/knowledge/FORUM_APPS_CATEGORY_DIGEST_2026-10.md
- Forum sweep 2026-10-18 (workstream C, read-only) docs/knowledge/FORUM_SWEEP_2026-10-18.md
- Forum Homey — fils clés (10/10/2026) docs/knowledge/FORUM_THREADS_DIGEST.md
- GitHub Actions hardening P2900 (20/10/2026, Paris time) docs/knowledge/GHA_HARDENING_P2900.md
- docs/knowledge/GHA_REPORTS_INVENTORY.md docs/knowledge/GHA_REPORTS_INVENTORY.md
- Gledopto GL-SPI-206P — recherche (10/10/2026) docs/knowledge/GLEDOPTO_GL_SPI_206P.md
- Gledopto GL-SPI-206P (led_controller_spi_tuya) — runtime fix + Athom status (2026-10-10) docs/knowledge/GLEDOPTO_SPI_206P_FIX_2026-10-10.md
- Diagnostics et crashs Homey reçus par Gmail (01/08 → 10/10/2026) docs/knowledge/GMAIL_DIAGNOSTICS_2026-08-10.md
- HOBEIAN ZG-101ZS = _TZ3000_bgtzm4ny + TS0044 → scene_switch_4 (2026-10-11, Paris) docs/knowledge/HOBEIAN_ZG101ZS_SCENE_SWITCH_2026-10-11.md
- Homey firmware & Zigbee stack: research notes (2026-10-10) docs/knowledge/HOMEY_FIRMWARE.md
- Homey news 2025-2026: what it means for this app (queue #101-#106) docs/knowledge/HOMEY_NEWS_2026_AUDIT.md
- Homey SDK, CLI and developer news — October 2026 (our summary) docs/knowledge/HOMEY_SDK_NEWS_2026-10.md
- Homey SDK v3 rules — sourced, tested, automated (P2964) docs/knowledge/HOMEY_SDK_RULES.md
- Homey tooling watch docs/knowledge/HOMEY_TOOLING_WATCH.md
- Homey versions strictly incremental — all apps (rule from dlnraja, 2026-10-10) docs/knowledge/HOMEY_VERSION_FLOOR.md
- Issues sweep 2026-10-19 (workstream C2) docs/knowledge/ISSUES_SWEEP_2026-10-19.md
- ZG-101ZD rotary knob driver + 9ern5sfh owner alignment — 2026-10-19 (Paris) docs/knowledge/KNOB_ZG101ZD_AND_9ERN5SFH_2026-10-19.md
- Lost couples restore — 2026-10-11 (bastien-home) docs/knowledge/LOST_COUPLES_RESTORE_2026-10-11.md
- Memory safety: lazy + async loading, bounded caches (2026-10-18) docs/knowledge/MEMORY_LAZY_ASYNC_2026-10-18.md
- P2914 — App memory crashes (20/10/2026) docs/knowledge/MEMORY_P2914.md
- New drivers — 2026-10-11 docs/knowledge/NEW_DRIVERS_2026-10-11.md
- _TZE200_nkjintbl + TS0601 → switch_2gang docs/knowledge/NKJINTBL_TZE200_SWITCH_2GANG_2026-10-13.md
- Node 22 — bastien-home per-file test verdicts (2026-10-11) docs/knowledge/NODE22_BASTIEN_TEST_VERDICTS_2026-10-11.md
- Stable-v5 Node 22 test audit — 2026-10-11 (Paris) docs/knowledge/NODE22_STABLE_AUDIT_2026-10-11.md
- OTA audit (P2932, 2026-10-21) docs/knowledge/OTA_AUDIT_P2932.md
- P2920 — built app.json committed + all-caps case variant (21/10/2026) docs/knowledge/P2920_APPJSON_AND_CASE_VARIANT_2026-10-21.md
- P2921 — HEIMAN native drivers + resolver keeps manufacturer names (21/10/2026) docs/knowledge/P2921_HEIMAN_DRIVERS_MFR_REPORT_ONLY_2026-10-21.md
- P2924 — "socket hang up": where it happens and what we changed (21/10/2026) docs/knowledge/P2924_SOCKET_HANG_UP_2026-10-21.md
- P2927 — HEIMAN couples kept on a specific driver and on the generic fallback (21/10/2026) docs/knowledge/P2927_HEIMAN_GENERIC_FALLBACK_DUALS_2026-10-21.md
- P2932 — needs-info OCR pass, Aqara RTCGQ13LM, startup heap (21/10/2026) docs/knowledge/P2932_NEEDS_INFO_OCR_AND_HEAP_2026-10-21.md
- P2933 / P2934 — Homey diag reports via Gmail + Aqara DJT11LM (2026-10-21) docs/knowledge/P2933_P2934_GMAIL_DIAG_AND_DJT11LM_2026-10-21.md
- P2951 — zcl_cluster_layer compose/$extends + _TZ3000_dfgbtub0|TS0042 docs/knowledge/P2951_ZCL_EXTENDS_AND_TS0042.md
- P2970 — Beca BAC-006AZB / BAC-002-ALZB on wall_thermostat docs/knowledge/P2970_BECA_BAC006AZB.md
- P2972 — "cobsyrain decoding" (COBS + rain DP decoder) docs/knowledge/P2972_COBS_RAIN_DECODING.md
- P3034 Phase 1: variables, accepted 9.0.1574 (#3655) vs refused #3656–#3680 docs/knowledge/P3034_PHASE1_VARIABLES.md
- P3036: Athom publish policy (green CI, spacing, one retry, bisect exit) docs/knowledge/P3036_ATHOM_PUBLISH_POLICY.md
- P3055 — parasitic Zigbee combos: per-couple decisions docs/knowledge/P3055_PARASITE_DECISIONS.md
- P3062 — Worktree rescue and triage (2026-10-26) docs/knowledge/P3062_WORKTREE_TRIAGE.md
- P3064 — family-by-family uplift (master, 2026-10-26) docs/knowledge/P3064_FAMILY_UPLIFT.md
- P3065 — Memory audit (all branches) docs/knowledge/P3065_MEMORY_AUDIT.md
- P3070 — Global gap audit (2026-10-26) docs/knowledge/P3070_GLOBAL_GAPS.md
- P3072 — Wi-Fi devices: one IP, follow IP changes, honest repair docs/knowledge/P3072_WIFI_UX.md
- P3073 — Free, local, deterministic learning loop (design) docs/knowledge/P3073_LEARNING_LOOP.md
- P3077 — phantom couples: one couple, one driver docs/knowledge/P3077_PHANTOM_DECISIONS.md
- P3204 — GH#598 _TZE284_9ern5sfh "Unable to connect" (2026-11-02, Paris) docs/knowledge/P3204_GH598_BINDINGS_AT_PAIRING.md
- Device peculiarities — cross-source investigation docs/knowledge/PECULIARITIES.md
- Peter forum #2259 — diag c05db40d (OOM / app.json) docs/knowledge/PETER_C05DB40D_OOM_2026-10-11.md
- Port round 2026-10-11 (master → stable-v5 / bastien-home) docs/knowledge/PORT_ROUND_2026-10-11.md
- Analyse REA des paquets de build (2026-10-10) docs/knowledge/REA_ANALYSIS.md
- REA (morluto/rea): evaluation for this project docs/knowledge/REA_TOOL.md
- Soil sensors pairing as "unknown" (#570 AOYAN AY-303Z, #571 QT-07S _TZE284_myd45weu), 2026-10-13 docs/knowledge/SOIL_PAIRING_570_571_2026-10-13.md
- led_controller_spi_tuya — Athom AggregateError bisect (19/10/2026) docs/knowledge/SPI_ATHOM_BISECT_2026-10-19.md
- Sync matrix master -> stable-v5 / bastien-home (2026-10-21) docs/knowledge/SYNC_MATRIX_2026-10-21.md
- Battery multi-button remotes — TS0041 / TS0042 / TS0043 / TS0044 / TS004F docs/knowledge/TS004X_BATTERY_REMOTES.md
- Tuya manufacturer clusters 0xE000 / 0xE001 / 0xE002 docs/knowledge/TUYA_E000_E001_E002.md
- Homey forum 154077 — "[APP][Pro] Tuya Local" (read 2026-10-11) docs/knowledge/TUYA_LOCAL_THREAD_154077.md
- Master publish unblock + issue #560 (TRV06) + bjawzodf/TY0201 + MemwarnGuard (2026-10-18, own words) docs/knowledge/UNBLOCK_MASTER_AND_ISSUE_560_2026-10-18.md
- Upstream watch — daily KB refresh (25/10/2026) docs/knowledge/UPSTREAM_DAILY_2026-10-25.md
- Upstream daily notes, 2026-10-26 docs/knowledge/UPSTREAM_DAILY_2026-10-26.md
- Upstream daily notes, 2026-10-27 docs/knowledge/UPSTREAM_DAILY_2026-10-27.md
- Homey SDK / upstream watch — zigbee-clusters 3.9.0 and tuya-local (24/10/2026) docs/knowledge/UPSTREAM_HOMEY_SDK_ZIGBEE_CLUSTERS_2026-10-24.md
- Upstream weekly check, 2026-10-19 to 2026-10-26 docs/knowledge/UPSTREAM_WEEKLY_2026-10-26.md
- P2930 — WiFi/local coverage + Tuya protocol versions (LAN and Zigbee) docs/knowledge/WIFI_LOCAL_PROTOCOLS_P2930.md
- Tuya Zigbee coverage matrix (P3039) docs/knowledge/Z2M_COVERAGE.md
- Z2M generic device options → ideas for Homey (ideas only, nothing implemented) docs/knowledge/Z2M_GENERIC_CONCEPTS.md
- Couche clusters ZCL (P2931, 2026-10-21) docs/knowledge/ZCL_CLUSTER_LAYER_2026-10-21.md
- AggregateError and the energy_ setting prefix docs/knowledge/aggregateerror-energy-prefix.md
- AggregateError: the five "isolated" drivers have no common content defect (2026-11-15) docs/knowledge/aggregateerror-isolated-drivers.md
- Athom driver-count ceiling and the AggregateError (P3330, 15/11/2026 Paris) docs/knowledge/athom-driver-ceiling.md
Device families (KB)
- Device families docs/knowledge/KB/devices/README.md
- Family TS0001 docs/knowledge/KB/devices/TS0001.md
- Family TS0001_fingerbot docs/knowledge/KB/devices/TS0001_fingerbot.md
- Family TS0002 docs/knowledge/KB/devices/TS0002.md
- Family TS0003 docs/knowledge/KB/devices/TS0003.md
- Family TS0004 docs/knowledge/KB/devices/TS0004.md
- Family TS000F docs/knowledge/KB/devices/TS000F.md
- Family TS0011 docs/knowledge/KB/devices/TS0011.md
- Family TS0012 docs/knowledge/KB/devices/TS0012.md
- Family TS0013 docs/knowledge/KB/devices/TS0013.md
- Family TS0014 docs/knowledge/KB/devices/TS0014.md
- Family TS0021 docs/knowledge/KB/devices/TS0021.md
- Family TS0041-M001-SlD docs/knowledge/KB/devices/TS0041-M001-SlD.md
- Family TS0041-M002-SlD docs/knowledge/KB/devices/TS0041-M002-SlD.md
- Family TS0041-M005-SlD docs/knowledge/KB/devices/TS0041-M005-SlD.md
- Family TS0041 docs/knowledge/KB/devices/TS0041.md
- Family TS0041A docs/knowledge/KB/devices/TS0041A.md
- Family TS0042-M003-SlD docs/knowledge/KB/devices/TS0042-M003-SlD.md
- Family TS0042-M006-SlD docs/knowledge/KB/devices/TS0042-M006-SlD.md
- Family TS0042-z-SlD docs/knowledge/KB/devices/TS0042-z-SlD.md
- Family TS0042 docs/knowledge/KB/devices/TS0042.md
- Family TS0043-M007-SlD docs/knowledge/KB/devices/TS0043-M007-SlD.md
- Family TS0043-z-SlD docs/knowledge/KB/devices/TS0043-z-SlD.md
- Family TS0043 docs/knowledge/KB/devices/TS0043.md
- Family TS0044-M004-SlD docs/knowledge/KB/devices/TS0044-M004-SlD.md
- Family TS0044-z-SlD docs/knowledge/KB/devices/TS0044-z-SlD.md
- Family TS0044 docs/knowledge/KB/devices/TS0044.md
- Family TS0045 docs/knowledge/KB/devices/TS0045.md
- Family TS0046 docs/knowledge/KB/devices/TS0046.md
- Family TS0049 docs/knowledge/KB/devices/TS0049.md
- Family TS004F docs/knowledge/KB/devices/TS004F.md
- Family TS0052 docs/knowledge/KB/devices/TS0052.md
- Family TS0101 docs/knowledge/KB/devices/TS0101.md
- Family TS0105 docs/knowledge/KB/devices/TS0105.md
- Family TS0108 docs/knowledge/KB/devices/TS0108.md
- Family TS0111 docs/knowledge/KB/devices/TS0111.md
- Family TS0115 docs/knowledge/KB/devices/TS0115.md
- Family TS011F docs/knowledge/KB/devices/TS011F.md
- Family TS0121 docs/knowledge/KB/devices/TS0121.md
- Family TS0201-z docs/knowledge/KB/devices/TS0201-z.md
- Family TS0201 docs/knowledge/KB/devices/TS0201.md
- Family TS0202 docs/knowledge/KB/devices/TS0202.md
- Family TS0203 docs/knowledge/KB/devices/TS0203.md
- Family TS0205 docs/knowledge/KB/devices/TS0205.md
- Family TS0207 docs/knowledge/KB/devices/TS0207.md
- Family TS0210 docs/knowledge/KB/devices/TS0210.md
- Family TS0211 docs/knowledge/KB/devices/TS0211.md
- Family TS0212 docs/knowledge/KB/devices/TS0212.md
- Family TS0215A docs/knowledge/KB/devices/TS0215A.md
- Family TS0216 docs/knowledge/KB/devices/TS0216.md
- Family TS0219 docs/knowledge/KB/devices/TS0219.md
- Family TS0222 docs/knowledge/KB/devices/TS0222.md
- Family TS0225 docs/knowledge/KB/devices/TS0225.md
- Family TS0301 docs/knowledge/KB/devices/TS0301.md
- Family TS030F docs/knowledge/KB/devices/TS030F.md
- Family TS0501 docs/knowledge/KB/devices/TS0501.md
- Family TS0501A docs/knowledge/KB/devices/TS0501A.md
- Family TS0501B docs/knowledge/KB/devices/TS0501B.md
- Family TS0502A docs/knowledge/KB/devices/TS0502A.md
- Family TS0502B docs/knowledge/KB/devices/TS0502B.md
- Family TS0502C docs/knowledge/KB/devices/TS0502C.md
- Family TS0503A docs/knowledge/KB/devices/TS0503A.md
- Family TS0503B docs/knowledge/KB/devices/TS0503B.md
- Family TS0504B docs/knowledge/KB/devices/TS0504B.md
- Family TS0505A docs/knowledge/KB/devices/TS0505A.md
- Family TS0505B docs/knowledge/KB/devices/TS0505B.md
- Family TS0601 docs/knowledge/KB/devices/TS0601.md
- Family TS0603 docs/knowledge/KB/devices/TS0603.md
- Family TS0726 docs/knowledge/KB/devices/TS0726.md
- Family TS1001 docs/knowledge/KB/devices/TS1001.md
- Family TS1002 docs/knowledge/KB/devices/TS1002.md
- Family TS1101 docs/knowledge/KB/devices/TS1101.md
- Family TS110E docs/knowledge/KB/devices/TS110E.md
- Family TS110F docs/knowledge/KB/devices/TS110F.md
- Family TS1201 docs/knowledge/KB/devices/TS1201.md
- Family TS130F docs/knowledge/KB/devices/TS130F.md
- Family TS202PIR1-z docs/knowledge/KB/devices/TS202PIR1-z.md
- Family TSO121 docs/knowledge/KB/devices/TSO121.md
- Family TY0201-z docs/knowledge/KB/devices/TY0201-z.md
- Family TY0201 docs/knowledge/KB/devices/TY0201.md
- Family TY0202 docs/knowledge/KB/devices/TY0202.md
- Family TY0203 docs/knowledge/KB/devices/TY0203.md