Skip to content

Commit b5d8586

Browse files
shwetasnghHwurzburg
authored andcommitted
issue(#6796) : Improved optitrack setup instructions
This change improves the OptiTrack non-GPS navigation documentation by clarifying two commonly confusing setup steps.
1 parent a5853f6 commit b5d8586

File tree

1 file changed

+16
-3
lines changed

1 file changed

+16
-3
lines changed

common/source/docs/common-optitrack.rst

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -122,8 +122,12 @@ Ground testing
122122

123123
- Connect the drone to MAVProxy
124124
- Start Motive and make sure `data streaming <https://v20.wiki.optitrack.com/index.php?title=Data_Streaming>`__ is turned on.
125-
- load and start optitrack module.
126-
- If you see following message appearing (initial pos may vary), then the drone is receiving pose data from Optitrack system.
125+
- Load and start optitrack module.
126+
- After starting the OptiTrack stream, verify that the position reported by ArduPilot closely matches the position shown in the OptiTrack (Motive) software.
127+
128+
Small offsets (a few centimeters) are acceptable. Large discrepancies indicate a configuration issue such as incorrect axis alignment, origin placement, or rigid body setup.
129+
130+
- If you see the following message appearing (initial pos may vary), then the drone is receiving pose data from the Optitrack system.
127131

128132
``EKF3 IMU0 is using external nav data
129133
EKF3 IMU0 initial pos NED = 0.1,-0.2,0.0 (m)
@@ -136,7 +140,16 @@ Take off in AltHold mode and maintain a stable hover. Switch to Loiter but be re
136140

137141
.. note::
138142

139-
In order to take off in guided or auto mode, you need to use `GPS_GLOBAL_ORIGIN <https://mavlink.io/en/messages/common.html#SET_GPS_GLOBAL_ORIGIN>`__ to set the GPS location of motion capture system origin. It is not need to be accurate, any valid lat/lng is ok.
143+
In order to take off in Guided, Auto, or RTL modes, a valid GPS global origin must be set using
144+
`GPS_GLOBAL_ORIGIN <https://mavlink.io/en/messages/common.html#SET_GPS_GLOBAL_ORIGIN>`__.
145+
146+
The latitude and longitude do not need to be highly accurate, but they must be valid coordinates.
147+
It is recommended to use the approximate latitude and longitude of the building or test facility
148+
where the motion capture system is installed (for example, obtained from Google Maps).
149+
Altitude can be set to zero or an approximate value.
150+
151+
The GPS global origin is only used as a reference frame; all position information comes from the
152+
OptiTrack system.
140153

141154
.. youtube:: JKzuaVQZclI
142155
:width: 100%

0 commit comments

Comments
 (0)