Protobuf definitions for the Meshtastic project
Find a file
Tom Fifield 8f2a53edf3
Add GPS Profile, deprecate Position Flags
This patch makes two major changes to address the current complexity of GPS Configuration.

GpsProfile, a new enum in PositionConfig we will use to configure a pre-tuned selection of GPS settings. The aim is to replace the current 5 configuration options with a single user-friendly label that is tailored to real-world Meshtastic use cases.

Based on a users selection of pedestrian, vehicle, or fixed position, we will apply different settings to GPS Update Interval, Position Broadcast Interval, Smart Broadcast Min Interval, Smart Broadcast Min Distance, and Position Flags in firmware. This should allow the apps to drastically simplify the position configuration shown to users.

The profile will also allow us to support new features in firmware to improve the accuracy of our position information. For example,  taking advantage of advanced features in GPS hardware specific to each case. We should also be able to discard some erroneous positions based on physically impossible movement.

ENUM 0 corresponds to no profile, which should mean an easier transition, and also support the 'manual' use case for people like cynfab/gpsfan, and balloons/aircraft/boats.

More information about the selections anticipated for each use case is available in this [google sheet](https://docs.google.com/spreadsheets/d/1-f9z5zx2VCYqE6ivYXm-XqtLeVZSGMKpC3G3wma6-vw/edit?gid=633840990#gid=633840990):

This patch deprecates PositionFlags, which will now be selected in firmware based on the GPS Profile.

PositionFlags has long been seen as a complicated and confusing burden in the apps. We determined that very few users use them, with the majority happy with the default set, and some of the 'advanced' flags don't even work.
2025-08-01 10:51:11 +10:00
.github Update bufbuild GitHub Actions 2025-07-12 19:46:12 -04:00
.vscode cleanup & update actions 2024-03-30 13:31:28 +10:00
meshtastic Add GPS Profile, deprecate Position Flags 2025-08-01 10:51:11 +10:00
.gitattributes clamp CR/LF and trunk fmt the ci files 2023-01-30 13:34:14 +01:00
.gitignore Add dsstore 2025-04-29 06:15:31 -05:00
buf.yaml Make node_db_lite a vector (#470) 2024-03-21 10:42:19 -05:00
LICENSE Initial commit 2020-03-02 09:44:55 -08:00
nanopb.proto Add go_package path for nanopb.proto 2025-03-25 09:32:11 -07:00
README.md Update README.md 2025-07-07 19:42:40 -05:00
renovate.json Update bufbuild GitHub Actions 2025-07-12 19:46:12 -04:00

Meshtastic Protobuf Definitions

CI CLA assistant Fiscal Contributors Vercel

Overview

The Protobuf message definitions for the Meshtastic project (used by apps and the device firmware).

Documentation/API Reference

Stats

Alt