From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web09.4883.1618810873169930411 for ; Sun, 18 Apr 2021 22:41:13 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: arm.com, ip: 217.140.110.172, mailfrom: chandni.cherukuri@arm.com) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id CD09DD6E; Sun, 18 Apr 2021 22:41:12 -0700 (PDT) Received: from usa.arm.com (a074744.blr.arm.com [10.162.17.16]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 2DEC23F800; Sun, 18 Apr 2021 22:41:10 -0700 (PDT) From: "chandni cherukuri" To: devel@edk2.groups.io Cc: Ard Biesheuvel , Leif Lindholm , Sami Mujawar , Chandni Cherukuri Subject: [edk2-platforms][PATCH V3 6/7] Platform-ARM-Morello: Add Readme.md file Date: Mon, 19 Apr 2021 11:10:42 +0530 Message-Id: <20210419054043.21909-7-chandni.cherukuri@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20210419054043.21909-1-chandni.cherukuri@arm.com> References: <20210419054043.21909-1-chandni.cherukuri@arm.com> This patch adds Readme.md file for Morello Platform. The document consists of information regarding the platform, steps to build and boot till UEFI Shell on the Morello FVP Platform. Signed-off-by: Chandni Cherukuri Reviewed-by: Sami Mujawar --- Platform/ARM/Morello/Readme.md | 46 ++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/Platform/ARM/Morello/Readme.md b/Platform/ARM/Morello/Readme.md new file mode 100644 index 000000000000..8d441234f3b8 --- /dev/null +++ b/Platform/ARM/Morello/Readme.md @@ -0,0 +1,46 @@ +# Introduction + +Morello is an ARMv8-A platform that implements the capability architecture +extension. Capability architecture specific changes will be added [here](https://git.morello-project.org/morello). + +The platform port in UEFI firmware provides ARMv8-A architecture enablement. + +Platform code is located at Platform/ARM/Morello. + +# Documentation + +Further information on Morello Platform is available at this [page](https://developer.arm.com/architectures/cpu-architecture/a-profile/morello). + +# Morello FVP + +Morello FVP can be downloaded from this [location](https://developer.arm.com/tools-and-software/open-source-software/arm-platforms-software/arm-ecosystem-fvps). + +# Supported Host and Toolchain + +- Host PC should be running Ubuntu Linux 18.04 LTS. +- Please refer to the `edk2-platforms/Readme.md` for downloading the GCC toolchain. + +# Build Instructions + +Please refer to the `edk2-platforms/Readme.md` for build instructions. + +# Dependencies + +Once the FVP is running, the SCP will be the first to boot and will bring the AP +core out of reset. The AP core will start executing Trusted Firmware-A at BL31 +and once it completes the execution, it will start executing UEFI. + +The SCP and TF-A binaries are required to boot to the UEFI Shell. + +## SCP Firmware + +The SCP firmware source code can be downloaded from this [page](https://github.com/ARM-software/SCP-firmware). + +Refer to the [SCP Readme](https://github.com/ARM-software/SCP-firmware/blob/master/user_guide.md) +for building SCP firmware. + +## Trusted Firmware-A (TF-A) + +The Trusted Firmware-A source code can be downloaded from this [page](https://trustedfirmware-a.readthedocs.io/en/latest/). + +Refer to the [TF-A Readme](https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/tree/docs/plat/arm/morello/index.rst?h=refs/heads/master) for building TF-A. -- 2.17.1