/**************************************************************************** * * Copyright (c) 2018 PX4 Development Team. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name PX4 nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /** * @file FlightTaskAuto.hpp * * Map from global triplet to local quadruple. */ #pragma once #include "FlightTask.hpp" #include #include #include #include #include #include /** * This enum has to agree with position_setpoint_s type definition * The only reason for not using the struct position_setpoint is because * of the size */ enum class WaypointType : int { position = position_setpoint_s::SETPOINT_TYPE_POSITION, velocity = position_setpoint_s::SETPOINT_TYPE_VELOCITY, loiter = position_setpoint_s::SETPOINT_TYPE_LOITER, takeoff = position_setpoint_s::SETPOINT_TYPE_TAKEOFF, land = position_setpoint_s::SETPOINT_TYPE_LAND, idle = position_setpoint_s::SETPOINT_TYPE_IDLE, offboard = position_setpoint_s::SETPOINT_TYPE_OFFBOARD, // only part of this structure due to legacy reason. It is not used within the Auto flighttasks follow_target = position_setpoint_s::SETPOINT_TYPE_FOLLOW_TARGET, }; enum class State { offtrack, /**< Vehicle is more than cruise speed away from track */ target_behind, /**< Vehicle is in front of target. */ previous_infront, /**< Vehilce is behind previous waypoint.*/ none /**< Vehicle is in normal tracking mode from triplet previous to triplet target */ }; class FlightTaskAuto : public FlightTask { public: FlightTaskAuto() = default; virtual ~FlightTaskAuto() = default; bool initializeSubscriptions(SubscriptionArray &subscription_array) override; bool activate() override; bool updateInitialize() override; /** * Sets an external yaw handler which can be used to implement a different yaw control strategy. */ void setYawHandler(WeatherVane *ext_yaw_handler) override {_ext_yaw_handler = ext_yaw_handler;} protected: void _setDefaultConstraints() override; matrix::Vector2f _getTargetVelocityXY(); /**< only used for follow-me and only here because of legacy reason.*/ void _updateInternalWaypoints(); /**< Depending on state of vehicle, the internal waypoints might differ from target (for instance if offtrack). */ bool _compute_heading_from_2D_vector(float &heading, matrix::Vector2f v); /**< Computes and sets heading a 2D vector */ void _updateAvoidanceWaypoints(); /**< fill desired_waypoints with the triplets. */ matrix::Vector3f _prev_prev_wp{}; /**< Pre-previous waypoint (local frame). This will be used for smoothing trajectories -> not used yet. */ matrix::Vector3f _prev_wp{}; /**< Previous waypoint (local frame). If no previous triplet is available, the prev_wp is set to current position. */ matrix::Vector3f _target{}; /**< Target waypoint (local frame).*/ matrix::Vector3f _next_wp{}; /**< The next waypoint after target (local frame). If no next setpoint is available, next is set to target. */ float _mc_cruise_speed{0.0f}; /**< Requested cruise speed. If not valid, default cruise speed is used. */ WaypointType _type{WaypointType::idle}; /**< Type of current target triplet. */ uORB::Subscription *_sub_home_position{nullptr}; State _current_state{State::none}; float _target_acceptance_radius = 0.0f; /**< Acceptances radius of the target */ int _mission_gear = landing_gear_s::GEAR_KEEP; DEFINE_PARAMETERS_CUSTOM_PARENT(FlightTask, (ParamFloat) _param_mpc_xy_cruise, (ParamFloat) _param_mpc_cruise_90, // speed at corner when angle is 90 degrees move to line (ParamFloat) _param_nav_mc_alt_rad, //vertical acceptance radius at which waypoints are updated (ParamInt) _param_mpc_yaw_mode, // defines how heading is executed, (ParamInt) _param_com_obs_avoid // obstacle avoidance active ); private: matrix::Vector2f _lock_position_xy{NAN, NAN}; /**< if no valid triplet is received, lock positition to current position */ bool _yaw_lock = false; /**< if within acceptance radius, lock yaw to current yaw */ uORB::Subscription *_sub_triplet_setpoint{nullptr}; uORB::Subscription *_sub_vehicle_status{nullptr}; matrix::Vector3f _triplet_target; /**< current triplet from navigator which may differ from the intenal one (_target) depending on the vehicle state. */ matrix::Vector3f _triplet_prev_wp; /**< previous triplet from navigator which may differ from the intenal one (_prev_wp) depending on the vehicle state.*/ matrix::Vector3f _triplet_next_wp; /**< next triplet from navigator which may differ from the intenal one (_next_wp) depending on the vehicle state.*/ matrix::Vector2f _closest_pt; /**< closest point to the vehicle position on the line previous - target */ map_projection_reference_s _reference_position{}; /**< Structure used to project lat/lon setpoint into local frame. */ float _reference_altitude = NAN; /**< Altitude relative to ground. */ hrt_abstime _time_stamp_reference = 0; /**< time stamp when last reference update occured. */ WeatherVane *_ext_yaw_handler = nullptr; /**< external weathervane library, used to implement a yaw control law that turns the vehicle nose into the wind */ orb_advert_t _pub_pos_control_status = nullptr; /**< Publisher for the position controller status */ bool _evaluateTriplets(); /**< Checks and sets triplets. */ bool _isFinite(const position_setpoint_s &sp); /**< Checks if all waypoint triplets are finite. */ bool _evaluateGlobalReference(); /**< Check is global reference is available. */ State _getCurrentState(); /**< Computes the current vehicle state based on the vehicle position and navigator triplets. */ void _set_heading_from_mode(); /**< @see MPC_YAW_MODE */ void _checkAvoidanceProgress(); };