# Position Mode (Multicopter)
Position is an easy-to-fly RC mode in which roll and pitch sticks control acceleration over ground in the vehicle's left-right and forward-back directions (similar to a car's accelerator pedal), and throttle controls speed of ascent-descent. When the sticks are released/centered the vehicle will actively brake, level, and be locked to a position in 3D space — compensating for wind and other forces. With full stick deflection the vehicle accelerates initially with MPC_ACC_HOR_MAX ramping down until it reaches the final velocity MPC_VEL_MANUAL.
Position mode is the safest manual mode for new fliers. Unlike Altitude and Manual/Stabilized modes the vehicle will stop when the sticks are centered rather than continuing until slowed by wind resistance.
The diagram below shows the mode behaviour visually (for a mode 2 transmitter).
Landing in this mode is easy:
- Position the drone horizontally above the landing spot using the roll and pitch stick.
- Let go of the roll and pitch stick and give it enough time to come to a complete stop.
- Pull the throttle stick down gently until the vehicle touches the ground.
- Pull the throttle stick all the way down to facilitate and accelerate land detection.
- The vehicle will lower propeller thrust, detect the ground and automatically disarm (by default).
While very rare on a well calibrated vehicle, sometimes there may be problems with landing.
- If the vehicle does not stop moving horizontally:
- You can still land under control in Altitude mode. The approach is the same as above, except that you must manually ensure that the vehicle stays above the landing spot using the roll and pitch stick.
- After landing check GPS and magnetometer orientation, calibration.
- If the vehicle does not detect the ground/landing and disarm:
- After the vehicle is on the ground switch to Manual/Stabilized mode keeping the throttle stick low, and manually disarm using a gesture or other command. Alternatively you can also use the kill switch when the vehicle is already on the ground.
# Technical Summary
RC mode where roll, pitch, throttle (RPT) sticks control movement in corresponding axes/directions. Centered sticks level vehicle and hold it to fixed altitude and position against wind.
- Centered roll, pitch, throttle sticks (within RC deadzone MPC_HOLD_DZ) hold x, y, z position steady against any disturbance like wind.
- Outside center:
- Roll/Pitch sticks control horizontal acceleration over ground in the vehicle's left-right and forward-back directions (respectively).
- Throttle stick controls speed of ascent-descent.
- Yaw stick controls rate of angular rotation above the horizontal plane.
- When landed, the vehicle will take off if the throttle stick is raised above 62.5% percent (of the full range from bottom).
- Manual input is required (RC controller, or gamepad/thumbsticks through MAVLink).
- This mode requires GPS.
All the parameters in the Multicopter Position Control group are relevant. A few parameters of particular note are listed below.
|MPC_HOLD_DZ||Deadzone of sticks where position hold is enabled. Default: 0.1 (10% of full stick range).|
|MPC_Z_VEL_MAX_UP||Maximum vertical ascent velocity. Default: 3 m/s.|
|MPC_Z_VEL_MAX_DN||Maximum vertical descent velocity. Default: 1 m/s.|
|MPC_LAND_VEL_XY||Horizontal velocity limit when close to ground (MPC_LAND_ALT2 meters above ground, or above home if distance-to-ground is unknown). Default: 10 m/s.|
|MPC_LAND_ALT1||Altitude for triggering first phase of slow landing. Affects maximum allowed horizontal velocity setpoint. Default 10m.|
|MPC_LAND_ALT2||Altitude for second phase of slow landing. In this phase maximum horizontal velocity is limited to MPC_LAND_VEL_XY. Default 5m.|
| ||RC dead zone for channel X. The value of X for throttle will depend on the value of RC_MAP_THROTTLE. For example, if the throttle is channel 4 then RC4_DZ specifies the deadzone.|
| ||Most of the MPC_xxx parameters affect flight behaviour in this mode (at least to some extent). For example, MPC_THR_HOVER defines the thrust at which a vehicle will hover.|
|MPC_POS_MODE||Stick input to movement translation strategy. From PX4 v1.12 the default (4) is that stick position controls acceleration (in a similar way to a car accelerator pedal). Other options allow stick deflection to directly control speed over ground, with and without smoothing and acceleration limits.|
|MPC_ACC_HOR_MAX||Maximum horizontal acceleration.|
|MPC_VEL_MANUAL||Maximum horizontal velocity.|
# Additional Information
# Position Loss/Safety
Position mode is dependent on having an acceptable position estimate. If the estimate falls below acceptable levels, for example due to GPS loss, this may trigger a Position (GPS) Loss Failsafe. Depending on configuration, whether you have a remote control, and whether there is an adequate altitude estimate, PX4 may switch to altitude mode, manual mode, land mode or terminate.