Skip to content

mission: correct _INT frame guidance - #796

Merged
hamishwillee merged 2 commits into
mavlink:masterfrom
bansiesta:mission-doc-int-frames
Oct 29, 2026
Merged

hamishwillee merged 2 commits into
mavlink:masterfrom
bansiesta:mission-doc-int-frames

Conversation

@bansiesta

Copy link
Copy Markdown
Contributor

The _INT global frames became synonyms of their non-_INT counterparts in mavlink/mavlink#2092 and are now marked superseded. mission.md still told plan items to use the _INT frames, and tied the 1e7 lat/lon scaling to the frame rather than to the field.

This recommends MAV_FRAME_GLOBAL / _RELATIVE_ALT / _TERRAIN_ALT instead, notes that scaling comes from the MISSION_ITEM_INT field type, and keeps the _INT variants as a compatibility note.

Tested: yarn docs:build, plus markdownlint, prettier and cspell on the changed file.

@julianoes

The _INT global frames were made synonyms of their non-_INT counterparts
in mavlink/mavlink#2092 and are tagged <superseded since="2024-03"> in
common.xml, but this page still instructed plan items to use them and
tied 1e7 scaling to the frame rather than to the field.

Scaling is a property of the field: MISSION_ITEM_INT.x/y are int32_t
holding degrees * 1e7 regardless of which spelling of the frame is set.
Recommend MAV_FRAME_GLOBAL / _RELATIVE_ALT / _TERRAIN_ALT, and keep the
note about the _INT variants as a compatibility aside.

@julianoes julianoes 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.

Looks correct to me.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@hamishwillee hamishwillee left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks @julianoes

I moved this up and made it more of a warning. While strictly accurate too easy to miss how implementers should work with these.

@hamishwillee
hamishwillee merged commit eb4312a into mavlink:master Oct 29, 2026
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.

3 participants