#pragma once #include #include #include #include // AHRS library #include // Inertial Navigation library #include // Attitude controller library for sqrt controller #include // Failsafe fence library #include #define AC_AVOID_ACCEL_CMSS_MAX 100.0f // maximum acceleration/deceleration in cm/s/s used to avoid hitting fence // bit masks for enabled fence types. #define AC_AVOID_DISABLED 0 // avoidance disabled #define AC_AVOID_STOP_AT_FENCE 1 // stop at fence #define AC_AVOID_USE_PROXIMITY_SENSOR 2 // stop based on proximity sensor output #define AC_AVOID_ALL 3 // use fence and promiximity sensor /* * This class prevents the vehicle from leaving a polygon fence in * 2 dimensions by limiting velocity (adjust_velocity). */ class AC_Avoid { public: /// Constructor AC_Avoid(const AP_AHRS& ahrs, const AP_InertialNav& inav, const AC_Fence& fence, const AP_Proximity& proximity); /* * Adjusts the desired velocity so that the vehicle can stop * before the fence/object. * Note: Vector3f version is for convenience and only adjusts x and y axis */ void adjust_velocity(const float kP, const float accel_cmss, Vector2f &desired_vel); void adjust_velocity(const float kP, const float accel_cmss, Vector3f &desired_vel); static const struct AP_Param::GroupInfo var_info[]; private: /* * Adjusts the desired velocity for the circular fence. */ void adjust_velocity_circle(const float kP, const float accel_cmss, Vector2f &desired_vel); /* * Adjusts the desired velocity for the polygon fence. */ void adjust_velocity_poly(const float kP, const float accel_cmss, Vector2f &desired_vel); /* * Adjusts the desired velocity based on output from the proximity sensor */ void adjust_velocity_proximity(const float kP, const float accel_cmss, Vector2f &desired_vel); /* * Limits the component of desired_vel in the direction of the unit vector * limit_direction to be at most the maximum speed permitted by the limit_distance. * * Uses velocity adjustment idea from Randy's second email on this thread: * https://groups.google.com/forum/#!searchin/drones-discuss/obstacle/drones-discuss/QwUXz__WuqY/qo3G8iTLSJAJ */ void limit_velocity(const float kP, const float accel_cmss, Vector2f &desired_vel, const Vector2f limit_direction, const float limit_distance) const; /* * Gets the current position, relative to home (not relative to EKF origin) */ Vector2f get_position(); /* * Computes the speed such that the stopping distance * of the vehicle will be exactly the input distance. */ float get_max_speed(const float kP, const float accel_cmss, const float distance) const; /* * Computes distance required to stop, given current speed. */ float get_stopping_distance(const float kP, const float accel_cmss, const float speed) const; /* * Gets the fence margin in cm */ float get_margin() const { return _fence.get_margin() * 100.0f; } // external references const AP_AHRS& _ahrs; const AP_InertialNav& _inav; const AC_Fence& _fence; const AP_Proximity& _proximity; // parameters AP_Int8 _enabled; };