Difference between revisions of "Help with Server FAQ"

From Wiki Knowledge Base | Teltonika GPS
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
This page is dedicated to quickly find most commonly faced issues or questions when trying to create an IoT data platform which supports Teltonika Telematics devices.  
+
Server Related Questions and Tips.
  
 
=='''Pre-Requisites for server implementation'''==
 
=='''Pre-Requisites for server implementation'''==
Line 6: Line 6:
 
|-
 
|-
 
|To develop the platform, below are the requirements:
 
|To develop the platform, below are the requirements:
−
{| class="wikitable"
 
−
|+
 
−
!Requirement
 
−
!Comment
 
−
|-
 
−
|Hardware
 
−
|A high CPU count promotes better cloud tiering throughout because although object storage can be slow in I/O operations per thread, object storage can support many threads. Any standard x86 64-bit servers can be ideally used.
 
−
|-
 
−
|Memory Requirements
 
−
|Cloud services demand a large amount of memory, which is why the minimum recommended memory size is 8GB.
 
−
|-
 
−
|Hard disk
 
−
|For a medium-sized (up to a 1000 devices) server, 300GB RAID1 disks can be recommended.
 
−
|-
 
−
|Database
 
−
|A database is required to store the records/messages incoming from multiple devices.
 
−
Further, this data must be assigned to its appropriate device ( recognized by IMEI ). MySQL can be used for the database.
 
−
|-
 
−
|Security
 
−
|Teltonika devices support TLS Encryption which can be implemented.
 
−
[[How to generate TLS certificates (Windows)?]]
 
−
|-
 
−
|Programming Skills
 
−
|Knowledge about programming language is a must. Teltonika Telematics is a hardware production company, we do not provide software programming services and cannot help with writing code for the server. Only consult on the logic and algorithms of device features and possible issues in data interpretation from the server side.
 
−
|-
 
−
|Hardware Knowledge
 
−
|It can be found on our Teltonika WIKI: https://wiki.teltonika-gps.com/view/Main_Page
 
−
To understand the devices, their use cases and how they send data.
 
−
|-
 
−
|Protocol Implementation
 
−
|Teltonika Telematics device protocols need to be implemented for the server to understand and parse the received data correctly.
 
−
[[Teltonika Data Sending Protocols]]
 
−
|-
 
−
|Socket Programming
 
−
|Sockets and the socket API are used to send messages across a network. For Teltonika devices to make connection to your server, the server needs to have an application socket programmed to accept these connection request.
 
−
'''Note:'''
 
−
 
−
Each socket should be dedicated to one device, this will allow the server to differentiate the devices when more than 1 device is sending data at the same time.
 
−
|-
 
−
|Network Considerations
 
−
|Cloud storage supports storing cold data on a public cloud object storage service,such as Amazon S3. When using a public cloud, the connection is over a WAN.
 
−
|-
 
−
|Bandwidth Requirements
 
−
|Bandwidth speed requirements are based on the amount of data transfer per month. It can be calculated using some online tools such as: https://www.calculator.net/bandwidth-calculator.html.
 
−
|-
 
−
|IP Address Requirements
 
−
|Static IP or a dedicated port and domain is required otherwise device configuration would need to be updated constantly with a new IP or a new Port.
 
−
|-
 
−
|}
 
  
 +
#Hardware Knowledge: It can be found on our Teltonika WIKI: https://wiki.teltonika-gps.com/view/Main_Page
 +
#Network Protocols: TCP/IP and UDP are the basic protocols supported by our devices. MQTT is also supported.
 +
#Knowledge about programming language is an asset, where Python, C#, JAVA can be used for Backend. MySQL can be used for the database.
 +
#Skillsket for Socket Programming is an asset to develop a server.
 +
#Security: Teltonika device support TLS Encryption which can be implemented on the server side.
 
|}
 
|}
  
 +
=='''Server Requirements'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<strong>How to open ports in my computer for virtual testing?</strong>
+
|<strong>What are the supported Network Protocols for Teltonika devices which I need to implement on my server</strong>
 
|-
 
|-
−
|
+
|Currently, the Teltonika devices works with 03 different protocols for Data Sending; TCP, UDP, and MQTT. Please keep a note that MQTT is supported only via AWS server or a custom server which should be implemented based on the AWS protocols. More information on MQTT ( based on AWS ) can be found here: https://wiki.teltonika-gps.com/view/Getting_Started_with_AWS_IoT_Core.
−
The step by step instructions to open a TCP/UDP port can be found here: https://wiki.teltonika-gps.com/view/Opening_TCP/UDP_port
 
−
|}
 
−
 
 
−
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
−
|<strong>What ports should i use to keep connection with the server?</strong>
 
−
|-
 
−
|
 
−
Any Non-reserved ports on the server side, which are not being blocked and used by server's firewall and services respectively.
 
 
|}
 
|}
  
Line 81: Line 30:
 
|}
 
|}
  
−
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
+
=='''Implementation'''==
−
|<strong>What are the supported Network Protocols for Teltonika devices which I need to implement on my server</strong>
 
−
|-
 
−
|Currently, the Teltonika devices works with 03 different protocols for Data Sending; TCP, UDP, and MQTT. Please keep a note that MQTT is supported only via AWS server or a custom server which should be implemented based on the AWS protocols. More information on MQTT ( based on AWS ) can be found here: https://wiki.teltonika-gps.com/view/Getting_Started_with_AWS_IoT_Core.
 
−
|}
 
−
 
 
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>Is there any ID/Value available corresponding to the paramters that Teltonika devices offer? </strong>
 
|<strong>Is there any ID/Value available corresponding to the paramters that Teltonika devices offer? </strong>
Line 101: Line 45:
 
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.
 
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.
+
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>How to setup records sorting from protocols Codec? </strong>
 
−
|-
 
−
|Records can be sorted by using timestamp as a record sorting method, as it allows us to know what record was received early.
 
−
|}
 
−
 
 
−
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
−
|<strong>How to setup the answer to the Codec protocols in C#, Java, C++ from the server side, while counting records?</strong>
 
−
|-
 
−
|You can write script in your preferred language ( C#, JAVA or Python ) which can extract the number of records received from device and send it as a ACK packet to the device.
 
 
|}
 
|}
  
Line 126: Line 58:
 
|}
 
|}
  
 +
=='''Common Mistakes'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
−
|<strong>How to make multiple session separation from the server side from different devices?</strong>
+
|<strong>I am getting the error on the server side saying"Protocol Mismatch". What could possible be wrong in this case?</strong>
 
|-
 
|-
−
|Multiple devices can be separated by recognizing the IMEIs of the devices on the server side. The very first step by the device is to send the IMEI on the server and server receives IMEI and sends ACK packet back to the module. All the modules have different IMEI which can be used as a point of differenciation.
+
|This is because of mismatch in the selection of Network Protocol on the device and server side. It is possible that on the Device, TCP is selected and on the server side its UDP or vice-versa. Since the structure for both the protocols is different, this mismatch can restrict establishing a connection on the server.
 
|}
 
|}
  
 +
=='''ACK Requirements'''==
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
|<strong>How can we know if the acknowledgment is required on the server or not? Can we change this setting?</strong>
 
|<strong>How can we know if the acknowledgment is required on the server or not? Can we change this setting?</strong>
Line 138: Line 72:
 
#If ACK Type, TCP/IP is selected then Server Acknowledgement is not required
 
#If ACK Type, TCP/IP is selected then Server Acknowledgement is not required
 
#If ACK Type, AVL is selected then the Server must respond with the Acknowledgement.
 
#If ACK Type, AVL is selected then the Server must respond with the Acknowledgement.
−
|}
 
−
 
−
=='''Common Mistakes'''==
 
−
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
 
−
|<strong>I am getting the error on the server side saying"Protocol Mismatch". What could possible be wrong in this case?</strong>
 
−
|-
 
−
|This is because of mismatch in the selection of Network Protocol on the device and server side. It is possible that on the Device, TCP is selected and on the server side its UDP or vice-versa. Since the structure for both the protocols is different, this mismatch can restrict establishing a connection on the server.
 
 
|}
 
|}
  

Revision as of 17:51, 12 February 2024

Server Related Questions and Tips.

Pre-Requisites for server implementation

Server Requirements

Documentation

Implementation

Communication with server

Troubleshooting Data

Common Mistakes

ACK Requirements

Communication over GPRS

RAW Data Example

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