[PATCH v2 0/2] Update and improve apalis/colibri imx8/imx8x docs
From: Hiago De Franco hiago.franco@toradex.com
Update and improve apalis-imx8.rst and colibri-imx8x.rst files with newer software revisions and instructions to build U-Boot and necessary firmware for the imx8/imx8x boot container.
v1: - https://lore.kernel.org/all/20240315143930.29155-1-hiagofranco@gmail.com/
v2: - Add Reviewed-by: Francesco Dolcini - Add a patch for apalis-imx8.rst as well, improving the documentation similarly to colibri-imx8x.rst.
Hiago De Franco (2): doc: board: colibri-imx8x: Update and improve documentation doc: board: apalis-imx8: Update and improve documentation
doc/board/toradex/apalis-imx8.rst | 32 ++++++++++++++--------------- doc/board/toradex/colibri-imx8x.rst | 23 ++++++++++++++------- 2 files changed, 32 insertions(+), 23 deletions(-)
From: Hiago De Franco hiago.franco@toradex.com
Update and improve the building documentation of Colibri iMX8X. The following changes were made: - imx-atf repository changed to nxp-imx GitHub. - imx-atf branch updated to 'lf_v2.6'. - imx-seco updated to version 5.8.7. - nxp-imx mfgtools link updated to GitHub releases. - General writing improvements.
Signed-off-by: Hiago De Franco hiago.franco@toradex.com Reviewed-by: Francesco Dolcini francesco.dolcini@toradex.com --- v2: - Add Reviewed-by: Francesco Dolcini --- doc/board/toradex/colibri-imx8x.rst | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-)
diff --git a/doc/board/toradex/colibri-imx8x.rst b/doc/board/toradex/colibri-imx8x.rst index 9e61d98c6b1f..378b259abd05 100644 --- a/doc/board/toradex/colibri-imx8x.rst +++ b/doc/board/toradex/colibri-imx8x.rst @@ -20,26 +20,35 @@ Quick Start Get and Build the ARM Trusted Firmware --------------------------------------
+Download the imx-atf repository: + +.. code-block:: bash + + $ git clone -b lf_v2.6 https://github.com/nxp-imx/imx-atf.git + +Compile it with an aarch64 toolchain: + .. code-block:: bash
- $ git clone -b toradex_imx_5.4.70_2.3.0 http://git.toradex.com/cgit/imx-atf.git/ $ make PLAT=imx8qx bl31 -C imx-atf
Get scfw_tcm.bin and ahab-container.img ---------------------------------------
+Download imx-seco firmware and extract it: + .. code-block:: bash
- $ wget https://github.com/toradex/i.MX-System-Controller-Firmware/raw/master/src/sc... - $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-3.8.1.bin - $ sh imx-seco-3.8.1.bin --auto-accept + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-5.8.7.bin + $ sh imx-seco-5.8.7.bin --auto-accept
Copy the following firmware to the U-Boot folder:
.. code-block:: bash
- $ cp imx-atf/build/imx8qx/release/bl31.bin . - $ cp imx-seco-3.8.1/firmware/seco/mx8qxc0-ahab-container.img mx8qx-ahab-container.img + $ wget https://github.com/toradex/i.MX-System-Controller-Firmware/raw/master/src/sc... + $ cp ../imx-atf/build/imx8qx/release/bl31.bin . + $ cp ../imx-seco-5.8.7/firmware/seco/mx8qxc0-ahab-container.img mx8qx-ahab-container.img
Build U-Boot ------------ @@ -54,7 +63,7 @@ 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%2F... +https://github.com/nxp-imx/mfgtools/releases
Put the module into USB recovery aka serial downloader mode, connect the USB device to your host and execute ``uuu``:
From: Hiago De Franco hiago.franco@toradex.com
Update and improve the building documentation of Apalis iMX8. The following changes were made: - imx-atf repository changed to nxp-imx GitHub. - imx-atf branch updated to 'lf_v2.6'. - imx-seco updated to version 5.8.7. - nxp-imx mfgtools link updated to GitHub releases. - General writing improvements.
Signed-off-by: Hiago De Franco hiago.franco@toradex.com --- v2: - Add this patch for apalis-imx8.rst, updating its instructions as it was done with colibri-imx8x.rst. --- doc/board/toradex/apalis-imx8.rst | 32 +++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-)
diff --git a/doc/board/toradex/apalis-imx8.rst b/doc/board/toradex/apalis-imx8.rst index ffc4c7d222a8..069d86ccd8ca 100644 --- a/doc/board/toradex/apalis-imx8.rst +++ b/doc/board/toradex/apalis-imx8.rst @@ -20,36 +20,36 @@ Quick Start Get and Build the ARM Trusted Firmware --------------------------------------
+Download the imx-atf repository: + +.. code-block:: bash + + $ git clone -b lf_v2.6 https://github.com/nxp-imx/imx-atf.git + +Compile it with an aarch64 toolchain: + .. code-block:: bash
- $ git clone -b imx_4.14.78_1.0.0_ga https://github.com/nxp-imx/imx-atf $ cd imx-atf/ $ make PLAT=imx8qm 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.... - bsp/imx-sc-firmware/files/mx8qm-apalis-scfw-tcm.bin?raw=true - $ mv mx8qm-apalis-scfw-tcm.bin?raw=true mx8qm-apalis-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: +Download imx-seco firmware and extract it:
.. code-block:: bash
- $ cp imx-atf/build/imx8qm/release/bl31.bin . - $ cp u-boot/u-boot.bin . + $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-5.8.7.bin + $ sh imx-seco-5.8.7.bin --auto-accept
-Copy the following firmware to the U-Boot folder: +Copy the following binaries to the U-Boot folder:
.. code-block:: bash
- $ cp firmware-imx-8.0/firmware/seco/ahab-container.img . + $ wget https://github.com/toradex/i.MX-System-Controller-Firmware/raw/master/src/sc... + $ cp ../imx-atf/build/imx8qm/release/bl31.bin . + $ cp ../imx-seco-5.8.7/firmware/seco/mx8qmb0-ahab-container.img mx8qm-ahab-container.img
Build U-Boot ------------ @@ -64,7 +64,7 @@ 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%2F... +https://github.com/nxp-imx/mfgtools/releases
Put the module into USB recovery aka serial downloader mode, connect the USB device to your host and execute ``uuu``:
participants (1)
-
Hiago De Franco