Jump to content

Device Firmware Update

From Teltonika Telematics Wiki
Revision as of 13:59, 12 September 2025 by Airidas.S (talk | contribs) (Created page with "= FT Device Firmware Update Information = == Introduction == The '''Device Firmware Update (DFU)''' feature enables FT platform devices to update their firmware either: * '''Over-the-air (OTA)''' via FOTAWEB * '''Locally''' through a USB connection using TCT (Teltonika Configuration Tool) This ensures devices always run the latest, most stable, and secure firmware versions. == Firmware image types == There are three main firmware image types used in the FT platform:...")

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)

FT Device Firmware Update Information

Introduction

The Device Firmware Update (DFU) feature enables FT platform devices to update their firmware either:

  • Over-the-air (OTA) via FOTAWEB
  • Locally through a USB connection using TCT (Teltonika Configuration Tool)

This ensures devices always run the latest, most stable, and secure firmware versions.

Firmware image types

There are three main firmware image types used in the FT platform:

  • FTx.Ver.x.x.x-rc.x.e.xim / FTx.Ver.x.x.x.x.e.xim
 Example: FTx.Ver.0.5.0-rc.9.e.xim
  • FTx.Ver.x.x.x-rc.x.wmi.e.xim / FTx.Ver.x.x.x.wmi.e.xim
 Example: FTx.Ver.1.5.0-rc.9.wmi.e.xim
  • FTx.Ver.x.x.x-rc.x.tpack / FTx.Ver.x.x.x.tpack
 Example: FTx.Ver.3.0.3.tpack

Versioning Scheme

  • FTx.Ver.x.x.x-rc (e.g. 2.1.0-rc.7) – Release Candidate: evaluation version, still in the stabilization phase.
  • FTx.Ver.x.x.x (e.g. 2.1.4) – Stable Release: factory-used and publicly available for OTA updates.

Image Details

  • .e.xim – Initial, deprecated DFU image type (used for firmware older than 1.1.0-rc.1).
  • .wmi.e.xim – Introduced from 1.1.0-rc.1. Contains additional metadata (image type, version, hardware support, etc.). Protects devices from being upgraded to unsupported versions.
  • .tpack – Support introduced from 2.0.0-rc.1. Includes additional packages for CAN, BLE, and MCU firmware updates.

Update Routes

Updating devices sometimes requires intermediate steps.

  • From 0.40.31.5.1 → must use .e.xim image type.
  • From 1.5.12.1.4 → must use .wmi.e.xim image type.
  • From 2.1.43.0.3 → must use .tpack image type.

Examples

  • Upgrading from 0.40.3 to 2.1.4:
  1. Update first to 1.5.1 (enables usage of .wmi.e.xim image type).
  2. Then update to 2.1.4 using .wmi.e.xim.
  • Upgrading from 0.40.3 to 3.0.3:
  1. Update first to 1.5.1.
  2. Then update to 2.1.4. (enables usage of .tpack image type).
  3. Finally, update to 3.0.3 using .tpack.

Downgrade Policy

  • Downgrades from 1.x.x0.x.x are forbidden
  • Downgrades from 2.x.x1.x.x or 0.x.x are forbidden

Hardware Support

Some hardware versions are deprecated and not supported by newer firmware.

Please always verify device compatibility in the Firmware Versions Table.

If unsure, contact your Sales Manager or Support via HelpDesk System.

Recommended Versions

To find the correct recommended version for your device, refer to our wiki page: → Firmware Versions

Image File Distribution Policy

  • Stable firmware images are currently distributed only via FOTAWEB platform.
  • Once a stable release is available, you can perform updates over-the-air (OTA).
  • If OTA update is not viable option (e.g., restricted connectivity), please contact your Sales Manager or Support via HelpDesk System for further assistance.