Setup esp32-h2 zigbee

ESPHome
1

Hello guys!

I’m really new to this. I have an esp32-h2 mini. What I’m looking for is to implement this in esphome (Home Assistant). My idea is to connect it to ZHA. I’m going to use 3 digital signals (ON/OFF) from an external device that I want to make wireless over ZigBee to get these signals into Home Assistant. I’ve complained to ESP Home in Home Assistant and it feels like I’ve combed the net to understand how to install my esp32 card. Now to the problem. Once I’ve installed and flashed my card, it’s still offline. And I can’t find it in ZHA. So now my humble question is. Can anyone help me with a somewhat detailed instruction, step by step on how to do this successfully? Step by step of installation, YAML code, etc. Thanks in advance.

I have searched and read thousands of texts and instructions but haven’t found exactly one good instruction for this…

This is my YAML code in Esp Home HA.

esphome:
name: esptest
friendly_name: ESPTest
platformio_options:
board: esp32-h2-devkitm-1

esp32:
board: esp32-h2-devkitm-1
framework:
type: esp-idf

2

Esphome doesn’t have zigbee for your board. Literally for any board except experimental support for nrf52.

3

Thanks for answer…

Ok…

Getting so confused about this…
The update 18 June -25 says it has support for this card with ZigBee

4

You likely need to wait just little bit…
" Zigbee support is currently available only on nRF52 platforms."

5

So esp32 (esp home) doesn’t support zigbee?

Or the question is, is there any esp32 card with zigbee that esp home can handle?

6

Not at the moment.
More precisely, esphome handle the card with zigbee, just not zigbee feature of the card.

7

Ok. Understand.

Only WiFi at the moment…?

8

or ble, mqtt, open thread… some boards have ethernet…

9

I don´t really understand thread…

I have a c6 card to. What do you recommend for a beginner? Thread or WiFi?

10

Wifi of course. When zigbee matures, you can switch to that.

11

Ok. Thanks for all the help! :slight_smile:
Trying to boot up my C6 board and hope ZigBee will be implemented soon.

12

We all hope…

13

Read this feature request which was just now closed as first attemt has now been merged into ESPHome dev branch → Zigbee support on the ESP32-H2, ESP32-C6 and ESP32-C5 · Issue #1397 · esphome/feature-requests · GitHub

Better yet if specific to ESP32 then first post question to discussions here → luar123/zigbee_esphome · Discussions · GitHub

FYI, the initial pull request by luar123 to add support for Zigbee binary sensors on ESP32 H2 and ESP32-C6 has finally been merged to ESPHome mainline so should be included in next month’s ESPHome 2026.5.0 release (to be relesed some time in May of 2026):

Documentation for the upcoming ESPHome 2026.5.0 release has already been updated here:

Should be noted that a recent major change in Espressif’s upstream ESP Zigbee SDK will relativly soon require larger under-the-hood changes in the underlying zigbee_esphome component library that be built to enable this → GitHub - luar123/zigbee_esphome: External zigbee component · GitHub

_Originally posted by luar123 in [zigbee][core] Add support for Zigbee binary sensors on ESP32 H2 and C6 by luar123 · Pull Request #11553 · esphome/esphome · GitHub

I could bring forward more PRs for additional options, sensor, switch and number components quite fast. However, espressif released a version 2.0 zigbee sdk a few days ago. Currently I am implementing it in my external component to test it (this will probably take a few days). If it works well we should consider to update here, or in a separate PR, before the release because they change the zigbee partition type. Overall, changes are large, they dropped zboss in favor of their own stack and integration with esp-idf seems much better. Functional changes are small, so review effort should be low, but all functions/types/macros change names.

For reference see:

In summery:

  • v1.x is based on ZBOSS

    • LTS (Long-Term Support) version, which is under maintenance (bug fixes only, no new features).
    • It is stable for existing products.

  • v2.x is based on Espressif proprietary Zigbee stack

    • A fully self-developed Zigbee stack provides greater flexibility and better capability to meet the evolving requirements of the Zigbee market
    • Full control of the entire stack, enabling better hardware–software adaptation
    • Faster iteration for new features (e.g., Zigbee 4.0, direct) and bug fixes
    • Improved code efficiency and reduced code size

  • Espressif will provide an example demonstrating how to perform OTA from v1.x to v2.0 as soon as possible. In the meantime, you can review their migration guide to understand the differences between v1.x and v2.x.

  • The Zigbee 4.0 certification testing for v2.x is being planned and will be completed as soon as possible.

1 Like