platform: Add support of frdmmcxn947

The commit adds support for the ARM Cortext-M33
based NXP frdmmcxn947 development board to
Trusted Firmware-M (TF-M). This includes:
- Native peripheral driver for Flash and LPUART
- System, Flash and RAM configuration files for
  dual-core CM33 architecture
- Platform Native drivers from MCUX SDK
- TF-M target configuration for secure/non-secure
  domains
- s/ns board configuration for FRDM-MCXN947
- Platform documentation added
- updates in common hal files to be re-used
  by multiple NXP platforms. This imporoves code
  reusability and standardization across NXP
  MCU platforms

Change-Id: I6ad23001d1e79dda786ff858c686465cd89f6b5b
Signed-off-by: Waqar Tahir <waqar.tahir@nxp.com>

Author: waqar-tahir

docs/platform/nxp/frdmmcxn947/README.rst

@@ -0,0 +1,106 @@
+###############
+FRDM-MCXN947
+###############
+
+The NXP FRDM-MCXN947 is a development board for the N94x 150 MHz Arm Cortex-M33 TrustZone microcontroller, which is for Industrial and Consumer IoT Applications.
+
+MCU device and part on board is shown below:
+
+* Device: MCXN947
+* Boardname: frdmmcxn947
+
+You can find more information about the `FRDM-MCXN947 on the official NXP product page`_.
+
+****************
+1. Building TF-M
+****************
+
+Prepare the tf-m-tests repository inside the TF-M base folder.
+
+.. code-block:: bash
+
+    cd <TF-M base folder>
+    git clone https://git.trustedfirmware.org/TF-M/tf-m-tests.git
+
+Currently FRDM-MCXN947 only supports builds without secondary bootloader (BL2).
+
+1.1 Building TF-M demo without BL2
+==================================
+To build S and NS application image without a BL2, run the following commands:
+
+.. code:: bash
+
+    cd <TF-M base folder>/tf-m-test/tests_reg
+    cmake -S spe -B build_spe -DTFM_PLATFORM=nxp/frdmmcxn947 -DCONFIG_TFM_SOURCE_PATH=<TF-M base folder>/trusted-firmware-m -G"Unix Makefiles" -DBL2=OFF
+    cmake --build build_spe -- install
+    cmake -S . -B build_test -G"Unix Makefiles" -DCONFIG_SPE_PATH=<TF-M base folder>/tf-m-tests/tests_reg/build_spe/api_ns
+    cmake --build build_test
+
+
+1.2 Building TF-M regression tests
+==================================
+
+To build the S and NS regression tests without BL2, run the following commands:
+
+* Profile Medium:
+
+.. code:: bash
+
+    cd <TF-M base folder>/tf-m-test/tests_reg
+    cmake -S spe -B build_spe -DTFM_PLATFORM=nxp/frdmmcxn947 -DCONFIG_TFM_SOURCE_PATH=<TF-M base folder>/trusted-firmware-m -G"Unix Makefiles" -DTFM_PROFILE=profile_medium -DTEST_S=ON -DTEST_NS=ON -DBL2=OFF
+    cmake --build build_spe -- install
+    cmake -S . -B build_test -G"Unix Makefiles" -DCONFIG_SPE_PATH=<TF-M base folder>/tf-m-tests/tests_reg/build_spe/api_ns
+    cmake --build build_test
+
+* Profile Small:
+
+.. code:: bash
+
+    cd <TF-M base folder>/tf-m-test/tests_reg
+	cmake -S spe -B build_spe_small -DTFM_PLATFORM=nxp/frdmmcxn947 -DCONFIG_TFM_SOURCE_PATH=C:/Code/tfm-upstream/trusted-firmware-m -G"Unix Makefiles" -DBL2=OFF -DTFM_PROFILE=profile_small -DTEST_S=ON   -DTEST_NS=ON   -DTEST_S_CRYPTO=ON   -DTEST_NS_CRYPTO=ON   -DTEST_S_ATTESTATION=OFF   -DTEST_S_STORAGE=OFF   -DTEST_S_PLATFORM=OFF   -DTEST_NS_ATTESTATION=OFF   -DTEST_NS_STORAGE=OFF -DTEST_NS_PLATFORM=OFF -DTEST_S_PLATFORM=OFF -DTEST_NS_SFN_BACKEND=OFF -DTEST_S_SFN_BACKEND=OFF
+    cmake --build build_spe_small -- install
+    cmake -S . -B build_test_small -G"Unix Makefiles" -DCONFIG_SPE_PATH=C:/Code/tfm-upstream/tf-m-tests/tests_reg/build_spe_small/api_ns
+    cmake --build build_test_small
+
+
+***********************************
+2. Flashing TF-M with Segger J-Link
+***********************************
+
+To install the J-Link Software and documentation pack, follow the steps below:
+
+#. Download the appropriate package from the `J-Link Software and documentation pack`_ website
+#. Depending on platform, install the package or run the installer
+#. When connecting a J-Link-enabled board such as an frdmmcxn947 , a serial port should come up
+
+Flash them with JLink as follows:
+
+* Flash Erase:
+
+.. code-block:: console
+
+
+    JLinkExe -device MCXN947_M33_0 -if swd -speed 4000 -autoconnect 1
+    J-Link>exec EnableEraseAllFlashBanks
+    J-Link>erase 0x00 0x180000
+    J-Link>r
+
+* Flash Write:
+
+.. code-block:: console	
+
+    JLinkExe -device MCXN947_M33_0 -if swd -speed 4000 -autoconnect 1
+    J-Link>r
+    J-Link>h
+    J-Link>loadfile build_spe/bin/tfm_s.bin 0x00
+    J-Link>h
+    J-Link>loadfile build_spe/bin/tfm_ns.bin 0x80000
+    J-Link>r
+
+.. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
+.. _FRDM-MCXN947 on the official NXP product page : https://www.nxp.com/design/design-center/development-boards-and-designs/FRDM-MCXN947
+
+--------------
+
+*Copyright 2025 NXP*
+*SPDX-License-Identifier: BSD-3-Clause*

docs/platform/nxp/index.rst

@@ -1,9 +1,18 @@
-############
-NXP platform
-############
+=============
+NXP platforms
+=============
+
+This document contains SOC and boards supported by NXP.
 
 .. toctree::
     :maxdepth: 1
-    :titlesonly:
+    :caption: SOC and Boards
+    :glob:
 
     LPCXpresso55S69 <lpcxpresso55s69/README.rst>
+    FRDM-MCXN947 <frdmmcxn947/README.rst>
+
+--------------
+
+*Copyright 2025 NXP*
+*SPDX-License-Identifier: BSD-3-Clause*