mirror of https://github.com/ArduPilot/ardupilot
281 lines
10 KiB
C++
281 lines
10 KiB
C++
// -*- tab-width: 4; Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil -*-
|
|
|
|
#include "Copter.h"
|
|
|
|
/*
|
|
* This event will be called when the failsafe changes
|
|
* boolean failsafe reflects the current state
|
|
*/
|
|
void Copter::failsafe_radio_on_event()
|
|
{
|
|
// if motors are not armed there is nothing to do
|
|
if( !motors.armed() ) {
|
|
return;
|
|
}
|
|
|
|
// This is how to handle a failsafe.
|
|
switch(control_mode) {
|
|
case STABILIZE:
|
|
case ACRO:
|
|
// if throttle is zero OR vehicle is landed disarm motors
|
|
if (ap.throttle_zero || ap.land_complete) {
|
|
init_disarm_motors();
|
|
|
|
// if failsafe_throttle is FS_THR_ENABLED_ALWAYS_LAND then land immediately
|
|
}else if(g.failsafe_throttle == FS_THR_ENABLED_ALWAYS_LAND) {
|
|
set_mode_land_with_pause();
|
|
|
|
// if far from home then RTL
|
|
} else if(home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
|
|
// We have no GPS or are very close to home so we will land
|
|
}else{
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
|
|
case AUTO:
|
|
// if mission has not started AND vehicle is landed, disarm motors
|
|
if (!ap.auto_armed && ap.land_complete) {
|
|
init_disarm_motors();
|
|
|
|
// if failsafe_throttle is FS_THR_ENABLED_ALWAYS_LAND then land immediately
|
|
} else if(g.failsafe_throttle == FS_THR_ENABLED_ALWAYS_LAND) {
|
|
set_mode_land_with_pause();
|
|
|
|
// if failsafe_throttle is FS_THR_ENABLED_ALWAYS_RTL do RTL
|
|
} else if (g.failsafe_throttle == FS_THR_ENABLED_ALWAYS_RTL) {
|
|
if (home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
// We are very close to home so we will land
|
|
set_mode_land_with_pause();
|
|
}
|
|
}
|
|
// failsafe_throttle must be FS_THR_ENABLED_CONTINUE_MISSION so no need to do anything
|
|
break;
|
|
|
|
case LAND:
|
|
// continue to land if battery failsafe is also active otherwise fall through to default handling
|
|
if (g.failsafe_battery_enabled == FS_BATT_LAND && failsafe.battery) {
|
|
break;
|
|
}
|
|
// no break
|
|
default:
|
|
// used for AltHold, Guided, Loiter, RTL, Circle, Drift, Sport, Flip, Autotune, PosHold
|
|
// if landed disarm
|
|
if (ap.land_complete) {
|
|
init_disarm_motors();
|
|
|
|
// if failsafe_throttle is FS_THR_ENABLED_ALWAYS_LAND then land immediately
|
|
} else if(g.failsafe_throttle == FS_THR_ENABLED_ALWAYS_LAND) {
|
|
set_mode_land_with_pause();
|
|
|
|
// if far from home then RTL
|
|
} else if(home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
// We have no GPS or are very close to home so we will land
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
}
|
|
|
|
// log the error to the dataflash
|
|
Log_Write_Error(ERROR_SUBSYSTEM_FAILSAFE_RADIO, ERROR_CODE_FAILSAFE_OCCURRED);
|
|
|
|
}
|
|
|
|
// failsafe_off_event - respond to radio contact being regained
|
|
// we must be in AUTO, LAND or RTL modes
|
|
// or Stabilize or ACRO mode but with motors disarmed
|
|
void Copter::failsafe_radio_off_event()
|
|
{
|
|
// no need to do anything except log the error as resolved
|
|
// user can now override roll, pitch, yaw and throttle and even use flight mode switch to restore previous flight mode
|
|
Log_Write_Error(ERROR_SUBSYSTEM_FAILSAFE_RADIO, ERROR_CODE_FAILSAFE_RESOLVED);
|
|
}
|
|
|
|
void Copter::failsafe_battery_event(void)
|
|
{
|
|
// return immediately if low battery event has already been triggered
|
|
if (failsafe.battery) {
|
|
return;
|
|
}
|
|
|
|
// failsafe check
|
|
if (g.failsafe_battery_enabled != FS_BATT_DISABLED && motors.armed()) {
|
|
switch(control_mode) {
|
|
case STABILIZE:
|
|
case ACRO:
|
|
// if throttle is zero OR vehicle is landed disarm motors
|
|
if (ap.throttle_zero || ap.land_complete) {
|
|
init_disarm_motors();
|
|
}else{
|
|
// set mode to RTL or LAND
|
|
if (g.failsafe_battery_enabled == FS_BATT_RTL && home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
set_mode_land_with_pause();
|
|
}
|
|
}
|
|
break;
|
|
case AUTO:
|
|
// if mission has not started AND vehicle is landed, disarm motors
|
|
if (!ap.auto_armed && ap.land_complete) {
|
|
init_disarm_motors();
|
|
|
|
// set mode to RTL or LAND
|
|
} else if (home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
} else {
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
default:
|
|
// used for AltHold, Guided, Loiter, RTL, Circle, Drift, Sport, Flip, Autotune, PosHold
|
|
// if landed disarm
|
|
if (ap.land_complete) {
|
|
init_disarm_motors();
|
|
|
|
// set mode to RTL or LAND
|
|
} else if (g.failsafe_battery_enabled == FS_BATT_RTL && home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
} else {
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
// set the low battery flag
|
|
set_failsafe_battery(true);
|
|
|
|
// warn the ground station and log to dataflash
|
|
gcs_send_text(MAV_SEVERITY_CRITICAL,"Low Battery!");
|
|
Log_Write_Error(ERROR_SUBSYSTEM_FAILSAFE_BATT, ERROR_CODE_FAILSAFE_OCCURRED);
|
|
|
|
}
|
|
|
|
// failsafe_gcs_check - check for ground station failsafe
|
|
void Copter::failsafe_gcs_check()
|
|
{
|
|
uint32_t last_gcs_update_ms;
|
|
|
|
// return immediately if gcs failsafe is disabled, gcs has never been connected or we are not overriding rc controls from the gcs and we are not in guided mode
|
|
// this also checks to see if we have a GCS failsafe active, if we do, then must continue to process the logic for recovery from this state.
|
|
if ((!failsafe.gcs)&&(g.failsafe_gcs == FS_GCS_DISABLED || failsafe.last_heartbeat_ms == 0 || (!failsafe.rc_override_active && control_mode != GUIDED))) {
|
|
return;
|
|
}
|
|
|
|
// calc time since last gcs update
|
|
// note: this only looks at the heartbeat from the device id set by g.sysid_my_gcs
|
|
last_gcs_update_ms = millis() - failsafe.last_heartbeat_ms;
|
|
|
|
// check if all is well
|
|
if (last_gcs_update_ms < FS_GCS_TIMEOUT_MS) {
|
|
// check for recovery from gcs failsafe
|
|
if (failsafe.gcs) {
|
|
failsafe_gcs_off_event();
|
|
set_failsafe_gcs(false);
|
|
}
|
|
return;
|
|
}
|
|
|
|
// do nothing if gcs failsafe already triggered or motors disarmed
|
|
if (failsafe.gcs || !motors.armed()) {
|
|
return;
|
|
}
|
|
|
|
// GCS failsafe event has occured
|
|
// update state, log to dataflash
|
|
set_failsafe_gcs(true);
|
|
Log_Write_Error(ERROR_SUBSYSTEM_FAILSAFE_GCS, ERROR_CODE_FAILSAFE_OCCURRED);
|
|
|
|
// clear overrides so that RC control can be regained with radio.
|
|
hal.rcin->clear_overrides();
|
|
failsafe.rc_override_active = false;
|
|
|
|
// This is how to handle a failsafe.
|
|
// use the throttle failsafe setting to decide what to do
|
|
switch(control_mode) {
|
|
case STABILIZE:
|
|
case ACRO:
|
|
case SPORT:
|
|
// if throttle is zero disarm motors
|
|
if (ap.throttle_zero || ap.land_complete) {
|
|
init_disarm_motors();
|
|
}else if(home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
// We have no GPS or are very close to home so we will land
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
case AUTO:
|
|
// if mission has not started AND vehicle is landed, disarm motors
|
|
if (!ap.auto_armed && ap.land_complete) {
|
|
init_disarm_motors();
|
|
// if g.failsafe_gcs is 1 do RTL, 2 means continue with the mission
|
|
} else if (g.failsafe_gcs == FS_GCS_ENABLED_ALWAYS_RTL) {
|
|
if (home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
// We are very close to home so we will land
|
|
set_mode_land_with_pause();
|
|
}
|
|
}
|
|
// if failsafe_throttle is 2 (i.e. FS_THR_ENABLED_CONTINUE_MISSION) no need to do anything
|
|
break;
|
|
default:
|
|
// used for AltHold, Guided, Loiter, RTL, Circle, Drift, Sport, Flip, Autotune, PosHold
|
|
// if landed disarm
|
|
if (ap.land_complete) {
|
|
init_disarm_motors();
|
|
} else if (home_distance > FS_CLOSE_TO_HOME_CM) {
|
|
// switch to RTL or if that fails, LAND
|
|
set_mode_RTL_or_land_with_pause();
|
|
}else{
|
|
// We have no GPS or are very close to home so we will land
|
|
set_mode_land_with_pause();
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
// failsafe_gcs_off_event - actions to take when GCS contact is restored
|
|
void Copter::failsafe_gcs_off_event(void)
|
|
{
|
|
// log recovery of GCS in logs?
|
|
Log_Write_Error(ERROR_SUBSYSTEM_FAILSAFE_GCS, ERROR_CODE_FAILSAFE_RESOLVED);
|
|
}
|
|
|
|
// set_mode_RTL_or_land_with_pause - sets mode to RTL if possible or LAND with 4 second delay before descent starts
|
|
// this is always called from a failsafe so we trigger notification to pilot
|
|
void Copter::set_mode_RTL_or_land_with_pause()
|
|
{
|
|
// attempt to switch to RTL, if this fails then switch to Land
|
|
if (!set_mode(RTL)) {
|
|
// set mode to land will trigger mode change notification to pilot
|
|
set_mode_land_with_pause();
|
|
} else {
|
|
// alert pilot to mode change
|
|
AP_Notify::events.failsafe_mode_change = 1;
|
|
}
|
|
}
|
|
|
|
void Copter::update_events()
|
|
{
|
|
ServoRelayEvents.update_events();
|
|
}
|
|
|