Devices
There are following columns in general Device area. Additional columns can be applied pressing on 
icon and selecting desired columns.
| FIELD NAME | VALUE | DESCRIPTION |
|---|---|---|
| Info |
Task icon:  |
Device is working on assigned tasks. When pressed, redirects user to detailed information about device’s activity. |
| IMEI |
Device’s IMEI | N/A; default: N/A |
Once device is registered – field shall display device’s IMEI. |
| DESCRIPTION |
Default: – | Until device description is changed this value shall remain. |
| Device's description |
This field can be edited to assign a description to the device. |
|
| MODEL |
Device's Model; Default: – |
Once device is registered – field shall display device’s model, e.g. TMT250, TFT100 etc. This field cannot be changed. |
| FIRMWARE |
Current Device firmware | New device firmware; Default: – |
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; Default: – |
Field displays configuration filename that has been uploaded via FOTA WEB from FILES tab. If device configuration has changed via other means than FOTA WEB – this field shall not be updated until the next connection to FOTA WEB. Note: if configuration was downloaded from device to FOTA WEB – it’s name shall be displayed. |
| SERIAL NO. |
Device’s Serial number; Default: – |
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. |
| GROUP |
Default: – | Until device is assigned to a group, this value shall remain. |
| Device's Group |
This field shall always show which group device belongs. | |
| STATUS NAME |
Device Status |
This field shall indicate status of device. Possible statuses: Inactive - Device has not connected to system in last 30 days. Idle - Device has no pending tasks. Pending - Device has queued tasks that have to be executed. Working - Device currently is connected to server and executing task.
|
| SEEN AT |
Date and time; Default: – |
This field shows the last time device connected to FOTA WEB web. |
| CREATED AT |
Date and time; Default: – |
This field shows when device has been added. |
| UPDATED AT |
Date and time; Default: – |
This field shows the last time device information has changed. |
Device actions
This chapter provides explanation of what each button item does and how to use it. There three action buttons to choose:
- Create task
- Move
- Export
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.
There are three options to select from when creating a task:
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.
Task types
| FIELD NAME | VALUE | 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. |
| Transfer BlueNRG firmware |
Update selected BlueNRG firmware version | Select File | Create | You can Upload the required BlueNRG firmware version over the Files menu or over the same pop up windown while selecting the task, if you have the BlueNRG firmware uploaded already, task can be assigned by selecting required BlueNRG firmware version. If there are no available BlueNRG firmware versions for the update, please press on Upload new file button to add the file on the same pop up window. |
| 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. |
| Send TLS file
(coming soon) |
Transfer user TLS certificate | Select File | Create | 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.
If there is are available TLS certificates, please press on Upload new file button to add the certificate on the same pop up window. |
Add scenario
Feature allows to enable scenario on device as easy as possible. Scenarios e.g.:
- Overspeeding
- Crash Detection
- Towing detection
After sending the partial configuration, it will not be portrayed as the current configuration.
Setting scenario doesn't overwrite other parameters apart scenario parameters.
Each scenario has recommended settings.
Scenarios have info link to scenario Wiki page: Overspeeding | Crash Detection | Towing Detection
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. GH5200 config for GH5200 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 Tasks.
You can select/filter devices by:
- Company
- Group
- Device Model
- Firmware version
- Configuration version
- Job status
Under Filter section you shall see current filters that have been selected.
Each Filter can be removed individually by clicking on a particular filter, or they all can be removed together by clicking Clear all filters.
Filters shall maintain current configuration until manually Reset, meaning that navigating through various FOTA menu’s Filters shall remain as last configured.
Bulk assignment
Once Filters section has any number of parameters, the Tasks section automatically displays how many devices have been filtered. It allows to assign tasks to all selected devices.
Example for the device filtering window is showed below, where GH5200 model selected.
Clicking on Create task and then selecting a task from filtering, for example – Firmware upgrade, would assign a Firmware upgrade job to selected devices.
Getting Started (Previous page) • Devices • Users (Next page)
