2 * This file is part of Cleanflight and Betaflight.
4 * Cleanflight and Betaflight are free software. You can redistribute
5 * this software and/or modify this software under the terms of the
6 * GNU General Public License as published by the Free Software
7 * Foundation, either version 3 of the License, or (at your option)
10 * Cleanflight and Betaflight are distributed in the hope that they
11 * will be useful, but WITHOUT ANY WARRANTY; without even the implied
12 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 * See the GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this software.
18 * If not, see <http://www.gnu.org/licenses/>.
28 #include "build/debug.h"
30 #include "blackbox/blackbox.h"
32 #include "common/axis.h"
33 #include "common/filter.h"
34 #include "common/maths.h"
35 #include "common/utils.h"
37 #include "config/feature.h"
39 #include "pg/pg_ids.h"
42 #include "drivers/light_led.h"
43 #include "drivers/serial_usb_vcp.h"
44 #include "drivers/sound_beeper.h"
45 #include "drivers/system.h"
46 #include "drivers/time.h"
47 #include "drivers/transponder_ir.h"
48 #include "drivers/usb_io.h"
50 #include "sensors/acceleration.h"
51 #include "sensors/barometer.h"
52 #include "sensors/battery.h"
53 #include "sensors/boardalignment.h"
54 #include "sensors/gyro.h"
55 #include "sensors/sensors.h"
57 #include "fc/config.h"
58 #include "fc/controlrate_profile.h"
59 #include "fc/fc_core.h"
60 #include "fc/fc_dispatch.h"
62 #include "fc/rc_adjustments.h"
63 #include "fc/rc_controls.h"
64 #include "fc/runtime_config.h"
66 #include "msp/msp_serial.h"
68 #include "interface/cli.h"
70 #include "io/asyncfatfs/asyncfatfs.h"
71 #include "io/beeper.h"
73 #include "io/motors.h"
74 #include "io/pidaudio.h"
75 #include "io/servos.h"
76 #include "io/serial.h"
77 #include "io/statusindicator.h"
78 #include "io/transponder_ir.h"
79 #include "io/vtx_control.h"
80 #include "io/vtx_rtc6705.h"
84 #include "scheduler/scheduler.h"
86 #include "telemetry/telemetry.h"
88 #include "flight/position.h"
89 #include "flight/failsafe.h"
90 #include "flight/imu.h"
91 #include "flight/mixer.h"
92 #include "flight/pid.h"
93 #include "flight/servos.h"
94 #include "flight/gps_rescue.h"
106 #define GYRO_WATCHDOG_DELAY 80 // delay for gyro sync
108 #ifdef USE_RUNAWAY_TAKEOFF
109 #define RUNAWAY_TAKEOFF_PIDSUM_THRESHOLD 600 // The pidSum threshold required to trigger - corresponds to a pidSum value of 60% (raw 600) in the blackbox viewer
110 #define RUNAWAY_TAKEOFF_ACTIVATE_DELAY 75000 // (75ms) Time in microseconds where pidSum is above threshold to trigger
111 #define RUNAWAY_TAKEOFF_DEACTIVATE_STICK_PERCENT 15 // 15% - minimum stick deflection during deactivation phase
112 #define RUNAWAY_TAKEOFF_DEACTIVATE_PIDSUM_LIMIT 100 // 10.0% - pidSum limit during deactivation phase
113 #define RUNAWAY_TAKEOFF_GYRO_LIMIT_RP 15 // Roll/pitch 15 deg/sec threshold to prevent triggering during bench testing without props
114 #define RUNAWAY_TAKEOFF_GYRO_LIMIT_YAW 50 // Yaw 50 deg/sec threshold to prevent triggering during bench testing without props
115 #define RUNAWAY_TAKEOFF_HIGH_THROTTLE_PERCENT 75 // High throttle limit to accelerate deactivation (halves the deactivation delay)
117 #define DEBUG_RUNAWAY_TAKEOFF_ENABLED_STATE 0
118 #define DEBUG_RUNAWAY_TAKEOFF_ACTIVATING_DELAY 1
119 #define DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_DELAY 2
120 #define DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_TIME 3
122 #define DEBUG_RUNAWAY_TAKEOFF_TRUE 1
123 #define DEBUG_RUNAWAY_TAKEOFF_FALSE 0
126 #define PARALYZE_PREVENT_MODE_CHANGES_DELAY_US 100000 // Delay after paralyze mode activates to let other mode changes propagate
128 #if defined(USE_GPS) || defined(USE_MAG)
132 static bool flipOverAfterCrashMode
= false;
134 static uint32_t disarmAt
; // Time of automatic disarm when "Don't spin the motors when armed" is enabled and auto_disarm_delay is nonzero
137 static int lastArmingDisabledReason
= 0;
139 #ifdef USE_RUNAWAY_TAKEOFF
140 static timeUs_t runawayTakeoffDeactivateUs
= 0;
141 static timeUs_t runawayTakeoffAccumulatedUs
= 0;
142 static bool runawayTakeoffCheckDisabled
= false;
143 static timeUs_t runawayTakeoffTriggerUs
= 0;
144 static bool runawayTakeoffTemporarilyDisabled
= false;
147 static bool paralyzeModeAllowed
= false;
149 void preventModeChangesDispatch(dispatchEntry_t
*self
) {
151 preventModeChanges();
154 static dispatchEntry_t preventModeChangesDispatchEntry
= { .dispatch
= preventModeChangesDispatch
};
156 PG_REGISTER_WITH_RESET_TEMPLATE(throttleCorrectionConfig_t
, throttleCorrectionConfig
, PG_THROTTLE_CORRECTION_CONFIG
, 0);
158 PG_RESET_TEMPLATE(throttleCorrectionConfig_t
, throttleCorrectionConfig
,
159 .throttle_correction_value
= 0, // could 10 with althold or 40 for fpv
160 .throttle_correction_angle
= 800 // could be 80.0 deg with atlhold or 45.0 for fpv
163 void applyAndSaveAccelerometerTrimsDelta(rollAndPitchTrims_t
*rollAndPitchTrimsDelta
)
165 accelerometerConfigMutable()->accelerometerTrims
.values
.roll
+= rollAndPitchTrimsDelta
->values
.roll
;
166 accelerometerConfigMutable()->accelerometerTrims
.values
.pitch
+= rollAndPitchTrimsDelta
->values
.pitch
;
168 saveConfigAndNotify();
171 static bool isCalibrating(void)
174 if (sensors(SENSOR_BARO
) && !isBaroCalibrationComplete()) {
179 // Note: compass calibration is handled completely differently, outside of the main loop, see f.CALIBRATE_MAG
181 return (!accIsCalibrationComplete() && sensors(SENSOR_ACC
)) || (!isGyroCalibrationComplete());
184 void resetArmingDisabled(void)
186 lastArmingDisabledReason
= 0;
189 void updateArmingStatus(void)
191 if (ARMING_FLAG(ARMED
)) {
194 // Check if the power on arming grace time has elapsed
195 if ((getArmingDisableFlags() & ARMING_DISABLED_BOOT_GRACE_TIME
) && (millis() >= systemConfig()->powerOnArmingGraceTime
* 1000)) {
196 // If so, unset the grace time arming disable flag
197 unsetArmingDisabled(ARMING_DISABLED_BOOT_GRACE_TIME
);
200 // Clear the crash flip active status
201 flipOverAfterCrashMode
= false;
203 // If switch is used for arming then check it is not defaulting to on when the RX link recovers from a fault
204 if (!isUsingSticksForArming()) {
205 static bool hadRx
= false;
206 const bool haveRx
= rxIsReceivingSignal();
208 const bool justGotRxBack
= !hadRx
&& haveRx
;
210 if (justGotRxBack
&& IS_RC_MODE_ACTIVE(BOXARM
)) {
211 // If the RX has just started to receive a signal again and the arm switch is on, apply arming restriction
212 setArmingDisabled(ARMING_DISABLED_BAD_RX_RECOVERY
);
213 } else if (haveRx
&& !IS_RC_MODE_ACTIVE(BOXARM
)) {
214 // If RX signal is OK and the arm switch is off, remove arming restriction
215 unsetArmingDisabled(ARMING_DISABLED_BAD_RX_RECOVERY
);
221 if (IS_RC_MODE_ACTIVE(BOXFAILSAFE
)) {
222 setArmingDisabled(ARMING_DISABLED_BOXFAILSAFE
);
224 unsetArmingDisabled(ARMING_DISABLED_BOXFAILSAFE
);
227 if (calculateThrottleStatus() != THROTTLE_LOW
) {
228 setArmingDisabled(ARMING_DISABLED_THROTTLE
);
230 unsetArmingDisabled(ARMING_DISABLED_THROTTLE
);
233 if (!STATE(SMALL_ANGLE
) && !IS_RC_MODE_ACTIVE(BOXFLIPOVERAFTERCRASH
)) {
234 setArmingDisabled(ARMING_DISABLED_ANGLE
);
236 unsetArmingDisabled(ARMING_DISABLED_ANGLE
);
239 if (averageSystemLoadPercent
> 100) {
240 setArmingDisabled(ARMING_DISABLED_LOAD
);
242 unsetArmingDisabled(ARMING_DISABLED_LOAD
);
245 if (isCalibrating()) {
246 setArmingDisabled(ARMING_DISABLED_CALIBRATING
);
248 unsetArmingDisabled(ARMING_DISABLED_CALIBRATING
);
251 if (isModeActivationConditionPresent(BOXPREARM
)) {
252 if (IS_RC_MODE_ACTIVE(BOXPREARM
) && !ARMING_FLAG(WAS_ARMED_WITH_PREARM
)) {
253 unsetArmingDisabled(ARMING_DISABLED_NOPREARM
);
255 setArmingDisabled(ARMING_DISABLED_NOPREARM
);
259 #ifdef USE_GPS_RESCUE
260 if (isModeActivationConditionPresent(BOXGPSRESCUE
)) {
261 if (rescueState
.sensor
.numSat
< gpsRescueConfig()->minSats
) {
262 setArmingDisabled(ARMING_DISABLED_GPS
);
264 unsetArmingDisabled(ARMING_DISABLED_GPS
);
269 if (IS_RC_MODE_ACTIVE(BOXPARALYZE
) && paralyzeModeAllowed
) {
270 setArmingDisabled(ARMING_DISABLED_PARALYZE
);
271 dispatchAdd(&preventModeChangesDispatchEntry
, PARALYZE_PREVENT_MODE_CHANGES_DELAY_US
);
274 if (!isUsingSticksForArming()) {
275 /* Ignore ARMING_DISABLED_CALIBRATING if we are going to calibrate gyro on first arm */
276 bool ignoreGyro
= armingConfig()->gyro_cal_on_first_arm
277 && !(getArmingDisableFlags() & ~(ARMING_DISABLED_ARM_SWITCH
| ARMING_DISABLED_CALIBRATING
));
279 /* Ignore ARMING_DISABLED_THROTTLE (once arm switch is on) if we are in 3D mode */
280 bool ignoreThrottle
= feature(FEATURE_3D
)
281 && !IS_RC_MODE_ACTIVE(BOX3D
)
282 && !flight3DConfig()->switched_mode3d
283 && !(getArmingDisableFlags() & ~(ARMING_DISABLED_ARM_SWITCH
| ARMING_DISABLED_THROTTLE
));
285 #ifdef USE_RUNAWAY_TAKEOFF
286 if (!IS_RC_MODE_ACTIVE(BOXARM
)) {
287 unsetArmingDisabled(ARMING_DISABLED_RUNAWAY_TAKEOFF
);
291 // If arming is disabled and the ARM switch is on
292 if (isArmingDisabled()
295 && IS_RC_MODE_ACTIVE(BOXARM
)) {
296 setArmingDisabled(ARMING_DISABLED_ARM_SWITCH
);
297 } else if (!IS_RC_MODE_ACTIVE(BOXARM
)) {
298 unsetArmingDisabled(ARMING_DISABLED_ARM_SWITCH
);
302 if (isArmingDisabled()) {
311 // Check if entering into paralyze mode can be allowed regardless of arming status
312 if (!IS_RC_MODE_ACTIVE(BOXPARALYZE
) && !paralyzeModeAllowed
) {
313 paralyzeModeAllowed
= true;
319 if (ARMING_FLAG(ARMED
)) {
320 DISABLE_ARMING_FLAG(ARMED
);
323 if (blackboxConfig()->device
&& blackboxConfig()->mode
!= BLACKBOX_MODE_ALWAYS_ON
) { // Close the log upon disarm except when logging mode is ALWAYS ON
329 if (isMotorProtocolDshot() && isModeActivationConditionPresent(BOXFLIPOVERAFTERCRASH
) && !feature(FEATURE_3D
)) {
330 flipOverAfterCrashMode
= false;
331 if (!feature(FEATURE_3D
)) {
332 pwmWriteDshotCommand(ALL_MOTORS
, getMotorCount(), DSHOT_CMD_SPIN_DIRECTION_NORMAL
, false);
336 // if ARMING_DISABLED_RUNAWAY_TAKEOFF is set then we want to play it's beep pattern instead
337 if (!(getArmingDisableFlags() & ARMING_DISABLED_RUNAWAY_TAKEOFF
)) {
338 beeper(BEEPER_DISARMING
); // emit disarm tone
345 if (armingConfig()->gyro_cal_on_first_arm
) {
346 gyroStartCalibration(true);
349 updateArmingStatus();
351 if (!isArmingDisabled()) {
352 if (ARMING_FLAG(ARMED
)) {
356 if (isMotorProtocolDshot() && isModeActivationConditionPresent(BOXFLIPOVERAFTERCRASH
)) {
357 if (!IS_RC_MODE_ACTIVE(BOXFLIPOVERAFTERCRASH
)) {
358 flipOverAfterCrashMode
= false;
359 if (!feature(FEATURE_3D
)) {
360 pwmWriteDshotCommand(ALL_MOTORS
, getMotorCount(), DSHOT_CMD_SPIN_DIRECTION_NORMAL
, false);
363 flipOverAfterCrashMode
= true;
364 #ifdef USE_RUNAWAY_TAKEOFF
365 runawayTakeoffCheckDisabled
= false;
367 if (!feature(FEATURE_3D
)) {
368 pwmWriteDshotCommand(ALL_MOTORS
, getMotorCount(), DSHOT_CMD_SPIN_DIRECTION_REVERSED
, false);
374 ENABLE_ARMING_FLAG(ARMED
);
375 ENABLE_ARMING_FLAG(WAS_EVER_ARMED
);
377 #ifdef USE_ACRO_TRAINER
378 pidAcroTrainerInit();
379 #endif // USE_ACRO_TRAINER
381 if (isModeActivationConditionPresent(BOXPREARM
)) {
382 ENABLE_ARMING_FLAG(WAS_ARMED_WITH_PREARM
);
384 imuQuaternionHeadfreeOffsetSet();
386 disarmAt
= millis() + armingConfig()->auto_disarm_delay
* 1000; // start disarm timeout, will be extended when throttle is nonzero
388 lastArmingDisabledReason
= 0;
390 //beep to indicate arming
392 if (feature(FEATURE_GPS
) && STATE(GPS_FIX
) && gpsSol
.numSat
>= 5) {
393 beeper(BEEPER_ARMING_GPS_FIX
);
395 beeper(BEEPER_ARMING
);
398 beeper(BEEPER_ARMING
);
401 #ifdef USE_RUNAWAY_TAKEOFF
402 runawayTakeoffDeactivateUs
= 0;
403 runawayTakeoffAccumulatedUs
= 0;
404 runawayTakeoffTriggerUs
= 0;
407 if (!isFirstArmingGyroCalibrationRunning()) {
408 int armingDisabledReason
= ffs(getArmingDisableFlags());
409 if (lastArmingDisabledReason
!= armingDisabledReason
) {
410 lastArmingDisabledReason
= armingDisabledReason
;
412 beeperWarningBeeps(armingDisabledReason
);
418 // Automatic ACC Offset Calibration
419 bool AccInflightCalibrationArmed
= false;
420 bool AccInflightCalibrationMeasurementDone
= false;
421 bool AccInflightCalibrationSavetoEEProm
= false;
422 bool AccInflightCalibrationActive
= false;
423 uint16_t InflightcalibratingA
= 0;
425 void handleInflightCalibrationStickPosition(void)
427 if (AccInflightCalibrationMeasurementDone
) {
428 // trigger saving into eeprom after landing
429 AccInflightCalibrationMeasurementDone
= false;
430 AccInflightCalibrationSavetoEEProm
= true;
432 AccInflightCalibrationArmed
= !AccInflightCalibrationArmed
;
433 if (AccInflightCalibrationArmed
) {
434 beeper(BEEPER_ACC_CALIBRATION
);
436 beeper(BEEPER_ACC_CALIBRATION_FAIL
);
441 static void updateInflightCalibrationState(void)
443 if (AccInflightCalibrationArmed
&& ARMING_FLAG(ARMED
) && rcData
[THROTTLE
] > rxConfig()->mincheck
&& !IS_RC_MODE_ACTIVE(BOXARM
)) { // Copter is airborne and you are turning it off via boxarm : start measurement
444 InflightcalibratingA
= 50;
445 AccInflightCalibrationArmed
= false;
447 if (IS_RC_MODE_ACTIVE(BOXCALIB
)) { // Use the Calib Option to activate : Calib = TRUE measurement started, Land and Calib = 0 measurement stored
448 if (!AccInflightCalibrationActive
&& !AccInflightCalibrationMeasurementDone
)
449 InflightcalibratingA
= 50;
450 AccInflightCalibrationActive
= true;
451 } else if (AccInflightCalibrationMeasurementDone
&& !ARMING_FLAG(ARMED
)) {
452 AccInflightCalibrationMeasurementDone
= false;
453 AccInflightCalibrationSavetoEEProm
= true;
457 #if defined(USE_GPS) || defined(USE_MAG)
458 void updateMagHold(void)
460 if (ABS(rcCommand
[YAW
]) < 15 && FLIGHT_MODE(MAG_MODE
)) {
461 int16_t dif
= DECIDEGREES_TO_DEGREES(attitude
.values
.yaw
) - magHold
;
466 dif
*= -GET_DIRECTION(rcControlsConfig()->yaw_control_reversed
);
467 if (STATE(SMALL_ANGLE
))
468 rcCommand
[YAW
] -= dif
* currentPidProfile
->pid
[PID_MAG
].P
/ 30; // 18 deg
470 magHold
= DECIDEGREES_TO_DEGREES(attitude
.values
.yaw
);
474 #ifdef USE_VTX_CONTROL
475 static bool canUpdateVTX(void)
477 #ifdef USE_VTX_RTC6705
478 return vtxRTC6705CanUpdate();
484 #ifdef USE_RUNAWAY_TAKEOFF
485 // determine if the R/P/Y stick deflection exceeds the specified limit - integer math is good enough here.
486 bool areSticksActive(uint8_t stickPercentLimit
)
488 for (int axis
= FD_ROLL
; axis
<= FD_YAW
; axis
++) {
489 const uint8_t deadband
= axis
== FD_YAW
? rcControlsConfig()->yaw_deadband
: rcControlsConfig()->deadband
;
490 uint8_t stickPercent
= 0;
491 if ((rcData
[axis
] >= PWM_RANGE_MAX
) || (rcData
[axis
] <= PWM_RANGE_MIN
)) {
494 if (rcData
[axis
] > (rxConfig()->midrc
+ deadband
)) {
495 stickPercent
= ((rcData
[axis
] - rxConfig()->midrc
- deadband
) * 100) / (PWM_RANGE_MAX
- rxConfig()->midrc
- deadband
);
496 } else if (rcData
[axis
] < (rxConfig()->midrc
- deadband
)) {
497 stickPercent
= ((rxConfig()->midrc
- deadband
- rcData
[axis
]) * 100) / (rxConfig()->midrc
- deadband
- PWM_RANGE_MIN
);
500 if (stickPercent
>= stickPercentLimit
) {
508 // allow temporarily disabling runaway takeoff prevention if we are connected
509 // to the configurator and the ARMING_DISABLED_MSP flag is cleared.
510 void runawayTakeoffTemporaryDisable(uint8_t disableFlag
)
512 runawayTakeoffTemporarilyDisabled
= disableFlag
;
517 // calculate the throttle stick percent - integer math is good enough here.
518 uint8_t calculateThrottlePercent(void)
521 if (feature(FEATURE_3D
)
522 && !IS_RC_MODE_ACTIVE(BOX3D
)
523 && !flight3DConfig()->switched_mode3d
) {
525 if ((rcData
[THROTTLE
] >= PWM_RANGE_MAX
) || (rcData
[THROTTLE
] <= PWM_RANGE_MIN
)) {
528 if (rcData
[THROTTLE
] > (rxConfig()->midrc
+ flight3DConfig()->deadband3d_throttle
)) {
529 ret
= ((rcData
[THROTTLE
] - rxConfig()->midrc
- flight3DConfig()->deadband3d_throttle
) * 100) / (PWM_RANGE_MAX
- rxConfig()->midrc
- flight3DConfig()->deadband3d_throttle
);
530 } else if (rcData
[THROTTLE
] < (rxConfig()->midrc
- flight3DConfig()->deadband3d_throttle
)) {
531 ret
= ((rxConfig()->midrc
- flight3DConfig()->deadband3d_throttle
- rcData
[THROTTLE
]) * 100) / (rxConfig()->midrc
- flight3DConfig()->deadband3d_throttle
- PWM_RANGE_MIN
);
535 ret
= constrain(((rcData
[THROTTLE
] - rxConfig()->mincheck
) * 100) / (PWM_RANGE_MAX
- rxConfig()->mincheck
), 0, 100);
542 * processRx called from taskUpdateRxMain
544 bool processRx(timeUs_t currentTimeUs
)
546 static bool armedBeeperOn
= false;
547 static bool airmodeIsActivated
;
548 static bool sharedPortTelemetryEnabled
= false;
550 if (!calculateRxChannelsAndUpdateFailsafe(currentTimeUs
)) {
554 // in 3D mode, we need to be able to disarm by switch at any time
555 if (feature(FEATURE_3D
)) {
556 if (!IS_RC_MODE_ACTIVE(BOXARM
))
560 updateRSSI(currentTimeUs
);
562 if (currentTimeUs
> FAILSAFE_POWER_ON_DELAY_US
&& !failsafeIsMonitoring()) {
563 failsafeStartMonitoring();
565 failsafeUpdateState();
567 const throttleStatus_e throttleStatus
= calculateThrottleStatus();
568 const uint8_t throttlePercent
= calculateThrottlePercent();
570 if (isAirmodeActive() && ARMING_FLAG(ARMED
)) {
571 if (throttlePercent
>= rxConfig()->airModeActivateThreshold
) {
572 airmodeIsActivated
= true; // Prevent Iterm from being reset
575 airmodeIsActivated
= false;
578 /* In airmode Iterm should be prevented to grow when Low thottle and Roll + Pitch Centered.
579 This is needed to prevent Iterm winding on the ground, but keep full stabilisation on 0 throttle while in air */
580 if (throttleStatus
== THROTTLE_LOW
&& !airmodeIsActivated
) {
582 if (currentPidProfile
->pidAtMinThrottle
)
583 pidStabilisationState(PID_STABILISATION_ON
);
585 pidStabilisationState(PID_STABILISATION_OFF
);
587 pidStabilisationState(PID_STABILISATION_ON
);
590 #ifdef USE_RUNAWAY_TAKEOFF
591 // If runaway_takeoff_prevention is enabled, accumulate the amount of time that throttle
592 // is above runaway_takeoff_deactivate_throttle with the any of the R/P/Y sticks deflected
593 // to at least runaway_takeoff_stick_percent percent while the pidSum on all axis is kept low.
594 // Once the amount of accumulated time exceeds runaway_takeoff_deactivate_delay then disable
595 // prevention for the remainder of the battery.
597 if (ARMING_FLAG(ARMED
)
598 && pidConfig()->runaway_takeoff_prevention
599 && !runawayTakeoffCheckDisabled
600 && !flipOverAfterCrashMode
601 && !runawayTakeoffTemporarilyDisabled
602 && !STATE(FIXED_WING
)) {
604 // Determine if we're in "flight"
606 // - throttle over runaway_takeoff_deactivate_throttle_percent
607 // - sticks are active and have deflection greater than runaway_takeoff_deactivate_stick_percent
608 // - pidSum on all axis is less then runaway_takeoff_deactivate_pidlimit
609 bool inStableFlight
= false;
610 if (!feature(FEATURE_MOTOR_STOP
) || isAirmodeActive() || (throttleStatus
!= THROTTLE_LOW
)) { // are motors running?
611 const uint8_t lowThrottleLimit
= pidConfig()->runaway_takeoff_deactivate_throttle
;
612 const uint8_t midThrottleLimit
= constrain(lowThrottleLimit
* 2, lowThrottleLimit
* 2, RUNAWAY_TAKEOFF_HIGH_THROTTLE_PERCENT
);
613 if ((((throttlePercent
>= lowThrottleLimit
) && areSticksActive(RUNAWAY_TAKEOFF_DEACTIVATE_STICK_PERCENT
)) || (throttlePercent
>= midThrottleLimit
))
614 && (fabsf(pidData
[FD_PITCH
].Sum
) < RUNAWAY_TAKEOFF_DEACTIVATE_PIDSUM_LIMIT
)
615 && (fabsf(pidData
[FD_ROLL
].Sum
) < RUNAWAY_TAKEOFF_DEACTIVATE_PIDSUM_LIMIT
)
616 && (fabsf(pidData
[FD_YAW
].Sum
) < RUNAWAY_TAKEOFF_DEACTIVATE_PIDSUM_LIMIT
)) {
618 inStableFlight
= true;
619 if (runawayTakeoffDeactivateUs
== 0) {
620 runawayTakeoffDeactivateUs
= currentTimeUs
;
625 // If we're in flight, then accumulate the time and deactivate once it exceeds runaway_takeoff_deactivate_delay milliseconds
626 if (inStableFlight
) {
627 if (runawayTakeoffDeactivateUs
== 0) {
628 runawayTakeoffDeactivateUs
= currentTimeUs
;
630 uint16_t deactivateDelay
= pidConfig()->runaway_takeoff_deactivate_delay
;
631 // at high throttle levels reduce deactivation delay by 50%
632 if (throttlePercent
>= RUNAWAY_TAKEOFF_HIGH_THROTTLE_PERCENT
) {
633 deactivateDelay
= deactivateDelay
/ 2;
635 if ((cmpTimeUs(currentTimeUs
, runawayTakeoffDeactivateUs
) + runawayTakeoffAccumulatedUs
) > deactivateDelay
* 1000) {
636 runawayTakeoffCheckDisabled
= true;
640 if (runawayTakeoffDeactivateUs
!= 0) {
641 runawayTakeoffAccumulatedUs
+= cmpTimeUs(currentTimeUs
, runawayTakeoffDeactivateUs
);
643 runawayTakeoffDeactivateUs
= 0;
645 if (runawayTakeoffDeactivateUs
== 0) {
646 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_DELAY
, DEBUG_RUNAWAY_TAKEOFF_FALSE
);
647 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_TIME
, runawayTakeoffAccumulatedUs
/ 1000);
649 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_DELAY
, DEBUG_RUNAWAY_TAKEOFF_TRUE
);
650 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_TIME
, (cmpTimeUs(currentTimeUs
, runawayTakeoffDeactivateUs
) + runawayTakeoffAccumulatedUs
) / 1000);
653 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_DELAY
, DEBUG_RUNAWAY_TAKEOFF_FALSE
);
654 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_DEACTIVATING_TIME
, DEBUG_RUNAWAY_TAKEOFF_FALSE
);
658 // When armed and motors aren't spinning, do beeps and then disarm
659 // board after delay so users without buzzer won't lose fingers.
660 // mixTable constrains motor commands, so checking throttleStatus is enough
661 if (ARMING_FLAG(ARMED
)
662 && feature(FEATURE_MOTOR_STOP
)
663 && !STATE(FIXED_WING
)
664 && !feature(FEATURE_3D
)
665 && !isAirmodeActive()
667 if (isUsingSticksForArming()) {
668 if (throttleStatus
== THROTTLE_LOW
) {
669 if (armingConfig()->auto_disarm_delay
!= 0
670 && (int32_t)(disarmAt
- millis()) < 0
672 // auto-disarm configured and delay is over
674 armedBeeperOn
= false;
676 // still armed; do warning beeps while armed
677 beeper(BEEPER_ARMED
);
678 armedBeeperOn
= true;
681 // throttle is not low
682 if (armingConfig()->auto_disarm_delay
!= 0) {
683 // extend disarm time
684 disarmAt
= millis() + armingConfig()->auto_disarm_delay
* 1000;
689 armedBeeperOn
= false;
693 // arming is via AUX switch; beep while throttle low
694 if (throttleStatus
== THROTTLE_LOW
) {
695 beeper(BEEPER_ARMED
);
696 armedBeeperOn
= true;
697 } else if (armedBeeperOn
) {
699 armedBeeperOn
= false;
704 processRcStickPositions();
706 if (feature(FEATURE_INFLIGHT_ACC_CAL
)) {
707 updateInflightCalibrationState();
710 updateActivatedModes();
713 /* Enable beep warning when the crash flip mode is active */
714 if (isMotorProtocolDshot() && isModeActivationConditionPresent(BOXFLIPOVERAFTERCRASH
) && IS_RC_MODE_ACTIVE(BOXFLIPOVERAFTERCRASH
)) {
715 beeper(BEEPER_CRASH_FLIP_MODE
);
720 updateAdjustmentStates();
721 processRcAdjustments(currentControlRateProfile
);
724 bool canUseHorizonMode
= true;
726 if ((IS_RC_MODE_ACTIVE(BOXANGLE
) || failsafeIsActive()) && (sensors(SENSOR_ACC
))) {
727 // bumpless transfer to Level mode
728 canUseHorizonMode
= false;
730 if (!FLIGHT_MODE(ANGLE_MODE
)) {
731 ENABLE_FLIGHT_MODE(ANGLE_MODE
);
734 DISABLE_FLIGHT_MODE(ANGLE_MODE
); // failsafe support
737 if (IS_RC_MODE_ACTIVE(BOXHORIZON
) && canUseHorizonMode
) {
739 DISABLE_FLIGHT_MODE(ANGLE_MODE
);
741 if (!FLIGHT_MODE(HORIZON_MODE
)) {
742 ENABLE_FLIGHT_MODE(HORIZON_MODE
);
745 DISABLE_FLIGHT_MODE(HORIZON_MODE
);
748 if (IS_RC_MODE_ACTIVE(BOXGPSRESCUE
) || (failsafeIsActive() && failsafeConfig()->failsafe_procedure
== FAILSAFE_PROCEDURE_GPS_RESCUE
)) {
749 if (!FLIGHT_MODE(GPS_RESCUE_MODE
)) {
750 ENABLE_FLIGHT_MODE(GPS_RESCUE_MODE
);
753 DISABLE_FLIGHT_MODE(GPS_RESCUE_MODE
);
756 if (FLIGHT_MODE(ANGLE_MODE
) || FLIGHT_MODE(HORIZON_MODE
)) {
758 // increase frequency of attitude task to reduce drift when in angle or horizon mode
759 rescheduleTask(TASK_ATTITUDE
, TASK_PERIOD_HZ(500));
762 rescheduleTask(TASK_ATTITUDE
, TASK_PERIOD_HZ(100));
765 if (!IS_RC_MODE_ACTIVE(BOXPREARM
) && ARMING_FLAG(WAS_ARMED_WITH_PREARM
)) {
766 DISABLE_ARMING_FLAG(WAS_ARMED_WITH_PREARM
);
769 #if defined(USE_ACC) || defined(USE_MAG)
770 if (sensors(SENSOR_ACC
) || sensors(SENSOR_MAG
)) {
771 #if defined(USE_GPS) || defined(USE_MAG)
772 if (IS_RC_MODE_ACTIVE(BOXMAG
)) {
773 if (!FLIGHT_MODE(MAG_MODE
)) {
774 ENABLE_FLIGHT_MODE(MAG_MODE
);
775 magHold
= DECIDEGREES_TO_DEGREES(attitude
.values
.yaw
);
778 DISABLE_FLIGHT_MODE(MAG_MODE
);
781 if (IS_RC_MODE_ACTIVE(BOXHEADFREE
)) {
782 if (!FLIGHT_MODE(HEADFREE_MODE
)) {
783 ENABLE_FLIGHT_MODE(HEADFREE_MODE
);
786 DISABLE_FLIGHT_MODE(HEADFREE_MODE
);
788 if (IS_RC_MODE_ACTIVE(BOXHEADADJ
)) {
789 if (imuQuaternionHeadfreeOffsetSet()){
790 beeper(BEEPER_RX_SET
);
796 if (IS_RC_MODE_ACTIVE(BOXPASSTHRU
)) {
797 ENABLE_FLIGHT_MODE(PASSTHRU_MODE
);
799 DISABLE_FLIGHT_MODE(PASSTHRU_MODE
);
802 if (mixerConfig()->mixerMode
== MIXER_FLYING_WING
|| mixerConfig()->mixerMode
== MIXER_AIRPLANE
) {
803 DISABLE_FLIGHT_MODE(HEADFREE_MODE
);
807 if (feature(FEATURE_TELEMETRY
)) {
808 bool enableSharedPortTelemetry
= (!isModeActivationConditionPresent(BOXTELEMETRY
) && ARMING_FLAG(ARMED
)) || (isModeActivationConditionPresent(BOXTELEMETRY
) && IS_RC_MODE_ACTIVE(BOXTELEMETRY
));
809 if (enableSharedPortTelemetry
&& !sharedPortTelemetryEnabled
) {
810 mspSerialReleaseSharedTelemetryPorts();
811 telemetryCheckState();
813 sharedPortTelemetryEnabled
= true;
814 } else if (!enableSharedPortTelemetry
&& sharedPortTelemetryEnabled
) {
815 // the telemetry state must be checked immediately so that shared serial ports are released.
816 telemetryCheckState();
817 mspSerialAllocatePorts();
819 sharedPortTelemetryEnabled
= false;
824 #ifdef USE_VTX_CONTROL
825 vtxUpdateActivatedChannel();
827 if (canUpdateVTX()) {
828 handleVTXControlButton();
832 #ifdef USE_ACRO_TRAINER
833 pidSetAcroTrainerState(IS_RC_MODE_ACTIVE(BOXACROTRAINER
) && sensors(SENSOR_ACC
));
834 #endif // USE_ACRO_TRAINER
839 static FAST_CODE
void subTaskPidController(timeUs_t currentTimeUs
)
841 uint32_t startTime
= 0;
842 if (debugMode
== DEBUG_PIDLOOP
) {startTime
= micros();}
843 // PID - note this is function pointer set by setPIDController()
844 pidController(currentPidProfile
, &accelerometerConfig()->accelerometerTrims
, currentTimeUs
);
845 DEBUG_SET(DEBUG_PIDLOOP
, 1, micros() - startTime
);
847 #ifdef USE_RUNAWAY_TAKEOFF
848 // Check to see if runaway takeoff detection is active (anti-taz), the pidSum is over the threshold,
849 // and gyro rate for any axis is above the limit for at least the activate delay period.
850 // If so, disarm for safety
851 if (ARMING_FLAG(ARMED
)
852 && !STATE(FIXED_WING
)
853 && pidConfig()->runaway_takeoff_prevention
854 && !runawayTakeoffCheckDisabled
855 && !flipOverAfterCrashMode
856 && !runawayTakeoffTemporarilyDisabled
857 && (!feature(FEATURE_MOTOR_STOP
) || isAirmodeActive() || (calculateThrottleStatus() != THROTTLE_LOW
))) {
859 if (((fabsf(pidData
[FD_PITCH
].Sum
) >= RUNAWAY_TAKEOFF_PIDSUM_THRESHOLD
)
860 || (fabsf(pidData
[FD_ROLL
].Sum
) >= RUNAWAY_TAKEOFF_PIDSUM_THRESHOLD
)
861 || (fabsf(pidData
[FD_YAW
].Sum
) >= RUNAWAY_TAKEOFF_PIDSUM_THRESHOLD
))
862 && ((ABS(gyroAbsRateDps(FD_PITCH
)) > RUNAWAY_TAKEOFF_GYRO_LIMIT_RP
)
863 || (ABS(gyroAbsRateDps(FD_ROLL
)) > RUNAWAY_TAKEOFF_GYRO_LIMIT_RP
)
864 || (ABS(gyroAbsRateDps(FD_YAW
)) > RUNAWAY_TAKEOFF_GYRO_LIMIT_YAW
))) {
866 if (runawayTakeoffTriggerUs
== 0) {
867 runawayTakeoffTriggerUs
= currentTimeUs
+ RUNAWAY_TAKEOFF_ACTIVATE_DELAY
;
868 } else if (currentTimeUs
> runawayTakeoffTriggerUs
) {
869 setArmingDisabled(ARMING_DISABLED_RUNAWAY_TAKEOFF
);
873 runawayTakeoffTriggerUs
= 0;
875 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_ENABLED_STATE
, DEBUG_RUNAWAY_TAKEOFF_TRUE
);
876 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_ACTIVATING_DELAY
, runawayTakeoffTriggerUs
== 0 ? DEBUG_RUNAWAY_TAKEOFF_FALSE
: DEBUG_RUNAWAY_TAKEOFF_TRUE
);
878 runawayTakeoffTriggerUs
= 0;
879 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_ENABLED_STATE
, DEBUG_RUNAWAY_TAKEOFF_FALSE
);
880 DEBUG_SET(DEBUG_RUNAWAY_TAKEOFF
, DEBUG_RUNAWAY_TAKEOFF_ACTIVATING_DELAY
, DEBUG_RUNAWAY_TAKEOFF_FALSE
);
886 if (isModeActivationConditionPresent(BOXPIDAUDIO
)) {
892 static FAST_CODE_NOINLINE
void subTaskMainSubprocesses(timeUs_t currentTimeUs
)
894 uint32_t startTime
= 0;
895 if (debugMode
== DEBUG_PIDLOOP
) {
896 startTime
= micros();
899 // Read out gyro temperature if used for telemmetry
900 if (feature(FEATURE_TELEMETRY
)) {
901 gyroReadTemperature();
905 if (sensors(SENSOR_MAG
)) {
910 #ifdef USE_GPS_RESCUE
911 updateGPSRescueState();
919 DEBUG_SET(DEBUG_USB
, 0, usbCableIsInserted());
920 DEBUG_SET(DEBUG_USB
, 1, usbVcpIsConnected());
924 if (!cliMode
&& blackboxConfig()->device
) {
925 blackboxUpdate(currentTimeUs
);
928 UNUSED(currentTimeUs
);
931 #ifdef USE_TRANSPONDER
932 transponderUpdate(currentTimeUs
);
934 DEBUG_SET(DEBUG_PIDLOOP
, 3, micros() - startTime
);
937 static FAST_CODE
void subTaskMotorUpdate(timeUs_t currentTimeUs
)
939 uint32_t startTime
= 0;
940 if (debugMode
== DEBUG_CYCLETIME
) {
941 startTime
= micros();
942 static uint32_t previousMotorUpdateTime
;
943 const uint32_t currentDeltaTime
= startTime
- previousMotorUpdateTime
;
944 debug
[2] = currentDeltaTime
;
945 debug
[3] = currentDeltaTime
- targetPidLooptime
;
946 previousMotorUpdateTime
= startTime
;
947 } else if (debugMode
== DEBUG_PIDLOOP
) {
948 startTime
= micros();
951 mixTable(currentTimeUs
, currentPidProfile
->vbatPidCompensation
);
954 // motor outputs are used as sources for servo mixing, so motors must be calculated using mixTable() before servos.
955 if (isMixerUsingServos()) {
962 DEBUG_SET(DEBUG_PIDLOOP
, 2, micros() - startTime
);
965 static FAST_CODE_NOINLINE
void subTaskRcCommand(timeUs_t currentTimeUs
)
968 // If we're armed, at minimum throttle, and we do arming via the
969 // sticks, do not process yaw input from the rx. We do this so the
970 // motors do not spin up while we are trying to arm or disarm.
971 // Allow yaw control for tricopters if the user wants the servo to move even when unarmed.
972 if (isUsingSticksForArming() && rcData
[THROTTLE
] <= rxConfig()->mincheck
973 #ifndef USE_QUAD_MIXER_ONLY
975 && !((mixerConfig()->mixerMode
== MIXER_TRI
|| mixerConfig()->mixerMode
== MIXER_CUSTOM_TRI
) && servoConfig()->tri_unarmed_servo
)
977 && mixerConfig()->mixerMode
!= MIXER_AIRPLANE
978 && mixerConfig()->mixerMode
!= MIXER_FLYING_WING
984 if (throttleCorrectionConfig()->throttle_correction_value
&& (FLIGHT_MODE(ANGLE_MODE
) || FLIGHT_MODE(HORIZON_MODE
))) {
985 rcCommand
[THROTTLE
] += calculateThrottleAngleCorrection(throttleCorrectionConfig()->throttle_correction_value
);
989 UNUSED(currentTimeUs
);
992 // Function for loop trigger
993 FAST_CODE
void taskMainPidLoop(timeUs_t currentTimeUs
)
995 static uint32_t pidUpdateCounter
= 0;
997 #if defined(SIMULATOR_BUILD) && defined(SIMULATOR_GYROPID_SYNC)
998 if (lockMainPID() != 0) return;
1001 // DEBUG_PIDLOOP, timings for:
1003 // 1 - subTaskPidController()
1004 // 2 - subTaskMotorUpdate()
1005 // 3 - subTaskMainSubprocesses()
1006 gyroUpdate(currentTimeUs
);
1007 DEBUG_SET(DEBUG_PIDLOOP
, 0, micros() - currentTimeUs
);
1009 if (pidUpdateCounter
++ % pidConfig()->pid_process_denom
== 0) {
1010 subTaskRcCommand(currentTimeUs
);
1011 subTaskPidController(currentTimeUs
);
1012 subTaskMotorUpdate(currentTimeUs
);
1013 subTaskMainSubprocesses(currentTimeUs
);
1016 if (debugMode
== DEBUG_CYCLETIME
) {
1017 debug
[0] = getTaskDeltaTime(TASK_SELF
);
1018 debug
[1] = averageSystemLoadPercent
;
1023 bool isFlipOverAfterCrashMode(void)
1025 return flipOverAfterCrashMode
;