Difference between revisions of "Starting with Teltonika Telematics"

From Wiki Knowledge Base | Teltonika GPS
Line 1: Line 1:
=='''Firmware'''==
+
Here are some tips for solving the most common issues setting up Server.
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>How to send SMS command to Teltonika Telematics device? </strong>
 
|-
 
|There exists a specific structure that commands must adhere to. For instance, to send the SMS command "getinfo," the following guidelines should be observed:
 
    If SMS login and password are set: login pass <strong>getinfo</strong>
 
    If SMS login and password are not set, leave two spaces before the command: <strong>getinfo</strong>
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is it possible to delete records from the device memory? </strong>
 
|-
 
|Records stored in the device's memory can be cleared by clicking the "format" button in the [Status] window. Alternatively, sending the SMS command "sdformat" remotely accomplishes the same result without requiring a physical connection to a computer.
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is it possible to show battery % of EYE sensors/beacons? </strong>
 
|-
 
|No, but it is possible to retrieve the battery voltage and estimate the remaining battery life.
 
More information about it can be found here: [https://wiki.teltonika-gps.com/view/EYE_FAQ#How_does_the_battery_voltage_translate_into_the_percentage_of_the_battery.3F How does the battery voltage translate into the percentage of the battery?]
 
 
 
Both EYE sensors and EYE Beacons can advertise their battery voltage
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>What is autoscan and which Teltonika device models support this feature?</strong>
 
|-
 
|Autoscan is the process of scanning for CANBUS program numbers in the vehicle CANBUS system. Currently, FMB140 and newest external CAN adapters have the Autoscan feature.
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>How to access the latest firmware and how to know when the latest firmware has been released? </strong>
 
|-
 
| The latest firmware release information is passed through the Teltonika newsletter. It is encouraged that you subscribe to this service to get real-time notifications about the releases.
 
Base firmware for all devices can also be found here: [[Firmware versions]]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>How to activate digital output with SMS command? What commands are available? </strong>
 
|-
 
| To set digital output use the setdigout command. A description of this command can be found here: [https://wiki.teltonika-gps.com/view/FMB_setdigout FMB_setdigout]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>What is the difference between Fuel consumed and Fuel consumed (Counted) or Total mileage and Total Mileage (Counted)? </strong>
 
|-
 
| Fuel consumed is the total fuel consumed by the vehicle since it was manufactured, while fuel consumed (counted) is the fuel consumed by the vehicle since the CAN device was installed.
 
Total mileage is the total mileage of the vehicle as displayed on the dashboard of the vehicle since it was manufactured, while total mileage (counted) is the mileage of the vehicle from when the CAN device was installed.
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Does FMC125 work with the Iridium Edge use case? </strong>
 
|-
 
| Yes, Iridium Edge does work with the FMC125 devices - the 03.28.06.Rev.323 firmware has to be used for this solution to work.
 
More information about the Iridium Edge solution can be found here: [[Iridium Edge]]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is there a way to encrypt the data that is sent to the server? </strong>
 
|-
 
| Yes, our devices have TLS encryption capability, which allows to secure the data using TLS certificates that are uploaded to the device and the server.
 
More information about TLS encryption can be found here: [https://wiki.teltonika-gps.com/view/FMB130_GPRS_settings#TLS.2FDTLS TLS settings]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is it possible to know how much data has been used with the current data plan? </strong>
 
|-
 
| In the configurator Status tab there is the GPRS traffic section, where data usage can be seen.
 
Other than this, there is no way to get the data consumption from the device - this information will be available from the network provider.
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is there a way to implement seat belt detection with a device with only one digital input? </strong>
 
|-
 
| There are 2 methods that can be followed:
 
 
 
1. Digital Input: if the device only has 1 Digital input which is mostly used to connect the ignition cable, In this use case - the ignition source can be set to power voltage and the seatbelt sensor can be connected to Digital input with priority - High and Operand "On change".
 
 
 
2. Analog Input: The seat belt sensor can be connected to Analog Input 1 with priority - high and low-level values (depending on the voltage from the seatbelt, let's say 12 VDC) - 10 VDC and High level - 13 VDC. The idea is to make the voltage fall between low-level and high-level values and generate an event when the voltage enters that range.
 
 
 
 
 
 
 
IO settings guide:  [[FMC920 I/O settings]]
 
 
 
It is recommended to use FMX130 as the device has a Ground sense option which will be easier to connect and DIN1 can be used for accurate Ignition detection.
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>How to get a SIM card IMSI number on my server? </strong>
 
|-
 
| The IMSI is not available as an IO element, and it will not be sent to the server with records. However, it can be requested by a SMS/GPRS command "getimsi"
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Why does the TAT100 device appear offline on my server? </strong>
 
|-
 
| The TAT100 always works in Deep-sleep mode, and the open link Timeout is 30sec maximum, so the device does not stay connected to the server - this is done to preserve the battery life and allow the device to work longer.
 
|}
 
  
 +
=='''Data Interpretation'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>Is it possible to send an SMS or command to the TAT100? </strong>
+
|<strong>Where can I find a simple and understandable description of the data sent from the device to the server, along with an explanation? I need to understand what the server sees, how it is written, and what the specific values mean.</strong>
 
|-
 
|-
| Yes, you can send a command to the TAT100 and it will execute this command once it wakes up.
+
|In the link below you can find a full explanation of the Teltonika protocols with details about Codec 8 and Codec 8 extended protocols, used for data sending, and Codec 12 for sending GPRS commands: https://wiki.teltonika-gps.com/view/Teltonika_Data_Sending_Protocols
 +
Each device I/O parameter has its unique ID, which is called AVL ID. If you want to decode the data easily you can try to use the device Data Sending Parameters ID page to learn about the AVL parameters and how to decode it: https://wiki.teltonika-gps.com/view/FMB920_Teltonika_Data_Sending_Parameters_ID
 
|}
 
|}
  
 +
=='''Data Functionality/Workflow'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>When does TAT100 connect to FOTA WEB? </strong>
+
|<strong>After creating my server, I started to receive the same message from the device for multiple times. Should I respond to it? If yes, whats the format of the response?
 +
</strong>
 
|-
 
|-
| TAT100 devices do not connect to FOTA Web periodically. It will automatically connect to FOTA Web only on initial startup (when the switch is flipped from OFF to ON position). Connection to FOTA Web should be initiated via the 'web_connect' SMS/GPRS command. This is to preserve battery power.
+
|First, when module connects to server, module sends its IMEI. First comes short identifying number of bytes written and then goes IMEI as text (bytes).
|}
+
For example, IMEI 356307042441013 would be sent as 000F333536333037303432343431303133. First two bytes denote IMEI length. In this case 0x000F means, that IMEI is 15 bytes long.
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
After receiving IMEI, server should determine if it would accept data from this module. If yes, server will reply to module 01, if not - 00. Note that confirmation should be sent as binary packet. I.e. 1 byte 0x01 or 0x00. Then module starts to send first AVL data packet. After server receives packet and parses it, server must report to module number of data received as integer (four bytes). If sent data number and reported by server doesnā€™t match module resends sent data.
|<strong>Can DSM detect 2 or more events at the same time? </strong>
 
|-
 
| Yes, it can detect multiple events at the same time. The events are placed in a queue and then reported based on their generation time.
 
 
|}
 
|}
  
 +
=='''Implementation'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>Which SMS encoding is supported by Teltonika Telematics devices? </strong>
+
|<strong>I tried to implement my server but I couldnā€™t create a tool to listen to the data sent by the device. Does Teltonika have any tools to help in receiving the packets? And to parse the data received? If yes, where I can find it?</strong>
 
|-
 
|-
| The device received commands encoded in Unicode and any third-party SMS portal should have the support of format SMS Default Alphabet while initiating communication with the Teltonika device. FMC devices support SMS Default Alphabet, also known as GSM-7, encoding only - this encoding standard should be configured at the sending device/application.
+
|Yes, Teltonika has a TCP and UDP listeners that makes part of the Teltonika Parser Pack. In the Parser Pack you can also find the Teltonika Parser to decode the data received by the listeners. You can find the download link of the parser pack here:  https://wiki.teltonika-gps.com/view/Universal_Device_Test_Guide#Protocols_implementation
 
|}
 
|}
  
=='''Software'''==
+
=='''Reading Records'''==
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>When opening the configurator, a .NET error is shown. I tried installing .NET 7.0, but the error remained. How can this be solved? </strong>
+
|<strong>After implement my own server I started to receive a packet with multiple records, how can I know which record was generated first?
 +
</strong>
 
|-
 
|-
| New Configurators use the newer .NET version - please make sure the correct version is installed and remove other (unused) .NET versions – more information can be found here:  [[.NET Runtime for Desktop installation]]
+
|When you receive a packet with multiple records in the same Data Packet you can use the Timestamp to know when the record was generated.
Note #1: The Ways to determine the required version section is especially important here. It will help you decide which version you should choose.
 
 
 
Note #2: x86 is recommended even with Microsoft Windows 64-bit Operating System.
 
 
|}
 
|}
  
 +
=='''Documentation'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>What is FOTA Web and how is it useful? Can you see the device's real-time location using this system? </strong>
+
|<strong>I want to receive the data generated by the Teltonika device, does Teltonika have any server or service for this purpose? In case not, Are there any recommendations on how to proceed to receive the data?</strong>
 
|-
 
|-
| FOTA Web is simply a device management platform that is used to assign files to the device remotely, such as firmware, configuration files, etc.
+
|As we are a Hardware manufacturer we donā€™t count on a server or service that you can use to see the data generated by your device. So we can offer different solutions for you to reach your goals. [SP1]
FOTA Web is '''not''' a tracking platform and does not report the device's real-time location.
+
# You can use an existing Fleet Management platform, a Telematics API Platform, or a Cloud Computing platform. There are a lot of options, but you can find a list with some of the compatible platforms/services here: [[Fleet Management platforms|https://wiki.teltonika-gps.com/view/Fleet_Management_platforms]]
 
+
# You can develop your platform to receive and parse the data generated by the device. To develop your platform you should have some knowledge about programming and networks.
 
 
You can find more information about the FOTA Web tool here: [[FOTA WEB]]
 
 
|}
 
|}
  
 +
=='''PRE-Requisite knowledge/skills'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>How to use the device transfer feature in FOTA Web? </strong>
+
|<strong>I want to develop a Vehicle Tracking System using your GPS Tracker. So, my question is what are the required knowledge/skills to set up my server for sending/receiving data to the Teltonika tracker? I am confused about how to set up my server to send and receive the data from the device</strong>
 
|-
 
|-
| Device transfer is a feature in FOTA Web that allows clients to directly move devices amongst their accounts without the need to involve Teltonika.
+
|To develop your platform first you must be aware of some sort of information/tech skills, such as device Data Sending Protocols, device data sending parameters, basic concepts of network communications, such as communication protocols, open and test IP and ports and how to parse the data received using source codes or the provide protocols.
More information about this feature can be found here:  [https://wiki.teltonika-gps.com/view/FOTA_WEB_Devices#Device_transfer Device transfer]
 
 
|}
 
|}
  
 +
=='''Server Requirements/Supported Network Protocols'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>How do I update configurations remotely via Teltonika FOTA Web? </strong>
+
|<strong>I want to develop a Vehicle Tracking System using your GPS Tracker. So, my question is what are the required knowledge/skills to set up my server for sending/receiving data to the Teltonika tracker? I am confused about how to set up my server to send and receive the data from the device</strong>
 
|-
 
|-
| Kindly use the FOTA Web to remotely update configurations to units as explained here: [[FOTA WEB|FOTA Web]]
+
|Currently, the Teltonika devices works with 03 different protocols for Data Sending; TCP, UDP, and MQTT. You can open a TCP or a UDP port on your PC to receive the data sent by your device. You can make sure that the port is open using external websites like canyouseeme (https://www.canyouseeme.org), port checker (https://portchecker.co/) and others. If youā€™re unable to open ports, you can use external tools such as ngrok (https://ngrok.com/) to virtually route the ports.
 
 
Steps are:
 
 
 
1. Upload the configuration file in FOTA Web under the files tab.  
 
 
 
2. Head over to the devices tab then select the devices to receive the configuration.
 
 
 
3. Click on Create Task and choose Update Configuration on the drop-down then below it, choose the uploaded file, then click on Create Task.  
 
 
 
The task will be executed the next time the device connects to FOTA Web or you can force it to connect immediately by sending a command '''''web_connect''''', or by forcing a hard restart of the unit by unplugging the power and the internal battery then plugging it back on - then the task will be executed immediately.
 
 
|}
 
|}
  
== '''Hardware''' ==
+
=='''Troubleshooting Data'''==
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>What are the SIM card requirements for use with Teltonika Telematics devices? </strong>
+
|<strong>I have done the IMEI acknowledgment part by sending 01 to the device upon reception of IMEI. Now, having a bit of difficulty in sending the number of data packets received on the server from the FMX device. What exactly should I do to properly respond to the device?
 +
</strong>
 
|-
 
|-
| Different Teltonika Telematics devices support Mini SIM, Micro SIM, and Nano SIM sized SIM cards. To know the exact SIM card supported by Your device, please check the General Description Wiki page for Your device.
+
|After receiving the AVL packet from the device you should respond with the number of records is in the packet, which is present in the payload and presented as Number of Data 1 and/ or Number of Data 2.
 +
Below we have a couple of examples of packets send using the Codec8 and TCP protocols with the proper response:
  
 +
1)    RAW with 01 record:
  
As for eSIMs, there are a couple of requirements for it to work with our devices - they can be found here: [[Requirements for eSIM]]
+
Received data in the hexadecimal stream:
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
000000000000003608010000016B40D8EA30010000000000000000000000000000000
|<strong>How to connect the fuel gauge sensor to the Analog input of the FMx and calibrate for accurate results? </strong>
 
|-
 
| Device can measure the fuel level using analog input by matching the voltage coming from the fuel level sensor already mounted in the car, with the fuel level in the tank.
 
More information on how the AIN has to be connected and calibrated can be found here: [[Analog Fuel Sensor]]
 
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
105021503010101425E0F01F10000601A014E0000000000000000010000C7CF
|<strong>Where the connection schemes for CAN-CONTROL adapter can be found? </strong>
 
|-
 
| Please create a Helpdesk ticket for our support team and specify the vehicle that the connection scheme is needed for.
 
The whole supported vehicle list for CAN-CONTROL adapter can be found here: [[CAN adapter supported vehicles]]
 
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
As the Number of Data 1 and 2 shows the value 1, the server should respond:
|<strong>Do all RFID cards with 125 or 128kHz frequency work with FMC150 ? What about a 13.56 MHz NFC or RFID device? </strong>
 
|-
 
|Like other devices with a 1-Wire interface, FMC150 also supports a 1-wire protocol (DS1990A) RFID reader.
 
If the reader reads cards with 125 or 128 kHz and transmits this data through 1 wire protocol (DS1990A), an integration can be done for FMX150 devices.
 
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
00000001
|<strong>How many batteries does TAT1XY use? </strong>
 
|-
 
| TAT1XY uses 1 battery, which consists of 2 (7.2V variant) or 3 (10.8V  variant) cells. Currently, manufactured TAT devices use 3-cell batteries.
 
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
2)    RAW with 02 records
|<strong>What is the battery life of TAT1XY? </strong>
 
|-
 
| TAT1XX can send approximately 1000 records, this may differ depending on the environment, coverage, Temperature, and device mounting,
 
|}
 
 
 
== '''Protocols''' ==
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Where information on how to parse messages from Teltonika Telematics devices can be found?</strong>
 
|-
 
| Teltonika data sending protocol Codec 8 and Codec 8Extended description with examples:
 
 
 
[[Codec|AVL data sending codecs]]
 
 
 
TCP/UDP listener and AVL parser with source code that could be used as a template for implementation of Teltonika protocols. The whole pack can be downloaded from here:
 
 
 
[https://wiki.teltonika-gps.com/view/Universal_Device_Test_Guide#Protocols_implementation Listener and AVL parser]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>In documentation it states that the Beacon data will be sent via AVL ID 385, but data from FMB140 is being sent with AVL ID:548. </strong>
 
|-
 
| When the simple mode is selected beacon parsing is done automatically so AVL ID:385 is used
 
 
 
When advanced beacon mode is selected, beacon data capturing can be configured manually and to distinguish simple and advanced functionalities a different ID is used - AVL ID 548.
 
 
 
For advanced beacon configuration documentation, you can find it here: [[Advanced Beacon Capturing Configuration]]
 
|}
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>I have implemented Codec8 Extended protocol. Communication is working correctly, IMEI and AVL packets are working fine, but the unit sends 0xFF instead of AVL packets sometimes. Is there any use of this packet and is it necessary to send some data as a response back? </strong>
 
|-
 
| It seems that You have enabled the Network Ping Timeout feature.
 
 
 
What Network Ping Timeout does is it sends an empty packet (0xFF) to the server to make sure that the operator does not close a link between the device and the server.
 
 
 
If you don't want to receive 0xFF packets anymore you can set Network Ping Timeout to 0 seconds.
 
|}
 
  
== '''Configuration''' ==
+
Received data in the hexadecimal stream:
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
000000000000004308020000016B40D57B48010000000000000000000000000000000
|<strong>I have successfully paired the Teltonika Eye sensor to the fleet management device and I can see the data on the I/O tab but the data is not sent to my platform, what could be the issue? </strong>
 
|-
 
| For the data to be sent to the platform, the I/O needs to have a priority of ‘Low’, ‘High’, or ‘Panic’ so that the data can be sent with periodical data to the platform.
 
  
I/O Settings wiki page - [[FMB125 I/O settings]]
+
1010101000000000000016B40D5C198010000000000000000000000000000000 101010101000000020000252C
|}
 
  
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
As the Number of Data 1 and 2 shows the value 2, the server should respond:
|<strong>Why device does not detect the ignition? </strong>
 
|-
 
|Please check which ignition source have you chosen and configure the device according to Your use case.
 
  
More information about the Ignition sources can be found here: [https://wiki.teltonika-gps.com/view/FMC130_System_settings#Ignition_Source Ignition source]
+
00000002
 
|}
 
|}
  
 +
=='''Common Mistakes'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>When testing an OBD device, alarm of the vehicle is triggered when it is parked. What could cause this? </strong>
+
|<strong>Iā€™m using the Parser tools to decode the records sent by the device to my server but the Parser says ā€œ Corrupted Data Insertedā€¯. What should Iā€™m doing wrong?</strong>
 
|-
 
|-
| This usually occurs when the device tries making OBD requests while the vehicle has no ignition and is locked. This can happen due to improper configuration, so make sure that the OBD device properly detects the ignition of the vehicle, when the ignition is actually ON.
+
|First, be sure that you're trying to decode using the proper protocol. I mean, if you configured the device to send messages using UDP to your server you must select UDP in the Parser, if you set the device to send the records using the TCP Protocol you must select the TCP in Parser.
More information about the Ignition sources can be found here: [https://wiki.teltonika-gps.com/view/FMC130_System_settings#Ignition_Source Ignition source]
 
 
|}
 
|}
  
 +
=='''RAW Data Example'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>How to calculate how much data device is going to consume according to configuration?</strong>
+
|<strong>I need to parse the data received on my end. Do you have any piece of code or examples that you can provide that I can use to develop my parser?</strong>
 
|-
 
|-
|The total number of data consumption bytes depends on parameters, features and also the frequency of data sending configured in Data Acquisition.
+
|Here's an example of the Data Received in the HEX Format and how to parse it:
 
+
Received data in the hexadecimal stream:
By counting the bytes of each enabled parameter, the size of one packet can be calculated. Once the frequency or amount of packets sent is known only multiplication needs to be done:
+
000000000000003608010000016B40D8EA30010000000000000000000000000000000105021503010101425E0F01F10000601A014E0000000000000000010000C7CF.
Packet Size X Amount of packets
 
 
 
Important note: Network operators round the packets into larger chunks, e.g.: if device sends 800 Bytes of data, operators can round it to 1 kB (1024 Bytes).  
 
  
You can find the size of each IO in the below link:</br>
+
The detailed parsing can be found in the wiki page, under the category Communication with server: https://wiki.teltonika-gps.com/view/Teltonika_Data_Sending_Protocols#Codec_8
[https://wiki.teltonika-gps.com/view/FMC130_Teltonika_Data_Sending_Parameters_ID#Permanent_I.2FO_elements Teltonika Data Sending parameters]
 
 
|}
 
|}
[[Category: Frequently Asked Questions - FAQ]]
 

Revision as of 07:17, 6 February 2024

Here are some tips for solving the most common issues setting up Server.

Data Interpretation

Data Functionality/Workflow

Implementation

Reading Records

Documentation

PRE-Requisite knowledge/skills

Server Requirements/Supported Network Protocols

Troubleshooting Data

Common Mistakes

RAW Data Example