GPS & Lokasi

# Mengapa Lokasi Penting

Nexus Telemetry menggunakan lokasi anda untuk memaparkan kedudukan terminal, menyediakan data cuaca tempatan, memadankan satelit dalam Starlink Viewer (Pro), dan merekod laluan GPS semasa sesi (Pro).

# Sumber GPS

Nexus Telemetry menyokong lima sumber lokasi. Anda boleh mengkonfigurasi satu atau lebih, dan aplikasi akan bertukar secara automatik kepada sumber lain jika salah satu tidak tersedia.

Buka Settings → Geolocation untuk mengurus sumber lokasi anda.

# Menambah Sumber GPS

Klik + Add Source untuk menambah sumber GPS baharu. Berikan nama dan pilih jenis sumber.

Jenis sumber yang tersedia adalah:

• Serial (USB Dongle) : menyambungkan USB GPS receiver secara terus
• NMEA / TCP : menerima NMEA sentences melalui sambungan TCP
• NMEA / UDP : mendengar NMEA sentences yang disiarkan melalui UDP
• gpsd : menyambung ke instance gpsd sedia ada
• Starlink gRPC : membaca GPS daripada dish Starlink (akan ditamatkan)

Setiap jenis sumber mempunyai pilihan konfigurasi tersendiri, seperti yang diterangkan di bawah.

# Lokasi Manual

Untuk pemasangan tetap di mana dish anda tidak bergerak. Cari alamat atau nama tempat, klik peta untuk meletakkan pin, atau masukkan koordinat secara terus. Klik Save Location untuk menyimpan. Koordinat anda disimpan secara setempat dan kekal antara sesi. Anda hanya perlu menetapkannya sekali sahaja.

Lokasi manual sentiasa tersedia sebagai sandaran jika tiada sumber GPS disambungkan.

# Serial GPS (USB Dongle)

Untuk persediaan mudah alih. Pasangkan USB GPS receiver ke mesin yang menjalankan Nexus Telemetry dan tambah sumber Serial (USB Dongle). Pilih serial port daripada senarai juntai bawah dan tetapkan baud rate yang sepadan dengan peranti anda (nilai lazim ialah 4800, 9600, dan 921600).

Nexus Telemetry membaca NMEA 0183 sentences standard terus daripada peranti. Ia menyokong kedua-dua prefix sentence $GP (GPS sahaja) dan $GN (pelbagai konstelasi). Tiada perisian tambahan diperlukan.

Untuk cadangan USB GPS receiver, lihat perbandingan GPS receiver.

# NMEA over TCP

Untuk persediaan di mana GPS receiver disambungkan ke mesin lain dalam rangkaian. Tambah sumber NMEA / TCP dan masukkan hos serta port peranti yang menghantar NMEA sentences. Nexus Telemetry menyambung sebagai TCP client dan membaca data NMEA daripada strim.

Persediaan lazim ialah Raspberry Pi dengan USB GPS dongle yang menghantar sentences menggunakan socat:

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

# NMEA over UDP

Untuk persediaan GPS siaran. Tambah sumber NMEA / UDP dan masukkan port untuk didengari. Nexus Telemetry mendengar NMEA sentences yang disiarkan melalui UDP pada port yang ditetapkan. Ini berguna apabila beberapa peranti perlu menerima data GPS daripada satu sumber.

# gpsd

Untuk pengguna yang sudah menjalankan gpsd pada sistem mereka. Tambah sumber gpsd dan masukkan hos serta port instance gpsd (lalai: localhost:2947). Nexus Telemetry menyambung ke gpsd JSON protocol dan melanggan kemas kini kedudukan.

# Starlink gRPC

Sumber GPS asal. Tambah sumber Starlink gRPC dan masukkan alamat dish (lalai: 192.168.100.1:9200). Nexus Telemetry membaca koordinat GPS daripada gRPC endpoint tempatan dish.

Nota: Sumber ini memerlukan togol perkongsian GPS diaktifkan dalam aplikasi Starlink. Pada perkakasan yang lebih baharu (V4, Mini), togol ini telah dialih keluar, dan SpaceX akan menyahaktifkan endpoint sepenuhnya pada 20 Mei 2026. Jika anda sedang menggunakan sumber ini, konfigurasikan alternatif sebelum tarikh tersebut.

# Fallback Automatik

Apabila Auto-fallback diaktifkan (togol di bahagian atas seksyen GPS Sources), Nexus Telemetry secara automatik bertukar ke sumber seterusnya yang tersedia jika sumber aktif anda berhenti bertindak balas. Contohnya, jika USB dongle dicabut, aplikasi bertukar ke sumber seterusnya dalam senarai tanpa gangguan.

Anda mengawal susunan keutamaan dengan menyusun semula sumber dalam senarai. Nexus Telemetry berfungsi dari atas ke bawah, menggunakan sumber pertama yang tersedia. Lokasi manual sentiasa digunakan sebagai sandaran terakhir.

Papan pemuka menunjukkan sumber mana yang sedang aktif dan, untuk sumber GPS, berapa banyak satelit yang sedang dijejak.

# Ciri yang Tersedia

Setelah lokasi anda ditetapkan (melalui mana-mana sumber), anda akan melihat:

• Location card: Latitud dan longitud dengan peta mini
• Weather card: Keadaan cuaca tempatan berdasarkan kedudukan anda
• Starlink Viewer (Pro): Globe berpusat pada dish anda dengan pemadanan satelit
• Session recording (Pro): Pemetaan laluan pada sesi yang direkod

# Penyelesaian Masalah

Jika data lokasi tidak dipaparkan dalam Nexus Telemetry:

1. Semak status sumber: Buka Settings → Geolocation dan sahkan bahawa sumber anda menunjukkan status Connected. Jika ia menunjukkan ralat, semak konfigurasi.
2. Sumber serial: Pastikan USB receiver dipasang dan serial port serta baud rate yang betul telah dipilih. Cuba cabut dan pasang semula peranti.
3. NMEA over TCP/UDP: Sahkan bahawa perkhidmatan penghantaran berjalan pada mesin jauh dan hos serta port adalah betul. Pastikan tiada firewall yang menyekat sambungan.
4. gpsd: Sahkan bahawa gpsd sedang berjalan (systemctl status gpsd) dan ia mempunyai GPS fix. Semak hos dan port dalam konfigurasi sumber.
5. Starlink gRPC: Sahkan bahawa togol GPS diaktifkan dalam aplikasi Starlink (jika masih tersedia pada perkakasan anda). Pastikan Nexus Telemetry boleh mencapai dish di 192.168.100.1 (lihat Masalah Sambungan).
6. Lokasi manual: Jika tiada sumber GPS tersedia, tetapkan lokasi anda secara manual menggunakan peta di bahagian Your Location di bahagian atas halaman tetapan Geolocation.
7. Mulakan semula Nexus Telemetry: Tutup dan buka semula aplikasi untuk menetapkan semula semua sambungan.

Untuk butiran teknikal tentang cara sumber GPS berfungsi dalam Nexus Telemetry, lihat catatan blog kami tentang membina GPS pelbagai sumber.