low cost power shield solution

samples/boards/nxp/mimxrt595_evk/system_off/sample.yaml

@@ -7,7 +7,23 @@ sample:
   name: Deep Power Down State Sample for mimxrt595_evk
 common:
   tags: power
+  harness: power
+  harness_config:
+    fixture: pm_probe
+    pytest_dut_scope: session
+    power_measurements:
+      elements_to_trim: 100
+      min_peak_distance: 40
+      min_peak_height: 0.008
+      peak_padding: 40
+      measurement_duration: 20
+      num_of_transitions: 6
+      expected_rms_values: []
+      tolerance_percentage: 20
+    record:
+      regex:
+        - "not used"
+      as_json: ['metrics']
 tests:
   sample.boards.mimxrt595_evk.system_off:
-    build_only: true
     platform_allow: mimxrt595_evk/mimxrt595s/cm33

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

samples/drivers/adc/adc_power_shield/Kconfig

@@ -0,0 +1,15 @@
+# Copyright (c) 2024 Centro de Inovacao EDGE.
+# SPDX-License-Identifier: Apache-2.0
+
+config SEQUENCE_SAMPLES
+	int "Number of samples to be made on the sequence for each channel."
+	default 5
+
+config SEQUENCE_RESOLUTION
+	int "Set the resolution of the sequence readings."
+	default 12
+
+config SEQUENCE_32BITS_REGISTERS
+	bool "ADC data sequences are on 32bits"
+
+source "Kconfig.zephyr"

samples/drivers/adc/adc_power_shield/README.rst

@@ -0,0 +1,80 @@
+.. zephyr:code-sample:: adc_power_shield
+   :name: Analog-to-Digital Converter (ADC) power shield sample
+   :relevant-api: adc_interface
+
+   Read analog inputs from ADC channels, using a sequence.
+
+Overview
+********
+
+This sample is to enable general power shield for platfroms that have ADC support.
+
+
+Building and Running
+********************
+
+Make sure that the ADC is enabled (``status = "okay";``) and has each channel as a
+child node, with your desired settings like gain, reference, or acquisition time and
+oversampling setting (if used). It is also needed to provide an alias ``adc0`` for the
+desired adc. See :zephyr_file:`boards/nrf52840dk_nrf52840.overlay
+<samples/drivers/adc/adc_dt/boards/nrf52840dk_nrf52840.overlay>` for an example of
+such setup.
+
+Building and Running for Nordic nRF52840
+========================================
+
+The sample can be built and executed for the
+:zephyr:board:`nrf52840dk` as follows:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/drivers/adc/adc_sequence
+   :board: nrf52840dk/nrf52840
+   :goals: build flash
+   :compact:
+
+To build for another board, change "nrf52840dk/nrf52840" above to that board's name
+and provide a corresponding devicetree overlay.
+
+Sample output
+=============
+
+the output as below, repeated every time you input any char in the console:
+
+.. code-block:: console
+
+   ADC sequence reading [1]:
+   - ADC_0, channel 0, 5 sequence samples:
+   - - 36 = 65mV
+   - - 35 = 63mV
+   - - 36 = 65mV
+   - - 35 = 63mV
+   - - 36 = 65mV
+   - ADC_0, channel 1, 5 sequence samples:
+   - - 0 = 0mV
+   - - 0 = 0mV
+   - - 1 = 1mV
+   - - 0 = 0mV
+   - - 1 = 1mV
+
+.. note:: If the ADC is not supported, the output will be an error message.
+
+You should get similar output as below, if you input a return:
+
+.. code-block:: console
+
+   ==== start of adc features ===
+   CHANNEL_COUNT: 4
+   Resolution: 12
+           channel_id 0 features:
+            - is single mode
+            - verf is 3300 mv
+           channel_id 3 features:
+            - is single mode
+            - verf is 3300 mv
+           channel_id 4 features:
+            - is single mode
+            - verf is 3300 mv
+           channel_id 7 features:
+            - is single mode
+            - verf is 3300 mv
+   ==== end of adc features ===

samples/drivers/adc/adc_power_shield/boards/arduino_due.overlay

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2024 Centro de Inovacao EDGE
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		adc0 = &adc0;
+	};
+};
+
+&adc0 {
+	#address-cells = <1>;
+	#size-cells = <0>;
+	status = "okay";
+
+	pinctrl-0 = <&adc0_default>;
+	pinctrl-names = "default";
+
+	prescaler = <9>;
+	startup-time = <64>;
+	settling-time = <3>;
+	tracking-time = <2>;
+
+	/* External ADC(+) */
+	channel@6 { // Connector A1
+		reg = <6>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_EXTERNAL0";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <6>;
+		zephyr,vref-mv = <3300>;
+	};
+
+	channel@7 { // Connector A0
+		reg = <7>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_EXTERNAL0";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <7>;
+		zephyr,vref-mv = <3300>;
+	};
+};

samples/drivers/adc/adc_power_shield/boards/bl54l15_dvk_nrf54l15_cpuapp.overlay

@@ -0,0 +1,62 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Copyright (c) 2024 Nordic Semiconductor ASA
+ * Copyright (c) 2025 Ezurio LLC
+ */
+
+/ {
+	zephyr,user {
+		io-channels = <&adc 0>, <&adc 1>, <&adc 2>, <&adc 7>;
+	};
+};
+
+/ {
+	aliases {
+		adc0 = &adc;
+	};
+};
+
+&adc {
+	#address-cells = <1>;
+	#size-cells = <0>;
+
+	channel@0 {
+		reg = <0>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN4>; /* P1.11 */
+		zephyr,resolution = <10>;
+	};
+
+	channel@1 {
+		reg = <1>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN2>; /* P1.06 */
+		zephyr,resolution = <12>;
+		zephyr,oversampling = <8>;
+	};
+
+	channel@2 {
+		reg = <2>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_DVDD>; /* 0.9 V internal */
+		zephyr,resolution = <12>;
+		zephyr,oversampling = <8>;
+	};
+
+	channel@7 {
+		reg = <7>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN6>; /* P1.13 */
+		zephyr,input-negative = <NRF_SAADC_AIN7>; /* P1.14 */
+		zephyr,resolution = <12>;
+	};
+};

samples/drivers/adc/adc_power_shield/boards/bl54l15u_dvk_nrf54l15_cpuapp.overlay

@@ -0,0 +1,62 @@
+/*
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Copyright (c) 2024 Nordic Semiconductor ASA
+ * Copyright (c) 2025 Ezurio LLC
+ */
+
+/ {
+	zephyr,user {
+		io-channels = <&adc 0>, <&adc 1>, <&adc 2>, <&adc 7>;
+	};
+};
+
+/ {
+	aliases {
+		adc0 = &adc;
+	};
+};
+
+&adc {
+	#address-cells = <1>;
+	#size-cells = <0>;
+
+	channel@0 {
+		reg = <0>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN4>; /* P1.11 */
+		zephyr,resolution = <10>;
+	};
+
+	channel@1 {
+		reg = <1>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN2>; /* P1.06 */
+		zephyr,resolution = <12>;
+		zephyr,oversampling = <8>;
+	};
+
+	channel@2 {
+		reg = <2>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_DVDD>; /* 0.9 V internal */
+		zephyr,resolution = <12>;
+		zephyr,oversampling = <8>;
+	};
+
+	channel@7 {
+		reg = <7>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,acquisition-time = <ADC_ACQ_TIME_DEFAULT>;
+		zephyr,input-positive = <NRF_SAADC_AIN6>; /* P1.13 */
+		zephyr,input-negative = <NRF_SAADC_AIN7>; /* P1.14 */
+		zephyr,resolution = <12>;
+	};
+};

samples/drivers/adc/adc_power_shield/boards/cy8cproto_062_4343w.conf

@@ -0,0 +1 @@
+CONFIG_SEQUENCE_RESOLUTION=12

samples/drivers/adc/adc_power_shield/boards/cy8cproto_062_4343w.overlay

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2024 Centro de Inovacao EDGE
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/dt-bindings/adc/adc.h>
+
+/ {
+	aliases {
+		adc0 = &adc0;
+	};
+};
+
+&adc0 {
+	status = "okay";
+	#address-cells = <1>;
+	#size-cells = <0>;
+
+	channel@0 {
+		reg = <0>;
+		zephyr,acquisition-time = <ADC_ACQ_TIME(ADC_ACQ_TIME_MICROSECONDS, 1)>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,input-positive = <0>;   /* P10.0 */
+	};
+
+	channel@1 {
+		reg = <1>;
+		zephyr,acquisition-time = <ADC_ACQ_TIME(ADC_ACQ_TIME_MICROSECONDS, 1)>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,input-positive = <1>;   /* P10.1 */
+	};
+};

samples/drivers/adc/adc_power_shield/boards/cy8cproto_063_ble.conf

@@ -0,0 +1 @@
+CONFIG_SEQUENCE_RESOLUTION=12

samples/drivers/adc/adc_power_shield/boards/cy8cproto_063_ble.overlay

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2024 Centro de Inovacao EDGE
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/dt-bindings/adc/adc.h>
+
+/ {
+	aliases {
+		adc0 = &adc0;
+	};
+};
+
+&adc0 {
+	status = "okay";
+	#address-cells = <1>;
+	#size-cells = <0>;
+
+	channel@0 {
+		reg = <0>;
+		zephyr,acquisition-time = <ADC_ACQ_TIME(ADC_ACQ_TIME_MICROSECONDS, 1)>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,input-positive = <2>;   /* P10.2 */
+	};
+
+	channel@1 {
+		reg = <1>;
+		zephyr,acquisition-time = <ADC_ACQ_TIME(ADC_ACQ_TIME_MICROSECONDS, 1)>;
+		zephyr,gain = "ADC_GAIN_1";
+		zephyr,reference = "ADC_REF_INTERNAL";
+		zephyr,input-positive = <3>;   /* P10.3 */
+	};
+};

samples/drivers/adc/adc_power_shield/boards/frdm_k64f.conf

@@ -0,0 +1 @@
+CONFIG_ADC_MCUX_ADC16_VREF_ALTERNATE=y