From patchwork Wed Oct 14 09:12:00 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peng Fan X-Patchwork-Id: 1381905 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=2a01:238:438b:c500:173d:9f52:ddab:ee01; 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=X/iAWLjq; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01]) (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 4CB5bp41gPz9sVJ for ; Wed, 14 Oct 2020 19:45:58 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 7039482428; Wed, 14 Oct 2020 10:45:40 +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="X/iAWLjq"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id DF16F823E0; Wed, 14 Oct 2020 10:45:38 +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 EUR05-DB8-obe.outbound.protection.outlook.com (mail-db8eur05on20600.outbound.protection.outlook.com [IPv6:2a01:111:f400:7e1a::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 B4392823E0 for ; Wed, 14 Oct 2020 10:45:35 +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=H2VVX+Kythm+LNu/RkCxQySAN3nA2Y/AN0+Lyy1ycnvMcj7xIoL2T0sfikfCjVTGLqhF2Qsnkg03yI8OhbBncvAl/ZiOtcijZ20JBm6ejtJPgB9KpKOub6/ARPkCbCNBt0nVsnl2Cavndv9xIoUVcKFrakoitUV93LcsylXY4pployUo4w1UikqcE94wPZY1qlpowHp9pu5ZOkAe12msJt5EWrATLk0VfnDUqO8tjD6knhRiAxv2MzcjP5Vtm1KFXExsjDlsU4NW5sDAbE70fngn3VJOL5BUJ81ggAbLwaY/aKmMrqrYzFYYgnf8NvvxMqzkiWNANiRpJsxFwVEWSg== 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=MUcaTlT9KUKYjznVPSmMF3WyAuzQT6L1ou1zd1111n4=; b=Xq10XiPFnTdqBPsG74/3IArA3FMaIJD1Sv0akBqpTP/yIlZwSelXN0eWS8epUGmSvoUHH2ezCHPmhAOE21cKVwP9U+TmcAaZi7XAr31HSMakVe/Enr4DjTUSX9swNeZ2cdxqv/EDR/fEyJ9szcNT/kNg1F683Rt1W1CCK/aQ5sCoMSZOATAeIpM6GK7LDYmZUyJxRRZDMQA3VaQoA4xuU5u/ZCqqaWK6/Ng/W9fAntFfs3vYXAbplih5tEuayWgSJNnfSf2ULtE/oEbYKdhmv1aHkbtGm/WXPWa8cSKsbFNjKOLnR4QHC3X6DAidnCDB9uLEKRNl18NaEDHv0MLOCw== 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=MUcaTlT9KUKYjznVPSmMF3WyAuzQT6L1ou1zd1111n4=; b=X/iAWLjqDI20iK/aNhgfuMVy9GR9dEC6zfq7Hhcgwj1WMOZ1jgiCCVLz3LROz5+tmqdqQYwooIQx+AWjqwRrxYlBzyo8dLdd0I3Uoe8CEQdMYO0mnjrFb4w2RLAIcXd9GndjDY2oDnXdYkMwzwGaJA6uqMxwzOu3Om0w9Z7XPmg= 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:34 +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:34 +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 02/12] doc: board: Convert i.MX8MP EVK README to reST Date: Wed, 14 Oct 2020 17:12:00 +0800 Message-Id: <20201014091210.12113-3-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:32 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 8a13276d-b14a-42b9-0958-08d8701d83ca X-MS-TrafficTypeDiagnostic: DB6PR0402MB2760: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:1775; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 2yPZIKidnqGHegviNb5EGlxBIF/dRdKUi6/mYEpgTEcHoKZPPkG1nvGk0818LohwwYj+74l9ZrgydoPSkjDGKEvIgA+c3DQghpkxyWiMnW053jLssm7JCkh7XE7SnOkKNfYXK3vW9kqPtK5Ew+cRgdKNl/D97p6esoS5v1EnBrKhyXysyCVClhaAM8K+nrD1GS/1awCqIovRv0vea2JvO2DUEO9N5Z2uYEVIYl9rmOzTOMDlCqjV+XQylmQMiRLobiIruA0crFtr+HQkM8TzSlCWf3PfFJTV6K54BF/WVauL/LBCixZGj/zybfxSu6ppN0wZ0f/ieRShGLa/+hbwoFbs6VTi5QSl70RKlbqrEH+slDXolTaxUQC7lC4vgdHl2ov0yUpVDLQKC+JO1Lb0hw== 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: CmHATwkl3FftQ2y4/nyYew0nRr8CIl0H486vbfMhqqgYo1eIMiEeqVjcabJfI31DMr2xUqxGTYPgbnFK/ekAMpGHKt82AcFNiaZvabs9f+gM+bhlmxDotFGsBvwTYLWZ6Tro25XwB1MJLtomTUK4OAgdYHcikdMvDXBQvXc3Kh/dg70rp4qNEJXfw0WBKtxlUu5UBCqISme9hHRToMT1xg7H2k+YZXRpp74sJrFQ6bWipTnj0exE8SbFLD4v4ATVvIrdcVhcmxPKoaKt7ZgxdqjRX/vSV0U/oB1vi9AVHQacrkxoVw/UPwtlxtZhnz33xC+3npCKhzWL1XPtLAgR02gjrhfDSST1ihVPxZulctxo6dTOT4h6s7J45kqjNy5WqLs/oUwnCtxLaS6ahfqUXkfWxGwq/t+qHKYu0VijlPBvGygJu22587S3xL924FdbRTyGvrYNOeY3IezfTbpxQDJIC0q4QIDJAr+hUzIge64Ndp2ByEPGWVLGVK/XB0kHFSLb4CkEjQWnEALP9BSAr7YQ70irKQ0bbXmTQfu+21ZOK1c9qHjFnQWUqzeealkBS/pJovxrnvIACQYaLs+1U6ZRw+IluyAWqltN+5jfPjaX9bu9Hs0NmqM7WqL/VjsRdGbN3/DUWJ7NSY9oieoRjQ== X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8a13276d-b14a-42b9-0958-08d8701d83ca 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:34.3092 (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: coqcp0Eilo8nrZcTpKphSHtPCrkEsck/B13Ajq/RzgrU3Sr07nNewCs32B06Xqz4DW7/NTt2yLiAE55/v6GH/g== 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/imx8mp_evk/README | 41 -------------------- doc/board/freescale/imx8mp_evk.rst | 61 ++++++++++++++++++++++++++++++ doc/board/freescale/index.rst | 1 + 3 files changed, 62 insertions(+), 41 deletions(-) delete mode 100644 board/freescale/imx8mp_evk/README create mode 100644 doc/board/freescale/imx8mp_evk.rst diff --git a/board/freescale/imx8mp_evk/README b/board/freescale/imx8mp_evk/README deleted file mode 100644 index 3c64979be9..0000000000 --- a/board/freescale/imx8mp_evk/README +++ /dev/null @@ -1,41 +0,0 @@ -U-Boot for the NXP i.MX8MP EVK board - -Quick Start -=========== -- Build the ARM Trusted firmware binary -- Get the firmware-imx package -- Build U-Boot -- Boot - -Get and Build the ARM Trusted firmware -====================================== -Note: $(srctree) is the U-Boot source directory -Get ATF from: https://source.codeaurora.org/external/imx/imx-atf -branch: imx_5.4.3_2.0.0 -$ make PLAT=imx8mp bl31 -$ sudo cp build/imx8mp/release/bl31.bin $(srctree) - -Get the ddr firmware -==================== -$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin -$ chmod +x firmware-imx-8.7.bin -$ ./firmware-imx-8.7 -$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin -$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin -$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin -$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin - -Build U-Boot -============ -$ export CROSS_COMPILE=aarch64-poky-linux- -$ make imx8mp_evk_defconfig -$ export ATF_LOAD_ADDR=0x960000 -$ make flash.bin - -Burn the flash.bin to the MicroSD card at offset 32KB -$sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync - -Boot -==== -Set Boot switch to SD boot -Use /dev/ttyUSB2 for U-Boot console diff --git a/doc/board/freescale/imx8mp_evk.rst b/doc/board/freescale/imx8mp_evk.rst new file mode 100644 index 0000000000..b34742e33e --- /dev/null +++ b/doc/board/freescale/imx8mp_evk.rst @@ -0,0 +1,61 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +imx8mp_evk +========== + +U-Boot for the NXP i.MX8MP EVK board + +Quick Start +----------- + +- Build the ARM Trusted firmware binary +- Get the firmware-imx package +- Build U-Boot +- Boot + +Get and Build the ARM Trusted firmware +-------------------------------------- + +Note: $(srctree) is the U-Boot source directory +Get ATF from: https://source.codeaurora.org/external/imx/imx-atf +branch: imx_5.4.3_2.0.0 + +.. code-block:: bash + + $ make PLAT=imx8mp bl31 + $ sudo cp build/imx8mp/release/bl31.bin $(srctree) + +Get the ddr firmware +-------------------- + +.. code-block:: bash + + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin + $ chmod +x firmware-imx-8.7.bin + $ ./firmware-imx-8.7 + $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin + $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin + $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin + $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin + +Build U-Boot +------------ + +.. code-block:: bash + + $ export CROSS_COMPILE=aarch64-poky-linux- + $ make imx8mp_evk_defconfig + $ export ATF_LOAD_ADDR=0x960000 + $ make flash.bin + +Burn the flash.bin to the MicroSD card at offset 32KB: + +.. code-block:: bash + + $sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync + +Boot +---- + +Set Boot switch to SD boot +Use /dev/ttyUSB2 for U-Boot console diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst index 8d42b35b96..070d678725 100644 --- a/doc/board/freescale/index.rst +++ b/doc/board/freescale/index.rst @@ -7,3 +7,4 @@ Freescale :maxdepth: 2 b4860qds + imx8mp_evk