Skip to content

docs(update): Clarify that the Nan/INT32_MAX values should be used on new params - #786

Merged
hamishwillee merged 3 commits into
mavlink:masterfrom
hamishwillee:reserved_params_sentinel
Oct 1, 2026
Merged

hamishwillee merged 3 commits into
mavlink:masterfrom
hamishwillee:reserved_params_sentinel

Conversation

@hamishwillee

Copy link
Copy Markdown
Collaborator

This updates the dev guide to make it clear that

  • All unused params are considered reserved. We used to treat them as overridable, but that essentially breaks extending the base to no value.
  • the expected sentinel values for unused params in new command and new implementations of commands is NaN for float params and INT32_MAX for INT32 params.

@peterbarker I've put in weasel words to not that existing implementations may use 0 for historical reasons and explicitly mentioned ArduPilot. I.e. it is not a bug.

I'd like to make corresponding updates to pymavlink.

Comment thread en/guide/xml_schema.md Outdated
Comment thread en/guide/define_xml_element.md Outdated
Co-authored-by: Hamish Willee <hamishwillee@gmail.com>

@peterbarker peterbarker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@hamishwillee
hamishwillee merged commit a81d586 into mavlink:master Oct 1, 2026
2 of 3 checks passed
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