Jump to content
  • EN

Device Firmware Update

From Teltonika Telematics Wiki
Revision as of 13:55, 30 March 2026 by Airidas.S (talk | contribs)

(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. To check for recommended versions, please visit Firmware versions page

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.7.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. Firmware bundle includes additional packages for CAN, BLE, and Main MCU application and database updates.

Image File Distribution Policy

  • Stable firmware image types such as 1.5.3 and 2.1.4 are currently distributed only via the FOTAWEB platform.
  • Due to the introduction of a new image type and specific update process, stable firmware versions 3.0.X are not distributed directly to client FOTAWEB accounts. Initial firmware updates to versions 3.0.X will be performed and supervised by our Support team, as the process requires multiple file transfer verification steps a to ensure all components of device are succesfully updated. To have devices in your fleet updated, please contact your Sales Manager or submit a request directly through the Partner Portal/HelpDesk system.
  • If an OTA update is not viable option (e.g., due to restricted connectivity) devices can be still be updated locally by downloading required files from Firmware versions page
  • With the introduction of the new and improved device component update process – FTMFC (FT Multiple File Container), available from 3.7.0-rc.22 version, devices can be updated by users via the FOTAWEB platform using the newly enabled Upload Firmware Bundle Container task type.

Note:

  • Teltonika-recommended stable 3.7.0-rc.22+ version files will be distributed through the FOTAWEB platform and accessible for all users.
  • Direct .tpack file image upload to a specific FOTAWEB company is managed exclusively by Teltonika administrators.

Update Routes

Updating devices from specific versions requires intermediate steps. If they are not followed update tasks in FOTAWEB will fail.

  • From 0.40.3 → 1.5.3 → must use .e.xim image type.
  • From 1.5.3 → 2.1.4 → must use .wmi.e.xim image type.
  • From 2.1.4 → 3.0.X → must use .tpack image type.

Note: FTC921 devices use a different MCU compared to other models. When updating these devices with .wmi.e.xim image type, you must select the file: FTC921.AG3335AT.Ver.2.1.4.wmi.e.xim.
For all other FT models supported in 2.1.4 select the file:FTx.Ver.2.1.4.wmi.e.xim instead. Using the wrong file will result in the update task failing. This MCU-specific requirement applies only to .wmi.e.xim images. All MCU types use the same .tpack image for updates

Examples

  • Upgrading from 0.40.3 to 2.1.4:
  1. Update first to 1.5.3 (using .e.xim, after succesful update device is enabled to use .wmi.e.xim image type).
  2. Then update to 2.1.4 (using .wmi.e.xim)
  • Upgrading from 0.40.3 to 3.0.X:
  1. Update first to 1.5.3.
  2. Then update to 2.1.4. (using .wmi.e.xim, after succesful update device is enabled to use .tpack image type).
  3. Finally, update to 3.0.X (using .tpack).

Note: It is not possible to assign "Upload Firmware Bundle Container" tasks for device, which has never connected to FOTAWEB. Device must first connect to FOTAWEB to report if already supports .tpack solution.

Downgrade Policy

  • Downgrades from 1.x.x → 0.x.x are not allowed
  • Downgrades from 2.x.x → 1.x.x or 0.x.x are not allowed
  • Downgrades from 3.x.x → 2.x.x or 1.x.x or 0.x.x are not allowed
  • Downgrades from 3.7.x → 3.0.x or 2.x.x or 1.x.x or 0.x.x are not allowed

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 Partner Portal/HelpDesk System.

Recommended Versions

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

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Device_Firmware_Update&oldid=112368"