Controle de Viagens
Comandos para gerenciar o ciclo de vida das viagens.
STPSTART - Iniciar Viagem
Inicia uma nova viagem, capturando GPS e timestamp de início.
Sintaxe
STPSTART // Sem condutor
STPSTART,CODIGO_CONDUTOR // Com condutor (1-16 chars)Resposta
RTPSTART,<id>; Trip startedExemplo
>STPSTART,CHOFER001<
>RTPSTART,127; Trip started ;ID=865413053386354;*5B<- ID de viagem se incrementa automaticamente (1-65535)
- GPS e timestamp são capturados no início
- Histogramas são resetados
- Contadores GC não são resetados automaticamente
STPSTOP - Finalizar Viagem
Finaliza a viagem ativa, calculando combustível e eficiência.
Sintaxe
STPSTOPResposta
RTPSTOP,<id>,<dist>; Trip endedExemplo
>STPSTOP<
>RTPSTOP,127,245; Trip ended ;ID=865413053386354;*13<- GPS e timestamp de finalização são capturados
- Dados ficam disponíveis até o próximo
STPSTART - Estado muda para IDLE
Emissão ao encerrar (;@dst)
STPSTOP aceita um sufixo ;@dst opcional para emitir a viagem completa para um destino no mesmo comando que a finaliza. Também aceita os flags de seção (ver STPSEND).
STPSTOP;@dst // Finaliza e emite tudo para o destino
STPSTOP,<flags>;@dst // Finaliza e emite apenas as seções indicadasNesse caso a resposta acrescenta a quantidade de partes emitidas como S<n>:
>STPSTOP;@GPRS<
>RTPSTOP,127,245,S13; Trip ended ;ID=865413053386354;*4E<
// Viagem 127, 245 km, 13 partes emitidas por dados móveisSem ;@dst, STPSTOP mantém o comportamento habitual (apenas finaliza).
STPSEND — Enviar Viagem Completa a um Destino
Emite a viagem (atual ou a última finalizada) para um canal de saída, dividida em partes. Cada parte é enfileirada como relatório de usuário RPT_U0 com o payload completo, sem corte em 170 caracteres. É somente leitura: aceito tanto por STP quanto por QTP.
Sintaxe
STP,SEND[,<flags>];@dst // Emitir seções selecionadas ao destino- O sufixo
;@dsté obrigatório (indica o canal de saída). <flags>é opcional; se omitido, envia tudo.
Flags de seção
Combináveis, em qualquer ordem, sem distinção de maiúsculas/minúsculas:
| Flag | Seção | Partes |
|---|---|---|
R | Resumo | R0 + R1 (GPS, métricas, condutor, contadores) |
H | Histogramas | R2–R9 (velocidade/RPM/acelerador/turbo, PCT + RAW) |
S | Drive Score | R10 |
G | Estatísticas globais | RTPGTOT / RTPGREC / RTPGSCO / RTPGGC |
Sem flags equivale a RHSG (todas as seções).
Destinos (;@dst)
| Sufixo | Canal |
|---|---|
;@GPRS | Dados móveis |
;@WIFI | Wi-Fi |
;@LOG | Memória (log) |
;@BT | Bluetooth |
;@BACK | Backend |
;@TRM | Terminal |
Resposta
RTPSEND,<n>; Trip sentOnde <n> é a quantidade de partes efetivamente emitidas.
Exemplos
// Enviar TUDO por dados móveis
>STP,SEND;@GPRS<
>RTPSEND,13; Trip sent ;ID=865413053386354;*4C<
// Apenas resumo + score para a memória
>STP,SEND,RS;@LOG<
>RTPSEND,3; Trip sent ;ID=865413053386354;*2B<
// Apenas histogramas (válido também por QTP)
>QTP,SEND,H;@GPRS<
>RTPSEND,8; Trip sent ;ID=865413053386354;*1F<Sem ;@dst o comando falha: RTPERROR; SEND needs ;@dst.
Disponível a partir do firmware v1.09.24.
QTPSTATUS - Estado Atual
Consulta o estado atual da viagem de forma compacta.
Sintaxe
QTPSTATUSResposta
RTPSTATUS,<estado>,<id>,<dist>km,<fuel>L,<tempo>,<condutor>| Campo | Descrição |
|---|---|
estado | active ou idle |
id | ID da viagem (0 se não há viagem) |
dist | Distância em km |
fuel | Combustível em litros (1 decimal) |
tempo | Formato <h>h<m>m |
condutor | Código ou - se não há |
Exemplos
// Viagem ativa
>QTPSTATUS<
>RTPSTATUS,active,127,245km,18.5L,4h15m,CHOFER001;ID=865413053386354;*10<
// Sem viagem
>QTPSTATUS<
>RTPSTATUS,idle,0,0km,0.0L,0h0m,-;ID=865413053386354;*1A<STPDRV / QTPDRV - Código de Condutor
Consultar
QTPDRV
RTPDRV,<codigo> // Código atual
RTPDRV,- // Sem condutorEstabelecer
STPDRV,CODIGO // Atribuir condutor (1-16 chars)
STPDRV, // Limpar condutor
STPDRV,* // Limpar condutor (alternativo)Exemplos
>STPDRV,JUAN123<
>RTPDRV,JUAN123; Driver code set ;ID=865413053386354;*60<
>STPDRV,*<
>RTPDRV,-; Driver code cleared ;ID=865413053386354;*77<Métricas Individuais
QTPRPM - Revoluções do Motor
>QTPRPM<
>RTPRPM,avg:2150,max:3200;ID=865413053386354;*0A<QTPSPD - Velocidade
>QTPSPD<
>RTPSPD,avg:78,max:125;ID=865413053386354;*3C<QTPTEMP - Temperatura do Motor
>QTPTEMP<
>RTPTEMP,avg:78.5,min:65.2,max:92.3;ID=865413053386354;*2F<Se a viagem está ativa, mostra dados da viagem atual. Se não há viagem, mostra dados da última viagem completada.