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 startedExample
>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
STPSTOPResponse
RTPSTOP,<id>,<dist>; Trip endedExample
>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
Emit on close (;@dst)
STPSTOP accepts an optional ;@dst suffix to emit the full trip to a destination in the same command that ends it. It also accepts the section flags (see STPSEND).
STPSTOP;@dst // Ends and emits everything to the destination
STPSTOP,<flags>;@dst // Ends and emits only the selected sectionsIn that case the response appends the number of parts emitted as S<n>:
>STPSTOP;@GPRS<
>RTPSTOP,127,245,S13; Trip ended ;ID=865413053386354;*4E<
// Trip 127, 245 km, 13 parts emitted over mobile dataWithout ;@dst, STPSTOP keeps the usual behavior (ends only).
STPSEND — Send Full Trip to a Destination
Emits the trip (current or last completed) to an output channel, split into parts. Each part is queued as a user report RPT_U0 with the full payload, without the 170-character trim. It is read-only: accepted by both STP and QTP.
Syntax
STP,SEND[,<flags>];@dst // Emit selected sections to the destination- The
;@dstsuffix is required (it sets the output channel). <flags>is optional; if omitted, everything is sent.
Section flags
Composable, in any order, case-insensitive:
| Flag | Section | Parts |
|---|---|---|
R | Summary | R0 + R1 (GPS, metrics, driver, counters) |
H | Histograms | R2–R9 (speed/RPM/throttle/turbo, PCT + RAW) |
S | Drive Score | R10 |
G | Global stats | RTPGTOT / RTPGREC / RTPGSCO / RTPGGC |
No flags is equivalent to RHSG (all sections).
Destinations (;@dst)
| Suffix | Channel |
|---|---|
;@GPRS | Mobile data |
;@WIFI | Wi-Fi |
;@LOG | Memory (log) |
;@BT | Bluetooth |
;@BACK | Backend |
;@TRM | Terminal |
Response
RTPSEND,<n>; Trip sentWhere <n> is the number of parts actually emitted.
Examples
// Send EVERYTHING over mobile data
>STP,SEND;@GPRS<
>RTPSEND,13; Trip sent ;ID=865413053386354;*4C<
// Summary + score only, to memory
>STP,SEND,RS;@LOG<
>RTPSEND,3; Trip sent ;ID=865413053386354;*2B<
// Histograms only (also valid via QTP)
>QTP,SEND,H;@GPRS<
>RTPSEND,8; Trip sent ;ID=865413053386354;*1F<Without ;@dst the command fails: RTPERROR; SEND needs ;@dst.
Available from firmware v1.09.24.
QTPSTATUS - Current Status
Queries the current trip status in a compact format.
Syntax
QTPSTATUSResponse
RTPSTATUS,<status>,<id>,<dist>km,<fuel>L,<time>,<driver>| Field | Description |
|---|---|
status | active or idle |
id | Trip ID (0 if no trip) |
dist | Distance in km |
fuel | Fuel in liters (1 decimal) |
time | Format <h>h<m>m |
driver | Code 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 driverSet
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.