Jump to content

Device Firmware Update: Difference between revisions

No edit summary
 
(7 intermediate revisions by 2 users not shown)
Line 16: Line 16:
   Example: <code>FTx.Ver.1.5.0-rc.9.wmi.e.xim</code>
   Example: <code>FTx.Ver.1.5.0-rc.9.wmi.e.xim</code>
* FTx.Ver.x.x.x-rc.x'''.tpack''' / FTx.Ver.x.x.x'''.tpack'''   
* FTx.Ver.x.x.x-rc.x'''.tpack''' / FTx.Ver.x.x.x'''.tpack'''   
   Example: <code>FTx.Ver.3.0.3.tpack</code>
   Example: <code>FTx.Ver.3.0.7.tpack</code>


=== Versioning Scheme ===
=== Versioning Scheme ===
Line 29: Line 29:
== Image File Distribution Policy ==
== 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
* 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 [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.
* Due to the introduction of a new image type, stable firmware version <code>3.0.7</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.7</code> will be performed and supervised by our '''Support''' team, as the process requires multiple file transfer verification steps. To have devices in your fleet updated, please contact your '''Sales Manager''' or submit a request directly through the '''Partner Portal/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 Partner Portal/HelpDesk System for further assistance.
* 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 ==
== Update Routes ==
Line 38: Line 37:
* From <code>0.40.3</code> → <code>1.5.3</code> → must use '''.e.xim''' image type.
* From <code>0.40.3</code> → <code>1.5.3</code> → must use '''.e.xim''' image type.
* From <code>1.5.3</code> → <code>2.1.4</code> → must use '''.wmi.e.xim''' image type.  
* From <code>1.5.3</code> → <code>2.1.4</code> → must use '''.wmi.e.xim''' image type.  
* From <code>2.1.4</code> → <code>3.0.3</code> → must use '''.tpack''' image type.
* From <code>2.1.4</code> → <code>3.0.7</code> → must use '''.tpack''' image type.


'''Note:''' FTC921 devices use a different MCU compared to other models.   
'''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:  <code>FTC921.AG3335AT.Ver.2.1.4.wmi.e.xim</code>. <br>  
When updating these devices with '''.wmi.e.xim''' image type, you must select the file:  <code>FTC921.AG3335AT.Ver.2.1.4.wmi.e.xim</code>. <br>  
For all other FT models supported in 2.1.4 updating to firmware version <code>2.1.4</code>, use the file: <code>FTx.Ver.2.1.4.wmi.e.xim</code> instead.
For all other FT models supported in <code>2.1.4</code> select the file:<code>FTx.Ver.2.1.4.wmi.e.xim</code> instead.
Using the wrong file will result in the update task failing.
Using the wrong file will result in the update task failing.
This point does not apply when using .'''.tpack''' solution. All MCU types use the same '''.tpack''' image.
This MCU-specific requirement applies only to '''.wmi.e.xim''' images.
All MCU types use the same '''.tpack''' image for updates


=== Examples ===
=== Examples ===
Line 51: Line 51:
# 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''':
* Upgrading from '''0.40.3 to 3.0.7''':
# Update first to <code>1.5.3</code>.
# Update first to <code>1.5.3</code>.
# Then update to <code>2.1.4</code>. (using '''.wmi.e.xim''', after succesful update device is enabled to use '''.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.7</code> (using '''.tpack''').  


'''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.
'''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.
Line 68: Line 68:
Please always verify device compatibility in the [https://wiki.teltonika-gps.com/view/FTC921_Firmware_Changelog Firmware Versions Table].
Please always verify device compatibility in the [https://wiki.teltonika-gps.com/view/FTC921_Firmware_Changelog Firmware Versions Table].


If unsure, contact your '''Sales Manager''' or '''Support''' via HelpDesk System.
If unsure, contact your '''Sales Manager''' or '''Support''' via Partner Portal/HelpDesk System.


== Recommended Versions ==
== Recommended Versions ==
To find the correct recommended version for your device, refer to our wiki page:   
To find the correct recommended version for your device, refer to our wiki page:   
→ [https://wiki.teltonika-gps.com/view/Firmware_versions Firmware Versions]
→ [https://wiki.teltonika-gps.com/view/Firmware_versions Firmware Versions]