tests: drivers: audio: Add test that collects audio from microphone

Verify operation of PDM driver with physical microphone and
sound analysis.

Signed-off-by: Sebastian Głąb <sebastian.glab@nordicsemi.no>

Author: nordic-segl

tests/drivers/audio/dmic_dump_buffer/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(dmic)
+
+target_sources(app PRIVATE src/main.c)

tests/drivers/audio/dmic_dump_buffer/boards/nrf52840dk_nrf52840.overlay

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2021 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&pinctrl {
+	pdm0_default_alt: pdm0_default_alt {
+		group1 {
+			psels = <NRF_PSEL(PDM_CLK, 0, 30)>,
+				<NRF_PSEL(PDM_DIN, 0, 31)>;
+		};
+	};
+};
+
+dmic_dev: &pdm0 {
+	status = "okay";
+	pinctrl-0 = <&pdm0_default_alt>;
+	pinctrl-names = "default";
+	clock-source = "PCLK32M_HFXO";
+};
+
+&uart0 {
+	current-speed = < 921600 >;
+};

tests/drivers/audio/dmic_dump_buffer/boards/nrf5340dk_nrf5340_cpuapp.overlay

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2021 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&clock {
+	hfclkaudio-frequency = <12288000>;
+};
+
+&pinctrl {
+	pdm0_default_alt: pdm0_default_alt {
+		group1 {
+			psels = <NRF_PSEL(PDM_CLK, 0, 25)>,
+				<NRF_PSEL(PDM_DIN, 0, 26)>;
+		};
+	};
+};
+
+dmic_dev: &pdm0 {
+	status = "okay";
+	pinctrl-0 = <&pdm0_default_alt>;
+	pinctrl-names = "default";
+	clock-source = "ACLK";
+};
+
+&uart0 {
+	current-speed = < 921600 >;
+};

tests/drivers/audio/dmic_dump_buffer/boards/nrf54l15dk_nrf54l15_cpuapp.overlay

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2024 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&pinctrl {
+	pdm20_default_alt: pdm20_default_alt {
+		group1 {
+			psels = <NRF_PSEL(PDM_CLK, 1, 12)>,
+				<NRF_PSEL(PDM_DIN, 1, 13)>;
+		};
+	};
+};
+
+dmic_dev: &pdm20 {
+	status = "okay";
+	pinctrl-0 = <&pdm20_default_alt>;
+	pinctrl-names = "default";
+	clock-source = "PCLK32M";
+};
+
+&uart20 {
+	current-speed = < 921600 >;
+};

tests/drivers/audio/dmic_dump_buffer/prj.conf

@@ -0,0 +1,11 @@
+CONFIG_BOOT_BANNER=n
+CONFIG_NCS_BOOT_BANNER=n
+
+CONFIG_AUDIO=y
+CONFIG_AUDIO_DMIC=y
+
+CONFIG_LOG=n
+CONFIG_LOG_MODE_IMMEDIATE=n
+CONFIG_PRINTK=y
+
+CONFIG_MAIN_STACK_SIZE=16384

tests/drivers/audio/dmic_dump_buffer/sample.yaml

@@ -0,0 +1,17 @@
+sample:
+  name: DMIC sample
+tests:
+  sample.drivers.audio.dmic_dump_buffer:
+    tags: dmic
+    filter: dt_nodelabel_enabled("dmic_dev")
+    integration_platforms:
+      - nrf52840dk/nrf52840
+      - nrf5340dk/nrf5340/cpuapp
+      - nrf54l15dk/nrf54l15/cpuapp
+    harness: console
+    harness_config:
+      type: multi_line
+      ordered: true
+      regex:
+        - "DMIC sample"
+        - "Exiting"

tests/drivers/audio/dmic_dump_buffer/src/main.c

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <string.h>
+#include <zephyr/kernel.h>
+#include <zephyr/audio/dmic.h>
+
+#include <zephyr/logging/log.h>
+LOG_MODULE_REGISTER(dmic_sample);
+
+#define SAMPLE_RATE  16000
+#define SAMPLE_BIT_WIDTH 16
+#define BYTES_PER_SAMPLE (SAMPLE_BIT_WIDTH / 8)
+#define NO_OF_CHANNELS	1
+
+/* Milliseconds to wait for a block to be captured by PCM peripheral. */
+#define READ_TIMEOUT     1200
+
+/* Driver will allocate blocks from this slab to receive audio data into them.
+ * Application, after getting a given block from the driver and processing its
+ * data, needs to free that block.
+ */
+#define AUDIO_BLOCK_SIZE   (BYTES_PER_SAMPLE * SAMPLE_RATE * NO_OF_CHANNELS / 10)
+/* Why driver fails when BLOCK_COUNT is decreased to 2? */
+#define BLOCK_COUNT      4
+K_MEM_SLAB_DEFINE_STATIC(mem_slab, AUDIO_BLOCK_SIZE, BLOCK_COUNT, 4);
+
+int main(void)
+{
+	const struct device *const dmic_dev = DEVICE_DT_GET(DT_NODELABEL(dmic_dev));
+	int ret;
+	int loop_counter = 1;
+	void *buffer;
+	uint32_t size;
+
+	if (!device_is_ready(dmic_dev)) {
+		LOG_ERR("%s is not ready", dmic_dev->name);
+		return 0;
+	}
+
+	struct pcm_stream_cfg stream = {
+		.pcm_rate = SAMPLE_RATE,
+		.pcm_width = SAMPLE_BIT_WIDTH,
+		.block_size = AUDIO_BLOCK_SIZE,
+		.mem_slab  = &mem_slab,
+	};
+
+	struct dmic_cfg cfg = {
+		.io = {
+			/* These fields can be used to limit the PDM clock
+			 * configurations that the driver is allowed to use
+			 * to those supported by the microphone.
+			 */
+			.min_pdm_clk_freq = 1000000,
+			.max_pdm_clk_freq = 3250000,
+			.min_pdm_clk_dc   = 40,
+			.max_pdm_clk_dc   = 60,
+		},
+		.streams = &stream,
+		.channel = {
+			.req_num_chan = 1,
+			.req_num_streams = 1,
+			.req_chan_map_lo = dmic_build_channel_map(0, 0, PDM_CHAN_LEFT),
+		},
+	};
+
+	ret = dmic_configure(dmic_dev, &cfg);
+	if (ret < 0) {
+		LOG_ERR("Failed to configure the driver: %d", ret);
+		return ret;
+	}
+
+	ret = dmic_trigger(dmic_dev, DMIC_TRIGGER_START);
+	if (ret < 0) {
+		LOG_ERR("START trigger failed: %d", ret);
+		return ret;
+	}
+
+	while (1) {
+		ret = dmic_read(dmic_dev, 0, &buffer, &size, READ_TIMEOUT);
+		if (ret < 0) {
+			LOG_ERR("%d - read failed: %d", loop_counter, ret);
+			return ret;
+		}
+
+		/* Print buffer on serial in binary mode */
+		unsigned char pcm_l, pcm_h;
+		int j;
+
+		uint16_t *pcm_out = buffer;
+		// uint8_t *pcm_out = buffer;
+
+		for (j = 2; j < size/2; j++) {
+			pcm_l = (char)(pcm_out[j] & 0xFF);
+			pcm_h = (char)((pcm_out[j] >> 8) & 0xFF);
+
+			z_impl_k_str_out(&pcm_l, 1);
+			z_impl_k_str_out(&pcm_h, 1);
+		}
+
+		// for (j = 0; j < size; j+=2) {
+		// 	pcm_l = (char)pcm_out[j];
+		// 	pcm_h = (char)pcm_out[j+1];
+
+		// 	z_impl_k_str_out(&pcm_l, 1);
+		// 	z_impl_k_str_out(&pcm_h, 1);
+		// }
+
+		k_mem_slab_free(&mem_slab, buffer);
+
+		loop_counter++;
+	}
+
+	ret = dmic_trigger(dmic_dev, DMIC_TRIGGER_STOP);
+	if (ret < 0) {
+		LOG_ERR("STOP trigger failed: %d", ret);
+		return ret;
+	}
+
+	return 0;
+}