Revision as of 11:58, 18 September 2025

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. Firmware bundle includes additional packages for CAN, BLE, and MCU firmware 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, stable firmware version 3.0.3 is not distributed directly to client FOTAWEB accounts. Initial firmware updates to version 3.0.3 will be performed and supervised by our Support team. To have devices in your fleet updated, please contact your Sales Manager or submit a request directly through the HelpDesk system.
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.

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.3 → must use .tpack image type.

Examples

Upgrading from 0.40.3 to 2.1.4:

Update first to 1.5.3 (using .e.xim, after succesful update device is enabled to use .wmi.e.xim image type).
Then update to 2.1.4 (using .wmi.e.xim)

Upgrading from 0.40.3 to 3.0.3:

Update first to 1.5.3.
Then update to 2.1.4. (using .wmi.e.xim, after succesful update device is enabled to use .tpack image type).
Finally, update to 3.0.3 (using .tpack).

Note: It is not possible to assign "Upload Firmware bundle" 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

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

@@ Line 3: / Line 3: @@
 == Introduction ==
 The '''Device Firmware Update (DFU)''' feature enables FT platform devices to update their firmware either:
-* '''Over-the-air (OTA)''' via FOTAWEB
+* '''Over-the-air (OTA)''' via [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB''']
 * '''Locally''' through a USB connection using TCT (Teltonika Configuration Tool)
@@ Line 29: / Line 29: @@
 == Image File Distribution Policy ==
 * Stable firmware image types such as <code>1.5.3</code> and <code>2.1.4</code> are currently distributed only via the [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB'''] platform
-* Due to the introduction of a new image type, stable firmware version <code>3.0.3</code> is not distributed directly to client '''FOTAWEB''' accounts.Initial firmware updates to version <code>3.0.3</code> will be performed and supervised by our '''Support''' team. To have devices in your fleet updated, please contact your '''Sales Manager''' or submit a request directly through the '''HelpDesk''' system.
+* Due to the introduction of a new image type, stable firmware version <code>3.0.3</code> is not distributed directly to client [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB'''] accounts. Initial firmware updates to version <code>3.0.3</code> will be performed and supervised by our '''Support''' team. To have devices in your fleet updated, please contact your '''Sales Manager''' or submit a request directly through the '''HelpDesk''' system.
 * 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.
 == Update Routes ==
-Updating devices from specific versions requires intermediate steps. If they are not followed update tasks in '''FOTAWEB''' will fail.
+Updating devices from specific versions requires intermediate steps. If they are not followed update tasks in [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB'''] will fail.
 * From <code>0.40.3</code> → <code>1.5.3</code> → must use '''.e.xim''' image type.
@@ Line 42: / Line 42: @@
 === Examples ===
 * Upgrading from '''0.40.3 to 2.1.4''':
-# Update first to <code>1.5.3</code> (using e.xim, enables usage of .wmi.e.xim image type).
+# Update first to <code>1.5.3</code> (using '''.e.xim''', after succesful update device is enabled to use '''.wmi.e.xim''' image type).
-# Then update to <code>2.1.4</code> (using .wmi.e.xim)
+# Then update to <code>2.1.4</code> (using '''.wmi.e.xim''')
 * Upgrading from '''0.40.3 to 3.0.3''':
 # Update first to <code>1.5.3</code>.
-# Then update to <code>2.1.4</code>. (sing .wmi.e.xim, enables usage of .tpack image type).
+# Then update to <code>2.1.4</code>. (using '''.wmi.e.xim''', after succesful update device is enabled to use '''.tpack''' image type).
-# Finally, update to <code>3.0.3</code> (using .tpack).
+# Finally, update to <code>3.0.3</code> (using '''.tpack''').
-Note: It is possible to update devices usng .tpack only if they have connected to FOTAWEB previously.
+Note: It is not possible to assign "Upload Firmware bundle" tasks for device, which has never connected to [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB''']. Device must first connect to [https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTAWEB'''] to report if already supports '''.tpack''' solution.
 == Downgrade Policy ==