Aemp protocol
Universal protocol used by various makes of heavy equipment that export telematics data according to AEMP 2.0 (ISO 15143-3) standard.
flespi parses the Aemp protocol messages into a JSON object with the
fields listed below in the Parameters tab.
The AEMP Telematics Data Standard is an XML web service that provides telemetry information about fleets of equipment according to ISO 15143-3.
Clients can access a fleet resource by sending an HTTPS GET request to the server at the given location ("AEMP 2.0 compatible server URI" field in the channel configuration). The response is a full snapshot of the fleet. If the fleet contains no equipment at the time of the snapshot, an empty document is returned.
flespi caches timestamp of the latest message for each device. If AEMP data feed answers with the message that has already been registered in flespi (corresponds to cached timestamp for the given device) then no duplicated message will be registered at flespi.
aemp.avg_load_factor24
number
percentage
Average daily load factor
AverageLoadFactorLast24.LoadFactor
aemp.carh
number
hours
Total active regeneration hours
CumulativeActiveRegenerationHours.Hour
aemp.defr
number
percentage
DEF tank remaining percentage
DEFRemaining.Percent
aemp.defr_capacity
number
liters
DEF Tank capacity
DEFRemaining.DEFTankCapacity
aemp.fuel_tank_capacity
number
liters
Fuel tank capacity
FuelRemaining.FuelTankCapacity
aemp.fuel_used24
number
liters
Fuel consumed by the machine for the last 24 hours period
FuelUsedLast24.FuelConsumed
aemp.idle_non_operating
number
hours
Total idle non operating hours
CumulativeIdleNonOperatingHours.Hour
aemp.install_timestamp
number
seconds
Telematics Unit Installation Date
EquipmentHeader.UnitInstallDateTime
aemp.load_count
number
Total cumulative number of loads
CumulativeLoadCount.Count
aemp.max_speed24
number
km/h
Maximum daily speed for this machine during the previous 24 hours period
MaximumSpeedLast24.Speed
aemp.model
string
Equipment Model
EquipmentHeader.Model
aemp.oem_name
string
Equipment Make
EquipmentHeader.OEMName
aemp.payload_total
number
Cumulative total payload moved by the machine
CumulativePayloadTotals.Payload
aemp.pin
string
OEM ISO Number
EquipmentHeader.PIN
aemp.power_takeoff
number
hours
Total power take-off hours
CumulativePowerTakeOffHours.Hour
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.serial.number
string
Device serial number
EquipmentHeader.SerialNumber
device.type.id
number
ID of device type of device that received a message
engine.ignition.status
boolean
Engine ignition or ACC status
EngineStatus.Running
engine.motorhours
number
hours
Total calculated engine motorhours
CumulativeOperatingHours.Hour
fuel.consumed
number
liters
Fuel volume totally consumed by vehicle
FuelUsed.FuelConsumed
fuel.level
number
percentage
Fuel level percentage
FuelRemaining.Percent
ident
string
Device unique identifier like serial number, IMEI, etc
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Location.Altitude
position.latitude
number
degrees
Latitude coordinate value
Location.Latitude
position.longitude
number
degrees
Longitude coordinate value
Location.Longitude
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
total.idle.time
number
seconds
Total time that vehicle was in idling state
CumulativeIdleHours.Hour
vehicle.odometer
number
Vehicle mileage in base units configured in device (km, miles, 100m etc)
Distance.Odometer
vehicle.vin
string
VIN of vehicle
EquipmentHeader.EquipmentID