Supported Hardware

Xirgo XG3700 TACHO SDK

1-wire, battery, ip67, lte, mqtt, rs-232, rs-485, vehicle
Xirgo XG3700 TACHO SDK is a vehicle GNSS tracker with LTE support, 2 simultaneous CAN-bus connections, tacho readings, and MQTT-based data transfer protocol. The device features an accelerometer, internal odometer, 1-Wire interface, 3 digital inputs, 3 analog inputs, 2 digital outputs, optional waterproof (IP67) casing, and more. The functionality includes driver identification, geofencing, fuel level sensors (analog, frequency, and digital) support, temperature/humidity sensors support, overspeeding control, eco-driving, fuel flow meters support, remote output control and immobilization, remote temperature read from digital thermograph, upload of DD files to FTP, etc.
Parameters Table
Parameter Type Unit Description Sources
absolute.acceleration number g Module of accelerometer vector Sensor ID 0xA001
ain number volts Voltage on the analog input Sensor ID 0x3001, Sensor ID 0x3002, Sensor ID 0x3003
armed.status boolean Armed/disarmed status Sensor ID 0x0060
battery.level number percentage Internal battery level Sensor ID 0x2041
battery.voltage number volts Internal battery voltage Sensor ID 0x3004
can.abs.failure.indicator.status boolean ABS failure indicator status read from CAN Sensor ID 0x007F
can.activity.status boolean CAN activity status if there were messages received last 10 seconds on CAN1 or on CAN2. Sensor ID 0x009F
can.adblue.level number percentage AdBlue (diesel exhaust fluid) level read from CAN Sensor ID 0x2021
can.airbag.fired.status boolean CAN airbag fired status Sensor ID 0x0079
can.ambient.air.temperature number celsius CAN ambient air temperature Sensor ID 0x302A
can.axle.weight number kg Weight on the axle read from CAN Sensor ID 0x302D...0x3031
can.barometric.pressure number kPa Absolute barometric pressure read from CAN Sensor ID 0x2040
can.battery.voltage.warning.status boolean Battery Voltage Warning status Sensor ID 0x0078
can.bitrate number CAN bitrate Sensor ID 0x4058, Sensor ID 0x4059
can.check.engine.status boolean CAN check engine warning is on Sensor ID 0x007A
can.command.id number Command Identifier, that is used by canbase_b function on CAN Sensor ID 0x302B, Sensor ID 0x302C
can.coolant.level.low.indicator.status boolean Coolant level low indicator status read from CAN Sensor ID 0x0076
can.cruise.state number Cruise control state Sensor ID 0x2031
can.cruise.status boolean CAN cruise control is active Sensor ID 0x008F
can.driver.seatbelt.indicator.status boolean Driver's seatbelt indicator status read from CAN Sensor ID 0x0085
can.dtc array Diagnostic trouble code array read from CAN
May content list of OBDII codes or list of objects with codes.
Standard object parameter names used:
*standard* - Protocol standard (J1939, J1708(J1587), OBDII)
*mid* - Message Identifier (J1708)
*sid* - Subsystem Identifier (J1708)
*fmi* - Failure Mode Identifier (J1939, J1708)
*spn* - Suspect Parameter Number (J1939)
*sa* - Source Address (J1939, OBDII)
*oc* - Occurrence Count (J1939)
*cm* - Conversion Method (J1939)
*status* - Status of error code (active, pending, historical, permanent)
Sensor ID 0xC015
can.electronic.power.control.status boolean Electronic power control status, read from CAN Sensor ID 0x0084
can.engine.coolant.temperature number celsius Engine coolant temperature read from CAN Sensor ID 0x2008, Sensor ID 0x2014
can.engine.fuel.rate number liters/h Engine fuel rate read from CAN Sensor ID 0x3021, Sensor ID 0x303D
can.engine.load.level number percentage Calculated engine load level read from CAN Sensor ID 0x200A, Sensor ID 0x2013
can.engine.motorhours number hours Total engine motorhours (engine work time) read from CAN Sensor ID 0x4002
can.engine.oil.pressure number kPa CAN Engine oil pressure Sensor ID 0x203F
can.engine.rpm number rpm Engine RPM read from CAN Sensor ID 0x300C, Sensor ID 0x303B
can.engine.torque.load number percentage Engine torque load percentage read from CAN Sensor ID 0x203A
can.esp.status boolean CAN ESP warning is on Sensor ID 0x0081
can.front.left.door.status boolean CAN front left door is opened Sensor ID 0x0062
can.front.right.door.status boolean CAN front right door is opened Sensor ID 0x0063
can.fuel.consumed number liters Fuel volume totally consumed by vehicle read from CAN Sensor ID 0x4001
can.fuel.consumed.high.resolution number liters Fuel volume totally consumed by vehicle calculated with high resolution (HRLFC), read from CAN Sensor ID 0x405A
can.fuel.consumption number liters/h Engine fuel rate read from CAN Sensor ID 0xA01B
can.fuel.economy number km/liters CAN instantaneous fuel economy Sensor ID 0x3034
can.fuel.low.indicator.status boolean CAN low fuel indicator is on Sensor ID 0x0080
can.fuel.pressure number kPa Fuel pressure read from CAN Sensor ID 0x2019
can.gear number Current gear read from CAN Sensor ID 0x203C
can.gross.combination.vehicle.weight number kg Gross combination vehicle weight read from CAN Sensor ID 0x3039
can.handbrake.status boolean CAN handbrake is pulled up Sensor ID 0x008B
can.high.beam.status boolean CAN high beams are on Sensor ID 0x0089
can.hood.status boolean CAN hood is opened Sensor ID 0x0066
can.ignition.key.status boolean The key is in ignition lock status, read from CAN Sensor ID 0x008A
can.intake.map number kPa Intake manifold absolute pressure Sensor ID 0x201A, Sensor ID 0x203E
can.j1979.engine.coolant.temperature number celsius CAN J1979 engine coolant temperature Sensor ID 0x2014
can.j1979.engine.fuel.rate number liters/h CAN J1979 Engine fuel rate Sensor ID 0x303D
can.j1979.engine.rpm number rpm CAN J1979 Engine RPM Sensor ID 0x303B
can.long.fuel.trim number percentage Short term fuel trim read from CAN Sensor ID 0x2016, Sensor ID 0x2018
can.master.warning.light.status boolean Status of master warning light, read from CAN Sensor ID 0x007E
can.messages.missed number Counter of missed messages from CAN bus Sensor ID 0x4057
can.messages.received number Counter of received messages from CAN bus Sensor ID 0x4056
can.oil.pressure.indicator.status boolean Oil pressure indicator status read from CAN bus Sensor ID 0x0075
can.passenger.seatbelt.indicator.status boolean Passenger seatbelt indicator status read from CAN Sensor ID 0x0086
can.pedal.brake.status boolean Footbrake pedal is depressed, read from CAN Sensor ID 0x008C
can.pedal.clutch.status boolean CAN clutch pedal pressed Sensor ID 0x009D
can.pto.state number Power take-off state, read from CAN Sensor ID 0x203B
can.pto.status boolean Power take-off status, read from CAN Sensor ID 0x009E
can.rear.left.door.status boolean CAN rear left door is opened Sensor ID 0x0064
can.rear.right.door.status boolean CAN rear right door is opened Sensor ID 0x0065
can.retarder.selection number percentage Retarder selection read from CAN Sensor ID 0x2039
can.retarder.torque.load number percentage Retarder torque load percentage read from CAN Sensor ID 0x2038
can.retarder.torque.mode number Retarder torque mode read from CAN Sensor ID 0x2037
can.service.mileage number km Service distance read from CAN Sensor ID 0x3038
can.short.fuel.trim number percentage Short term fuel trim read from CAN Sensor ID 0x2015, Sensor ID 0x2017
can.throttle.pedal.level number percentage Throttle pedal push level read from CAN Sensor ID 0x2006
can.tire.pressure.status boolean CAN tire pressure warning is on Sensor ID 0x007C
can.trunk.status boolean CAN trunk is opened Sensor ID 0x0067
can.vehicle.mileage number km Total vehicle mileage read from CAN Sensor ID 0x4003
can.vehicle.mileage.high.resolution number km Total vehicle mileage calculated with high resolution (VDHR), read from CAN Sensor ID 0x4062
can.webasto.status boolean Webasto status read from CAN bus Sensor ID 0x0093
can.wheel.speed number km/h Vehicle wheel based speed, read from CAN bus Sensor ID 0x301D
cargo.temperature number celsius Cargo temperature sensor value Sensor ID 0x3033
channel.id number ID of channel that received a message
counter.impulses number Impulses counter Sensor ID 0x3040...0x3043
custom any Any custom parameter
device.firmware.version string Firmware revision
device.id number ID of device that received a message
device.imei string IMEI of the device Sensor ID 0xC007
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 Sensor ID 0x0003, Sensor ID 0x0010, Sensor ID 0x0011, Sensor ID 0x0012, Sensor ID 0x0013, Sensor ID 0x0014, Sensor ID 0x0015
dout number Digital outputs bitmask Sensor ID 0x0094, Sensor ID 0x0095, Sensor ID 0x0096, Sensor ID 0x009A
driver.id string Driver identification card id Sensor ID 0xC016...0xC017
engine.ignition.status boolean Engine ignition or ACC status Sensor ID 0x006D
event.enum number Protocol-specific event code
event.function number Event function
external.powersource.voltage number volts External power voltage Sensor ID 0x3000
firmware.version string Firmware version Sensor ID 0xC012
fuel.sensor.value number Value reported by fuel sensor Sensor ID 0x2007, Sensor ID 0x2009
geofence.id number Geofence ID Sensor ID 0x202C
geofence.status boolean Geofence entered status Sensor ID 0x0006
gnss.jamming.status boolean GNSS receiver signal jamming detected Sensor ID 0x009B
gnss.signal.weak.status boolean GNSS signal weak Sensor ID 0x0007
gprs.status boolean GPRS mobile network status Sensor ID 0x000B
gsm.cellid number Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID Sensor ID 0x300A
gsm.jamming.alarm.status boolean Alarm status for the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) jamming Sensor ID 0x0008
gsm.lac number Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code Sensor ID 0x3009
gsm.mcc number Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code Sensor ID 0x3008
gsm.mnc number Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code Sensor ID 0x2003
gsm.network.status boolean Registration status in the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) Sensor ID 0x000A
gsm.signal.dbm number dbm Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal Sensor ID 0x2005
gsm.sim.iccid string Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) Sensor ID 0xC014
headlight.status boolean Headlights status Sensor ID 0x0088
ibutton.code string Hexadecimal code of connected iButton Sensor ID 0x5000
ibutton.connected.status boolean iButton connection status Sensor ID 0x001E
ident string Device unique identifier like serial number, IMEI, etc
last.success.registration.timestamp number Timestamp of last successful data registration Sensor ID 0x4060
locked.status boolean Locked/unlocked status Sensor ID 0x0061
media boolean Message contain media file
media.video object Video file in media storage
movement.status boolean Current movement state Sensor ID 0x0002
onewire.sensor.temperature number celsius External 1-Wire temperature sensor value Sensor ID 0x5004...0x5007, Sensor ID 0xA000, Sensor ID 0xA017, Sensor ID 0xA018, Sensor ID 0xA019, Sensor ID 0xA01A
payload.hex string HEX Payload received from device Sensor ID 0xE000...0xEFFF
peer string IP:port from which device connecting to the channel
position.altitude number meters Altitude value for position Sensor ID 0x7003, Sensor ID 0xD000
position.direction number degrees Heading angle at position detection moment Sensor ID 0x300B, Sensor ID 0xD000
position.hdop number Horizontal dilution of precision Sensor ID 0x2002, Sensor ID 0xD000
position.latitude number degrees Latitude coordinate value Sensor ID 0xB001, Sensor ID 0xD000
position.longitude number degrees Longitude coordinate value Sensor ID 0xB000, Sensor ID 0xD000
position.satellites number Quantity of satellites used to calculate coordinates for given position information Sensor ID 0x2001, Sensor ID 0xD000
position.speed number km/h Instant speed at position detection moment Sensor ID 0x2000, Sensor ID 0xD000
protocol.id number ID of protocol
reset.event boolean Device reset event Sensor ID 0x0000
script.name string Script name Sensor ID 0xC004...0xC006
sensor.boolean.value boolean User-defined sensor boolean value Sensor ID 0x001F...0x005F
sensor.float.value number User-defined sensor float value Sensor ID 0xA003, Sensor ID 0xA004, Sensor ID 0xA005, Sensor ID 0xA006, Sensor ID 0xA007, Sensor ID 0xA008, Sensor ID 0xA009, Sensor ID 0xA00A, Sensor ID 0xA00B, Sensor ID 0xA00C, Sensor ID 0xA00D, Sensor ID 0xA00E, Sensor ID 0xA00F, Sensor ID 0xA010, Sensor ID 0xA011
sensor.frequency number hz Frequency sensor value Sensor ID 0x3022...0x3025
sensor.int16.value number User-defined 2 bytes sensor signed value stored as int16, indexed parameter Sensor ID 0x7004...0x700D
sensor.int32.value number User-defined 4 bytes sensor signed value stored as int32, indexed parameter Sensor ID 0x8000...0x8009
sensor.int8.value number User-defined 1 byte sensor signed value stored as int8, indexed parameter Sensor ID 0x6000...0x6009
sensor.static.signal boolean User defined Static Signal flag, indexed parameter Sensor ID 0x001B...0x001C, Sensor ID 0x00A0...0x00A2
sensor.string.value string User-defined sensor string value Sensor ID 0xC000, Sensor ID 0xC001, Sensor ID 0xC002, Sensor ID 0xC003
sensor.uint16.value number User-defined 2 bytes sensor value stored as uint16, indexed parameter Sensor ID 0x300D...0x301C
sensor.uint32.value number User-defined 4 bytes sensor value stored as uint32, indexed parameter Sensor ID 0x4005...0x4054
sensor.uint64.value number User-defined 8 bytes sensor value stored as uint64, indexed parameter Sensor ID 0x5001
sensor.uint8.value number User-defined 1 byte sensor value stored as uint8, indexed parameter Sensor ID 0x200B...0x2012
server.timestamp number seconds Timestamp when server received a message
shock.event boolean Vibration level corresponds to shock Sensor ID 0x0098, Sensor ID 0x0099
tacho.file.manager.state number Tachograph File Manager State Sensor ID 0x202F
tacho.slot.activity number Slot activity from tachograph Sensor ID 0x202D, Sensor ID 0x202E
tacho.slot.distance number Slot distance from tachograph Sensor ID 0x405E...0x405F
tacho.slot.time number Slot time from tachograph Sensor ID 0x405C...0x405D
tacho.timestamp number seconds Time reported by tacho Sensor ID 0x4066
tacho.vehicle.mileage number km Total mileage calculated by tacho Sensor ID 0x405B
timestamp number seconds Message timestamp
turn.acceleration number g Acceleration on turn Sensor ID 0xA002
vehicle.mileage number km Total calculated mileage Sensor ID 0xB002
vibration.alarm boolean Vibration alarm event Sensor ID 0x0069
wiegand.code string Wiegand26 RFID code Sensor ID 0x4061
x.acceleration number g Accelerometer value X Sensor ID 0x7000
y.acceleration number g Accelerometer value Y Sensor ID 0x7001
z.acceleration number g Accelerometer value Z Sensor ID 0x7002