Enable poweroff feature on NXP MCXA and MCXN series MCUs.

boards/nxp/frdm_mcxa153/board.c

@@ -7,6 +7,9 @@
 #include <zephyr/dt-bindings/clock/mcux_lpc_syscon_clock.h>
 #include <fsl_clock.h>
 #include <fsl_spc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
 #include <soc.h>
 
 /* Core clock frequency: 96MHz */
@@ -151,6 +154,9 @@ void board_early_init_hook(void)
  */
 #if DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
 	CLOCK_SetupFRO16KClocking(kCLKE_16K_SYSTEM | kCLKE_16K_COREMAIN);
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3
 	CLOCK_SetClockDiv(kCLOCK_DivLPTMR0, 1u);
 	CLOCK_AttachClk(kFRO12M_to_LPTMR0);

boards/nxp/frdm_mcxa156/board.c

@@ -1,12 +1,15 @@
 /*
- * Copyright 2024  NXP
+ * Copyright 2024-2025 NXP
  * SPDX-License-Identifier: Apache-2.0
  */
 #include <zephyr/init.h>
 #include <zephyr/device.h>
 #include <zephyr/dt-bindings/clock/mcux_lpc_syscon_clock.h>
 #include <fsl_clock.h>
 #include <fsl_spc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
 #include <soc.h>
 
 /* Core clock frequency: 96MHz */
@@ -227,6 +230,9 @@ void board_early_init_hook(void)
  * 3 <- Combination of clocks configured in MRCC_LPTMR0_CLKSEL[MUX] field
  */
 #if DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 	CLOCK_SetupFRO16KClocking(kCLKE_16K_SYSTEM | kCLKE_16K_COREMAIN);
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3
 	CLOCK_SetClockDiv(kCLOCK_DivLPTMR0, 1u);

boards/nxp/frdm_mcxa166/board.c

@@ -7,6 +7,9 @@
 #include <zephyr/dt-bindings/clock/mcux_lpc_syscon_clock.h>
 #include <fsl_clock.h>
 #include <fsl_spc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
 #include <soc.h>
 
 /* Core clock frequency: 180MHz */
@@ -250,6 +253,9 @@ void board_early_init_hook(void)
  */
 #if DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
 	CLOCK_SetupFRO16KClocking(kCLKE_16K_SYSTEM | kCLKE_16K_COREMAIN);
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3
 	CLOCK_AttachClk(kFRO_LF_DIV_to_LPTMR0);
 	CLOCK_SetClockDiv(kCLOCK_DivLPTMR0, 1u);

boards/nxp/frdm_mcxa276/board.c

@@ -7,6 +7,9 @@
 #include <zephyr/dt-bindings/clock/mcux_lpc_syscon_clock.h>
 #include <fsl_clock.h>
 #include <fsl_spc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
 #include <soc.h>
 
 /* Core clock frequency: 180MHz */
@@ -255,6 +258,9 @@ void board_early_init_hook(void)
  */
 #if DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
 	CLOCK_SetupFRO16KClocking(kCLKE_16K_SYSTEM | kCLKE_16K_COREMAIN);
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3
 	CLOCK_AttachClk(kFRO_LF_DIV_to_LPTMR0);
 	CLOCK_SetClockDiv(kCLOCK_DivLPTMR0, 1u);

boards/nxp/frdm_mcxn236/board.c

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024  NXP
+ * Copyright 2024-2025 NXP
  * SPDX-License-Identifier: Apache-2.0
  */
 #include <zephyr/init.h>
@@ -8,6 +8,10 @@
 #include <fsl_clock.h>
 #include <fsl_spc.h>
 #include <soc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
+
 #if CONFIG_USB_DC_NXP_EHCI
 #include "usb_phy.h"
 #include "usb.h"
@@ -289,6 +293,9 @@ void board_early_init_hook(void)
 	CLOCK_SetupClockCtrl(kCLOCK_FRO12MHZ_ENA);
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
 	CLOCK_SetupClk16KClocking(kCLOCK_Clk16KToVsys);
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x2
 	CLOCK_SetupOsc32KClocking(kCLOCK_Osc32kToVsys);
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3

boards/nxp/frdm_mcxn236/frdm_mcxn236-pinctrl.dtsi

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024 NXP
+ * Copyright 2024-2025 NXP
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -14,6 +14,7 @@
 			slew-rate = "fast";
 			drive-strength = "low";
 			input-enable;
+			bias-pull-up;
 		};
 	};
 
@@ -48,6 +49,7 @@
 			slew-rate = "fast";
 			drive-strength = "low";
 			input-enable;
+			bias-pull-up;
 		};
 	};
 

boards/nxp/frdm_mcxn947/board.c

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024  NXP
+ * Copyright 2024-2025 NXP
  * SPDX-License-Identifier: Apache-2.0
  */
 #include <zephyr/init.h>
@@ -8,6 +8,10 @@
 #include <fsl_clock.h>
 #include <fsl_spc.h>
 #include <soc.h>
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+#include <fsl_vbat.h>
+#endif
+
 #if CONFIG_USB_DC_NXP_EHCI
 #include "usb_phy.h"
 #include "usb.h"
@@ -365,6 +369,9 @@ void board_early_init_hook(void)
 	CLOCK_SetupClockCtrl(kCLOCK_FRO12MHZ_ENA);
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x1
 	CLOCK_SetupClk16KClocking(kCLOCK_Clk16KToVsys);
+#if defined(CONFIG_PM) || defined(CONFIG_POWEROFF)
+	VBAT_EnableFRO16k(VBAT0, true);
+#endif
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x2
 	CLOCK_SetupOsc32KClocking(kCLOCK_Osc32kToVsys);
 #elif DT_PROP(DT_NODELABEL(lptmr0), clk_source) == 0x3

boards/nxp/frdm_mcxn947/frdm_mcxn947-pinctrl.dtsi

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024 NXP
+ * Copyright 2024-2025 NXP
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -62,6 +62,7 @@
 			slew-rate = "fast";
 			drive-strength = "low";
 			input-enable;
+			bias-pull-up;
 		};
 	};
 
@@ -72,6 +73,7 @@
 			slew-rate = "fast";
 			drive-strength = "low";
 			input-enable;
+			bias-pull-up;
 		};
 	};
 

modules/hal_nxp/mcux/mcux-sdk-ng/drivers/drivers.cmake

@@ -164,6 +164,11 @@ endif()
 
 if(CONFIG_SOC_SERIES_MCXN OR CONFIG_SOC_SERIES_MCXA)
   set(CONFIG_MCUX_COMPONENT_driver.mcx_spc ON)
+  if(CONFIG_PM OR CONFIG_POWEROFF)
+    set(CONFIG_MCUX_COMPONENT_driver.mcx_cmc ON)
+    set(CONFIG_MCUX_COMPONENT_driver.mcx_vbat ON)
+    set(CONFIG_MCUX_COMPONENT_driver.wuu ON)
+  endif()
 endif()
 
 if(CONFIG_BT_NXP AND CONFIG_SOC_SERIES_MCXW OR CONFIG_IEEE802154_MCXW)

samples/boards/nxp/mcx/poweroff/CMakeLists.txt

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

samples/boards/nxp/mcx/poweroff/Kconfig

@@ -0,0 +1,6 @@
+# Copyright 2025 NXP
+# SPDX-License-Identifier: Apache-2.0
+
+mainmenu "NXP MCXA/N SERIES POWER OFF DEMO"
+
+source "Kconfig.zephyr"

samples/boards/nxp/mcx/poweroff/README.rst

@@ -0,0 +1,85 @@
+.. zephyr:code-sample:: nxp_mcx_poweroff
+   :name: NXP MCXA/N Series MCUs Poweroff
+   :relevant-api: sys_poweroff
+
+   Use poweroff on NXP MCXA/N series MCUs.
+
+Overview
+********
+
+This example demonstrates how to power off NXP MCXA/N series MCUs.
+
+Building, Flashing and Running
+******************************
+
+Building and Running for NXP FRDM-MCXA153
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxa153` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxa153
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXA156
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxa156` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxa156
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXA166
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxa166` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxa166
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXA276
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxa276` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxa276
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXN236
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxn236/mcxn236` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxn236/mcxn236
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXN947
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxn947/mcxn947/cpu0` board.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/mcx/poweroff
+   :board: frdm_mcxn947/mcxn947/cpu0
+   :goals: build flash
+   :compact:
+
+Sample Output
+=============
+FRDM-MCXA153, FRDM-MCXA156, FRDM-MCXA166, FRDM-MCXA276 FRDM-MCXN236, FRDM-MCXN947 output
+----------------------------------------------------------------------------------------
+
+.. code-block:: console
+
+   *** Booting Zephyr OS build v4.2.0-rc1-255-gf71b531cb990 ***
+   Will wakeup after 5 seconds
+   Press key to power off the system
+   Powering off

samples/boards/nxp/mcx/poweroff/app.overlay

@@ -0,0 +1,14 @@
+/*
+ * Copyright 2025 NXP
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&lptmr0 {
+	status = "okay";
+	timer-mode-sel = <0>;
+	clk-source = <1>;
+	clock-frequency = <16384>;
+	resolution = <32>;
+	wakeup-source;
+};

samples/boards/nxp/mcx/poweroff/prj.conf

@@ -0,0 +1,7 @@
+# Copyright 2025 NXP
+# SPDX-License-Identifier: Apache-2.0
+
+CONFIG_POWEROFF=y
+CONFIG_COUNTER=y
+CONFIG_CONSOLE_SUBSYS=y
+CONFIG_CONSOLE_GETCHAR=y

samples/boards/nxp/mcx/poweroff/sample.yaml

@@ -0,0 +1,16 @@
+# Copyright 2025 NXP
+# SPDX-License-Identifier: Apache-2.0
+
+sample:
+  name: Poweroff demo for NXP MCXA/N series
+common:
+  tags: power
+tests:
+  sample.boards.nxp.mcx.poweroff:
+    platform_allow:
+    - frdm_mcxa156
+    - frdm_mcxa153
+    - frdm_mcxa166
+    - frdm_mcxa276
+    - frdm_mcxn236/mcxn236
+    - frdm_mcxn947/mcxn947/cpu0

samples/boards/nxp/mcx/poweroff/src/main.c

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2025 NXP
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdio.h>
+#include <zephyr/drivers/counter.h>
+#include <zephyr/sys/poweroff.h>
+#include <zephyr/sys_clock.h>
+#include <zephyr/console/console.h>
+#include <zephyr/kernel.h>
+#include <zephyr/sys/printk.h>
+
+int main(void)
+{
+	int ret;
+	const struct device *dev = DEVICE_DT_GET(DT_NODELABEL(lptmr0));
+
+	struct counter_top_cfg top_cfg = {
+		.ticks = counter_us_to_ticks(dev, 5000000),
+		.callback = NULL,
+		.user_data = NULL,
+		.flags = 0,
+	};
+
+	console_init();
+
+	if (!device_is_ready(dev)) {
+		printf("Counter device not ready\n");
+		return 0;
+	}
+
+	ret = counter_set_top_value(dev, &top_cfg);
+
+	printf("Will wakeup after 5 seconds\n");
+	printf("Press key to power off the system\n");
+	console_getchar();
+
+	ret = counter_start(dev);
+	if (ret < 0) {
+		printf("Could not start wakeup counter (%d)\n", ret);
+		return 0;
+	}
+
+	printf("Powering off\n");
+
+	sys_poweroff();
+
+	return 0;
+}