[edk2-devel] [edk2-platforms PATCH 2/4] SolidRun/Armada80x0McBin: Add Readme.md

[Marcin Wojtas]

From: Grzegorz Bernacki <gjb at semihalf.com>

Add the complete build instruction for MacchiatoBin platform.

Signed-off-by: Marcin Wojtas <mw at semihalf.com>
---
 Platform/SolidRun/Armada80x0McBin/Readme.md | 97 ++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 Platform/SolidRun/Armada80x0McBin/Readme.md

diff --git a/Platform/SolidRun/Armada80x0McBin/Readme.md b/Platform/SolidRun/Armada80x0McBin/Readme.md
new file mode 100644
index 0000000000..c63cf41b2d
--- /dev/null
+++ b/Platform/SolidRun/Armada80x0McBin/Readme.md
@@ -0,0 +1,97 @@
+SolidRun MacchiatoBin

+=====================

+

+# Summary

+

+This is a port of 64-bit TianoCore EDK II firmware for the SolidRun MacchiatoBin platform based on the Marvell ARMADA 8040 SoC.

+

+# Building the firmware

+

+## Prepare toolchain (for cross-compilation only):

+

+1. Download the toolchain:

+

+   ```

+   wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz

+   ```

+

+1. After extracting, setup the path and compiler prefix to GCC5\_AARCH64\_PREFIX variable:

+

+   ```

+   export GCC5_AARCH64_PREFIX=<toolchain_path>/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-

+   ```

+

+## Prepare prerequisites

+

+1. Create a new folder (directory) on your local development machine

+   for use as your workspace. This example uses `/work/git/tianocore`, modify as

+   appropriate for your needs.

+

+   ```

+   $ export WORKSPACE=/work/git/tianocore

+   $ mkdir -p $WORKSPACE

+   $ cd $WORKSPACE

+   ```

+

+1. Clone the Trusted Firmware repository:

+

+   ```

+   $ cd ${WORKSPACE}

+   $ git clone https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git

+   ```

+1. Clone repository for auxiliary firmware on the SoC co-processors and checkout to binaries-marvell-armada-SDK10.0.1.0:

+

+   ```

+   $ cd ${WORKSPACE}

+   $ git clone https://github.com/MarvellEmbeddedProcessors/binaries-marvell.git

+   $ cd binaries-marvell/

+   $ git checkout -b binaries-marvell-armada-SDK10.0.1.0 origin/binaries-marvell-armada-SDK10.0.1.0

+   ```

+1. Clone the DDR training code from:

+

+   ```

+   $ cd ${WORKSPACE}

+   $ git clone https://github.com/MarvellEmbeddedProcessors/mv-ddr-marvell.git

+   ```

+## Prepare EDKII environment:

+

+Please follow instructions from "Obtaining source code" and "Manual building" from the top level edk2-platforms [Readme.md](https://github.com/tianocore/edk2-platforms#readme).

+

+## Build EDKII:

+

+1. Use below build command:

+

+   ```

+   $ cd ${WORKSPACE}

+   $ build -a AARCH64 -t GCC5 -b RELEASE -D INCLUDE_TFTP_COMMAND -D X64EMU_ENABLE -p Platform/SolidRun/Armada80x0McBin/Armada80x0McBin.dsc

+   ```

+

+## Build the final firmware image:

+

+1. Set BL33 variable to path to EDK II output binary:

+

+   ```

+   $ export BL33=${WORKSPACE}/Build/Armada80x0McBin-AARCH64/RELEASE_GCC5/FV/ARMADA_EFI.fd

+   ```

+1. Export SCP_BL2 variable:

+

+   ```

+   $ export SCP_BL2=${WORKSKPACE}/binaries-marvell/mrvl_scp_bl2.img

+   ```

+1. Export compiler variables (for cross-compilation only):

+

+   ```

+   $ export ARCH=arm64

+   $ export CROSS_COMPILE=<toolchain_path>/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-

+   ```

+1. Build the image:

+

+   ```

+   $ cd ${WORKSPACE}/trusted-firmware-a/

+   $ make LOG_LEVEL=20 MV_DDR_PATH=${WORKSPACE}/mv-ddr-marvell PLAT=a80x0_mcbin all fip mrvl_flash

+   ```

+The firmware image `flash-image.bin` can be found in `build/a80x0_mcbin/release/` directory.

+

+# ARM System Ready certification.

+

+MacchiatoBin is [System Ready ES](https://developer.arm.com/architectures/system-architectures/arm-systemready/es) certified. Release binary and the firmware components' baselines list are available in a dedicated [wiki page](https://github.com/semihalf/edk2-platforms/wiki).

-- 
2.29.0



-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#80931): https://edk2.groups.io/g/devel/message/80931
Mute This Topic: https://groups.io/mt/85762838/1813853
Group Owner: devel+owner at edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [edk2-devel-archive at redhat.com]
-=-=-=-=-=-=-=-=-=-=-=-