protobufs icon indicating copy to clipboard operation
protobufs copied to clipboard

Add GPS Profile, deprecate Position Flags

Open fifieldt opened this issue 4 months ago • 1 comments

This patch makes two major changes to address the current complexity of GPS Configuration.

GPS Profile

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

PositionFlags

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.

Checklist before merging

  • [x] All top level messages commented
  • [x] All enum members have unique descriptions

fifieldt avatar Aug 01 '25 00:08 fifieldt

The latest Buf updates on your PR. Results from workflow pull-request / build (pull_request).

BuildFormatLintBreakingUpdated (UTC)
✅ passed✅ passed✅ passed❌ failed (28)Oct 8, 2025, 10:40 PM

github-actions[bot] avatar Aug 01 '25 00:08 github-actions[bot]