Bsj protocol
Parse and decode BSJ binary messages into JSON. Get parsed data from BSJ devices via REST API and MQTT. Forward normalized data from BSJ trackers to AWS, Azure, etc.
flespi parses the Bsj protocol messages into a JSON object with the
fields listed below in the Parameters tab.
BSJ protocol
accelerometer.module.status
boolean
Accelerometer module (G-sensor) status
Extension ID: 0x0089 of Additional info ID 0xEB
ain
number
volts
Voltage on the analog input
Additional info ID 0x2B
alarm.sign.bitmask
number
Alarm sign bitmask
Message ID 0x0200
battery.charging.status
boolean
Battery charging status
Extension ID: 0x00C5 of Additional info ID 0xEB
battery.low.alarm
boolean
Battery low alarm event
Message ID 0x0200
battery.voltage
number
volts
Internal battery voltage
Extension ID: 0x002D of Additional info ID 0xEB
beidou.satellites.status
boolean
BeiDou positioning system status
Message ID 0x0200
camera.failure.alarm
boolean
Camera failure alarm event
Message ID 0x0200
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
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
Footbrake pedal is depressed, read from CAN
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 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
cumulative.driving.alarm
boolean
Cumulative driving time in one day alarm event
Message ID 0x0200
danger.alarm
boolean
Danger alarm event
Message ID 0x0200
device.id
number
ID of device that received a message
device.imei
string
IMEI of the device
Extension ID: 0x00D5 of Additional info ID 0xEB
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
displacement.alarm
boolean
Displacement alarm event
Extension ID: 0x0089 of Additional info ID 0xEB
door.open.status
boolean
Door open status
Message ID 0x0200
driver.card.reading.error
string
Driver card reading error
Message ID 0x0702
driver.id
string
Driver identification card id
Message ID 0x0702
driver.name
string
Driver name
Message ID 0x0702
driver.registration.status
boolean
Driver registration status
Message ID 0x0702
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 0x0200
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
Message ID 0x0200
event.enum
number
Protocol-specific event code
Additional info ID 0x04,
Message ID 0x0301
Message ID 0x0301
event.seqnum
number
Unique event sequence number
Message Sequence Number
external.powersource.voltage
number
volts
External power voltage
Extension ID: 0x00CE of Additional info ID 0xEB
firmware.version
string
Firmware version
Message ID 0x0107
fuel.level.alarm
boolean
Fuel level alarm triggered
Message ID 0x0200
fuel.volume
number
liters
Fuel volume
Additional info ID 0x02
galileo.satellites.status
boolean
Galileo positioning system status
Message ID 0x0200
geofence.alarm
boolean
Geofence alarm event
Message ID 0x0200
glonass.satellites.status
boolean
Glonass positioning system status
Message ID 0x0200
gnss.antenna.disconnected.alarm
boolean
GNSS antenna disconnected or cut off alarm event
Message ID 0x0200
gnss.antenna.short.circuit.alarm
boolean
GNSS antenna short circuit alarm event
Message ID 0x0200
gnss.failure.alarm
boolean
GNSS receiver failure alarm event
Message ID 0x0200
gps.satellites.status
boolean
GPS positioning system status
Message ID 0x0200
gsm.signal.quality
number
The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Additional info ID 0x30
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Extension ID: 0x00B2 of Additional info ID 0xEB,
Message ID 0x0107
Message ID 0x0107
hardware.version
string
Hardware version
Message ID 0x0107
harsh.acceleration.alarm
boolean
Harsh acceleration alarm
Extension ID: 0x0089 of Additional info ID 0xEB
harsh.braking.event
boolean
Harsh braking detected
Extension ID: 0x0089 of Additional info ID 0xEB
high.temperature.alarm
boolean
High temperature alarm
Extension ID: 0x0089 of Additional info ID 0xEB
ic.card.module.failure.alarm
boolean
IC card module failure alarm event
Message ID 0x0200
ident
string
Device unique identifier like serial number, IMEI, etc
illegal.ignition.alarm
boolean
Illegal ignition alarm event
Message ID 0x0200
illegal.movement.alarm
boolean
Illegal movement alarm event
Message ID 0x0200
lcd.failure.alarm
boolean
LCD display failure alarm event
Message ID 0x0200
low.temperature.alarm
boolean
Low temperature alarm
Extension ID: 0x0089 of Additional info ID 0xEB
memory.fault.status.bitmask
number
Memory fault alarm status bitmask
Additional info ID 0x17
overspeeding.event
boolean
Overspeeding detected
Extension ID: 0x0089 of Additional info ID 0xEB,
Message ID 0x0200
Message ID 0x0200
payload.hex
string
HEX Payload received from device
Message ID 0x0900,
Message ID 0x0F00...0x0FFF
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
Message ID 0x0200
position.direction
number
degrees
Heading angle at position detection moment
Message ID 0x0200
position.latitude
number
degrees
Latitude coordinate value
Message ID 0x0200
position.longitude
number
degrees
Longitude coordinate value
Message ID 0x0200
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Additional info ID 0x31
position.source
string
Source of position.latitude and position.longitude parameters if they were received from other systems than GNSS, i.e. lbs, wifi
Extension ID: 0x00C5 of Additional info ID 0xEB
position.speed
number
km/h
Instant speed at position detection moment
Message ID 0x0200
position.valid
boolean
Is position information accurate and valid for given timestamp
Message ID 0x0200
power.cut.alarm
boolean
External power cut-off alarm event
Extension ID: 0x0089 of Additional info ID 0xEB,
Message ID 0x0200
Message ID 0x0200
protocol.id
number
ID of protocol
report.code
string
Report code
rollover.event
boolean
Roll over event detected
Message ID 0x0200
route.alarm
boolean
Route alarm event
Message ID 0x0200
route.deviation.alarm
boolean
Route deviation alarm event
Message ID 0x0200
route.time.alarm
boolean
Route time alarm event
Message ID 0x0200
server.timestamp
number
seconds
Timestamp when server received a message
sharp.turn.alarm
boolean
Sharp turn alarm event
Extension ID: 0x0089 of Additional info ID 0xEB
sleep.mode.status
boolean
Device is in sleep mode
Extension ID: 0x0089 of Additional info ID 0xEB
sos.alarm
boolean
SOS alarm triggerred
Message ID 0x0200
status.bitmask
number
Status bitmask
Message ID 0x0200
theft.alarm
boolean
Theft alarm
Message ID 0x0200
time.limit.alarm
boolean
Time limit expired alarm event
Message ID 0x0200
timestamp
number
seconds
Message timestamp
Message ID 0x0200,
Message ID 0x0702
Message ID 0x0702
tts.module.failure.alarm
boolean
Text-to-speech module failure alarm event
Message ID 0x0200
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
upgrade.status.name
string
Upgrade status
Message ID 0x0108
upgrade.type
string
Upgrade type
Message ID 0x0108
vehicle.collision.alarm
boolean
Ordinary vehicle collision alarm
Extension ID: 0x0089 of Additional info ID 0xEB,
Extension ID: 0x00C5 of Additional info ID 0xEB
Extension ID: 0x00C5 of Additional info ID 0xEB
vehicle.mileage
number
km
Total calculated mileage
Additional info ID 0x01
vehicle.oil.circuit.status
boolean
Vehicle Oil circuit status
Message ID 0x0200
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
vibration.alarm
boolean
Vibration alarm event
Extension ID: 0x0089 of Additional info ID 0xEB,
Extension ID: 0x00C5 of Additional info ID 0xEB
Extension ID: 0x00C5 of Additional info ID 0xEB
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
Properties
Custom command
Examples
custom
Send custom command to device
message_id: Message ID in HEX format
message_body: Message body payload in HEX format
