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 202EBC433F5 for ; Thu, 3 Mar 2022 20:44:29 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 9AD748309E; Thu, 3 Mar 2022 21:44:26 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=seco.com header.i=@seco.com header.b="BpdqDMI/"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 89C0B83BAE; Thu, 3 Mar 2022 21:44:24 +0100 (CET) Received: from EUR03-AM5-obe.outbound.protection.outlook.com (mail-am5eur03on061d.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe08::61d]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 2F420811D8 for ; Thu, 3 Mar 2022 21:44:20 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=sean.anderson@seco.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QLG/syxyaNRyDHdmPcV+hRh07//4k2b984TXaW8FkeoQdhyVTtDDLlJAywYZsdv3L7RbntrN4BkRGCXf+cuq+NuDTZ1w+i+k7U5cdRdWBiH7utxGazevIkK8CkCs87dzPbmX748TvU30qsMOSn59ZXeKtU1z7NeiBSIbvNMH9bIrHx/yjnsO0SKMm8LBPtptbciEZgTZyNceZbJBVX8+knDti9KVmdHYTrjpnyC3fnYkLpa0qWBonFNhN00zNEaeQrYObZ4TccWKIRiUl2Y//kHg+DXFj8Q4+PPVxUEa9lfO+3jaeeNNrPl80q/jm7awK3GlqGgkzsEgxQFcMAUWJA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=tum7uRy5/2ikTf4fkYJAhgIdTbQl+WRE+Z8AiydLhig=; b=FqFNMbwiiMdqQiacM8nyrxeOJQ1phXpPyGsIRc+6XNodJebFz6cuTMGr4iFFn94WAWtL69wLbUSrxHrf5ZbGS/bibgIEKm+s2lq93ikRu6tqm4dh/WXQIOpKBe+R+DuPXKMPeSVEMxZxdMZLj23u9tQsbpOtf0+NjK0f0NH9fNI+x6te4NuhFP7d0bqESaSvT9G14bsquArxOAIrHvzAbnqUE0/AlZk+1KOHJZrILMXrrDCibg/Iruj5po1dmIYVbMtfRY1a+68Q26DDXz99sSu/dSXDgdyU5Rn7cWSrYVgfKLaayAQG/IR7TdbjryKIz8Vibdg8iJS6IaKIXtD2cg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=seco.com; dmarc=pass action=none header.from=seco.com; dkim=pass header.d=seco.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=seco.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=tum7uRy5/2ikTf4fkYJAhgIdTbQl+WRE+Z8AiydLhig=; b=BpdqDMI/O1+UsvTa9jJa1Q049GPNd8jd9V9lxv4tEPZXk7VVJLfNnU9zbTcHlEx6qv+SE0IottEnoiObiJCR/O1QRUM5wBlu8DSYn3gnOOku7eCo3Y+veIFTnZKsfTTvcSeu5CLwpHGjVfuUEetoNwQ+fj8HUImx3RhDTBz9rEvwsHEVuU9DXmqDRNcYQDanK2EcE3OJjQxDMT1ZHETYvkEejKdLH2M0lROwU5RshcB1stphlqYc+u8Hy5WDhUcnYy/xArtlMDE5eYxOjqmFkMgONgIiwBV+dAYvzFwSHt/tJuy3hXsVvemclc+xZ5wKmxsQQZkVzxRW9JhwOMXKmg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=seco.com; Received: from DB7PR03MB4523.eurprd03.prod.outlook.com (2603:10a6:10:19::27) by VI1PR03MB4893.eurprd03.prod.outlook.com (2603:10a6:803:ba::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5017.25; Thu, 3 Mar 2022 20:44:18 +0000 Received: from DB7PR03MB4523.eurprd03.prod.outlook.com ([fe80::9130:93ae:6e27:e9a]) by DB7PR03MB4523.eurprd03.prod.outlook.com ([fe80::9130:93ae:6e27:e9a%4]) with mapi id 15.20.5038.014; Thu, 3 Mar 2022 20:44:18 +0000 From: Sean Anderson To: Simon Glass Cc: Linus Walleij , Tom Rini , u-boot@lists.denx.de, Sean Anderson Subject: [PATCH 01/17] doc: Convert semihosting readme to rST Date: Thu, 3 Mar 2022 15:43:44 -0500 Message-Id: <20220303204400.2787389-2-sean.anderson@seco.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220303204400.2787389-1-sean.anderson@seco.com> References: <20220303204400.2787389-1-sean.anderson@seco.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: MN2PR16CA0013.namprd16.prod.outlook.com (2603:10b6:208:134::26) To DB7PR03MB4523.eurprd03.prod.outlook.com (2603:10a6:10:19::27) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 63757196-f532-4e51-6bb4-08d9fd569661 X-MS-TrafficTypeDiagnostic: VI1PR03MB4893:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: Vp2J2ynnMMiOrKA9ecJAkYP/hhsvl9UD2Y2qkuafLaZLQSVC0+z8HlWJRKY5/fCQmHDRHSiA7qGbW/psLlf/W2KFO7RibafEnypFwqeHINPtvu4pjLO0hMCXDGujG9i72laN7Y/C5aC9sT6B1ok2XL7Ud11eIQ76Dl7vVAYfqS8QnmMBRpHe2WO2QiqaUYfO4xKTppovVOBMX+bPryk/zk3eR2PgdkK+wOKI8U72k6hIMn91K95sCnvYJ7fTsV4mjDk+uGZpOpVJLyPgagLNiIK1+aqqYZshqITeQZ9EG7/SHL3+5FOjCxsNvPBsnKfuJhm0fy7bWsEdsu2u2DUopBMU7iZRlJOVNjdw0cisPqbyFdAElnjkrmn+tLkMRXiWcQSZa5B+x3vn0ahjpnQiNBlBHk0gpAPp/3AXWRa+5xTd9/xRipAa321UiIp+TTg4RcQ2QP1d6619ZSV8Tm6E+uSWG/wuxPhJsWCuQMiwAQ+Zi379YuDxE6KpTWRgDDtRce3gbXO3/iYP9MkCDfa0CnrQ0qFPO9M2K2bj7W2b2XMOYNZrktL+Uh/8sGy7SjrqKCKK3o4yHIdvVCVU+QZVBFsfL5dOFuHHpSs2p/QHBfUiHx/vcJJjyJx7kt8GIvwpmNQCo2OB40nMWMajBPB1RgyFOVL2FMksS/dD8Tar46Ne38Cc3FSyZev1c6D7+7ne9msvqzkxjGlDw4b7Bo5I4itYJB40GYd6r/ongjAm7RDBt51wdOj6nl7Bn8LIy484dseVQZcCGZHjaDoVgj5IwP4s/acJbtd8EwtRNUg0bNo= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB7PR03MB4523.eurprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(366004)(38350700002)(38100700002)(44832011)(15188155005)(36756003)(2906002)(186003)(8936002)(26005)(5660300002)(508600001)(2616005)(8676002)(4326008)(107886003)(1076003)(83380400001)(52116002)(66946007)(16799955002)(66556008)(86362001)(66476007)(316002)(54906003)(6916009)(6506007)(6512007)(6666004)(6486002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?nQCwBgPdPPxvz1mzWBpMYgkRpeL5CLsK6zUmyS1aPKteP2mmCMs1TBNGTPSp?= =?us-ascii?Q?sn8qd5wf01SVZQ1tI/CC8R6E6mUXnro2m/Txpj+zxFFqTj/b1X9O8SYkClU7?= =?us-ascii?Q?y/X0Y3HTwr2WYzm+QLAiycIRFDAlBi/0rUaKArv35djW9ZhlYumq+MsSj5jp?= =?us-ascii?Q?yuhLqv3QT0tMzaDsZJSvutOPtW4zWHK8xrxDB1nZirwRUHcbddzc3ZkiWG//?= =?us-ascii?Q?/0sZt9d13qjPtSb49oqr/ZbMZPZ3ogz0LipJ+GMbIB9ygtZBOc7UoRpdyfgK?= =?us-ascii?Q?vkMjbU8L9az25uuRKhiXJhpLkTL2nM82xvL/PNJgDlWXdrw/WzcCsvV8zZHc?= =?us-ascii?Q?RA0donJi7YmGtiRgxVtHX1j5e1dcSYvbB7ahGmf0cO9lmsxI9SmAWc1htMKG?= =?us-ascii?Q?Eat66hWrV4ZwrNC8jBiY3cHTzFDyNq4tuG9UtVBQXLpKPswpbGMz1/Y4VKii?= =?us-ascii?Q?g4Vj57Dx3tKEW9jGGQaHJqsAWvPeyJZK3Hjunj8SeRTkMffGzXqWlcdhVjX+?= =?us-ascii?Q?jUtuODQcU4zEUMSqRUBvV2DO5wHi1f+6Bq8T5p9V2ZjxkvcYzWpi73z4Dn+8?= =?us-ascii?Q?Q7Rl9epcAnQzavirJSpw/fe3dU2vYFBRSuCuelyC/KwvpTtsmmQj5vIs+Dru?= =?us-ascii?Q?XyQo0dipRm5J31y8252Ll/YEUEoERX8kZhhUuBZgeKWKEW7GW/daOE7JCQAW?= =?us-ascii?Q?n5iqmon/W6iSDCqSDW+TZ628D8ESZdRsbeElGl0kiDwQlVocrhbRf8Bj9TkO?= =?us-ascii?Q?u+gkfeoiKwXfZ14uGeh/l1EvJAwsJ7a5gJMqMzJ1vlbTN5niC+J50hojb4gI?= =?us-ascii?Q?PqoaPgFeGIzCsU/nHaK/PreA8XEIl1Ey+/aDZmciPXWImZfx4zQQLuBeYxQ+?= =?us-ascii?Q?0Xhk9i+9pCrjOnZJrslZxqhl5elQp/GDXERxIlDMVeH3G8Vu+NFi5R88GmzR?= =?us-ascii?Q?DyucIyy7DEqLh3pdNfjCuUl+y5q7IQ7JI5ggAJvAhJGRSKI/nr0IxUBXB5AD?= =?us-ascii?Q?GINua1X9dH8zIgOJ2ksRd8GDmoqJ17RJYqDEO8WxSY3/FtyDQh8ufKNEk5l/?= =?us-ascii?Q?BR+k5D/oJu7ji8jEbPC18m3IHyfkfwfgeuAaLHBmjoCovRRWYCRWcnaiTSRK?= =?us-ascii?Q?liDtVDL68j7vXssAxqoxQq4ouX0dmo3zkDDbUXFONxHpeskRKBcVhIR6I5Qo?= =?us-ascii?Q?nnxCgL3cubXnzFmcOJ8kcCYla/90qpM1WNcarPRoH+uzeaZu7WpE28/DwF2f?= =?us-ascii?Q?KMwMNSGLgWrhVlcuU5vKVDFgpRE2xUL4DFL2CN7KzPGy/0QOxpwvb1E6kFX6?= =?us-ascii?Q?mvtnIpKfjcdCTU8yjghy3z1we7EsqnXQf0yiryxmvntU7dvNJh3nd6BLOGkL?= =?us-ascii?Q?GLBAc1+2LLxo9YpX9InI71Qeys8oWIkjgnR1rtd+Mg9Teijs2sGDmTI4Ukv5?= =?us-ascii?Q?NzLwpzKKgNe0QMZrcavJqh3O5TUKnbLSgJWyCt/1GwanblUHvnVf1I0x6DJR?= =?us-ascii?Q?HIONCZldQPuh7nIiyMMToqFGzO1FitqqrEl5CzhNgPqtPTe1AfZCeUAuLH69?= =?us-ascii?Q?I4Kbv//mywAoVzUKhsy17jd7nX1nclWMzdXxpBvAUGJ7a0kazJOri5sCri3F?= =?us-ascii?Q?ANPEMRUq1DpjStLOgyWArf8=3D?= X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-Network-Message-Id: 63757196-f532-4e51-6bb4-08d9fd569661 X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4523.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Mar 2022 20:44:18.3180 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: C13KvVmZKj+dHAB58uLq2L9NtmuBaikr4cQjbRrPaVfBnvohgXl/2KWNX6kwUTy3uPc0jTtmfGZBZv2OvabZyw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR03MB4893 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 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.5 at phobos.denx.de X-Virus-Status: Clean This converts the semihosting readme to rST. I have tried to make only cosmetic changes, but I did fix up the first link (which was broken). Signed-off-by: Sean Anderson --- doc/usage/index.rst | 1 + .../semihosting.rst} | 35 +++++++++++-------- 2 files changed, 21 insertions(+), 15 deletions(-) rename doc/{README.semihosting => usage/semihosting.rst} (53%) diff --git a/doc/usage/index.rst b/doc/usage/index.rst index 964d761e13..569da2bdd1 100644 --- a/doc/usage/index.rst +++ b/doc/usage/index.rst @@ -11,6 +11,7 @@ Use U-Boot netconsole partitions cmdline + semihosting Shell commands -------------- diff --git a/doc/README.semihosting b/doc/usage/semihosting.rst similarity index 53% rename from doc/README.semihosting rename to doc/usage/semihosting.rst index f382d0131e..ed16e4d582 100644 --- a/doc/README.semihosting +++ b/doc/usage/semihosting.rst @@ -1,35 +1,40 @@ -SPDX-License-Identifier: GPL-2.0+ -/* - * Copyright 2014 Broadcom Corporation. - */ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright 2014 Broadcom Corporation. + +Semihosting +=========== Semihosting is ARM's way of having a real or virtual target communicate with a host or host debugger for basic operations such as file I/O, -console I/O, etc. Please see -http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0471c/Bgbjjgij.html for more information. +console I/O, etc. Please see `Arm's semihosting documentation +`_ for more +information. For developing on armv8 virtual fastmodel platforms, semihosting is a valuable tool since it allows access to image/configuration files before eMMC or other NV media are available. There are two main ARM virtual Fixed Virtual Platform (FVP) models, -Versatile Express (VE) FVP and BASE FVP (See -http://www.arm.com/products/tools/models/fast-models/foundation-model.php) +`Versatile Express (VE) FVP and BASE FVP +`_. The initial vexpress64 u-boot board created here runs on the VE virtual platform using the license-free Foundation_v8 simulator. Fortunately, the Foundation_v8 simulator also supports the BASE_FVP model which companies can purchase licenses for and contain much more functionality. -So we can, in u-boot, run either model by either using the VE FVP (default), -or turning on CONFIG_BASE_FVP for the more full featured model. +So we can, in U-Boot, run either model by either using the VE FVP (default), +or turning on ``CONFIG_BASE_FVP`` for the more full featured model. -Rather than create a new armv8 board similar to armltd/vexpress64, add -semihosting calls to the existing one, enabled with CONFIG_SEMIHOSTING -and CONFIG_BASE_FVP both set. Also reuse the existing board config file +Rather than create a new armv8 board similar to ``armltd/vexpress64``, add +semihosting calls to the existing one, enabled with ``CONFIG_SEMIHOSTING`` +and ``CONFIG_BASE_FVP`` both set. Also reuse the existing board config file vexpress_aemv8.h but differentiate the two models by the presence or -absence of CONFIG_BASE_FVP. This change is tested and works on both the +absence of ``CONFIG_BASE_FVP``. This change is tested and works on both the Foundation and Base fastmodel simulators. -The semihosting code adds a command: +Loading files +------------- + +The semihosting code adds a "hostfs":: smhload
[env var] -- 2.25.1