bartoszek/zephyr
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc: arm: MPS4 Corstone-315

Browse Source 
Update MPS4  documentation for Corstone315.

Signed-off-by: Shaunak saha <ssaha@tsavoritesi.com>
This commit is contained in:
Shaunak saha 2025-06-16 16:03:42 -07:00 committed by Daniel DeGrasse
parent 7bc5ef87cf
commit 690f001013
1 changed files with 63 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

69
boards/arm/mps4/doc/index.rst
View File

@ -6,12 +6,13 @@ Overview
The MPS4 board configuration is used by Zephyr applications that run
on the MPS4 board.
`Corstone-320 FVP`_ is an Arm reference subsystem for
`Corstone-315 FVP`_/`Corstone-320 FVP`_ are Arm reference subsystem for
secure System on Chips containing an Armv8.1-M Cortex-M85 processor,
LCM, KMU and SAM IPs and, an Ethos-U85 neural network processor.
LCM, KMU and SAM IPs. Corstone-320 FVP have Ethos-U85 while
Corstone-315 FVP have a Ethos-U65 neural network processor.
They are available free of charge for Linux and Windows systems.
The FVPs have been selected for simulation since they provide access to the
Ethos-U85 NPU, which is unavailable in QEMU or other simulation platforms.
Ethos-U65/Ethos-U85 NPU, which is unavailable in QEMU or other simulation platforms.
Zephyr board options
@ -19,6 +20,38 @@ Zephyr board options
.. tabs::
.. tab:: MPS4 Corstone-315 (FVP)
The MPS4 FVP is an SoC with Cortex-M85 architecture. Zephyr provides support
for building for both Secure and Non-Secure firmware.
The BOARD options are summarized below:
+-------------------------------+-----------------------------------------------+
| BOARD | Description |
+===============================+===============================================+
| ``mps4/corstone315/fvp`` | For building Secure (or Secure-only) firmware |
+-------------------------------+-----------------------------------------------+
| ``mps4/corstone315/fvp/ns`` | For building Non-Secure firmware |
+-------------------------------+-----------------------------------------------+
FPGA Usage:
- N/A.
FVP Usage:
- To run with the FVP, first set environment variable ``ARMFVP_BIN_PATH`` before using it. Then you can run it with ``west build -t run``.
.. code-block:: bash
export ARMFVP_BIN_PATH=/path/to/fvp/directory
west build -b {BOARD qualifier from table above} samples/hello_world -t run
To run the Fixed Virtual Platform simulation tool you must download "FVP model
for the Corstone-315 MPS4" from Arm and install it on your host PC.
QEMU Usage:
- N/A.
.. tab:: MPS4 Corstone-320 (FVP)
The MPS4 FVP is an SoC with Cortex-M85 architecture. Zephyr provides support
@ -55,9 +88,9 @@ Zephyr board options
.. note::
- Board qualifier must include the variant name as mentioned above.
``mps4/corstone320`` without the variant name is not a valid qualifier.
- ``mps4/corstone320/fvp/ns`` variant needs latest upstream TF-M release since Zephyr's current
TF-M doesn't support Corstone-320 FVP yet.
``mps4/corstone315``/ ``mps4/corstone320`` without the variant name is not a valid qualifier.
- ``mps4/corstone315/fvp/ns``/ ``mps4/corstone320/fvp/ns`` variant needs latest upstream TF-M release since Zephyr's current
TF-M doesn't support Corstone-315 FVP yet.
Hardware
********
@ -93,6 +126,23 @@ Flashing
- N/A since the only support available is FVP.
Building an application with Corstone-315
-----------------------------------------
You can build applications in the usual way. Here is an example for
the :zephyr:code-sample:`hello_world` application with Corstone-315.
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: mps4/corstone315/fvp
:goals: run
Run with FVP and you should see the following message:
.. code-block:: console
Hello World! mps4
Building an application with Corstone-320
-----------------------------------------
@ -111,14 +161,21 @@ Run with FVP and you should see the following message:
Hello World! mps4
For more details refer to:
- `Corstone SSE-315 Reference Guide`_
- `Corstone SSE-320 Reference Guide`_
- `Cortex M85 Generic User Guide`_
- `Arm Corstone-320 Reference Package Technical Overview`_
- `Arm MPS4 FPGA Prototyping Board Technical Reference Manual`_
.. _Corstone-315 FVP:
https://developer.arm.com/tools-and-software/open-source-software/arm-platforms-software/arm-ecosystem-fvps
.. _Corstone-320 FVP:
https://developer.arm.com/tools-and-software/open-source-software/arm-platforms-software/arm-ecosystem-fvps
.. _Corstone SSE-315 Reference Guide:
https://developer.arm.com/documentation/109395/0000
.. _Corstone SSE-320 Reference Guide:
https://developer.arm.com/documentation/109760/0000/