Skip to Content

Trip Control

Commands to manage the trip lifecycle.


STPSTART - Start Trip

Starts a new trip, capturing GPS and start timestamp.

Syntax

STPSTART // Without driver STPSTART,DRIVER_CODE // With driver (1-16 chars)

Response

RTPSTART,<id>; Trip started

Example

>STPSTART,CHOFER001< >RTPSTART,127; Trip started ;ID=865413053386354;*5B<
  • Trip ID increments automatically (1-65535)
  • GPS and timestamp are captured at start
  • Histograms are reset
  • GC counters are not reset automatically

STPSTOP - End Trip

Ends the active trip, calculating fuel consumption and efficiency.

Syntax

STPSTOP

Response

RTPSTOP,<id>,<dist>; Trip ended

Example

>STPSTOP< >RTPSTOP,127,245; Trip ended ;ID=865413053386354;*13<
  • GPS and end timestamp are captured
  • Data remains available until next STPSTART
  • Status changes to IDLE

QTPSTATUS - Current Status

Queries the current trip status in a compact format.

Syntax

QTPSTATUS

Response

RTPSTATUS,<status>,<id>,<dist>km,<fuel>L,<time>,<driver>
FieldDescription
statusactive or idle
idTrip ID (0 if no trip)
distDistance in km
fuelFuel in liters (1 decimal)
timeFormat <h>h<m>m
driverCode or - if none

Examples

// Active trip >QTPSTATUS< >RTPSTATUS,active,127,245km,18.5L,4h15m,CHOFER001;ID=865413053386354;*10< // No trip >QTPSTATUS< >RTPSTATUS,idle,0,0km,0.0L,0h0m,-;ID=865413053386354;*1A<

STPDRV / QTPDRV - Driver Code

Query

QTPDRV RTPDRV,<code> // Current code RTPDRV,- // No driver

Set

STPDRV,CODE // Assign driver (1-16 chars) STPDRV, // Clear driver STPDRV,* // Clear driver (alternative)

Examples

>STPDRV,JUAN123< >RTPDRV,JUAN123; Driver code set ;ID=865413053386354;*60< >STPDRV,*< >RTPDRV,-; Driver code cleared ;ID=865413053386354;*77<

Individual Metrics

QTPRPM - Engine RPM

>QTPRPM< >RTPRPM,avg:2150,max:3200;ID=865413053386354;*0A<

QTPSPD - Speed

>QTPSPD< >RTPSPD,avg:78,max:125;ID=865413053386354;*3C<

QTPTEMP - Engine Temperature

>QTPTEMP< >RTPTEMP,avg:78.5,min:65.2,max:92.3;ID=865413053386354;*2F<

If a trip is active, shows current trip data. If no trip is active, shows data from the last completed trip.

Last updated