BOX tracker
Communication Protocol v1.5
10 of 36
If required the SIM number can be configured (via the
SIM_SN_ALWAYS command)
to always be present. This allows the SIM number to be used to identify the tracker
instead of the serial number.
Log Command (L)
L, <DataTime>,<DataItem>,<Values>[;<DataItem>,<Values>][;<DataItem>,<Values>]
The Log command is used to pass historical (or real-time) log entries recorded by BOX-tracker. The log
command consists of a single
L
character followed by the date and time, Data Item and its optional
parameters.
A single log command can contain multiple Data Items where each is separated by a semi-colon (
;
)
character (0x3B). A Data Item is only ever included once in a Log Command but each Data Item (listed
below) is not necessarily included in each log command nor can the order of the Data Items be assumed
to be consistent.
It is therefore important to parse the log command by splitting on semi-colons and checking the name of
each Data Item before handling the values associated with the Data Item.
Date Time
The date and time is always in the format
YYMMDDHHmmss
and is the time the log
record was made. If multiple Data Items are included in the log command then all were
recorded at this time.
Data Item
BOX-tracker can log a variety of Data Items, the name of which is passed prior to its
values. The Data Item name allows the server to identify how to handle its values. The
following Data Item names are currently used; additional Data Items may be used in the
future. (See later for a detailed description of each)
Name
Description
G
GPS position with event code, speed, direction and distance
END
End of journey information
DID
Driver ID as a string
GF
Geofence entry or exit
DI0
Digital Input 1 with a value of 0 or 1
DI1
Digital Input 2 with a value of 0 or 1
AI0
Analogue Input 1 with it integer value
AI1
Analogue Input 2 with it integer value
AI2
Analogue Input 3 with it integer value
AI3
Analogue Input 4 with it integer value
BOOT
Reboot reason
FAULT
Fault reason as a string
Values
The values passed after a Data Item name depends on the Data Item. Some may only have
a single value others may have many, each separated by a comma. See the following for
specific details of what is included.