i.MX 95 AHAB Load M7 Application to TCM

i.MX 95 AHAB Load M7 Application to TCM#

This notebook describes how to build a bootable AHAB image with M7 application, and how to load it to TCM (Tightly Coupled Memory).

1. Prerequisites#

  • SPSDK is needed with examples extension. pip install spsdk[examples] (Please refer to the installation documentation.)

  • This demo was tested with i.MX 95 EVK board with LPDDR4 memory and A0 chip revision.

1.1 Images preparation#

  • Obtain all the necessary binaries and put them into inputs directory

1.2 Requirements#

Download these files from the https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/<package name> and put them into the inputs directory.

Primary image container set:

  • ELE firmware

  • lpddr5 or lpddr4 firmware files with OEI firmware

  • CM33 OEI TCM

  • CM33 System manager image

  • M7 application image

2. AHAB Image#

2.1 AHAB Template#

We can generate the template using the nxpimage ahab get-template command. The command will generate a template. The template is a YAML file that contains the AHAB header and the AHAB container. The AHAB header contains the information about the image, such as the version, the number of containers, and the signature.

The following command generates the template:

nxpimage ahab get-template -f mimx9596 -o ahab_template.yaml

2.2 Exporting of the AHAB image#

The AHAB image can be exported using the nxpimage ahab export command. The command will create the AHAB image from the template. The following command creates the AHAB image:

nxpimage ahab export -c ahab_template.yaml

Image container set consists of the following images:

  • ELE firmware

  • DDR firmware with OEI

  • System manager

  • M7 application image

nxpimage ahab get-template -f mimx9596 -o workspace/ahab_template.yaml --force 
Creating workspace/ahab_template.yaml template file.

Configuration Differences

# EXPORT U-BOOT IMAGE
VERBOSITY = "-v"

%! nxpimage $VERBOSITY ahab export --config inputs/mx95_tcm.yaml

nxpimage -v ahab export --config inputs/mx95_tcm.yaml 
INFO:spsdk.apps.nxpimage_apps.nxpimage_ahab:Created AHAB Image:
Name:      AHAB Image
Starts:    0x0
Ends:      0x5c7ff
Size:      Size: 370.0 kiB; 378,880 B
Alignment: 512 B
Execution Start Address: Not defined
Pattern:zeros
AHAB Image for mimx9596, Revision: latest

INFO:spsdk.apps.nxpimage_apps.nxpimage_ahab:Created AHAB Image memory map:

+==0x0000_0000= AHAB Image ==========================+
|             Size: 370.0 kiB; 378,880 B             |
|     AHAB Image for mimx9596, Revision: latest      |
|                   Pattern: zeros                   |
|+==0x0000_0000= AHAB Containers ===================+|
||             Size: 48.0 kiB; 49,152 B             ||
||              AHAB Containers block               ||
||                  Pattern: zeros                  ||
||+==0x0000_0000= AHAB Container 0 ================+||
|||             Size: 8.0 kiB; 8,227 B             |||
|||         AHAB Container for nxp_SWver:0         |||
||+==0x0000_2022===================================+||
||                   Gap: 8.0 kiB                   ||
||+==0x0000_4000= AHAB Container 1 ================+||
|||                  Size: 832 B                   |||
|||         AHAB Container for nxp_SWver:0         |||
||+==0x0000_433f===================================+||
||                  Gap: 15.2 kiB                   ||
||+==0x0000_8000= AHAB Container 2 ================+||
|||                  Size: 544 B                   |||
|||        AHAB Container for none_SWver:0         |||
||+==0x0000_821f===================================+||
|+==0x0000_bfff=====================================+|
|+==0x0000_c000= Container 0 AHAB Data Image 0 =====+|
||             Size: 44.6 kiB; 45,648 B             ||
||  AHAB encrypted data block for ele core and ele  ||
||                   Image Type.                    ||
|+==0x0001_724f=====================================+|
|                    Gap: 3.4 kiB                    |
|+==0x0001_8000= Container 1 AHAB Data Image 0 =====+|
||             Size: 63.8 kiB; 65,280 B             ||
||   AHAB encrypted data block for v2x-1 core and   ||
||             v2x_primary Image Type.              ||
|+==0x0002_7eff=====================================+|
|                     Gap: 256 B                     |
|+==0x0002_8000= Container 1 AHAB Data Image 1 =====+|
||             Size: 28.0 kiB; 28,672 B             ||
||   AHAB encrypted data block for v2x-2 core and   ||
||            v2x_secondary Image Type.             ||
|+==0x0002_efff=====================================+|
|+==0x0002_f000= OEI TCM ===========================+|
||              Size: 5.0 kiB; 5,120 B              ||
||AHAB data block for cortex-m33 core and oei Image ||
||                      Type.                       ||
|+==0x0003_03ff=====================================+|
|+==0x0003_0400= System manager ====================+|
||            Size: 163.0 kiB; 166,912 B            ||
||AHAB data block for cortex-m33 core and executable||
||                   Image Type.                    ||
|+==0x0005_8fff=====================================+|
|+==0x0005_9000= Additional Cortex M7 application ==+|
||             Size: 14.0 kiB; 14,336 B             ||
||     AHAB data block for cortex-m7-1 core and     ||
||              executable Image Type.              ||
|+==0x0005_c7ff=====================================+|
|+==0x0005_c800= V2X core Dummy record =============+|
||                    Size: 0 B                     ||
||AHAB data block for cortex-m33 core and v2x_dummy ||
||                   Image Type.                    ||
|+==0x0005_c7ff=====================================+|
+==0x0005_c7ff=======================================+

Success. (AHAB: outputs/flash.bin created.)

# Set the boot mode to Cortex-M Serial Downloader 1001 and download the files using the UUU tool

%! nxpuuu $VERBOSITY run "SDPS[-t 10000]: boot -f outputs/flash.bin"

nxpuuu run "SDPS[-t 10000]: boot -f outputs/flash.bin" 
SDPS[-t 10000]: boot -f outputs/flash.bin


Success
Contents