michaelh/zephyr
1
0
Fork 0
Code Releases Activity

boards: nxp: imx943_evk: add M33 support in doc

Browse source 
Added M33 support in doc.

Signed-off-by: Yangbo Lu <yangbo.lu@nxp.com>
This commit is contained in:
Yangbo Lu 2025-06-05 15:31:44 +08:00 • committed by Benjamin Cabé
commit 8dec03ea6b
1 changed files with 164 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

165
boards/nxp/imx943_evk/doc/index.rst
View file

@ -52,12 +52,14 @@ System Clock
This board configuration uses a system clock frequency of 24 MHz for Cortex-A55.
Cortex-A55 Core runs up to 1.7 GHz.
Cortex-M33 Core runs up to 333MHz in which SYSTICK runs on same frequency.
Serial Port
-----------
This board configuration uses a single serial communication channel with the
CPU's UART1 for Cortex-A55.
CPU's UART1 for Cortex-A55, and UART8 for Cortex-M33.
Programming and Debugging (A55)
*******************************
@ -176,3 +178,164 @@ Then the following log could be found on UART1 console:
.. include:: ../../common/board-footer.rst
:start-after: nxp-board-footer
Programming and Debugging (M33)
*******************************
Step 1. Build Zephyr application
================================
Here is an example to build the :zephyr:code-sample:`hello_world` application.
For TCM target
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: imx943_evk/mimx94398/m33
:goals: build
For DDR target
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: imx943_evk/mimx94398/m33/ddr
:goals: build
Step 2. Build bootable firmware
===============================
The imx-mkimage tool and some other firmware files from `i.MX Linux BSP release`_
are required to make a bootable firmware to program to SD/eMMC.
Below is an operations example on Linux host. (For more detail, refer to
`i.MX Linux BSP release`_ 6.12.3_1.0.0)
.. code-block:: console
# download
git clone https://github.com/nxp-imx/imx-mkimage.git -b lf-6.12.3_1.0.0
git clone https://github.com/nxp-imx/imx-sm.git -b lf-6.12.3-imx943-er1
git clone https://github.com/nxp-imx/imx-oei.git -b lf-6.12.3-imx943-er1
wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.27-5af0ceb.bin
wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-ele-imx-2.0.1-0a66c34.bin
# some firmware files need to be unpacked
chmod 777 firmware-imx-8.27-5af0ceb.bin
chmod 777 firmware-ele-imx-2.0.1-0a66c34.bin
./firmware-imx-8.27-5af0ceb.bin --auto-accept
./firmware-ele-imx-2.0.1-0a66c34.bin --auto-accept
# some firmware files need to be built from source
export TOOLS=$ARMGCC_DIR
export SM_CROSS_COMPILE=${TOOLS}/bin/arm-none-eabi-
export OEI_CROSS_COMPILE=${TOOLS}/bin/arm-none-eabi-
make -C imx-oei board=mx943lp5-19 oei=ddr d=1 all
make -C imx-sm config=mx94alt cfg
make -C imx-sm config=mx94alt all
# make bootable firmware flash.bin
cp firmware-imx-8.27-5af0ceb/firmware/ddr/synopsys/lpddr5*v202409.bin imx-mkimage/iMX94/
cp firmware-ele-imx-2.0.1-0a66c34/mx943a0-ahab-container.img imx-mkimage/iMX94/
cp imx-sm/build/mx94alt/m33_image.bin imx-mkimage/iMX94/
cp imx-oei/build/mx943lp5-19/ddr/oei-m33-ddr.bin imx-mkimage/iMX94/
cp zephyr/build/zephyr/zephyr.bin imx-mkimage/iMX94/m33s_image.bin
cd imx-mkimage
make SOC=iMX94 OEI=YES flash_m33s # for TCM target
make SOC=iMX94 OEI=YES flash_m33s_ddr # for DDR target
# Program to SD card
dd if=iMX94/flash.bin of=/dev/sdb bs=1k seek=32 && sync
Note: for this Linux BSP release version, we need to do some changes in imx-sm and imx-mkimage
to support M33 boot and DDR target.
imx-sm changes:
.. code-block:: console
diff --git a/configs/mx94alt.cfg b/configs/mx94alt.cfg
index 4613900..069992a 100755
--- a/configs/mx94alt.cfg
+++ b/configs/mx94alt.cfg
@@ -308,7 +308,7 @@ FAULT_SWNCF04 OWNER, reaction=sys_shutdown
# Boot EENV #
#==========================================================================#
-LM1 name="Boot", rpc=scmi, boot=2, skip=1, did=3, default
+LM1 name="Boot", rpc=scmi, boot=2, skip=1, did=13, default
DFMT0: sa=secure
DFMT1: sa=secure, pa=privileged
@@ -322,10 +322,6 @@ DATA: perm=rw
PD_NETC stop=6
CPU_M33S start=1, stop=5
-PD_M70 stop=4
-CPU_M7P0 start=2, stop=3
-PD_M71 stop=2
-CPU_M7P1 start=3, stop=1
# Start/Stop (mSel=1)
imx-mkimage changes:
.. code-block:: console
diff --git a/iMX94/soc.mak b/iMX94/soc.mak
index 838d2a2..bc756f9 100644
--- a/iMX94/soc.mak
+++ b/iMX94/soc.mak
@@ -392,6 +392,11 @@ flash_m33s: $(MKIMG) $(AHAB_IMG) $(MCU_IMG) $(M33S_IMG) $(OEI_IMG_M33)
-m33 $(MCU_IMG) 0 $(MCU_TCM_ADDR) \
-m33 $(M33S_IMG) 1 $(M33S_TCM_ADDR) $(M33S_TCM_ADDR_ALIAS) -out flash.bin
+flash_m33s_ddr: $(MKIMG) $(AHAB_IMG) $(MCU_IMG) $(M33S_IMG) $(OEI_IMG_M33)
+ ./$(MKIMG) -soc IMX9 -cntr_version 2 -u 1 -append $(AHAB_IMG) -c $(OEI_OPT_M33) -msel $(MSEL) \
+ -m33 $(MCU_IMG) 0 $(MCU_TCM_ADDR) \
+ -m33 $(M33S_IMG) 1 0x86000000 0x86000000 -out flash.bin
+
flash_m33s_xspi: $(MKIMG) $(AHAB_IMG) $(MCU_IMG) $(M33S_IMG) $(OEI_IMG_M33)
./$(MKIMG) -soc IMX9 -cntr_version 2 -u 1 -append $(AHAB_IMG) -dev flexspi -c $(OEI_OPT_M33) -msel $(MSEL) \
-m33 $(MCU_IMG) 0 $(MCU_TCM_ADDR) \
Step 3. Boot Zephyr
===================
Boot board from SD card. It will display the following console output.
For TCM target
.. code-block:: console
*** Booting Zephyr OS build v4.1.0-5264-g8654b4029d16 ***
Hello World! imx943_evk/mimx94398/m33
For DDR target
.. code-block:: console
*** Booting Zephyr OS build v4.1.0-5264-g8654b4029d16 ***
Hello World! imx943_evk/mimx94398/m33/ddr
Note: there will be 4 serial ports identified when connect USB cable to debug port.
The first serial port will be UART8 for M33. As there is multiplexing between JTAG
and UART8, below bcu (`bcu 1.1.113 download`_) configuration is needed to use UART8.
.. code-block:: console
bcu lsftdi
bcu set_gpio fta_jtag_host_en 0 -board=imx943evk19b1 -id=1-1
.. _bcu 1.1.113 download:
https://github.com/nxp-imx/bcu/releases/tag/bcu_1.1.113
.. _i.MX Linux BSP release:
https://www.nxp.com/design/design-center/software/embedded-software/i-mx-software/embedded-linux-for-i-mx-applications-processors:IMXLINUX