Configuration options
This page lists the Kconfig options provided by the Matter and Zigbee add-on.
See Configuring and building in the nRF Connect SDK documentation for information about how to permanently or temporarily change the configuration.
Add-on Kconfig options
- CONFIG_MATTER_ZIGBEE_ADD_ON
(bool) Enable Matter + Zigbee add-on
Add-on module for combined Matter and Zigbee solutions. Requires both the ncs-zigbee (ZIGBEE_ADD_ON) and Matter (CHIP).
- CONFIG_MATTER_ZIGBEE_COEXISTENCE
(bool) Matter + Zigbee coexistence runtime for combined applications
Shared orchestration layer for samples that host both Matter and Zigbee stacks on the same 802.15.4 radio. Owns the Zigbee and Matter worker threads, the radio handover on first Matter commissioning, and updates the persistent protocol state across reboots and factory resets.
On last-fabric removal the device reboots and resumes the protocol selected by CONFIG_MATTER_ZIGBEE_PROTOCOL_STATE_DEFAULT_PROTOCOL.
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_BT_ADV_WHILE_ZIGBEE
(bool) Allow CHIPoBLE commissioning while Zigbee is active
When enabled, Matter may start BLE commissioning advertising while the Zigbee stack owns the 802.15.4 radio. The Zigbee worker waits for the first CHIPoBLE advertising-started event before chaining sample button handlers and starting Zigbee.
Requires CONFIG_CHIP_ENABLE_PAIRING_AUTOSTART in the application.
When disabled, the sample must call matter_zigbee_coexistence_signal_matter_board_init() after Matter server init completes. The Zigbee worker then proceeds without waiting for Thread or DNS-SD. Set CONFIG_CHIP_ENABLE_PAIRING_AUTOSTART=n if Matter commissioning over BLE is not needed until after a protocol switch.
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_BUTTON_SWITCH
(bool) Enable user protocol switch on button long press
When enabled, samples may call matter_zigbee_coexistence_process_switch_button() to switch between Zigbee and Matter using a long button press.
When disabled, protocol changes rely on Matter commissioning events and factory reset only.
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_SWITCH_BUTTON_PRESS_TIME_SECONDS
(int) Protocol-switch button hold time (seconds)
Hold time required when pressing the protocol-switch button. When the timer expires, the coexistence runtime attempts to switch to the other protocol unless pairing or commissioning is in progress.
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_ZIGBEE_THREAD_STACK_SIZE
(int) Zigbee worker thread stack size (bytes)
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_ZIGBEE_THREAD_PRIORITY
(int) Zigbee worker thread priority
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_MATTER_THREAD_STACK_SIZE
(int) Matter worker thread stack size (bytes)
- CONFIG_MATTER_ZIGBEE_COEXISTENCE_MATTER_THREAD_PRIORITY
(int) Matter worker thread priority
- CONFIG_MATTER_ZIGBEE_PROTOCOL_STATE
(bool) Persistent protocol state for combined Matter + Zigbee applications
Small settings-backed module that tracks which protocol (Zigbee or Matter) the combined application should resume after a reboot. Used by samples that host both stacks on the same 802.15.4 radio.
- CONFIG_MATTER_ZIGBEE_PROTOCOL_STATE_DEFAULT_ZIGBEE
(bool) Zigbee
Start on Zigbee: bring up the Zigbee stack and hand the 802.15.4 radio to ZBOSS unless a previous run already persisted Matter.
- CONFIG_MATTER_ZIGBEE_PROTOCOL_STATE_DEFAULT_MATTER
(bool) Matter
Start on Matter: skip Zigbee stack start and hand the 802.15.4 radio to OpenThread unless a previous run already persisted Zigbee.
- CONFIG_MATTER_ZIGBEE_UI
(bool) Common Matter + Zigbee UI for combined samples
Shared button and LED handling for combined Matter + Zigbee samples. Samples register optional callbacks from main() and pass matter_zigbee_ui_register() as the coexistence post_matter_ui_init hook. That hook calls dk_buttons_init() for the common UI dispatcher.
- CONFIG_MATTER_ZIGBEE_UI_FACTORY_RESET_PRESS_TIME_SECONDS
(int) Matter factory reset button press time (seconds)
Total time budget for the Matter factory-reset button gesture on MATTER_ZIGBEE_UI_BUTTON_FACTORY_RESET. Half of this value is the initial hold before the cancel window opens; the other half is the cancel window duration (keeping the button pressed through it confirms the reset).
- CONFIG_MATTER_ZIGBEE_UI_SMP_DFU
(bool) SMP DFU button in common UI
Enables button handling to start BT SMP DFU advertising.
- CONFIG_MATTER_ZIGBEE_UI_DISABLE_LEDS
(bool) Disable DK LEDs usage
Disable all DK LED indications in the application.