# Obstacle Avoidance

Obstacle Avoidance enables a vehicle to navigate around obstacles when following a preplanned path.

The feature requires a companion computer that is running computer vision software. This software provides a route for a given desired trajectory, mapping and navigating around obstacles to achieve the best path.

Obstacle avoidance is intended for automatic modes, and is currently supported for multicopter vehicles in Missions and Offboard mode.

This topic explains how the feature is set up and enabled in both modes.

# Limitations/Capabilities

  • The maximum speed for obstacle avoidance is currently approximately 3 m/s (due to the cost of computing the avoidance path).


    Obstacle avoidance can use the local planner planner emits messages at ~30Hz and can move at around 3 m/s) or global planner (emits messages at ~10Hz and mission speed with obstacle avoidance is around 1-1.5 m/s).

# Offboard Mode Avoidance

PX4 supports obstacle avoidance in Offboard mode.

The desired route comes from a ROS node running on a companion computer. This is passed into an obstacle avoidance module (another ROS node). The avoidance software sends the planned path to the flight stack as a stream of SET_POSITION_TARGET_LOCAL_NED messages.

The only required PX4-side setup is to put PX4 into Offboard mode.

Companion-side hardware setup and hardware/software configuration is provided in the PX4/avoidance (opens new window) Github repo.

# Mission Mode Avoidance

PX4 supports obstacle avoidance in Mission mode, using avoidance software running on a separate companion computer.

# Mission Progression

Mission behaviour with obstacle avoidance enabled is slightly different to the original plan.

The difference when avoidance is active are:

  • A waypoint is "reached" when the vehicle is within the acceptance radius, regardless of its heading.
    • This differs from normal missions, in which the vehicle must reach a waypoint with a certain heading (i.e. in a "close to" straight line from the previous waypoint). This constraint cannot be fulfilled when obstacle avoidance is active because the obstacle avoidance algorithm has full control of the vehicle heading, and the vehicle always moves in the current field of view.
  • PX4 starts emitting a new current/next waypoint once the previous waypoint is reached (i.e. as soon as vehicle enters its acceptance radius).
  • If a waypoint is inside an obstacle it may unreachable (and the mission will be stuck).
    • If the vehicle projection on the line previous-current waypoint passes the current waypoint, the acceptance radius is enlarged such that the current waypoint is set as reached
    • If the vehicle within the x-y acceptance radius, the altitude acceptance is modified such that the mission progresses (even if it is not in the altitude acceptance radius).
  • The original mission speed (as set in QGroundControl/PX4) is ignored. The speed will be determined by the avoidance software:
    • local planner mission speed is around 3 m/s.
    • global planner mission speed is around 1-1.5 m/s.

If PX4 stops receiving setpoint updates for more than half a second it will switch into Hold mode.

# PX4 Configuration

Obstacle avoidance is enabled within PX4 by setting the COM_OBS_AVOID to 1.


COM_OBS_AVOID also enables Safe Landing and any other features that use the PX4 Path Planning Offboard Interface (Trajectory Interface) to integrate external path planning services with PX4.

# Companion Computer Setup

Companion-side hardware setup and hardware/software configuration is provided in the PX4/avoidance (opens new window) Github repo.

Obstacle avoidance in missions can use either the local planner or global planner (the local planner is recommended/better performing).

# Obstacle Avoidance Interface

PX4 uses the Path Planning Offboard Interface for integrating path planning services from a companion computer (including Obstacle Avoidance in missions, Safe Landing, and future services).

The interface (messages sent) between PX4 and the companion are exactly the same as for any other path planning services.

# Supported Hardware

Tested companion computers and cameras are listed in PX4/avoidance (opens new window).