Difference between revisions of "FOTA WEB Devices"
(75 intermediate revisions by 12 users not shown) | |||
Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
− | |||
− | |||
− | |||
There are the following columns in the general Device area. | There are the following columns in the general Device area. | ||
− | [[Image: | + | [[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;" | | + | | 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;" | | + | | 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 | N/A; default: N/A <br /> | |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | 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;" |Once device is | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |''' | + | | 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;" | | + | | 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;" | | + | | 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: |
− | + | - 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;" |''' | + | | 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;" | | + | | 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:''' | + | | 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 /> |
− | + | '''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;" |''' | + | | 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;" | | + | | 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;" | | + | | 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 /> |
− | |||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |''' | + | | 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 | + | | 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;" | | + | | 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;" |''' | + | | 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 | + | | 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;" | | + | | 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;" |''' | + | | 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;" | | + | | 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 | + | | 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;" |''' | + | | 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 | + | | 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;" |''' | + | | 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;" | | + | | 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;" | | + | | 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 /> | ||
− | === | + | =='''Create Task'''== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | The '''Create Task''' pop up menu button is the main tool for all possible actions (tasks) with devices. Successful action results in a [[FOTA Devices#View Tasks|'''queued job''']]. | |
− | + | [[Image:Task.png|1100px|center]] | |
− | + | 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 /> | |
− | |||
− | |||
1. For the manually '''selected devices'''.<br /> | 1. For the manually '''selected devices'''.<br /> | ||
2. For the '''filtered devices'''.<br /> | 2. For the '''filtered devices'''.<br /> | ||
Line 124: | Line 74: | ||
4. For '''all devices'''.<br /> | 4. For '''all devices'''.<br /> | ||
− | [[Image: | + | [[Image:TaskCreation.png|300px|center]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | {| 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: 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''' | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | {| class=" | ||
− | ! 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;" | '''Update firmware''' <br /> |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Update selected firmware version | Select File | Create <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;" | 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 /> |
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 /> | 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 /> | ||
|- | |- | ||
− | | 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;" | '''Update configuration''' <br /> |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Update selected firmware version | Select File | Create <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;" | 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 /> |
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 /> | 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 /> | ||
|- | |- | ||
− | | 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;" | '''Receive configuration''' <br /> |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Receive configuration | Create <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 | + | | 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 – selected files shall be downloaded.<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;" | '''Receive internal log''' <br /> |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | Receive internal log | Create <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 | + | | 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 – 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 [[FOTA Company and User role structure#USER ROLES|'''USER ROLES''']]. <br /> | |
− | |||
− | |||
− | [[ | ||
− | |||
− | |||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=='''Move'''== | =='''Move'''== | ||
− | This function assigns devices from | + | This function assigns devices from Device list. |
− | + | There is 4 possible filtering options for this function..<br /> | |
− | There | + | 1. For the manually '''selected devices'''.<br /> |
+ | 2. For the '''filtered devices'''.<br /> | ||
+ | 3. For the devices '''from .csv file'''.<br /> | ||
+ | 4. For '''all devices'''.<br /> | ||
Select '''Company''' or '''Group''' name that these devices should be assigned to.<br /> | Select '''Company''' or '''Group''' name that these devices should be assigned to.<br /> | ||
'''NOTE:''' a '''Group''' must be created first in '''Groups''' menu.<br /> | '''NOTE:''' a '''Group''' must be created first in '''Groups''' menu.<br /> | ||
− | [[Image: | + | [[Image:MoveFOTA.png|1100px|center]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=='''Export'''== | =='''Export'''== | ||
This function is used to '''Export''' devices to the required '''.csv''' or '''.xlsx''' files. | This function is used to '''Export''' devices to the required '''.csv''' or '''.xlsx''' files. | ||
− | There | + | There is 4 possible filtering options for this function.<br /> |
1. For the manually '''selected devices'''.<br /> | 1. For the manually '''selected devices'''.<br /> | ||
2. For the '''filtered devices'''.<br /> | 2. For the '''filtered devices'''.<br /> | ||
− | 3. For the devices '''from .csv file''' | + | 3. For the devices '''from .csv file'''.<br /> |
4. For '''all devices'''.<br /> | 4. For '''all devices'''.<br /> | ||
− | |||
− | + | [[Image:ExportFOTA.png|1100px|center]] | |
− | + | =='''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 Devices#Create task|'''Create Task''']]. <br /> | |
− | |||
− | |||
− | |||
− | </ | ||
− | <br /> | + | 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 /> |
− | + | The order of job execution is as follows:<br /> | |
− | 2. | + | 1. Upload FW to the device <br /> |
− | 3. | + | 2. Upload CFG to the device <br /> |
− | 4. | + | 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 the logs shall be taken.<br /> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </ | ||
− | |||
− | + | Relevant possible error’s that you may encounter after creating a task<br /> | |
− | + | {| 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: 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 /> | ||
+ | |} | ||
− | + | In an unlikely event, any other type of error would appear – it should be reported back to us.<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 171: | ||
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 /> | ||
Line 317: | Line 177: | ||
*Configuration 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 | + | '''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'''=== | |
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. | Example for the device filtering window is showed below, where FMB120 model selected. | ||
− | [[Image: | + | [[Image:FOTAFilters.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 /> | Clicking on '''Create task''' and then selecting a task from filtering, say Firmware upgrade, would assign a Firmware upgrade job to selected devices.<br /> | ||
− | + | =='''Device details'''== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | This | + | 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 /> |
− | + | [[Image:DeviceDetailsinfo.png|1100px|center]]<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;" |''' | + | ! 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;" |''' | + | ! 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;" |''' | + | | 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;" | | + | | 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;" | | + | | 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;" |''' | + | | 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;" | | + | | 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;" | | + | | 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 /> | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | Next chapter [[Users v2|'''Users''']] | ||
− | [[Category:FOTA | + | [[Category:FOTA]] |
Revision as of 10:26, 1 February 2021
Main Page > Software & Applications > FOTA WEB > FOTA WEB DevicesThere are the following columns in the general Device area.
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; |
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. |
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. |
Create Task
The Create Task pop up menu button is the main tool for all possible actions (tasks) with devices. Successful action results in a queued job.
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.
1. For the manually selected devices.
2. For the filtered devices.
3. For the devices from .csv file.
4. For all devices.
FIELD NAME | ACTION | DESCRIPTION |
---|---|---|
Update firmware |
Update selected firmware version | Select File | Create |
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. 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. |
Update configuration |
Update selected firmware version | Select File | Create |
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. 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. |
Receive configuration |
Receive configuration | Create |
This function assigns a Download configuration job to device. Next time it connects to FOTA – selected files shall be downloaded. |
Receive internal log |
Receive internal log | Create |
This function assigns a Download logs job to 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. |
Move
This function assigns devices from Device list.
There is 4 possible filtering options for this function..
1. For the manually selected devices.
2. For the filtered devices.
3. For the devices from .csv file.
4. For all devices.
Select Company or Group name that these devices should be assigned to.
NOTE: a Group must be created first in Groups menu.
Export
This function is used to Export devices to the required .csv or .xlsx files.
There is 4 possible filtering options for this function.
1. For the manually selected devices.
2. For the filtered devices.
3. For the devices from .csv file.
4. For all devices.
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 Create 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.
The order of job execution is as follows:
1. Upload FW to the device
2. Upload CFG to the device
3. Download LOGS from the device
4. Download CFG from the device
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 the logs shall be taken.
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
- Configuration 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.
Example for the device filtering window is showed below, where FMB120 model selected.
Clicking on Create task and then selecting a task from filtering, say Firmware upgrade, would assign a Firmware upgrade job to selected 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.
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