Protocol used by GPS tracking devices manufactured by Geometris headquartered in the USA.
flespi parses the Geometris protocol messages into a JSON object with the
fields listed below in the Parameters tab.
To connect your tracker using the Geometris protocol, you need to have a geometris channel created first.
Point your tracker to the channel's domain name:port via SMS or configuration tool provided by the vendor.
Then create a device instance for your tracker and use a serial number (28.) (usually specified on the tracker casing) in the ident field.
Use the Toolbox tab on the device screen to check if the messages are coming.
Important!
Since geometris protocol has the configurable format of data packets, the server needs to know the format of data packets configured on the devices to parse messages successfully.
The expected packet format can be specified in the channel's configuration. By default flespi geometris channel has the following packet format:
28.9.36.3.4.7.8.11.12.14.16.24.50.51
that matches the default Data Packet Assembly Format preconfigured on the whereQube devices.
If you use the flespi telematics hub on the channel level, i.e. don't create devices in flespi, then the packet format that is configured in the channel will be applied to all devices connected to the geometris channel. So, all the devices must have the same Data Packet Assembly Format setting, and it must be specified in the channel configuration.
If you created devices in flespi, then each device can have its own packet format that takes precedence over that of the channel. Packet format can be configured with the device's Settings -> Configuration tab -> Packet Format setting. If the Packet Format setting is configured for the device, it will be applied for parsing of the messages from the device, otherwise, the packet format configured for the channel will be used.
It's very important to keep the packet format synchronized on the devices and on the server — either in the channel or in the flespi device configuration.
If you changed the packet format on the tracker in any way other than via the flespi device settings, you must update the report format in flespi accordingly, i.e. request a new setting value from the device. Otherwise parsing will fail.
Also please note, that the report format must always have a serial number (28.) in the first place; the other fields may be used at your discretion. This is required for correct device identification.
battery.voltage
number
volts
Internal battery voltage
ble.beacons
array
Array with all detected BLE beacons data objects. Each object contain list of assosiated parameteres sent by appropriate beacon.
Standard parameter names used:
*id* - beacon identification string. Usually it is beacon's UUID or MAC-address
*local_name* - Beacons's Local Name
*rssi* - BLE signal level. Units = dBm
*battery.voltage* - Beacon's battery voltage. Units = volts
*battery.level* - Beacon's battery level. Units = percentage
*temperature* - Beacon's temperature. Units = celsius
bluetooth.mode
string
Bluetooth mode
bluetooth.version
string
Bluetooth version
board.type
string
Board type
can.active.dtc
string
Active (stored) diagnostic trouble code read from CAN
can.active.dtc.mil.status
boolean
Malfunction indicator lamp status read from CAN together with active (stored) diagnostic trouble codes
can.active.dtc.number
number
Number of active (stored) diagnostic trouble codes
can.adblue.level
number
percentage
AdBlue (diesel exhaust fluid) level read from CAN
can.adblue.temperature
number
celsius
AdBlue (diesel exhaust fluid) temperature read from CAN
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.battery.voltage
number
volts
Battery voltage read from CAN
can.cruise.control.state
number
Cruise control state read from CAN
can.cumulative.fuel.economy
number
km/liters
Cumulative fuel economy calculated for vehicle read from CAN
can.dm1.dtc
string
DM1 diagnostic trouble code read from CAN J1939
can.dm1.dtc.number
number
Number of DM1 diagnostic trouble codes for CAN J1939
can.dm1.mil.status
boolean
Malfunction indicator lamp status of DM1 for CAN J1939
can.dm2.dtc
string
DM2 diagnostic trouble code read from CAN J1939
can.dm2.dtc.number
number
Number of DM2 diagnostic trouble codes for CAN J1939
can.dm2.mil.status
boolean
Malfunction indicator lamp status of DM2 for CAN J1939
can.dpf.regeneration.threshold
number
percentage
DPF soot load regenration threshold read from CAN
can.dpf.regeneration.time
number
seconds
Time since last active regeneration of DPF read from CAN
can.dpf.soot.load
number
percentage
DPF soot load read from CAN
can.dtc
array
Diagnostic trouble code array read from CAN
can.dtc.number
number
Number of diagnostic trouble codes
can.engine.coolant.level
number
percentage
Engine coolant level read from CAN
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
can.engine.motorhours
number
hours
Total engine motorhours (engine work time) read from CAN
can.engine.oil.level
number
percentage
Engine oil level read from CAN
can.engine.oil.temperature
number
celsius
Engine oil temperature read from CAN
can.engine.rpm
number
rpm
Engine RPM read from CAN
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
can.fuel.economy
number
km/liters
CAN instantaneous fuel economy
can.fuel.idle.consumed
number
liters
Fuel volume totally consumed during idling state of the vehicle read from CAN
can.fuel.level
number
percentage
Fuel level in tank read from CAN
can.gas.consumed
number
kg
Total mass of gas used by gaseous engine read from CAN
can.gear
number
Current gear read from CAN. Numeric negative values are reverse gears, positive values are forward gears, zero is neutral
can.mil.status
boolean
Malfunction indicator lamp status read from CAN
can.powesource.takeof.duration
number
hours
PTO total duration read from CAN
can.pto.status
boolean
Power take-off status, read from CAN
can.seatbelt.status
boolean
Seatbelt status read from CAN, false - the belt is not buckled, true - the belt is buckled
can.throttle.position
number
percentage
Absolute throttle position for corresponding throttle position sensor read from CAN
can.total.cruise.control.time
number
hours
Total driving time when cruise control is ON, read from CAN
can.total.engine.idle.time
number
hours
Time of engine running in idling status (vehicle stopped) since vehicle manufacture, read from CAN
can.transmission.oil.level
number
percentage
Transmission oil level read from CAN
can.transmission.oil.temerature
number
celsius
Transmission oil temperature reaed from CAN
can.trip.fuel.consumed
number
liters
Volume of liquid fuel consumed for current trip read from CAN
can.trip.fuel.economy
number
km/liters
Fuel economy calculated for current trip read from CAN
can.trip.gas.consumed
number
kg
Mass of gas used by gaseous engine for current trip 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
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.imei
string
IMEI of the device
device.name
string
Name of device that received a message
device.temperature
number
celsius
Temperature of device
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
ecu.speed.limit
number
km/h
Vehicle speed limit set in ECU
engine.ignition.status
boolean
Engine ignition or ACC status
engine.motorhours
number
hours
Total calculated engine motorhours
event.seqnum
number
Unique event sequence number
event.timestamp
number
seconds
Timestamp of the event
external.powersource.voltage
number
volts
External power voltage
fault.tire
string
Axle and index of fault tire
fault.tire.cross.axle.fault.status
boolean
Fault tire cross axle fault
fault.tire.error.status
boolean
Fault tire status error
fault.tire.extreme.overpressure.status
boolean
Extreme overpressure of fault tire
fault.tire.extreme.underpressure.status
boolean
Extreme underpressure of fault tire
fault.tire.leakage.psi
number
psi
Fault tire leakage rate
fault.tire.leak.status
boolean
Fault tire leak detected
fault.tire.low.status
boolean
Low TPMS battery on fault tire
fault.tire.overpressure.status
boolean
Fault tire overpressure
fault.tire.pressure.error.status
boolean
Pressure sensor error on fault tire
fault.tire.pressure.psi
number
psi
Fault tire pressure
fault.tire.temperature
number
celsius
Fault tire temperature
fault.tire.temperature.error.status
boolean
Temperature sensor error on fault tire
fault.tire.underpressure.status
boolean
Fault tire underpressure
fault.tire.we.error.status
boolean
Wheel end sensor error on fault tire
firmware.hash
string
Firmware hash
firmware.type
string
Firmware type
firmware.version
string
Firmware version
geofence.id
number
Geofence ID
gnss.vehicle.mileage
number
km
Vehicle mileage calculated by global navigation system (GNSS)
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
gsm.msisdn
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) station integrated services digital network number
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
gsm.sim.type
string
SIM type
hardware.options
string
Hardware options
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
position.direction
number
degrees
Heading angle at position detection moment
position.fix.age
number
seconds
Time since the last position fix
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
protocol.id
number
ID of protocol
report.code
string
Report code
report.reason
number
Transmission reason code
rhumb
string
Heading in N,S,E,W notation
segment.vehicle.mileage
number
km
Segment mileage
server.timestamp
number
seconds
Timestamp when server received a message
supervisor.version
string
Supervisor version
timestamp
number
seconds
Message timestamp
tire
string
Axle and tire index
tire.cross.axle.fault.status
boolean
Tire cross axle fault
tire.error.status
boolean
Tire status error
tire.extreme.overpressure.status
boolean
Extreme tire overpressure
tire.extreme.underpressure.status
boolean
Extreme tire underpressure
tire.leakage.psi
number
psi
Tire leakage rate
tire.leak.status
boolean
Tire leak detected
tire.low.status
boolean
Low TPMS battery on tire
tire.overpressure.status
boolean
Tire overpressure
tire.pressure.error.status
boolean
Pressure sensor error on tire
tire.pressure.psi
number
psi
Tire pressure
tire.temperature
number
celsius
Tire temperature
tire.temperature.error.status
boolean
Temperature sensor error on tire
tire.underpressure.status
boolean
Tire underpressure
tire.we.error.status
boolean
Wheel end sensor error on tire
total.idle.seconds
number
seconds
Total time that vehicle was in idling state
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle
Properties
Custom command
custom
Send custom command to device
payload: Text of command to be sent to the device
wait_ack: Wait ACK
Tags
