From patchwork Wed Oct 14 09:12:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peng Fan X-Patchwork-Id: 317741 Delivered-To: patch@linaro.org Received: by 2002:a92:d603:0:0:0:0:0 with SMTP id w3csp215001ilm; Wed, 14 Oct 2020 01:47:37 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwIN8N4rN5mjSE1E9DawmYoviIaH6MMdJJvoauo2MHnwO9OYGgqO0pE+YnkMoecXfaaYZ3S X-Received: by 2002:a05:6402:31b3:: with SMTP id dj19mr4135622edb.210.1602665257542; Wed, 14 Oct 2020 01:47:37 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1602665257; cv=pass; d=google.com; s=arc-20160816; b=AMCS3L14XZjqlhHRaFyzEqa7UMwmMwvm9Ts4zJKgf3y7kMtWTX1N6MnfkM0rx0EAym kVgwlF877GrBO6gO2Pmkl7rFukALdL4Efk8OR9LfHM/xTjZRj8j+W14fdBblhfjglNNB PUPTM0R1DuO2U6j9ZdR1iBeOY82PnGYSFmMaXJl4H8IFRYSBxGzra4DPMcLVmY5EjkQG uNQ+lhH6UlEEm7E2bIDk+LnRXdWiIgIA5jUKnsf2AQVA0zNisCcKf3ADIgmzMIZ6B3pn XgODe8Hi2JMHaLReQx/oMueaQtS3Xtg6Ch0/ACWRSbT5bN/Wt/X99YqrGhsPII8g59+B w+jw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:mime-version :content-transfer-encoding:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature; bh=3VV3dhhJP95nXxpY1QF6t4L49jxq8j5cD0OOI5r2Dis=; b=Jl6bX6pRL+1DUFU7ISXiF66joAvFx07YxFBDHK1e+TnGR0SelK8oPyXRPe2dA6o9pC 4ce4J4lqdojpaAM7T+++RRvvQ7jod3UlS7V1YazbH6V3RjMh+2HcMddelhhzlhurpSth L/l5BrSJ6SXhCYF7t5g9oitXhqViCzojeZQ0MizhO4CcbHLSF2prkZXlsZAoGc3XAm1p UD6ed9omSqxdNHJ6xgnv7JlPRWvRHZSZI+RtI+lEvnP5tAVe+b1/mR2Yap7nNjaACMAu iGmUnXYzuLh59e3j5cOPqTeLnxYsOnW6Ao/dlk3hMrp6jGb53Ghhp5VpHiM2w8C53gze /CbA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=GMbl+jqd; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from phobos.denx.de (phobos.denx.de. [85.214.62.61]) by mx.google.com with ESMTPS id 65si1680397edc.222.2020.10.14.01.47.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 14 Oct 2020 01:47:37 -0700 (PDT) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 as permitted sender) client-ip=85.214.62.61; Authentication-Results: mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=GMbl+jqd; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 85.214.62.61 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id BE6DC82475; Wed, 14 Oct 2020 10:46:00 +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="GMbl+jqd"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id E70A582475; Wed, 14 Oct 2020 10:45:58 +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 EUR03-DB5-obe.outbound.protection.outlook.com (mail-db5eur03on0627.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe0a::627]) (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 EF91882465 for ; Wed, 14 Oct 2020 10:45:55 +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=Owji0rv/UtFd+dX50Ux9Y9oKNgqS8GhHurZngR3EsHWp5sg0KZvMx4zA47XC0MscPf/eEGglRV4lk7gNrEaHvcpumFZ8t2u9jPkI85C1GCkUiv4VDTLUIM7I+epm6aUPCDr9EvUNfDFxU9kxWq5gYKPQOw9ewueaT3yrtV5jRDaNnFMujl3ntGOdjCJe5uYyxVyi0l0O4WWlpGSAhrB4QuzGl39qJZCCdDGEGIPhl24jEdyZOUlYvF7WkuV0WoGSbPUch34g2tZ3VjqJsCKrL31ElWiI577XFt5yrC1vvNHuaa1KTa3RV8Ua9N7DMTSD2wWag6n5eOsr1/L35D5k2Q== 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=3VV3dhhJP95nXxpY1QF6t4L49jxq8j5cD0OOI5r2Dis=; b=cE3si3NRujfD+3kh9PSSzMRSt7jA8OBjMK0AfugLYjYFw+dPtIttgf+Lelz6WgmqIK8PJnIwflIDC5pXrEXGYOltEjpb4SZ1K862Q71Zlnig9ndthVl9JlJL9hNfA0FqRYE1MpmPxyMpqkmJK5sO32jpTMgdG25JBx6GPdsnEkzlvd61E+sxvE+HlIYIrYBMPlTZakdP4dXNX+9MN9XqCt6t+uWGlERV/6s7b80rwFZCjKLy8zwPSdaebECp7YDQxbMXpXop9t42KtP2v8B0phVk73Mx0kICqHn3JQQKiZSxcZ70G5OrXQe3O/EhZKVVaolfNY382oVLBOhJHuh26Q== 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=3VV3dhhJP95nXxpY1QF6t4L49jxq8j5cD0OOI5r2Dis=; b=GMbl+jqdfzJdzuimarfWbHmn/FxsDx3aTl9D9G+2fclo6hz9IfEyIuqWbCSklFDvkXxfZtjUTcPDzUBweiJpC4FCT70mhkyzPRsdsvwywsl2V86Uf+25yGyKZCl0Jg/I380L3haPD7Ym8wGk9ZOMT9Xtc59OxpmloM9i07MHsRQ= 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:53 +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:53 +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 09/12] doc: board: Convert i.MX6 Sabreauto README to reST Date: Wed, 14 Oct 2020 17:12:07 +0800 Message-Id: <20201014091210.12113-10-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:51 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: c95fc864-7cde-4a1a-5ba5-08d8701d8f50 X-MS-TrafficTypeDiagnostic: DB7PR04MB5241: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7691; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: vphTXO2qKnM3v96j7mLHi2/cgo6zaNkgGWfRQV67INF8wQdEfsruwKYmIEzk+IsYiGCIGk+tx0og5eFoL4q+wOMS6w/9YgDTNSc/M2K1h8QY8DXCTB3VRkKSLrcIW0JtfoVIoHNsyeqyyqUecXhnUwchIA2mGF+MbT5pF1r3RanJ35vCiTbCTATWCVy6dQ2P1DwyB7S8wRkilmnUfx8te+wB93R3MYY/wTz8Id0Vo3Amlyi2PnhCowBmBbM/VfGXq2zw0qh5g2E93x+p2vMpPAJFohiLM8Jy5fRjHRRp2pOeGl1wxMELf/dngBeZpFhOyc5O9jbxrD4u/7BUmAf0Rw== 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: P9T6Yo3aG3RSpQVYaOVkQs0HNdk+xWresneTyQnw5hFoEm+XMygAWRZ+WWAmCqHnH8fRKbE+B+LU86UJDUIrm8BkMu+YpVnRvqPkJMx1291iyivKJaTrC55SWRAxfjFsupftL4WLbCKJcGz6EO9mn6AkvnSaBVsl/+tL1trdb/SrVS814evmA8fWCg8/+tESyV/gt6Qz+sdNEh5gEDTUkcSGrFWcjedsYRyIn4fQ/dPch2Vt/++CeMlAtDad9JzZvRyr1SRyVfQLcUZedVDjzkjdkoH07jBIzXw0ZPOZZzYRbIB1DwbZMTcK7TJxWDznuI+qFstLTrqaLgaRzSHNKuErr3qIY0oXwMiuea7iw0s6Z2JnoGjAXoTY7N7+dZFZWxRqXVAvCfrMqly7X1/HD1MpU8DKDP3BBAb6paHetYMwmhzyLkwbdrPEhTNuUji3xPWbps+U1cTkyt40m5e77N3SfgVt0l2slqio6KwTr8H+HJT181LVcMZ0O8KaAEZoYNLb/bjWVIiNKoA6PSQ3yRCsb7C+6sy+wZ3rJPczVW+sbX0R2wc8QHxjj1ShXs22hvF6xIipYcqTkkdrXZNcRiq+aMpFzCG30xSPP0xLkaSaDPu2MONqfazEbdLxC2kCDmPva0rrqEn07/MdTsKC4g== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: c95fc864-7cde-4a1a-5ba5-08d8701d8f50 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:53.7983 (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: GVLCe9SN/WYRilcK+3wx/AQxNmHjT06GcHXvhSq6G0VpqiGtlKFD5BfOCKgu8sIBvEnao6GY5pWqCIHfyHbzyA== 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/mx6sabreauto/README | 82 ---------------------- doc/board/freescale/index.rst | 1 + doc/board/freescale/mx6sabreauto.rst | 100 +++++++++++++++++++++++++++ 3 files changed, 101 insertions(+), 82 deletions(-) delete mode 100644 board/freescale/mx6sabreauto/README create mode 100644 doc/board/freescale/mx6sabreauto.rst -- 2.28.0 diff --git a/board/freescale/mx6sabreauto/README b/board/freescale/mx6sabreauto/README deleted file mode 100644 index 710026a05e..0000000000 --- a/board/freescale/mx6sabreauto/README +++ /dev/null @@ -1,82 +0,0 @@ -How to use and build U-Boot on mx6sabreauto -------------------------------------------- - -mx6sabreauto_defconfig target supports mx6q/mx6dl/mx6qp sabreauto variants. - -In order to build it: - -$ make mx6sabreauto_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 - -Booting via Falcon mode ------------------------ - -Write in mx6sabreauto_defconfig the following define below: - -CONFIG_SPL_OS_BOOT=y - -In order to build it: - -$ make mx6sabreauto_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/sdb bs=1K seek=1 conv=notrunc && sync - -- Flash the u-boot-dtb.img image into the SD card: - -$ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 conv=notrunc && sync - -Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there: - -$ sudo cp uImage /media/boot - -$ sudo cp imx6dl-sabreauto.dtb /media/boot - -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: - -- Load dtb file from boot partition: - -# load mmc 0:1 ${fdt_addr} imx6dl-sabreauto.dtb - -- Load kernel image from boot partition: - -# load mmc 0:1 ${loadaddr} uImage - -- Write kernel at 2MB offset: - -# mmc write ${loadaddr} 0x1000 0x4000 - -- Setup kernel bootargs: - -# setenv bootargs "console=ttymxc3,115200 root=/dev/mmcblk0p1 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 - -- Restart 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 c9d7411875..cc079cadce 100644 --- a/doc/board/freescale/index.rst +++ b/doc/board/freescale/index.rst @@ -14,3 +14,4 @@ Freescale imx8qxp_mek imxrt1020-evk imxrt1050-evk + mx6sabreauto diff --git a/doc/board/freescale/mx6sabreauto.rst b/doc/board/freescale/mx6sabreauto.rst new file mode 100644 index 0000000000..fe4cd9d214 --- /dev/null +++ b/doc/board/freescale/mx6sabreauto.rst @@ -0,0 +1,100 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +mx6sabreauto +============ + +How to use and build U-Boot on mx6sabreauto +------------------------------------------- + +mx6sabreauto_defconfig target supports mx6q/mx6dl/mx6qp sabreauto variants. + +In order to build it: + +.. code-block:: bash + + $ make mx6sabreauto_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 + +Booting via Falcon mode +----------------------- + +Write in mx6sabreauto_defconfig the following define below: + +CONFIG_SPL_OS_BOOT=y + +In order to build it: + +.. code-block:: bash + + $ make mx6sabreauto_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/sdb bs=1K seek=1 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/sdb bs=1K seek=69 conv=notrunc && sync + +Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there: + +.. code-block:: bash + + $ sudo cp uImage /media/boot + $ sudo cp imx6dl-sabreauto.dtb /media/boot + +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: + +- Load dtb file from boot partition:: + + # load mmc 0:1 ${fdt_addr} imx6dl-sabreauto.dtb + +- Load kernel image from boot partition:: + + # load mmc 0:1 ${loadaddr} uImage + +- Write kernel at 2MB offset:: + + # mmc write ${loadaddr} 0x1000 0x4000 + +- Setup kernel bootargs:: + + # setenv bootargs "console=ttymxc3,115200 root=/dev/mmcblk0p1 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 + +- Restart the board and then SPL binary will launch the kernel directly.