diff options
| author | Mehmet Fide <mehmet.fide@screeningeagle.com> | 2026-08-14 10:17:56 +0200 |
|---|---|---|
| committer | Fabio Estevam <festevam@gmail.com> | 2026-08-14 16:20:55 -0300 |
| commit | 26e89c6268273a9ca4c2784788cdb502d73f25da (patch) | |
| tree | c5a54ae4a704956bf7866c3643d48d06093b5943 | |
| parent | f6471f9792c4aa1d5b851eb2867a246a4583051b (diff) | |
| download | u-boot-26e89c6268273a9ca4c2784788cdb502d73f25da.tar.gz u-boot-26e89c6268273a9ca4c2784788cdb502d73f25da.zip | |
doc: board: toradex: add the Colibri VF50/VF61 page
The other Toradex modules are documented here, the Vybrid ones were
not. Describe the build, the two ways of getting the image into NAND,
and the flashloader command of the WinCE-era bootloader that modules
from that era still carry.
Acked-by: Francesco Dolcini <francesco.dolcini@toradex.com>
Signed-off-by: Mehmet Fide <mehmet.fide@screeningeagle.com>
| -rw-r--r-- | doc/board/toradex/colibri_vf.rst | 66 | ||||
| -rw-r--r-- | doc/board/toradex/index.rst | 1 |
2 files changed, 67 insertions, 0 deletions
diff --git a/doc/board/toradex/colibri_vf.rst b/doc/board/toradex/colibri_vf.rst new file mode 100644 index 00000000000..f9c81d70214 --- /dev/null +++ b/doc/board/toradex/colibri_vf.rst @@ -0,0 +1,66 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later +.. sectionauthor:: Mehmet Fide <mehmet.fide@screeningeagle.com> + +Colibri VF50/VF61 Modules +========================= + +- SoM: https://www.toradex.com/computer-on-modules/colibri-arm-family/nxp-vybrid-vf5xx-vf6xx +- Carrier boards: https://www.toradex.com/products/carrier-board/colibri-evaluation-board + and https://www.toradex.com/products/carrier-board/iris-carrier-board + +Quick Start +----------- + +- Build U-Boot +- Flash to NAND from a running U-Boot +- Flash to NAND over recovery mode +- Modules still carrying the WinCE bootloader + +Build U-Boot +------------ + +.. code-block:: console + + $ export CROSS_COMPILE=arm-linux-gnueabi- + $ make colibri_vf_defconfig + $ make + +This produces ``u-boot.imx``, the image with the IVT for the Vybrid +BootROM, ready to be written to the ``u-boot`` NAND partition. + +Flash to NAND from a running U-Boot +----------------------------------- + +Load the image over TFTP or from a FAT formatted SD card and use the +``update_uboot`` script from the default environment: + +.. code-block:: none + + Colibri VFxx # fatload mmc 0:1 ${loadaddr} u-boot.imx + Colibri VFxx # run update_uboot + Colibri VFxx # reset + +Flash to NAND over recovery mode +-------------------------------- + +With nothing bootable in NAND, the Vybrid BootROM falls back to the +serial downloader on the USB client port. The `imx_usb_loader +<https://github.com/boundarydevices/imx_usb_loader>`_ tool can push +``u-boot.imx`` straight into OCRAM and run it: + +.. code-block:: console + + $ imx_usb u-boot.imx + +From the running U-Boot, flash NAND as in the previous section. + +Modules still carrying the WinCE bootloader +------------------------------------------- + +Modules that were shipped with the WinCE-era Toradex bootloader (eBoot) +offer a ``flashloader`` command that writes a U-Boot image to NAND: + +.. code-block:: none + + > flashloader u-boot.imx + > reboot diff --git a/doc/board/toradex/index.rst b/doc/board/toradex/index.rst index c5955ea1ad8..10af3a5b758 100644 --- a/doc/board/toradex/index.rst +++ b/doc/board/toradex/index.rst @@ -11,6 +11,7 @@ Toradex aquila-imx95 colibri_imx7 colibri-imx8x + colibri_vf smarc-imx8mp smarc-imx95 verdin-am62 |