Devices

From Wiki Knowledge Base | Teltonika SAS

There are following columns in general Device area. Additional columns can be applied pressing on Filterdevice.png icon and selecting desired columns.

DeviceFiltering.gif
FIELD NAME VALUE DESCRIPTION
Info
Task icon: Tasks icon.png
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;
- when firmware has been updated and the device reconnected to FOTA WEB with the new firmware.

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.
SEEN AT
Date and time; Default: –
This field shows when device connected to FOTA WEB the last time.
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, when device has been updated.


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


Device actions.png



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.

TaskCreation.png


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.


Create a task select.gif

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.

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.

MoveFOTA.png

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.

ExportFOTA.png

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.

FotaFiltersDevices.png


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)DevicesUsers (Next page)