sample: adc_stream: Add sample app for ADC stream

Add sample application to demonstrate new ADC stream APIs.
Two tests are also added:
- ad4052-stream
- max32-stream

Signed-off-by: Vladislav Pejic <vladislav.pejic@orioninc.com>

Author: vladislav-pejic

samples/drivers/adc/adc_stream/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(adc_stream)
+
+target_sources(app PRIVATE src/main.c)

samples/drivers/adc/adc_stream/README.rst

@@ -0,0 +1,42 @@
+.. zephyr:code-sample:: adc_stream
+   :name: Generic ADC stream
+   :relevant-api: adc_interface
+
+   Get data from a ADC using stream.
+
+Overview
+********
+
+This sample application demonstrates how to use ADC stream APIs.
+
+Building and Running
+********************
+
+This sample supports one ADC. ADC needs to be aliased as ``adc0`` in devicetree.
+For example:
+
+.. code-block:: devicetree
+
+ / {
+	aliases {
+			adc0 = &ad4052;
+		};
+	};
+
+Make sure the aliase are in devicetree, then build and run with:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/drivers/adc/adc_stream
+   :board: <board to use>
+   :goals: build flash
+   :compact:
+
+Sample Output
+=============
+
+.. code-block:: console
+
+	ADC data for adc405@0 (0.000074) 942995000ns
+	ADC data for adc405@0 (0.000446) 963059000ns
+	ADC data for adc405@0 (0.000297) 983124000ns
+	ADC data for adc405@0 (0.000446) 1003189000ns

samples/drivers/adc/adc_stream/ad4052-stream.conf

@@ -0,0 +1,7 @@
+# Copyright (c) 2025 Analog Devices, Inc.
+# SPDX-License-Identifier: Apache-2.0
+CONFIG_SPI=y
+CONFIG_SPI_RTIO=y
+CONFIG_AD405X_STREAM=y
+CONFIG_COUNTER=y
+CONFIG_COUNTER_TIMER_MAX32=y

samples/drivers/adc/adc_stream/boards/apard32690_max32690_m4_ad4052.overlay

@@ -0,0 +1,11 @@
+/*
+ * Copyright (c) 2025 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&arduino_spi {
+	adc4052_eval_ad4052_ardz: adc4052@0 {
+		sampling-period = <20000>; /*uS*/
+	};
+};

samples/drivers/adc/adc_stream/boards/apard32690_max32690_m4_max32.overlay

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2025 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		adc0 = &adc;
+	};
+
+	zephyr,user {
+		io-channels = <&adc 0>;
+	};
+};
+
+&adc_clk_ext_p0_9 {
+	power-source = <MAX32_VSEL_VDDIOH>;
+};
+
+&adc {
+	reg = <0x40034000 0x1000>;
+	pinctrl-0 = <&adc_clk_ext_p0_9>;
+	pinctrl-names = "default";
+
+	/* ADC parameters set up 25KSPS sampling rate */
+	track-count = <96>;
+	idle-count = <183>;
+
+	#address-cells = <1>;
+	#size-cells = <0>;
+	#io-channel-cells = <1>;
+	status = "okay";
+	compatible = "adi,max32-adc";
+
+	channel@0 {
+		reg = <0>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,resolution = <12>;
+		zephyr,vref-mv = <1250>;
+	};
+};

samples/drivers/adc/adc_stream/max32-stream.conf

@@ -0,0 +1,3 @@
+# Copyright (c) 2025 Analog Devices, Inc.
+# SPDX-License-Identifier: Apache-2.0
+CONFIG_ADC_MAX32_STREAM=y

samples/drivers/adc/adc_stream/prj.conf

@@ -0,0 +1,3 @@
+CONFIG_ADC=y
+CONFIG_GPIO=y
+CONFIG_ADC_STREAM=y

samples/drivers/adc/adc_stream/sample.yaml

@@ -0,0 +1,25 @@
+sample:
+  name: ADC stream sample
+common:
+  tags: adc
+  harness: console
+  harness_config:
+    type: one_line
+    regex:
+      - "^ADC data for [^@]+@\\d+ \\([0-9.]+\\) \\d+n$"
+tests:
+  sample.driver.adc_stream:
+    filter: dt_alias_exists("adc0")
+  sample.driver.adc_stream.ad4052-stream:
+    extra_args:
+      - SHIELD=eval_ad4052_ardz
+      - EXTRA_CONF_FILE=ad4052-stream.conf
+      - DTC_OVERLAY_FILE=boards/apard32690_max32690_m4_ad4052.overlay
+    platform_allow:
+      - apard32690/max32690/m4
+  sample.driver.adc_stream.max32-stream:
+    extra_args:
+      - EXTRA_CONF_FILE=max32-stream.conf
+      - DTC_OVERLAY_FILE=boards/apard32690_max32690_m4_max32.overlay
+    platform_allow:
+      - apard32690/max32690/m4

samples/drivers/adc/adc_stream/src/main.c

@@ -0,0 +1,131 @@
+/*
+ * Copyright (c) 2024 Centro de Inovacao EDGE
+ * Copyright (c) 2025 Analog Devices, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <zephyr/device.h>
+#include <zephyr/drivers/adc.h>
+#include <zephyr/sys/util_macro.h>
+#include <zephyr/rtio/rtio.h>
+#include <zephyr/kernel.h>
+#include <zephyr/dsp/print_format.h>
+
+/* ADC node from the devicetree. */
+#define ADC_NODE DT_ALIAS(adc0)
+
+#define DT_SPEC_AND_COMMA(node_id, prop, idx) ADC_DT_SPEC_GET_BY_IDX(node_id, idx),
+
+#if DT_NODE_HAS_PROP(DT_PATH(zephyr_user), io_channels)
+/* Data of ADC io-channels specified in devicetree. */
+static const struct adc_dt_spec adc_channels[] = {
+	DT_FOREACH_PROP_ELEM(DT_PATH(zephyr_user), io_channels, DT_SPEC_AND_COMMA)
+};
+static const int adc_channels_count = ARRAY_SIZE(adc_channels);
+#endif
+
+static void init_adc(void)
+{
+	int i, ret;
+
+	ret = adc_is_ready_dt(&adc_channels[0]);
+
+	for (i = 0; i < adc_channels_count; i++) {
+		ret = adc_channel_setup_dt(&adc_channels[i]);
+	}
+}
+
+#define ADC_TRIGGERS						\
+	{ADC_TRIG_FIFO_FULL, ADC_STREAM_DATA_INCLUDE},		\
+	{ADC_TRIG_FIFO_WATERMARK, ADC_STREAM_DATA_INCLUDE}
+
+ADC_DT_STREAM_IODEV(iodev, ADC_NODE, adc_channels, ADC_TRIGGERS);
+
+RTIO_DEFINE_WITH_MEMPOOL(adc_ctx, 20, 20, 20, 512, sizeof(void *));
+
+static int print_adc_stream(const struct device *dev, struct rtio_iodev *local_iodev)
+{
+	int rc = 0;
+	const struct adc_decoder_api *decoder;
+	struct rtio_cqe *cqe;
+	uint8_t *buf;
+	uint32_t buf_len;
+	struct rtio_sqe *handles;
+
+	/* Start the streams */
+	adc_stream(local_iodev, &adc_ctx, NULL, &handles);
+
+	while (1) {
+		cqe = rtio_cqe_consume_block(&adc_ctx);
+
+		if (cqe->result != 0) {
+			printk("async read failed %d\n", cqe->result);
+			return cqe->result;
+		}
+
+		rc = rtio_cqe_get_mempool_buffer(&adc_ctx, cqe, &buf, &buf_len);
+
+		if (rc != 0) {
+			printk("get mempool buffer failed %d\n", rc);
+			return rc;
+		}
+
+		const struct device *adc = dev;
+
+		rtio_cqe_release(&adc_ctx, cqe);
+
+		rc = adc_get_decoder(adc, &decoder);
+
+		if (rc != 0) {
+			printk("sensor_get_decoder failed %d\n", rc);
+			return rc;
+		}
+
+		/* Frame iterator values when data comes from a FIFO */
+		uint32_t adc_fit = 0;
+		struct adc_data adc_data = {0};
+
+		/* Number of accelerometer data frames */
+		uint16_t frame_count;
+
+		rc = decoder->get_frame_count(buf, 0, &frame_count);
+
+		if (rc != 0) {
+			printk("get_frame_count failed %d\n", rc);
+			return rc;
+		}
+
+		/* Decode all available accelerometer sample frames */
+		for (int i = 0; i < frame_count; i++) {
+			decoder->decode(buf, 0, &adc_fit, 1, &adc_data);
+
+			printk("ADC data for %s (%" PRIq(6) ") %lluns\n", dev->name,
+			PRIq_arg(adc_data.readings[0].value, 6, adc_data.shift),
+			(adc_data.header.base_timestamp_ns
+			+ adc_data.readings[0].timestamp_delta));
+		}
+
+		rtio_release_buffer(&adc_ctx, buf, buf_len);
+	}
+
+	return rc;
+}
+
+int main(void)
+{
+	int ret;
+	struct adc_sequence sequence;
+	struct adc_read_config *read_cfg = iodev.data;
+
+	read_cfg->sequence = &sequence;
+
+	init_adc();
+	(void)adc_sequence_init_dt(&adc_channels[0], &sequence);
+
+	ret = print_adc_stream(adc_channels[0].dev, &iodev);
+
+	return ret;
+}