Aovx protocol

Protocol used by GPS tracking devices manufactured by AOVX headquartered in China.
flespi parses the Aovx protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the AOVX protocol, you need to have an aovx channel created first.

Point your tracker to the channel's domain name:port via SMS or configuration tool provided by the vendor.

Then create a device instance for your tracker and use a 15-character IMEI (usually specified on the tracker casing) in the ident field.

Use the Logs & Messages tab on the device screen to check if the messages are coming.

alarm.mode.status
boolean
Device alarm mode status
Message ID 0x0200
battery.charging.state
string
Protocol-specific battery charging state
Extension ID 0xF7 of Message ID 0x0200
battery.level
number
percentage
Internal battery level
Extension ID 0xF7 of Message ID 0x0200
battery.voltage
number
volts
Internal battery voltage
Extension ID 0xF7 of Message ID 0x0200
ble.beacons
array
Array with all detected BLE beacons data objects. Each object contain list of assosiated parameteres 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
Extension ID 0xF3 of Message ID 0x0200,
Message ID 0x0900
ble.sensors
array
Array with all detected BLE sensors data objects. Each object contain list of assosiated parameteres sent by appropriate sensor. Standard parameter names used: *mac* - sensor MAC-address *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
Message ID 0x0900
channel.id
number
ID of channel that received a message
data.type.enum
number
Data type code
Extension ID 0xF6 of Message ID 0x0200
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
displacement.alarm
boolean
Displacement alarm event
Message ID 0x0200
engine.blocked.status
boolean
Engine blocked status (fuel cutoff relay), true - engine is blocked, false - engine isn't blocked
Message ID 0x0200,
Message ID 0x0900
engine.ignition.on.duration
number
seconds
Duration when engine is on
Extension ID 0xF9 of Message ID 0x0200
engine.ignition.status
boolean
Engine ignition or ACC status
Message ID 0x0200,
Message ID 0x0900
event.enum
number
Protocol-specific event code
Message ID
event.seqnum
number
Unique event sequence number
Message Sequence Number
external.powersource.voltage
number
volts
External power voltage
Extension ID 0xF1 of Message ID 0x0200
gnss.failure.alarm
boolean
GNSS receiver failure alarm event
Message ID 0x0200
gpio.input
number
GPIO Input channel
Extension ID 0xF5 of Message ID 0x0200
gpio.output
number
GPIO Output channel
Extension ID 0xF5 of Message ID 0x0200
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Extension ID 0xF0 of Message ID 0x0200
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Extension ID 0xF0 of Message ID 0x0200
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Extension ID 0xF0 of Message ID 0x0200
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Extension ID 0xF0 of Message ID 0x0200
gsm.network.type
string
The type of the Mobile network the device is currently registered to
Message ID 0x0200,
Message ID 0x0900
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Extension ID 0xF0 of Message ID 0x0200
gsm.signal.quality
number
The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Extension ID 0x30 of Message ID 0x0200
ident
string
Device unique identifier like serial number, IMEI, etc
main.powersource.status
boolean
Main power supply connection status
Message ID 0x0200
message.buffered.status
boolean
Black box message
Message ID 0x0200,
Message ID 0x0900
overspeeding.event
boolean
Overspeeding detected
Message ID 0x0200
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Message ID 0x0200,
Message ID 0x0900
position.direction
number
degrees
Heading angle at position detection moment
Message ID 0x0200,
Message ID 0x0900
position.fix.age
number
seconds
Time since the last position fix
Extension ID 0xF9 of Message ID 0x0200
position.hdop
number
Horizontal dilution of precision
Extension ID 0xF9 of Message ID 0x0200
position.latitude
number
degrees
Latitude coordinate value
Message ID 0x0200,
Message ID 0x0900
position.longitude
number
degrees
Longitude coordinate value
Message ID 0x0200,
Message ID 0x0900
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Extension ID 0x31 of Message ID 0x0200
position.speed
number
km/h
Instant speed at position detection moment
Message ID 0x0200,
Message ID 0x0900
position.timestamp
number
seconds
Timestamp when coordinates where calculated
Extension ID 0xF9 of Message ID 0x0200
position.valid
boolean
Is position information accurate and valid for given timestamp
Message ID 0x0200,
Message ID 0x0900
protocol.id
number
ID of protocol
sensor.humidity
number
percentage
Humidity sensor value, i.e. relative air humidity level
Extension ID 0xF6 of Message ID 0x0200
sensor.humidity.limit.max
number
percentage
Humidity sensor limit (max)
Extension ID 0xF6 of Message ID 0x0200
sensor.humidity.limit.min
number
percentage
Humidity sensor limit (min)
Extension ID 0xF6 of Message ID 0x0200
sensor.illuminance
number
lux
Illuminance measured by light sensor
Extension ID 0xF6 of Message ID 0x0200
sensor.illuminance.limit.max
number
Illuminance sensor limit (max)
Extension ID 0xF6 of Message ID 0x0200
sensor.temperature
number
celsius
Temperature sensor value
Extension ID 0xF6 of Message ID 0x0200
sensor.temperature.limit.max
number
celsius
Temperature sensor limit (max)
Extension ID 0xF6 of Message ID 0x0200
sensor.temperature.limit.min
number
celsius
Temperature sensor limit (min)
Extension ID 0xF6 of Message ID 0x0200
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
Message ID 0x0200,
Message ID 0x0900
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.
Message ID 0x0200
towing.event
boolean
Towing event detected
Message ID 0x0200,
Message ID 0x0900
vehicle.mileage
number
km
Total calculated mileage
Extension ID 0x01 of Message ID 0x0200
vibration.alarm
boolean
Vibration alarm event
Message ID 0x0200
wifi.mac.address
string
WiFi MAC address
Extension ID 0xF4 of Message ID 0x0200
wifi.signal.strength
number
WiFi signal strength, RSSI
Extension ID 0xF4 of Message ID 0x0200
work.mode
number
Protocol-specific work mode
Extension ID 0xF8 of Message ID 0x0200
x.acceleration
number
g
Accelerometer value X
Extension ID 0xF6 of Message ID 0x0200
y.acceleration
number
g
Accelerometer value Y
Extension ID 0xF6 of Message ID 0x0200
z.acceleration
number
g
Accelerometer value Z
Extension ID 0xF6 of Message ID 0x0200
Properties
Custom command
custom
Custom command through AT Transparent Transmission
command: AT transparent transmission command