ruptela

This protocol is used by all Ruptela GPS tracking devices. Please also read our guide on how-to connect Ruptela device to flespi in few mouse clicks.

Below is the list of parameters that can appear in the messages received by the channel via ruptela protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
absolute.idle.seconds number seconds Absolute time in idle state
accident.din number Accident digital input state
accident.extreme.braking.status boolean Accident extreme braking state
accident.harsh.acceleration.status boolean Accident harsh acceleration state
accident.harsh.breaking.status boolean Accident harsh braking state
accident.overspeeding.status boolean Accident overspeeding state
ain number volts Voltage on the analog input
alarm.panic.status boolean Panic state
a.sensor.fuel.temperature number celsius Digital Fuel Sensor A fuel temperature
battery.current number amperes Battery current
battery.voltage number volts Internal battery voltage
b.sensor.fuel.level number percentage Digital Fuel Sensor B fuel level
b.sensor.fuel.temperature number celsius Digital Fuel Sensor B fuel temperature
can.ambient.air.temperature number celsius CAN ambient air temperature
can.a.sensor.fuel.level number percentage CAN A digital sensor fuel level
can.axle.weight number kg Weight on the axle read from CAN
can.cruise.status boolean CAN cruise control is active
can.diagnostic.support.enum number CAN diagnostics supported bitmask
can.diagnostic.troublecode.mil.bitmask number Diagnostic Trouble Code and Malfunction Indicator Lamp bitmask read from CAN
can.dtc string Diagnostic trouble code read from CAN
can.engine.coolant.temperature number celsius Engine coolant temperature read from CAN
can.engine.fuel.rate number liters/hours Engine fuel rate read from CAN
can.engine.load.level number percentage Engine load level read from CAN
can.engine.motorhours number hours Total engine motorhours read from CAN
can.engine.rpm number rpm Engine RPM read from CAN
can.engine.temperature number celsius Engine temperature read from CAN
can.first.driver.card.id number CAN first driver ID
can.fms.axle.location.enum number CAN axle location according FMS standard
can.fms.software.version.bitmask number CAN FMS software version supported bitmask
can.fms.tyre.location.enum number CAN tire location according FMS standard
can.fuel.consumed number liters Fuel volume totally consumed by vehicle read from CAN
can.fuel.consumption.distance number liters/100km Fuel consumption read from CAN
can.fuel.economy number km/liters CAN instantaneous fuel economy
can.fuel.level number percentage Fuel level in tank read from CAN
can.fuel.type.enum number Fuel type read from CAN
can.j1939.cargo.weight number kg CAN J1939 cargo weight
can.j1939.trailer.weight number kg CAN J1939 trailer weight
can.liquid.sensor.fuel.volume number liters Fuel volume in tank reported by LLS CAN
can.maintenance.before.mileage number km Mileage before next maintenance read from CAN
can.mil.mileage number km Distance traveled while malfunction indicator lamp is activated, read from CAN
can.movement.status boolean CAN tacho vehicle motion
can.one.powersource.takeoff.enum number CAN at least one PTO engaged
can.pedal.brake.status boolean CAN brake pedal pressed
can.pedal.clutch.status boolean CAN clutch pedal pressed
can.powersource.takeoff.enum number CAN power takeoff bitmask
can.request.support.enum number CAN requests supported bitmask
can.secondary.driver.card.id number CAN second driver ID
can.secondary.fuel.level number percentage CAN engine fuel level secondary
can.system.event.enum number CAN system event enum
can.tacho.driver.activity.enum number CAN tacho driver activity state
can.tacho.driver.card.enum number CAN tacho driver card status enum
can.tacho.driver.time.enum number CAN tacho driver 1 time related status
can.tacho.handling.info.status boolean CAN tacho handling information
can.tacho.overspeeding.event boolean CAN tacho vehicle overspeed
can.tacho.performance.enum number CAN tachograph performance
can.tacho.position.speed number km/h CAN tachograph vehicle speed
can.tacho.reverse.movement.status boolean CAN tacho direction indicator
can.throttle.pedal.level number percentage Throttle pedal push level read from CAN
can.vehicle.mileage number km Total vehicle mileage read from CAN
can.vehicle.speed number km/h Vehicle speed read from CAN
can.vehicle.vin string Vehicle VIN read from CAN
can.wheel.speed number CAN wheel based speed
channel_id number ID of channel that received message
config.engine.ignition.status boolean Custom configured engine ignition status
counter.din.hours number hours Digital input hour counter
counter.fuel.value number Fuel counter
crash.impact.acceleration number g Crash impact acceleration
crash.impact.direction number degrees Crash impact direction
c.sensor.fuel.level number percentage Digital Fuel Sensor C fuel level
c.sensor.fuel.temperature number celsius Digital Fuel Sensor C fuel temperature
device.configuration.id number Configuration profile index
device.temperature number celsius Temperature of device
din number Digital inputs bitmask
dout number Digital outputs bitmask
dtc.latitude number degrees Latitude of diagnostic trouble code
dtc.longitude number degrees Longitude of diagnostic trouble code
dtc.source number Source of diagnostic trouble code: 0xFF - OBD, 0x1 - CAN j1939, 0x02 - CAN j1708
dtc.status number Status of diagnostic trouble code: 1 - current, 2 - historical
dtc.timestamp number seconds Timestamp of diagnostic trouble code
eco.idle.status boolean ECO idling state
event.id number ID of event that caused record generation
external.powersource.voltage number volts External power voltage
extnav.position.altitude number meters Altitude value for external receiver position
garmin.payload.hex string Garmin payload in hex
garmin.status boolean Garmin FMI module status
gnss.antenna.status boolean GNSS receiver antenna status
gprs.status boolean GPRS mobile network status
gsm.jamming.event boolean GSM signal jamming detected
gsm.mnc number GSM mobile network code
gsm.signal.dbm number dbm Strength of GSM signal
gsm.troublecode.bitmask number GSM trouble codes
ibutton.code string Hexadecimal code of connected iButton
ident string Device unique identificator and optional password
magnetic.card.code string Magnetic Card ID code
movement.status boolean Current movement state
ot.din number OT digital input value
passenger.ibutton.code string iButton code of passenger
pcb.temperature number celsius PCB temperature
peer string IP:port from which device connecting to the channel
position.altitude number meters Altitude value for position
position.direction number degrees Heading angle at position detection moment
position.hdop number Horizontal dilution of precision
position.latitude number degrees Latitude coordinate value
position.longitude number degrees Longitude coordinate value
position.satellites number Quantity of satellites used to calculate coordinates for given position information
position.speed number km/h Instant speed at position detection moment
private.status boolean Device is in private mode
refrigerator.door.open.status boolean Refrigerator door open status
refrigerator.engine.mode.enum string Refrigerator engine mode - diesel, electric
refrigerator.high.speed.status boolean Fridge high speed status
refrigerator.operate.mode.enum string Refrigerator operating mode - cycle sentry, continuous
rfid.code string Hexadecimal code of connected RFID
rollover.alarm.status boolean Roll over alarm state
sdcard.log.enum number SD card log id
sdcard.log.marker.value number SD Log record Marker
security.event.enum number Security information ID
segment.acceleration.events number The number of harsh acceleration events during the last segment
segment.ain.voltage number volts Voltage difference between current and earlier obtained voltage reference
segment.braking.events number The number of braking events during the last segment
segment.can.fuel.consumed number liters Fuel volume consumed by vehicle on the last segment using CAN data
segment.cruise.control.distance number km Distance travelled under cruise control during the last segment
segment.cruise.control.fuel.used number liters Fuel used under cruise control during the last segment
segment.engine.on.time number seconds Time when engine was on during the last segment
segment.engine.overload.distance number km Distance travelled with overloaded engine during the last segment
segment.engine.overload.fuel.used number liters Fuel used while engine was overloaded during the last segment
segment.extreme.braking.events number The number of extreme braking events during the last segment
segment.free.rolling.distance number km Free rolling distance during the last segment
segment.fuel.idle.used number liters Fuel used while idling during the last segment
segment.harsh.braking.events number The number of harsh braking events during the last segment
segment.highest.gear.distance number km Distance travelled on highest gear during the last segment
segment.highest.gear.fuel.used number liters Fuel used when travelling on highest gear during the last segment
segment.idle.time number seconds Time when the vehocle was idle during the last segment
segment.max.acceleration number g Maximum acceleration value that occured on the segment
segment.max.angular.acceleration.deg_sec2 number deg/sec^2 Maximum angular acceleration value that occured on the segment
segment.max.braking.acceleration number g Maximum braking acceleration value that occured on the segment
segment.max.engine.rpm number rpm Maximum engine RPM on segment
segment.max.speed number km/h Maximum speed on the segment
segment.overspeeding.distance number km Distance travelled with overspeeding during the last segment
segment.overspeeding.fuel.used number liters Fuel used with overspeeding during the last segment
segment.overspeeding.time number seconds Time when speed was above limit during the last segment
segment.rpm.green number seconds Time when RPM was optimal during the last segment
segment.rpm.range.distance number km Distance travelled with RPM within the specified range during the last segment
segment.rpm.range.fuel.used number liters Fuel used when RPM was within the specified range during the last segment during the last segment
segment.rpm.red number seconds Time when RPM was not optimal during the last segment
segment.rpm.red.distance number km Distance travelled when RPM was not optimal during the last segment
segment.vehicle.mileage number km Segment mileage
sensor.temperature number celsius Temperature sensor value
server.timestamp number seconds Timestamp when server received message
shock.duration number milliseconds Duration of shock
sleep.timer.wakeup.status boolean Device wake-up by timer event
tacho.card.reader.status boolean Tacho card reader state
tacho.driver.continuous_driving.duration number seconds Driver continuous driving time
tacho.driver.cumulative_break.duration number seconds Driver cumulative break time
tacho.driver.cumulative_driving.duration number seconds Driver cumulative driving time
tacho.driver.current.activity.duration number seconds Current driver activity duration
tacho.driver.time.enum number Driver time states
tacho.engine.rpm number rpm Engine RPM reported by tacho
tacho.first.driver.card.status boolean Tacho card of first driver presence
tacho.fms.first.driver.id number First driver ID
tacho.fms.first.driver.status.enum number First driver state
tacho.fms.secondary.driver.id number Second driver ID
tacho.fms.secondary.driver.status.enum number Second driver state
tacho.position.speed number km/h Instant speed reported by tacho
tacho.registration.code string Tacho registration number
tacho.second.driver.card.status boolean Tacho card of second driver presence
tacho.trip.mileage number km Trip mileage calculated by tacho
tacho.vehicle.mileage number km Total mileage calculated by tacho
timestamp number seconds Message timestamp
towing.alarm.status boolean Towing alarm state
trailer.braking.wheel.speed number km/h Trailers Braking system wheel–based vehicle speed
trailer.lateral.acceleration number m/s^2 Trailers Lateral acceleration
trailer.main.axle.wheel.diff.speed number km/h Trailers Wheel speed difference main axle
trailer.state.bitmask number Trailer status
trailer.vin string Trailer VIN
trip.state.enum number Trip status
tyre.pressure.bitmask number Tire Pressure Measurement System message
ubi.process.status boolean UBI data saving is in process
umts.enabled boolean UMTS enabled
vehicle.mileage number km Total calculated mileage
vehicle.vin string VIN of vehicle
virtual.engine.ignition.status boolean Virtual engine ignition status
wireless.enabled boolean Wireless enabled
wireless.pair.status boolean Wireless Pair
x.acceleration number g Accelerometer value X
x.axis.angle number degrees X-axis angle to horizon
y.acceleration number g Accelerometer value Y
y.axis.angle number degrees Y-axis angle to horizon
z.acceleration number g Accelerometer value Z
z.axis.angle number degrees Z-axis angle to horizon

Below is the list of commands that can be sent to devices to change their configuration or to send signals to various outputs. When sending a command you can specify the transport type defining how the command will be delivered - the address parameter can take values connection (via network connection once the device goes online), sms (via SMS message), push (via PUSH notification). A comprehensive format of each command with all possible parameter values, parameter types, default values, etc. can be found in the REST API documentation in your flespi.io account.

Title Name Description Properties
Custom Command custom Send SMS command Over GPRS or SMS command: Command

sms_password: SMS Password
Request DTC dtc_codes Request Diagnostic Trouble Codes from Device
Garmin Data garmin_data Send Data to Germin Device payload: Hex data to send to Garmin device
Garmin Status garmin_status Get Status of Garmin Device