Re: [PATCH v5 4/6] doc: board: colibri-imx8x: convert readme to reST
On Wed, Feb 12, 2020 at 11:14 PM Igor Opaniuk wrote: > > From: Igor Opaniuk > > Convert README to reStructuredText format. > > Signed-off-by: Igor Opaniuk > --- > > board/toradex/colibri-imx8x/README | 66 --- > doc/board/toradex/colibri-imx8x.rst | 82 + > doc/board/toradex/index.rst | 1 + > 3 files changed, 83 insertions(+), 66 deletions(-) > delete mode 100644 board/toradex/colibri-imx8x/README > create mode 100644 doc/board/toradex/colibri-imx8x.rst > Reviewed-by: Bin Meng Tested-by: Bin Meng
Re: [PATCH v5 4/6] doc: board: colibri-imx8x: convert readme to reST
On Wed, Feb 12, 2020 at 5:15 PM Igor Opaniuk wrote: > > From: Igor Opaniuk > > Convert README to reStructuredText format. > > Signed-off-by: Igor Opaniuk Reviewed-by: Oleksandr Suvorov > --- > > board/toradex/colibri-imx8x/README | 66 --- > doc/board/toradex/colibri-imx8x.rst | 82 + > doc/board/toradex/index.rst | 1 + > 3 files changed, 83 insertions(+), 66 deletions(-) > delete mode 100644 board/toradex/colibri-imx8x/README > create mode 100644 doc/board/toradex/colibri-imx8x.rst > > diff --git a/board/toradex/colibri-imx8x/README > b/board/toradex/colibri-imx8x/README > deleted file mode 100644 > index 708bb3e51c..00 > --- a/board/toradex/colibri-imx8x/README > +++ /dev/null > @@ -1,66 +0,0 @@ > -U-Boot for the Toradex Colibri iMX8QXP V1.0B Module > - > -Quick Start > -=== > - > -- Build the ARM trusted firmware binary > -- Get scfw_tcm.bin and ahab-container.img > -- Build U-Boot > -- Load U-Boot binary using uuu > -- Flash U-Boot binary into the eMMC > -- Boot > - > -Get and Build the ARM Trusted Firmware > -== > - > -$ git clone -b imx_4.14.78_1.0.0_ga > https://source.codeaurora.org/external/imx/imx-atf > -$ cd imx-atf/ > -$ make PLAT=imx8qxp bl31 > - > -Get scfw_tcm.bin and ahab-container.img > -=== > - > -$ wget > https://github.com/toradex/meta-fsl-bsp-release/blob/toradex-sumo-4.14.78-1.0.0_ga-bringup/imx/meta-bsp/recipes-bsp/imx-sc-firmware/files/mx8qx-colibri-scfw-tcm.bin?raw=true > -$ mv mx8qx-colibri-scfw-tcm.bin\?raw\=true mx8qx-colibri-scfw-tcm.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 > - > -Copy the following binaries to the U-Boot folder: > - > -$ cp imx-atf/build/imx8qxp/release/bl31.bin . > -$ cp u-boot/u-boot.bin . > - > -Copy the following firmware to the U-Boot folder: > - > -$ cp firmware-imx-8.0/firmware/seco/ahab-container.img . > - > -Build U-Boot > - > - > -$ make colibri-imx8qxp_defconfig > -$ make u-boot-dtb.imx > - > -Load the U-Boot Binary Using UUU > - > - > -Get the latest version of the universal update utility (uuu) aka mfgtools > 3.0: > - > -https://community.nxp.com/external-link.jspa?url=https%3A%2F%2Fgithub.com%2FNXPmicro%2Fmfgtools%2Freleases > - > -Put the module into USB recovery aka serial downloader mode, connect USB > device > -to your host and execute uuu: > - > -sudo ./uuu u-boot/u-boot-dtb.imx > - > -Flash the U-Boot Binary into the eMMC > -= > - > -Burn the u-boot-dtb.imx binary to the primary eMMC hardware boot area > partition: > - > -load mmc 1:1 $loadaddr u-boot-dtb.imx > -setexpr blkcnt ${filesize} + 0x1ff && setexpr blkcnt ${blkcnt} / 0x200 > -mmc dev 0 1 > -mmc write ${loadaddr} 0x0 ${blkcnt} > - > -Boot > diff --git a/doc/board/toradex/colibri-imx8x.rst > b/doc/board/toradex/colibri-imx8x.rst > new file mode 100644 > index 00..244e5a4c04 > --- /dev/null > +++ b/doc/board/toradex/colibri-imx8x.rst > @@ -0,0 +1,82 @@ > +.. SPDX-License-Identifier: GPL-2.0+ > + > +Colibri iMX8QXP V1.0B Module > + > + > +Quick Start > +--- > + > +- Build the ARM trusted firmware binary > +- Get scfw_tcm.bin and ahab-container.img > +- Build U-Boot > +- Load U-Boot binary using uuu > +- Flash U-Boot binary into the eMMC > +- Boot > + > +Get and Build the ARM Trusted Firmware > +-- > + > +.. code-block:: bash > + > +$ git clone -b imx_4.14.78_1.0.0_ga > https://source.codeaurora.org/external/imx/imx-atf > +$ cd imx-atf/ > +$ make PLAT=imx8qxp bl31 > + > +Get scfw_tcm.bin and ahab-container.img > +--- > +.. code-block:: bash > + > +$ wget https://github.com/toradex/meta-fsl-bsp-release/blob/ > + toradex-sumo-4.14.78-1.0.0_ga-bringup/imx/meta-bsp/recipes- > + bsp/imx-sc-firmware/files/mx8qx-colibri-scfw-tcm.bin?raw=true > +$ mv mx8qx-colibri-scfw-tcm.bin\?raw\=true mx8qx-colibri-scfw-tcm.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 > + > +Copy the following binaries to the U-Boot folder: > + > +.. code-block:: bash > + > +$ cp imx-atf/build/imx8qxp/release/bl31.bin . > +$ cp u-boot/u-boot.bin . > + > +Copy the following firmware to the U-Boot folder: > + > +.. code-block:: bash > + > +$ cp firmware-imx-8.0/firmware/seco/ahab-container.img . > + > +Build U-Boot > + > + > +.. code-block:: bash > + > + $ make colibri-imx8qxp_defconfig > + $ make u-boot-dtb.imx > + > +Load the U-Boot Binary Using UUU > + > + > +Get the latest version of the universal update utility (uuu) aka ``mfgtools > 3.0``: > + >
[PATCH v5 4/6] doc: board: colibri-imx8x: convert readme to reST
From: Igor Opaniuk Convert README to reStructuredText format. Signed-off-by: Igor Opaniuk --- board/toradex/colibri-imx8x/README | 66 --- doc/board/toradex/colibri-imx8x.rst | 82 + doc/board/toradex/index.rst | 1 + 3 files changed, 83 insertions(+), 66 deletions(-) delete mode 100644 board/toradex/colibri-imx8x/README create mode 100644 doc/board/toradex/colibri-imx8x.rst diff --git a/board/toradex/colibri-imx8x/README b/board/toradex/colibri-imx8x/README deleted file mode 100644 index 708bb3e51c..00 --- a/board/toradex/colibri-imx8x/README +++ /dev/null @@ -1,66 +0,0 @@ -U-Boot for the Toradex Colibri iMX8QXP V1.0B Module - -Quick Start -=== - -- Build the ARM trusted firmware binary -- Get scfw_tcm.bin and ahab-container.img -- Build U-Boot -- Load U-Boot binary using uuu -- Flash U-Boot binary into the eMMC -- Boot - -Get and Build the ARM Trusted Firmware -== - -$ git clone -b imx_4.14.78_1.0.0_ga https://source.codeaurora.org/external/imx/imx-atf -$ cd imx-atf/ -$ make PLAT=imx8qxp bl31 - -Get scfw_tcm.bin and ahab-container.img -=== - -$ wget https://github.com/toradex/meta-fsl-bsp-release/blob/toradex-sumo-4.14.78-1.0.0_ga-bringup/imx/meta-bsp/recipes-bsp/imx-sc-firmware/files/mx8qx-colibri-scfw-tcm.bin?raw=true -$ mv mx8qx-colibri-scfw-tcm.bin\?raw\=true mx8qx-colibri-scfw-tcm.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 - -Copy the following binaries to the U-Boot folder: - -$ cp imx-atf/build/imx8qxp/release/bl31.bin . -$ cp u-boot/u-boot.bin . - -Copy the following firmware to the U-Boot folder: - -$ cp firmware-imx-8.0/firmware/seco/ahab-container.img . - -Build U-Boot - - -$ make colibri-imx8qxp_defconfig -$ make u-boot-dtb.imx - -Load the U-Boot Binary Using UUU - - -Get the latest version of the universal update utility (uuu) aka mfgtools 3.0: - -https://community.nxp.com/external-link.jspa?url=https%3A%2F%2Fgithub.com%2FNXPmicro%2Fmfgtools%2Freleases - -Put the module into USB recovery aka serial downloader mode, connect USB device -to your host and execute uuu: - -sudo ./uuu u-boot/u-boot-dtb.imx - -Flash the U-Boot Binary into the eMMC -= - -Burn the u-boot-dtb.imx binary to the primary eMMC hardware boot area partition: - -load mmc 1:1 $loadaddr u-boot-dtb.imx -setexpr blkcnt ${filesize} + 0x1ff && setexpr blkcnt ${blkcnt} / 0x200 -mmc dev 0 1 -mmc write ${loadaddr} 0x0 ${blkcnt} - -Boot diff --git a/doc/board/toradex/colibri-imx8x.rst b/doc/board/toradex/colibri-imx8x.rst new file mode 100644 index 00..244e5a4c04 --- /dev/null +++ b/doc/board/toradex/colibri-imx8x.rst @@ -0,0 +1,82 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Colibri iMX8QXP V1.0B Module + + +Quick Start +--- + +- Build the ARM trusted firmware binary +- Get scfw_tcm.bin and ahab-container.img +- Build U-Boot +- Load U-Boot binary using uuu +- Flash U-Boot binary into the eMMC +- Boot + +Get and Build the ARM Trusted Firmware +-- + +.. code-block:: bash + +$ git clone -b imx_4.14.78_1.0.0_ga https://source.codeaurora.org/external/imx/imx-atf +$ cd imx-atf/ +$ make PLAT=imx8qxp bl31 + +Get scfw_tcm.bin and ahab-container.img +--- +.. code-block:: bash + +$ wget https://github.com/toradex/meta-fsl-bsp-release/blob/ + toradex-sumo-4.14.78-1.0.0_ga-bringup/imx/meta-bsp/recipes- + bsp/imx-sc-firmware/files/mx8qx-colibri-scfw-tcm.bin?raw=true +$ mv mx8qx-colibri-scfw-tcm.bin\?raw\=true mx8qx-colibri-scfw-tcm.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 + +Copy the following binaries to the U-Boot folder: + +.. code-block:: bash + +$ cp imx-atf/build/imx8qxp/release/bl31.bin . +$ cp u-boot/u-boot.bin . + +Copy the following firmware to the U-Boot folder: + +.. code-block:: bash + +$ cp firmware-imx-8.0/firmware/seco/ahab-container.img . + +Build U-Boot + + +.. code-block:: bash + + $ make colibri-imx8qxp_defconfig + $ make u-boot-dtb.imx + +Load the U-Boot Binary Using UUU + + +Get the latest version of the universal update utility (uuu) aka ``mfgtools 3.0``: + +https://community.nxp.com/external-link.jspa?url=https%3A%2F%2Fgithub.com%2FNXPmicro%2Fmfgtools%2Freleases + +Put the module into USB recovery aka serial downloader mode, connect USB device +to your host and execute ``uuu``: + +.. code-block:: bash + +sudo ./uuu u-boot/u-boot-dtb.imx + +Flash the U-Boot Binary into the eMMC +- + +Burn the ``u-boot-dtb.imx`` binary to the primary eMMC