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 BA59EC433F5 for ; Thu, 3 Mar 2022 20:47:34 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 97B4E83D78; Thu, 3 Mar 2022 21:45:30 +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="cndygLGp"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 195DB83CC0; Thu, 3 Mar 2022 21:44:56 +0100 (CET) Received: from EUR02-VE1-obe.outbound.protection.outlook.com (mail-ve1eur02on0600.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe06::600]) (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 AF55083D14 for ; Thu, 3 Mar 2022 21:44:38 +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=oFTB0vPt+iOZfkdWbk97+/NXx9Iqpw7gtfXPlS6K0xAi1uubupfebADJzgyU6CiFJJlndkuC5ZpiTE6b7WzUtFR2qehmvuLwCRZbLAjaYBY8YOxWRp3bAus2vodevKAaWanZ2c4kMiBhVV3y8tUE2bI3rkQms84hloMCGbVJwxsPeMgRHaS58FINzP7ycZwx6AR0WTphkZaUP4uf8D6xdPBeTQTvckkAjTd/yEm5lb9+KNQ4MGN+AfhPCV4mjCadl4YUGTKS7a8TaDyhWjULVqBRajXfrlxh1KGHhYfRTwVBioNb19Q6ygHAtuUEeb9u0unNbVWc7RDETWxdHu81Tw== 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=UUZUXWYYizmwel+Y6Bn7alPsBjHjBxKbVqN9EbhGsSk=; b=V+VSeuh+5p5+tuJU7HE1mdzCivnY8cWTKIaH9sPW5lK+z4QxzvKuHxFdtdKehXEaSujXvYN+Fr0XDynZldb53Y8+STn3wbbhtAl07CPohCEcRHyMgGwVvRUUsT2BLQeUzmvlr4jn/ZjNDJY0ouw6U0rc9xL6NyeS75V5kFa7liALhSQ1835z5a26FOhDercm+ONt42fLBDABdcE42Bu0dcWMBWXaE80Mcgn1fycbD88SKIoHi939e0keMcdw37gqNQ36rOplh85ePjudtE79QIqmNYkC4EkuG0x+xxhql+eiTBFIucvaPQa/ySdh3oZUCJJU4/cUyd+qnHjk+AGrsg== 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=UUZUXWYYizmwel+Y6Bn7alPsBjHjBxKbVqN9EbhGsSk=; b=cndygLGpttB/Ni4ONmCqGrtDks/H5iq5XTFfq+Gz5xOlyEtjj3QYag9ZncYDQQbGGJfHUJqMSQ6/AR4vYElAf0ANXS0Iw4opuje/IpuUew/F7v961DVfGvedL7tDo59pY5Tm1Y+21S1xaLIlDgo97fivWpyrEwLpeCvNc2etZgX49qOmfzy8nLWjq4DABXeaDe+INAokEtakIx0UP85/u8ww0TlcX7HrFRuKqAoY/nOGj4zeeK1/86OSwWd2bcBvIoOs56ddn813gjSn1gxHoq70gNDX1SVmbZuyFiA1GLaislqsIdBPTNpszlb2XN5hdDOYK4yxfpQ9oRIEWdwKZw== 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 AM6PR03MB3573.eurprd03.prod.outlook.com (2603:10a6:209:2f::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5017.26; Thu, 3 Mar 2022 20:44:37 +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:37 +0000 From: Sean Anderson To: Simon Glass Cc: Linus Walleij , Tom Rini , u-boot@lists.denx.de, Sean Anderson Subject: [PATCH 16/17] doc: smh: Update semihosting documentation Date: Thu, 3 Mar 2022 15:43:59 -0500 Message-Id: <20220303204400.2787389-17-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: 8094fffa-a0dc-48ef-b748-08d9fd56a1a3 X-MS-TrafficTypeDiagnostic: AM6PR03MB3573: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: A9z0a/iAhJzpZR5qh7pVp1zMw2GaXx73e0aHp0SVNcJy+DIXmnnSMJ8WiLafm4sg6yLasaAvf9l6J8b5H3qrDXfPorJTUjToauV6jaIeQJN4oDnd9mRhU5bKCYsdxqclL8mOtRGryYyrf30K6yXQVOyk32dMBa3Fx9pLCMhQWIinknJIUeh2MnlrUmuYxTXkO0yuqefsUZkpqLXVvFYo2S4oXq/dxnYVThJuJFT0JX143NkLFuz8r4MnjrT/yc1DY0PcpP0KzRd0/4BHQPx4/2RTo5drWCbqBFBGSbnDHetNKWpMip1tWbwypS32cAKHElMuA5BBAw/C+4FeRTX5CcdiA61i4fh5ezp57E5CEG9WktzNSOFAeejLDa31PPO0E+utdC0FowZeZkNlzlcI4yEjE9LgTQZh60yEiTexKS4v2AB0CNvhFtYnNMh0TsMDnt81nqIu8oBJw+YoMKeuqLq7rzWchV8hRvfkPOcJza9X++Bcy969yhdzGjU4yKOml+O5LT3RQcTnJvnTaISehd81TYzLS3hX4eHDsYgucPnBsyYmmmlKyrtguChwzFEY5qqqAcEwgR2fg1Y1ZW/fA1lCKVGEuJFxpzOFcmwgcedVLX6aJ+LkgBg857lYvDvWjDncFSWNFKWcWRn2P8oMrd1FmSVwzMhWAqYYTrFq8jOR3KKl5K6b1U9ffjGrK6wmiiFSsLq8sfxehfyKPT9J6Q== 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)(6916009)(36756003)(54906003)(1076003)(2616005)(83380400001)(316002)(38100700002)(38350700002)(186003)(26005)(107886003)(4326008)(6506007)(6666004)(508600001)(6512007)(2906002)(52116002)(86362001)(5660300002)(6486002)(8676002)(44832011)(66476007)(66946007)(66556008)(8936002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?t/Nlrr35FAKZuZvaOm6YoozsN+tvExCN4q93Nf96hiM4/sTXSuG4ztb3z/VT?= =?us-ascii?Q?Kt83MINRUFTjMwLEmAGrXI5W4k2tmr+PmK3f64oqX5G+02AjlriZp7Kc5yNv?= =?us-ascii?Q?VN/z2rRd6RrxtRNbfSRUFrYS1ERq2BTlEXoOJO74DYJn+A8shqL0J3b0XEMK?= =?us-ascii?Q?A6vJJs2TpJshQrCyg0Sa9/qvGOU/7OeKxmVRIooUj+oV9A2Wg/MtG9Ijw0Hc?= =?us-ascii?Q?6otyP4C28G2FKq/BDxflGEiJ8Ao8VVVA+S53rJOoW7bOer07iVQfKmV23hW8?= =?us-ascii?Q?T7TCVDwREoSuPdh+xm8lyBDPVkWDaDH4KmPeCoS6LS1GkJmIdLCrCHT53se+?= =?us-ascii?Q?Mui7Hq6Kh0j5O0/E8t3/Ha/yMk048gW2/gkKMJbxAgPKnNKcrZCgCxmNmRLb?= =?us-ascii?Q?K6i0D/MtArc6rk9hGIYlkhuZQ/is/DNuyVE1ROdJpwyecSAqseeNzWOq1V4g?= =?us-ascii?Q?GOjCekQ7lj5Lfkd1SiW4k5oHgSF2fXD0zD7YMQgn9Is1/TIwmP1/9X77D1pu?= =?us-ascii?Q?f1vATulQV2fUB1sTbf/UKR6KvL/mHR9gQ6EJkKYCZtucixzh7naW0RGw6/G+?= =?us-ascii?Q?HlqAhtz0j+u3K/jhoPQBsStBAaPkvs9+8Nowv5XdU19YY33bD+2H69u+B2Sd?= =?us-ascii?Q?vAYzeViGcpv2DMltl7vgcho1VUaW6EAij87EitM6W/OLhwGflSKkwVm1U/bY?= =?us-ascii?Q?PEMcMx3OHMXqjbZ4SmlhoScaqLjMwJHF42Ocrg8Rsepj6pNPAJjs86QycwLp?= =?us-ascii?Q?gVQpaXZ/dQ898MUANmFbQ2KzLiOp/tAtD4mkN71TEZ+yhKxdll9owyUzev6Y?= =?us-ascii?Q?ZLpPl8jfLKCiPu8B6B7u42k2rMLFnUdoVVoRifEXGh10mRFlWMco+BkKn9Z0?= =?us-ascii?Q?PFUbimB9GcNyUCmaP/Pjp1IrPBLPSG3+AZ8a1PVttU4b9v7KNZM8F5CJ779E?= =?us-ascii?Q?7Z0uDa/W6FCLODgljZ+SLjba+dhb2yg+wYtfSUFV/wj5GpB8eIq5KXUXMOnH?= =?us-ascii?Q?fu5fvoow5Eo3J+4plegJ3Sp41m4HJGBdV8a9IV+5ylSPgnHSNlS5cCY4RLtN?= =?us-ascii?Q?RGvHNHD2QCLK2dI6bV7jDRZKza4FKCVMa4Iqevp0Nbui0c5lQllzOgNMF/Ob?= =?us-ascii?Q?rBvAhb4ZoGnKtbFh2Y/tP0zZithAJaIQy9Q0Qe5pNnyxLixvFEYhElSSRYQA?= =?us-ascii?Q?ABiSSaEOLqiX0LeOmqHONlRQzGjg0WF+QGdikPBMKqWMiky/MoSJ3Ao0nCyW?= =?us-ascii?Q?CvkkPvmmq8vHZnK7M/7AU5Q72MqNKXzxbRMY5JSxONsSINJVl/BOxPtaHiIz?= =?us-ascii?Q?LOo54bNpwOJPLaXkqmq+DF8QnAR5lf/Yvn0sj7539tCMHWZpcUMSkG4d8u6+?= =?us-ascii?Q?HD0sFuFQTPgrlkMPOStmMpCTexAMLEf47Xa9hMj7yfGu/nMX8FiAtGVMp5v+?= =?us-ascii?Q?0uOfKP71XiBFHY4MQ98d6yZll/hcYtB61uMztO+8As885rac8PBb9PhhRb7+?= =?us-ascii?Q?jOIDzmxa44rf5aMb2V3a0WzAqY4siypv/kf020d2HDuLpdm9eOqqaTvIJWHX?= =?us-ascii?Q?+u65PZRfIzCk8W4uC8JCmchL7xJMr81QfuZpqH1Pa1Y4neWohmSQrWZQSmJY?= =?us-ascii?Q?OiQOQklHKAQX7N37tS9Hhxo=3D?= X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8094fffa-a0dc-48ef-b748-08d9fd56a1a3 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:37.2855 (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: mXxtlZh1sY9Je70E+z+KI2VujtnYmb8cAyZmb6x5pNL32VIbbhQY0SnlhMNngJxZS92MJeq3wyuhJEYxpkdDDA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR03MB3573 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 documents the new semihosting features added in the past few commits. Signed-off-by: Sean Anderson --- doc/usage/semihosting.rst | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/doc/usage/semihosting.rst b/doc/usage/semihosting.rst index ed16e4d582..986a821819 100644 --- a/doc/usage/semihosting.rst +++ b/doc/usage/semihosting.rst @@ -34,10 +34,18 @@ Foundation and Base fastmodel simulators. Loading files ------------- -The semihosting code adds a "hostfs":: +The semihosting code adds a "semihosting filesystem":: - smhload
[env var] + load hostfs
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. -- 2.25.1