GPS та місцезнаходження

# Чому місцезнаходження важливе

Nexus Telemetry використовує ваше місцезнаходження для відображення позиції термінала, надання місцевих даних про погоду, зіставлення супутників у Starlink Viewer (Pro) та запису GPS маршрутів під час сесій (Pro).

# Джерела GPS

Nexus Telemetry підтримує п’ять джерел місцезнаходження. Ви можете налаштувати одне або кілька, і застосунок автоматично перемкнеться на інше, якщо одне стане недоступним.

Відкрийте Settings → Geolocation, щоб керувати джерелами місцезнаходження.

# Додавання джерела GPS

Натисніть + Add Source, щоб додати нове джерело GPS. Дайте йому назву та виберіть тип джерела.

Доступні типи джерел:

• Serial (USB Dongle) : підключіть USB GPS приймач безпосередньо
• NMEA / TCP : отримуйте речення NMEA через з’єднання TCP
• NMEA / UDP : слухайте речення NMEA, що транслюються через UDP
• gpsd : підключіться до наявного екземпляра gpsd
• Starlink gRPC : зчитуйте GPS з тарілки Starlink (підтримка припиняється)

Кожен тип джерела має власні параметри налаштування, описані нижче.

# Ручне місцезнаходження

Для стаціонарних установок, де тарілка не переміщується. Знайдіть адресу або назву місця, натисніть на карту, щоб поставити мітку, або введіть координати вручну. Натисніть Save Location, щоб зберегти. Ваші координати зберігаються локально і не втрачаються між сесіями. Їх потрібно встановити лише один раз.

Ручне місцезнаходження завжди доступне як резервний варіант, якщо жодне джерело GPS не підключено.

# Serial GPS (USB приймачі)

Для мобільних конфігурацій. Підключіть USB GPS приймач до машини, на якій працює Nexus Telemetry, і додайте джерело Serial (USB Dongle). Виберіть послідовний порт зі спадного меню та встановіть швидкість передачі відповідно до вашого пристрою (поширені значення: 4800, 9600 та 921600).

Nexus Telemetry зчитує стандартні речення NMEA 0183 безпосередньо з пристрою. Підтримуються як префікси $GP (лише GPS), так і $GN (багатосистемні). Додаткове програмне забезпечення не потрібне.

Рекомендації щодо USB GPS приймачів дивіться в нашому порівнянні GPS приймачів.

# NMEA через TCP

Для конфігурацій, де GPS приймач підключено до іншої машини в мережі. Додайте джерело NMEA / TCP і введіть хост та порт пристрою, що пересилає речення NMEA. Nexus Telemetry підключається як TCP клієнт і зчитує дані NMEA з потоку.

Поширена конфігурація: Raspberry Pi з USB GPS приймачем, що пересилає речення за допомогою socat:

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

# NMEA через UDP

Для конфігурацій GPS із широкомовною передачею. Додайте джерело NMEA / UDP і введіть порт для прослуховування. Nexus Telemetry слухає речення NMEA, що транслюються через UDP на вказаному порту. Це зручно, коли кілька пристроїв повинні отримувати дані GPS з одного джерела.

# gpsd

Для користувачів, які вже запускають gpsd у своїй системі. Додайте джерело gpsd і введіть хост та порт екземпляра gpsd (за замовчуванням: localhost:2947). Nexus Telemetry підключається до протоколу JSON gpsd і підписується на оновлення позиції.

# Starlink gRPC

Початкове джерело GPS. Додайте джерело Starlink gRPC і введіть адресу тарілки (за замовчуванням: 192.168.100.1:9200). Nexus Telemetry зчитує GPS координати з локальної gRPC кінцевої точки тарілки.

Примітка: Для цього джерела потрібно, щоб перемикач спільного доступу GPS був увімкнений у застосунку Starlink. На новішому обладнанні (V4, Mini) цей перемикач вже видалено, а SpaceX повністю вимкне кінцеву точку 20 травня 2026 року. Якщо ви зараз використовуєте це джерело, налаштуйте альтернативу до цієї дати.

# Автоматичне резервне перемикання

Коли Auto-fallback увімкнено (перемикач у верхній частині розділу GPS Sources), Nexus Telemetry автоматично перемикається на наступне доступне джерело, якщо активне джерело перестає відповідати. Наприклад, якщо USB приймач від’єднано, застосунок без переривання переходить до наступного джерела у списку.

Порядок пріоритетів ви контролюєте, змінюючи послідовність джерел у списку. Nexus Telemetry працює зверху вниз, використовуючи перше доступне джерело. Ручне місцезнаходження завжди використовується як останній резервний варіант.

На панелі керування відображається, яке джерело зараз активне, а для джерел GPS, скільки супутників відстежується.

# Що стає доступним

Коли ваше місцезнаходження встановлено (через будь-яке джерело), ви побачите:

• Картка місцезнаходження: широта та довгота з міні-картою
• Картка погоди: місцеві погодні умови на основі вашої позиції
• Starlink Viewer (Pro): глобус, центрований на вашій тарілці з зіставленням супутників
• Запис сесій (Pro): відображення маршруту на записаних сесіях

# Усунення несправностей

Якщо дані про місцезнаходження не відображаються в Nexus Telemetry:

1. Перевірте статус джерела: відкрийте Settings → Geolocation і переконайтеся, що ваше джерело показує статус Connected. Якщо відображається помилка, перевірте налаштування.
2. Послідовні джерела: переконайтеся, що USB приймач підключено та обрано правильний послідовний порт і швидкість передачі. Спробуйте від’єднати та повторно підключити пристрій.
3. NMEA через TCP/UDP: перевірте, що служба пересилання працює на віддаленій машині та що хост і порт правильні. Переконайтеся, що брандмауер не блокує з’єднання.
4. gpsd: підтвердіть, що gpsd працює (systemctl status gpsd) і має GPS фіксацію. Перевірте хост і порт у налаштуваннях джерела.
5. Starlink gRPC: перевірте, що перемикач GPS увімкнено в застосунку Starlink (якщо він ще доступний на вашому обладнанні). Переконайтеся, що Nexus Telemetry може зв’язатися з тарілкою за адресою 192.168.100.1 (див. Проблеми з підключенням).
6. Ручне місцезнаходження: якщо джерело GPS недоступне, встановіть місцезнаходження вручну за допомогою карти в розділі Your Location у верхній частині сторінки налаштувань Geolocation.
7. Перезапустіть Nexus Telemetry: закрийте та знову відкрийте застосунок, щоб скинути всі з’єднання.

Технічні подробиці щодо роботи джерел GPS у Nexus Telemetry дивіться в нашій публікації в блозі про створення багатоджерельного GPS.