Skip to content

Add LoRa region preset mapping to support region-specific modem presets#951

Merged
thebentern merged 2 commits into
developfrom
lora-region-preset-map
Jun 17, 2026
Merged

Add LoRa region preset mapping to support region-specific modem presets#951
thebentern merged 2 commits into
developfrom
lora-region-preset-map

Conversation

@thebentern

Copy link
Copy Markdown
Contributor

This pull request introduces a new system for communicating which LoRa modem presets are legal in each region from the firmware to clients, allowing client UIs to prevent users from selecting invalid region and preset combinations. The changes add new protobuf messages and options to efficiently encode this mapping, ensuring the data fits within protocol size limits.

LoRa region and preset compatibility mapping:

  • Added a new LoRaRegionPresetMap message to FromRadio, sent during the configuration handshake, which describes the valid modem presets for each LoRa region. This enables clients to enforce legal region+preset selections and warn users about licensed-only regions.
  • Introduced supporting messages: LoRaPresetGroup (describes a set of legal presets, the default preset, and licensing status for regions), and LoRaRegionPresets (associates a region with a preset group).
  • Documented the structure and rationale for these new messages, including how grouping regions by shared preset lists keeps the mapping compact and fits protocol constraints.

Protocol size and option constraints:

  • Updated mesh.options to define max_count and int_size for the new fields, ensuring the region-preset map remains within the protocol's maximum message size.

@github-actions

github-actions Bot commented Jun 17, 2026

Copy link
Copy Markdown

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

BuildFormatLintBreakingUpdated (UTC)
✅ passed✅ passed✅ passed✅ passedJun 17, 2026, 2:56 PM

@thebentern thebentern merged commit 1acb7ba into develop Jun 17, 2026
3 checks passed
@thebentern thebentern deleted the lora-region-preset-map branch June 17, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants