From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=2a00:1450:4864:20::444; helo=mail-wr1-x444.google.com; envelope-from=nariman.poushin@linaro.org; receiver=edk2-devel@lists.01.org Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 6EED121BADAB2 for ; Mon, 14 Jan 2019 07:39:27 -0800 (PST) Received: by mail-wr1-x444.google.com with SMTP id j2so23475990wrw.1 for ; Mon, 14 Jan 2019 07:39:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=JSYgZk6NUPVhjD2ZtQc7Dn7HrNYzFupjGViXrCfH9C0=; b=K1eMjqonoW1ER9yGaP7jW0oMLMC5mCnAwTAHJpCgFNjWkNGKKyel/A7lZcFn+UMEXH 9WgBANvt1YdWcJs5Ci9jDVG2He/hWRTYP7LPm8zCC/DqruM3p+LZP6HvstNF994UGOc2 dl95IQh6M+kROLeg+Cfo6N9VdmY/YmZRbBbbQ= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=JSYgZk6NUPVhjD2ZtQc7Dn7HrNYzFupjGViXrCfH9C0=; b=SBsVlha4kbqUxiqZvwAsJMf6CRXeVZm/Tjn2uMBLYpatyZBBhJ6ZkIsBJoccc5/WlW BcPkoi/W3ZenLrrDE/iDFW8pSQiTVraYIAMJS5CLqFLB8IvWDnqtWH1ZWf7sl9M2VpN5 nv/1tc8+KyF0FiXkLTS9REReg/vGJpo1bLtIeYJV7gzhcK5kRsINgm3O0NTOoo1R/+TD oKwvvDdWEjT+YiEf3C07HaeR3O1J82Cr+GnFdRYVZZvlWGEmw7CBF7wfVXdC8Sf2m3Uz APTYuwXg7cDINCfRMZ1wu1yr2CnvGKR3S1WJmNfJcXHrFdXnCucoUJltE77vqDFqGsxg 6vJA== X-Gm-Message-State: AJcUukeOI52ba+UN7l5fsIg1alX7XdM9o/wnjh2gnd1p8fdXMq9C2rPk SFQVf/yq4bepI+T1O4V1uadzkg== X-Google-Smtp-Source: ALg8bN5kXo29yD0ug0ysRBfxCD1Y0YOAPD7uc6fen1ucYTLhseD9kMtR37Zv58uu0KBtpYst+lqclA== X-Received: by 2002:adf:f28d:: with SMTP id k13mr25699958wro.78.1547480365655; Mon, 14 Jan 2019 07:39:25 -0800 (PST) Received: from e121012-lin.cambridge.arm.com (host86-180-60-162.range86-180.btcentralplus.com. [86.180.60.162]) by smtp.gmail.com with ESMTPSA id o3sm60191971wrs.30.2019.01.14.07.39.24 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 14 Jan 2019 07:39:24 -0800 (PST) Date: Mon, 14 Jan 2019 15:40:43 +0000 From: Nariman Poushin To: Leif Lindholm Cc: edk2-devel@lists.01.org Message-ID: <20190114154043.GA10563@e121012-lin.cambridge.arm.com> References: <20181205094547.pxhwnuhdur6aqobj@bivouac.eciton.net> <1545242506-5758-1-git-send-email-nariman.poushin@linaro.org> <20190111174242.twwzw2wrll6xy7ju@bivouac.eciton.net> MIME-Version: 1.0 In-Reply-To: <20190111174242.twwzw2wrll6xy7ju@bivouac.eciton.net> User-Agent: Mutt/1.5.24 (2015-08-30) Subject: Re: [edk2-platforms] [PATCH v7 2/2] Platform/ARM: Add Readme.md X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 Jan 2019 15:39:27 -0000 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Fri, Jan 11, 2019 at 05:42:43PM +0000, Leif Lindholm wrote: > On Wed, Dec 19, 2018 at 06:01:46PM +0000, Nariman Poushin wrote: > > This covers the bulk of the information originally present in > > https://github.com/tianocore/tianocore.github.io/wiki/ArmPlatformPkg-AArch64 > > regarding building and running the Foundation/Base FVP Platforms. > > > > The sections on fetching source have been delegated to the root Readme.md > > > > Contributed-under: TianoCore Contribution Agreement 1.1 > > Signed-off-by: Nariman Poushin > > I'm going to push this patch because I really don't want to get to v8. > A few comments below. You and me both, thanks though, hopefully it moves us forward a bit by updating the docs. > > > --- > > > > Changes from v6: > > > > - Removed inline html and generally tidied up markdown > > > > Platform/ARM/Readme.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++ > > Readme.md | 4 +--- > > 2 files changed, 64 insertions(+), 3 deletions(-) > > create mode 100644 Platform/ARM/Readme.md > > > > diff --git a/Platform/ARM/Readme.md b/Platform/ARM/Readme.md > > new file mode 100644 > > index 0000000..ac86e95 > > --- /dev/null > > +++ b/Platform/ARM/Readme.md > > @@ -0,0 +1,63 @@ > > +# Introduction > > + > > +These instructions explain how to get an edk2/edk2-platforms build running > > +on the ARM Base FVP, which is a software model provided by ARM (for free) > > +, which models a Cortex A core with various peripherals. More information > > +can be found here: > > +[https://developer.arm.com/products/system-design/fixed-virtual-platforms] > > + > > +##Requirements > > +- A 32-bit or 64-bit Linux host machine. > > +- Visual Studio is not officially supported, experimental support can be found here: > > +[https://git.linaro.org/people/leif.lindholm/edk2.git/log/?h=aarch64-vs] > > + > > +# Build EDK2 Tianocore > > + > > +`cd $(WORKSPACE)/edk2` > > + > > Dropping above two lines which make assumptions that may not apply for everyone. > Sure thing. > > +`build -a AARCH64 -p Platform/ARM/VExpressPkg/ArmVExpress-FVP-AArch64.dsc -t GCC5` > > + > > +Once built, the edk2 image is the following file Build/ArmVExpress-FVP-AArch64/DEBUG_GCC5/FV/FVP_AARCH64_EFI.fd > > + > > +# Run edk2/edk2-platforms on the ARM Base Platform FVP > > + > > +In order to run the binary we have just built there are a few steps we need to > > +go through, we need to get a model, a set of prebuilts (where we will swap out > > +the edk2 image with our own) and the tool with which we will swap out the > > +prebuilt edk2 image. > > + > > +We will also rely on the "run_model" script that comes with the prebuilts, it > > +is entirely possible to run the model without this but would require quite a bit > > +of knowledge regarding the areguments ARM fastmodel (documentation can be found here: > > +[https://developer.arm.com/docs/100966/1101/programming-reference-for-base-fvps/base-platform-revc-features]) > > +however the manual set of the FVP is outside the scope of this document. If you are interested > > +please consult the documentation. > > + > > +It's recommended you create a folder where you download the prebuilts and > > +required tool and copy your edk2 image in to it, as the run script expects > > +the binaries in the same directory. > > + > > +1. Download the Base FVP from here https://developer.arm.com/products/system-design/fixed-virtual-platforms > > + > > + - Select Armv8-A Base Platform FVP based on Fast Models 11.4 > > + - It has a click through license but is free. > > + > > +2. Download the 18.10 Linaro ARM Landing Team release for FVP booting UEFI > > +https://releases.linaro.org/members/arm/platforms/18.10/fvp-uefi.zip > > + > > +3. Download the prebuilt fiptool from https://git.linaro.org/landing-teams/working/arm/prebuilt_tools.git > > + > > +4. Update the fip.bin image from fvp-uefi.zip by running the following command: > > + > > + `fiptool update --nt-fw=[path to binary built above] fip.bin` > > + > > +5. Execute the FVP run_model.sh script from fvp-uefi.zip and provide a path to the FVP binaries > > +downloaded in step 1): > > + > > + `MODEL=[path to FVP binary] ./run_model.sh` > > + > > +This expects the contents of fvp-uefi.zip, the bl1.bin and fip.bin (which is > > +the file we modify), to be in the same directory as the run_model.sh script. > > + > > +This should be sufficient to provide a build/run/debug environment for aarch64. > > + > > Above line makes the 'file' command call this an "exported SGML > document". So I'm dropping this too. > Sure. > > diff --git a/Readme.md b/Readme.md > > index bb53c6f..86c989f 100644 > > --- a/Readme.md > > +++ b/Readme.md > > @@ -206,9 +206,7 @@ they will be documented with the platform. > > * [Overdrive](Platform/AMD/OverdriveBoard) > > * [Overdrive 1000](Platform/SoftIron/Overdrive1000Board) > > > > -## ARM > > -* [Juno](Platform/ARM/JunoPkg) > > -* [Versatile Express](Platform/ARM/VExpressPkg) > > So, this patch adds a Platform/ARM/Readme.md (which is great), but it > deletes the only mention of all platforms other than Sgi (which is > less so). > Please address in a new patch. > Ah ... yes, I see. Apologies! Will fix ASAP, I have some (currently) non public stuff to work on but will address this as soon as I get a chance > Reviewed-by: Leif Lindholm > > Pushed as e6fd447b23. Cheers! Nariman > > > +## [ARM](Platform/ARM/Readme.md) > > > > ## Hisilicon > > * [D02](Platform/Hisilicon/D02) > > -- > > 2.7.4 > > > > _______________________________________________ > > edk2-devel mailing list > > edk2-devel@lists.01.org > > https://lists.01.org/mailman/listinfo/edk2-devel