Skip to main content
Omnitracs Knowledge Base

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.
 
2.  Setup a dequeue2 process. Pickup only the virtualChannel 117 transactions.
 
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
T2.10.JPG
 

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. 
Possible values:
0:  Unknown State
A valid index that resolves to a valid state/province.  See chart below.

New State Index

2 bytes

Index of the new state when the vehicle crosses over into a new state. 
Possible values:
0:  Unknown State  (new state will be zero for miles within the same state)
A valid index that resolves to a valid state/province.  See chart below.

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

  • Was this article helpful?