• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..--

README.rstD11-Mar-20244.3 KiB11486

README.rst

1Corstone SSE-300 with Ethos-U55 Example Subsystem for MPS3 (AN547)
2==================================================================
3
4Building TF-M
5-------------
6
7Follow the instructions in :doc:`Building instructions </building/tfm_build_instruction>`.
8Build instructions with platform name: arm/mps3/an547
9``-DTFM_PLATFORM=arm/mps3/an547``
10
11.. note::
12
13   This platform support does not provide software for Ethos-U55 IP, only
14   contains base address and interrupt number for it.
15
16.. note::
17
18   The built binaries can be run on the Corstone SSE-300 with Ethos-U55
19   Example Subsystem for MPS3 (AN547).
20   They can also be run on the Corstone-300 Ethos-U55 Ecosystem FVP
21   (FVP_SSE300_MPS3) up until version 11.15. From version 11.16, the FVP
22   is aligned with the AN552 FPGA platform. For build information check
23   :doc:`AN552 platform </platform/arm/mps3/an552/README>`.
24
25To run the example code on Corstone SSE-300 with Ethos-U55 Example Subsystem for MPS3 (AN547)
26---------------------------------------------------------------------------------------------
27FPGA image is available to download `here <https://developer.arm.com/tools-and-software/development-boards/fpga-prototyping-boards/download-fpga-images>`__
28
29To run BL2 bootloader and TF-M example application and tests in the MPS3 board,
30it is required to have AN547 image in the MPS3 board SD card. The image should
31be located in ``<MPS3 device name>/MB/HBI<BoardNumberBoardrevision>/AN547``
32
33The MPS3 board tested is HBI0309C.
34
35#. Copy ``bl2.bin`` and ``tfm_s_ns_signed.bin`` files from
36   build dir to ``<MPS3 device name>/SOFTWARE/``
37#. Rename ``tfm_s_ns_signed.bin`` to ``tfm.bin`` (Filename should not be longer
38   than 8 charachters.)
39#. Open ``<MPS3 device name>/MB/HBI0309C/AN547/images.txt``
40#. Update the ``images.txt`` file as follows::
41
42    TITLE: Arm MPS3 FPGA prototyping board Images Configuration File
43
44    [IMAGES]
45    TOTALIMAGES: 2                     ;Number of Images (Max: 32)
46
47    IMAGE0UPDATE: AUTO                 ;Image Update:NONE/AUTO/FORCE
48    IMAGE0ADDRESS: 0x00000000          ;Please select the required executable program
49    IMAGE0FILE: \SOFTWARE\bl2.bin
50    IMAGE1UPDATE: AUTO
51    IMAGE1ADDRESS: 0x02000000
52    IMAGE1FILE: \SOFTWARE\tfm.bin
53
54#. Close ``<MPS3 device name>/MB/HBI0309C/AN547/images.txt``
55#. Unmount/eject the ``<MPS3 device name>`` unit
56#. Reset the board to execute the TF-M example application
57#. After completing the procedure you should be able to visualize on the serial
58   port (baud 115200 8n1) the following messages::
59
60    [INF] Starting bootloader
61    [INF] Swap type: none
62    [INF] Swap type: none
63    [INF] Bootloader chainload address offset: 0x0
64    [INF] Jumping to the first image slot
65    [Sec Thread] Secure image initializing!
66    Booting TFM v1.4.0
67    [Crypto] Dummy Entropy NV Seed is not suitable for production!
68    Non-Secure system starting...
69
70.. note::
71
72   Some of the messages above are only visible when ``CMAKE_BUILD_TYPE`` is set
73   to ``Debug``.
74
75To run the example code on Corstone-300 Ethos-U55 Ecosystem FVP
76---------------------------------------------------------------
77.. note::
78
79   The built binaries can be run on the Corstone-300 Ethos-U55 Ecosystem FVP
80   (FVP_SSE300_MPS3) up until version 11.15. This version is no longer
81   available to download.
82
83#. Install the FVP
84#. Copy ``bl2.axf`` and ``tfm_s_ns_signed.bin`` files from
85   build dir to ``<FVP installation path>/models/Linux64_GCC-6.4/``
86#. Navigate to the same directory and execute the following command to start FVP::
87
88    $ ./FVP_MPS3_Corstone_SSE-300 -a cpu0*="bl2.axf" --data "tfm_s_ns_signed.bin"@0x01000000
89
90#. After completing the procedure you should be able to visualize on the serial
91   port the following messages::
92
93    Trying 127.0.0.1...
94    Connected to localhost.
95    Escape character is '^]'.
96    [INF] Starting bootloader
97    [INF] Swap type: none
98    [INF] Swap type: none
99    [INF] Bootloader chainload address offset: 0x0
100    [INF] Jumping to the first image slot
101    [Sec Thread] Secure image initializing!
102    Booting TFM v1.4.0
103    [Crypto] Dummy Entropy NV Seed is not suitable for production!
104    Non-Secure system starting...
105
106.. note::
107
108   Some of the messages above are only visible when ``CMAKE_BUILD_TYPE`` is set
109   to ``Debug``.
110
111-------------
112
113*Copyright (c) 2020-2022, Arm Limited. All rights reserved.*
114