Proto commits in meshtastic/protobufs

These commits are when the Protocol Buffers files have changed: (only the last 100 relevant commits are shown)

2026-06-24

fix: buf-format module_config.proto reserved names to single line Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

The documentation is generated from this commit.

2026-06-20

Merge pull request #955 from NomDeTom/pr2-tmm-trim-bools Pr2 tmm trim bools

TMM: remove bool toggles and position_precision_bits from TrafficManagementConfig Removes 9 fields that are either simple default-to-off bool toggles or derivable from other config, in favour of the "non-zero implies enabled" convention: Removed (tags reserved so they cannot be reused): 1 enabled 2 position_dedup_enabled 3 position_precision_bits — precision is now driven by the channel's own position_precision ceiling, not a separate TMM field 5 nodeinfo_direct_response 7 rate_limit_enabled 10 drop_unknown_enabled 12 exhaust_hop_telemetry 13 exhaust_hop_position 14 router_preserve_hops Kept (require numeric values): 4 position_min_interval_secs 6 nodeinfo_direct_response_max_hops 8 rate_limit_window_secs 9 rate_limit_max_packets 11 unknown_packet_threshold None of these tags shipped in a stable release. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-17

feat: add field metadata option + cross-language registry generators Introduces a structured (meshtastic.field_metadata) custom field option and build-time generators that expose it as reflection-free static accessors in every consumer language: KMP/Wire (Wire SchemaHandler in packages/kmp/buildSrc) and C/Python/TypeScript/Rust/Swift (the tools/protoc-gen-fieldmeta plugin). The TS target is wired into buf.gen.yaml and re-exported from mod.ts as FieldMeta. Generalizes the #905 experiment: one extensible FieldMetadata message carried in a single FieldOptions extension, so adding an attribute is a schema-only change (scalar-only, enforced at generation time) with no new extension number and no generator changes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

chore: format powermon.proto with buf 1.71 buf-action runs the latest buf (now 1.71.0), which normalizes block-comment indentation differently than the version master was last formatted with. This applies that formatting so the PR format check passes; no schema change. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

fix: apply buf formatting in powermon proto comment block

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

2026-06-16

Add MESHNOLOGY_W12 hardware model Add the Meshnology W12 to the HardwareModel enum.

2026-06-13

Merge pull request #949 from meshtastic/master Master to develop backmerge

Merge pull request #948 from NomDeTom/pr1-nodedb-warmstore Move SNR in nodeDB to a Sint based figure, saving 2 bytes

Add MESHNOLOGY_W10 hardware model Add the Meshnology W10 to the HardwareModel enum. Generated by Meshtastic Readyline.

2026-06-12

Add W10 hardware model Add the Meshnology W10 to the HardwareModel enum. Generated by Meshtastic Readyline.

Merge pull request #941 from vidplace7/ham-longname Add "Long_Name" to HamParameters

2026-06-11

Fix long_name field size to 40 bytes for compatibility with legacy data

Add "Long_Name" to HamParameters Adds Long_Name HamParameters. This will be appended to the call_sign in firmware with a // delimter (following Amateur Radio best practices). Since the max length for a callsign is 8 and // uses two characters. The limit for HamParameter.long_name is set to 15 (10 less than traditional LongName). E.g. call_sign = N0CALL long_name = Attic Heltec v3 becomes N0CALL//Attic Heltec v3

2026-06-10

Add Heltec Mesh Tower V2 board.

2026-06-08

It would be a Sint do that

Add TRANSPORT_UNICAST_UDP to mesh.proto

2026-06-04

-_-

fix comments

add FULLY_CHARGED, NOT_PRESENT, NOT_PRESENT

2026-06-02

Add ITU Region 2 Amateur Radio 1.25m band to Config message

Add TINY_FAST and TINY_SLOW presets for Amateur Radio compliance (#934)

fix complains about UNKNOWN

add BatteryStatus enum

add new hardware models L2, P4

2026-05-30

fix: revert unrelated MeshLink description edit

fix: align Station G3 comment formatting in mesh proto

2026-05-29

Fix truncated mesh.proto: restore full file, add LockdownAuth.disable and LockdownStatus.State.DISABLED

Preserve mesh.proto content and keep intended lockdown changes

Add lockdown disable to LockdownAuth and DISABLED to LockdownStatus Supports moving MESHTASTIC_LOCKDOWN from a compile-time build flag to a runtime, client-toggleable setting. - AdminMessage.LockdownAuth.disable (field 6): with a valid passphrase, reverts the device out of lockdown — decrypt all stored config back to plaintext, drop the wrapped DEK / unlock token / monotonic counter / backoff files, reboot into normal mode. APPROTECT is explicitly NOT reversed (the debug-port lockout is permanent on silicon where it is effective; only a full chip erase clears it). - FromRadio.LockdownStatus.State.DISABLED (value 5): reported by a lockdown-capable device that is not currently in lockdown, so a client can render its 'lockdown mode' toggle as OFF. Distinct from NEEDS_PROVISION, which is only used mid-enable.

Merge remote-tracking branch 'origin/master' into develop

Refactor DrawnShape vertices to use packed sint32 deltas and update TAKPacketV2 payload handling

2026-05-28

TAK tweaks

2026-05-27

Merge branch 'master' into develop

Add TAKTALK message and room data structures to atak.proto

2026-05-26

Update ham regions, split by ITU Stop combining ITU 2 and 3. They will need VERY different default slotOverrides (default freq). In effect, this means each ham band we support will need 3 "regions", ITU1, ITU2, ITU3. This will allow us to better support hams around the world without stirring anger.

Merge branch 'develop' into master-backmerge

2026-05-25

master: Split ITU regions for 2M ham bands

2026-05-23

Merge pull request #920 from vidplace7/ham-70cm Add ITU Region 1 and Region 2/3 Amateur Radio 70cm regions

2026-05-22

Add ITU Region 1 and Region 2/3 Amateur Radio 70cm band identifiers to config.proto

2026-05-19

Merge remote-tracking branch 'origin/master' into develop

2026-05-18

Add T_ECHO_CARD identifier to mesh.proto (#919)

Add rotated SH1107 display type (#913)

Deprecate `ModuleConfig.MQTTConfig.json_enabled` after MQTT JSON removal (#890)

Add lilygo T-Impulse-Plus https://github.com/Xinyuan-LilyGO/T-Impulse-Plus

2026-05-15

Refine session-expiry behavior doc: decrement in place, reboot only on exhaustion The firmware was updated to decrement the on-flash boot count at each session expiry without rebooting (while budget remains), and only hard-lock + reboot when the boot count reaches zero. Mesh routing continues across session boundaries; per-connection auth is revoked and the screen lock re-engages at each roll so clients must re-auth to see content. The exposure ceiling is unchanged — the boot count still ticks down monotonically once per session boundary. Companion firmware change: meshtastic/firmware PR #10349 (commit d2b47e4ca).

Fix off-by-one in exposure-ceiling formula The initial passphrase-unlocked session counts toward total exposure too, since boots_remaining is the count of *subsequent* token-driven auto-unlocks (not total sessions). Ceiling is (resolved_boot_count + 1) * max_session_seconds.

Clarify exposure-ceiling formula re: boots_remaining=0 sentinel Address review feedback: the formula 'boots_remaining * max_session_seconds' is ambiguous because boots_remaining=0 in the request means 'use firmware default' (TOKEN_DEFAULT_BOOTS), not literally zero boots. A client that sends only max_session_seconds and leaves boots_remaining=0 cannot compute the ceiling from the raw request fields. Document that the formula uses the resolved (post-default) boot count, and call out the sentinel explicitly.

Add LockdownAuth.max_session_seconds for uptime-bounded sessions Per-boot cap on how long a single auto-unlocked session can hold the device's encrypted storage open, in seconds. 0 = unlimited (current behavior, suitable for unattended infrastructure nodes). When non-zero, the firmware arms an uptime timer at unlock. On expiry the device revokes per-connection auth, re-engages screen redaction, and reboots without deleting the token; next boot auto-unlocks via the boot-count TTL (decrementing boots_remaining) and arms a fresh session. Total exposure ceiling = boots_remaining * max_session_seconds. Uses CPU uptime (millis), not wall-clock time, so the cap is immune to GPS spoofing, RTC backup-battery removal, and Faraday cage isolation — none of those move the uptime counter. The only way to reset the session clock is a reboot, which costs a boot from the HMAC-bound on-flash counter. Companion firmware change: meshtastic/firmware PR #10349.

2026-05-13

Add initial protobufs for XEdDSA (#753) * Add initial protobufs for XEdDSA * Add nodeinfo bool has_xeddsa_signed * Remove optional tag from xeddsa sig field * Add missed comment marker * Apply buf format to mesh.proto Agent-Logs-Url: https://github.com/meshtastic/protobufs/sessions/f6082d6b-c47b-42a3-bda3-e269d0b63226 Co-authored-by: thebentern <9000580+thebentern@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: thebentern <9000580+thebentern@users.noreply.github.com>

2026-05-12

Add precision_bits field to PositionLite message for node precision indication

2026-05-11

Merge branch 'master' into develop

Merge pull request #911 from niccellular/feature/lockdown-signaling Add LockdownAuth and LockdownStatus messages for hardened firmware builds

Add HardwareModel enum for B&Q Consulting Station G3

Merge branch 'master' into develop

Fix formatting in mesh.proto and telemetry.proto by removing extra blank lines

Merge pull request #908 from Quency-D/heltec-mesh-node-t1 Add heltec-mesh-node-t1 product

Buf fmt

2026-05-07

Add LockdownAuth and LockdownStatus messages for hardened firmware builds Companion proto changes for meshtastic/firmware#10349 (MESHTASTIC_LOCKDOWN hardened build option). Replaces a previous "no schema change" hack that repurposed SecurityConfig.private_key as the passphrase byte transport. AdminMessage.lockdown_auth (= 104): LockdownAuth carries a passphrase plus optional boots/until-epoch overrides, and a lock_now sentinel. Used for first-time provisioning, unlock on subsequent reboots, re-verification on already-unlocked devices, and Lock Now. Firmware decides between provision and unlock based on its own state. FromRadio.lockdown_status (= 18): LockdownStatus reports lockdown state to the client (NEEDS_PROVISION / LOCKED / UNLOCKED / UNLOCK_FAILED) plus structured fields for lock reason, token TTL, and unlock-failure backoff. Sent post-config and in response to each LockdownAuth command. Replaces the earlier scheme of encoding state as magic-string prefixes inside ClientNotification. Both messages are documented inline. No existing fields are altered.

Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Apply buf format to deviceonly.proto and deviceonly_legacy.proto Agent-Logs-Url: https://github.com/meshtastic/protobufs/sessions/df6c83e6-b057-425c-8533-f83df8ed0c75 Co-authored-by: thebentern <9000580+thebentern@users.noreply.github.com>

Add NodeEnvironmentEntry message

2.8: Refactor NodeInfoLite structure and add legacy support for migration

change ICM-42670-P to ICM-42607-P

add MMC5983MA and ICM-42670-P sensors

Add heltec-mesh-node-t1 product

2026-04-30

refactor: flatten config_field to scalar bool extension Replace the ConfigFieldMetadata message wrapper with a direct scalar bool extension on FieldOptions. This allows Wire 6's native emitAppliedOptions to generate @DiyOnlyOption annotations without a custom SchemaHandler, and simplifies access for all downstream clients (Swift, Python, Go). Usage: [(meshtastic.diy_only) = true] instead of [(meshtastic.config_field).diy_only = true]

Experminental PR for adding metadata to protobufs

More serialHal protos (#904)

2026-04-28

Add SerialHal proto definitions Define SerialHalCommand and SerialHalResponse messages with enums for command types and response results.

2026-04-24

Merge pull request #898 from Quency-D/heltec-v4-r8 add heltec-v4-r8 board

2026-04-22

New Regions (EU866, EU_NARROW) + New Presets (Lite, Narrow) (#824) * new new_presets * Update comments for frequency bands Per @fifieldt * remove hamfast * Clean up config.proto by removing extra newline Removed unnecessary blank spaces before EU 866MHz comment. * Removed US 433MHz Amateur Use band removing ham settings for now. * Update EU 866MHz band references and descriptions in config.proto * Whitespace * format again --------- Co-authored-by: Thomas Göttgens <tgoettgens@gmail.com>

add heltec-v4-r8 board

2026-04-21

Add ITU Region 1 and 2/3 Amateur Radio bands (#897)

2026-04-17

Run buf format on atak proto Agent-Logs-Url: https://github.com/meshtastic/protobufs/sessions/059c2e02-63e3-467d-b032-dc5c15883261 Co-authored-by: thebentern <9000580+thebentern@users.noreply.github.com>

Update atak.proto Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update atak.proto Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

2026-04-16

Add Environment and SensorFov annotations to TAKPacketV2 Two new top-level optional fields at tags 25 and 26 that attach to any payload_variant. Environment carries weather readings from <environment> CoT detail elements (temperature, wind direction, wind speed). SensorFov carries the 8 geometry attributes of ATAK-CIV's <sensor> element (type, azimuth, range, horizontal and vertical FOV, elevation, roll, model), dropping the 9 display-only attributes (fovAlpha/RGB, strokeColor/Weight, hideFov, fovLabels, displayMagneticReference, rangeLines) that are receiver-side render hints. Units are chosen for compact varint encoding and parity with existing fields: temperature in deci-degrees Celsius (sint32), wind speed in cm/s to match TAKPacketV2.speed, all angles as whole degrees. Tags 27-29 reserved for future annotations before the payload_variant oneof resumes at tag 30.

Add v2.x medline extensions and ZMistEntry message to CasevacReport

Rename Environment -> TAKEnvironment to avoid SwiftUI collision The bare `Environment` message name clashes with SwiftUI's `@Environment` property wrapper, which is used by every SwiftUI view in an iOS consumer app. Importing the generated proto module (e.g. `MeshtasticProtobufs`) made `Environment` ambiguous in all 78 files of Meshtastic-Apple that reference `@Environment(\.scenePhase)` or similar, breaking the build. Field name `environment` on TAKPacketV2 stays unchanged — only the message type is renamed. Wire format is unaffected (proto3 encodes by tag number, not type name), but all generated code and source-level references must be regenerated. The `TAK` prefix matches the convention used by the outer TAKPacketV2 wrapper and is unambiguous across Swift (no SwiftUI/WeatherKit clash), Kotlin, Python, TypeScript, and C# targets.

2026-04-14

Add two more RemoteShell fields

add THINKNODE device IDs (#893)

Multiple one wire channels (#886) * Add DS248X bridge * One wire temperature for multiple channels

Remote Shell Protobufs (#892) * Add initial dmshell * Remove unused code * Internally use RemoteShell * Formatting fix * Clarify comment for REMOTE_SHELL_APP Co-authored-by: Thomas Göttgens <tgoettgens@gmail.com>

Takv2 geometry and other structures (#891)

2026-04-10

Add DS248X bridge (#885)

2026-04-08

Busted

Add additional CotType enums for aircraft, ground units, and other data messages

2026-04-07

Add ATAK Plugin V2 protobufs and expand CoT enums

2026-04-03

Add Hardware Model for T1000-E-Pro

2026-04-02

Add NodeInfoBatch message for efficient bulk transfer in FromRadio

2026-03-19

Correct the enumeration value.

add heltec-mesh-node-t096 board

2026-03-17

Merge pull request #873 from fablabbcn/enhancement/sht-sensor-consolidation Enhancement/sht sensor consolidation

Add GroupAlarm app portnum

2026-03-08

Add admin command for SHT accuracy setting

Add TODO - REMOVE on SHT31, SHT4X, SHT21 and SHTC3

2026-03-07

Add SHTXX TelemetrySensorType

fix formatting