From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id CB855C433EF for ; Mon, 20 Dec 2021 17:47:06 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id E630D83633; Mon, 20 Dec 2021 18:47:02 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=arm.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Received: by phobos.denx.de (Postfix, from userid 109) id 9DC6583662; Mon, 20 Dec 2021 18:47:00 +0100 (CET) Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by phobos.denx.de (Postfix) with ESMTP id B087E83468 for ; Mon, 20 Dec 2021 18:46:56 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=andre.przywara@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 BC5216D; Mon, 20 Dec 2021 09:46:55 -0800 (PST) Received: from donnerap.cambridge.arm.com (usa-sjc-imap-foss1.foss.arm.com [10.121.207.14]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 95AF13F774; Mon, 20 Dec 2021 09:46:54 -0800 (PST) Date: Mon, 20 Dec 2021 17:46:51 +0000 From: Andre Przywara To: Simon Glass Cc: Tom Rini , Sudeep Holla , Linus Walleij , u-boot@lists.denx.de, Peter Hoyes , Liviu Dudau , David Feng Subject: Re: [PATCH 1/2] doc: Add documentation for the Arm VExpress64 board configs Message-ID: <20211220174651.2a43340d@donnerap.cambridge.arm.com> In-Reply-To: References: <20211214175539.3173701-1-andre.przywara@arm.com> <20211214175539.3173701-2-andre.przywara@arm.com> Organization: ARM X-Mailer: Claws Mail 3.17.5 (GTK+ 2.24.32; aarch64-unknown-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.38 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.2 at phobos.denx.de X-Virus-Status: Clean On Fri, 17 Dec 2021 09:37:12 -0700 Simon Glass wrote: Hi, > On Tue, 14 Dec 2021 at 10:55, Andre Przywara wrote: > > > > From: Peter Hoyes > > > > Create a new documentation section for Arm Ltd boards with a sub-page > > for the FVP VExpress64 system. > > > > Signed-off-by: Peter Hoyes > > [Andre: remove Juno stub] > > Signed-off-by: Andre Przywara > > --- > > doc/board/armltd/fvp64.rst | 30 ++++++++++++++++++++++++++++++ > > doc/board/armltd/index.rst | 10 ++++++++++ > > doc/board/index.rst | 1 + > > 3 files changed, 41 insertions(+) > > create mode 100644 doc/board/armltd/fvp64.rst > > create mode 100644 doc/board/armltd/index.rst > > > > diff --git a/doc/board/armltd/fvp64.rst b/doc/board/armltd/fvp64.rst > > new file mode 100644 > > index 0000000000..9817b0aa3f > > --- /dev/null > > +++ b/doc/board/armltd/fvp64.rst > > @@ -0,0 +1,30 @@ > > +.. SPDX-License-Identifier: GPL-2.0 > > + > > +Fixed Virtual Platforms > > +======================= > > + > > +The Fixed Virtual Platforms (FVP) are complete software simulations of an Arm > > +system, including processor, memory and peripherals. They are set out in a > > +"programmer's view", which gives a comprehensive model on which to build and > > +test software. > > + > > +The supported FVPs are available free of charge and can be downloaded from the > > +Arm developer site [1]_ (user registration might be required). > > + > > +Supported features: > > + > > + * GICv3 > > + * Generic timer > > + * PL011 UART > > + > > +The default configuration assumes that U-Boot is bootstrapped using a suitable > > +bootloader, such as Trusted Firmware-A [4]_. The u-boot binary can be passed > > TF-A has become a bootloader?! As much as U-Boot is firmware, yes :-P The full featured TF-A suite contains a whole loading stage (BL2), some platforms have MMC and even USB drivers. We can also put a Linux kernel directly into DRAM, then TF-A directly drops into Linux directly. The point is that for those virtual platforms a boot*loader* is strictly speaking not required, since you can much easier load through your host - either via semihosting or by letting the model programme put your binaries directly into the emulated DRAM. > > > +into the TF-A build: ``make PLAT= all fip BL33=u-boot.bin`` > > What is in this case? That depends on the exact model, but just "fvp" would probably be good enough to put in here. Cheers, Andre > > + > > +The FVPs can be debugged using Arm Development Studio [2]_. > > + > > +References > > +---------- > > + > > +.. [1] https://developer.arm.com/tools-and-software/simulation-models/fixed-virtual-platforms > > +.. [2] https://developer.arm.com/tools-and-software/embedded/arm-development-studio > > diff --git a/doc/board/armltd/index.rst b/doc/board/armltd/index.rst > > new file mode 100644 > > index 0000000000..caa6fd2bb0 > > --- /dev/null > > +++ b/doc/board/armltd/index.rst > > @@ -0,0 +1,10 @@ > > +.. SPDX-License-Identifier: GPL-2.0 > > +.. Copyright (C) 2021 Arm Ltd. > > + > > +ARM Ltd. boards and emulated systems > > +==================================== > > + > > +.. toctree:: > > + :maxdepth: 2 > > + > > + fvp64 > > diff --git a/doc/board/index.rst b/doc/board/index.rst > > index 74ea33e081..78b486538b 100644 > > --- a/doc/board/index.rst > > +++ b/doc/board/index.rst > > @@ -11,6 +11,7 @@ Board-specific doc > > AndesTech/index > > amlogic/index > > apple/index > > + armltd/index > > atmel/index > > congatec/index > > coreboot/index > > -- > > 2.25.1 > > > > Regards, > Simon