Jump to content

VCode: Difference between revisions

 
(7 intermediate revisions by the same user not shown)
Line 44: Line 44:


In total 152 Bytes   
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
| <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
| <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
| <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
| <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)
| <span style="background-color: #9F81F7">010000013feb55ff74</span> – Timestamp in milliseconds (1374042849140)
GMT: Wed, 17 Jul 2013 06:34:09 GMT
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
| <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
| <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
| <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
| <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
| <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
| <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
| <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)
| <span style="background-color: #0040FF">00</span> – IO element ID of Event generated (in this case when 00 – data generated not on event)


Line 244: Line 245:
0    – IO element’s value
0    – IO element’s value
|-
|-
| Number of Data 2
| style="background: white; color: #0052A1"|Number of Data 2(1 byte)
(1 byte)
| style="background: white; color: #0052A1"|
|  
| style="background: white; color: #0052A1"|
|  
| <span style="background-color: #FF0000">01</span>    – Number of Data (1 record)
| <span style="background-color: #FF0000">01</span>    – Number of Data (1 record)
|-
|-
| CRC-16
| style="background: white; color: #0052A1"|CRC-16(4 bytes)
(4 bytes)
| style="background: white; color: #0052A1"|
|  
| style="background: white; color: #0052A1"|
|  
| <span style="background-color: #F5DA81">00003fca</span>    - CRC-16, 4 Bytes (first 2 are always zeros)
| <span style="background-color: #F5DA81">00003fca</span>    - CRC-16, 4 Bytes (first 2 are always zeros)
|}
|}
Line 264: Line 263:
Minimum AVL packet size is 45 bytes (all IO elements disabled).
Minimum AVL packet size is 45 bytes (all IO elements disabled).
Maximum AVL packet size for one record is 783 bytes.
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
|}




Line 283: Line 269:
*''Priority''
*''Priority''


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.


{| 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''
*''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  
X    Longitude  
Line 345: Line 315:
Converted to DEC: 547146368
Converted to DEC: 547146368
For more information see two‘s complement arithmetics.
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: #DF3A01">09</span> – 9 IO elements, which length is 1 Byte
0    – IO element ID = 01
0    – IO element’s value = 0
02    – IO element ID = 02
0    – IO element’s value = 0
03    – IO element ID = 03
0    – IO element’s value = 0
4    – IO element ID = 04
0    – IO element’s value = 0
16    – IO element ID = 22 (dec)
0    – IO element’s value = 1
47    – IO element ID = 71 (dec)
03    – IO element’s value = 3
F0    – IO element ID = 240 (dec)
0    – IO element’s value = 0
15    – IO element ID = 21 (dec)
04    – IO element’s value = 0
C8    – IO element ID = 200 (dec)
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
09    – IO element ID = 9 (dec)
0073    – IO element’s value
0a    – IO element ID = 10 (dec)
0046    – IO element’s value
0b    – IO element ID = 11 (dec)
0050    – IO element’s value
13    – IO element ID = 19 (dec)
0046    – IO element’s value
43    – IO element ID = 67 (dec)
06d7    – IO element’s value
1    – IO element ID = 68 (dec)
0    – IO element’s value
B5    – IO element ID = 181 (dec)
000b    – IO element’s value
B6    – IO element ID = 182 (dec)
0007    – IO element’s value
42    – IO element ID = 66 (dec)
2e9f    – IO element’s value
2    – IO element ID = 24 (dec)
0    – IO element’s value
cd    – IO element ID = 205 (dec)
3    – IO element’s value
CE    – IO element ID = 206 (dec)
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
C7        – IO element ID = 199 (dec)
0    – IO element’s value
f1        – IO element ID = 241 (dec)
0000601a    – IO element’s value
46        – IO element ID = 70 (dec)
00000134    – IO element’s value
48        – IO element ID = 72 (dec)
00000bb8    – IO element’s value
4    – IO element ID = 73 (dec)
00000bb8    – IO element’s value
4a        – IO element ID = 74 (dec)
00000bb8    – IO element’s value
4c        – IO element ID = 76 (dec)
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
4e            – IO element ID = 78 (dec)
0    – IO element’s value
cf            – IO element ID = 207 (dec)
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"|N8’th  IO ID || 1 byte
|-
| style="background: white; color: #0052A1"|N8’th IO Value || 8 bytes
|}
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.
N    total number of properties coming with record (N=N1+N2+N4+N8)
N1    number of properties, which length is 1 byte
N2    number of properties, which length is 2 bytes
N4    number of properties, which length is 4 bytes
N8    number of properties, which length is 8 bytes
'''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
<span style="background-color: #848484">00000000</span> 4 zeroes, 4 bytes
<span style="background-color: #A9BCF5">0000008c</span> data length, 4 bytes
<span style="background-color: #04B45F">08</span> – Codec ID
<span style="background-color: #FF0000">01</span>    Number of Data (1 record) 1’st record data
<span style="background-color: #9F81F7">010000013feb55ff74</span> – Timestamp in milliseconds (1374042849140)
GMT: Wed, 17 Jul 2013 06:34:09 GMT
<span style="background-color: #D8D8D8">00</span> – Priority
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)