From patchwork Fri Nov 20 14:05:51 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Oliver Graute X-Patchwork-Id: 1403737 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=fail (p=none dis=none) header.from=kococonnector.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=KoCoConnector.onmicrosoft.com header.i=@KoCoConnector.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-KoCoConnector-onmicrosoft-com header.b=MEjFYI+c; 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) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4Ccyzb5ZZVz9sVC for ; Sat, 21 Nov 2020 01:07:16 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 14DA482552; Fri, 20 Nov 2020 15:07:10 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=kococonnector.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=KoCoConnector.onmicrosoft.com header.i=@KoCoConnector.onmicrosoft.com header.b="MEjFYI+c"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 7FF7682564; Fri, 20 Nov 2020 15:07:08 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-0.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,FORGED_SPF_HELO,MSGID_FROM_MTA_HEADER,SPF_HELO_PASS, URIBL_BLOCKED autolearn=no autolearn_force=no version=3.4.2 Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2060c.outbound.protection.outlook.com [IPv6:2a01:111:f400:7d00::60c]) (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 560BB82366 for ; Fri, 20 Nov 2020 15:07:05 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=kococonnector.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=oliver.graute@kococonnector.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Aku/Y+edS2q5+AO6KYpss3Kweza2/eE36oyZ8KlFhaScmvcuXtywRIebjVJUnipMGznbaFJ5oGrU8T3JAjr9kBp13EXMtCwx3KE1RPbt9qJwWKqnnG6SJPxhFrWGgeWowzkieGEfyG5mACw3BAwXe5x5NXBVIK1y0kol6WidPdFY7ffL/0n03Lf5JTE0GGet7rJfuFRCQff8TEnCFRCW1OrMB5IeMbp4wogreAHGCf/OvzwvrMzLewXAtHjj0BLQhjS/i2BTspl+jFQtFPVhDpGJeAiPstA71s8x6iA/GeEOu8K8ZPN7emnqcpFhMrResKQQzk6VpQtcH7WjUUICjw== 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=e0mrqKBuCitD09MEisfjQQDQMSqbTS/4anSUZ8VOaj8=; b=NmmdgbFMWDpwH9f4u1mtovPurAsNuNIfQDchcJctI1fgkuLJ848I1APCEGVHAEogNXuqnsqglSGLLZVDVktQM/v6nwhj87999HZ4O5m6TgIPfH1iSkVORHq2tQOTl7T1xs+uheaTRZJm7wvbmHdcvkVkFty4oC72mFb/ea7ynih8scL1LjC9e1cqH6xrhDRfssz+QOzJCbvznqDhl+BNkm4QW2wSwbNd7m40dBdygmbz9uqlSkzk+Ak391pGzU/i7BG9X5hyQIRc9gDoP4uuQ2J6ZfzEDuYNxOxAvP0dKAHAEUIkXjxcGRvoaVY4OP9ezN4gW3EoLqvheeaCLXNTYA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=kococonnector.com; dmarc=pass action=none header.from=kococonnector.com; dkim=pass header.d=kococonnector.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=KoCoConnector.onmicrosoft.com; s=selector2-KoCoConnector-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=e0mrqKBuCitD09MEisfjQQDQMSqbTS/4anSUZ8VOaj8=; b=MEjFYI+cLJLCQ3jYT5DIYtrCmSSIztf7Uow3yfcFdhsdAQsCSsDj8QRspFKE24nKhpgHgwAC/RVVz9LqYnN2ua/CMkXfL6H4nEtCESK/V1SVsO8zN9qZZtLNlBaCYVYOpey4R8QSrM1wMTzqv/4V7xu6uaUfV9ZVZFQUGOZA7M8= Authentication-Results: denx.de; dkim=none (message not signed) header.d=none;denx.de; dmarc=none action=none header.from=kococonnector.com; Received: from AM0PR09MB4067.eurprd09.prod.outlook.com (2603:10a6:208:194::14) by AM0PR09MB3395.eurprd09.prod.outlook.com (2603:10a6:208:16e::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3589.24; Fri, 20 Nov 2020 14:07:03 +0000 Received: from AM0PR09MB4067.eurprd09.prod.outlook.com ([fe80::15c3:deb5:2d25:c1f3]) by AM0PR09MB4067.eurprd09.prod.outlook.com ([fe80::15c3:deb5:2d25:c1f3%6]) with mapi id 15.20.3589.022; Fri, 20 Nov 2020 14:07:03 +0000 From: Oliver Graute To: sbabic@denx.de Cc: u-boot@lists.denx.de, uboot-imx@nxp.com, oliver.graute@kococonnector.com Subject: [PATCH v1] doc: board: imx8qm-rom7720-a1.rst: convert readme to reST Date: Fri, 20 Nov 2020 15:05:51 +0100 Message-Id: <20201120140552.6929-1-oliver.graute@kococonnector.com> X-Mailer: git-send-email 2.17.1 X-Patchwork-Bot: notify X-Originating-IP: [2.207.138.2] X-ClientProxiedBy: AM0PR01CA0099.eurprd01.prod.exchangelabs.com (2603:10a6:208:10e::40) To AM0PR09MB4067.eurprd09.prod.outlook.com (2603:10a6:208:194::14) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from localhost (2.207.138.2) by AM0PR01CA0099.eurprd01.prod.exchangelabs.com (2603:10a6:208:10e::40) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3589.20 via Frontend Transport; Fri, 20 Nov 2020 14:07:03 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 09e4cb16-5c0d-41de-ae05-08d88d5d8e56 X-MS-TrafficTypeDiagnostic: AM0PR09MB3395: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:1728; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 7URqx77I45m71BlX3pONpLoSoC0GyKRfz6H6OmlAACxUhbKGu+A+RG9nblYZNnVcWEVBShzdDrvwopfRQz6FAwSJno2Ju4KUCVmtYnzDZ2/JKWMIxJP04wXPJ0tVo1sJT18YAKYoqhbS7MNrTctPd6b5yzmNxgQv4UHobz3sq/3dwqmKf7x9+M5Jk4icO9mEfrwCpxjP3oeocJdxv0Y1pQBzmjbmUMM/HqqdhpSv7ll2WOWKzb1EXLX6i9ZBfoi56cwX5Rzf389AmAN1Fxw6GQUNhWxDO79m09VBwNgPvUb5qIAXt72i70+Zo3Dn4LB74Y+t60muMCbO5Skaj0dREDRYGdS68IzNhbw4tSdT5bz/cu+EG2swITHbVLyXc5iG/4pujz4kLRTXNOEPd7RpvMgI4HiSkPdCQ1/BhsBgjUMLSkPlAIgpVQ30L0rdRDAHwiQlv6I74AmFa2TEZ0sYwg== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR09MB4067.eurprd09.prod.outlook.com; PTR:; CAT:NONE; SFS:(136003)(366004)(346002)(396003)(376002)(39830400003)(66476007)(36756003)(66574015)(6666004)(66946007)(5660300002)(83380400001)(66556008)(107886003)(2906002)(2616005)(956004)(6496006)(44832011)(186003)(4326008)(16526019)(52116002)(478600001)(26005)(1076003)(966005)(86362001)(316002)(6916009)(6486002)(8936002)(8676002)(32563001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: xhj8MXNgdlG/gYjF4bWPwmu9wWZk0Y4Qvt5da062pHvz4PxCW7jdJDJJCDs3geVnIfZOxJnqFtURUv8btu0cEV2C5h7QIzoZnv4tqqLCCoHCTjtAlGDRSnfWNhJdZnOeRmbAGhS5bsbaYECJGh2uXIzZ0pQxv+KcjjFKFBG8qlISlwZbXKovKUH2uQ8g7WHXdon5HpGvE99NGrRT4JSX0y0GIzwIPujMlhiYGCxFgGUWvSoEMzfVm/x+j7faHomntYAGS6e2a8YMkCV3oqy3kytf+XbNzMVqTF7sw7QIYqmGTteVx35QFQLrM4vvuRixKKSXvOACQrig2O5ZBcZoMnXaeZT1bsHpIxugT3ISSoKe3T8dQroq0kTX5i0y7JHaZrjPQGwuZWORpMAne6L18qcAhJc9sJPtXJDsHYoSV4gQw++XpLTxmPvpS7UBUWohRkrXBX9Jm/Ll8nqVshkxGF5Lt/ZVqaKUWjIbh+Fv7+vYpQrV6sC836+/FOkfwt2QM2G3gr6we+zOCdzoeEnljdUU7liTQf+RV6dHpLwXPzoxv/wJAvKqTjpDh5VKdjwFnd0ndNslVOyeYSZNtUloQDKGdjcFfgWBjrQRy2EL+eRgY7Ts47l+0tGogZLRMIhwWBUhzkZt7SVEH8fQkK6rpg== X-OriginatorOrg: kococonnector.com X-MS-Exchange-CrossTenant-Network-Message-Id: 09e4cb16-5c0d-41de-ae05-08d88d5d8e56 X-MS-Exchange-CrossTenant-AuthSource: AM0PR09MB4067.eurprd09.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Nov 2020 14:07:03.5292 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 59845429-0644-4099-bd7e-17fba65a2f2b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 0gRz2ohWHgJuIjKVjQkVmgza5SRFdaBrIy0V6V2hFrrzwDmpoxNvvcUGSznBfBNDxHi4ySvAxWX+bk2KB7/5N77COPLEWBWnW6YTJHVGISw= X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR09MB3395 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 README to reStructuredText format. Signed-off-by: Oliver Graute --- board/advantech/imx8qm_rom7720_a1/README | 61 ------------------ doc/board/advantech/imx8qm-rom7720-a1.rst | 75 +++++++++++++++++++++++ doc/board/advantech/index.rst | 9 +++ 3 files changed, 84 insertions(+), 61 deletions(-) delete mode 100644 board/advantech/imx8qm_rom7720_a1/README create mode 100644 doc/board/advantech/imx8qm-rom7720-a1.rst create mode 100644 doc/board/advantech/index.rst diff --git a/board/advantech/imx8qm_rom7720_a1/README b/board/advantech/imx8qm_rom7720_a1/README deleted file mode 100644 index 585fde440d..0000000000 --- a/board/advantech/imx8qm_rom7720_a1/README +++ /dev/null @@ -1,61 +0,0 @@ -U-Boot for the NXP i.MX8QM ROM 7720a1 board - -Quick Start -=========== - -- Build the ARM Trusted firmware binary -- Get scfw_tcm.bin and ahab-container.img -- Get imx-mkimage -- Build U-Boot -- Build imx-mkimage -- Flash the binary into the SD card -- Boot - -Get and Build the ARM Trusted firmware -====================================== - -$ git clone https://source.codeaurora.org/external/imx/imx-atf -$ cd imx-atf/ -$ git checkout origin/imx_4.14.78_1.0.0_ga -b imx_4.14.78_1.0.0_ga -$ make PLAT=imx8qm bl31 - -Get scfw_tcm.bin and ahab-container.img -============================== - -$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-sc-firmware-1.1.bin -$ chmod +x imx-sc-firmware-1.1.bin -$ ./imx-sc-firmware-1.1.bin -$ 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.bin - -Or use this to avoid running random scripts from the internet, -but note that you must agree to the license the script displays: - -$ dd if=imx-sc-firmware-1.1.bin of=imx-sc-firmware-1.1.tar.bz2 bs=37185 skip=1 -$ tar -xf imx-sc-firmware-1.1.tar.bz2 -$ cp imx-sc-firmware-1.1/mx8qm-val-scfw-tcm.bin $(builddir) - -$ dd if=firmware-imx-8.0.bin of=firmware-imx-8.0.tar.bz2 bs=37180 skip=1 -$ tar -xf firmware-imx-8.0.tar.bz2 -$ cp firmware-imx-8.0/firmware/seco/mx8qm-ahab-container.img $(builddir) - -Build U-Boot -============ - -$ export ATF_LOAD_ADDR=0x80000000 -$ export BL33_LOAD_ADDR=0x80020000 -$ make imx8qm_rom7720_a1_4G_defconfig -$ make u-boot.bin -$ make flash.bin - -Flash the binary into the SD card -================================= - -Burn the flash.bin binary to SD card offset 32KB: - -$ sudo dd if=flash.bin of=/dev/sd[x] bs=1k seek=32 conv=fsync - -Boot -==== -Set Boot switch SW2: 1100. diff --git a/doc/board/advantech/imx8qm-rom7720-a1.rst b/doc/board/advantech/imx8qm-rom7720-a1.rst new file mode 100644 index 0000000000..bd4be1dbeb --- /dev/null +++ b/doc/board/advantech/imx8qm-rom7720-a1.rst @@ -0,0 +1,75 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +U-Boot for the NXP i.MX8QM ROM 7720a1 board +=========================================== + +Quick Start +----------- + +- Build the ARM Trusted firmware binary +- Get scfw_tcm.bin and ahab-container.img +- Get imx-mkimage +- Build U-Boot +- Build imx-mkimage +- Flash the binary into the SD card +- Boot + +Get and Build the ARM Trusted firmware +-------------------------------------- + +.. code-block:: bash + + $ git clone https://source.codeaurora.org/external/imx/imx-atf + $ cd imx-atf/ + $ git checkout origin/imx_4.14.78_1.0.0_ga -b imx_4.14.78_1.0.0_ga + $ make PLAT=imx8qm bl31 + +Get scfw_tcm.bin and ahab-container.img +--------------------------------------- + +.. code-block:: bash + + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-sc-firmware-1.1.bin + $ chmod +x imx-sc-firmware-1.1.bin + $ ./imx-sc-firmware-1.1.bin + $ 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.bin + +Or use this to avoid running random scripts from the internet, +but note that you must agree to the license the script displays: + +.. code-block:: bash + + $ dd if=imx-sc-firmware-1.1.bin of=imx-sc-firmware-1.1.tar.bz2 bs=37185 skip=1 + $ tar -xf imx-sc-firmware-1.1.tar.bz2 + $ cp imx-sc-firmware-1.1/mx8qm-val-scfw-tcm.bin $(builddir) + + $ dd if=firmware-imx-8.0.bin of=firmware-imx-8.0.tar.bz2 bs=37180 skip=1 + $ tar -xf firmware-imx-8.0.tar.bz2 + $ cp firmware-imx-8.0/firmware/seco/mx8qm-ahab-container.img $(builddir) + +Build U-Boot +------------ + +.. code-block:: bash + + $ export ATF_LOAD_ADDR=0x80000000 + $ export BL33_LOAD_ADDR=0x80020000 + $ make imx8qm_rom7720_a1_4G_defconfig + $ make u-boot.bin + $ make flash.bin + +Flash the binary into the SD card +--------------------------------- + +Burn the flash.bin binary to SD card offset 32KB: + +.. code-block:: bash + + $ sudo dd if=flash.bin of=/dev/sd[x] bs=1k seek=32 conv=fsync + +Boot +---- + +Set Boot switch SW2: 1100. diff --git a/doc/board/advantech/index.rst b/doc/board/advantech/index.rst new file mode 100644 index 0000000000..e9b198c5c3 --- /dev/null +++ b/doc/board/advantech/index.rst @@ -0,0 +1,9 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Advantech +========= + +.. toctree:: + :maxdepth: 2 + + imx8qm-rom7720-a1.rst