Changes

VCode (view source)

Revision as of 21:49, 4 October 2019

1,279 bytes removed ,  21:49, 4 October 2019
→‎Codec 8
Line 25: Line 25:     
Below table represents AVL data packet structure.
 
Below table represents AVL data packet structure.
 +
 +
'''Example'''
 +
 +
Received data:
 +
 +
 +
 +
<span style="background-color: #848484">00000000</span><span style="background-color: #A9BCF5">0000008c</span><span style="background-color: #04B45F">08</span><span style="background-color: #FF0000">01</span><span style="background-color: #9F81F7">0000013feb55ff74</span><span style="background-color: #D8D8D8">00</span><span style="background-color: #FFFF00">0f0ea850</span><span style="background-color: #FAAC58">209a6900</span><span style="background-color: #2EFE2E">0094</span><span style="background-color: #088A29">0000</span>120000<span style="background-color: #0040FF">00</span>
 +
 +
<span style="background-color: #A9A9F5">1e</span><span style="background-color: #DF3A01">09</span>010002000300040016014703f0001504c800<span style="background-color: #DF3A01">0c</span>0900730a00460b00501300464306
 +
 +
d7440000b5000bb60007422e9
 +
f180000cd0386ce0001<span style="background-color: #DF3A01">07</span>c700000000f10000601a4600
 +
 +
0001344800000bb84900000bb84a00000bb84c00000000<span style="background-color: #DF3A01">02</span>4e0000000000000000cf00
 +
 +
00000000000000<span style="background-color: #FF0000">01</span><span style="background-color: #F5DA81">00003fca</span>
 +
 +
In total 152 Bytes 
 
{| class="wikitable"
 
{| class="wikitable"
−
! 4 zeros
+
| style="background: white; color: #0052A1"|
−
(4 bytes)
+
4 zeros(4 bytes)
−
!
+
| style="background: white; color: #0052A1"|
−
!
+
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #848484">00000000</span> 4 zeroes, 4 bytes
 
|-
 
|-
−
| Data field length
+
| style="background: white; color: #0052A1"|
−
(4 bytes)
+
Data field length(4 bytes)
−
|  
+
| style="background: white; color: #0052A1"|
−
|  
+
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #A9BCF5">0000008c</span> data length, 4 bytes
 
|-
 
|-
−
| Codec ID
+
| style="background: white; color: #0052A1"|
−
(1 byte)
+
Codec ID(1 byte)
−
|  
+
| style="background: white; color: #0052A1"|
−
|  
+
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #04B45F">08</span> – Codec ID
 
|-
 
|-
−
| Number of Data 1
+
| style="background: white; color: #0052A1"|
−
(1 byte)
+
Number of Data 1(1 byte)
−
|  
+
| style="background: white; color: #0052A1"|
−
|  
+
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #FF0000">01</span>    Number of Data (1 record) 1’st record data
 
|-
 
|-
−
| rowspan="9" | AVL Data
+
| rowspan="9" style="background: white; color: #0052A1"|AVL Data(30-147 bytes)
−
(30-147 bytes)
+
| style="background: white; color: #0052A1"|Timestamp(8 bytes)
−
| Timestamp
+
| style="background: white; color: #0052A1"|
−
(8 bytes)
+
| <span style="background-color: #9F81F7">010000013feb55ff74</span> – Timestamp in milliseconds (1374042849140)
−
|  
+
GMT: Wed, 17 Jul 2013 06:34:09 GMT
 
|-
 
|-
−
| Priority
+
| style="background: white; color: #0052A1"|Priority(1 byte)
−
(1 byte)
+
| style="background: white; color: #0052A1"|
−
|  
+
| <span style="background-color: #D8D8D8">00</span> – Priority
 
|-
 
|-
−
| rowspan="6" | GPS Element
+
| style="background: white; color: #0052A1" rowspan="6" | GPS Element(15 bytes)
−
(15 bytes)
+
| style="background: white; color: #0052A1"|
−
| Longitude
+
Longitude
 
(4 bytes)
 
(4 bytes)
 +
| <span style="background-color: #FFFF00">0f0ea850</span>    – Longitude 252618832 = 25,2618832º N
 
|-
 
|-
−
| Latitude
+
| style="background: white; color: #0052A1"|
 +
Latitude
 
(4 bytes)
 
(4 bytes)
 +
| <span style="background-color: #FAAC58">209a6900</span>    – Latitude 546990336 = 54,6990336 º E
 
|-
 
|-
−
| Altitude
+
| style="background: white; color: #0052A1"|
 +
Altitude
 
(2 bytes)
 
(2 bytes)
 +
| <span style="background-color: #2EFE2E">0094</span>        – Altitude 148 meters
 
|-
 
|-
−
| Angle  
+
| style="background: white; color: #0052A1"|
 +
Angle  
 
(2 bytes)
 
(2 bytes)
 +
| <span style="background-color: #088A29">0000</span>    – Angle 0
 
|-
 
|-
−
| Satellites
+
| style="background: white; color: #0052A1"|
 +
Satellites
 
(1 bytes)
 
(1 bytes)
 +
| <span style="background-color: #088A29">12</span>    – 18 Visible satellites
 
|-
 
|-
−
| Speed
+
| style="background: white; color: #0052A1"|
 +
Speed
 
(2 bytes)
 
(2 bytes)
 +
| <span style="background-color: #088A29">0000</span>    – 0 km/h speed
 
|-
 
|-
−
| IO Element
+
| style="background: white; color: #0052A1"|IO Element
 
(6-123 bytes)
 
(6-123 bytes)
−
|  
+
| style="background: white; color: #0052A1"|
−
|-
+
| <span style="background-color: #0040FF">00</span> – IO element ID of Event generated (in this case when 00 – data generated not on event)
−
| Number of Data 2
  −
(1 byte)
  −
|
  −
|
  −
|-
  −
| CRC-16
  −
(4 bytes)
  −
|
  −
|
  −
|}
  −
Number of data – number of encoded data (number of records).
  −
Codec ID is constant 08.
  −
 
  −
Data field length is the length of bytes [codec id, number of data 2].
  −
Number of data 1 should always be equal to number of data 2 byte.
  −
CRC-16 is 4 bytes, but first two are zeroes and last two are CRC-16 calculated for [codec id, number of data 2]
  −
Minimum AVL packet size is 45 bytes (all IO elements disabled).
  −
Maximum AVL packet size for one record is 783 bytes.
  −
 
  −
 
  −
*''AVL data''
  −
 
  −
{| class="wikitable"
  −
|-
  −
! style="background: white; color: #0052A1"| Timestamp
  −
! style="background: white; color: #0052A1"| Priority
  −
! style="background: white; color: #0052A1"| GPS Element
  −
! style="background: white; color: #0052A1"| IO element
  −
|-
  −
| 8 bytes || 1 byte || 15 bytes || 6-123
  −
|}
  −
 
  −
 
  −
Timestamp – difference, in milliseconds, between the current time and midnight, January 1, 1970 UTC
  −
 
  −
*''Priority''
  −
 
  −
 
  −
{| class="wikitable"
  −
|-
  −
 
  −
|-
  −
| style="background: white; color: #0052A1"|0 || Low
  −
|-
  −
| style="background: white; color: #0052A1"|1 || High
  −
|-
  −
| style="background: white; color: #0052A1"|2 || Panic
  −
|}
  −
 
  −
 
  −
*''GPS Element''
  −
 
  −
 
  −
{| class="wikitable"
  −
|-
  −
! style="background: white; color: #0052A1"| Longitude
  −
! style="background: white; color: #0052A1"| Latitude
  −
! style="background: white; color: #0052A1"| Altitude
  −
! style="background: white; color: #0052A1"| Angle
  −
! style="background: white; color: #0052A1"| Satellites
  −
! style="background: white; color: #0052A1"| Speed
  −
|-
  −
| 4 bytes || 4 bytes || 2 bytes || 2 bytes || 1 bytes || 2 bytes
  −
|}
  −
 
  −
X    Longitude
  −
 
  −
Y    Latitude1
  −
 
  −
Altitude    In meters above sea level1
  −
 
  −
Angle    In degrees, 0 is north, increasing clock-wise 1
  −
 
  −
Satellites    Number of visible satellites1
  −
 
  −
Speed in km/h. 0x0000 if GPS data is invalid1
  −
 
  −
Longitude and latitude are integer values built from degrees, minutes, seconds and milliseconds by formula
  −
 
  −
[[Image:197.png]]
  −
 
  −
d -    Degrees
  −
 
  −
m -    Minutes
  −
 
  −
s -    Seconds
  −
 
  −
ms -    Milliseconds
  −
 
  −
p -    Precision (10000000)
  −
 
  −
If longitude is in west or latitude in south, multiply result by –1. To determine if the coordinate is negative, convert it to binary format and check the very first bit. If it is 0, coordinate is positive, if it is 1, coordinate is negative.
  −
 
  −
Example:
  −
  −
Received value: 20 9c ca 80
  −
Converted to BIN: 00100000 10011100 11001010 10000000 first bit is 0, which means coordinate is positive
  −
Converted to DEC: 547146368
  −
For more information see two‘s complement arithmetics.
  −
 
  −
 
  −
*''IO Element''
  −
 
  −
{| class="wikitable"
  −
|-
  −
 
  −
| style="background: white; color: #0052A1"|Event IO ID || 1 byte || rowspan="8" |
  −
<span style="background-color: #0040FF">00</span> – IO element ID of Event generated (in this case when 00 – data generated not on event)
      
<span style="background-color: #A9A9F5">1e</span> – 30 IO elements in record (total)
 
<span style="background-color: #A9A9F5">1e</span> – 30 IO elements in record (total)
Line 228: Line 154:     
0    – IO element’s value = 0
 
0    – IO element’s value = 0
−
  −
|-
  −
| style="background: white; color: #0052A1"|N of Total IO || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|N1 of One Byte IO || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|1’st  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|1’st IO Value || 1 byte
  −
|-
  −
| ... ||
  −
|-
  −
| style="background: white; color: #0052A1"|N1’th  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|N1’th IO Value || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|N2 of Two Bytes || 1 byte || rowspan="6" |
      
<span style="background-color: #DF3A01">0c</span>    – 12 IO elements, which value length is 2 Bytes
 
<span style="background-color: #DF3A01">0c</span>    – 12 IO elements, which value length is 2 Bytes
Line 295: Line 204:     
0    – IO element’s value
 
0    – IO element’s value
−
  −
|-
  −
| style="background: white; color: #0052A1"|1’st  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|1’st IO Value || 2 bytes
  −
|-
  −
| |... ||
  −
|-
  −
| style="background: white; color: #0052A1"|N2’th  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|N2’th IO Value || 2 bytes
  −
|-
  −
| style="background: white; color: #0052A1"|N4 of Four Bytes || 1 byte || rowspan="6" |
      
<span style="background-color: #DF3A01">07</span> – 7 IO elements, which value length is 4 Bytes
 
<span style="background-color: #DF3A01">07</span> – 7 IO elements, which value length is 4 Bytes
Line 338: Line 234:     
1    – IO element’s value
 
1    – IO element’s value
−
  −
|-
  −
| style="background: white; color: #0052A1"|1’st  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|1’st IO Value || 4 byte
  −
|-
  −
| |... ||
  −
|-
  −
| style="background: white; color: #0052A1"|N4’th  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|N4’th IO Value || 4 bytes
  −
|-
  −
| style="background: white; color: #0052A1"|N8 of Eight Bytes || 1 byte || rowspan="6" |
      
<span style="background-color: #DF3A01">02</span> – 2 IO elements, which value length is 8 Bytes
 
<span style="background-color: #DF3A01">02</span> – 2 IO elements, which value length is 8 Bytes
Line 361: Line 244:     
0    – IO element’s value
 
0    – IO element’s value
−
  −
  −
|-
  −
| style="background: white; color: #0052A1"|1’st  IO ID || 1 byte
  −
|-
  −
| style="background: white; color: #0052A1"|1’st IO Value || 8 bytes
   
|-
 
|-
−
| |... ||  
+
| style="background: white; color: #0052A1"|Number of Data 2(1 byte)
 +
| style="background: white; color: #0052A1"|
 +
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #FF0000">01</span>    – Number of Data (1 record)
 
|-
 
|-
−
| style="background: white; color: #0052A1"|N8’th  IO ID || 1 byte
+
| style="background: white; color: #0052A1"|CRC-16(4 bytes)
−
|-
+
| style="background: white; color: #0052A1"|
−
| style="background: white; color: #0052A1"|N8’th IO Value || 8 bytes
+
| style="background: white; color: #0052A1"|
 +
| <span style="background-color: #F5DA81">00003fca</span>    - CRC-16, 4 Bytes (first 2 are always zeros)
 
|}
 
|}
−
Event IO ID – if data is acquired on event – this field defines which IO property has changed and generated an event. If data cause is not event – the value is 0.
+
Number of data – number of encoded data (number of records).
 +
Codec ID is constant 08.
   −
N    total number of properties coming with record (N=N1+N2+N4+N8)
+
Data field length is the length of bytes [codec id, number of data 2].
 +
Number of data 1 should always be equal to number of data 2 byte.
 +
CRC-16 is 4 bytes, but first two are zeroes and last two are CRC-16 calculated for [codec id, number of data 2]
 +
Minimum AVL packet size is 45 bytes (all IO elements disabled).
 +
Maximum AVL packet size for one record is 783 bytes.
   −
N1    number of properties, which length is 1 byte
     −
N2    number of properties, which length is 2 bytes
+
Timestamp – difference, in milliseconds, between the current time and midnight, January 1, 1970 UTC
   −
N4    number of properties, which length is 4 bytes
+
*''Priority''
   −
N8    number of properties, which length is 8 bytes
+
Priority level (AVL packet priority) can be:
 +
*Low Priority
 +
**Module makes an additional record with an indication that the event was caused by an I/O element change (depending on Operands configuration).
 +
*High Priority
 +
**Module makes an additional record with High priority flag and sends event packet immediately to the server using GPRS.
 +
*Panic Priority
 +
**This priority triggers same actions as High priority, but if GPRS fails, it sends an AVL packet using SMS data if SMS data sending is enabled and the number is provided in SMS/Call Settings.
      −
'''Example'''
     −
Received data:
+
*''GPS Element''
    +
X    Longitude
    +
Y    Latitude1
   −
<span style="background-color: #848484">00000000</span><span style="background-color: #A9BCF5">0000008c</span><span style="background-color: #04B45F">08</span><span style="background-color: #FF0000">01</span><span style="background-color: #9F81F7">0000013feb55ff74</span><span style="background-color: #D8D8D8">00</span><span style="background-color: #FFFF00">0f0ea850</span><span style="background-color: #FAAC58">209a6900</span><span style="background-color: #2EFE2E">0094</span><span style="background-color: #088A29">0000</span>120000<span style="background-color: #0040FF">00</span>
+
Altitude    In meters above sea level1
   −
<span style="background-color: #A9A9F5">1e</span><span style="background-color: #DF3A01">09</span>010002000300040016014703f0001504c800<span style="background-color: #DF3A01">0c</span>0900730a00460b00501300464306
+
Angle    In degrees, 0 is north, increasing clock-wise 1
   −
d7440000b5000bb60007422e9
+
Satellites    Number of visible satellites1
−
f180000cd0386ce0001<span style="background-color: #DF3A01">07</span>c700000000f10000601a4600
     −
0001344800000bb84900000bb84a00000bb84c00000000<span style="background-color: #DF3A01">02</span>4e0000000000000000cf00
+
Speed in km/h. 0x0000 if GPS data is invalid1
   −
00000000000000<span style="background-color: #FF0000">01</span><span style="background-color: #F5DA81">00003fca</span>
+
Longitude and latitude are integer values built from degrees, minutes, seconds and milliseconds by formula
   −
In total 152 Bytes
+
[[Image:197.png]]
    +
d -    Degrees
   −
<span style="background-color: #848484">00000000</span> 4 zeroes, 4 bytes
+
m -   Minutes
   −
<span style="background-color: #A9BCF5">0000008c</span> data length, 4 bytes
+
s -   Seconds
   −
<span style="background-color: #04B45F">08</span> – Codec ID
+
ms -   Milliseconds
   −
<span style="background-color: #FF0000">01</span>   Number of Data (1 record) 1’st record data
+
p -    Precision (10000000)
    +
If longitude is in west or latitude in south, multiply result by –1. To determine if the coordinate is negative, convert it to binary format and check the very first bit. If it is 0, coordinate is positive, if it is 1, coordinate is negative.
   −
 
+
Example:
−
<span style="background-color: #9F81F7">010000013feb55ff74</span> – Timestamp in milliseconds (1374042849140)
+
−
 
+
Received value: 20 9c ca 80
−
GMT: Wed, 17 Jul 2013 06:34:09 GMT
+
Converted to BIN: 00100000 10011100 11001010 10000000 first bit is 0, which means coordinate is positive
−
 
+
Converted to DEC: 547146368
−
<span style="background-color: #D8D8D8">00</span> – Priority
+
For more information see two‘s complement arithmetics.
−
 
  −
GPS Element
  −
 
  −
<span style="background-color: #FFFF00">0f0ea850</span>    – Longitude 252618832 = 25,2618832º N
  −
 
  −
<span style="background-color: #FAAC58">209a6900</span>    – Latitude 546990336 = 54,6990336 º E
  −
 
  −
<span style="background-color: #2EFE2E">0094</span>        – Altitude 148 meters
  −
 
  −
<span style="background-color: #088A29">0000</span>    – Angle 0
  −
 
  −
<span style="background-color: #088A29">12</span>    – 18 Visible satellites
  −
 
  −
<span style="background-color: #088A29">0000</span>    – 0 km/h speed
  −
 
  −
IO Element
  −
<span style="background-color: #FF0000">01</span>    – Number of Data (1 record)
  −
 
  −
<span style="background-color: #F5DA81">00003fca</span>    - CRC-16, 4 Bytes (first 2 are always zeros)
       
Retrieved from "https://wiki.teltonika-networks.com/view/Special:MobileDiff/45808...45818"

Navigation menu