Universal Tuya docsHomeSupported devicesRequest a deviceFAQChangelogArchitectureKnowledge baseCreditsSourcesContributing

KB sources (P-KB)

Mirrors live outside the repo (/workspace/kb/<source>, shallow git clones). The repo keeps only ids + facts + commit-pinned links (data/kb/couples.json, docs/knowledge/KB/). No upstream prose is copied.

sourcelinklicenceused for
Zigbee2MQTT docshttps://github.com/Koenkk/zigbee2mqtt.ioGPL-3.0device pages (model, vendor, exposes, options), guide outline
zigbee-herdsman-convertershttps://github.com/Koenkk/zigbee-herdsman-convertersMITfingerprints (tuya.fingerprint / zigbeeModel)
ZHA device handlershttps://github.com/zigpy/zha-device-handlersApache-2.0quirk fingerprints, DP ids
deCONZ DDFhttps://github.com/dresden-elektronik/deconz-rest-pluginBSD-3-ClauseDDF fingerprints, items
Blakadder templateshttps://github.com/blakadder/zigbeeMITwhite-label models
tuya-localhttps://github.com/make-all/tuya-localMITWi-Fi product ids, DP ids, entities
tinytuyahttps://github.com/jasonacox/tinytuyaMITLAN protocol versions/constants
localtuyahttps://github.com/rospogrigio/localtuyaGPL-3.0LAN protocol notes (ideas only)
Johan Bendz Tuya Zigbeehttps://github.com/JohanBendz/com.tuya.zigbeeGPL-3.0driver couples
Athom zigbee-clustershttps://github.com/athombv/node-zigbee-clustersMITcluster/attribute ids
Koenkk zigbee-OTAhttps://github.com/Koenkk/zigbee-OTAsee repoOTA image index (code, type, version, sha512)
Homey Apps SDK docshttps://apps.developer.homey.app (the old GitHub repo athombv/homey-apps-sdk-v3-docs is gone, 404 since 2026-10-24)AthomSDK rules (links only)
Tuya developer docs (MCU/Zigbee serial)https://developer.tuya.com/en/docs/iotTuyaEF00 command semantics (links only)

Refresh: scripts/kb/refresh.sh (git fetch per mirror; rebuild only when HEAD changed; outputs byte-identical when unchanged).

Alternative projects (P3017)

Scanned 2026-10-24 (Europe/Paris) for how they handle unknown commands, fallbacks, polling, magic packets, time sync and reporting. Incremental scan pointer = the commit or push date below; next scan starts from there.

projectbranchlicencepointerused for
Koenkk/zigbee-herdsman-convertersmasterMIT7462b54 (2026-10-25)tuya.ts private commands, tuyaDatapoints names, magic packet, mcuSyncTime
Koenkk/zigbee-herdsmanmasterMIT6764136 (2026-10-25)manuSpecificTuya cluster commands
Koenkk/zigbee2mqttmasterGPL-3.0pushed 2026-10-24 (checked 2026-10-25)ideas only
zigpy/zha-device-handlersdevApache-2.02b1abce (2026-10-26)Tuya private clusters, TSN dedup, rotate_type
zigpy/zhadevApache-2.06decce1ed4 (2026-10-24, deps only)quirks v2 behaviour
dresden-elektronik/deconz-rest-pluginmasterBSD-3-Clausepushed 2026-09-10DDF read functions, refresh.interval
make-all/tuya-localmainMIT633c008 (2026-11-03)unknown DP exposure, DP refresh
rospogrigio/localtuyamasterGPL-3.0pushed 2026-01-29ideas only
xZetsubou/hass-localtuyamasterGPL-3.0pushed 2026-10-21ideas only
jasonacox/tinytuyamasterMITpushed 2026-10-13DP_QUERY / UPDATEDPS
kkossev/Hubitatdevelopmentnone statedpushed 2026-10-20ideas only (no licence: nothing reused)
SmartThingsCommunity/SmartThingsEdgeDriversmainApache-2.071bea06957 (2026-11-03)sub-driver chain, health check
ioBroker/ioBroker.zigbeemasterMITpushed 2026-10-16polling option
domoticz/domoticzdevelopmentGPL-3.0pushed 2026-10-19ideas only
zigbeefordomoticz/Domoticz-Zigbeestable9GPL-3.0pushed 2026-10-24 (no stable9 commit)ideas only
arendst/TasmotadevelopmentGPL-3.0568220d (2026-11-03, changelogs only)raw unknown attribute logging (idea)
esphome/esphomedevsee repob90e1e43a3 (2026-10-24, components/tuya)Tuya DP query at boot (idea)
Koenkk/zigbee-OTAmasterGPL-3.0df5e8e13f0 (2026-10-25, index.json unchanged)OTA index
blakadder/zigbeemasterMITd96e8aaf72white-label models
JohanBendz/com.tuya.zigbeeSDK3see repo328d24e (v0.2.76); issues updated to 2026-11-02 read (#1549)issue #619 DP101/DP102; #1534 _TZ3000_pd9mpyh4 TS0044 interview

Forum topics scanned for unknown commands: Homey Community 140352 and 26439 (anonymised, facts only).

P3019 sources (2026-10-24)

sourcepointerused for
Koenkk/zigbee-herdsman-converters src/devices/tuya.ts1c90116ZS-SF00 DP map; HZ-WT02 TS0049 0xE001/0xFE countdown; TS004F 0x8004 mode
Koenkk/zigbee2mqtt#31445issuesinxpbrl Tuya schema (DP2, DP6, DP7, DP101, DP102)
JohanBendz/com.tuya.zigbee#1504issuesinxpbrl MC101Z report
zigpy/zha-device-handlers PR #2592PRTuyaZB1888Cluster (empty: 0x1888 stays open)
make-all/tuya-localmainchecked for TS0726 DP18–20: Wi-Fi only, not used

DP + endpoint coverage (P3018)

dataupstreamlicencepointerused for
scripts/data/z2m-tuya-dps.jsonKoenkk/zigbee-herdsman-converters src/devices/*.ts tuyaDatapointsMITcff1de4731exact couple → DP name + converter token (facts only, rebuilt daily by scripts/kb/refresh.sh)
scripts/data/zha-tuya-dps.jsonzigpy/zha-device-handlers Tuya quirks (KB index)Apache-2.01d6598c32aDP numbers per couple (coverage audit)
scripts/data/zha-quirk-dps.jsonzigpy/zha-device-handlers zhaquirks/** (QuirkBuilder v2 chains + v1 dp_to_attribute)Apache-2.01d6598c32aP3018b: exact per-quirk couple → DP + attribute name + scaling (ZCL centi-units converted); fill-only into the catalogue
scripts/data/deconz-tuya-dps.jsondresden-elektronik/deconz-rest-plugin devices/**/*.json DDF (fn: tuya items)BSD-3-Clausea4c17adfa0P3018b: exact couple → dpid + item + scaling (deCONZ 0.01 units converted); fill-only into the catalogue
lib/zigbee/data/inferred-dp-family.jsonderived from the catalogue rows above (no new upstream)——P3018b: optional inferred family candidates (pid+driver / driver / name+DP id), confirmed per device at runtime by lib/zigbee/InferredDpLayer.js (master)
lib/zigbee/EndpointCoverage.jsZCL specification (cluster ids, measuredValue scaling)——passive per-endpoint routing

One couple = one driver (P3018b)

couple(s)ownerupstream pointer (Koenkk/zigbee-herdsman-converters @cff1de4731)
_TZE200_2pddnnrk, _TZE200_jsaqgakfrain_sensorsrc/devices/hobeian.ts ZG-223Z
_TZE200_4mh6tyyo, _TZE204_dcnsggvz, _TZE204_9qhuzgo0, _TZE204_5cuocqtydimmer_1_gang_tuyasrc/devices/tuya.ts, src/devices/avatto.ts ZDMS16-1
_TZE200_bjzrowv2, _TZE284_r3szw0xr, _TZE200_eqpaxqdvcurtain_motorsrc/devices/tuya.ts covers, KnockautX PIMS3028
_TZE200_locansqnlcdtemphumidsensorsrc/devices/nous.ts SZ-T04
_TZE200_ntcy3xu1smoke_sensor2src/devices/tuya.ts smoke (smoke/tamper/battery)
_TZE200_rgeapp2cpanel_switch_cover_tuyasrc/devices/tuya.ts Semicom panel
_TZE200_zl1kmjqxlcdtemphumidsensor_3src/devices/tuya.ts temp/humidity
_TZE204_6fk3gewc, _TZE284_6fk3gewcwall_switch_1gang_1waysrc/devices/weten.ts PCI E
_TZE204_mrffaamu, _TZE284_mrffaamu, _TZE284_9xstqowhsmart_breakersrc/devices/tuya.ts Tongou TOQCB2-80
_TZE204_loejka0i, _TZE284_loejka0ienergy_meter_3phasesrc/devices/nous.ts D4Z
HOBEIAN CK-BL702-MWS-01(7016)presence (not vibration_sensor)src/devices/hobeian.ts ZG-205Z/A; zigpy/zha-device-handlers tuya_motion.py
_TYST11_jeaxp72v / eaxp72vdevice_radiator_valvesrc/devices/siterwell.ts GS361A-H04
_TZ3000_cet6ch1r TS130F EP2 0x0102curtain_motor_wall (passive EP2 info)src/lib/tuya.ts cover_options: EP2 = calibration "to_close", moesCalibrationTime ÷10 s
_TZE200_9cqcpkgbsoil_sensorsrc/devices/tuya.ts TS0601_soil
_TZE284_33bwcga2, _TZE284_3urschql, _TZE284_ap9owrsa, _TZE284_nhgdf6qr, _TZE284_wckqztdqsoil_sensorsrc/devices/tuya.ts TS0601_soil_3 (GIEX GX04/GX06)
_TZE284_k7p2q5d9, _TZE284_65gzcss7, _TZE284_yzr43ayqsoil_sensorsrc/devices/tuya.ts Arteco ZS-300Z/302Z/304Z

Daily refresh log

People and projects are credited on the credits page.