Skip to content

Commit ef1a683

Browse files
bnsgeyerHwurzburg
authored andcommitted
show applicable SID_AXIS options for each frame
1 parent 60388d2 commit ef1a683

File tree

2 files changed

+15
-8
lines changed

2 files changed

+15
-8
lines changed

common/source/docs/common-systemid-mode-operation.rst

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
.. _common-systemid-mode-operation:
22

3+
[copywiki destination="plane,copter"]
4+
35
.. contents::
46

57
System ID Mode Operation
@@ -26,7 +28,7 @@ Data Collection
2628

2729
The data collection is initiated by switching to the System ID mode.
2830
Each time the mode is changed to the System ID flight mode a new data collection is initiated.
29-
To change the amplitude of the excitation the :ref:`SID_MAGNITUDE<SID_MAGNITUDE>` parameter can be tuned using the :ref:`Ch6 tuning knob<TUNE>` during the data collection.
31+
To change the amplitude of the excitation, the :ref:`SID_MAGNITUDE<SID_MAGNITUDE>` parameter can be tuned using the transmitter during the data collection using :ref:`common-transmitter-tuning` and setting the :ref:`TUNE<TUNE>` parameter in Copter, or the :ref:`TUNE_PARAM<TUNE_PARAM>` in Plane, to "58" .
3032

3133
The System ID mode provides these capabilities:
3234

@@ -82,15 +84,17 @@ Value Description
8284
11 Mixer Pitch
8385
12 Mixer Yaw
8486
13 Mixer Thrust
87+
[site wiki="copter"]
8588
14 Measured Lateral Position
8689
15 Measured Longitudinal Position
8790
16 Measured Lateral Velocity
8891
17 Measured Longitudinal Velocity
8992
18 Input Lateral Velocity
9093
19 Input Longitudinal Velocity
94+
[/site]
9195
===== ===========
9296

93-
:ref:`SID_MAGNITUDE<SID_MAGNITUDE>`: System identification Chirp Magnitude. Depending on the injection point, units will be in either deg, deg/s, 0-1 for mixer outputs, m/s for velocity, and m for position. The magnitude can be changed in flight easily using the :ref:`tuning knob<TUNE>` using the 58 option.
97+
:ref:`SID_MAGNITUDE<SID_MAGNITUDE>`: System identification Chirp Magnitude. Depending on the injection point, units will be in either deg, deg/s, 0-1 for mixer outputs, m/s for velocity, and m for position. The magnitude can be changed in flight easily using :ref:`common-transmitter-tuning`, as explained previously.
9498

9599
:ref:`SID_F_START_HZ<SID_F_START_HZ>`: System identification Start Frequency. Range: 0.01-100 Hz
96100

@@ -122,17 +126,19 @@ main loop frequency divided by a sub-sample factor.
122126
+--------------+--------------+---------------+
123127

124128

125-
The next figure depicts the :ref:`SID_AXIS<SID_AXIS>` injection points in yellow and some details of the most inner PID loops when :ref:`ATC_RATE_FF_ENAB<ATC_RATE_FF_ENAB>` == 0.
129+
The next figure depicts the :ref:`SID_AXIS<SID_AXIS>` injection points in yellow and some details of the most inner PID loops when :ref:`ATC_RATE_FF_ENAB<ATC_RATE_FF_ENAB>` = 0.
126130

127131
.. figure:: ../images/arducopter4.1_pid_loops_ff_dis.png
128132

129133
ArduCopter control loops with ATC_RATE_FF_ENAB=0
130134

131-
The next figure depicts the :ref:`SID_AXIS<SID_AXIS>` injection points in yellow and some details of the most inner PID loops when :ref:`ATC_RATE_FF_ENAB<ATC_RATE_FF_ENAB>` == 1.
135+
The next figure depicts the :ref:`SID_AXIS<SID_AXIS>` injection points in yellow and some details of the most inner PID loops when :ref:`ATC_RATE_FF_ENAB<ATC_RATE_FF_ENAB>` = 1.
132136

133137
.. figure:: ../images/arducopter4.1_pid_loops_ff_en.png
134138

135-
ArduCopter control loops with ATC_RATE_FF_ENAB=1
139+
ArduCopter control loops with :ref:`ATC_RATE_FF_ENAB<ATC_RATE_FF_ENAB>` = 1
140+
141+
[site wiki="copter"]
136142

137143
Position controller diagram showing the chirp being input at the desired velocity. Both the velocity and position feedback loops are being used. This input would be used to analyze data to determine position or tracking bandwidth.
138144

@@ -150,3 +156,4 @@ Position controller diagram showing the chirp being input at the measured veloci
150156

151157
.. figure:: ../images/Pos_Ctrl_Vel_DRB.png
152158

159+
[/site]

common/source/docs/common-systemid-mode.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,14 +21,14 @@ It injects an input signal, called a chirp, at various points in the control loo
2121
Enabling the System Identification Feature
2222
==========================================
2323

24-
This feature is not automatically compiled into the stable version of firmware. Use the `custom firmware webtool <https://custom.ardupilot.org>` to compile a version for your board. Select the "system ID support for quadplanes" under the Plane category.
24+
This feature is not automatically compiled into the stable version of firmware. Use the `custom firmware webtool <https://custom.ardupilot.org>`__ to compile a version for your board. Select the "system ID support for quadplanes" under the Plane category.
2525

2626
Setup
27-
======
27+
=====
2828

2929
System ID feature in quadplane is different than copter. The system ID feature in copter is a separate flight mode. In quadplane, system ID is run on top of either qstabilize, qhover, or qloiter flight modes. The system ID feature is started and stopped using an Aux Switch.
3030

31-
Set an aux switch on the transmitter to have RCX_OPTION set to 184.
31+
Set an aux switch on the transmitter to have ``RCx_OPTION`` set to 184 to start/stop operation.
3232

3333
Further Information
3434
===================

0 commit comments

Comments
 (0)