FOTA WEB Devices

There 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; - 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.

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.

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.

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