Configuration options

This page lists the Kconfig options provided by the Matter Edge AI add-on.

To use the add-on in a Matter application, enable the CONFIG_MATTER_EDGEAI Kconfig option. This option pulls in the nRF Edge AI library and the integration layer between Matter and Edge AI.

The options are grouped as follows:

Add-on options — Top-level options that enable and configure Matter Edge AI support.
Sample configuration options — Shared options used by the Matter Edge AI samples for wakeword and keyword spotting, DMIC settings, and related features.

See Configuring and building in the nRF Connect SDK documentation for information about how to permanently or temporarily change the configuration. For details about the Kconfig options mentioned here, see the Kconfig search in the nRF Connect SDK documentation.

Add-on Kconfig options 

CONFIG_MATTER_EDGEAI

(bool) Matter with nRF Edge AI

Integration of Matter application with the nRF Edge AI library.

CONFIG_MATTER_EDGEAI_DETAILED_MODEL_LOGS

(bool) Prints live probabilities

Prints all the output probabilities of the model for easier debugging.

CONFIG_MATTER_EDGEAI_DMIC

(bool) Matter Edge AI DMIC

Enable the Matter Edge AI DMIC module. DMIC provides an interface to the digital microphone. The audio is captured and processed by the Edge AI model.

CONFIG_MATTER_EDGEAI_DMIC_MEM_SLAB_NUM_BLOCKS

(int) DMIC PCM memory slab block count

Number of RX blocks for the Zephyr DMIC driver mem slab (matter_common dmic). Fewer blocks reduce RAM when the reader keeps up with capture; increase if you see audio underruns when inference occasionally stalls.

CONFIG_MATTER_EDGEAI_DMIC_GAIN

(hex) DMIC gain

Gain for the DMIC driver. The value represents: 0x00 - 0dB, 0x40 - +20 dB, 0x80 - +40 dB.

CONFIG_MATTER_EDGEAI_DIMMING

(bool) Matter Edge AI Dimming

Enable the Matter Edge AI Dimming module. Dimming provides an interface to the LED PWM. The LED PWM is used to dim the LED light when the wakeword is detected.

CONFIG_MATTER_EDGEAI_DIMMING_FX_TICK_MS

(int) PWM dimming effect tick period (milliseconds)

Interval for the dimming work handler. Larger values reduce scheduling overhead at the cost of slightly coarser LED PWM steps.

CONFIG_MATTER_EDGEAI_WAKEWORD_PROBABILITY_THRESHOLD

(int) Wakeword probability threshold

Probability threshold for wakeword detection model. The value is expressed in units of 1/1000.

CONFIG_MATTER_EDGEAI_WAKEWORD_HISTORY_SIZE

(int) Size of wakeword predictions history

Size of history of previous results from wakeword detection model. Each entry corresponds to 30 milliseconds of past audio.

CONFIG_MATTER_EDGEAI_WAKEWORD_COUNT_THRESHOLD

(int) Threshold for wakeword detection from predictions history

Number of predictions above threshold in predictions history required to confirm wakeword detection.

CONFIG_MATTER_EDGEAI_KEYWORD_DETECTION_TIMEOUT_S

(int) Timeout for keyword detection in seconds

Timeout for keyword detection in seconds after recognizing the wakeword.

CONFIG_MATTER_EDGEAI_TASK_THREAD_STACK_SIZE

(int) Edge AI task thread stack size in bytes

Stack size for the Edge AI wakeword/keyword task thread.

CONFIG_MATTER_EDGEAI_TASK_THREAD_PRIORITY

(int) Edge AI task thread priority

Preemptible priority of the Edge AI wakeword/keyword task thread.

CONFIG_MATTER_EDGEAI_WW_KW_LOG_LEVEL

(int) Edge AI wakeword/keyword log level

Log level for the Edge AI wakeword/keyword task and model processing modules.

CONFIG_FPU

(bool) Enable hardware Floating Point Unit (FPU) support.

This option enables use of the hardware floating point unit (FPU) if present on the target device. When enabled, the system will make use of the hardware FPU during context switching, and FPU registers will be preserved as part of the thread context. Applications can then use floating point operations in C code and assembly, provided the underlying hardware supports it.

Note: Enabling the FPU incurs additional overhead in interrupt and thread context switches due to saving and restoring the extra registers. Not all targets have a hardware FPU; enabling this on hardware without FPU support will have no effect or may cause build errors.

CONFIG_NEWLIB_LIBC

(bool) Build with the Newlib C library.

Build with the Newlib library. The Newlib library is expected to be part of the SDK in this case.

Sample configuration options 

CONFIG_MATTER_EDGEAI_DETAILED_MODEL_LOGS