gpsmon - Online na nuvem

PROGRAMA:

NOME

gpsmon - monitor de pacotes GPS em tempo real e utilitário de controle

SINOPSE

gpsmon [-L] [-V] [-h] [-n] [-a] [-l arquivo de log] [-t prefixo do driver]
[[ servidor [:porta [:dispositivo]] | dispositivo]] [-D nível de depuração]

DESCRIÇÃO

gpsmon é um monitor que observa os pacotes vindos de um GPS e os exibe junto com
informações de diagnóstico. Ele suporta comandos que podem ser usados ​​para ajustar as configurações de GPS em
várias maneiras; alguns são independentes do dispositivo, alguns variam com o tipo de chipset GPS. Será
comporte-se de maneira saudável, apenas despejando pacotes, quando conectado a um tipo de GPS sobre o qual nada sabe.

O gpsmon difere de um cliente de navegação porque despeja principalmente dados brutos do GPS,
com apenas a massagem de dados suficiente para permitir verificações em relação à saída esperada. Em particular,
esta ferramenta não faz nenhuma interpolação ou modelagem para derivar subida / afundamento ou erro
estimativas. Nem descarta relatórios de altitude quando a qualidade da correção é muito baixa.

Ao contrário do gpsd, o gpsmon nunca grava strings de controle ou sondagem no dispositivo, a menos que você
diga explicitamente para. Assim, embora ele sincronize automaticamente com os tipos de pacotes binários, ele não
reconhece automaticamente um dispositivo que envia um protocolo NMEA estendido como qualquer outro
do que um dispositivo NMEA simples. Use o -t opção ou o t para contornar isso.

gpsmon é projetado para ser executado em um emulador de terminal com um tamanho mínimo de 25x80; o não-GUI
interface é uma escolha de design feita para acomodar usuários que operam em ambientes restritos
ambientes e através de conexões telnet ou ssh. Se executado em uma janela maior, o tamanho de
a janela de log de pacotes será aumentada para caber.

gpsmon aceita uma opção -h que exibe uma mensagem de uso, ou uma opção -V para despejar o
versão do pacote e saída.

Este programa pode ser executado em qualquer um dos dois modos, como um cliente para o daemon gpsd (e seu
soquete de controle associado) ou diretamente conectado a um dispositivo serial especificado. Quando corre
sem nenhum argumento, ele tenta se conectar ao daemon. Se o argumento começar com um
servidor: a especificação da porta também tentará se conectar ao daemon. Se o argumento
parece um nome de servidor vazio, ele tentará se conectar a um daemon em execução no
porta gpsd padrão nesse servidor. Somente se o argumento do dispositivo contém barras, mas não
dois pontos serão tratados como um dispositivo serial para conexão direta. No modo de conexão direta
O gpsmon buscará uma taxa de transmissão correta e se conectará a ela automaticamente. Casos possíveis
parece com isso:

localhost: / dev / ttyS1
Observe a porta padrão de localhost, tentando IPv4 e IPv6 e observando a saída
do dispositivo serial 1.

exemplo.com:2317
Olhe para a porta 2317 em example.com, tentando IPv4 e IPv6.

71.162.241.5:2317:/dev/ttyS3
Olhe para a porta 2317 no endereço IPv4 especificado, coletando dados do serial conectado
dispositivo 3.

[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210]:2317:/dev/ttyS5
Olhe para a porta 2317 no endereço IPv6 especificado, coletando dados do serial conectado
dispositivo 5.

Ao contrário do gpsd, o gpsmon executado em modo direto não faz sua própria verificação de dispositivo. Assim, em
em particular, se você apontar para um GPS com um modo binário nativo que está emitindo
NMEA, ele não identificará o tipo real, a menos que o dispositivo emita um NMEA reconhecível
sentença de gatilho. As opções -t e -i podem ajudá-lo.

A opção -F só é válida no modo cliente; ele especifica um soquete de controle para o qual o
programa deve enviar strings de controle de dispositivo. Você deve especificar um nome de caminho válido de um
Soquete de domínio Unix em seu sistema de arquivos local.

A opção -D ativa a saída de depuração do getter de pacotes e provavelmente só é útil para
desenvolvedores do código GPSD. Consulte o código-fonte do getter de pacotes para obter os valores relevantes.

A opção -L lista uma tabela que mostra quais tipos de dispositivos GPS gpsmon tem suporte integrado
para, e quais comandos genéricos podem ser aplicados a quais tipos de GPS e, em seguida, sai. Observação
que isso não lista comandos específicos de tipo associados a tipos de GPS individuais.

A opção -l configura o registro em um arquivo especificado para iniciar imediatamente na abertura do dispositivo.
Isso pode ser útil se, por exemplo, você deseja capturar a mensagem de inicialização de um dispositivo
que exibe informações sobre a versão do firmware lá.

A opção -n força o gpsmon a solicitar pacotes NMEA0183 em vez do fluxo de dados bruto de
gpsd.

A opção -t configura um tipo de fallback. Dê a ele uma string que seja um prefixo distinto de
exatamente um nome de tipo de driver; isso será usado para mudança de modo, velocidade e taxa se o
o driver selecionado pelo tipo de pacote não possui esses recursos. Mais útil quando o pacote
tipo é NMEA, mas o dispositivo é conhecido por ter um modo binário, como o binário SiRF.

A opção -a ativa um modo de depuração especial que não usa pintura de tela. Pacotes
são despejados normalmente; qualquer caractere digitado suspende o despejo do pacote e traz um comando
mensagem. Este recurso será de interesse principalmente para desenvolvedores de GPSD.

Após a inicialização (sem -a), a parte superior da tela relata o conteúdo de vários
tipos de pacotes especialmente interessantes. O campo "PPS", se não estiver vazio, é o delta entre
o último 1PPS no início do segundo e o relógio do sistema naquele momento.

A metade inferior da tela é um dump hexadecimal de rolagem de todos os pacotes que o GPS está emitindo.
Se o tipo de pacote for textual, qualquer CR / LF final será omitido. Despejar linhas começando >>>
representam os pacotes de controle enviados ao GPS. Linhas consistindo em "PPS" cercadas por travessões,
se presente, indique 1PPS e o início do ciclo de relatório.

COMANDOS

Os seguintes comandos independentes de dispositivo estão disponíveis enquanto o gpsmon está em execução:

i
(Somente modo direto.) Habilite / desabilite a investigação de subtipo e reinicialize o driver. No
operação normal, gpsmon não envia strings de configuração para o dispositivo (exceto para
strings de ativação necessárias para enviar dados, se houver). O comando 'i1' faz com que
envie a mesma sequência de sondas de subtipo que o gpsd enviaria. O comando 'i0' desliga
sondagem; 'i' sozinho alterna a parte. Em qualquer um dos casos, o driver atual é selecionado novamente;
se o bit de teste estiver habilitado, os testes começarão a ser emitidos imediatamente.

Observe que a ativação da sondagem pode transformar o dispositivo em outro modo; em particular,
irá virar um chip SiRF para o modo binário, como se você tivesse usado o comando “n”. Isto é devido
a uma limitação no firmware SiRF que não podemos corrigir.

Este comando geralmente não fará nada depois da primeira vez que você o usar, porque o
tipo de dispositivo já terá sido descoberto.

c
(Somente modo direto.) Mude o tempo de ciclo. Siga-o com um número interpretado como um ciclo
tempo em segundos. A maioria dos dispositivos tem um tempo de ciclo fixo de 1 segundo, então este comando pode
falhe com uma mensagem.

l
Alterne o registro de pacotes. Se o log de pacotes estiver ativado, ele será desativado e o log
fechado. Se estiver desativado, o registro no nome do arquivo após o l será ativado. Difere
de simplesmente capturar os dados do dispositivo GPS em que apenas pacotes inteiros são
registrado. O arquivo de log é aberto para anexar, então você pode registrar mais de uma parte do
fluxo de pacote e eles serão costurados juntos corretamente.

n
(Apenas modo direto.) Com um argumento de 0, alterne o dispositivo para o modo NMEA na corrente
Rapidez; com um argumento de 1, mude para o modo binário (nativo). Sem argumento, alterne
a configuração. Irá mostrar um erro se o dispositivo não tiver tais modos.

Depois de mudar um GPS de protocolo duplo para o modo NMEA com este comando, ele retém o
informações sobre o tipo original e seus recursos de controle. É por isso que
o tipo de dispositivo listado antes do prompt não muda.

q
Saia do gpsmon. Control-C, ou qualquer que seja o seu caractere de interrupção atual, funciona como
bem.

s
(Somente modo direto.) Altere a taxa de transmissão. Siga-o com um número interpretado como bits por
segundo, por exemplo "s9600". O número da velocidade pode opcionalmente ser seguido por dois pontos
e uma especificação de stopbits de paridade de comprimento de palavra no estilo tradicional, por exemplo, 8N1 (o
padrão), 7E1, etc. Alguns dispositivos não suportam modos seriais diferentes do padrão,
portanto, este comando pode falhar com uma mensagem.

Use este comando com cuidado. Em GPSs USB e Bluetooth, também é possível para
configuração do modo serial para falhar porque o chip do adaptador serial não suporta
modos não 8N1 ou porque o firmware do dispositivo não sincroniza corretamente o serial
chip adaptador com o UART no chipset GPS quando a velocidade muda. Essas falhas
pode travar seu dispositivo, possivelmente exigindo um ciclo de energia do GPS ou (em casos extremos)
desconectar fisicamente a bateria de backup NVRAM.

t
(Somente modo direto.) Força uma troca de tipo de monitoramento. Siga-o com uma corda que seja
exclusivo para o nome de um driver gpsd com suporte gpsmon; gpsmon passará a usar
esse driver e código de exibição. Irá mostrar uma mensagem de erro se não houver gpsd correspondente
driver, ou combinações múltiplas, ou a combinação única não tem suporte de exibição no gpsmon.

x
(Somente modo direto.) Envie a carga hexadecimal para o dispositivo. Seguindo a carta de comando, você pode
digite pares de dígitos hexadecimais; termine com uma nova linha. Eles se tornarão a carga útil de um controle
pacote enviado para o dispositivo. O pacote será embalado com cabeçalhos, trailers e
checksum apropriado para o tipo de driver atual. O primeiro ou dois bytes do
carga útil pode ser especialmente interpretada, consulte a descrição do -x of gpsctl(1).

X
(Somente modo direto.) Envie bytes hexadecimais brutos para o dispositivo. Seguindo a carta de comando, você pode
digite pares de dígitos hexadecimais; termine com uma nova linha. Eles serão enviados para o dispositivo.

Ctrl-S
Congele a exibição, suspenda a rolagem na janela de depuração.

Ctrl-Q
Descongele a tela e retome a operação normal.

NMEA ajuda
(Estas observações se aplicam não apenas a dispositivos NMEA genéricos, mas a todos os dispositivos NMEA estendidos para
qual gpsmon atualmente tem suporte.)

Todos os campos são dados brutos do GPS, exceto (a) a janela "PVT cozido" próximo ao topo do
tela, fornecida como uma verificação e (b) o campo "PPS offset".

Não há comandos específicos do dispositivo. Os comandos genéricos disponíveis podem variar de acordo com
tipo: examine a saída de gpsmon -l para saber mais.

SiRF ajuda
A maioria das informações é bruta do GPS. Os campos sublinhados são derivados da tradução de
Coordenadas ECEF ou aplicação de compensações de segundo bissexto e de fuso horário local. 1PPS é o
atraso do relógio, como de costume.

Os seguintes comandos são suportados apenas para GPSes SiRF:

A
(Somente modo direto.) Alternar relatórios de dados do subframe de 50BPS.

M
(Somente modo direto.) Defina (M1) ou desmarque (M0) a navegação estática. A documentação do SiRF
afirma “A navegação estática é um filtro de posição projetado para ser usado com veículos motorizados.
Quando a velocidade do veículo cai abaixo de um limite, a posição e o rumo são
congelado, e a velocidade é definida como zero. Esta condição vai continuar até o cálculo
a velocidade sobe acima de 1.2 vezes o limite ou até que a posição calculada esteja em
pelo menos uma distância definida do local congelado. A velocidade limite e a distância definida
pode variar com as versões do software. ”

O modo não estático é projetado para uso com software de navegação rodoviária, que muitas vezes se encaixa
a posição relatada para a estrada mais próxima dentro de algum raio de incerteza. Você provavelmente
deseja desativar a navegação estática para uso de pedestres, pois é provável que informe a velocidade
zero e mudança de posição em grandes saltos.

P
(Somente modo direto.) Alterne o modo de exibição dos parâmetros de navegação. Alterna entre normal
display e um que mostra os parâmetros de navegação selecionados do MID 19, incluindo o
Bit de navegação estática alternado pelo comando 'M'.

Para interpretar o que você vê, você precisará de uma cópia do SiRF Binary Protocol Reference
Manual.

ublox ajuda
A maioria das informações é bruta do GPS. Os campos sublinhados são derivados da tradução de
Coordenadas ECEF. 1PPS é o atraso do clock, como de costume. Não há comandos especiais por tipo.

Use gpsmon online usando serviços onworks.net