Search by Tags

Update Tool

 

Compare with Revision




Subscribe for this article updates

Description

The Update Tool is part of the standard image.

With this tool, you can easily do the following:

Please also watch our Update Tool Video Tutorial.

Wich Version To Use

Update Tool
PXA Use the tool which is part of the PXA OS image download
Tegra
i.MX6 Use the tool which is part of the i.MX6 OS image download

Locations on the device

  • Start menu: Start->Progrms->ColibriTools->UpdateTool
  • File system: \Windows\update.exe

Update Tool Help and remarks

When to flash using CFG file (Tegra Only)

Since Update Tool 6.0 you can flash a your module using the *.cfg file. This file actually references all the other files (nb0, bmz, ..) that have to be flashed. Additionally it also re-layouts the module. We recommend to initially flash your modules using the *.cfg files. In a field upgrade we recommend to update only single sections, like image, flashdisk or bootloader if not required differently.

Downgrade from 1.4 and later (Tegra only)

In case you have module flashed with image 1.4 or later and you have to downgrade to any older image Version, you need to add the parameter /nandecc rs4 at the end of your download statement. Forcing the ECC handling is not supported in the GUI version.

Upgrade from images V1.0 (Tegra only)

If you upgrade your Tegra device from image 1.0 to a newer image version you have to use at least Update Tool 6.0. One additional step is required:

  • Run first updatetool.exe /u default.bct. This forces the device to upgrade the BCT
  • After that you can run the image upgrade as for for any other image. Example: updatetool.exe /u ce7.cfg . Don't forget to use /nandecc rs4 if you upgrade to an image older than 1.4.

Command Line Interface

Command Line Parameters (Tegra, PXA and Vybrid)

  • Update an Image, bootloader or another flash section.
/u path

Example: update.exe /u \USB HD\flashbackup.bin

  • Backup the whole Flash to a .bin File
/b path

Example: update.exe /b \USB HD\flashbackup.bin

  • Save registry to Flash Memory
/f 

Example: update.exe /f

  • Save registry to Flash Memory unattended (no additional user input required)
/fu

Example: update.exe /fu

  • Clear registry
/c 

Example: update.exe /c

  • Clear registry unattended (no additional user input required)
/cu

Example: update.exe /cu

  • Colibri T20 only: Wipe Flash Drive and Registry. This is strongly recommended when upgrading from an image older than 1.2. Deprecated since V2.0beta1, Update Tool 6.0.1
/w

Example: update.exe /w

  • Colibri T20 only: Wipe Flash Drive and Registry unattended (no additional user input required). This is strongly recommended when upgrading from an image older than 1.2. Deprecated since V2.0beta1, Update Tool 6.0.1
/wu

Example: update.exe /wu

  • Colibri T20 only: Wipe Flash Drive and Registry unattended (no additional user input required), suppress all errors. This is strongly recommended when upgrading from an image older than 1.2. Deprecated since V2.0beta1, Update Tool 6.0.1
/wue

Example: update.exe /wue

/r

Example: update.exe /r

/rc[Time in ms] 

Example Coldboot immediately: update.exe /rc

Example Coldboot after a 2 second delay: update.exe /rc2000

For PXAxxx WinCE Image V3.3 beta 1 and onwards, it is possible to use more than one command line parameter.

Example: update.exe /cu /u \USB HD\eboot.bin /u \USB HD\nk.bin /rc

  • Force using ECC handling (Colibri T20 only, requires Update Tool 6.0 and later)
/nandecc rs4 

This parameter has to be used in case you want to downgrade to an image older than 1.4 to make sure your module runs with the supported RS4 error correction.

Command Line Parameters (i.MX6)

  • Update an Image, bootloader or another flash section.
/u section,format,path

Example: update.exe /u os,compressed,\TEMP\nk8.nbx

Supported sections and formats:

  • os (bin and compressed)
  • spl (raw, since rev.1.2)
  • bootloader (raw,spl since rev.1.2)
  • configblock (raw)
  • splashscreen (raw)
  • registry (raw, since rev.1.2)

    • Backup a section to file
/s section,format,path

Example: update.exe /s configblock,raw,\Temp\config.cfg

Supported sections and formats:

  • configblock (raw)

    • Save registry to Flash Memory
/f 

Example: update.exe /f

  • Save registry to Flash Memory unattended (no additional user input required)
/fu

Example: update.exe /fu

  • Clear registry
/c 

Example: update.exe /c

  • Clear registry unattended (no additional user input required)
/cu

Example: update.exe /cu

/r

Example: update.exe /r

/rc[Time in ms] 

Example Coldboot immediately: update.exe /rc

Example Coldboot after a 2 second delay: update.exe /rc2000

On i.MX there is no difference between /r and /rc, a cold boot will be always performed

Return Values

When you start the Update tool via command line, you can check the return value to verify if the Update was successful.

  • FALSE: Error
  • TRUE: Successful

Update Splash Screen

For information on Splash Screen refer this article. Once you have a splash screen image in the Bmz format, you can update the splash screen by using the Update Tool.

  1. Open the update tool.
  2. Click on Update.
  3. Change the Type to SplashScreen file.
  4. Select the Bmz file and click ok.

When updating the Splash Screen the LCD screen settings are automatically exported to the Bootloader. Next time you reboot the module you will see the updated splash screen. The field ss.dbginfo always gets set to 0 when updating the splash screen.

This does not apply to i.MX6.

Customization

In case you need a more customized Update processes, you can use our Update Lib. For example, this allows you to show your own progress bar.

On i.MX6 the update library uses the new API, you can download our libraries and find a full documented reference inside the download package.

Video