GPS e localização

# Por que a localização é importante

O Nexus Telemetry usa sua localização para exibir a posição do seu terminal, fornecer dados meteorológicos locais, associar satélites no Starlink Viewer (Pro) e registrar rotas GPS durante as sessões (Pro).

# Fontes GPS

O Nexus Telemetry suporta cinco fontes de localização. Você pode configurar uma ou mais, e o aplicativo alternará automaticamente entre elas se uma ficar indisponível.

Abra Settings → Geolocation para gerenciar suas fontes de localização.

# Adicionar uma fonte GPS

Clique em + Add Source para adicionar uma nova fonte GPS. Dê um nome a ela e selecione o tipo de fonte.

Os tipos de fontes disponíveis são:

• Serial (USB Dongle) : conectar um receptor USB GPS diretamente
• NMEA / TCP : receber sentenças NMEA por uma conexão TCP
• NMEA / UDP : escutar sentenças NMEA transmitidas por UDP
• gpsd : conectar a uma instância gpsd existente
• Starlink gRPC : ler GPS da antena Starlink (em processo de descontinuação)

Cada tipo de fonte tem suas próprias opções de configuração, descritas abaixo.

# Localização manual

Para instalações fixas onde sua antena não se move. Pesquise um endereço ou nome de local, clique no mapa para colocar um marcador, ou insira as coordenadas diretamente. Clique em Save Location para salvar. Suas coordenadas são armazenadas localmente e persistem entre sessões. Você só precisa defini-las uma vez.

A localização manual está sempre disponível como fallback se nenhuma fonte GPS estiver conectada.

# GPS serial (dongles USB)

Para configurações móveis. Conecte um receptor USB GPS à máquina que executa o Nexus Telemetry e adicione uma fonte Serial (USB Dongle). Selecione a porta serial no menu suspenso e defina a taxa de transmissão para corresponder ao seu dispositivo (os valores comuns são 4800, 9600 e 921600).

O Nexus Telemetry lê sentenças NMEA 0183 padrão diretamente do dispositivo. Suporta tanto os prefixos de sentença $GP (apenas GPS) quanto $GN (multi-constelação). Nenhum software adicional é necessário.

Para recomendações de receptores USB GPS, consulte nossa comparação de receptores GPS.

# NMEA sobre TCP

Para configurações onde o receptor GPS está conectado a outra máquina na rede. Adicione uma fonte NMEA / TCP e insira o host e a porta do dispositivo que encaminha sentenças NMEA. O Nexus Telemetry conecta como cliente TCP e lê os dados NMEA do fluxo.

Uma configuração comum é um Raspberry Pi com um dongle USB GPS encaminhando sentenças usando socat:

socat /dev/ttyUSB0,b9600,raw TCP-LISTEN:10110,reuseaddr,fork

# NMEA sobre UDP

Para configurações GPS de transmissão. Adicione uma fonte NMEA / UDP e insira a porta de escuta. O Nexus Telemetry escuta sentenças NMEA transmitidas por UDP na porta especificada. Isso é útil quando vários dispositivos precisam receber dados GPS de uma única fonte.

# gpsd

Para usuários que já executam gpsd em seu sistema. Adicione uma fonte gpsd e insira o host e a porta da instância gpsd (padrão: localhost:2947). O Nexus Telemetry conecta ao protocolo JSON do gpsd e se inscreve para atualizações de posição.

# Starlink gRPC

A fonte GPS original. Adicione uma fonte Starlink gRPC e insira o endereço da antena (padrão: 192.168.100.1:9200). O Nexus Telemetry lê as coordenadas GPS do endpoint gRPC local da antena.

Nota: Esta fonte requer que o botão de compartilhamento GPS esteja ativado no aplicativo Starlink. Em hardware mais recente (V4, Mini), esse botão já foi removido, e a SpaceX desativará o endpoint completamente em 20 de maio de 2026. Se você usa essa fonte atualmente, configure uma alternativa antes dessa data.

# Fallback automático

Quando Auto-fallback está ativado (o botão no topo da seção Fontes GPS), o Nexus Telemetry muda automaticamente para a próxima fonte disponível se sua fonte ativa parar de responder. Por exemplo, se um dongle USB for desconectado, o aplicativo passa para a próxima fonte na lista sem interrupção.

Você controla a ordem de prioridade reordenando as fontes na lista. O Nexus Telemetry funciona de cima para baixo, usando a primeira fonte disponível. A localização manual é sempre usada como o último fallback.

O painel mostra qual fonte está ativa no momento e, para fontes GPS, quantos satélites estão sendo rastreados.

# O que fica disponível

Quando sua localização estiver definida (por meio de qualquer fonte), você verá:

• Cartão de localização: Latitude e longitude com um mini mapa
• Cartão meteorológico: Condições meteorológicas locais baseadas na sua posição
• Starlink Viewer (Pro): Globo centralizado na sua antena com associação de satélites
• Gravação de sessões (Pro): Mapeamento de rotas nas sessões gravadas

# Solução de problemas

Se os dados de localização não aparecem no Nexus Telemetry:

1. Verificar o status da fonte: Abra Settings → Geolocation e verifique se sua fonte aparece como Connected. Se mostrar um erro, verifique a configuração.
2. Fontes seriais: Certifique-se de que o receptor USB está conectado e de que a porta serial e a taxa de transmissão corretas estão selecionadas. Tente desconectar e reconectar o dispositivo.
3. NMEA sobre TCP/UDP: Verifique se o serviço de encaminhamento está funcionando na máquina remota e se o host e a porta estão corretos. Confirme que nenhum firewall está bloqueando a conexão.
4. gpsd: Confirme que o gpsd está em execução (systemctl status gpsd) e que tem um fix GPS. Verifique o host e a porta na configuração da fonte.
5. Starlink gRPC: Verifique se o botão GPS está ativado no aplicativo Starlink (se ainda disponível no seu hardware). Certifique-se de que o Nexus Telemetry consegue alcançar a antena em 192.168.100.1 (consulte Problemas de conexão).
6. Localização manual: Se nenhuma fonte GPS estiver disponível, defina sua localização manualmente usando o mapa na seção Your Location no topo da página de configurações de geolocalização.
7. Reiniciar o Nexus Telemetry: Feche e reabra o aplicativo para redefinir todas as conexões.

Para detalhes técnicos sobre como as fontes GPS funcionam no Nexus Telemetry, consulte nosso artigo no blog sobre a construção de GPS multi-fonte.