
Writing a Custom ZHA Quirk for an Unsupported Zigbee Device
Your Zigbee device pairs with ZHA but exposes only generic entities. How to enable custom quirks and write one with QuirkBuilder, entirely locally.
Setup guides

Your Zigbee device pairs with ZHA but exposes only generic entities. How to enable custom quirks and write one with QuirkBuilder, entirely locally.

Zigbee2MQTT's \"Failed to configure\" error explained: what the ZCL status codes mean, when it's harmless, and how to force a reconfigure without re-pairing.

Zigbee2MQTT's Remove, Force Remove, and a physical factory reset do three different things to a device's network key. The mechanism, and which one to use before you sell or bin hardware.

Secondhand Hue or IKEA Zigbee bulbs won't join Zigbee2MQTT until factory-reset. Here's how Touchlink does that over MQTT, and which devices it works on.

The Tuya TS0043 3-button switch also ships as LoraTap SS600ZB and Lonsonho TS0043. Pairing, entities, and automations in Zigbee2MQTT or ZHA — fully local.

Your Zigbee2MQTT coordinator flags outdated firmware. Here's when updating is worth it, how to back up first, and the right tool per adapter.

There's no in-place transfer from a Tuya Zigbee gateway to Zigbee2MQTT. Here's the reset-and-rejoin process, and what breaks in Home Assistant.

Getting a Tuya local key for LocalTuya or tuya-local still works in 2026, but a subscription-expiration wall stops most first-timers. Here's the fix.

Set up the SMLIGHT SLZB-06 Ethernet Zigbee coordinator in Zigbee2MQTT: TCP vs mDNS, PoE and USB-C power, offline firmware, and SLZB-06 vs SLZB-07.

Pair the Aqara B1 (ZNCLDJ12LM) to Zigbee2MQTT without the Aqara Hub, run the mandatory reset_limits calibration, and fix the 99%/1% position drift bug.