ATrack AP1
Make your ATrack AP1 devices a part of any infrastructure by connecting them via flespi telematics hub. Manage the
device settings using flespi device
management platform. Learn how
to configure ATrack AP1 with flespi.
Usage specifics
Parameters (179)
Settings (9)
Commands (1)
ATrack AP1
Flespi parses telemetry data from your ATrack AP1 into a standardized JSON and
lets you send commands to ATrack AP1 via API.
Here’s the like of JSON you get
{
"ident": "352625333222111",
"position.altitude": 273.61,
"position.hdop": 0.7,
"position.latitude": 49.069782,
"position.longitude": 28.632826,
"position.satellites": 18,
"server.timestamp": 1650636570.426424,
"timestamp": 1650636570.426424,
"device.type.id": "ATrack AP1",
"channel.id": 1111,
"protocol.id": "atrack"
"engine.ignition.status": true
...
}
How to consume this nice JSON
The easiest way is to make a REST API request like this
curl -X GET --header 'Authorization: FlespiToken XXX' 'https://flespi.io/gw/devices/<device id>/messages'
How to send commands to ATrack AP1?
You can send a specific command.
Show all commands
You can use pre-defined settings to send instructions more conveniently.
Show all settings
You can also
Modify messages
Add or remove parameters, inject data from LBS and reverse-geocoding services, etc.
Learn what plugins can do
Aggregate data
Determine trips and stops, catch events, detect geofence ins/outs, and more.
Learn about flespi analytics capabilities acceleration.array
array
g
Array of objects with acceleration data by x, y, and z axis
accelerometer.data.seqnum
number
Sequence number of acceleration data package
ain
number
volts
Voltage on the analog input
Data field %AI,
Data field %AV
Data field %AV
ain.voltage.high.status
boolean
Analog input's voltage is above the threshold
Data field %AG
autogeofence.status
boolean
Auto Geo-Fence Area status
Data field %PK
backup.battery.voltage
number
volts
Backup battery voltage
Data field %BV
battery.low.status
boolean
Battery low status
Data field %BL
ble.beacons
array
Array with all detected BLE beacons data objects. Each object contain list of associated parameters sent by appropriate beacon.
Standard parameter names used:
*id* - beacon identification string. Usually it is beacon's UUID or MAC-address
*local_name* - Beacons's Local Name
*rssi* - BLE signal level. Units = dBm
*battery.voltage* - Beacon's battery voltage. Units = volts
*battery.level* - Beacon's battery level. Units = percentage
*temperature* - Beacon's temperature. Units = celsius
bluetooth.connected.status
boolean
Bluetooth connection status
Data field %BT
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
Data field %JH
can.axle.weight
number
kg
Weight on the axle read from CAN
Data field %JH
can.cruise.control.mileage
number
km
CAN-bus Cruise Control Distance
Data field %JN
can.cruise.status
boolean
CAN cruise control is active
Data field %JO
can.driver.card.status
boolean
CAN-bus driver card presence
Data field %JO
can.driver.time.related.status
number
CAN-bus driver time related states Indicating whether the driver approaches or exceeds working time limits. 0=normal;1=15min before4.5h;2=4.5h reached;3=15min before 9h ;4=9h reached;5=15min before16h;6=16h reached;14=Error;15=not available
Data field %JO
can.driver.work.state.enum
number
CAN-bus driver working state: 0=Rest;1=Driver available;2=Work;3=Drive;6=Error;7=Not available
Data field %JO
can.dtc
array
Diagnostic trouble code array read from CAN
can.dtc.cleared.mileage
number
km
Vehicle mileage since diagnostic trouble codes were cleared, read from CAN
Data field %DC
can.dtc.pending.status
boolean
Pending DTC status read from CAN
Data field %PD
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
Data field %JO
can.engine.load.level
number
percentage
Calculated engine load level read from CAN
Data field %JO
can.engine.motorhours
number
hours
Total engine motorhours (engine work time) read from CAN
Data field %EH
can.engine.temperature
number
celsius
Engine temperature read from CAN
Data field %ET
can.fms.diagnostic.state
number
Status signal indicates whether the FMS Vehicle Interface supports the handling of diagnostic messages from the vehicle network onto the FMS network
Data field %JO
can.fms.request.state
number
The status signal indicates whether the FMS Vehicle Interface will respond to requests from the FMS device for the PGNs listed in the FMS Interface Specification.
Data field %JO
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
Data field %FC
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
Data field %JH
can.fuel.economy
number
km/liters
CAN instantaneous fuel economy
Data field %JH
can.fuel.idle.consumed
number
liters
Fuel volume totally consumed during idling state of the vehicle read from CAN
Data field %JN
can.fuel.level
number
percentage
Fuel level in tank read from CAN
Data field %JO
can.handling.info.status
boolean
CAN-bus handling information
Data field %JO
can.intake.air.temperature
number
celsius
Intake air temperature
Data field %IA
can.intake.map
number
kPa
Intake manifold absolute pressure
Data field %MP
can.j1708.abs.state
number
CAN J1708 ABS control state bitmask
Data field %ZO
can.j1708.accelerator.pedal.level
number
percentage
CAN J1708 accelerator pedal position
Data field %ZO
can.j1708.boost.pressure
number
kPa
CAN J1708 boost pressure
Data field %ZO
can.j1708.brake.pressure
number
kPa
CAN J1708 brake application pressure
Data field %ZO
can.j1708.brake.primary.pressure
number
kPa
CAN J1708 brake primary pressure
Data field %ZO
can.j1708.brake.secondary.pressure
number
kPa
CAN J1708 brake secondary pressure
Data field %ZO
can.j1708.brake.stroke.state
number
CAN J1708 brake stroke state bitmask
Data field %ZO
can.j1708.cargo.weight
number
N
CAN J1708 cargo weight
Data field %ZH
can.j1708.cruise.control.state
number
CAN J1708 cruise control state bitmask
Data field %ZO
can.j1708.engine.coolant.temperature
number
celsius
CAN J1708 engine coolant temperature
Data field %ZO
can.j1708.engine.load
number
percentage
CAN J1708 engine load
Data field %ZO
can.j1708.engine.motorhours
number
hours
CAN J1708 calculated engine motorhours
Data field %ZL
can.j1708.engine.oil.pressure
number
kPa
CAN J1708 engine oil pressure
Data field %ZO
can.j1708.engine.rpm
number
rpm
CAN J1708 engine RPM
Data field %ZH
can.j1708.fuel.level
number
percentage
CAN J1708 fuel level
Data field %ZO
can.j1708.fuel.rate
number
10e-6L/s
CAN J1708 instantaneous fuel rate
Data field %ZH
can.j1708.fuel.used
number
liters
CAN J1708 total fuel used
Data field %ZL
can.j1708.fuel.used.idle
number
liters
CAN J1708 total idle fuel used
Data field %ZL
can.j1708.idle.motorhours
number
hours
CAN J1708 total idle hours
Data field %ZL
can.j1708.intake.manifold.temperature
number
celsius
CAN J1708 intake manifold temperature
Data field %ZO
can.j1708.mil.state
number
CAN J1708 malfunction attention/warning indicator lamps state bitmask
Data field %ZO
can.j1708.parking.brake.state
number
CAN J1708 parking brake switch state bitmask
Data field %ZO
can.j1708.throttle.pedal.level
number
percentage
CAN J1708 throttle pedal position
Data field %ZO
can.j1708.vehicle.mileage
number
km
CAN J1708 vehicle mileage
Data field %ZL
can.j1708.vehicle.motorhours
number
hours
CAN J1708 total vehicle hours
Data field %ZL
can.j1708.vehicle.speed
number
km/h
CAN J1708 vehicle speed
Data field %ZO
can.j1708.vehicle.vin
string
CAN J1708 vehicle VIN
Data field %ZS
can.j1939.engine.fuel.total
number
liters
CAN-ubs J1939 FMS engine total fuel used
Data field %JL
can.j1939.engine.motorhours
number
hours
CAN J1939 calculated engine motorhours
Data field %JL
can.j1939.engine.rpm
number
rpm
CAN J1939 engine RPM
Data field %JH
can.j1939.fuel.consumed
number
liters
CAN J1939 fuel volume consumed by vehicle
Data field %JL
can.j1939.software.version
string
CAN-bus J1939 FMS SW-version
Data field %JS
can.j1939.vehicle.mileage
number
km
CAN J1939 vehicle mileage
Data field %JL
can.j1939.vehicle.speed
number
km/h
CAN J1939 vehicle speed
Data field %JH
can.j1939.vehicle.vin
string
CAN J1939 vehicle VIN
Data field %JS
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
Data field %MF
can.mil.bitmask
number
Malfunction indicator lamps state bitmask, read from CAN
can.mil.status
boolean
Malfunction indicator lamp status read from CAN
Data field %ML
can.movement.status
boolean
CAN-bus current movement state
Data field %JO
can.overspeeding.status
boolean
CAN-bus ovespeeding status
Data field %JO
can.pedal.brake.status
boolean
CAN brake pedal pressed
Data field %JO
can.pedal.clutch.status
boolean
CAN clutch pedal pressed
Data field %JO
can.pending.dtc
string
Pending diagnostic trouble code read from CAN
Data field %PD
can.powersource.takeoff.engaged.status
boolean
CAN-bus at least one PTO engaged
Data field %JO
can.powersource.takeoff.enum
number
CAN power takeoff bitmask
Data field %JO
can.powesource.takeof.duration
number
hours
PTO total duration read from CAN
Data field %JN
can.powesource.takeof.fuel.consumed
number
liters
CAN-bus Fuel Used During PTO
Data field %JN
can.reverse.gear.status
boolean
CAN reverse gear is on
Data field %JO
can.service.mileage
number
km
Service distance read from CAN
Data field %JH
can.tacho.event
boolean
CAN-bus Tachograph system event
Data field %JO
can.tacho.performance
number
CAN-bus Tachograph performance: 0=normal;1=analysis
Data field %JO
can.tacho.position.speed
number
km/h
CAN-bus Tachograph vehicle speed
Data field %JH
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
Data field %JO
can.total.engine.idle.time
number
hours
Time of engine running in idling status (vehicle stopped) since vehicle manufacture, read from CAN
Data field %JN
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
Data field %EO
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
Data field %ES
channel.id
number
ID of channel that received a message
counter.impulses
number
Impulses counter
Data field %PC
custom
any
Any custom parameter
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
Data field %IN
dout
number
Digital outputs bitmask
Data field %OP
driver.id
string
Driver identification card id
Data field %DD,
Data field %JS
Data field %JS
driver.message
string
Driver text message content
engine.ignition.status
boolean
Engine ignition or ACC status
Data field %EG
engine.motorhours
number
hours
Total calculated engine motorhours
Data field %EH
event.seqnum
number
Unique event sequence number
external.powersource.level
number
percentage
External battery level
Data field %BP
external.powersource.status
boolean
External power source connection status
Data field %PS
external.powersource.voltage
number
volts
External power voltage
Data field %MV
fuel.level
number
percentage
Fuel level percentage
Data field %FL
fuel.sensor.status
boolean
Fuel sensor event status
Data field %FU
geofence.status
boolean
Geofence entered status
Data field %GF
gnss.antenna.short.circuit.status
boolean
GNSS antenna short circuit status
Data field %SS
gnss.antenna.signal.timeout.status
boolean
GNSS antenna signal reception timeout status
Data field %SS
gnss.antenna.status
boolean
GNSS receiver antenna status
Data field %SS
gnss.fix.duration
number
seconds
Time used to fetch device GNSS position ("Time to GPS fix")
Data field %FT
gnss.fix.status
boolean
GNSS fix status
Data field %SF
gnss.status
boolean
GNSS receiver on/off status
Data field %SS
gprs.status
boolean
GPRS mobile network status
Data field %CG
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Data field %CE
gsm.home.network.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) home network registration event
Data field %CR
gsm.jamming.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal jamming detected
Data field %JD
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Data field %LC
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Data field %CN
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Data field %CN
gsm.operator.code
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator code, which is MCC joined with MNC
Data field %CN
gsm.preferred.network.status
boolean
Preferred Mobile network (GSM, 3G, 4G, LTE, 5G, ...) status
Data field %PF
gsm.roaming.network.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) home roaming registration event
Data field %RO
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Data field %RL
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Data field %GQ
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Data field %CD
gsm.sim.imsi
string
IMSI of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Data field %CM
gsm.state.enum
number
Mobile network module state
Data field %GS
gsm.state.enum.description
string
Mobile network module state description
Data field %GS
harsh.acceleration.event
boolean
Harsh acceleration detected
Data field %HA
harsh.braking.event
boolean
Harsh braking detected
Data field %HB
harsh.cornering.event
boolean
Harsh cornering detected
Data field %HC
ibutton.code
string
Hexadecimal code of connected iButton
ident
string
Device unique identifier like serial number, IMEI, etc
idle.status
boolean
Vehicle is in idling state
Data field %DL
impact.event
boolean
Impact event
Data field %IP
main.power.low.status
boolean
Main power low status
Data field %PL
message.buffered.status
boolean
Black box message
Data field %DT
movement.status
boolean
Current movement state
Data field %MT
network.signal.rsrp
number
dbm
LTE reference signal received power (RSRP)
Data field %GR
obd.connected.status
boolean
OBDII device is connected to vehicle
Data field %OC
overspeeding.status
boolean
Overspeeding detected
Data field %SD
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Data field %AT
position.direction
number
degrees
Heading angle at position detection moment
Data field %HD
position.filter.motion
number
GPS position filter by Motion
Data field %FP
position.hdop
number
Horizontal dilution of precision
Data field %HP
position.latitude
number
degrees
Latitude coordinate value
Data field %LA
position.longitude
number
degrees
Longitude coordinate value
Data field %LG
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Data field %GP,
Data field %SA
Data field %SA
position.speed
number
km/h
Instant speed at position detection moment
Data field %VS
position.timestamp
number
seconds
Timestamp when coordinates where calculated
position.valid
boolean
Is position information accurate and valid for given timestamp
Data field %GP
protocol.id
number
ID of protocol
report.reason
number
Transmission reason code
Data field %RD
segment.max.acceleration
number
g
Maximum acceleration value that occurred on the segment
Data field %GV
segment.max.braking.acceleration
number
g
Maximum braking acceleration value that occurred on the segment
Data field %GV
segment.max.cornering.acceleration
number
g
Maximum cornering acceleration value that occurred on the segment
Data field %GV
segment.max.engine.load.level
number
percentage
Maximum engine load percentage on segment
Data field %EL
segment.max.engine.rpm
number
rpm
Maximum engine RPM on segment
Data field %RP
segment.max.position.speed
number
km/h
Maximum speed on segment
Data field %SM
segment.max.throttle.pedal.level
number
percentage
Maximum throttle pedal push level on segment
Data field %TR
segment.max.vertical.acceleration
number
g
Maximum vertical acceleration value that occurred on the segment
Data field %GV
send.timestamp
number
seconds
Message send timestamp
Data field %ST
sensor.humidity
number
percentage
Humidity sensor value, i.e. relative air humidity level
Data field %HT
sensor.temperature
number
celsius
Temperature sensor value
Data field %HT,
Data field %TP
Data field %TP
server.connection.status
boolean
Server connection status
Data field %CS
server.timestamp
number
seconds
Timestamp when server received a message
sim.card.state
number
SIM card state. Protocol specific numeric value
Data field %SR
tilt.angle
number
degree
Tilt angle
Data field %TL
timestamp
number
seconds
Message timestamp
Data field %RT
timestamp.key
number
Message timestamp in seconds with message sequence number appended as the value fractional part. Used to distinguish between several messages that have the same timestamp.
total.acceleration
number
Total acceleration for x, y and z axis
Data field %JF
towing.event
boolean
Towing event detected
Data field %TW
trip.engine.motorhours
number
hours
Engine hours for current trip
Data field %WH
vehicle.mileage
number
km
Total calculated mileage
Data field %EO,
Data field %OD
Data field %OD
vehicle.vin
string
VIN of vehicle
Data field %VN
wifi.mac.address
string
WiFi MAC address
Data field %MA
Properties
Clear Message Queue
clear_message_queue
Clear Message Queue
Connectivity Setup
gprs_setup
GPRS Setup.
Please note that the device will restart automatically after received this command by SMS/GPRS.
gprs: GPRS/UMTS Communication Properties
server: Backend Server Communication Properties
GPS Tracking
gps_tracking
GPS Tracking Setup.
Produce new tracking reports on specified conditions
time: Track By Time
speed: Minimum Speed
engine: Engine Status
heading: Track By Heading Change
distance: Track By Distance
conditions: Track When
motion_only: Track On Motion Only
acc_off_interval: ACC OFF Interval
G-Sensor data
g_sensor_data
Get the last impact of G-Sensor data
Info command response
info
Readonly settings to check device firmware and hardware info
ccid: Card identification number of SIM card
imei: International Mobile Equipment Identity number
imsi: International Mobile Subscriber Identity
earfcn: E-UTRA Absolute Radio Frequency Channel Number
gsm_fw: The firmware version of GSM module
msisdn: The Mobile Subscriber ISDN number stored in the SIM card
unit_id: Unit ID
gps_status: Numbers of GPS satellite currently used
gsm_signal: GSM eceived signal strength
gsm_status: GSM Network registration status
model_name: Device Model Name
main_voltage: Main power voltage in 0.1 volt
bt_conn_status: Bluetooth connection status
battery_voltage: Backup battery voltage in 0.1 volt
obd_conn_status: OBD connection status
firmware_version: Device firmware version information
gps_antenna_status: GPS antenna status
server_conn_status: Server connection status
j1939_j1708_conn_status: J1939/ J1708 connection status
Vehicle Odometer
odom
The vehicle odometer is calculated by accumulating of each GPS movement or direct speed data from OBD Port.
value: Odometer value
option: Filter out odometer accumulation when ACC is OFF
source: Odometer signal source
reset_option: Reset odometer value to zero with the following condition
Position Report Format
position_report_format
Position Report Format Configuration
custom_info: Custom Info
time_format: Time Format
header_prefix: Header Prefix
position_format: Position Report Data Format
Power Management
pwr_mode
Set up the power management properties of the device.
dur_a: Power Off Timeout
dur_b: Sleep Mode Timeout
dur_c: Deep Sleep Mode Timeout
sleep_mode: Sleep Mode Settings
power_off_detect: Power Off Detection
sleep_mode_control: Control Options
Reboot Device
reboot
Reboot Device
Properties
Custom command
Examples
custom
Send custom command via connection or over SMS
text: Text payload
More devices from ATrack (26)
Tags
