Skip to content

Commit 6c60e9c

Browse files
committed
Sub:add crash check page
1 parent a70768c commit 6c60e9c

6 files changed

+38
-15
lines changed

sub/source/docs/crash_check.rst

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
.. _crash_check:
2+
3+
===========
4+
Crash Check
5+
===========
6+
7+
Sub includes a crash check which can disarm the motors in cases where the vehicle is likely out of control and has hit something. This reduces damage to the vehicle and its surroundings, and also reduces the chance of injury to people or creatures nearby.
8+
9+
When will the crash check disarm the motors?
10+
============================================
11+
When all the following are true for 2 full seconds:
12+
13+
* The :ref:`FS_CRASH_CHECK<FS_CRASH_CHECK>` = 2 ( A value of "0" disables the check while "1" will send only a warning to the GCS)
14+
* The vehicle is armed
15+
* The current flight mode is *not* ACRO or MANUAL
16+
* The actual lean angle has diverged from the desired lean angle (perhaps input by the pilot) by more than 30 degrees.
17+
18+
What will happen when the crash check fires?
19+
============================================
20+
21+
* The motors will disarm
22+
* "Crash: Disarming" will be displayed on the Ground Station
23+
* A crash event will be written to the dataflash logs (look for EV, 12 in the logs)
24+
25+
How and when should the crash check be disabled?
26+
================================================
27+
In general the crash check should be left enabled but if the vehicle is likely to suffer from lean angle errors of over 30 degrees for a second or more it should be disabled.

sub/source/docs/failsafe-battery.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ When the failsafe is triggered:
2424

2525
- Buzzer will play a loud low-battery alarm
2626
- LEDs will flash yellow
27-
- "Low Battery!" will be displayed on the ground stations HUD (if telemetry is connected)
27+
- "Low Battery!" will be displayed on the ground station's HUD (if telemetry is connected)
2828

2929
Then one of the following will happen, depending on :ref:`BATT_FS_LOW_ACT<BATT_FS_LOW_ACT>`:
3030

sub/source/docs/failsafe-landing-page.rst

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,11 @@ Sub has a number of failsafe mechanisms to ease vehicle recovery/prevent wanderi
1414
Radio Failsafe <radio-failsafe>
1515
Battery Failsafe <failsafe-battery>
1616
GCS Failsafe <gcs-failsafe>
17-
Pilot Control Failsafe <pilot-failsafe>
18-
Internal Leak Failsafe<internal-leak>
19-
Internal Pressure Failsafe<internal-pressure>
17+
Pilot Control Failsafe <pilot-control-failsafe>
18+
Internal Leak Failsafe <internal-leak-failsafe>
19+
Internal Pressure Failsafe <internal-pressure-failsafe>
20+
Internal Temperature Failsafe <internal-temperature-failsafe>
21+
EKF Failsafe <ekf-inav-failsafe>
22+
Crash Check <crash_check>
23+
Independent Watchdog <common-watchdog>
2024

21-
EKF Failsafe <ekf-inav-failsafe>
22-
Vibration Failsafe <vibration-failsafe>
23-
Terrain Data Loss Failsafe <terrain-following>
24-
Crash Check <crash_check>
25-
26-
Internal Pressure <internal-pressure>
27-
Internal Temp <internal-temp>
28-
Independent Watchdog <common-watchdog>

sub/source/docs/gcs-failsafe.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The following situations can cause a loss of GCS MAVLink heartbeat, triggering a
2020

2121
What will happen
2222
================
23-
When a GCS failsafe is triggered, the sub can be configured via parameters to do nothing, send the GCS a warning message, disarm, or change to ALTHOLD or SURFACE modes.
23+
When a GCS failsafe is triggered, the sub can be configured via parameters to do nothing, attempt to send the GCS a warning message, disarm, or change to ALTHOLD or SURFACE modes.
2424

2525
If the failsafe clears (i.e. GCS reconnects and MAVLink heartbeat is restored) the sub will remain in its failsafe mode. It will **not** automatically return to the flight mode that was active before the failsafe was triggered, if it was changed.
2626

sub/source/docs/internal-leak-failsafe.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ For the remainder of this article, the first leak detector's parameters will use
1010

1111
When the failsafe will trigger
1212
==============================
13-
If :ref:`FS_LEAK_ENABLE<FS_LEAK_ENABLE>` is non-zero, then if the detector attached to a logical pin on the autopilot designated by :ref:`LEAK1_PIN<LEAK1_PIN>` is analog (:ref:`LEAK1_TYPE<LEAK1_TYPE>` = "0"), its considered active ("1") if its voltage is > 2.0V. Digital sensors (:ref:`LEAK1_TYPE<LEAK1_TYPE>` = "1") present a logic level. Whether the active level of an analog sensor or the logic level from a digital sensor is taken as "dry" is determined by the :ref:`LEAK1_LOGIC<LEAK1_LOGIC>` parameter.
13+
If :ref:`FS_LEAK_ENABLE<FS_LEAK_ENABLE>` is non-zero, then if the detector attached to a logical pin on the autopilot designated by :ref:`LEAK1_PIN<LEAK1_PIN>` is analog (:ref:`LEAK1_TYPE<LEAK1_TYPE>` = "0"), it's considered active ("1") if its voltage is > 2.0V. Digital sensors (:ref:`LEAK1_TYPE<LEAK1_TYPE>` = "1") present a logic level. Whether the active level of an analog sensor or the logic level from a digital sensor is taken as "dry" is determined by the :ref:`LEAK1_LOGIC<LEAK1_LOGIC>` parameter.
1414

1515
What will happen
1616
================

sub/source/docs/pilot-control-failsafe.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
Pilot Control Failsafe
55
======================
66

7-
Sub provides a failsafe mechanism in case pilot manual control is lost. Pilot control in Sub is provided by either or both of two ways: via GCS MAVLink RC override messages( stimulated by GCS Joystick) or by the optional RC control link.
7+
Sub provides a failsafe mechanism in case pilot manual control is lost. Pilot control in Sub is provided by either or both of two ways: via GCS MAVLink RC override or Manual Control messages (stimulated by GCS Joystick) or by the optional RC control link.
88

99
When the failsafe will trigger
1010
==============================

0 commit comments

Comments
 (0)