ardupilot/ArduPlane/soaring.cpp

186 lines
7.3 KiB
C++
Raw Normal View History

#include "Plane.h"
#if SOARING_ENABLED == ENABLED
/*
* ArduSoar support function
*
* Peter Braswell, Samuel Tabor, Andrey Kolobov, and Iain Guilliard
*/
void Plane::update_soaring() {
// Check if soaring is active. Also sets throttle suppressed
// status on active state changes.
plane.g2.soaring_controller.update_active_state();
if (!g2.soaring_controller.is_active()) {
return;
}
g2.soaring_controller.update_vario();
// Check for throttle suppression change.
switch (control_mode->mode_number()) {
case Mode::Number::AUTO:
g2.soaring_controller.suppress_throttle();
break;
case Mode::Number::FLY_BY_WIRE_B:
case Mode::Number::CRUISE:
if (!g2.soaring_controller.suppress_throttle() && aparm.throttle_max > 0) {
gcs().send_text(MAV_SEVERITY_INFO, "Soaring: forcing RTL");
set_mode(mode_rtl, ModeReason::SOARING_FBW_B_WITH_MOTOR_RUNNING);
}
break;
case Mode::Number::LOITER:
// Never use throttle in LOITER with soaring active.
g2.soaring_controller.set_throttle_suppressed(true);
break;
default:
// In any other mode allow throttle.
g2.soaring_controller.set_throttle_suppressed(false);
break;
}
// Nothing to do if we are in powered flight
if (!g2.soaring_controller.get_throttle_suppressed() && aparm.throttle_max > 0) {
return;
}
switch (control_mode->mode_number()) {
default:
// nothing to do
break;
case Mode::Number::AUTO:
case Mode::Number::FLY_BY_WIRE_B:
case Mode::Number::CRUISE:
// Test for switch into thermalling mode
g2.soaring_controller.update_cruising();
if (g2.soaring_controller.check_thermal_criteria()) {
gcs().send_text(MAV_SEVERITY_INFO, "Soaring: Thermal detected, entering %s", mode_loiter.name());
set_mode(mode_loiter, ModeReason::SOARING_THERMAL_DETECTED);
}
break;
case Mode::Number::LOITER: {
// Update thermal estimate and check for switch back to AUTO
g2.soaring_controller.update_thermalling(); // Update estimate
2020-06-26 14:04:19 -03:00
// Thermalling is done in a home-relative coordinate system, so we need home to be set.
Vector3f position;
if (!ahrs.get_relative_position_NED_home(position)) {
return;
}
// Check distance to home against MAX_RADIUS.
if (g2.soaring_controller.max_radius >= 0 &&
sq(position.x)+sq(position.y) > sq(g2.soaring_controller.max_radius) &&
2020-06-26 14:04:19 -03:00
previous_mode->mode_number()!=Mode::Number::AUTO) {
// Some other loiter status, and outside of maximum soaring radius, and previous mode wasn't AUTO
gcs().send_text(MAV_SEVERITY_INFO, "Soaring: Outside SOAR_MAX_RADIUS, RTL");
set_mode(mode_rtl, ModeReason::SOARING_DRIFT_EXCEEDED);
break;
}
// If previous mode was AUTO and there was a previous NAV command, we can use previous and next wps for drift calculation
// with respect to the desired direction of travel. If these vectors are zero, drift will be calculated from thermal start
// position only, without taking account of the desired direction of travel.
Vector2f prev_wp, next_wp;
2020-06-26 14:04:19 -03:00
if (previous_mode == &mode_auto) {
AP_Mission::Mission_Command current_nav_cmd = mission.get_current_nav_cmd();
AP_Mission::Mission_Command prev_nav_cmd;
if (!(mission.get_next_nav_cmd(mission.get_prev_nav_cmd_with_wp_index(), prev_nav_cmd) &&
2020-06-26 14:04:19 -03:00
prev_nav_cmd.content.location.get_vector_xy_from_origin_NE(prev_wp) &&
current_nav_cmd.content.location.get_vector_xy_from_origin_NE(next_wp))) {
2020-06-26 14:04:19 -03:00
prev_wp.zero();
next_wp.zero();
}
}
2020-06-26 14:04:19 -03:00
// Get the status of the soaring controller cruise checks.
const SoaringController::LoiterStatus loiterStatus = g2.soaring_controller.check_cruise_criteria(prev_wp/100, next_wp/100);
if (loiterStatus == SoaringController::LoiterStatus::GOOD_TO_KEEP_LOITERING) {
// Reset loiter angle, so that the loiter exit heading criteria
// only starts expanding when we're ready to exit.
plane.loiter.sum_cd = 0;
2020-06-26 14:04:19 -03:00
plane.soaring_mode_timer_ms = AP_HAL::millis();
//update the wp location
g2.soaring_controller.get_target(next_WP_loc);
break;
}
// Some other loiter status, we need to think about exiting loiter.
2020-06-26 14:04:19 -03:00
const uint32_t time_in_loiter_ms = AP_HAL::millis() - plane.soaring_mode_timer_ms;
2020-06-26 14:04:19 -03:00
if (!soaring_exit_heading_aligned() && loiterStatus!=SoaringController::LoiterStatus::ALT_TOO_LOW && time_in_loiter_ms < 20000) {
// Heading not lined up, and not timed out or in a condition requiring immediate exit.
break;
}
2020-06-26 14:04:19 -03:00
// Heading lined up and loiter status not good to continue. Need to switch mode.
2020-06-26 14:04:19 -03:00
// Determine appropriate mode.
Mode* exit_mode = previous_mode;
if (loiterStatus == SoaringController::LoiterStatus::ALT_TOO_LOW &&
((previous_mode == &mode_cruise) || (previous_mode == &mode_fbwb))) {
exit_mode = &mode_rtl;
}
// Print message and set mode.
switch (loiterStatus) {
case SoaringController::LoiterStatus::ALT_TOO_HIGH:
soaring_restore_mode("Too high", ModeReason::SOARING_ALT_TOO_HIGH, *exit_mode);
break;
2020-06-26 14:04:19 -03:00
case SoaringController::LoiterStatus::ALT_TOO_LOW:
soaring_restore_mode("Too low", ModeReason::SOARING_ALT_TOO_LOW, *exit_mode);
break;
default:
case SoaringController::LoiterStatus::THERMAL_WEAK:
soaring_restore_mode("Thermal ended", ModeReason::SOARING_THERMAL_ESTIMATE_DETERIORATED, *exit_mode);
break;
2020-06-26 14:04:19 -03:00
case SoaringController::LoiterStatus::DRIFT_EXCEEDED:
soaring_restore_mode("Drifted too far", ModeReason::SOARING_DRIFT_EXCEEDED, *exit_mode);
break;
2020-06-26 14:04:19 -03:00
} // switch loiterStatus
break;
2020-06-26 14:04:19 -03:00
} // case loiter
2019-06-05 17:04:20 -03:00
} // switch control_mode
2020-06-26 14:04:19 -03:00
}
2020-06-26 14:04:19 -03:00
bool Plane::soaring_exit_heading_aligned() const
{
// Return true if the current heading is aligned with the next objective.
// If home is not set, or heading not locked, return true to avoid delaying mode change.
switch (previous_mode->mode_number()) {
case Mode::Number::AUTO: {
//Get the lat/lon of next Nav waypoint after this one:
AP_Mission::Mission_Command current_nav_cmd = mission.get_current_nav_cmd();;
return plane.mode_loiter.isHeadingLinedUp(next_WP_loc, current_nav_cmd.content.location);
}
2020-06-26 14:04:19 -03:00
case Mode::Number::FLY_BY_WIRE_B:
return (!AP::ahrs().home_is_set() || plane.mode_loiter.isHeadingLinedUp(next_WP_loc, AP::ahrs().get_home()));
case Mode::Number::CRUISE:
return (!cruise_state.locked_heading || plane.mode_loiter.isHeadingLinedUp_cd(cruise_state.locked_heading_cd));
default:
break;
}
return true;
}
2020-06-26 14:04:19 -03:00
void Plane::soaring_restore_mode(const char *reason, ModeReason modereason, Mode &exit_mode)
{
gcs().send_text(MAV_SEVERITY_INFO, "Soaring: %s, restoring %s", reason, exit_mode.name());
set_mode(exit_mode, modereason);
}
#endif // SOARING_ENABLED