From patchwork Wed Oct 14 09:12:09 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peng Fan X-Patchwork-Id: 1381915 X-Patchwork-Delegate: sbabic@denx.de Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org 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=) Authentication-Results: ozlabs.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.a=rsa-sha256 header.s=selector2 header.b=c78k0Soh; dkim-atps=neutral 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 ozlabs.org (Postfix) with ESMTPS id 4CB5fN417Sz9sVR for ; Wed, 14 Oct 2020 19:48:12 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 8315A82495; Wed, 14 Oct 2020 10:46:09 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.b="c78k0Soh"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id A241D82478; Wed, 14 Oct 2020 10:46:03 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FORGED_SPF_HELO,MSGID_FROM_MTA_HEADER, SPF_HELO_PASS,URIBL_BLOCKED autolearn=no autolearn_force=no version=3.4.2 Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on060f.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe1f::60f]) (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 E01A582474 for ; Wed, 14 Oct 2020 10:45:59 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=peng.fan@nxp.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DGFLsA0khO8tRMpXBgE77iHTRN2EumZ3U6mz5NTgFQrP4UF671y8vUkaJ3ita1EqC0NNG3BHQ9Vg+cW+FHyGzZC+zQw7TaWFHC5s2caI0w2MHYoVvXJsf6uAICe+JXetXgTG2N0VOT/W3mtM0S9J8LLIGp4x5ZjNFAP1+8SOrjqMERWfTaz34rrWkzhLMAnbR1soifhP9Jkz8O8eDpxd1Y/PKPbpEceYiPXsLuQ+HrehSzZH6K0OHs09IcLRQ94AamnSoAEWWmDxuf4fWY3msjCsEeMCItPurA1LPbqwcW+xO8a9CLSTkimB/NOgBewHY9zucpq7JiaGIPNr9aH1NA== 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-SenderADCheck; bh=Jh2GuE1hsc1nmACwgyYqDqBfSxD1XcdV9A8TTJSIRrg=; b=ls01tD28WaOOif9v46VhC0XuqCLYiFaRw8We66Zp9WPb7iuu6cHCZY5UHPB0psRKqenSsSITLQ3qKH9CnMX49AznwCBOVu8v7hN9YUcRgYT7oG+jXwjZb1x1qyx9xYOLmenlixyloXgTdj7vOXBHZJnTvnaEF6KTHU7aSbtzmQu9CrLhCdFjsIoISZI23YlBrTU0ubhQVpGQr9wX5NVBcA3YzZomFmjHZq6arnWQW2KGiD3tp2aYiOw/Z5s+5+aruk8mnCPD/SrFHMoV5P6XOiMOuKMusmbKcHrfL0nNmJyVJNXfE+ca2fbduvSJkYkXxMvqXSaCnn1as+US6QFQbg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Jh2GuE1hsc1nmACwgyYqDqBfSxD1XcdV9A8TTJSIRrg=; b=c78k0SohQ0AZnkuW7qJTGk8Z71xT+pAvxYDhiKuhGnGSNic9TNJXC9FG3x1Ab4IorCN1InJjYxdoE2wTqavYRKmSaZQtv9S9xIg9JFhjVkD4LF0V8Fmc5QEBasRVlRJch7Bm4356HiJx9xeD/cR7g66/aLmFJ8Lpk+Lc73yKWCo= Authentication-Results: denx.de; dkim=none (message not signed) header.d=none;denx.de; dmarc=none action=none header.from=nxp.com; Received: from DB6PR0402MB2760.eurprd04.prod.outlook.com (2603:10a6:4:a1::14) by DB6PR0402MB2760.eurprd04.prod.outlook.com (2603:10a6:4:a1::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3455.22; Wed, 14 Oct 2020 08:45:58 +0000 Received: from DB6PR0402MB2760.eurprd04.prod.outlook.com ([fe80::35c5:8c71:91f3:6bc6]) by DB6PR0402MB2760.eurprd04.prod.outlook.com ([fe80::35c5:8c71:91f3:6bc6%12]) with mapi id 15.20.3455.031; Wed, 14 Oct 2020 08:45:58 +0000 From: Peng Fan To: sbabic@denx.de, festevam@gmail.com Cc: uboot-imx@nxp.com, u-boot@lists.denx.de, Peng Fan Subject: [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK README to reST Date: Wed, 14 Oct 2020 17:12:09 +0800 Message-Id: <20201014091210.12113-12-peng.fan@nxp.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201014091210.12113-1-peng.fan@nxp.com> References: <20201014091210.12113-1-peng.fan@nxp.com> X-Originating-IP: [119.31.174.71] X-ClientProxiedBy: SG2PR02CA0117.apcprd02.prod.outlook.com (2603:1096:4:92::33) To DB6PR0402MB2760.eurprd04.prod.outlook.com (2603:10a6:4:a1::14) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from linux-1xn6.ap.freescale.net (119.31.174.71) by SG2PR02CA0117.apcprd02.prod.outlook.com (2603:1096:4:92::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.21 via Frontend Transport; Wed, 14 Oct 2020 08:45:56 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 61596645-670a-4c26-4e8d-08d8701d924e X-MS-TrafficTypeDiagnostic: DB6PR0402MB2760: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: K3flMEzV3LPhJnflx9DDMYaD43mtB8gw2KRD4GQFV7t5uM2d49LHoLXI9IKEcgh5HdggZtuauFRxK4xuyq2PGvUPcSWL1sgJUSTA8rUXVQCLg0WpP2dQnn2TpGIW06A6uLcDH8LiS0aNlDHi1D5U3wxv1wj3zKoao9b5eL9WodOyqNxBP6dELqM22bO8VkjHazx8CC3EP10g9Lp+SSfq14aU4CG9N+QFrZCvxQ4IQbwOPiRt/ncF2vBrReqMVRzYipKH9NVOpolqw0Lo0OyM52b8tnZz6voGIVfPv16hVt0ZDRf/acXNJ0YKJHnzHeFbxxDd1VbjWkM4c4jsa6YU5NM+TdBRK8OfdsOQFFJ9IT2Yt1zhcPvlJT9kyDcpKXaqHPw7Q4OkOWFAPjRsgkaDfA== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB6PR0402MB2760.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(39860400002)(366004)(136003)(346002)(376002)(478600001)(4326008)(316002)(1076003)(2906002)(26005)(16526019)(52116002)(6512007)(2616005)(36756003)(86362001)(956004)(8676002)(44832011)(186003)(8936002)(83380400001)(6506007)(6486002)(966005)(66556008)(83080400001)(66476007)(6666004)(5660300002)(66946007); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: TRBOfSjREWDxO0ALjpJR30/IiwOxYo5xSw4Q1TYGOX6XViKWEJLnJIkOc/KLVlddYBzyYM7caIdN6RCHafR1BSKB10dnC6bOMsdMI6dN3PhxgrVggX5P8IYR55ytganIfIDERtoi3WYcsywP2UTh4WRAgC+orBmgNpg80o5iuASRRXkmTukwJulyZCRJuB5QmLDc8Pk7h00Sp3SN//btR/QYMu+AR63FNMgMPjJStyq94gY5GAKsIoRRjEjCcFJG1BhVHi3CbthzyKq9TRFEDqnNTFURbmBHDQ7lIqajxa2ZUJz+7oiEHpxXPKvuOj6drLWQkLg3GDOqJ5KvPCJ06tDfWjnXneMKCJFza3urj9yNeuhJL+4GcbhnuIp15oW9Um5S0j+rI7Dq8VNV9McAmz0cMuQ39s98V1m+9jDImr0uHBuL8Pfkm9K0HyYhNz/lulVzB0Soy9DcUxeAok2f8oeouwVku5+kgF8R5gATGagpsy42dFvxBwOMbg8eziE2jjp7fj3gAzr93/7wQL0VKUBhEjg+WPIUATsJCKGrue7zGdPW27PGdjYigKH2y3qODO/ccK+aaXgz66G9WcV2XGzrdw1TScat9YNjX6UeZmTDTAjc4Ao6GurM9X7w/rP1k0BzBxqZcLzQ1PES83phKA== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 61596645-670a-4c26-4e8d-08d8701d924e X-MS-Exchange-CrossTenant-AuthSource: DB6PR0402MB2760.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Oct 2020 08:45:58.6621 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: WVnBAUJ5IaSD5IphR+NcxPmbXw0ortStUqusZL/j0x+3OIB4PYaqJt0iNHgamjSLU2TX3dyRr1W7Tt9UbLQP3Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0402MB2760 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 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.102.3 at phobos.denx.de X-Virus-Status: Clean Convert plain text documentation to reStructuredText format and add it to Sphinx TOC tree. No essential content change. Signed-off-by: Peng Fan --- doc/board/freescale/index.rst | 1 + .../board/freescale/mx6ul_14x14_evk.rst | 62 ++++++++++++------- 2 files changed, 40 insertions(+), 23 deletions(-) rename board/freescale/mx6ul_14x14_evk/README => doc/board/freescale/mx6ul_14x14_evk.rst (65%) diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst index 716bb1e3ac..046a839a52 100644 --- a/doc/board/freescale/index.rst +++ b/doc/board/freescale/index.rst @@ -16,3 +16,4 @@ Freescale imxrt1050-evk mx6sabreauto mx6sabresd + mx6ul_14x14_evk diff --git a/board/freescale/mx6ul_14x14_evk/README b/doc/board/freescale/mx6ul_14x14_evk.rst similarity index 65% rename from board/freescale/mx6ul_14x14_evk/README rename to doc/board/freescale/mx6ul_14x14_evk.rst index 70eb86efba..8298bf8e1e 100644 --- a/board/freescale/mx6ul_14x14_evk/README +++ b/doc/board/freescale/mx6ul_14x14_evk.rst @@ -1,11 +1,18 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +mx6ul_14x14_evk +=============== + How to use U-Boot on Freescale MX6UL 14x14 EVK ----------------------------------------------- - Build U-Boot for MX6UL 14x14 EVK: -$ make mrproper -$ make mx6ul_14x14_evk_defconfig -$ make +.. code-block:: bash + + $ make mrproper + $ make mx6ul_14x14_evk_defconfig + $ make This will generate the SPL image called SPL and the u-boot.img. @@ -14,35 +21,38 @@ This will generate the SPL image called SPL and the u-boot.img. - Flash the SPL image into the micro SD card: -sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1 conv=notrunc; sync +.. code-block:: bash + + sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1 conv=notrunc; sync - Flash the u-boot.img image into the micro SD card: -sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69 conv=notrunc; sync +.. code-block:: bash -- Jumper settings: + sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69 conv=notrunc; sync -SW601: 0 0 1 0 -Sw602: 1 0 +- Jumper settings:: + + SW601: 0 0 1 0 + Sw602: 1 0 where 0 means bottom position and 1 means top position (from the switch label numbers reference). - Connect the USB cable between the EVK and the PC for the console. -(The USB console connector is the one close the push buttons) + The USB console connector is the one close the push buttons -- Insert the micro SD card in the board, power it up and U-Boot messages should -come up. +- Insert the micro SD card in the board, power it up and U-Boot messages should come up. 2. Booting via Serial Download Protocol (SDP) --------------------------------------------- The mx6ulevk board can boot from USB OTG port using the SDP, target will enter in SDP mode in case an SD Card is not connect or boot switches are -set as below: +set as below:: -Sw602: 0 1 -SW601: x x x x + Sw602: 0 1 + SW601: x x x x The following tools can be used to boot via SDP, for both tools you must connect an USB cable in USB OTG port. @@ -54,13 +64,15 @@ https://github.com/NXPmicro/mfgtools The following script should be created to boot SPL + u-boot-dtb.img binaries: - $ cat uuu_script - uuu_version 1.1.4 +.. code-block:: bash + + $ cat uuu_script + uuu_version 1.1.4 - SDP: boot -f SPL - SDPU: write -f u-boot-dtb.img -addr 0x877fffc0 - SDPU: jump -addr 0x877fffc0 - SDPU: done + SDP: boot -f SPL + SDPU: write -f u-boot-dtb.img -addr 0x877fffc0 + SDPU: jump -addr 0x877fffc0 + SDPU: done Please note that the address above is calculated based on SYS_TEXT_BASE address: @@ -68,7 +80,9 @@ Please note that the address above is calculated based on SYS_TEXT_BASE address: Power on the target and run the following command from U-Boot root directory: - $ sudo ./uuu uuu_script +.. code-block:: bash + + $ sudo ./uuu uuu_script - Method 2: imx usb loader tool (imx_usb): @@ -78,5 +92,7 @@ https://github.com/boundarydevices/imx_usb_loader Build the source code and run the following commands from U-Boot root directory: - $ sudo ./imx_usb SPL - $ sudo ./imx_usb u-boot-dtb.img +.. code-block:: bash + + $ sudo ./imx_usb SPL + $ sudo ./imx_usb u-boot-dtb.img