Changes

Teltonika Data Sending Protocols (view source)

Revision as of 09:49, 8 December 2023

6,383 bytes added ,  09:49, 8 December 2023
→‎Codec 15
Line 2,802: Line 2,802:  
|} <br />
 
|} <br />
   −
=='''<big>Differences between Codec 12, Codec 13 and Codec 14</big>'''==
+
 
−
In the table below you will see differences between Codec12, Codec13, and Codec14.  
+
 
 +
=='''<big>Codec 15</big>'''==
 +
 
 +
*'''<big>Protocol Overview</big>'''
 +
 
 +
Codec 15 relies on the Codec12 protocol and is employed when both message timestamp and device IMEI are enabled. It serves as the original Teltonika protocol for communication from the device to the server via GPRS messages. This protocol is exclusively applicable to FMX6 professional devices.
 +
 
 +
Codec15 is available in RS232 modes:
 +
 
 +
1. TCP/UDP Ascii
 +
<br>2. TCP/UDP Binary
 +
<br>3. TCP/UDP Ascii Buffered
 +
<br>4. TCP/UDP Binary Buffered.
 +
 
 +
*'''<big>Structure of Codec 15 messages</big>'''
 +
{| class="nd-othertables_2" style="width:100%;"
 +
|+
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |0x00000000 (Preamble)
 +
! rowspan="1" style="width:5%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Data Size
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |0x0F (Codec ID)
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Command quantity
 +
! colspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Message type
 +
! rowspan="1" style="width:14%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Command size + timestamp + imei
 +
! rowspan="1" style="width:5%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Timestamp
 +
! rowspan="1" style="width:5%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |IMEI
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Command
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Command quantity
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |CRC - 16
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |4 bytes
 +
| style="vertical-align: middle; text-align: center;" |4 bytes
 +
| style="vertical-align: middle; text-align: center;" |1 byte
 +
| style="vertical-align: middle; text-align: center;" |1 byte
 +
| style="vertical-align: middle; text-align: center;" |1 bytes
 +
| style="vertical-align: middle; text-align: center;" |4 byte
 +
| style="vertical-align: middle; text-align: center;" |4 bytes
 +
| style="vertical-align: middle; text-align: center;" |8 bytes
 +
| style="vertical-align: middle; text-align: center;" |X bytes
 +
| style="vertical-align: middle; text-align: center;" |1 bytes
 +
| style="vertical-align: middle; text-align: center;" |4 bytes
 +
|-
 +
|}
 +
 
 +
*'''<big>Structure explanation</big>'''
 +
'''Preamble''' - four zero bytes.
 +
<br>'''Data size''' - size is calculated from codec id(0x0F) field to the second command quantity field.
 +
<br>'''Codec ID''' - in Codec 15 it is always 0x0F.
 +
<br>'''Command quantity''' - a number which defines how many commands are in the packet.
 +
<br>'''Message type''' - this value is configurable in RS232 settings box.
 +
<br>'''Command size + Timestamp + IMEI''' - it is equal to size of payload + size of timestamp + size of imei.
 +
<br>'''Timestamp''' – data record creation time in seconds(Unix timestamp).
 +
<br>'''IMEI''' - send as HEX value. Example if device IMEI is 123456789123456 then IMEI data field will contain 0x0123456789123456 value.
 +
<br>'''Command field''' - actual received data.
 +
<br>'''Command quantity''' - a number which defines how many commands are in the packet.
 +
<br>'''CRC field''' - calculated from Codec ID to the Second Number of Data.
 +
*'''<big>Codec 15 examples</big>'''
 +
 
 +
Device sends message „Hello\n“ via GPRS Codec15:
 +
 
 +
000000000000001b0f010b00000013654b65a4012345678912345648656c6c6f210a01000093d6
 +
{| class="nd-othertables_2" style="width:100%;"
 +
! colspan="2" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parsed command
 +
|-
 +
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |Command Part
 +
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Zero Bytes
 +
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Data Size
 +
| style="vertical-align: middle; text-align: center;" |00 00 00 1B
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Codec ID
 +
| style="vertical-align: middle; text-align: center;" |0F
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Quantity of commands
 +
| style="vertical-align: middle; text-align: center;" |01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Command type
 +
| style="vertical-align: middle; text-align: center;" |0B
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Command Size
 +
| style="vertical-align: middle; text-align: center;" |00 00 00 13
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Timestamp
 +
| style="vertical-align: middle; text-align: center;" |65 4B 65 A4
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |IMEI
 +
| style="vertical-align: middle; text-align: center;" |01 23 45 67 89 12 34 56
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Command
 +
| style="vertical-align: middle; text-align: center;" |48 65 6c 6c 6f 21 0a
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |Quantity of commands
 +
| style="vertical-align: middle; text-align: center;" |01
 +
|-
 +
| style="vertical-align: middle; text-align: center;" |CRC-16
 +
| style="vertical-align: middle; text-align: center;" |00 00 93 D6
 +
|-
 +
|}
 +
 
 +
CRC: 0x 000093d6
 +
The algorithm to calculate CRC is CRC-16 (also known as CRC-16-IBM). All the fields from codec ID to second command/response quantity field are used to calculate CRC.
 +
 
 +
=='''<big>Differences between Codec 12, Codec 13, Codec 14 and Codec 15</big>'''==
 +
In the table below you will see differences between Codec12, Codec13, Codec14 and Codec 15.  
 
{| class="nd-othertables_2" style="width:100%;"
 
{| class="nd-othertables_2" style="width:100%;"
 
|+
 
|+
Line 2,810: Line 2,915:  
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Codec13
 
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Codec13
 
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Codec14
 
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Codec14
 +
! rowspan="1" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Codec15
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Communication
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Communication
Line 2,815: Line 2,921:  
| style="vertical-align: middle; text-align: center;" |One-way (Device -> Server communication)
 
| style="vertical-align: middle; text-align: center;" |One-way (Device -> Server communication)
 
| style="vertical-align: middle; text-align: center;" |Server - Device Communication
 
| style="vertical-align: middle; text-align: center;" |Server - Device Communication
 +
| style="vertical-align: middle; text-align: center;" |One-way (Device -> Server communication)
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Codec ID
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Codec ID
Line 2,820: Line 2,927:  
| style="vertical-align: middle; text-align: center;" |0x0D
 
| style="vertical-align: middle; text-align: center;" |0x0D
 
| style="vertical-align: middle; text-align: center;" |0x0E
 
| style="vertical-align: middle; text-align: center;" |0x0E
 +
| style="vertical-align: middle; text-align: center;" |0x0F
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Response Message Type
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Response Message Type
Line 2,825: Line 2,933:  
| style="vertical-align: middle; text-align: center;" | -
 
| style="vertical-align: middle; text-align: center;" | -
 
| style="vertical-align: middle; text-align: center;" |0x06 (if it is ACK) or 0x11 (if it is nACK)
 
| style="vertical-align: middle; text-align: center;" |0x06 (if it is ACK) or 0x11 (if it is nACK)
 +
| style="vertical-align: middle; text-align: center;" | -
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Command / Response size
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Command / Response size
Line 2,830: Line 2,939:  
| style="vertical-align: middle; text-align: center;" |Only Command
 
| style="vertical-align: middle; text-align: center;" |Only Command
 
| style="vertical-align: middle; text-align: center;" |Command/Response + IMEI
 
| style="vertical-align: middle; text-align: center;" |Command/Response + IMEI
 +
| style="vertical-align: middle; text-align: center;" |Command + IMEI
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Timestamp
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |Timestamp
Line 2,835: Line 2,945:  
| style="vertical-align: middle; text-align: center;" |Is Using
 
| style="vertical-align: middle; text-align: center;" |Is Using
 
| style="vertical-align: middle; text-align: center;" |Not Using
 
| style="vertical-align: middle; text-align: center;" |Not Using
 +
| style="vertical-align: middle; text-align: center;" |Is Using
 
|-
 
|-
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |IMEI
 
! rowspan="1" style="width:10%; vertical-align: middle; text-align: center;" |IMEI
 
| style="vertical-align: middle; text-align: center;" |Not Using
 
| style="vertical-align: middle; text-align: center;" |Not Using
 
| style="vertical-align: middle; text-align: center;" |Not Using
 
| style="vertical-align: middle; text-align: center;" |Not Using
 +
| style="vertical-align: middle; text-align: center;" |Is Using
 
| style="vertical-align: middle; text-align: center;" |Is Using
 
| style="vertical-align: middle; text-align: center;" |Is Using
 
|-
 
|-
Retrieved from "https://wiki.teltonika-gps.com/view/Special:MobileDiff/90056...93546"

Navigation menu