Devices

Revision as of 09:14, 8 February 2021 by Tomas.kriauciunas (talk | contribs)

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)

There are the following columns in the general Device area.

Devicee.png
FIELD NAME VALUE DESCRIPTION
DESCRIPTION
Not registered | Device name | Not Registered Until device connects to FOTA WEB 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 WEB with the new firmware.

CONFIGURATION
Current configuration name | N/A; default: N/A
Field displays configuration filename 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.

Note: if configuration was downloaded from device to FOTA WEB – 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 WEB | 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 WEB – this means that last time device was configured using FOTA WEB.
- 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 WEB 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 WEB – 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 WEB – 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 WEB – 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 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.

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 WEB 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 WEB 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 WEB interface, as well as downloaded while in the viewind menu.


Next chapter Users