GPS e localização

# Porque é que a localização é importante

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

# Fontes GPS

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

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

# Adicionar uma fonte GPS

Clique em + Add Source para adicionar uma nova fonte GPS. Atribua-lhe um nome e selecione o tipo de fonte.

Os tipos de fontes disponíveis são:

• Serial (USB Dongle) : ligar um recetor USB GPS diretamente
• NMEA / TCP : receber frases NMEA através de uma ligação TCP
• NMEA / UDP : escutar frases NMEA transmitidas por UDP
• gpsd : ligar a uma instância gpsd existente
• Starlink gRPC : ler GPS a partir da antena Starlink (em processo de descontinuação)

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

# Localização manual

Para instalações fixas em que a sua antena não se move. Pesquise um endereço ou nome de local, clique no mapa para colocar um marcador, ou introduza as coordenadas diretamente. Clique em Save Location para guardar. As suas coordenadas são armazenadas localmente e persistem entre sessões. Só precisa de as definir uma vez.

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

# GPS série (dongles USB)

Para configurações móveis. Ligue um recetor USB GPS à máquina que executa o Nexus Telemetry e adicione uma fonte Serial (USB Dongle). Selecione a porta série no menu pendente 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ê frases NMEA 0183 padrão diretamente do dispositivo. Suporta tanto os prefixos de frase $GP (apenas GPS) como $GN (multi-constelação). Não é necessário software adicional.

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

# NMEA sobre TCP

Para configurações em que o recetor GPS está ligado a outra máquina na rede. Adicione uma fonte NMEA / TCP e introduza o host e a porta do dispositivo que reencaminha frases NMEA. O Nexus Telemetry liga-se como cliente TCP e lê os dados NMEA do fluxo.

Uma configuração comum é um Raspberry Pi com um dongle USB GPS que reencaminha frases usando socat:

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

# NMEA sobre UDP

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

# gpsd

Para utilizadores que já executam gpsd no seu sistema. Adicione uma fonte gpsd e introduza o host e a porta da instância gpsd (predefinido: localhost:2947). O Nexus Telemetry liga-se ao protocolo JSON do gpsd e subscreve atualizações de posição.

# Starlink gRPC

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

Nota: Esta fonte requer que o interruptor de partilha GPS esteja ativado na aplicação Starlink. Em hardware mais recente (V4, Mini), este interruptor já foi removido, e a SpaceX desativará o endpoint completamente a 20 de maio de 2026. Se utiliza atualmente esta fonte, configure uma alternativa antes dessa data.

# Fallback automático

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

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

O painel mostra qual fonte está atualmente ativa e, para fontes GPS, quantos satélites estão a ser rastreados.

# O que fica disponível

Quando a sua localização estiver definida (através de qualquer fonte), 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 centrado na sua antena com associação de satélites
• Gravação de sessões (Pro): Mapeamento de rotas nas sessões gravadas

# Resolução de problemas

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

1. Verificar o estado da fonte: Abra Settings → Geolocation e verifique se a sua fonte aparece como Connected. Se mostrar um erro, verifique a configuração.
2. Fontes série: Certifique-se de que o recetor USB está ligado e de que a porta série e a taxa de transmissão corretas estão selecionadas. Tente desligar e voltar a ligar o dispositivo.
3. NMEA sobre TCP/UDP: Verifique se o serviço de reencaminhamento está a funcionar na máquina remota e se o host e a porta estão corretos. Confirme que nenhuma firewall está a bloquear a ligaçã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 interruptor GPS está ativado na aplicação 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 ligação).
6. Localização manual: Se nenhuma fonte GPS estiver disponível, defina a sua localização manualmente usando o mapa na secção Your Location no topo da página de definições de geolocalização.
7. Reiniciar o Nexus Telemetry: Feche e reabra a aplicação para repor todas as ligações.

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