Add documentation for running on MPS3
Change-Id: Ie5afef7bd07456e0fe2eb47c0ab6f979fc9aa5ea
diff --git a/README.md b/README.md
index b20718a..ff92bbd 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,8 @@
### Testing
+#### Fixed Virtual Platform - Corstone-300
+
Assuming that the Corstone-300 FVP has been downloaded, installed and placed in
the PATH variable. Then the software binaries can be tested like this.
@@ -58,6 +60,54 @@
```
$ FVP_Corstone_SSE-300_Ethos-U55 applications/freertos/freertos.elf
```
+#### MPS3 FPGA
+
+The files needed to get started for Corstone-300 can be found on
+[developer.arm.com](https://developer.arm.com/tools-and-software/development-boards/fpga-prototyping-boards/download-fpga-images).
+
+Follow the documentation in the downloaded archive to setup the board with the
+Corstone-300 FPGA bit files.
+
+The built files can then be ran by adapting the steps in chapter '10 Software',
+using the extracted binary files from the build process. This is needed for the
+bootloader on the FPGA to be able to load the memories.
+
+1. Copy the binary files for the application in the fw/ folder to the board
+ <MPS3_dir>/Software folder, making sure the filename is max 8.3 characters
+ (i.e. 00000000.bin and 70000000.bin for the freertos application)
+2. Navigate to <MPS3_dir>MB/HBI0309C/AN547 and open the images.txt file in a
+ text editor
+3. Remove the lines under the '[IMAGES]' section and replace it with:
+
+```
+TOTALIMAGES: 2
+
+IMAGE0ADDRESS: 0x02000000
+IMAGE0UPDATE: AUTO
+IMAGE0FILE: \SOFTWARE\10000000.bin; sram binary
+
+IMAGE1ADDRESS: 0x0c000000
+IMAGE1UPDATE: AUTO
+IMAGE1FILE: \SOFTWARE\70000000.bin ; ddr binary
+```
+
+The mapping between the Cortex-M55 memory space and the addresse the FPGA MMC
+bootloader needs is found in section '9.6 MCC Memory mapping' of the
+documentation in the Corstone-300 FPGA archive. A part of the table is shown
+below:
+
+ | Cortex-M55 | MMC Bootloader |
+ |---------------|-----------------|
+ | 0x00000000 | 0x00000000 |
+ | 0x10000000 | 0x01000000 |
+ | 0x60000000 | 0x08000000 |
+ | 0x70000000 | 0x0C000000 |
+
+The binary that the Cortex-M55 CPU expects at address 0x10000000 must therefor
+be written to 0x02000000.
+
+Power up the board with the PBON and the application output will be seen on the
+serial console.
# Multi NPU