[nrf fromlist] soc: nordic: nrf54h: gpd: add API to set/clear pin retention

This API needs to be called by FAST peripherals before/after
disabling/enabling them.

Upstream PR #: 80291

Signed-off-by: Gerard Marull-Paretas <[email protected]>
(cherry picked from commit f17e6221fe8c5adbef3e68a0fda285ffd59b8a93)

Author: gmarull

soc/nordic/nrf54h/gpd/gpd.c

@@ -12,6 +12,7 @@
 #include <zephyr/spinlock.h>
 #include <zephyr/sys/util.h>
 
+#include <hal/nrf_gpio.h>
 #include <nrf/gpd.h>
 #include <nrfs_gdpwr.h>
 #include <nrfs_backend_ipc_service.h>
@@ -211,6 +212,33 @@ int nrf_gpd_release(uint8_t id)
 	return onoff_release(&gpd_mgr->mgr);
 }
 
+int nrf_gpd_retain_pins_set(const struct pinctrl_dev_config *pcfg, bool retain)
+{
+	const struct pinctrl_state *state;
+	int ret;
+
+	ret = pinctrl_lookup_state(pcfg, PINCTRL_STATE_DEFAULT, &state);
+	if (ret < 0) {
+		return ret;
+	}
+
+	for (uint8_t i = 0U; i < state->pin_cnt; i++) {
+		uint32_t pin = NRF_GET_PIN(state->pins[i]);
+
+		if (pin == NRF_PIN_DISCONNECTED) {
+			continue;
+		}
+
+		if (retain) {
+			nrf_gpio_pin_retain_set(pin);
+		} else {
+			nrf_gpio_pin_retain_clear(pin);
+		}
+	}
+
+	return 0;
+}
+
 static int nrf_gpd_pre_init(void)
 {
 	int ret;

soc/nordic/nrf54h/gpd/include/nrf/gpd.h

@@ -9,6 +9,7 @@
 #include <stdint.h>
 
 #include <zephyr/dt-bindings/power/nordic-nrf-gpd.h>
+#include <zephyr/drivers/pinctrl.h>
 
 /**
  * @brief Request a global power domain.
@@ -30,4 +31,15 @@ int nrf_gpd_request(uint8_t id);
  */
 int nrf_gpd_release(uint8_t id);
 
+/**
+ * @brief Retain set/clear a set of pins.
+ *
+ * @param pcfg Device pin configuration.
+ * @param retain Retain or not.
+ *
+ * @retval 0 If the request was successful.
+ * @retval -errno If the request was not successful.
+ */
+int nrf_gpd_retain_pins_set(const struct pinctrl_dev_config *pcfg, bool retain);
+
 #endif /* ZEPHYR_SOC_NORDIC_NRF54H_GPD_INCLUDE_NRF_GPD_H_ */