Document toolboxDocument toolbox

dUpgrade Firmware Package Structure

Firmware packages for the new (Java) dUpgrade tool can contain a single version of firmware each for the TX1, TX2 and TXL loggers. The packages consist of a ZIP format file with a particular structure.

The structure inside the ZIP file

All three different kinds of firmware are optional.

  • TXL firmware: This consists of two or three files: master.bin, slave.bin and optionally webpages.bin. These files must be located at the top level of the ZIP directory structure.
  • TX1 firmware: This consists of a Master.exe file, any number of *.dll files, and optionally a config folder containing the web config tool files. The files and the config folder (if existent) must be located inside a tx folder that is directly underneath the top level of the ZIP directory structure.
  • TX2 firmware: This is exactly the same as the TX1 firmware, except that the Master.exe file is now called tx28.exe and the files must be located in a tx2 folder directly underneath the top level of the ZIP, rather than in a tx folder.

For example:

The name of the ZIP file

The name of the file is not significant for the upgrade tool, but a consistent format is useful for users. The suggested format is as follows:

  • TX[master.version-webconfig.version]TX2[master.version-webconfig.version]TXL[master.version-slave.version-webconfig.version].zip

Where each of the TX, TX2 and TXL parts relate to the versions of the firmware contained within the package (and as such, each part is optional). Example names include:

  • TX[1.5T419-608]TX2[1.5T425-608]TXL[723-723-720].zip
  • TX2[1.5T425-608].zip
  • TXL[723-723-720].zip

Compatibility with the old dUpgrade tool

The old (non-Java) dUpgrade could only upgrade TXLs - it took a ZIP file containing the TXLs .bin files at the top level of the ZIP directory structure. The new dUpgrade also understands these package files.