[nrf fromtree] boards: shields: add npm1304_ek shield

Add an nPM1304 EK shield, update samples/shields/npm1300_ek to support
both shields, improve the sample description.

Signed-off-by: Sergei Ovchinnikov <[email protected]>
(cherry picked from commit f0f2b94)

Author: seov-nordic

boards/shields/npm1300_ek/doc/index.rst

@@ -22,10 +22,5 @@ Usage
 *****
 
 The shield can be used in any application by setting ``--shield npm1300_ek``
-when invoking ``west build``. You can check :zephyr:code-sample:`npm1300_ek` for a
+when invoking ``west build``. You can check :zephyr:code-sample:`npm13xx_ek` for a
 comprehensive sample.
-
-References
-**********
-
-TBC

boards/shields/npm1304_ek/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 Nordic Semiconductor ASA
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_NPM1304_EK
+	def_bool $(shields_list_contains,npm1304_ek)

boards/shields/npm1304_ek/doc/index.rst

@@ -0,0 +1,30 @@
+.. _npm1304_ek:
+
+nPM1304 EK
+##########
+
+Overview
+********
+
+The nPM1304 EK lets you test different functions and features of the nPM1304
+Power Management Integrated Circuit (PMIC).
+
+Requirements
+************
+
+The nPM1304 EK board is not a direct fit into an Arduino connector. However,
+the Zephyr shield is expected to be connected to the Arduino shield connectors.
+That is, you need to connect the I2C lines to the ``arduino_i2c`` bus. This allows to
+use the shield with any host board that supports the Arduino connector.
+
+Usage
+*****
+
+To use the shield in any application, build it with the following command:
+
+.. zephyr-app-commands::
+   :board: your_board
+   :shield: npm1304_ek
+   :goals: build
+
+For a comprehensive sample, refer to :zephyr:code-sample:`npm13xx_ek`.

boards/shields/npm1304_ek/npm1304_ek.overlay

@@ -0,0 +1,86 @@
+/*
+ * Copyright (C) 2025 Nordic Semiconductor ASA
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <dt-bindings/regulator/npm13xx.h>
+#include <zephyr/dt-bindings/input/input-event-codes.h>
+
+&arduino_i2c {
+	npm1304_ek_pmic: pmic@6b {
+		compatible = "nordic,npm1304";
+		reg = <0x6b>;
+
+		npm1304_ek_gpio: gpio-controller {
+			compatible = "nordic,npm1304-gpio";
+			gpio-controller;
+			#gpio-cells = <2>;
+			ngpios = <5>;
+		};
+
+		npm1304_ek_regulators: regulators {
+			compatible = "nordic,npm1304-regulator";
+
+			/* limits are set to min/max allowed values */
+			npm1304_ek_buck1: BUCK1 {
+				regulator-min-microvolt = <1000000>;
+				regulator-max-microvolt = <3300000>;
+			};
+
+			npm1304_ek_buck2: BUCK2 {
+				regulator-min-microvolt = <1000000>;
+				regulator-max-microvolt = <3300000>;
+			};
+
+			npm1304_ek_ldo1: LDO1 {
+				regulator-min-microvolt = <1000000>;
+				regulator-max-microvolt = <3300000>;
+			};
+
+			npm1304_ek_ldo2: LDO2 {
+				regulator-min-microvolt = <1000000>;
+				regulator-max-microvolt = <3300000>;
+			};
+		};
+
+		npm1304_ek_charger: charger {
+			compatible = "nordic,npm1304-charger";
+			term-microvolt = <4150000>;
+			term-warm-microvolt = <4000000>;
+			current-microamp = <4000>;
+			vbus-limit-microamp = <500000>;
+			thermistor-ohms = <10000>;
+			thermistor-beta = <3380>;
+			charging-enable;
+		};
+
+		npm1304_ek_buttons: buttons {
+			compatible = "gpio-keys";
+
+			pmic_button0: pmic_button_0 {
+				gpios = <&npm1304_ek_gpio 0 GPIO_ACTIVE_LOW>;
+				label = "Pmic button switch 0";
+				zephyr,code = <INPUT_KEY_0>;
+			};
+
+			pmic_button1: pmic_button_1 {
+				gpios = <&npm1304_ek_gpio 1 GPIO_ACTIVE_LOW>;
+				label = "Pmic button switch 1";
+				zephyr,code = <INPUT_KEY_1>;
+			};
+
+			pmic_button2: pmic_button_2 {
+				gpios = <&npm1304_ek_gpio 2 GPIO_ACTIVE_LOW>;
+				label = "Pmic button switch 2";
+				zephyr,code = <INPUT_KEY_2>;
+			};
+		};
+
+		npm1304_ek_leds: leds {
+			compatible = "nordic,npm1304-led";
+			nordic,led0-mode = "error";
+			nordic,led1-mode = "charging";
+			nordic,led2-mode = "host";
+		};
+	};
+};

boards/shields/npm1304_ek/shield.yml

@@ -0,0 +1,11 @@
+shield:
+  name: npm1304_ek
+  full_name: nPM1304 EK
+  vendor: nordic
+  supported_features:
+    - mfd
+    - input
+    - gpio
+    - led
+    - regulator
+    - sensor

doc/_scripts/redirects.py

@@ -302,6 +302,7 @@
     ('samples/sensor/max44009/README', 'samples/sensor/light_polling/README'),
     ('samples/sensor/wsen_hids/README', 'samples/sensor/sensor'),
     ('samples/sensor/wsen_itds/README', 'samples/sensor/sensor'),
+    ('samples/shields/npm1300_ek/doc/index', 'samples/shields/npm13xx_ek/doc/index'),
     ('samples/subsys/video/capture/README', 'samples/drivers/video/capture/README'),
     ('samples/subsys/video/tcpserversink/README', 'samples/drivers/video/tcpserversink/README'),
     ('samples/subsys/video/video', 'samples/drivers/video/video'),

samples/shields/npm1300_ek/CMakeLists.txt

@@ -0,0 +1,17 @@
+# Copyright (c) 2023 Nordic Semiconductor ASA
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+
+if(SHIELD STREQUAL "npm1300_ek")
+  set(EXTRA_DTC_OVERLAY_FILE npm1300.overlay)
+elseif(SHIELD STREQUAL "npm1304_ek")
+  set(EXTRA_DTC_OVERLAY_FILE npm1304.overlay)
+else()
+  message(FATAL_ERROR "either npm1300_ek or npm1304_ek must be selected with --shield")
+endif()
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+
+project(npm13xx_ek)
+target_sources(app PRIVATE src/main.c)