Skip to main content

Position Configuration

The position config options are: GPS Enabled, GPS Update Interval, GPS Attempt Time, Fixed Position, Smart Broadcast, Broadcast Interval and Position Packet Flags. Position config uses an admin message sending a Config.Position protobuf.

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

Position Config Valuesโ€‹

GPS Disabledโ€‹

Acceptable values: true or false

Defaults to false. Should the device GPS be disabled for this node?

GPS Update Intervalโ€‹

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

GPS Attempt Timeโ€‹

How long should we try to get our position during each GPS update interval attempt? (in seconds) Or if zero, use the default of 30 seconds.

Fixed Positionโ€‹

Acceptable values: true or false

Off 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

On 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.

Broadcast Intervalโ€‹

Default of 0 is 15 minutes

If smart broadcast is of we should send our position this often (but only if it has changed significantly)

The GPS updates will be sent out every Broadcast Interval, with either the actual GPS location, or an empty location if no GPS fix was achieved. This defaults to broadcast every 15 minutes.

Position Flagsโ€‹

Bit field of boolean configuration options for POSITION messages (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 > Radio Configuration > Position.


Altering/disabling the GPS functionality does not mean that you will be unable to be found. Via triangulation of your radio, location may be given up to someone if they are determined enough.