The Toradex Easy Installer is Toradex's recommended option for flashing images onto their modules. One of the methods described below loads the installer into RAM, boots from there and allows to flash a new image. Another method boots from our current image into the Toradex Easy Installer sitting on a USB stick. However, this method currently does not work.
Getting Toradex Easy Installer
You need the Colibri evaluation module, see Colibri Evaluation Board from Toradex. Follow instructions on Loading Toradex Easy Installer to get the installer and load it via USB OTG into the RAM. First, you have to enter recovery mode, see Using a command in the bootloader. If there is no longer any bootloader on the board, follow instructions under Using hardware mechanism. Next, load the installer with the instruction given further down on the same website unter Load Toradex Easy Installer through the USB OTG interface. It will now automatically boot into the Toradex Easy Installer.
Installing an Image
You will need a VNC client installed to connect to the installer. For Ubuntu:
$ sudo apt install tigervnc-viewer
Then connect to the installer with
$ vncviewer <ip address>
You can get the ip address from the Easy Installer command line with ip a
. The following window should appear:
Now select the desired image and click install.
Images Feeds
Images can be browsed on the Images Page. By adding the webserver address provided on this page to the feeds, the images can be installed directly over the web.
Image not showing up
If the installer does not show the image on the SD Card/USB try the refresh button in the menu bar at the top.
Enable Torizon Beta images
The Toradex CI Server can be enabled under „feeds“ in the menu bar. After a refresh this yields access to Toradex's work in progress and daily builds, e.g. Torizon with RT kernel.
Toradex Easy Installer Image Format
Unlike the legacy images that needed to be flashed explicitly, this „image“ is a collection of files in a folder that can simply be copied to a SD Card or USB stick. They will automatically be recognised by the Toradex Easy Installer if they are present at boot.
Providing an Image via http
The Toradex Easy Installer can load images from a web server using http. All that is needed is a web server hosting the files and a file describing what images there are (image_list.json
) in the web root.
Example image_list.json
, assuming that the image of interest is in a directory called cb20
. This is the same directory as produced by yocto when building for the CB20 in build/deploy/images
.
UI Text Box | ||
---|---|---|
| ||
{ |
Adding the server to the Toradex Easy Installer Image
The server can be added to the Easy Installer Image by adding a tezi_config.json
file to it. A sample is provided below:
UI Text Box | ||
---|---|---|
| ||
{ |
Alternatively, it can also be added by clicking on the *feeds* button in the menu bar..
Toradex Easy Installer on USB
With a standard image on the Colibri module, there is no need to load the Toradex Easy Installer into RAM through USB OTG. You can interrupt the boot process in uBoot and boot into the installer sitting on a USB stick or SD card.
However, with our image the uBoot environment is slightly different and the installer will not be found unless the following changes are made.
The boot script should be boot.scr (instead of boot-tezi.scr)
The device tree name must be imx6dl-colibri-eval-v3.dtb (instead of imx6dl-colibri-cb20.dtb.
Getting the Toradex Easy Installer
Download the Toradex Easy Installer from the Toradex Wiki and extract the downloaded archive onto a SD Card or USB Stick (FAT32). Insert the into the Board's SD Card slot or USB port and power it on.
Booting into Toradex Easy Installer
Interrupt the boot process (hit any key) to boot into uBoot. Now run run bootcmd_mmc1 to boot from the SD Card or run bootcmd_usb0 to boot from USB.
Note that while Toradex recommends using the run distro_bootcmd this will boot from the modules internal flash if a bootable image is present.
If you get an error along the lines of bootcmd_usb0 not found chances are that the board runs an older version of uboot that does not come with distroboot. In that case the bootloader can be updated by flashing a new toradex image as described here here.
Note that if Toradex's update.sh script fails with no space left on device, you can try increasing the MIN_PARTITION_FREE_SIZE in update.sh to work around the issue.
Now proceed with with "Installing an Image" on this page.