GPS u Lokazzjoni

# Għaliex il-Lokazzjoni hija Importanti

Nexus Telemetry juża l-lokazzjoni tiegħek biex juri l-pożizzjoni tat-terminal tiegħek, jipprovdi data tat-temp lokali, jaqbel satelliti fi Starlink Viewer (Pro), u jirrekordja rotot GPS matul-sessjonijiet (Pro).

# Sorsi GPS

Nexus Telemetry jappoġġja ħames sorsi ta’ lokazzjoni. Tista’ tikkonfigura wieħed jew aktar u l-app awtomatikament jaqleb għal sors ieħor jekk wieħed isir indisponibbli.

Iftaħ Settings → Geolocation biex timmaniġġja s-sorsi tal-lokazzjoni tiegħek.

# Żieda ta’ Sors GPS

Ikklikkja + Add Source biex iżżid sors GPS ġdid. Agħtih isem u agħżel it-tip ta’ sors.

It-tipi ta’ sorsi disponibbli huma:

• Serial (USB Dongle) : ikkonnettja riċevitur USB GPS direttament
• NMEA / TCP : irċievi sentenzi NMEA fuq konnessjoni TCP
• NMEA / UDP : isma’ għal sentenzi NMEA broadcast fuq UDP
• gpsd : ikkonnettja ma’ istanza gpsd eżistenti
• Starlink gRPC : aqra GPS mid-dish Starlink (qed jitneħħa)

Kull tip ta’ sors għandu l-għażliet ta’ konfigurazzjoni tiegħu, deskritti hawn taħt.

# Lokazzjoni Manwali

Għal installazzjonijiet fissi fejn id-dish tiegħek ma jiċċaqlaqx. Fittex indirizz jew isem ta’ post, ikklikkja fuq il-mappa biex tpoġġi pin, jew daħħal il-koordinati direttament. Ikklikkja Save Location biex issejvja. Il-koordinati tiegħek huma maħżuna lokalment u jibqgħu bejn sessjoni u oħra. Għandek bżonn tissettjahom darba waħda biss.

Il-lokazzjoni manwali dejjem tkun disponibbli bħala fallback jekk l-ebda sors GPS ma jkunx ikkonnettjat.

# Serial GPS (USB Dongles)

Għal setups mobbli. Ikkonnettja riċevitur USB GPS mal-magna li qed tħaddem Nexus Telemetry u żid sors Serial (USB Dongle). Agħżel il-port seriali mid-dropdown u issettja l-baud rate biex taqbel mal-apparat tiegħek (valuri komuni huma 4800, 9600, u 921600).

Nexus Telemetry jaqra sentenzi standard NMEA 0183 direttament mill-apparat. Jappoġġja kemm $GP (GPS biss) u kemm $GN (multi-constellation) prefissi ta’ sentenzi. L-ebda software addizzjonali mhu meħtieġ.

Għal rakkomandazzjonijiet ta’ riċevituri USB GPS, ara l-paragun ta’ riċevituri GPS tagħna.

# NMEA fuq TCP

Għal setups fejn ir-riċevitur GPS huwa ikkonnettjat ma’ magna differenti fuq in-network. Żid sors NMEA / TCP u daħħal il-host u l-port tal-apparat li qed jibgħat sentenzi NMEA. Nexus Telemetry jikkonnettja bħala klijent TCP u jaqra data NMEA mill-flusso.

Setup komuni hija Raspberry Pi b’USB GPS dongle li jibgħat sentenzi permezz ta’ socat:

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

# NMEA fuq UDP

Għal setups GPS ta’ broadcast. Żid sors NMEA / UDP u daħħal il-port li fuqu tisma’. Nexus Telemetry jisma’ għal sentenzi NMEA broadcast fuq UDP fuq il-port speċifikat. Dan huwa utli meta diversi apparati jeħtieġu jirċievu data GPS minn sors wieħed.

# gpsd

Għal utenti li diġà jħaddmu gpsd fuq is-sistema tagħhom. Żid sors gpsd u daħħal il-host u l-port tal-istanza gpsd (default: localhost:2947). Nexus Telemetry jikkonnettja mal-protokoll JSON ta’ gpsd u jissottoskrivni għal aġġornamenti tal-pożizzjoni.

# Starlink gRPC

Is-sors GPS oriġinali. Żid sors Starlink gRPC u daħħal l-indirizz tad-dish (default: 192.168.100.1:9200). Nexus Telemetry jaqra koordinati GPS mill-endpoint gRPC lokali tad-dish.

Nota: Dan is-sors jeħtieġ li l-GPS sharing toggle ikun attivat fl-app Starlink. Fuq hardware aktar ġdid (V4, Mini) dan it-toggle diġà tneħħa, u SpaceX se jiddiżattiva l-endpoint għal kollox fl-20 ta’ Mejju 2026. Jekk bħalissa qed tuża dan is-sors, ikkonfigura alternattiva qabel dik id-data.

# Auto-Fallback

Meta Auto-fallback ikun attivat (it-toggle fil-quċċata tas-sezzjoni GPS Sources), Nexus Telemetry awtomatikament jaqleb għas-sors disponibbli li jmiss jekk is-sors attiv tiegħek jieqaf jirrispondi. Pereżempju, jekk USB dongle jiġi diżikkonnettjat, l-app jaqleb għas-sors li jmiss fil-lista mingħajr interruzzjoni.

Tikkontrolla l-ordni ta’ prijorità billi tbiddel l-ordni tas-sorsi fil-lista. Nexus Telemetry jaħdem minn fuq għal isfel, u juża l-ewwel sors disponibbli. Il-lokazzjoni manwali dejjem tintuża bħala l-aħħar fallback.

Id-dashboard juri liema sors huwa attiv bħalissa u, għal sorsi GPS, kemm satelliti qed jiġu tracked.

# X’Isir Disponibbli

Ladarba l-lokazzjoni tiegħek tkun issettjata (permezz ta’ kwalunkwe sors), tara:

• Card tal-Lokazzjoni: Latitudni u lonġitudni b’mini mappa
• Card tat-Temp: Kundizzjonijiet tat-temp lokali bbażati fuq il-pożizzjoni tiegħek
• Starlink Viewer (Pro): Globu ċċentrat fuq id-dish tiegħek b’satellite matching
• Reġistrazzjoni tas-Sessjoni (Pro): Mappa tar-rotta f’sessjonijiet reġistrati

# Troubleshooting

Jekk data tal-lokazzjoni ma tidhirx f’Nexus Telemetry:

1. Iċċekkja l-istatus tas-sors: Iftaħ Settings → Geolocation u ivverifika li s-sors tiegħek jidher bħala Connected. Jekk juri error, iċċekkja l-konfigurazzjoni.
2. Sorsi seriali: Kun ċert li r-riċevitur USB huwa pplaggjat u li l-port seriali u l-baud rate korretti huma magħżula. Ipprova iddiskonnettja u erġa’ ikkonnettja l-apparat.
3. NMEA fuq TCP/UDP: Ivverifika li s-servizz ta’ forwarding qed jaħdem fuq il-magna remota u li l-host u l-port huma korretti. Iċċekkja li l-ebda firewall ma jkunx qed jibblokka l-konnessjoni.
4. gpsd: Ikkonferma li gpsd qed jaħdem (systemctl status gpsd) u li għandu GPS fix. Iċċekkja l-host u l-port fil-konfigurazzjoni tas-sors.
5. Starlink gRPC: Ivverifika li l-GPS toggle huwa attivat fl-app Starlink (jekk għadu disponibbli fuq il-hardware tiegħek). Kun ċert li Nexus Telemetry jista’ jilħaq id-dish fuq 192.168.100.1 (ara Problemi ta’ Konnessjoni).
6. Lokazzjoni manwali: Jekk l-ebda sors GPS ma jkunx disponibbli, issettja l-lokazzjoni tiegħek manwalment billi tuża l-mappa fis-sezzjoni Your Location fil-quċċata tal-paġna tas-settings tal-Geolocation.
7. Irristartja Nexus Telemetry: Agħlaq u erġa’ iftaħ l-applikazzjoni biex tirrisettja l-konnessjonijiet kollha.

Għal dettalji tekniċi dwar kif jaħdmu s-sorsi GPS f’Nexus Telemetry, ara l-blog post tagħna dwar il-bini ta’ GPS b’diversi sorsi.