From patchwork Wed Oct 14 09:12:02 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peng Fan X-Patchwork-Id: 1381907 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=hfDNeoTW; 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 4CB5cY38lnz9sVR for ; Wed, 14 Oct 2020 19:46:37 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id A203082406; Wed, 14 Oct 2020 10:45:47 +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="hfDNeoTW"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id A6F7282431; Wed, 14 Oct 2020 10:45:44 +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-ve1eur01on0608.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe1f::608]) (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 C5ADA82410 for ; Wed, 14 Oct 2020 10:45:41 +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=IiZCeo7VCDUP+QRB0HkKrHBa0MZUgL5dAJiqVjgFUk8GYbBbSRdNeTjuO+ElYH5OVpoIuD1/Vq92cB8j5e7My/wEBVOM8Y2W5oufsA4oAHPJ4L9F6/y+tae0AT9Vcf9Tn9JZAVq4qRUXDZZbzieVq0nV8chF32iptNLJoKS8/cFj6Qley6u6HBqw2veimBzqhvyr8m261rLbmO/9QgRaIEdzUZI7L6bSqobqzLhT33HcwnfDHnJBfdXoOnVTy9/SWSjd+5PMI5pcaSEUT3j9oiwrNkIqqg/EaKFygaL4BC5mBogCcbpm+CubGUwM7rVGHywtJBXkmbh/O6mJUx0J7g== 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=Ij20q2cYg+sUwlka83tBlxib7fGWhz7PVIUSckUfHyc=; b=JuJRLdrwRg4edH7WcQvNSYJoZHxlYx7JFCfjMsUBMGNK2Fryxq3kvjRKaw+XAGqxxrEkYWqhnpJC/6XnndypHiwuG5oR11PC9+yLsMGURr0IfA2RMU16hfKbazA8DpPP4thYlmsZnNkazFR8atOD3sc/Vk3jyOfhVCeIoIqU7R1UtqjshW1Qj4rQQPWw+FRkLWVtR5xhU6iReC+yXRCT+jjGVwBz8U29/eHydqtDZaFXZbm0li2VsphByB6yGatmH8n+V63gZM9SSe/rHfnrRRhjvMnHzRDFHerzD6cSMQ+F2HlRwSqZAx/ef4BNzvppiei9lrjMRrfYvjP/7PmZnQ== 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=Ij20q2cYg+sUwlka83tBlxib7fGWhz7PVIUSckUfHyc=; b=hfDNeoTW4yj15ztri7tVvKi7H9LUpgjuQAHNug5FvDyKxLN+BTyExMnVMzLgufZh5jqs9+JcdKi1Q1SMMG1dC/i87PR1xsmByvHR4uWCpe5c37/7+a7a+Z3+1qiT6GGIzjsvCHdnmrr8le106HE12WhsG9HYeQ6u/5vmXQlg/x0= 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:40 +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:40 +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 04/12] doc: board: Convert i.MX8MM EVK README to reST Date: Wed, 14 Oct 2020 17:12:02 +0800 Message-Id: <20201014091210.12113-5-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:37 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: c601048b-a175-475f-bd70-08d8701d8768 X-MS-TrafficTypeDiagnostic: DB6PR0402MB2760: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:1107; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 3a6CDLmX/NPYn2Og622f3Pr0d0BdYmv7FmdLn8q9xxREcMd291W8mK3p3+bIP/mEFSGU+jdMQ7LCVzRqo2s+AIYBCpE6OEN9KCPdg0WO4cQFWf/WeOZtoANG3W1xmMz5HzEbuGcOrCwy0Eul47kWhLdm3i8je/VGPtuAGs/tHMHNvrjTGhdHeepiJA7lhauP7Z5LFBbnuHwHwnX4d5kqL9zeQsdpcpY49KQ0n1Kkr5EDzHiOiIAj0Mb9haQcVKC80CW8zsJVNABa6KcbiVnw3z5LQ0ltj1aF+Pn5TUJNMXeMckYRBtflTweGKc+z1P+BWmVtzM+uji+yZQBd0Ed2iopnPNn61l/CnInShP8Uc71VIjb1aAEIGL29VpNH2hxxbg2W0feLV9pg4sJ2nxHfnQ== 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: laoIALCRMOXtugCSxrHsfG6YZ++JpSc4/A2KZexyYceRN9ax+OWjM6uh2HM+BzVsQCsi0JWNAWQpMezpaHmOVd+wVUrbHYk9pbvGETuhyiqrgi7SpAhAEGuQOTmC+y2SZyIEWy0+qU4fdqsgHP+nT9RVGXqUc9chnBWg7i4JqpH5n1Ua+nsmEpJlk9aTz452oKjBX+lSkwdRNPZQmqcd90VoLBb3ho4bnlKN+iPh9kGdXHufTu40YISQ2O3DeP5Nmfriy6qVdUEz8EAQwgYW2Gb8J6QhzDp4FaUVvCueYdDPfhCl1gOpuhHCNrRUp1uyyifPXMa65YitSCHU3PRVhfsQFril/39xQSsnfh+rXuEpVDEpWmULNS0dx3P3Q+0hz60w/7RP7XTYkq5m3NOsWJd/DaVhaz3+TnSGEPefQ6fYmHhNi/sIy9UMfbihwMsvepHiN2auxUJp4rE8BJfFftqwXBYu4mFeQWu9jOc5dUue2K8vcKAIHKT49lwd7HuRFs0CRnYq7OamLYiYDvllMP7Le/ltLO/59uyAuU6C+dAmfTj1CZRDrkQrdtAVGJmEGL8On6kmXKsAZU0PN1IqNq2iZPHkRC9w5T1zfK9P92VxaLyT9Keg3+h7Fq0opzw776oH4UoNvbVDBoSYcOWQow== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: c601048b-a175-475f-bd70-08d8701d8768 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:40.3684 (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: UKqOWdDcaekee9xcxxJJ7fVZVXH3cFrmjVOo7Z9dsjcT8vd37ncJFV2HUPS6MO9sdZjDQBagQ+7HcUSBhiAQ+Q== 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 --- board/freescale/imx8mm_evk/README | 37 -------------------- doc/board/freescale/imx8mm_evk.rst | 56 ++++++++++++++++++++++++++++++ doc/board/freescale/index.rst | 1 + 3 files changed, 57 insertions(+), 37 deletions(-) delete mode 100644 board/freescale/imx8mm_evk/README create mode 100644 doc/board/freescale/imx8mm_evk.rst diff --git a/board/freescale/imx8mm_evk/README b/board/freescale/imx8mm_evk/README deleted file mode 100644 index 3307711d5d..0000000000 --- a/board/freescale/imx8mm_evk/README +++ /dev/null @@ -1,37 +0,0 @@ -U-Boot for the NXP i.MX8MM EVK board - -Quick Start -=========== -- Build the ARM Trusted firmware binary -- Get ddr firmware -- Build U-Boot -- Boot - -Get and Build the ARM Trusted firmware -====================================== -Note: builddir is U-Boot build directory (source directory for in-tree builds) -Get ATF from: https://source.codeaurora.org/external/imx/imx-atf -branch: imx_4.19.35_1.0.0 -$ make PLAT=imx8mm bl31 -$ cp build/imx8mm/release/bl31.bin $(builddir) - -Get the ddr firmware -============================= -$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.0.bin -$ chmod +x firmware-imx-8.0.bin -$ ./firmware-imx-8.0 -$ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir) - -Build U-Boot -============ -$ export CROSS_COMPILE=aarch64-poky-linux- -$ make imx8mm_evk_defconfig -$ export ATF_LOAD_ADDR=0x920000 -$ make flash.bin - -Burn the flash.bin to MicroSD card offset 33KB -$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc - -Boot -==== -Set Boot switch to SD boot diff --git a/doc/board/freescale/imx8mm_evk.rst b/doc/board/freescale/imx8mm_evk.rst new file mode 100644 index 0000000000..f75190227c --- /dev/null +++ b/doc/board/freescale/imx8mm_evk.rst @@ -0,0 +1,56 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +imx8mm_evk +========== + +U-Boot for the NXP i.MX8MM EVK board + +Quick Start +----------- + +- Build the ARM Trusted firmware binary +- Get ddr firmware +- Build U-Boot +- Boot + +Get and Build the ARM Trusted firmware +-------------------------------------- + +Note: builddir is U-Boot build directory (source directory for in-tree builds) +Get ATF from: https://source.codeaurora.org/external/imx/imx-atf +branch: imx_4.19.35_1.0.0 + +.. code-block:: bash + + $ make PLAT=imx8mm bl31 + $ cp build/imx8mm/release/bl31.bin $(builddir) + +Get the ddr firmware +-------------------- + +.. code-block:: bash + + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.0.bin + $ chmod +x firmware-imx-8.0.bin + $ ./firmware-imx-8.0 + $ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir) + +Build U-Boot +------------ + +.. code-block:: bash + + $ export CROSS_COMPILE=aarch64-poky-linux- + $ make imx8mm_evk_defconfig + $ export ATF_LOAD_ADDR=0x920000 + $ make flash.bin + +Burn the flash.bin to MicroSD card offset 33KB: + +.. code-block:: bash + + $sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc + +Boot +---- +Set Boot switch to SD boot diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst index 77b6802098..33b1be95f5 100644 --- a/doc/board/freescale/index.rst +++ b/doc/board/freescale/index.rst @@ -7,5 +7,6 @@ Freescale :maxdepth: 2 b4860qds + imx8mm_evk imx8mn_evk imx8mp_evk