Difference between revisions of "FOTA WEB Devices"

From Wiki Knowledge Base | Teltonika GPS
(96 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
The Device Area is the main area where we can see the devices and all information about them including pending,completed and canceled tasks.
 
 
=='''Device Area'''==
 
  
 
There are the following columns in the general Device area.  
 
There are the following columns in the general Device area.  
  
[[Image:FOTANEWDEVICE1.png|1100px|center]]
+
[[Image:FOTADevice.png|1100px|center]]
{| style="width: 100%;"
+
{| class="wikitable" style="width: 100%;"
 +
|+
 
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''FIELD NAME'''
 
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''FIELD NAME'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''VALUE'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''VALUE'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 
|-
 
|-
| rowspan="2" style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''DESCRIPTION'''
+
| rowspan="2" style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''DESCRIPTION'''<br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Device description |default: -</nowiki>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Not registered | Device name | Not Registered
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Will display device description added by the user.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Until device connects to FOTA for the first time this value shall remain. <br />
 +
|-
 
|-
 
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | default: Not Registered <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Not Registered. Once device registers – it shall display Device’s model (e.g. FMB001) and the data of first-time connection. This field can be edited manually. <br />
 
|+
 
|+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''MODEL'''
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''MODEL''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Device model<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Device model | N/A; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Displays device’s model, e.g. FMB001, FMC130 etc. This field cannot be changed.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Once device is registered – field shall display device’s model, e.g. FMB001, FM3001 etc. This field cannot be changed.
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''FIRMWARE'''
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Device firmware version |default: -</nowiki>
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Once device is seen – field shall display current firmware version. This field is changed only when firmware has been updated and FM device reconnected to FOTA WEB with the new firmware.
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''CONFIGURATION''' <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Current configuration name | default: - </nowiki><br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Field displays configuration file name that has been uploaded via FOTA WEB from '''FILES''' tab. If FM configuration was changed via other means than FOTA WEB – this field shall not be updated.<br />
 
'''Note:''' if a configuration was downloaded from the device – it’s name shall be displayed.
 
 
 
'''Note:''' From 2022-02-01, if the device was sent from manufacturing with custom client configuration, the name of the configuration will have the following structure '''''GCFXXX_YYYYMMDDHHMM''''' where:
 
 
 
* '''''XXX'''''  - shows the internal manufacturing identification number
 
* '''''YYYYMMDDHHMM'''''  - date and time configuration file was uploaded to manufacturing.
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''IMEI''' <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Device’s IMEI<br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Field displays device’s IMEI. <br />
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Status''' <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:grey">'''Inactive'''</span> <br /> <span style="color:orange">'''Offline'''</span> <br /> <span style="color:green">'''Online'''</span><br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:grey">'''Inactive'''</span> - not activated or already decomissioned <br /> <span style="color:orange">'''Offline'''</span> - seen at is more than 24h ago <br /> <span style="color:green">'''Online'''</span> - seen at is less than 24h ago <br />
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Task queue''' <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:grey">'''Empty'''</span> <br /> <span style="color:indigo">'''Pending'''</span> <br /> <span style="color:#0066CC">'''Executing'''</span>
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<span style="color:grey">'''Empty'''</span> - no task in a queue <br /> <span style="color:indigo">'''Pending'''</span> - created task is awaiting execution<br /><span style="color:#0066CC">'''Executing'''</span> - created task is being executed <br />
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''SERIAL NO.''' <br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Device’s S/N<br />
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Field displays device’s Serial number.<br />
 
|-
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''GSM NUMBER'''
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |GSM number (MSISDN) of the SIM card installed in the device
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Note:''' The GSM number is shown in FOTA WEB for all devices that had the SIM card is installed during the device manufacturing process (eSIM or regular SIM) after May 3rd, 2022.
 
Previously manufactured devices might not have the GSM number available in FOTA WEB.
 
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''ICCID'''
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''FIRMWARE''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |ICCID of the SIM card that is installed in the device
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Current Device firmware | New device firmware | N/A; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Note:''' The SIM card IMSI is shown in FOTA WEB for all devices that had the SIM card is installed during the device manufacturing process (eSIM or regular SIM) after May 3rd, 2022.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Once device is registered – field shall display current firmware version. This field is changed only when:
Previously manufactured devices might not have the ICCID number available in FOTA WEB.
+
- firmware update is Pending or in Progress;<br />
 +
- when firmware has been updated and FM device reconnected to FOTA with the new firmware.
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''IMSI'''
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''CONFIGURATION''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |IMSI number of the SIM card that is installed in the device
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Current configuration name | N/A; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Note:''' The SIM card IMSI is shown in FOTA WEB for all devices that had the SIM card is installed during the device manufacturing process (eSIM or regular SIM) after May 3rd, 2022.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Field displays configuration filename that has been uploaded via FOTA from '''FILES''' tab. If FM configuration was changed via other means than FOTA – this field shall not be updated.<br />
Previously manufactured devices might not have the IMSI number available in FOTA WEB.
+
'''Note:''' if configuration was downloaded from device to FOTA – it’s name shall be displayed.
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''PRODUCT CODE'''
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''IMEI''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Manufacturing code of the device
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Device’s IMEI | N/A; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Internal manufacturing code, that shows the device hardware/firmware configuration.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Once device is registered – field shall display device’s IMEI. <br />
 
 
'''Note:''' All devices manufactured '''after''' 2022, May 3rd will have the product code displayed in FOTA WEB - devices manufactured before this date, might not have the product code in FOTA WEB.
 
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''COMPANY''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''SERIAL NO.''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Device’s Company <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Device’s S/N | N/A; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This field shall always show which company device belongs to directly. Higher level companies shall not be displayed in this field. <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Once device is registered – field shall display device’s Serial number <br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''GROUP'''<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''COMPANY''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Device’s Group<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Device’s Company <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |If device is assigned to a group, this field displays group name device is assigned to.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This field shall always show which company device belongs to directly. Higher level companies shall not be displayed in this field. <br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''UPDATED AT'''<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''LAST INITIATOR''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |String; default: N/A <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | SMS | FOTA | FOTA <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This field shows the last time device information has changed.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This field explains which method was used to initiate your last device configuration.<br />
 +
- SMS – this means that device last time was configured using SMS commands.<br />
 +
- FOTA – this means that last time device was configured using FOTA. <br />
 +
- FOTA – this means that last time device was configured using FOTA. <br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''SEEN AT'''<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''LAST LOGIN''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |String; default: N/A <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | String; default: N/A <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This field shows the last time device connected to FOTA WEB web.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This field shows when device connected to FOTA the last time. <br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''CREATED AT'''<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''INFO ICON (i)''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |String; default: N/A <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | - <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This field shows the time device was added to the FOTA WEB web system.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Redirects user to detailed information about device’s activity. <br />
 
|}
 
|}
 +
<br />
 +
=='''Actions'''==
  
===Device Information===
+
The '''ACTIONS''' drop down menu button is the main tool for all possible actions (tasks) with devices. Successful action results in a [[Devices#View Tasks|'''queued job''']].
  
By clicking on a device we can see the displayed information about the selected device.
+
[[Image:Aktions.png|1100px|center]]
  
[[Image:Device_Information.png|800px|left]]<br>
+
This chapter provides an explanation of what each dropdown menu item does and how to use it.
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
  
=='''Create Task'''==
+
{| class="wikitable" style="width: 100%;"
 
+
|+
The '''Create Task''' pop up menu button is the main tool for all possible actions (tasks) with devices. Successful action results in a [[FOTA WEB Devices#View Tasks|'''queued job''']].
+
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''FIELD NAME'''
 
+
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''ACTION'''
[[Image:FOTATaskCreate.png|500px|left]]<br>
+
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
<br>
+
|-
<br>This chapter provides an explanation of what each dropdown menu item does and how to use it. There is 4 possible filtering from the beginning to assign your tasks.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Import Device Description''' <br />
1. For the manually '''selected devices'''.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Upload .csv file | Select First Field <br />
2. For the '''filtered devices'''.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | You can import a list of device '''Descriptions''', that are mapped to '''IMEIs''' or '''S/Ns'''. <br />
3. For the devices '''from .csv file'''.<br />
+
Selecting '''First Field''' determines before mentioned mapping.<br />
4. For '''all devices'''.<br />
+
You can download a demo reference .csv file to help you generate your own list.<br />
 
+
|-
[[Image:FOTACreateTask.png|400px|alt=|left]]
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Assign Devices''' <br />
<br>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Devices .csv list | Select Identifier | Company name | Group (optional) <br />
<br>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | You can assign devices to your Child companies, re-assign between different Child companies, or bring devices to your own company with '''Assign Devices''' function. <br />
<br>
+
'''Select Identifier''' has to be chosen depending on whether you shall use '''IMEIs''' or '''S/Ns''' to make this action.<br />
<br>
+
'''Company Name''' determines which Company shall receive devices from .csv list.<br />
<br>
+
You can download a demo reference .csv file to help you generate your own list.<br />
<br>
+
'''Group''' option appears only after a '''Company''' is selected.
<br>
+
|-
<br>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Assign to company''' <br />
<br>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Company Name <br />
<br>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This function '''assigns''' devices that were selected from '''Device list''' one-by-one or by using '''Filter'''.<br />
<br>
+
Select '''Company Name''' that these devices should be assigned to.<br />
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
 
 
=== Cancel task ===
 
 
 
By selecting the required device and opening the detailed information you can also cancel the task. Only tasks in the statuses "Pending" and "Running" can be cancelled
 
 
 
[[Image:Cancel task.png|400px|alt=|left]]
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
 
 
 
 
=== Task Types ===
 
 
 
General information about tasks and task types.
 
 
 
{| class="sortable" style="width: 100%;"
 
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''FIELD NAME'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''ACTION'''
 
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''DESCRIPTION'''
 
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Update firmware''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Assign to group''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Update selected firmware version | Select File | Create </nowiki><br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Group Name <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |You can Upload the required firmware version over the '''Files menu''' or over the same pop up windown while selecting the task, if you have the firmware uploaded already, task can be assigned by selecting required firmware version.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This function '''assigns''' devices that were selected from '''Device list''' one-by-one or by using '''Filter'''.<br />
If there is no available firmware versions for the update, please press on '''Upload new file''' button to add the file on the same pop up window.<br />
+
Select '''Group Name''' that these devices should be assigned to.<br />
 +
<br />
 +
'''NOTE:''' a '''Group''' must be created first in '''Groups''' menu.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Update configuration''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Assign firmware''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Update selected configuration | Select File | Create </nowiki><br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Firmware Name <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |You can Upload the required configuration over the '''Files menu''' or over the same pop up windown while selecting the task, if you have the firmware uploaded already, task can be created by selecting required configuration file.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Assign a firmware upgrade job to a single or many devices. The next time FM device connects to FOTA – it shall start firmware upgrade procedure.<br />
If there is no available configuration versions for the update, please press on '''Upload new file''' button to add the file on the same pop up window.<br />
+
Firmware selection dropdown menu is populated by assigning Firmware via '''Files''' menu.<br />
 +
<br />
 +
'''NOTE:''' if any of selected devices have already '''Pending''' firmware upgrade tasks – those previous tasks shall be overwritten.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Receive configuration''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Assign configuration''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Receive configuration | Create </nowiki><br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Configuration  name <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This function assigns a Download configuration job to device. Next time it connects to FOTA WEB – selected files shall be downloaded.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Assign a configuration upgrade job to a single or many devices. The next time FM device connects to FOTA – it shall start configuration upgrade procedure.<br />
 +
Configuration selection dropdown menu is populated by assigning Firmware via '''Files''' menu.<br />
 +
<br />
 +
'''NOTE''': If any of selected devices have already '''Pending''' configuration upgrade tasks – those previous tasks shall be overwritten.<br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Receive internal log''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Download from device''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<nowiki>Receive internal log | Create </nowiki><br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Configuration file | Black box file | Continuous log files <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |This function assigns a Download logs job to device. Next time it connects to FOTA WEB – selected files shall be downloaded.<br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This function assigns a '''Download''' job to FMB device. Next time it connects to FOTA – selected files shall be downloaded.<br />
 
'''NOTE:''' Continuous log lets you select number of files to be downloaded. Newest log files, that are stored in device’s memory, are taken first. <br />
 
'''NOTE:''' Continuous log lets you select number of files to be downloaded. Newest log files, that are stored in device’s memory, are taken first. <br />
 +
'''NOTE 2:''' Continuous log can be read only by Teltonika’s team, while blackbox log IS displayed in the device details (i) menu BLACKBOXES tab. <br />
 +
'''NOTE 3:''' Continuous log cannot be downloaded by '''user''' role. For more – see [[Company and User role structure#USER ROLES|'''USER ROLES''']]. <br />
 
|-
 
|-
|'''Send TLS file'''
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Cancel actions''' <br />
|<nowiki>Transfer user TLS certificate | Select File | Create </nowiki>
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |-
|You can Upload the required TLS certificate over the '''Files menu''' or over the same pop up window while selecting the task, if you have the TLS certificate uploaded already, task can be created by selecting required TLS certificate.<br />If there is no available TLS certificates, please press on '''Upload new file''' button to add the certificate on the same pop up window.
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Cancels all pending jobs. <br />
[[File:Alert.png|left|link=]]
 
<br>  
 
Task type is only supported by devices with '''Firmware version newer than 03.28.01''', otherwise FOTA WEB will not allow to upload certificate to device and error that feature is not supported will be shown.
 
 
|}
 
|}
  
=== Scheduled tasks ===
 
The "Schedule time" feature allows users to select the time, when the created task can be executed.
 
  
[[File:FOTASchedule1.png|alt=|frameless|600x600px]]
 
  
Time range can be selected in 30 minute periods, but it cannot be less than 2 hours - for example, user can select a task time from 8:30 to 15:00.
+
=='''View Tasks'''==
  
With the time range set for the task, the device will only execute the task, if it connects to FOTA WEB during set hours.
+
This menu provides an opportunity to observe the status of a TASK. <br />
  
'''NOTE:''' The time is selected in the user's time zone.
+
Tasks are successfully '''queued job''', meaning that there was no error parsing user’s request to make an [[Devices#Actions|'''ACTION''']]. <br />
  
'''NOTE:''' The scheduling feature does '''not''' adjust the time of the device connection to FOTA WEB - the user has to ensure, that the device has the correct connection frequency configured, so the device would connect to FOTA WEB during the set time range. Otherwise, the device will not execute the task.  
+
If there are multiple jobs assigned for a single device – FOTA shall execute them one by one. Each time a job is completed FM shall reconnect to FOTA immediately and if another job is awaiting – attempt to complete it.<br />
  
FOTA WEB connection frequency configuration is described here: [[FMB920 GPRS settings#FOTA%20WEB%20Settings|FOTA WEB Settings]]
+
The order of job execution is as follows:<br />
  
=='''Move'''==
+
1. Blackbox log <br />
 +
2. Continuous log <br />
 +
3. Firmware upgrade <br />
 +
4. Configuration download <br />
 +
5. Configuration upgrade <br />
  
This function assigns devices from the Device list.
+
Meaning, that if you set all 5 jobs – the device will first upload BlackBox log, then continuous log and only on 3rd reconnect to FOTA the firmware shall be upgraded.<br />
  
There are 4 possible filtering options for this function..<br />1. For the manually '''selected devices'''.<br />2. For the '''filtered devices'''.<br />3. For the devices '''from .csv file''' (IMEI or Serial No. can be used as identifier).<br />4. For '''all devices'''.<br />
+
Relevant possible error’s that you may encounter after creating a task<br />
  
Select '''Company''' or '''Group''' name that these devices should be assigned to.<br />
+
{| class="wikitable" style="width: 100%;"
'''NOTE:''' a '''Group''' must be created first in '''Groups''' menu.<br />
+
|+
 +
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''TASK'''
 +
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''ERROR'''
 +
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Config assignment''' <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Configuration file mismatch device's platform. <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Configuration file is not applicable to this type of device model. Select config file that works on this particular device, e.g. FMB64 config for FMB64 device model. <br />
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''Firmware''' <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Firmware file does not exist or information about firmware is missing. Please re-upload firmware file. <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Re-upload the firmware and try again. Should error remain – contact us (your Sales representative) for assistance. <br />
 +
|}
  
[[Image:FOTAMove.png|600px|left]]<br>
+
In an unlikely event, any other type of error would appear – it should be reported back to us.<br />
<br>
 
<br>
 
<br />
 
=='''Import'''==
 
 
 
This function is used to '''Import''' device attributes from the supported '''.csv''' file.
 
There are 4 possible attributes that can be imported using this function.<br />
 
1. Description<br />
 
2. GSM Number<br />
 
3. ICCID<br />
 
4. IMSI<br />
 
<br />
 
'''NOTE:''' File syntax is as follows: IMEI, Attribute value.
 
 
 
[[File:Import new.png|frameless]]
 
 
 
=='''Export'''==
 
 
 
This function is used to '''Export''' devices to the required '''.csv''' or '''.xlsx''' files.
 
There are 4 possible filtering options for this function.<br />
 
1. For the manually '''selected devices'''.<br />
 
2. For the '''filtered devices'''.<br />
 
3. For the devices '''from .csv file''' (IMEI or Serial No. can be used as identifier).<br />
 
4. For '''all devices'''.<br />
 
[[File:Export new.png|frameless]]
 
 
 
=='''Device transfer'''==
 
 
 
This function is used to '''transfer devices''' between unrelated companies.
 
 
 
[[File:Transfer new.png|frameless]]
 
  
<br>
+
=='''Filter'''==
"Device transfer" function operation principle: <br />
 
1. Company A (Device receiving company) generates a transfer token by selecting "Receive devices" tab and clicking on the "Create button". Generated token will be visible in the following window.<div style="width: 1000px; height: 250px;">
 
{{{insert1|[[Image:FotaDeviceTransfer.png|550x270px|left|frameless]]}}}{{{insert2|[[Image:FotaDeviceToken.png|550x270px|right|frameless]]}}}
 
</div>
 
 
 
<br />
 
 
 
'''NOTE:''' The token is single-use and expires in 21 days. Send this token to the person responsible for transferring devices from their company to yours.
 
 
 
2. Company A provides token to Company B (Device sending company) <br />
 
3. Company B opens the Device transfer window, Transfer devices tab, and selects the preferred device source (Selected, Filtered or From file). <br />
 
4. Company B enters the transfer token and clicks on the "Transfer" button to transfer selected devices to the "Receiving company"<br />
 
 
 
<div style="width: 1000px; height: 380px;">
 
[[Image:FotaDeviceTransfer2.png|500px|left]]<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>
 
<br>If all steps were correctly done, device/devices will be transferred to the receiving company, and both companies will receive an e-mail regarding the successful device transfer.
 
</div>
 
=='''Search'''==
 
 
 
This function is used to search for a device.<br>
 
 
 
You can search for devices by using the:<br>
 
1. IMEI.<br>
 
2. Description.<br>
 
3. Serial Number.<br>
 
 
 
==='''Status'''===
 
 
 
This function is used to search for devices with the specific chosen status.<br />
 
 
 
You can choose the devices that have this status:<br />
 
1. Inactive.<br />
 
2. Offline.<br />
 
3. Online. <br />
 
 
 
==='''Filter'''===
 
  
 
Filter is designed to both: (1) filter out a list of devices based on combinations of parameters, (2) and to make bulk ACTIONS.<br />
 
Filter is designed to both: (1) filter out a list of devices based on combinations of parameters, (2) and to make bulk ACTIONS.<br />
Line 312: Line 172:
 
You can select/filter devices by:<br />
 
You can select/filter devices by:<br />
  
 +
*Company<br />
 
*Group<br />
 
*Group<br />
 
*Device Model<br />
 
*Device Model<br />
 
*Firmware version<br />
 
*Firmware version<br />
*Configuration version<br />
 
 
*Job status<br />
 
*Job status<br />
  
 
Under '''Active Filters''' section you shall see current filters that have been selected.<br />
 
Under '''Active Filters''' section you shall see current filters that have been selected.<br />
 
Each of the '''Active Filters''' can be removed individually by clicking on a particular filter, or they all can be removed together by clicking '''Reset all'''.<br />
 
Each of the '''Active Filters''' can be removed individually by clicking on a particular filter, or they all can be removed together by clicking '''Reset all'''.<br />
'''Active Filters''' shall maintain current configuration until manually Reset, meaning that navigating through various FOTA WEB menu’s '''Active Filters''' shall remain as last configured.<br />
+
'''Active Filters''' shall maintain current configuration until manually Reset, meaning that navigating through various FOTA menu’s '''Active Filters''' shall remain as last configured.<br />
  
===='''Bulk assignment'''====
+
==='''Bulk assignment'''===
  
 
Once '''Active Filters''' section has any number of parameters, the '''ACTIONS''' dropdown button automatically displays how many devices have been filtered. It allows to assign jobs to all selected devices.<br />
 
Once '''Active Filters''' section has any number of parameters, the '''ACTIONS''' dropdown button automatically displays how many devices have been filtered. It allows to assign jobs to all selected devices.<br />
  
Example for the device filtering window is showed below, where FMB120 model selected.
+
In the example below, you can see 119590 devices being filtered.
[[Image:FotaFilter.png|1100px|center]]<br />
+
[[Image:BULK.png|1100px|center]]<br />
 
 
Clicking on '''Create task''' and then selecting a task from filtering, say Firmware upgrade, would assign a Firmware upgrade job to selected devices.<br />
 
 
 
==='''Table View'''===
 
This function allows you to manage the amount and what kind of information will be displayed in the table.<br />
 
 
 
Table view has two options:<br />
 
1. Select columns to show.<br />
 
2. Rows count per page.<br />
 
 
 
===='''Columns view'''====
 
 
 
This function allows you to filter out what kind of information to be shown about the device.<br />
 
 
 
===='''Rows per page'''====
 
 
 
This function defines the amount of rows that will be shown.<br />
 
 
 
=='''View Tasks'''==
 
 
 
This menu provides an opportunity to observe the status of a TASK. <br />
 
 
 
Tasks are successfully '''queued job''', meaning that there was no error parsing user’s request to make an [[FOTA WEB Devices#Create task|'''Create Task''']]. <br />
 
  
If there are multiple jobs assigned for a single device – FOTA WEB shall execute them one by one. Each time a job is completed FM shall reconnect to FOTA WEB immediately and if another job is awaiting – attempt to complete it.<br />
+
Clicking on '''ACTIONS''' and then selecting a task, say Firmware upgrade, would assign a Firmware upgrade job to 119590 devices.<br />
  
The order of job execution is as follows:<br />
+
=='''Device details'''==
  
1. Upload FW to the device <br />
+
This chapter is an overview of the device details (i) menu. It provides additional detailed information about each device. To access it click on (i) icon on the right of device’s table.<br />
2. Upload CFG to the device <br />
 
3. Download LOGS from the device <br />
 
4. Download CFG from the device <br />
 
  
Meaning, that if you set all 4 jobs – the device will first upload firmware file, then configuration file and only on 3rd reconnect to FOTA WEB the logs shall be taken.<br />
+
[[Image:Alone.png|1100px|center]]<br />
 
 
Relevant possible error’s that you may encounter after creating a task<br />
 
  
 
{| class="wikitable" style="width: 100%;"
 
{| class="wikitable" style="width: 100%;"
 
|+
 
|+
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''TASK'''
+
! style="width: 20%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''FIELD NAME'''
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''ERROR'''
+
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''VALUE'''
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |'''DESCRIPTION'''
+
! style="width: 40%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | '''DESCRIPTION'''
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Config assignment''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''SYSTEM LOGS''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Configuration file mismatch device's platform. <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Information about device’s activities <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Configuration file is not applicable to this type of device model. Select config file that works on this particular device, e.g. FMB64 config for FMB64 device model. <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | More info soon... <br />
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |'''Firmware''' <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''CONT. LOGS''' <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Firmware file does not exist or information about firmware is missing. Please re-upload firmware file. <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Downloaded files <br />
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Re-upload the firmware and try again. Should error remain – contact us (your Sales representative) for assistance. <br />
+
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This section shows which Continuous logs downloads from device.<br />
 +
'''Continuous logs''' can be read only by Teltonika engineers.<br />
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''CONFIGURATIONS''' <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Downloaded configuration files  <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This section displays '''Configuration files''' that were downloaded from this device.<br />
 +
|-
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | '''BLACKBOXES''' <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Downloaded blackboxes  <br />
 +
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | This section displays '''Blackboxes''' that were downloaded from this device.<br />
 +
Blackbox file can be viewed directly within FOTA interface, as well as downloaded while in the viewind menu.<br />
 
|}
 
|}
  
In an unlikely event, any other type of error would appear – it should be reported back to us.<br />
 
 
 
{|style="width:100%;"
 
|-
 
|[https://wiki.teltonika-gps.com/view/Dashboard '''Dashboard'''] - Previous page
 
|style="text-align:right;| Next page - [https://wiki.teltonika-gps.com/view/Task_Groups '''Task Groups''']
 
|}
 
  
 +
Next chapter [[Users v2|'''Users''']]
  
[[Category:FOTA WEB]]
+
[[Category:FOTA]]

Revision as of 16:12, 29 January 2021

Main Page > Software & Applications > FOTA WEB > FOTA WEB Devices

There are the following columns in the general Device area.

FOTADevice.png
FIELD NAME VALUE DESCRIPTION
DESCRIPTION
Not registered | Device name | Not Registered Until device connects to FOTA for the first time this value shall remain.
default: Not Registered
Not Registered. Once device registers – it shall display Device’s model (e.g. FMB001) and the data of first-time connection. This field can be edited manually.
MODEL
Device model | N/A; default: N/A
Once device is registered – field shall display device’s model, e.g. FMB001, FM3001 etc. This field cannot be changed.
FIRMWARE
Current Device firmware | New device firmware | N/A; default: N/A
Once device is registered – field shall display current firmware version. This field is changed only when:

- firmware update is Pending or in Progress;
- when firmware has been updated and FM device reconnected to FOTA with the new firmware.

CONFIGURATION
Current configuration name | N/A; default: N/A
Field displays configuration filename that has been uploaded via FOTA from FILES tab. If FM configuration was changed via other means than FOTA – this field shall not be updated.

Note: if configuration was downloaded from device to FOTA – it’s name shall be displayed.

IMEI
Device’s IMEI | N/A; default: N/A
Once device is registered – field shall display device’s IMEI.
SERIAL NO.
Device’s S/N | N/A; default: N/A
Once device is registered – field shall display device’s Serial number
COMPANY
Device’s Company
This field shall always show which company device belongs to directly. Higher level companies shall not be displayed in this field.
LAST INITIATOR
SMS | FOTA | FOTA
This field explains which method was used to initiate your last device configuration.

- SMS – this means that device last time was configured using SMS commands.
- FOTA – this means that last time device was configured using FOTA.
- FOTA – this means that last time device was configured using FOTA.

LAST LOGIN
String; default: N/A
This field shows when device connected to FOTA the last time.
INFO ICON (i)
-
Redirects user to detailed information about device’s activity.


Actions

The ACTIONS drop down menu button is the main tool for all possible actions (tasks) with devices. Successful action results in a queued job.

Aktions.png

This chapter provides an explanation of what each dropdown menu item does and how to use it.

FIELD NAME ACTION DESCRIPTION
Import Device Description
Upload .csv file | Select First Field
You can import a list of device Descriptions, that are mapped to IMEIs or S/Ns.

Selecting First Field determines before mentioned mapping.
You can download a demo reference .csv file to help you generate your own list.

Assign Devices
Devices .csv list | Select Identifier | Company name | Group (optional)
You can assign devices to your Child companies, re-assign between different Child companies, or bring devices to your own company with Assign Devices function.

Select Identifier has to be chosen depending on whether you shall use IMEIs or S/Ns to make this action.
Company Name determines which Company shall receive devices from .csv list.
You can download a demo reference .csv file to help you generate your own list.
Group option appears only after a Company is selected.

Assign to company
Company Name
This function assigns devices that were selected from Device list one-by-one or by using Filter.

Select Company Name that these devices should be assigned to.

Assign to group
Group Name
This function assigns devices that were selected from Device list one-by-one or by using Filter.

Select Group Name that these devices should be assigned to.

NOTE: a Group must be created first in Groups menu.

Assign firmware
Firmware Name
Assign a firmware upgrade job to a single or many devices. The next time FM device connects to FOTA – it shall start firmware upgrade procedure.

Firmware selection dropdown menu is populated by assigning Firmware via Files menu.

NOTE: if any of selected devices have already Pending firmware upgrade tasks – those previous tasks shall be overwritten.

Assign configuration
Configuration name
Assign a configuration upgrade job to a single or many devices. The next time FM device connects to FOTA – it shall start configuration upgrade procedure.

Configuration selection dropdown menu is populated by assigning Firmware via Files menu.

NOTE: If any of selected devices have already Pending configuration upgrade tasks – those previous tasks shall be overwritten.

Download from device
Configuration file | Black box file | Continuous log files
This function assigns a Download job to FMB device. Next time it connects to FOTA – selected files shall be downloaded.

NOTE: Continuous log lets you select number of files to be downloaded. Newest log files, that are stored in device’s memory, are taken first.
NOTE 2: Continuous log can be read only by Teltonika’s team, while blackbox log IS displayed in the device details (i) menu BLACKBOXES tab.
NOTE 3: Continuous log cannot be downloaded by user role. For more – see USER ROLES.

Cancel actions
- Cancels all pending jobs.


View Tasks

This menu provides an opportunity to observe the status of a TASK.

Tasks are successfully queued job, meaning that there was no error parsing user’s request to make an ACTION.

If there are multiple jobs assigned for a single device – FOTA shall execute them one by one. Each time a job is completed FM shall reconnect to FOTA immediately and if another job is awaiting – attempt to complete it.

The order of job execution is as follows:

1. Blackbox log
2. Continuous log
3. Firmware upgrade
4. Configuration download
5. Configuration upgrade

Meaning, that if you set all 5 jobs – the device will first upload BlackBox log, then continuous log and only on 3rd reconnect to FOTA the firmware shall be upgraded.

Relevant possible error’s that you may encounter after creating a task

TASK ERROR DESCRIPTION
Config assignment
Configuration file mismatch device's platform.
Configuration file is not applicable to this type of device model. Select config file that works on this particular device, e.g. FMB64 config for FMB64 device model.
Firmware
Firmware file does not exist or information about firmware is missing. Please re-upload firmware file.
Re-upload the firmware and try again. Should error remain – contact us (your Sales representative) for assistance.

In an unlikely event, any other type of error would appear – it should be reported back to us.

Filter

Filter is designed to both: (1) filter out a list of devices based on combinations of parameters, (2) and to make bulk ACTIONS.

You can select/filter devices by:

  • Company
  • Group
  • Device Model
  • Firmware version
  • Job status

Under Active Filters section you shall see current filters that have been selected.
Each of the Active Filters can be removed individually by clicking on a particular filter, or they all can be removed together by clicking Reset all.
Active Filters shall maintain current configuration until manually Reset, meaning that navigating through various FOTA menu’s Active Filters shall remain as last configured.

Bulk assignment

Once Active Filters section has any number of parameters, the ACTIONS dropdown button automatically displays how many devices have been filtered. It allows to assign jobs to all selected devices.

In the example below, you can see 119590 devices being filtered.

BULK.png


Clicking on ACTIONS and then selecting a task, say Firmware upgrade, would assign a Firmware upgrade job to 119590 devices.

Device details

This chapter is an overview of the device details (i) menu. It provides additional detailed information about each device. To access it click on (i) icon on the right of device’s table.

Alone.png


FIELD NAME VALUE DESCRIPTION
SYSTEM LOGS
Information about device’s activities
More info soon...
CONT. LOGS
Downloaded files
This section shows which Continuous logs downloads from device.

Continuous logs can be read only by Teltonika engineers.

CONFIGURATIONS
Downloaded configuration files
This section displays Configuration files that were downloaded from this device.
BLACKBOXES
Downloaded blackboxes
This section displays Blackboxes that were downloaded from this device.

Blackbox file can be viewed directly within FOTA interface, as well as downloaded while in the viewind menu.


Next chapter Users