Skip to main content

Production Programming for Colibri VFxx Modules

There are different ways to program / configure your Colibri modules in production. The documentation below is split into the two sections

  • Create the master backup Files
  • Restore this backup to many modules

Create the Master Backup Files

Use the following steps to generate the master backup files once:

  1. Set up a Colibri with all your SW and settings.
    Make sure the Configblock and the Registry are correct, and that your software is on the system (e.g in \FlashDisk\).
  2. Use the Update Tool to backup all the regions you want to restore including Configblock, Registry and filesystem.
    We strongly recommend to use the latest available Update Tool. We cannot guarantee that an old Update Tool will work properly for example to downgrade a newer image to a previous version!

Instead of using the Update Tool, we also offer an Update library that allows you to write your own backup program.

Restore the Master Backup Files to Many Modules

There are a few options to restore the master backup files onto other modules,

caution

If a power loss occurs while programming data, the flash could get corrupted.
As long as the Bootloader is not damaged, you can always use it to restore the module. If the bootloader is damaged, you need Recovery mode to restore the module.

Restore Using the Latest Update Tool

info

We strongly recommend to use the latest available Update Tool. We cannot guarantee that an old Update Tool will work properly for example to downgrade a newer image to a previous version!

Restore Using a Production Programming Script

For production programming you will need a USB, SD or other mass storage device.
We call it production programming storage device in the following.

Preparation (Once)

Use the following steps to prepare the production programming storage device once:

  1. Download the production programming template
  2. Copy the master backup files into the folder Production programming template\Backup\
  3. Copy the latest Update tool into the folder Production programming template\UpdateTool\
    The latest update tool is available as part of the latest image download package
  4. Modify the ProductionProgramming.Bat file to your needs
    Notes:
    • If you are updating the OS to a newer image version of the same OS you need to clear the registry, as it may be incompatible
    • If you are updating from different version of Windows CE you need to first update the bootloader and the image, reboot, and update the rest of the sections
  5. Copy all the Production programming template\ files to the production programming storage device

Programming

To program modules, follow the simple steps below:

  1. Boot the target module and insert the production programming storage device
    The update process will start automatically. Wait for the update to complete.
  2. Reboot the device

Build Your Own Restore Application

If you need more control over the programming, you can write your own program and use the Update tool to do the actual programming.

If you wish to further customize the programming, use the Toradex CE Libraries. The package contains the UpdateLib, which provides an API to implement your own update process. This is, for example, useful if you would like to show your own progress bar.

Partial programming

In case you do not wish to program the complete flash, just make a backup file of each region you would like to program. Available regions include:

  • Bootloader
  • Config Block
  • OS Image
  • Registry
  • File System

Update tool versions before 7.3.0 (2.0)

danger

Using an older Update Tool is deprecated. We strongly recommend to use the latest Update Tool only. This section is left in the post for completeness, because the process was slightly different.

Click To Read through the process for old Update Tool Versions

Program the complete flash with the Update Tool

Create the master files
  • Set up a Colibri with all your SW and settings. Make sure the Configblock and the Registry are correct, and that your software is on the system (e.g in /FlashDisk).
  • Use the Update Tool to backup the complete flash memory including Bootloader, Configblock, Image, Registry, and all files in the Flash Disk.
Program the master files to other Colibris
  • Take an empty USB memory stick
  • Copy the Update Tool in the root of the USB stick
  • Copy the backup files to the root
  • Create a folder called AutoRun
  • Place a Shortcut in the AutoRun Folder which starts the Update Tool with the following parameters "/u \USB HD\backup.bin". (Instead of using a shortcut file you can also write a small program which starts the update process, so you could add more functionality like tests or logging)
Start the programming
  • Just connect the USB stick with the Colibri and the system will automatically do an update

Notes on Toradex Firmware Versions

Toradex modules are normally shipped with the newest version of the Image/Bootloader firmware. We change the SW version of the preinstalled Win CE image/bootloader firmware without any notification.
If you receive a new batch of Colibris, make sure you check the version of the installed SW. If the version is different check the change log file on our server.
We recommend that you should always use our latest OS release. Make sure that your own SW/HW still works fine with the newest Toradex SW. (This is normally the case).

However, it is not possible for all customers to always use the latest Toradex SW. In this case you can downgrade all the Colibri SW with your tested version of the SW. If the HW version of the Colibri has changed, you need to verify if the "old" SW is still 100% compatible. If you are not sure, you can contact the support.



Send Feedback!