State Miles - Virtual Channel 117 Binary Packet
State Miles Extract (SME):
The State Miles Extract is a binary message that is returned across the CI via 115/705. The binary data type (aka Virtual Channel) is 117.
1. Setup an ESS queue and subscribe to the T.2.10 transaction type. https://intinfo.omnitracs.com/display/iWebInt/T.2.10.0
2. Setup a dequeue2 process. Pickup only the virtualChannel 117 transactions. https://intinfo.omnitracs.com/display/iWebInt/Event+Subscription+Service
3. The msgBody is BASE64 encoded. The msgBody must be decoded to hex and then each data field converted to decimal.
4. T.2.10 Transaction
5. msgBody Data Layout. Attached is a spreadsheet that can assist in parsing the values. ParseSMILESMessages.xlsx
|
DATA FIELD
|
SIZE
|
DESCRIPTION
|
|---|---|---|
|
Current State Index |
2 bytes |
Index of the current state that the vehicle is in, or was in before a state border crossing event. |
|
New State Index |
2 bytes |
Index of the new state when the vehicle crosses over into a new state. |
|
Miles Travelled |
4 bytes |
Miles (represented as 1/10th miles) travelled in the current state since the last message. |
|
Starting Timestamp |
4 bytes |
Starting timestamp when vehicle started tracking miles since last event. The value is the GMT seconds since 01/01/1988. |
|
Ending Timestamp |
4 bytes |
Ending timestamp when vehicle stops tracking miles. The value is the GMT seconds since 01/01/1988. |
6. msgBodyBinary Example:
|
BASE64
|
HEX
|
|---|---|
|
BAAAAAKVMUWuFTFFvC4= |
0400000002953145ae153145bc2e |
|
FORMAT
|
CURRENT STATE
|
NEW STATE
|
MILES
|
STARTTS
|
ENDTS
|
|---|---|---|---|---|---|
|
HEX |
04 |
00 |
00000295 |
3145ae15 |
3145bc2e |
|
DEC |
04 |
00 |
66.1 |
826650133 or Wed Mar 12 13:02:13 EDT 2014 |
826653742 or Wed Mar 12 14:02:22 EDT 2014 |
7. State Miles Index
|
INDEX
|
STATE/PROVINCE
|
|---|---|
|
1 |
AL ALABAMA US-AL Alabama |
|
2 |
AK ALASKA US-AK Alaska |
|
4 |
AZ ARIZONA US-AZ Arizona |
|
5 |
AR ARKANSAS US-AR Arkansas |
|
6 |
CA CALIFORNIA US-CA California |
|
8 |
CO COLORADO US-CO Colorado |
|
9 |
CT CONNECTICUT US-CT Connecticut |
|
10 |
DE DELAWARE US-DE Delaware |
|
12 |
FL FLORIDA US-FL Florida |
|
13 |
GA GEORGIA US-GA Georgia |
|
15 |
HI HAWAII US-HI Hawaii |
|
16 |
ID IDAHO US-ID Idaho |
|
17 |
IL ILLINOIS US-IL Illinois |
|
18 |
IN INDIANA US-IN Indiana |
|
19 |
IA IOWA US-IA Iowa |
|
20 |
KS KANSAS US-KS Kansas |
|
21 |
KY KENTUCKY US-KY Kentucky |
|
22 |
LA LOUISIANA US-LA Louisiana |
|
23 |
ME MAINE US-ME Maine |
|
26 |
MI MICHIGAN US-MI Michigan |
|
27 |
MN MINNESOTA US-MN Minnesota |
|
28 |
MS MISSISSIPPI US-MS Mississippi |
|
29 |
MO MISSOURI US-MO Missouri |
|
30 |
MT MONTANA US-MT Montana |
|
31 |
NE NEBRASKA US-NE Nebraska |
|
32 |
NV NEVADA US-NV Nevada |
|
33 |
NH NEW HAMPSHIRE US-NH New Hampshire |
|
34 |
NJ NEW JERSEY US-NJ New Jersey |
|
35 |
NM NEW MEXICO US-NM New Mexico |
|
36 |
NY NEW YORK US-NY New York |
|
37 |
NC NORTH CAROLINA US-NC North Carolina |
|
38 |
ND NORTH DAKOTA US-ND North Dakota |
|
39 |
OH OHIO US-OH Ohio |
|
40 |
OK OKLAHOMA US-OK Oklahoma |
|
41 |
OR OREGON US-OR Oregon |
|
42 |
PA PENNSYLVANIA US-PA Pennsylvania |
|
44 |
RI RHODE ISLAND US-RI Rhode Island |
|
45 |
SC SOUTH CAROLINA US-SC South Carolina |
|
46 |
SD SOUTH DAKOTA US-SD South Dakota |
|
47 |
TN TENNESSEE US-TN Tennessee |
|
48 |
TX TEXAS US-TX Texas |
|
49 |
UT UTAH US-UT Utah |
|
50 |
VT VERMONT US-VT Vermont |
|
51 |
VA VIRGINIA US-VA Virginia |
|
53 |
WA WASHINGTON US-WA Washington |
|
54 |
WV WEST VIRGINIA US-WV West Virginia |
|
55 |
WI WISCONSIN US-WI Wisconsin |
|
56 |
WY WYOMING US-WY Wyoming |
|
11 |
DC D. OF COLUMBIA US-DC District of Columbia |
|
72 |
PR PUERTO RICO US-PR Puerto Rico |
|
57 |
AB ALBERTA CA-AB Alberta |
|
58 |
BC BRIT. COLUMBIA CA-BC British Columbia |
|
59 |
MB MANITOBA CA-MB Manitoba |
|
60 |
NB NEW BRUNSWICK CA-NB New Brunswick |
|
61 |
NF NEWFOUNDLAND CA-NL Newfoundland & Labrador |
|
62 |
NT NW TERRITORIES CA-NT Northwest Territories |
|
63 |
NS NOVA SCOTIA CA-NS Nova Scotia |
|
64 |
ON ONTARIO CA-ON Ontario |
|
65 |
PE PRINCE EDWARD CA-PE Prince Edward Island |
|
66 |
PQ QUEBEC CA-QC Quebec |
|
67 |
SK SASKATCHEWAN CA-SK Saskatchewan |
|
68 |
YT YUKON TERRITRY CA-YT Yukon Territory |
|
69 |
AG AGUASCALIENTES MX-AGU Aguascalientes |
|
70 |
BJ BAJA CAL. MX-BCN Baja California |
|
71 |
BS BAJA CAL. SUR MX-BCS Baja California Sur |
|
73 |
CM CAMPECHE MX-CAM Campeche |
|
74 |
CP CHIAPAS MX-CHP Chiapas |
|
75 |
CH CHIHUAHUA MX-CHH Chihuahua |
|
76 |
CU COAHUILA MX-COA Coahuila |
|
77 |
CL COLIMA MX-COL Colima |
|
78 |
DF DIST. FEDERAL MX-DIF Distrito Federal |
|
79 |
DU DURANGO MX-DUR Durango |
|
80 |
MX EDO. DE MEXICO MX-MEX México |
|
81 |
GJ GUANAJUATO MX-GUA Guanajuato |
|
82 |
GR GUERRERO MX-GRO Guerrero |
|
83 |
HD HIDALGO MX-HID Hidalgo |
|
84 |
JS JALISCO MX-JAL Jalisco |
|
85 |
MH MICHOACAN MX-MIC Michoacán |
|
86 |
MR MORELOS MX-MOR Morelos |
|
87 |
NR NAYARIT MX-NAY Nayarit |
|
88 |
NL NUEVO LEON MX-NLE Nuevo León |
|
89 |
OX OAXACA MX-OAX Oaxaca |
|
90 |
PB PUEBLA MX-PUE Puebla |
|
91 |
QT QUERETARO MX-QUE Queretaro |
|
92 |
QR QUINTANA ROO MX-ROO Quintana Roo |
|
93 |
SP S. LUIS POTOSI MX-SLP San Luis Potosí |
|
94 |
SN SINALOA MX-SIN Sinaloa |
|
95 |
SR SONORA MX-SON Sonora |
|
96 |
TB TABASCO MX-TAB Tabasco |
|
97 |
TP TAMAULIPAS MX-TAM Tamaulipas |
|
98 |
TL TLAXCALA MX-TLA Tlaxcala |
|
99 |
VC VERACRUZ MX-VER Veracruz |
|
100 |
YU YUCATAN MX-YUC Yucatán |
|
101 |
ZA ZACATECAS MX-ZAC Zacatecas |