#include "Copter.h" #if MODE_SMARTRTL_ENABLED == ENABLED /* * Init and run calls for Smart_RTL flight mode * * This code uses the SmartRTL path that is already in memory, and feeds it into WPNav, one point at a time. * Once the copter is close to home, it will run a standard land controller. */ bool ModeSmartRTL::init(bool ignore_checks) { if (g2.smart_rtl.is_active()) { // initialise waypoint and spline controller wp_nav->wp_and_spline_init(); // set current target to a reasonable stopping point Vector3f stopping_point; pos_control->get_stopping_point_xy(stopping_point); pos_control->get_stopping_point_z(stopping_point); wp_nav->set_wp_destination(stopping_point); // initialise yaw to obey user parameter auto_yaw.set_mode_to_default(true); // wait for cleanup of return path smart_rtl_state = SmartRTL_WaitForPathCleanup; return true; } return false; } // perform cleanup required when leaving smart_rtl void ModeSmartRTL::exit() { g2.smart_rtl.cancel_request_for_thorough_cleanup(); } void ModeSmartRTL::run() { switch (smart_rtl_state) { case SmartRTL_WaitForPathCleanup: wait_cleanup_run(); break; case SmartRTL_PathFollow: path_follow_run(); break; case SmartRTL_PreLandPosition: pre_land_position_run(); break; case SmartRTL_Descend: descent_run(); // Re-using the descend method from normal rtl mode. break; case SmartRTL_Land: land_run(true); // Re-using the land method from normal rtl mode. break; } } void ModeSmartRTL::wait_cleanup_run() { // hover at current target position motors->set_desired_spool_state(AP_Motors::DesiredSpoolState::THROTTLE_UNLIMITED); wp_nav->update_wpnav(); pos_control->update_z_controller(); attitude_control->input_euler_angle_roll_pitch_yaw(wp_nav->get_roll(), wp_nav->get_pitch(), auto_yaw.yaw(),true); // check if return path is computed and if yes, begin journey home if (g2.smart_rtl.request_thorough_cleanup()) { smart_rtl_state = SmartRTL_PathFollow; } } void ModeSmartRTL::path_follow_run() { float target_yaw_rate = 0.0f; if (!copter.failsafe.radio) { // get pilot's desired yaw rate target_yaw_rate = get_pilot_desired_yaw_rate(channel_yaw->get_control_in()); if (!is_zero(target_yaw_rate)) { auto_yaw.set_mode(AUTO_YAW_HOLD); } } // if we are close to current target point, switch the next point to be our target. if (wp_nav->reached_wp_destination()) { Vector3f next_point; if (g2.smart_rtl.pop_point(next_point)) { bool fast_waypoint = true; if (g2.smart_rtl.get_num_points() == 0) { // this is the very last point, add 2m to the target alt and move to pre-land state next_point.z -= 2.0f; smart_rtl_state = SmartRTL_PreLandPosition; fast_waypoint = false; } // send target to waypoint controller wp_nav->set_wp_destination_NED(next_point); wp_nav->set_fast_waypoint(fast_waypoint); } else { // this can only happen if we fail to get the semaphore which should never happen but just in case, land smart_rtl_state = SmartRTL_PreLandPosition; } } // update controllers motors->set_desired_spool_state(AP_Motors::DesiredSpoolState::THROTTLE_UNLIMITED); wp_nav->update_wpnav(); pos_control->update_z_controller(); // call attitude controller if (auto_yaw.mode() == AUTO_YAW_HOLD) { // roll & pitch from waypoint controller, yaw rate from pilot attitude_control->input_euler_angle_roll_pitch_euler_rate_yaw(wp_nav->get_roll(), wp_nav->get_pitch(), target_yaw_rate); } else { // roll, pitch from waypoint controller, yaw heading from auto_heading() attitude_control->input_euler_angle_roll_pitch_yaw(wp_nav->get_roll(), wp_nav->get_pitch(), auto_yaw.yaw(), true); } } void ModeSmartRTL::pre_land_position_run() { // if we are close to 2m above start point, we are ready to land. if (wp_nav->reached_wp_destination()) { // choose descend and hold, or land based on user parameter rtl_alt_final if (g.rtl_alt_final <= 0 || copter.failsafe.radio) { land_start(); smart_rtl_state = SmartRTL_Land; } else { set_descent_target_alt(copter.g.rtl_alt_final); descent_start(); smart_rtl_state = SmartRTL_Descend; } } // update controllers motors->set_desired_spool_state(AP_Motors::DesiredSpoolState::THROTTLE_UNLIMITED); wp_nav->update_wpnav(); pos_control->update_z_controller(); attitude_control->input_euler_angle_roll_pitch_yaw(wp_nav->get_roll(), wp_nav->get_pitch(), auto_yaw.yaw(), true); } // save current position for use by the smart_rtl flight mode void ModeSmartRTL::save_position() { const bool should_save_position = motors->armed() && (copter.control_mode != Mode::Number::SMART_RTL); copter.g2.smart_rtl.update(copter.position_ok(), should_save_position); } bool ModeSmartRTL::get_wp(Location& destination) { // provide target in states which use wp_nav switch (smart_rtl_state) { case SmartRTL_WaitForPathCleanup: case SmartRTL_PathFollow: case SmartRTL_PreLandPosition: case SmartRTL_Descend: return wp_nav->get_wp_destination(destination); case SmartRTL_Land: return false; } // we should never get here but just in case return false; } uint32_t ModeSmartRTL::wp_distance() const { return wp_nav->get_wp_distance_to_destination(); } int32_t ModeSmartRTL::wp_bearing() const { return wp_nav->get_wp_bearing_to_destination(); } #endif