samples: boards/nxp: Enable generic poweroff for NXP MCUs

This commit introduced the following changes:
1. Enabled generic poweroff example for NXP MCUs. The
example is test on frdm_mcxa153, frdm_mcxa156, frdm_mcxa166,
frdm_mcxa276, frdm_mcxn236, frdm_mcxn947 and mimxrt595_evk.
3. Migrate the existing mimxrt595_evk/system_off example
to the new poweroff example.
4. The Poweroff example now supports counter wake-up and
button/GPIO wake-up, suitable for most NXP devices/boards.
For testing purposes, frdm_mcxn236 is wakeup using the
wake-up button; frdm_mcxa153, frdm_mcxa156, frdm_mcxa166,
frdm_mcxa276, and frdm_mcxn947 are wakeup using lptmr;
mimxrt595_evk is wakeup using high-resolution RTC.

Signed-off-by: Zhaoxiang Jin <[email protected]>

Author: ZhaoxiangJin

samples/boards/nxp/mimxrt595_evk/system_off/Kconfig

@@ -1,9 +1,8 @@
-# Copyright 2022, NXP
-#
+# 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(mimxrt595_evk_system_off)
+project(nxp_mcu_poweroff)
 
 target_sources(app PRIVATE src/main.c)

samples/boards/nxp/mimxrt595_evk/system_off/README.rst

@@ -0,0 +1,22 @@
+# Copyright 2025 NXP
+# SPDX-License-Identifier: Apache-2.0
+
+mainmenu "NXP MCU POWER OFF DEMO"
+
+config COUNTER_WAKEUP_ENABLE
+	bool
+	select COUNTER
+	default y if BOARD_FRDM_MCXA153 || BOARD_FRDM_MCXA156 || \
+				BOARD_FRDM_MCXA166 || BOARD_FRDM_MCXA276 || \
+				BOARD_FRDM_MCXN947 || BOARD_MIMXRT595_EVK
+	help
+	  Use counter to wake up device from poweroff.
+
+config GPIO_WAKEUP_ENABLE
+	bool
+	select GPIO
+	default y if BOARD_FRDM_MCXN236
+	help
+	  Use gpio to wake up device from poweroff.
+
+source "Kconfig.zephyr"

samples/boards/nxp/mimxrt595_evk/system_off/app.overlay

@@ -0,0 +1,117 @@
+.. zephyr:code-sample:: nxp_mcu_poweroff
+   :name: NXP MCU Poweroff
+   :relevant-api: sys_poweroff
+
+   Use poweroff on NXP MCUs.
+
+Overview
+********
+
+This example shows how to poweroff an NXP MCU. In this example,
+the wakeup source can be the MCU internal counter or the wakeup
+button/gpio. If the counter is used, the MCU will wake up after
+5 seconds. If the wakeup button is used, the MCU will wake up
+after the wakeup button is pressed.
+
+Building, Flashing and Running
+******************************
+
+Building and Running for NXP FRDM-MCXA153
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxa153` board.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/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.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/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.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/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.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/poweroff
+   :board: frdm_mcxa276
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP FRDM-MCXN236
+=========================================
+Build the application for the :zephyr:board:`frdm_mcxn236` board.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/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` board.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/poweroff
+   :board: frdm_mcxn947/mcxn947/cpu0
+   :goals: build flash
+   :compact:
+
+Building and Running for NXP MIMXRT595-EVK
+==========================================
+Build the application for the :zephyr:board:`mimxrt595_evk` board.
+Note: After wakeup, the chip goes through the entire reset process.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/boards/nxp/poweroff
+   :board: mimxrt595_evk/mimxrt595s/cm33
+   :goals: build flash
+   :compact:
+
+Sample Output
+=============
+FRDM-MCXA153, FRDM-MCXA156, FRDM-MCXA166, FRDM-MCXA276 FRDM-MCXN236, FRDM-MCXN947,
+MIMXRT595-EVK, output
+----------------------------------------------------------------------------------------
+
+.. code-block:: console
+
+   *** Booting Zephyr OS build v4.2.0-rc1-255-gf71b531cb990 ***
+   Press 'enter' key to power off the system
+   Will wakeup after 5 seconds
+   Powering off
+
+FRDM-MCXN236 output
+--------------------
+
+.. code-block:: console
+
+   *** Booting Zephyr OS build v4.2.0-rc3-17-g70b7c64e1094 ***
+   Press 'enter' key to power off the system
+   Will wakeup after press wakeup button
+   Powering off