Difference between revisions of "Starting with Teltonika Telematics"

From Wiki Knowledge Base | Teltonika GPS
Line 1: Line 1:
−
Here are some tips for solving the most common issues setting up Server.
+
=='''Firmware'''==
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>How do I send SMS command to Teltonika Telematics device? </strong>
 +
|-
 +
|There is a certain structure that the command has to follow:
 +
 
 +
For example, if we would want to send SMS command getinfo:
 +
 
 +
If you have set SMS login and password: <strong>login pass getinfo</strong>
 +
 
 +
If SMS login and password are not set leave two spaces before command:  <strong>getinfo</strong>
 +
|}
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>Can we delete records from the device memory? </strong>
 +
|-
 +
|You can clear device's memory by clicking the "format" button in the [Status] window. This will delete all stored records from the device's memory. You can also send the SMS command "sdformat" to the device and it will do the same thing but remotely without the need to connect the device 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 with how many Teltonika device models is this possible? </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 us 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>Can we check how much data has been used with the current data plan? </strong>
 +
|-
 +
| In the configurator Status tab, we have 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 we can follow:
 +
 
 +
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 do I 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"
 +
|}
  
−
=='''Data Interpretation'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>Why does the TAT100 device appear offline on my server? </strong>
 
|-
 
|-
−
|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
+
| 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.
−
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>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>Can I send an SMS or command to the TAT100? </strong>
−
</strong>
 
 
|-
 
|-
−
|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).
+
| Yes, you can send a command to the TAT100 and it will execute this command once it wakes up.
−
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.
+
|}
  
−
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.
+
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>When does TAT100 connect to FOTA WEB? </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.
 
|}
 
|}
  
−
=='''Implementation'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>Can DSM detect 2 or more events at the same time? </strong>
 
|-
 
|-
−
|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
+
| 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.
 
|}
 
|}
  
−
=='''Reading Records'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>Which SMS encoding is supported by Teltonika Telematics devices? </strong>
−
</strong>
 
 
|-
 
|-
−
|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.
+
| 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.
 
|}
 
|}
  
−
=='''Documentation'''==
+
=='''Software'''==
 +
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<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>
 
|-
 
|-
−
|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]
+
| 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]]
−
# 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]]
+
Note #1: The Ways to determine the required version section is especially important here. It will help you decide which version you should choose.
−
# 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.
+
 
 +
Note #2: x86 is recommended even with Microsoft Windows 64-bit Operating System.
 
|}
 
|}
  
−
=='''PRE-Requisite knowledge/skills'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>What is FOTA Web and how is it useful? Can you see the device's real-time location using this system? </strong>
 
|-
 
|-
−
|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.
+
| FOTA Web is simply a device management platform that is used to assign files to the device remotely, such as firmware, configuration files, etc.
 +
FOTA Web is '''not''' a tracking platform and does not report the device's real-time location.
 +
 
 +
 
 +
You can find more information about the FOTA Web tool here: [[FOTA WEB]]
 
|}
 
|}
  
−
=='''Server Requirements/Supported Network Protocols'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>How to use the device transfer feature in FOTA Web? </strong>
 
|-
 
|-
−
|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.
+
| Device transfer is a feature in FOTA Web that allows clients to directly move devices amongst their accounts without the need to involve Teltonika.
 +
More information about this feature can be found here: [https://wiki.teltonika-gps.com/view/FOTA_WEB_Devices#Device_transfer Device transfer]
 
|}
 
|}
  
−
=='''Troubleshooting Data'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>How do I update configurations remotely via Teltonika FOTA Web? </strong>
−
</strong>
 
 
|-
 
|-
−
|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.
+
| Kindly use the FOTA Web to remotely update configurations to units as explained here: [[FOTA WEB|FOTA Web]]
−
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:
+
Steps are:  
  
−
Received data in the hexadecimal stream:
+
1. Upload the configuration file in FOTA Web under the files tab.
  
−
000000000000003608010000016B40D8EA30010000000000000000000000000000000
+
2. Head over to the devices tab then select the devices to receive the configuration.
  
−
105021503010101425E0F01F10000601A014E0000000000000000010000C7CF
+
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.
  
−
As the Number of Data 1 and 2 shows the value 1, the server should respond:
+
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.
 +
|}
  
−
00000001
+
== '''Hardware''' ==
  
−
2)    RAW with 02 records
+
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>What are the SIM card requirements for use with Teltonika Telematics devices? </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.
  
−
Received data in the hexadecimal stream:
 
  
−
000000000000004308020000016B40D57B48010000000000000000000000000000000
+
As for eSIMs, there are a couple of requirements for it to work with our devices - they can be found here: [[Requirements for eSIM]]
 +
|}
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>How to connect the fuel gauge sensor to the Analog input of the FMx and calibrate for accurate results? </strong>
 +
|-
 +
| We 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]]
 +
|}
  
−
1010101000000000000016B40D5C198010000000000000000000000000000000 101010101000000020000252C
+
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>Where can we find the connection schemes for CAN-CONTROL adapter? </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]]
 +
|}
  
−
As the Number of Data 1 and 2 shows the value 2, the server should respond:
+
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>Does 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), we can integrate it into FMC150.
 +
|}
  
−
00000002
+
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<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 2-cell batteries.
 
|}
 
|}
  
−
=='''Common Mistakes'''==
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>What is the battery life of TAT1XY? </strong>
 
|-
 
|-
−
|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.
+
| TAT1XX can send approximately 1000 records, this may differ depending on the environment, coverage, Temperature, and device mounting,
 
|}
 
|}
  
−
=='''RAW Data Example'''==
+
== '''Protocols''' ==
 +
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<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>
+
|<strong>Where can I find how to parse the message from the device in the backend? </strong>
 
|-
 
|-
−
|Here's an example of the Data Received in the HEX Format and how to parse it:
+
| Teltonika data sending protocol Codec 8 and Codec 8Extended description with examples:
−
Received data in the hexadecimal stream:
 
−
000000000000003608010000016B40D8EA30010000000000000000000000000000000105021503010101425E0F01F10000601A014E0000000000000000010000C7CF.
 
  
−
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
+
[[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''' ==
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<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]]
 +
|}
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>Why device doesn't 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]
 +
|}
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 +
|<strong>When testing the OBD device alarm of the vehicle is triggered when it is parked. What could cause this? </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.
 +
More information about the Ignition sources can be found here: [https://wiki.teltonika-gps.com/view/FMC130_System_settings#Ignition_Source Ignition source]
 
|}
 
|}

Revision as of 08:20, 9 February 2024

Firmware

Software

Hardware

Protocols

Configuration

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Starting_with_Teltonika_Telematics&oldid=95889"