Zigbee2MQTTZigbee2MQTT
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)
  • Getting started
  • Supported Hardware
    • Adapters
    • Devices
  • Installation
    • Linux
    • Docker
    • Home Assistant addon
    • openHABian
    • Windows
    • FreeBSD jail
    • Kubernetes
    • Watchdog
    • Zigbee2MQTT fails to start/crashes runtime
  • Configuration
    • Adapter settings
    • MQTT
    • Zigbee network
    • Frontend
    • Devices and Groups
    • Logging
    • Device blocklist / passlist
    • OTA device firmware update
    • Device Availability
    • Home Assistant integration
    • More configuration options
    • Configuration update
  • Usage
    • Allowing devices to join
    • Integrations
    • Touchlink
    • Scenes
    • Binding
    • Groups
    • OTA updates
    • MQTT Topics and Messages
    • Exposes
  • FAQ

ZBOSS adapters

ATTENTION

Support for this adapter is experimental, not recommended yet for production setups

The adapter for the ZBOSS protocol is based on the example of ZBOSS NCP Host Zigbee NCP (Network Co-Processor) for Nordic Semiconductor chips, such as nRF5340, nRF52840, nRF52833, nRF21540.

Also, thanks to the special firmware https://github.com/andryblack/esp-coordinator, ZBOSS protocol can be used to interact with the Espressif ESP32-C6/H2 chips.

The interaction between the chip and the host occurs according to ZBOSS NCP Serial Protocol.

The adapter code is based on the zigpy-zboss library.

ATTENTION

Currently, this adapter does not support various functions, so if you depend on these functions, consider using a different adapter.

  • Changing the channel, changing requires re-pairing all devices.
  • Adding install codes, which is required to pair some devices.
  • Backups
  • Inter-PAN, which is required for touchlink

Configuration

serial:
    adapter: zboss

Other supported settings are: adapter_concurrent and transmit_power (docs).

Hardware

Currently tested on nRF52840 Dongle, Nice!Nano v2 (nRF52840) and ESP32-C6/H2 devboards.

  • Pre build coordinator firmware for Nordic Semiconductor with nRF52840 SoC
  • Pre build coordinator firmware for Nice!Nano v2 with nRF52840 SoC
Nice!Nano v2
  • Experimental ESP32-C6 firmware
Help to make the docu better and edit this page on Github ✌
Last Updated:: 5/16/25, 7:53 PM