Message ID | 20220310205059.499269-18-sean.anderson@seco.com |
---|---|
State | Superseded |
Delegated to: | Tom Rini |
Headers | show
Return-Path: <u-boot-bounces@lists.denx.de> X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=seco.com header.i=@seco.com header.a=rsa-sha256 header.s=selector1 header.b=kXTrZ8wE; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=85.214.62.61; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=<UNKNOWN>) Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4KF1Xc5GLdz9sGB for <incoming@patchwork.ozlabs.org>; Fri, 11 Mar 2022 07:54:56 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id A8D9083B53; Thu, 10 Mar 2022 21:53:34 +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="kXTrZ8wE"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 9357B83B2C; Thu, 10 Mar 2022 21:52:03 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.2 Received: from EUR03-VE1-obe.outbound.protection.outlook.com (mail-ve1eur03on061c.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe09::61c]) (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 0140183B0D for <u-boot@lists.denx.de>; Thu, 10 Mar 2022 21:51:41 +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=gDC1ajV9Cgc9d2NMT6+g8Ex6Q0AJ2ooIrNnGAdouCJT+j+8saAFWuVBF3Nm5Uswqq+EdrQrqI8mIO/0Fk5RMtuKs9WcbCDbI1l17YMxrA7D9Tfh+rUqS34SEdmhNWwZ3I5ncScniXfawGjiyf2e244PEocY47ToQ0NfB6zLTPkkPMiRMZKt+f1acQXK80S8jJa9oJugPU28wmI1nZJNxReyMr4sGkUvXNX5NXOHOkZ/yFxnzESzbiVfKuFNMejiJvHyhV7/zFDG1yHm+/XgsmDa3gbs2yVITY8grr6CSNvQHnNrGf68eQTSgJTEGGGLwjbFdE2nvWnmwMWGO8nw/jQ== 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=/9SvQiBY7eP6Wf8OcKywk61m45OnTuqx716852sTsVk=; b=DMPLM/yRfVhh9O5xvH1Zxqy2AIKZvsR0oWZ256aCD7X4kBuv4YNrG+hADU7WgLttbf84AzmAHQ+0ecYAEEYETZshNqpoDBrrXOksq5eBjSM3A4DcWzPfC+jCXBLBY9dF9n0MseiGYHNPPpME+ETlhncseYhN+MIA21oPxjiQ0rdi5R8NBMcPxHNGt+pG2Qmd/hf4AGZI6OCUVf0djw6+7zAnyhb2z2Vvvl/afJo9eUoBkgIm/dJgfwng0NWbKJmgD53W0gJCp3O1MnjW27pAuKtCYJlzCEC3QvihrHVdsWP4XNPZjL1x8ddTgOmhFRJ4p+r4uHEVMAfF3FE5HhVoww== 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=/9SvQiBY7eP6Wf8OcKywk61m45OnTuqx716852sTsVk=; b=kXTrZ8wE6ZcxMT84nP1t5siZRyFgT7cWIP5bfU6cHmjUvfuU+nhQcvsFEF0jR8nztQoBZSRGtWmOiJ75WRkXrBV1vXuMk4+CpWoqIb+KucN3mE8HCu1fuXoF3fB/Gs5HR0PFmNq3s1I7xAhNu7mrNQ2zP1Zf9U5FR8RE84fBV13Mpzu9/+QcwlJdEwkamLKsBh85qOSoJbOtXLAsedyHfr3IqhCSF55UXFPzQiSuWrnQliw8pT29yQPjirY8m7/nIpsr7CjbYxSf72Q4WvdBxbgEulrXzh9GJy9FVJ2cvwr/sD5quNf0v9kn0X24glLoUhC+ylZaBqDPmomsxla5DA== 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 DB6PR0301MB2439.eurprd03.prod.outlook.com (2603:10a6:4:5b::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5038.14; Thu, 10 Mar 2022 20:51:40 +0000 Received: from DB7PR03MB4523.eurprd03.prod.outlook.com ([fe80::9860:b15b:f166:5896]) by DB7PR03MB4523.eurprd03.prod.outlook.com ([fe80::9860:b15b:f166:5896%3]) with mapi id 15.20.5061.022; Thu, 10 Mar 2022 20:51:40 +0000 From: Sean Anderson <sean.anderson@seco.com> To: Tom Rini <trini@konsulko.com> Cc: Liviu Dudau <liviu.dudau@foss.arm.com>, u-boot@lists.denx.de, Simon Glass <sjg@chromium.org>, Linus Walleij <linus.walleij@linaro.org>, Andre Przywara <andre.przywara@arm.com>, Sean Anderson <sean.anderson@seco.com> Subject: [PATCH v2 17/28] doc: smh: Update semihosting documentation Date: Thu, 10 Mar 2022 15:50:47 -0500 Message-Id: <20220310205059.499269-18-sean.anderson@seco.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220310205059.499269-1-sean.anderson@seco.com> References: <20220310205059.499269-1-sean.anderson@seco.com> Content-Transfer-Encoding: 8bit Content-Type: text/plain X-ClientProxiedBy: BL1PR13CA0433.namprd13.prod.outlook.com (2603:10b6:208:2c3::18) 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: 6a171d8b-62a6-486f-95de-08da02d7c6ca X-MS-TrafficTypeDiagnostic: DB6PR0301MB2439:EE_ X-Microsoft-Antispam-PRVS: <DB6PR0301MB2439CA4619C1259B35E2A4F7960B9@DB6PR0301MB2439.eurprd03.prod.outlook.com> X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: e4sokE7o0QV2A/LXtVp7OhWu4ijZywQCh9HSXDyLE2YdmkimxJK1UgDGNkCg2uKW6cMGlMJ3QjQhrlnCjaSJB9mG+gQEwUBpxzt4YtSRI1L6qTEHvUuBTF9N2Bn0SUNMSEHVz7SCYmUk/7eQpzldpwsuaqO0BvqlKeEGBj2S42Pve2v5c8slOT9OV04277ASLtw5H95DKzOjAlG+czuggSh/oLJeIWKABZts19qODKCtx3GDxGDHV25xr/BCUVPckWElY2Kq9byHeq9F9fu8H/WW5wvFiF1C/AyjivpjGzgVrmo3y741AS3lxBpONgSpiuuk0+XXanu5FFpgCy16jVArpfb8dwmk9TQSItZlXTNEYAfDPBdGblny5iG+1jYj9zKq+AfZGTS7X6iHWbmHkdHOlsVzQktYZy9RuAtpBn3izhaBnArCmaN4CnFRhW3Vt5i2yVEY/H/gSIB8FcNSTX4XZlhYmHgWIKL3uuHqKU7MU/M6Osa9KCa7y74nRffVtulAdi4Tg4I+/evicPrVQZIF55J9sbbHNMR2XofAsMKuteiv3aK6D1641FthU4/r1RIeG4d2SkhFz4EHCo0QdzpjGyZzOEoTmE9rIkQisYVa/sGjOvN456U30xyqZRdIS+IJvQNyUIO+YkJ5/wXRZ0XLsp1hjfqZzXFVYmeTLBLaCfyyeRu+gqAQDX3Zy0xSK3s4GFreCz4WEyy3/jiDng== 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)(54906003)(15650500001)(66476007)(316002)(4326008)(66556008)(6916009)(8676002)(66946007)(44832011)(36756003)(86362001)(2906002)(38350700002)(38100700002)(5660300002)(8936002)(6512007)(52116002)(6486002)(6506007)(508600001)(186003)(26005)(2616005)(107886003)(1076003)(83380400001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 2DN7sOnRGLrf3GzuuSQqxBzVsQ4qNQB0u9Z7ds+hWj3eikT4H3A+kZZ0Px1SjTBquZk0sKhrknLYH5YNQrvgTzJSFIrXFDqOX0LtqoYSFtjZwn7zRfNZaq5Dn8OaNNQdKwPofSMrp1DNmLI+1+DEBHGY8TNwDZ7kDocy9Anjvuyvth2mSMf4fQe2v34kyRQnhXxbRyQL9gY1dgkk4h5NAXGmdE7WbhZd4TFs756fr9g0h/QcO9ND+mM4PbESly/M7CbwZ+lNm5uhjhajjNJC/aFzoFyNP4Vp82UuDzdDFnbziDW0ObSZN4GPYafdkbWQR9lN0vRm51QYDUJYt+5UqGa/HbkWgcXDGnenazWVDz9eUbftQPGUSHHiP+fkox2ncDjFC6RGHYXYef35S0ddCORvIGxs6vO2anmnQzkLznL8bijPSTKrK0whrm0qZics2Tmjs+c3SnC6yK1rHRLpuApKU1COdfp063eztAPB5rK8oy6yOiMxU1B1/tZeTeQ6OwqN1Y58TptKRxkMuResmTa5hHyNffZ40aL/0AsApKPIj8FXFXuEfOeMUA7z4aimXgQd5ZpjCa8P+9SsKfBKnPu5HAxRpV6l7T7COzsJ11Ya4J4JPAVX6yDv3oRflyhqk1T4gr7gvODKFGP2KSD0AO7lQXdsHtdYn6LvxseglxmPbv7i9+pOq3dj61TBwpZI4phB0WyxKosTAtQMO2NlkaHE6OMcRQpuLkvo843G0p+eor3K4cAU+Vif9VczJEYzzKcnXiQD5k+pd+WYkajPx+duGgMUpbSzt9glmVYwAY+UyJdOnG4CAeqV2Q+8ffN3idi9wypPYL7dx2Fm1qsTMgBM3xHiarbStVqLrhI1Ty6pqP9G2GUkb9SUjFa8Ua2nbkR4w9WfpGYo/ycq+hyqjYe+rJL5Yn+FIkq/Dr7xPpoj2CG04OtvGVE9e04G1RAgsWUHj35MiTlauB2+4CwHpwZASEkzAXXfBK3MItFjBBvvDKEPfxbNAxQNRjd3JHFTR+ktmsZSzfEbj1kdZkL83Aqbzrr1Lqjfoxm2uWBlmBVseeh5QEBNkmmePY0g3mP2CWJZnvpRWVoCB94N+iIZqXpW8LWPdzCLGtwxK45LTBOx0VqpUKYCDOrLOkf/UVwrGeAt7LJkTvUaTv1Ri1TYb0hIQEPps9OzAZ58vGeQpmyDHpv6A82rl9E+Tm7x3cxKv0AU87xEKiYmJxCxnmzbRY57py3xQxY9qFa5B1J9t0dIAAEuTcVUt7VHB4uQr73UQvxkM2YZwmnR6dQHffdnJQMNRZ+mh/n9mGNTtzyfDiSKx6LiF5YbZht9XQLVmyOvb79kyxBXOD6eWZ334/lRlJKKbcIS/kI4oWzXTt95ZBvLvQ4VTuyQBRdnk8awpo5mJIUCdizrTHUu0Wb/NlKsJNc0+K/6FmJQr/osWdcM1LGPIyDPdHm4/q0VhAq971fBAxgIy5892XXz2jexcdpfMv5UHral5UDizJwxw52Q+osWRcXYSUtcD3S5bekZ/UenX6fruD6Os6wGRhAnOzC9JZygBZpW/vuYXQPbpcqUXIfcGRBA4S5OyEidVrWYm2R52HGzRgJ3VWRQxfYOxuta/+3i62eQV/zNOAGzaJabUCM= X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6a171d8b-62a6-486f-95de-08da02d7c6ca X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4523.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Mar 2022 20:51:40.3517 (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: Y7xVfYPCrwhnnsOjYMKhrfoE7YXWhCxB5YuC+02uhS8pYeVklV0DqXTV9PjD04JKZVH39ywKsXaD48bOTUAg8A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0301MB2439 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion <u-boot.lists.denx.de> List-Unsubscribe: <https://lists.denx.de/options/u-boot>, <mailto:u-boot-request@lists.denx.de?subject=unsubscribe> List-Archive: <https://lists.denx.de/pipermail/u-boot/> List-Post: <mailto:u-boot@lists.denx.de> List-Help: <mailto:u-boot-request@lists.denx.de?subject=help> List-Subscribe: <https://lists.denx.de/listinfo/u-boot>, <mailto:u-boot-request@lists.denx.de?subject=subscribe> Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" <u-boot-bounces@lists.denx.de> X-Virus-Scanned: clamav-milter 0.103.5 at phobos.denx.de X-Virus-Status: Clean |
Series |
arm: semihosting: Cleanups and new features
|
expand
|
diff --git a/doc/usage/semihosting.rst b/doc/usage/semihosting.rst index ed16e4d582..e3cb88724f 100644 --- a/doc/usage/semihosting.rst +++ b/doc/usage/semihosting.rst @@ -34,10 +34,40 @@ Foundation and Base fastmodel simulators. Loading files ------------- -The semihosting code adds a "hostfs":: +The semihosting code adds a "semihosting filesystem":: - smhload <image> <address> [env var] + load hostfs <address> <image> That will load an image from the host filesystem into RAM at the specified -address and optionally store the load end address in the specified -environment variable. +address. If you are using U-Boot SPL, you can also use ``BOOT_DEVICE_SMH`` +which will load ``CONFIG_SPL_FS_LOAD_PAYLOAD_NAME``. + +Host console +------------ + +U-Boot can use the host's console instead of a physical serial device by +enabling ``CONFIG_SERIAL_SEMIHOSTING``. If you don't have +``CONFIG_DM_SERIAL`` enabled, make sure you disable any other serial +drivers. + +Migrating from ``smhload`` +-------------------------- + +If you were using the ``smhload`` command, you can migrate commands like:: + + smhload <file> <address> [<end var>] + +to a generic load command like:: + + load hostfs <address> <file> + +The ``load`` command will set the ``filesize`` variable with the size of +the file. The ``fdt chosen`` command has been updated to take a size +instead of an end address. If you were adding the initramfs to your device +tree like:: + + fdt chosen <address> <end var> + +you can now run:: + + fdt chosen <address> $filesize
This documents the new semihosting features added in the past few commits. It also describes how to migrate any out-of-tree users of smhload. Signed-off-by: Sean Anderson <sean.anderson@seco.com> --- Changes in v2: - Add migration instructions for smhload doc/usage/semihosting.rst | 38 ++++++++++++++++++++++++++++++++++---- 1 file changed, 34 insertions(+), 4 deletions(-)