Jt808 protocol

The JT808 protocol is a comprehensive vehicle telematics standard for real-time fleet management in China.
flespi parses the Jt808 protocol messages into a JSON object with the fields listed below in the Parameters tab.

The JT808 protocol is a comprehensive vehicle telematics standard for real-time fleet management in China. It offers data communication between vehicle terminals and servers, including GPS tracking, alerts, video streaming, and remote control. With support for cellular networks and multimedia transmission, it ensures efficient data usage and safety compliance. The protocol is modular, supporting extensions for specific needs like cargo tracking and public transport monitoring, enhancing operational efficiency and safety.


The protocol implementation is based on the JT808 standard from 2013. The protocol also includes the JT1078 Video Communication Protocol for Vehicle Telematics standard from 2016 and TJSTL12 Technical Requirements and Test Methods for Driver Monitoring Systems (DMS) from 2017


Tracker manufacturers supporting this protocol can expand it by adding new tags with information. In this case, the information is saved in parameters with the custom prefix and must be parsed using the pvm-code-plugin

ain
number
volts
Voltage on the analog input
Additional info ID 0x2B
alarm.sign.bitmask
number
Alarm sign bitmask
Message ID 0x0200,
Message ID 0x0801
battery.low.alarm
boolean
Battery low alarm event
Message ID 0x0200,
Message ID 0x0801
beidou.satellites.status
boolean
BeiDou positioning system status
Message ID 0x0200,
Message ID 0x0801
brake.status
boolean
Brake status
Additional info ID 0x64,
Additional info ID 0x65
camera.failure.alarm
boolean
Camera failure alarm event
Message ID 0x0200,
Message ID 0x0801
can.air.condition.status
boolean
CAN air conditioning is on
Additional info ID 0x25
can.central.lock.status
boolean
CAN central lock is locked
Message ID 0x0200,
Message ID 0x0801
can.high.beam.status
boolean
CAN high beams are on
Additional info ID 0x25
can.low.beam.status
boolean
CAN low beams are on
Additional info ID 0x25
can.neutral.gear.status
boolean
CAN neutral gear is on
Additional info ID 0x25
can.pedal.brake.status
boolean
CAN brake pedal pressed
Additional info ID 0x25
can.pedal.clutch.status
boolean
CAN clutch pedal pressed
Additional info ID 0x25
can.rear.fog.lights.status
boolean
CAN rear fog lights are on
Additional info ID 0x25
can.reverse.gear.status
boolean
CAN reverse gear is on
Additional info ID 0x25
can.tacho.position.speed
number
km/h
CAN-bus Tachograph vehicle speed
Additional info ID 0x03
channel.id
number
ID of channel that received a message
crash.event
boolean
Crash event detected
Message ID 0x0200,
Message ID 0x0801
cumulative.driving.alarm
boolean
Cumulative driving time in one day alarm event
Message ID 0x0200,
Message ID 0x0801
custom
any
Any custom parameter
danger.alarm
boolean
Danger alarm event
Message ID 0x0200,
Message ID 0x0801
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
Additional info ID 0x2A
door.open.status
boolean
Door open status
Message ID 0x0200,
Message ID 0x0801
driving.alarm.bitmask
number
Abnormal driving alarm flags bitmask
Additional info ID 0x18
dsm.driver.phone.event
boolean
Driver using the phone event generated by Driver status monitoring system (DSM)
Additional info ID 0x18
dsm.fatigue.degree
number
Driver fatigue degree got from Driver status monitoring system (DSM)
Additional info ID 0x18
dsm.fatigue.event
boolean
Driver fatigue event generated by Driver status monitoring system (DSM)
Additional info ID 0x18,
Message ID 0x0200,
Message ID 0x0801
dsm.smoking.event
boolean
Driver smoking event generated by Driver status monitoring system (DSM)
Additional info ID 0x18
engine.ignition.status
boolean
Engine ignition or ACC status
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
event.enum
number
Protocol-specific event code
Additional info ID 0x04,
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0301,
Message ID 0x0800,
Message ID 0x0801
event.seqnum
number
Unique event sequence number
Message Sequence Number
fuel.level.alarm
boolean
Fuel level alarm triggered
Message ID 0x0200,
Message ID 0x0801
fuel.volume
number
liters
Fuel volume
Additional info ID 0x02
galileo.satellites.status
boolean
Galileo positioning system status
Message ID 0x0200,
Message ID 0x0801
geofence.alarm
boolean
Geofence alarm event
Message ID 0x0200,
Message ID 0x0801
glonass.satellites.status
boolean
Glonass positioning system status
Message ID 0x0200,
Message ID 0x0801
gnss.antenna.disconnected.alarm
boolean
GNSS antenna disconnected or cut off alarm event
Message ID 0x0200,
Message ID 0x0801
gnss.antenna.short.circuit.alarm
boolean
GNSS antenna short circuit alarm event
Message ID 0x0200,
Message ID 0x0801
gnss.failure.alarm
boolean
GNSS receiver failure alarm event
Message ID 0x0200,
Message ID 0x0801
gps.satellites.status
boolean
GPS positioning system status
Message ID 0x0200,
Message ID 0x0801
gsm.signal.quality
number
The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Additional info ID 0x30
ic.card.module.failure.alarm
boolean
IC card module failure alarm event
Message ID 0x0200,
Message ID 0x0801
ident
string
Device unique identifier like serial number, IMEI, etc
illegal.ignition.alarm
boolean
Illegal ignition alarm event
Message ID 0x0200,
Message ID 0x0801
illegal.movement.alarm
boolean
Illegal movement alarm event
Message ID 0x0200,
Message ID 0x0801
lcd.failure.alarm
boolean
LCD display failure alarm event
Message ID 0x0200,
Message ID 0x0801
media
boolean
Message contain media file
media.channel
number
Multimedia channel
Message ID 0x0800,
Message ID 0x0801
media.filename
string
Multimedia file name
Message ID 0x1211,
Message ID 0x1212
media.filesize
number
Multimedia file size
Message ID 0x1211,
Message ID 0x1212
media.format
string
Multimedia format
Message ID 0x0800,
Message ID 0x0801
media.id
number
Multimedia data ID
Message ID 0x0800,
Message ID 0x0801,
Message ID 0x0805
media.image
object
Image file in media storage
media.type
string
Multimedia type
Message ID 0x0800,
Message ID 0x1211,
Message ID 0x1212
media.video
object
Video file in media storage
memory.fault.status.bitmask
number
Memory fault alarm status bitmask
Additional info ID 0x17
overspeeding.event
boolean
Overspeeding detected
Message ID 0x0200,
Message ID 0x0801
payload.hex
string
HEX Payload received from device
Message ID 0x0900,
Message ID 0x0F00...0x0FFF
payload.source.type
number
Payload source type
Message ID 0x0900
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
position.direction
number
degrees
Heading angle at position detection moment
Message ID 0x0200,
Message ID 0x0801
position.latitude
number
degrees
Latitude coordinate value
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
position.longitude
number
degrees
Longitude coordinate value
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Additional info ID 0x31
position.speed
number
km/h
Instant speed at position detection moment
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
position.valid
boolean
Is position information accurate and valid for given timestamp
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
power.cut.alarm
boolean
External power cut-off alarm event
Message ID 0x0200,
Message ID 0x0801
protocol.id
number
ID of protocol
report.code
string
Report code
rollover.event
boolean
Roll over event detected
Message ID 0x0200,
Message ID 0x0801
route.alarm
boolean
Route alarm event
Message ID 0x0200,
Message ID 0x0801
route.deviation.alarm
boolean
Route deviation alarm event
Message ID 0x0200,
Message ID 0x0801
route.time.alarm
boolean
Route time alarm event
Message ID 0x0200,
Message ID 0x0801
server.timestamp
number
seconds
Timestamp when server received a message
sos.alarm
boolean
SOS alarm triggerred
Message ID 0x0200,
Message ID 0x0801
status.bitmask
number
Status bitmask
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801
theft.alarm
boolean
Theft alarm
Message ID 0x0200,
Message ID 0x0801
time.limit.alarm
boolean
Time limit expired alarm event
Message ID 0x0200,
Message ID 0x0801
timestamp
number
seconds
Message timestamp
Additional info ID 0x64,
Additional info ID 0x65,
Message ID 0x0200,
Message ID 0x0801,
Message ID 0x1212
tts.module.failure.alarm
boolean
Text-to-speech module failure alarm event
Message ID 0x0200,
Message ID 0x0801
turn.left.status
boolean
Turn left status
Additional info ID 0x25
turn.right.status
boolean
Turn right status
Additional info ID 0x25
unauthorized.alarm
boolean
Unauthorized access alarm event
Message ID 0x0200,
Message ID 0x0801
upgrade.status.name
string
Upgrade status
Message ID 0x0108
upgrade.type
string
Upgrade type
Message ID 0x0108
vehicle.mileage
number
km
Total calculated mileage
Additional info ID 0x01
vehicle.oil.circuit.status
boolean
Vehicle Oil circuit status
Message ID 0x0200,
Message ID 0x0801
vehicle.plate.number
string
Vehicle plate number
Message ID 0x0100
vehicle.signal.status.bitmask
number
Vehicle signal status bitmask
Additional info ID 0x25
vehicle.vin
string
VIN of vehicle
Message ID 0x0100
video.alarm.bitmask
number
Video alarm flags bitmask
Additional info ID 0x14
video.blind.alarm
boolean
Video blind alarm event per channel
Additional info ID 0x16
video.loss.alarm
boolean
Video loss alarm event per channel
Additional info ID 0x15
vss.failure.alarm
boolean
Vehicle security system failure alarm event
Message ID 0x0200,
Message ID 0x0801
Properties
Custom Command
custom
Send custom command to device
message_id: Message ID in HEX format
message_body: Message body payload in HEX format
Check terminal parameter
{"message_id":"8104"}
Check terminal heardbeat sending interval
{"message_id":"8106","message_body":"0100000001"}
Playback video
playback_video
Start video playback from device
Request video
request_video
Request video file upload from device
Start videostream
start_videostream
Start videostream
Take a photo
take_photo
Take a photo
Video timeline
video_timeline
Request timeline with intervals of available video data