Grzegorz Bernacki f24563a493 SolidRun/Armada80x0McBin: Add Readme.md 2 years ago
..
Armada80x0McBinBoardDescLib aa6c0ad821 Marvell: Armada7k8k/OcteonTX: Enable additional board configuration 2 years ago
NonDiscoverableInitLib dfbfdbbf4d Marvell/Library: MvGpioLib: Extend GPIO pin description 5 years ago
Armada80x0McBin.dsc caefecbbe3 Platform/SolidRun: Consume MdeLibs.dsc.inc for RegisterFilterLib 3 years ago
Armada80x0McBin.fdf.inc 9ad38945c6 Platform/SolidRun: Replace BSD License with BSD+Patent License 5 years ago
Readme.md f24563a493 SolidRun/Armada80x0McBin: Add Readme.md 2 years ago

Readme.md

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
    
  2. 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
    
  2. Clone the Trusted Firmware repository:

    $ cd ${WORKSPACE}
    $ git clone https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git
    
  3. 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
    
  4. 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.

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
    
  2. Export SCP_BL2 variable:

    $ export SCP_BL2=${WORKSKPACE}/binaries-marvell/mrvl_scp_bl2.img
    
  3. 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-
    
  4. 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 certified. Release binary and the firmware components’ baselines list are available in a dedicated wiki page.