Skip to main content

Position Configuration

Position data from GPS is provided by either the radio or your paired phone. It is not required to use Meshtastic, but time calculations require at least one device on the mesh to have either a GPS, RTC, or internet connection for NTP.

The position config uses an admin message to send a Config.Position protobuf. The position config options are: GPS Mode, GPS Update Interval, Fixed Position, Smart Broadcast, Smart Broadcast Minimum Distance, Smart Broadcast Minimum Interval, Broadcast Interval, Position Packet Flags, and GPS RX/TX Pins.

Position Config Values

GPS Mode

Configures whether the GPS functionality is enabled, disabled, or not present on the node.

Acceptable values: Disabled, Enabled, and Not_Present.

Generally, depending on the device and its configuration, this value will default to either Enabled or Not Present.

GPS Update Interval

How often we should try to get GPS position (in seconds), or zero for the default of once every 2 minutes, or a very large value (maxint) to update only once at boot.

Fixed Position

Acceptable values: true or false

False by default

If set, this node is at a fixed position. The device will generate GPS updates at the regular GPS update interval, but use whatever the last lat/lon/alt it saved for the node. The lat/lon/alt can be set by an internal GPS or with the help of the mobile device's GPS.

Smart Broadcast

Acceptable values: true or false

True by default

Smart broadcast will send out your position at an increased frequency only if your location has changed enough for a position update to be useful.

Smart broadcast complements broadcast interval (doesn't override that setting) but will apply an algorithm to more frequently update your mesh network if you are in motion and then throttle it down when you are standing still. If you use this feature, it's best to leave broadcast interval at the default.

Smart broadcast will calculate an ideal position update interval based on the data rate of your selected channel configuration.

Smart Broadcast Minimum Distance

Default of 0 is 100 meters

The minimum distance in meters traveled (since the last send) before we can send a position to the mesh if smart broadcast is enabled.

Smart Broadcast Minimum Interval

Default of 0 is 30 seconds

The minimum number of seconds (since the last send) before we can send a position to the mesh if smart broadcast is enabled.

Broadcast Interval

Default of 0 is 15 minutes

If smart broadcast is off we should send our position this often.

The GPS updates will be sent out every broadcast interval, either with the actual GPS location or an empty location if no GPS fix was achieved.

Position Flags

Defines which options are sent in POSITION messages. Values are stored as a bit field of boolean configuration options (bitwise OR of PositionFlags).

UNSETRequired for compilation
ALTITUDEInclude an altitude value (if available)
ALTITUDE_MSLAltitude value is MSL
GEOIDAL_SEPARATIONInclude geoidal separation
DOPInclude the DOP value ; PDOP used by default, see below
HVDOPIf POS_DOP set, send separate HDOP / VDOP values instead of PDOP
SATINVIEWInclude number of "satellites in view"
SEQ_NOInclude a sequence number incremented per packet
TIMESTAMPInclude positional timestamp (from GPS solution)
HEADINGInclude positional heading (from GPS solution)
SPEEDInclude positional speed (from GPS solution)

GPIO RX/TX for GPS Module

If your device does not have a fixed GPS chip, you can define the GPIO pins for the RX and TX pins of a GPS module.

Position Config Client Availability



All position config values are available on iOS, iPadOS and macOS at Settings > Device Configuration > Position.