Zigbee component

Zigbee is a low-power mesh networking standard for IoT devices. The low-power aspect is important for battery-powered smart home devices. However, it’s also low-bandwidth, making it ideal for applications that don’t send a lot of data, like switches or motion sensors.

Zigbee uses the same RF technology as Thread (IEEE 802.15.4) but defines also multiple application standards. This component, however, supports only the Homeautomation profile. This component allows exposing supported ESPHome components over a Zigbee network to Home Assistant via Zigbee2MQTT or ZHA.
Due to the limitations of the Zigbee protocol, only basic properties are exposed. Additional properties must be configured manually in Home Assistant.

ℹ️ Note
You will need a Zigbee coordinator like Zigbee2MQTT or ZHA.

Usage

This component requires an ESP32 with IEEE 802.15.4 connectivity (ESP32-C6 or ESP32-H2) and the use of ESP-IDF.

# Example ESP-IDF configuration for ESP32-C6-DevKitM-1 board
esp32:
  board: esp32-c6-devkitm-1
  framework:
    type: esp-idf

⚠️ Warning
Whenever the configuration is changed, the device should be re-inerviewed (z2m only) and removed and re-added to the Zigbee network. This is especially important if components are added or removed or if names change.

Full Configuration

This example show how to configure the Zigbee component.

# Example configuration entry
zigbee:

Configuration variables

name (Optional, string): Name of the Zigbee device. Defauts to the ESPHome node name.
router (Optional, boolean): If true the Zigbee role will be router instead of end device and it will forward Zigbee packets from other devices. Don’t use this for battery powered devices. Defaults to false.

Actions

`factory_reset` Action

This action triggers a factory reset of the Zigbee device. It handles the leaving of the Zigbee network.

on_...:
  then:
    - zigbee.factory_reset

Supported Components

Binary Sensor: only state and name are exposed over Zigbee.