SIM001

SIM001 › The ground station › Ground control station › Planning a mission

Waypoints

When PLAN is selected, each click on the map adds a waypoint at the end of the plan, at the plan altitude. A right-click removes the last item, and CLEAR removes all items. The map shows the plan as a dashed line, and the mission on the vehicle as a solid line.

A click adds a waypoint

If the map tool is PLAN, click the map. A new marker appears at the end of the dashed plan, and the count on UPLOAD goes up by 1. The last item of the dashed plan is WAYPOINT. The new waypoint goes at the altitude between ALT- and ALT+.

Except when the plan has 650 items: see A full plan takes no more waypoints.

If the map tool is PLAN, click the map. A new marker appears at the end of the dashed plan, and the count on UPLOAD goes up by 1. The last item of the dashed plan is WAYPOINT. The new waypoint goes at the altitude between ALT- and ALT+.

See it in Planning a hand-launched circuit, Fixing a misplaced waypoint, Clearing the ridge, Keeping a mission for the field, From plan to flight.

How this is tested verified
Given the map tool is PLAN
When the operator clicks the map
Then the plan goes up by 1
  And the last plan item is WAYPOINT
  And the newest waypoint is at the plan altitude
Follows
the section's setup
Leads to
Right-click removes the last item, Loading brings the saved plan back
Overridden by
A full plan takes no more waypoints when the map tool is PLAN and the plan has 650 items
Tested by
Planning a hand-launched circuit › Takeoff, three waypoints, home passed, Fixing a misplaced waypoint › Two clicks and a right-click passed, Clearing the ridge › Raise the plan, add a waypoint, check it not supported yet, Keeping a mission for the field › Save, change, load not supported yet, From plan to flight › Plan, upload, arm, AUTO, throw not supported yet, 6 more

Right-click removes the last item

If the map tool is PLAN and the plan has at least 1 item, right-click the map. The last marker goes away from the dashed plan, and the count on UPLOAD goes down by 1.

If the map tool is PLAN and the plan has at least 1 item, right-click the map. The last marker goes away from the dashed plan, and the count on UPLOAD goes down by 1.

See it in Fixing a misplaced waypoint.

How this is tested verified
Given the map tool is PLAN
  And the plan has at least 1 item
When the operator right-clicks the map
Then the plan goes down by 1
Follows
PLAN picks the planning tool, A click adds a waypoint, +TKOF puts a takeoff first, +RTL ends the plan with a return, A survey grid fills the area with waypoints
Tested by
Fixing a misplaced waypoint › Two clicks and a right-click passed

Right-click on an empty plan does nothing

If the map tool is PLAN and the plan has 0 items, right-click the map. The dashed plan and the count on UPLOAD do not change.

Screenshot to come.
Screenshot to come.
How this is tested verified
Given the map tool is PLAN
  And the plan has 0 items
When the operator right-clicks the map
Then the plan stays the same
Follows
the section's setup
Tested by
Reaching «Right-click on an empty plan does nothing» passed

CLEAR empties the plan

Press CLEAR. The UPLOAD button reads UPLOAD 0. The plan has no takeoff.

Press CLEAR. The UPLOAD button reads UPLOAD 0. The plan has no takeoff.
How this is tested verified
When the operator clears the plan
Then the plan has 0 items
  And the takeoff is not planned
Follows
the section's setup
Tested by
Reaching «CLEAR empties the plan» passed

A full plan takes no more waypoints

ArduPilot keeps approximately 650 mission items in its memory, so the plan stops at 650. With BRD_SD_MISSION and an SD card, ArduPilot keeps more.

If the map tool is PLAN and the plan has 650 items, click the map. The dashed plan and the count on UPLOAD do not change.

An exception to A click adds a waypoint.

Screenshot to come.
Screenshot to come.
How this is tested untested
Given the map tool is PLAN
  And the plan has 650 items
When the operator clicks the map
Then the plan stays the same
Follows
A survey grid fills the area with waypoints
Leads to
Loading brings the saved plan back
Overrides
A click adds a waypoint when the map tool is PLAN and the plan has 650 items
Tested by
nothing yet