Przewodnik Meshtastic – Ustawienia Pozycjonowania i Lokalizacji

Dane pozycji z GPS są dostarczane przez radio lub sparowany telefon. Chociaż nie jest wymagane używanie Meshtastic, obliczenia czasu potrzebują co najmniej jednego urządzenia w sieci mesh z GPS, RTC lub połączeniem internetowym dla NTP.

Konfiguracja pozycji wykorzystuje wiadomość administratora do wysłania Config.Position protobuf. Opcje konfiguracji pozycji obejmują: Tryb GPS, Interwał aktualizacji GPS, Stała pozycja, Smart Broadcast, Minimalna odległość Smart Broadcast, Minimalny interwał Smart Broadcast, Interwał nadawania, Flagi pakietu pozycji oraz piny GPS RX/TX/EN.

Wartości konfiguracji pozycji

Tryb GPS: Konfiguruje, czy funkcjonalność GPS jest włączona, wyłączona lub nieobecna na węźle. Akceptowalne wartości: DISABLED, ENABLED oraz NOT_PRESENT. Zazwyczaj ta wartość domyślnie będzie ustawiona na ENABLED lub NOT_PRESENT, w zależności od urządzenia i jego konfiguracji.
Interwał aktualizacji GPS: Określa, jak często powinniśmy próbować uzyskać pozycję GPS (w sekundach), lub ustaw na zero, aby użyć domyślnej wartości raz na 2 minuty, lub bardzo dużą wartość (maxint), aby aktualizować tylko raz przy uruchomieniu.
Stała pozycja: Akceptowalne wartości: true lub false (domyślnie false). Jeśli ustawione na true, ten węzeł znajduje się w stałej pozycji. Urządzenie będzie generować aktualizacje GPS w regularnych interwałach aktualizacji GPS, ale będzie używać ostatnio zapisanych wartości lat/lon/alt dla węzła. Wartości lat/lon/alt mogą być ustawione przez wewnętrzny GPS lub z pomocą GPS urządzenia mobilnego.
Smart Broadcast: Akceptowalne wartości: true lub false (domyślnie true). Smart broadcast będzie wysyłać Twoją pozycję z większą częstotliwością tylko wtedy, gdy Twoja lokalizacja zmieniła się na tyle, że aktualizacja pozycji jest użyteczna. Uzupełnia to interwał nadawania (nie zastępuje tej ustawienia) i stosuje algorytm do częstszej aktualizacji sieci mesh podczas ruchu, a następnie zmniejsza częstotliwość, gdy jesteś w miejscu. Jeśli korzystasz z tej funkcji, najlepiej pozostawić interwał nadawania na domyślnym poziomie. Smart broadcast obliczy idealny interwał aktualizacji pozycji na podstawie szybkości transmisji wybranej konfiguracji kanału.
Minimalna odległość Smart Broadcast: Domyślna wartość 0 oznacza 100 metrów. Ten parametr określa minimalną odległość w metrach pokonaną (od ostatniego wysłania), po której pozycja może zostać wysłana do sieci mesh, jeśli smart broadcast jest włączony.
Minimalny interwał Smart Broadcast: Domyślna wartość 0 oznacza 30 sekund. Ten parametr definiuje minimalną liczbę sekund (od ostatniego wysłania), po których pozycja może zostać wysłana do sieci mesh, jeśli smart broadcast jest włączony.
Interwał nadawania: Domyślna wartość 0 oznacza 15 minut. Jeśli smart broadcast jest wyłączony, pozycja powinna być wysyłana z taką częstotliwością. Aktualizacje GPS będą wysyłane przy każdym interwale nadawania, albo z aktualną lokalizacją GPS, albo z pustą lokalizacją, jeśli nie uzyskano fixu GPS.
Flagi pozycji: Definiuje, które opcje są uwzględnione w komunikatach POSITION. Wartości są przechowywane jako pole bitowe opcji konfiguracyjnych typu boolean (bitowe OR z PositionFlags).

Wartość	Opis
WYŁĄCZ	Wymagane do kompilacji
ALTITUDE	Uwzględnij wartość wysokości (jeśli dostępna)
ALTITUDE_MSL	Wartość wysokości jest względem MSL
GEOIDAL_SEPARATION	Uwzględnij separację geoidalną
DOP	Uwzględnij wartość DOP; domyślnie używany PDOP, patrz poniżej
HVDOP	Jeśli ustawiono POS_DOP, wyślij oddzielne wartości HDOP / VDOP zamiast PDOP
SATWZASIĘGU	Uwzględnij liczbę "satelitów w zasięgu"
NUMER_SEKWENCJI	Uwzględnij numer sekwencji zwiększany dla każdego pakietu
ZNACZNIK CZASU	Uwzględnij znacznik czasu pozycji (z rozwiązania GPS)
NAGŁÓWEK	Uwzględnij kierunek pozycji (z rozwiązania GPS)
PRĘDKOŚĆ	Uwzględnij prędkość pozycji (z rozwiązania GPS)

GPIO RX/TX/EN dla Moduł GPS

Jeśli Twoje urządzenie nie ma stałego układu GPS, możesz zdefiniować piny GPIO dla pinów RX, TX i EN modułu GPS.

Dostępność klienta konfiguracji pozycji

Android

Opcje konfiguracji pozycji są dostępne dla Androida.

Aby uzyskać do nich dostęp, otwórz Aplikację Meshtastic i przejdź do: Pionowa elipsa (3 kropki w prawym górnym rogu) > Konfiguracja radia > Pozycja.

Jabłko

Wszystkie wartości konfiguracji pozycji są dostępne na iOS, iPadOS i macOS w Ustawienia > Konfiguracja urządzenia > Pozycja.

CLI

Wszystkie polecenia konfiguracji pozycji są dostępne w Python CLI. Przykładowe polecenia podano poniżej:

Ustawienie	Akceptowalne wartości	Domyślny
position.gps_mode	WŁĄCZONE, WYŁĄCZONE, BRAK	WŁĄCZONE lub BRAK
position.gps_update_interval	liczba całkowita (sekundy)	Domyślnie 0 to 2 minuty
position.fixed_position	prawda, fałsz	FAŁSZ
position.position_broadcast_smart_enabled	prawda, fałsz	PRAWDA
position.broadcast_smart_minimum_distance	liczba całkowita (metry)	Domyślnie 0 to 100 metrów
position.broadcast_smart_minimum_interval_secs	liczba całkowita (sekundy)	Domyślnie 0 to 15 minut
position.position_broadcast_secs	liczba całkowita (sekundy)	Domyślnie 0 to 15 minut
position.flags	WYŁĄCZ, WYSOKOŚĆ, WYSOKOŚĆ_NPM, SEPARACJA_GEODEZYJNA, DOP, HVDOP, PDOP, SATINVIEW, SEQ_NO, TIMESTAMP, KIERUNEK, PRĘDKOŚĆ	WYŁĄCZ
position.rx_gpio	liczba całkowita (0-39)	WYŁĄCZ
position.tx_gpio	liczba całkowita (0-34)	WYŁĄCZ

Ustaw interwał aktualizacji GPS (domyślnie 0 to 2 minuty)

meshtastic --set position.gps_update_interval 0
meshtastic --set position.gps_update_interval 45

Ustaw stałą pozycję - bieżąca lokalizacja

meshtastic --set position.fixed_position true

UWAGA1: Urządzenie będzie nadal pobierać współrzędne GPS zgodnie z gps_update_interval, ale jako stały punkt będzie używać ostatnio zapisanych współrzędnych.

Ustaw i włącz stałą pozycję - zdefiniowaną przez użytkownika

meshtastic --setlat 37.8651 --setlon -119.5383

Usuń i wyłącz stałą pozycję

meshtastic --remove-position

Włącz / Wyłącz inteligentne nadawanie pozycji (domyślnie włączone)

meshtastic --set position.position_broadcast_smart_enabled true
meshtastic --set position.position_broadcast_smart_enabled false

Ustaw interwał nadawania pozycji (domyślnie 0 to 15 minut)

meshtastic --set position.broadcast_secs 0
meshtastic --set position.broadcast_secs 60

UWAGA2: Może minąć trochę czasu, zanim zmiana zacznie obowiązywać. Lokalizacja GPS jest aktualizowana zgodnie z wartością określoną dla gps_update_interval, a sieć mesh zostanie powiadomiona o nowej pozycji zgodnie z wartością position_broadcast_secs.

Ustaw / Usuń flagi pozycji

meshtastic --pos-fields ALTITUDE ALTITUDE_MSL
meshtastic --pos-fields UNSET

UWAGA3: Ponieważ urządzenie uruchomi się ponownie po wysłaniu każdego polecenia przez CLI, zaleca się łączenie poleceń w jedno podczas ustawiania wielu wartości w sekcji konfiguracji. Jest to szczególnie ważne dla wartości position, aby zapewnić ich jednoczesne ustawienie i uniknąć nadpisania przez kolejne polecenia. Na przykład:

meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383