Control de Viajes
Comandos para gestionar el ciclo de vida de los viajes.
STPSTART - Iniciar Viaje
Inicia un nuevo viaje, capturando GPS y timestamp de inicio.
Sintaxis
STPSTART // Sin conductor
STPSTART,CODIGO_CONDUCTOR // Con conductor (1-16 chars)Respuesta
RTPSTART,<id>; Trip startedEjemplo
>STPSTART,CHOFER001<
>RTPSTART,127; Trip started ;ID=865413053386354;*5B<- ID de viaje se incrementa automáticamente (1-65535)
- GPS y timestamp se capturan al inicio
- Histogramas se resetean
- Contadores GC no se resetean automáticamente
STPSTOP - Finalizar Viaje
Finaliza el viaje activo, calculando combustible y eficiencia.
Sintaxis
STPSTOPRespuesta
RTPSTOP,<id>,<dist>; Trip endedEjemplo
>STPSTOP<
>RTPSTOP,127,245; Trip ended ;ID=865413053386354;*13<- GPS y timestamp de finalización se capturan
- Datos quedan disponibles hasta el próximo
STPSTART - Estado cambia a IDLE
Emisión al cierre (;@dst)
STPSTOP acepta un sufijo ;@dst opcional para emitir el viaje completo hacia un destino en el mismo comando que lo finaliza. También admite los flags de sección (ver STPSEND).
STPSTOP;@dst // Finaliza y emite todo al destino
STPSTOP,<flags>;@dst // Finaliza y emite solo las secciones indicadasEn ese caso la respuesta agrega la cantidad de partes emitidas como S<n>:
>STPSTOP;@GPRS<
>RTPSTOP,127,245,S13; Trip ended ;ID=865413053386354;*4E<
// Viaje 127, 245 km, 13 partes emitidas por datos móvilesSin ;@dst, STPSTOP mantiene el comportamiento habitual (solo finaliza).
STPSEND — Enviar Viaje Completo a un Destino
Emite el viaje (actual o el último finalizado) hacia un canal de salida, dividido en partes. Cada parte se encola como reporte de usuario RPT_U0 con el payload completo, sin recorte a 170 caracteres. Es de solo lectura: se acepta tanto por STP como por QTP.
Sintaxis
STP,SEND[,<flags>];@dst // Emitir secciones seleccionadas al destino- El sufijo
;@dstes obligatorio (indica el canal de salida). <flags>es opcional; si se omite se envía todo.
Flags de sección
Componibles, en cualquier orden, sin distinción de mayúsculas/minúsculas:
| Flag | Sección | Partes |
|---|---|---|
R | Resumen | R0 + R1 (GPS, métricas, conductor, contadores) |
H | Histogramas | R2–R9 (velocidad/RPM/acelerador/turbo, PCT + RAW) |
S | Drive Score | R10 |
G | Estadísticas globales | RTPGTOT / RTPGREC / RTPGSCO / RTPGGC |
Sin flags equivale a RHSG (todas las secciones).
Destinos (;@dst)
| Sufijo | Canal |
|---|---|
;@GPRS | Datos móviles |
;@WIFI | Wi-Fi |
;@LOG | Memoria (log) |
;@BT | Bluetooth |
;@BACK | Backend |
;@TRM | Terminal |
Respuesta
RTPSEND,<n>; Trip sentDonde <n> es la cantidad de partes efectivamente emitidas.
Ejemplos
// Enviar TODO por datos móviles
>STP,SEND;@GPRS<
>RTPSEND,13; Trip sent ;ID=865413053386354;*4C<
// Solo resumen + score a la memoria
>STP,SEND,RS;@LOG<
>RTPSEND,3; Trip sent ;ID=865413053386354;*2B<
// Solo histogramas (válido también por QTP)
>QTP,SEND,H;@GPRS<
>RTPSEND,8; Trip sent ;ID=865413053386354;*1F<Sin ;@dst el comando falla: RTPERROR; SEND needs ;@dst.
Disponible desde el firmware v1.09.24.
QTPSTATUS - Estado Actual
Consulta el estado actual del viaje de forma compacta.
Sintaxis
QTPSTATUSRespuesta
RTPSTATUS,<estado>,<id>,<dist>km,<fuel>L,<tiempo>,<conductor>| Campo | Descripción |
|---|---|
estado | active o idle |
id | ID del viaje (0 si no hay viaje) |
dist | Distancia en km |
fuel | Combustible en litros (1 decimal) |
tiempo | Formato <h>h<m>m |
conductor | Código o - si no hay |
Ejemplos
// Viaje activo
>QTPSTATUS<
>RTPSTATUS,active,127,245km,18.5L,4h15m,CHOFER001;ID=865413053386354;*10<
// Sin viaje
>QTPSTATUS<
>RTPSTATUS,idle,0,0km,0.0L,0h0m,-;ID=865413053386354;*1A<STPDRV / QTPDRV - Código de Conductor
Consultar
QTPDRV
RTPDRV,<codigo> // Código actual
RTPDRV,- // Sin conductorEstablecer
STPDRV,CODIGO // Asignar conductor (1-16 chars)
STPDRV, // Limpiar conductor
STPDRV,* // Limpiar conductor (alternativo)Ejemplos
>STPDRV,JUAN123<
>RTPDRV,JUAN123; Driver code set ;ID=865413053386354;*60<
>STPDRV,*<
>RTPDRV,-; Driver code cleared ;ID=865413053386354;*77<Métricas Individuales
QTPRPM - Revoluciones del Motor
>QTPRPM<
>RTPRPM,avg:2150,max:3200;ID=865413053386354;*0A<QTPSPD - Velocidad
>QTPSPD<
>RTPSPD,avg:78,max:125;ID=865413053386354;*3C<QTPTEMP - Temperatura del Motor
>QTPTEMP<
>RTPTEMP,avg:78.5,min:65.2,max:92.3;ID=865413053386354;*2F<Si el viaje está activo, muestra datos del viaje actual. Si no hay viaje, muestra datos del último viaje completado.