This Repo Contains ESPHome YAML configurations and other files that might be useful in building Zigbee devices using ESPHome 2026.2.1+
This may not be backwards compatible with older versions of ESPHome, I suggest using ESPHome 2026.2.1 (or above)
As of 6/23/2026, these compile on 2026.6.2. These files should work without issues on the current version of ESPHome.
To update: Erase your device using the ESP Tool, remove from ZHA, flash the updated config file, then add back to ZHA.
Be warned, ESPHome will ALWAYS break non-standard/custom integrations on a new version. As a rule, you should NEVER trust software updates will work as intended. Always make several backups (including yaml files, encryption keys, etc.).
To save yourself a lot of frustration and anger, you should ALWAYS freeze any working version of ESPHome by using khendrick's ESPHome legacy addons (i.e. Before a new monthly release, install the current month's legacy add-on. Doing things this way will allow you beta test future versions until everything can correctly compile on your specialized hardware.)
If you are having issues with ZHA, take a look at some tips I created here: zhatips.md
Firmware cannot be sent via Zigbee OTA at this time. Updates only work via USB/UART using the procedure below. You do not need to constantly update your devices on ESPHome, unless there's a compelling reason.
For example, ESPHome 2026.2 improves system resource usage and system event processing times, so it might make your mesh happier.
- ALWAYS clear build files in ESPHome AND
- Fully ERASE the device's flash memory by using the ESP Tool before you
- Update your device's firmware and
- Be prepared to delete and re-pair any device you update.
This is made possible by the hard work of @luar123 for the zigbee_esphome external component. A lot of the code is based on examples in the github repo above, but I was having some issues getting started and a lot was discovered by trial and error. I'd like to save you some time and frustration.
These are sorted by devkit manufacturer and function.
- m5stack.md Contains instructions for making lights using the M5Stack NanoC6
- xiao.md Contains instructions for using the XIAO MR60BHA2 60GHz mmWave Human Breathing and Heartbeat Sensor Kit
- waveshare.md Contains instructions for using the Waveshare ESP32-C6-DEV-KIT-N8 (and likely other makers too) to make multi sensors. (Uses LD2410B, BME680, and generic lux sensors)
- esp32H2.md Contains instructions for a basic router and LED light using a generic ESP32-H2-DevKitM-1-N4S.