Hi everyone!
I’d like to share TelinkHome, a project I’ve been building to bring an ESPHome-style experience to Telink TLSR825x-based Zigbee devices — switches, sockets, relays, sensors and more.
Why this exists
Telink TLSR8xxx chips are everywhere in Zigbee hardware. A huge share of the Tuya, Avatto, Moes, Bseed and many other brands’ Zigbee switches/sockets/sensors on the market run on TLSR825x. But for ESP32 we have ESPHome, while these chips had no easy “write a YAML, get firmware” workflow. TelinkHome aims to fill that gap.
What it is
A declarative, ESPHome-style framework: describe your device in a single device.yaml, and it compiles into ready-to-flash firmware — with ZHA quirks and Zigbee2MQTT external converters generated automatically.
device.yaml → codegen → make → firmware (.bin / .zigbee / z2m / zha)
Highlights
- Template-first: 220+ known device templates (TS0001, TS011F, TS0201, …) — pick one, tweak a few pins, compile
- Standardized Zigbee 3.0 structure: cluster/attribute mapping follows the standard profile, so devices behave correctly in ZHA / Z2M
- Auto-generated adapters: ZHA quirk + Z2M external converter + OTA index are produced for every build
- Local builds: compile on Windows / Linux / HAOS (aarch64 via QEMU) or directly inside Home Assistant via the add-on
- Component library: button / relay / led / battery / pir / reed / th_sensor / cover / cover_switch… with more coming progressively
Three ways to use it
- CLI —
tlh build devices/xxx.yaml - Local web dashboard —
python -m www, manage devices and compile in the browser - Home Assistant add-on — TelinkHome Builder: compile and flash right in HA, no command line needed
Credits
Standing on the shoulders of giants:
- pvvx/TLSRPGM — SWire programmer tooling
- tuya-zigbee-switch (TYS) — major reference for Tuya device configs
- ESPHome — the declarative YAML idea and the device-builder UX
- pvvx/ZigbeeTLc — same-chip firmware reference
Repositories
- Firmware framework: github.com/waxgourd-ha/telinkhome
- HA app: github.com/waxgourd-ha/telinkhome-ha
Feedback, device requests and pull requests are very welcome!
