From patchwork Wed Oct 14 09:12:08 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peng Fan X-Patchwork-Id: 1381914 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=OtDmgWSr; 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 4CB5f74ZXpz9sVJ for ; Wed, 14 Oct 2020 19:47:59 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id E32B282483; Wed, 14 Oct 2020 10:46:07 +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="OtDmgWSr"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 9E1AF82477; Wed, 14 Oct 2020 10:46:02 +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 EUR04-HE1-obe.outbound.protection.outlook.com (mail-he1eur04on060e.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe0d::60e]) (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 227B382478 for ; Wed, 14 Oct 2020 10:45:58 +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=fFKx7i5svbs1otBjYrtaRWe8ETa1o0EMg4vs/a3ik8CO7ZS1uGbz5jumgioERaha+bquBhmu3vmXIgChtHwswp7yMZb78tYPw+EoGVrCz5NqX9OTrGncuh20YcNkIcRfPwuMAydcS0bPKHZpV8/h5moDiRjEd4R2yjWoShO3tXMsjZxtuaU7eE7uCvQ+U8mj2ZV/CL7qiQRaJ13v1yMJvPasHM3LeKnuLCr7w+wBZ4X3Ph/I1TG35o1GqAR1J8f+AVrabXnozo/MK0YsoeR6ndlqeznHw17OCg4SDtGVDNH0jes7ZU/frqDDKtMlCVpP1c50H5mcCaBp0xTq2njHiA== 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=hyLWuoYRHut5xmE7TEx8nb0h7DnwbDFPAy7+K/QGoEE=; b=nXOFP/HVoD0pOmqiv96Dxpy5vgs2GzGfKlVdJ7YFt8exo5IOc1yfta5qyD603Y55omcwSB0VRxLZIvKZPFREScreY3nnSsJQp4cEJS1menIPEgaXvtnwGjtn7h1KSPZHDHiLi3eVbtrJGMmpbC8QppYJcSoqjbYA4ECDdK0Nvjx2JXEJjjtBV0C1FvfHeEoAjqBS+VVjgQXxLlIvXv3xDf0IxjBL5EDzkLL/ziJiV/LWjvIssRDmQ/z5Ui/pmDITPjh2z0RklvaAri/ZoqufuXNzDwCJam/yv0iEyPCosKmuGYFfhj7Sn3R5guMrU9TTZA+UdyeZQe64YODqFoLTAw== 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=hyLWuoYRHut5xmE7TEx8nb0h7DnwbDFPAy7+K/QGoEE=; b=OtDmgWSrMa0ElpbHqXoBJbVRSjvojzWgMUnlyCvfE+KdGE1PZIqGyXEtr1UAWALk/4DOT66Rq7EuSuSKqDWn+cQ5jBoALZIsG3QkG8UynG5lo69IH9bfPeR2CWyBIu2dPew3V5Q335kFGtvoE7zaiCB3EWduusI6FdZ7T96P5Iw= 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 DB7PR04MB5241.eurprd04.prod.outlook.com (2603:10a6:10:1d::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.20; Wed, 14 Oct 2020 08:45:56 +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:56 +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 10/12] doc: board: Convert i.MX6 Sabresd README to reST Date: Wed, 14 Oct 2020 17:12:08 +0800 Message-Id: <20201014091210.12113-11-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:54 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 36ee5967-a961-43f0-ec7d-08d8701d90da X-MS-TrafficTypeDiagnostic: DB7PR04MB5241: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:6790; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: MXT69eyEmkKD+oVu98Pj0gm/fUhEFMgAOT0BltPyn1no2aZ8ETx76YpWJEjVMuxtT5k4JaW/gXJrGHldmLFFbKIJG1KEJIFs4OUW+Z/lef/GXxyRY2rpi6GyiG/vjmqoUsp2mRiFMGfObzbVQcnoKBbwak++NqPJPQMtr0CbhohlG79CENbG/PSZOEY8VT70+ZPVWZ2/MQttbLxr0PW3NGrtWkQpBW+iLm/Bxt6/hl3bb7L1Bq6nuUjk/c5CgsBpkmFJjH0ihi34xnfgAUnMltrAKr9WoxM0d2nFtNd8Nsbz10NVB91mQbCL0xBSGotl9aEM5Wqkn1wadDD2jU/5uA== 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)(39860400002)(396003)(346002)(376002)(136003)(366004)(6512007)(83380400001)(86362001)(8676002)(316002)(8936002)(6666004)(36756003)(2906002)(66556008)(66946007)(66476007)(2616005)(956004)(52116002)(5660300002)(6486002)(4326008)(6506007)(16526019)(26005)(478600001)(44832011)(186003)(1076003); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: EEkkP+vevEnpr+uN+VV0zh57fa0Hg2LrXy6c4Mr1fr90nIIofqNFluc1h28W0h3Say6+1VIF+zoH1lkEiL/GOgnlpnmgiWUf8YcviGGjJZH+VX+m30miIsQ132esfGz1ThO4Zchei2Cf/OLrW0XtGJESxRG0BmpQJSri+u96L3/e2PVnV4jqmgnwcqYoULsva79SeBqVo/570csVZsCcDnlJuhG8tDP45/jyhIzaV13rUMa2SxBvvGfvAZZ7BKk9N2cXyeYZXcGi+EgC0IbOsdtFMIo/pXtV0FpgW07CMBgxuwS558DAn3uGuRuSQ0D49X7hZpMHTMxqQk8yVKepUEvzB2Pvsr3yDQGP8eMKIlCQ+Na4363S4BV0pAHIR97I9rdzgAu46UGoP6Yg5qxP6vXEntC/+iZfZ9muZ3fZV9UiQKQBAu8WUsbBvdLG1/n/n/TCYP9AdFDE+jmgfs1Kznw+wRkoBLrxMyQNLkl4b961N/XnPF1KGGq8YzkQHS59xsgGsEUQLICa4XGGiEUi2tAdJaGuxJwu2QvvO4htX3EDToAxNvqwjdWH4PZyokqtmHWATM5dJnvLGJPZPltplLtZyTzTaJZo73WosNdEogpsJXVYCZkSXJiduw3WChz+7zux1TQ5si1fFLnoXptSfQ== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 36ee5967-a961-43f0-ec7d-08d8701d90da 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:56.3482 (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: ZBnQDp04YuHrZbWtV+HGdM1Baw0+2LEw2blgDcjxcgvros4pmS+4CL5vOvxU8A8kKO/l6ZY6f5Cc8rlGlY57mA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR04MB5241 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 --- board/freescale/mx6sabresd/README | 114 ------------------------- doc/board/freescale/index.rst | 1 + doc/board/freescale/mx6sabresd.rst | 132 +++++++++++++++++++++++++++++ 3 files changed, 133 insertions(+), 114 deletions(-) delete mode 100644 board/freescale/mx6sabresd/README create mode 100644 doc/board/freescale/mx6sabresd.rst diff --git a/board/freescale/mx6sabresd/README b/board/freescale/mx6sabresd/README deleted file mode 100644 index 974b0be175..0000000000 --- a/board/freescale/mx6sabresd/README +++ /dev/null @@ -1,114 +0,0 @@ -How to use and build U-Boot on mx6sabresd ------------------------------------------ - -The following methods can be used for booting mx6sabresd boards: - -1. Booting from SD card - -2. Booting from eMMC - -3. Booting via Falcon mode (SPL launches the kernel directly) - - -1. Booting from SD card via SPL -------------------------------- - -mx6sabresd_defconfig target supports mx6q/mx6dl/mx6qp sabresd variants. - -In order to build it: - -$ make mx6sabresd_defconfig - -$ make - -This will generate the SPL and u-boot-dtb.img binaries. - -- Flash the SPL binary into the SD card: - -$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync - -- Flash the u-boot-dtb.img binary into the SD card: - -$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync - - -2. Booting from eMMC --------------------- - -$ make mx6sabresd_defconfig - -$ make - -This will generate the SPL and u-boot-dtb.img binaries. - -- Boot first from SD card as shown in the previous section - -In U-boot change the eMMC partition config: - -=> mmc partconf 2 1 0 0 - -Mount the eMMC in the host PC: - -=> ums 0 mmc 2 - -- Flash SPL and u-boot-dtb.img binaries into the eMMC: - -$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync -$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync - -Set SW6 to eMMC 8-bit boot: 11010110 - - -3. Booting via Falcon mode --------------------------- - -$ make mx6sabresd_defconfig -$ make - -This will generate the SPL image called SPL and the u-boot-dtb.img. - -- Flash the SPL image into the SD card: - -$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync - -- Flash the u-boot-dtb.img image into the SD card: - -$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync - -Create a partition for root file system and extract it there: - -$ sudo tar xvf rootfs.tar.gz -C /media/root - -The SD card must have enough space for raw "args" and "kernel". -To configure Falcon mode for the first time, on U-Boot do the following commands: - -- Setup the IP server: - -# setenv serverip - -- Download dtb file: - -# dhcp ${fdt_addr} imx6q-sabresd.dtb - -- Download kernel image: - -# dhcp ${loadaddr} uImage - -- Write kernel at 2MB offset: - -# mmc write ${loadaddr} 0x1000 0x4000 - -- Setup kernel bootargs: - -# setenv bootargs "console=ttymxc0,115200 root=/dev/mmcblk1p1 rootfstype=ext4 rootwait quiet rw" - -- Prepare args: - -# spl export fdt ${loadaddr} - ${fdt_addr} - -- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors) - -# mmc write 18000000 0x800 0x800 - -- Press KEY_VOL_UP key, power up the board and then SPL binary will -launch the kernel directly. diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst index cc079cadce..716bb1e3ac 100644 --- a/doc/board/freescale/index.rst +++ b/doc/board/freescale/index.rst @@ -15,3 +15,4 @@ Freescale imxrt1020-evk imxrt1050-evk mx6sabreauto + mx6sabresd diff --git a/doc/board/freescale/mx6sabresd.rst b/doc/board/freescale/mx6sabresd.rst new file mode 100644 index 0000000000..fe15ba7b79 --- /dev/null +++ b/doc/board/freescale/mx6sabresd.rst @@ -0,0 +1,132 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +mx6sabresd +========== + +How to use and build U-Boot on mx6sabresd +----------------------------------------- + +The following methods can be used for booting mx6sabresd boards: + +1. Booting from SD card + +2. Booting from eMMC + +3. Booting via Falcon mode (SPL launches the kernel directly) + + +1. Booting from SD card via SPL +------------------------------- + +mx6sabresd_defconfig target supports mx6q/mx6dl/mx6qp sabresd variants. + +In order to build it: + +.. code-block:: bash + + $ make mx6sabresd_defconfig + $ make + +This will generate the SPL and u-boot-dtb.img binaries. + +- Flash the SPL binary into the SD card: + +.. code-block:: bash + + $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync + +- Flash the u-boot-dtb.img binary into the SD card: + +.. code-block:: bash + + $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync + +2. Booting from eMMC +-------------------- + +.. code-block:: bash + + $ make mx6sabresd_defconfig + $ make + +This will generate the SPL and u-boot-dtb.img binaries. + +- Boot first from SD card as shown in the previous section + +In U-boot change the eMMC partition config:: + + => mmc partconf 2 1 0 0 + +Mount the eMMC in the host PC:: + + => ums 0 mmc 2 + +- Flash SPL and u-boot-dtb.img binaries into the eMMC: + +.. code-block:: bash + + $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync + $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync + +Set SW6 to eMMC 8-bit boot: 11010110 + +3. Booting via Falcon mode +-------------------------- + +.. code-block:: bash + + $ make mx6sabresd_defconfig + $ make + +This will generate the SPL image called SPL and the u-boot-dtb.img. + +- Flash the SPL image into the SD card + +.. code-block:: bash + + $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync + +- Flash the u-boot-dtb.img image into the SD card + +.. code-block:: bash + + $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync + +Create a partition for root file system and extract it there + +.. code-block:: bash + + $ sudo tar xvf rootfs.tar.gz -C /media/root + +The SD card must have enough space for raw "args" and "kernel". +To configure Falcon mode for the first time, on U-Boot do the following commands: + +- Setup the IP server:: + + # setenv serverip + +- Download dtb file:: + + # dhcp ${fdt_addr} imx6q-sabresd.dtb + +- Download kernel image:: + + # dhcp ${loadaddr} uImage + +- Write kernel at 2MB offset:: + + # mmc write ${loadaddr} 0x1000 0x4000 + +- Setup kernel bootargs:: + + # setenv bootargs "console=ttymxc0,115200 root=/dev/mmcblk1p1 rootfstype=ext4 rootwait quiet rw" + +- Prepare args:: + + # spl export fdt ${loadaddr} - ${fdt_addr} + +- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors):: + + # mmc write 18000000 0x800 0x800 + +- Press KEY_VOL_UP key, power up the board and then SPL binary will launch the kernel directly.