Positionsdaten von GPS können entweder von der Funkhardware oder von Ihrem gekoppelten Mobiltelefon bereitgestellt werden. Obwohl Meshtastic nicht zwingend GPS erfordert, erfordert eine genaue Zeitsynchronisation über ein LoRa-Mesh-Netzwerk, dass mindestens ein Gerät im Mesh entweder über ein GPS-Modul, eine Echtzeituhr (RTC) oder eine Internetverbindung für NTP-Synchronisation verfügt.
Das Positionskonfigurationssystem verwendet eine administrative Nachricht, um ein Config.Position protobuf zu senden. Die verfügbaren Konfigurationsoptionen umfassen: GPS-Modus, GPS-Aktualisierungsintervall, Feste Position, Intelligenter Broadcast (Smart Broadcast), Smart Broadcast Mindestentfernung, Smart Broadcast Mindestintervall, Broadcast-Intervall, Positions-Paket-Flags und GPS RX/TX/EN Pins.
Positionskonfigurationswerte
- GPS-Modus: Bestimmt, ob die GPS-Funktionalität auf dem Knoten aktiviert, deaktiviert oder nicht vorhanden ist. Akzeptable Werte sind DISABLED, ENABLED und NOT_PRESENT. Die Standardwerte hängen von der Gerätehardware und der Konfiguration ab.
- GPS-Aktualisierungsintervall: Definiert, wie häufig das Gerät versucht, eine GPS-Position zu erfassen. Der Standardwert ist einmal alle 2 Minuten. Wird das Intervall auf Null gesetzt, wird der Standardwert verwendet, während ein sehr großer Wert nur einmal beim Booten aktualisiert.
- Feste Position: Akzeptable Werte sind true oder false. Wenn auf "true" gesetzt, wird der Knoten als stationär behandelt, wobei die zuletzt gespeicherten Werte für Breitengrad, Längengrad und Höhe verwendet werden. Diese Werte können durch ein internes GPS oder durch Unterstützung eines gekoppelten Mobilgeräts festgelegt werden.
- Intelligenter Broadcast (Smart Broadcast): Standard ist true. Diese Funktion erhöht die Broadcast-Frequenz nur, wenn eine Bewegung erkannt wird, und optimiert so die Effizienz des Mesh-Netzwerks. Sie ergänzt das Broadcast-Intervall und wendet einen Algorithmus an, um das LoRa-Netzwerk während der Bewegung häufiger zu aktualisieren und die Aktualisierungen zu reduzieren, wenn es stationär ist.
- Smart Broadcast Mindestentfernung: Standard ist 100 Meter. Definiert die Mindestentfernung, die zurückgelegt werden muss, bevor eine neue Positionsaktualisierung gesendet wird, wenn Smart Broadcast aktiviert ist.
- Smart Broadcast Mindestintervall: Standard ist 30 Sekunden. Definiert die Mindestzeit zwischen Aktualisierungen, wenn Smart Broadcast aktiviert ist.
- Broadcast-Intervall: Standard ist 15 Minuten. Wenn Smart Broadcast deaktiviert ist, werden Aktualisierungen in diesem festen Intervall gesendet. GPS-Aktualisierungen werden bei jedem Broadcast-Intervall gesendet, entweder mit dem tatsächlichen GPS-Standort oder einem leeren Standort, wenn kein GPS-Fix erreicht wurde.
- Positions-Flags: Bestimmt, welche Datenfelder in POSITION-Nachrichten enthalten sind, wie Höhe, Richtung, Geschwindigkeit oder Zeitstempel. Diese Werte werden als Bitfeld von booleschen Konfigurationsoptionen gespeichert.
| Wert | Beschreibung |
| UNSET | Erforderlich für die Kompilierung |
| ALTITUDE | Einen Höhenwert einschließen (falls verfügbar) |
| ALTITUDE_MSL | Höhenwert ist MSL |
| GEOIDAL_SEPARATION | Geoidale Trennung einschließen |
| DOP | Den DOP-Wert einschließen; PDOP wird standardmäßig verwendet, siehe unten |
| HVDOP | Wenn POS_DOP gesetzt ist, senden Sie separate HDOP / VDOP-Werte anstelle von PDOP |
| SATINVIEW | Anzahl der "Satelliten in Sicht" einschließen |
| SEQ_NO | Eine Sequenznummer einschließen, die pro Paket inkrementiert wird |
| TIMESTAMP | Positionszeitstempel einschließen (aus GPS-Lösung) |
| HEADING | Positionsrichtung einschließen (aus GPS-Lösung) |
| SPEED | Positionsgeschwindigkeit einschließen (aus GPS-Lösung) |
-
GPIO RX/TX/EN für GPS-Modul
Wenn Ihr Gerät keinen festen GPS-Chip hat, können Sie die GPIO-Pins für die RX-, TX- und EN-Pins eines GPS-Moduls definieren.
Verfügbarkeit von Positionskonfigurations-Clients
Android
Positionskonfigurationsoptionen sind für Android verfügbar.
Um darauf zuzugreifen, öffnen Sie die Meshtastic App und navigieren Sie zu: Vertikale Ellipse (3 Punkte oben rechts) > Radio Configuration > Position.
Apple
Alle Positionskonfigurationswerte sind unter iOS, iPadOS und macOS unter Settings > Device Configuration > Position verfügbar.
CLI
Alle Positionskonfigurationsbefehle sind in der Python CLI verfügbar. Beispielbefehle finden Sie unten:
| Einstellung | Akzeptable Werte | Standard |
| position.gps_mode | ENABLED, DISABLED, NOT_PRESENT | ENABLED oder NOT_PRESENT |
| position.gps_update_interval | Ganzzahl (Sekunden) | Standard 0 ist 2 Minuten |
| position.fixed_position | true, false | FALSE |
| position.position_broadcast_smart_enabled | true, false | TRUE |
| position.broadcast_smart_minimum_distance | Ganzzahl (Meter) | Standard von 0 ist 100 Meter |
| position.broadcast_smart_minimum_interval_secs | Ganzzahl (Sekunden) | Standard von 0 ist 15 Minuten |
| position.position_broadcast_secs | Ganzzahl (Sekunden) | Standard von 0 ist 15 Minuten |
| position.flags | UNSET, ALTITUDE, ALTITUDE_MSL, GEOIDAL_SEPARATION, DOP, HVDOP, PDOP, SATINVIEW, SEQ_NO, TIMESTAMP, HEADING, SPEED | UNSET |
| position.rx_gpio | Ganzzahl (0-39) | UNSET |
| position.tx_gpio | Ganzzahl (0-34) | UNSET |
-
GPS-Aktualisierungsintervall festlegen (Standard von 0 ist 2 Minuten)
| meshtastic --set position.gps_update_interval 0 meshtastic --set position.gps_update_interval 45 |
-
Feste Position festlegen - Aktueller Standort
| meshtastic --set position.fixed_position true |
HINWEIS 1: Das Gerät erfasst weiterhin GPS-Koordinaten entsprechend dem gps_update_interval, verwendet aber die zuletzt gespeicherten Koordinaten als seinen festen Punkt.
-
Feste Position festlegen und aktivieren - Benutzerdefiniert
| meshtastic --setlat 37.8651 --setlon -119.5383 |
-
Feste Position entfernen und aufheben
| meshtastic --remove-position |
-
Intelligenten Positions-Broadcast aktivieren / deaktivieren (Standardmäßig aktiviert)
| meshtastic --set position.position_broadcast_smart_enabled true meshtastic --set position.position_broadcast_smart_enabled false |
-
Positions-Broadcast-Intervall festlegen (Standard von 0 ist 15 Minuten)
| meshtastic --set position.broadcast_secs 0 meshtastic --set position.broadcast_secs 60 |
HINWEIS 2: Es kann einige Zeit dauern, bis die Änderung wirksam wird. Der GPS-Standort wird entsprechend dem für gps_update_interval angegebenen Wert aktualisiert, und das Mesh wird über die neue Position in Bezug auf den Wert position_broadcast_secs benachrichtigt.
-
Positions-Flags festlegen / aufheben
| meshtastic --pos-fields ALTITUDE ALTITUDE_MSL meshtastic --pos-fields UNSET |
HINWEIS 3: Da das Gerät nach jedem über die CLI gesendeten Befehl neu startet, wird empfohlen, Befehle aneinanderzureihen, wenn mehrere Werte in einem Konfigurationsabschnitt festgelegt werden. Dies ist besonders wichtig für Positions-Werte, um sicherzustellen, dass sie gleichzeitig gesetzt werden und nicht von nachfolgenden Befehlen überschrieben werden. Zum Beispiel:
| meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383 |
Web
Alle Positionskonfigurationsoptionen sind in der Web-Benutzeroberfläche verfügbar.
