Skip to content

Commit 25a55ab

Browse files
committed
docs(tuning guide): update the experiment instruction text
1 parent 24897f7 commit 25a55ab

File tree

4 files changed

+66
-67
lines changed

4 files changed

+66
-67
lines changed

TUNING_GUIDE_ArduCopter.md

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Use Mission Planner to flash the latest stable [ArduCopter](https://firmware.ard
9797

9898
## 2.1 Used software summary
9999

100-
The table bellow summarizes the software used in this guide. Download and install them as you progress in the guide.
100+
The table below summarizes the software used in this guide. Download and install them as you progress in the guide.
101101

102102
| Software | Version | Description |
103103
|:----|:----|:----|
@@ -295,7 +295,7 @@ Propeller size has a big influence on the vehicle dynamics, this adapts controll
295295

296296
Repeat the steps from [Section 6.1.1](#611-use-ardupilot-methodic-configurator-to-edit-the-parameter-file-and-upload-it-to-the-flight-controller) to edit and upload the `11_initial_atc.param` file
297297

298-
When asked *Should the FC values now be copied to the 12_mp_setup_mandatory_hardware.param file?* select `No` and close the *ArduPilot Methodic Configurator* software.
298+
When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
299299

300300
## 6.9 Configure "Mandatory Hardware" Parameters
301301

@@ -384,8 +384,8 @@ Now do some general configuration
384384

385385
1. Connect the flight controller to the PC
386386
1. Start *ArduPilot Methodic Configurator* and select the vehicle directory where you previously stored your *intermediate parameter files*.
387-
1. When *ArduPilot Methodic Configurator* asks you *Should the FC values now be copied to the 12_mp_setup_mandatory_hardware.param file?* select `Yes`
388-
1. Select `13_general_configuration.param` on the *Current intermediate parameter file:* Combobox.
387+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `12_mp_setup_mandatory_hardware.param` file because you've completed the experiment.
388+
1. Press `Upload selected params to FC, and advance to next file` button.
389389
1. Read the documentation links inside the `13_general_configuration.param documentation`
390390
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
391391
1. Press `Upload selected params to FC, and advance to next file` button.
@@ -620,7 +620,7 @@ The estimation will be improved after the first flight.
620620

621621
Repeat the steps from [Section 6.1.1](#611-use-ardupilot-methodic-configurator-to-edit-the-parameter-file-and-upload-it-to-the-flight-controller) to edit and upload the `18_notch_filter_setup.param` file
622622

623-
When asked *Should the FC values now be copied to the 19_notch_filter_results.param file?* select `No` and close the *ArduPilot Methodic Configurator* software.
623+
When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
624624

625625
# 7. Assemble propellers and perform the first flight
626626

@@ -643,7 +643,7 @@ Land and disarm.
643643

644644
> [!IMPORTANT]
645645
> If your vehicle is very overpowered and requires a [MOT_THST_HOVER](https://ardupilot.org/copter/docs/parameters.html#mot-thst-hover)
646-
> level close to or bellow 0.2 you will need to set the [MOT_HOVER_LEARN](https://ardupilot.org/copter/docs/parameters.html#mot-hover-learn)
646+
> level close to or below 0.2 you will need to set the [MOT_HOVER_LEARN](https://ardupilot.org/copter/docs/parameters.html#mot-hover-learn)
647647
> parameter to 0 (using the `Add` button on the GUI) and follow the [setting hover throttle instructions](https://ardupilot.org/copter/docs/ac_throttlemid.html)
648648
649649
### 7.1.1 Check for Motor Output Oscillation
@@ -722,7 +722,7 @@ These are the very minimum tuning steps required for a stable flight:
722722

723723
Load the `.bin` log from the first flight onto the [online Ardupilot Filter Review tool](https://firmware.ardupilot.org/Tools/WebTools/FilterReview/)
724724
Follow the [instructions from Peter Hall on his Blog Post](https://discuss.ardupilot.org/t/new-fft-filter-setup-and-review-web-tool/102572) to configure the Harmonic Notch filter(s).
725-
Noise levels bellow -50dB are considered good enough.
725+
Noise levels below -50dB are considered good enough.
726726
Do not use notch filters to reduce noise bellow that level as it introduces unwanted signal lag.
727727
The graph below is a bode diagram of the gyro signals before and after the low-pass and Harmonic Notch filters.
728728
As you can see, the filters remove most of the vibration noise from the gyro sensors.
@@ -786,7 +786,7 @@ Perform the flight and afterward:
786786

787787
1. Connect the flight controller to the PC
788788
1. On *ArduPilot Methodic Configurator* select `23_quicktune_results.param` on the *Current intermediate parameter file:* Combobox.
789-
1. When asked *Should the FC values now be copied to the 23_quicktune_results.param file?* select `Yes`.
789+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `23_quicktune_results.param` file because you've completed the experiment.
790790
1. Press `Upload selected params to FC, and advance to next file` button.
791791
1. Close *ArduPilot Methodic Configurator*
792792

@@ -816,8 +816,7 @@ Follow these steps before the flight:
816816
1. Read the documentation links inside the `24_inflight_magnetometer_fit_setup.param documentation`
817817
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
818818
1. Press `Upload selected params to FC, and advance to next file` button.
819-
1. When asked *Should the FC values now be copied to the 25_inflight_magnetometer_fit_results.param file?* select `No`.
820-
1. Close *ArduPilot Methodic Configurator*
819+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
821820

822821
Perform the MagFit figure-eight flight and land
823822

@@ -829,7 +828,7 @@ Perform the MagFit figure-eight flight and land
829828
1. Perform the MagFit calculations. Save the tool-generated file as `25_inflight_magnetometer_fit_results.param` in your vehicle's intermediate parameter file directory.
830829
1. Connect your flight controller to the PC
831830
1. On *ArduPilot Methodic Configurator* select `25_inflight_magnetometer_fit_results.param` on the *Current intermediate parameter file:* Combobox.
832-
1. When asked *Should the FC values now be copied to the 25_inflight_magnetometer_fit_results.param file?* select `No`.
831+
1. When asked *Update file with values from FC?* select `No`.
833832
1. Press `Upload selected params to FC, and advance to next file` button.
834833
1. Close *ArduPilot Methodic Configurator*
835834

@@ -858,16 +857,15 @@ Setup the lua script using:
858857
1. Read the documentation links inside the `24_quicktune_setup.param documentation`
859858
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
860859
1. Press `Upload selected params to FC, and advance to next file` button.
861-
1. When asked *Should the FC values now be copied to the 25_quicktune_results.param file?* select `No`.
862-
1. Close *ArduPilot Methodic Configurator*
860+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
863861

864862
Perform the flight and afterward:
865863

866864
### 9.2.2 Store quicktune results to file
867865

868866
1. Connect the flight controller to the PC
869867
1. On *ArduPilot Methodic Configurator* select `25_quicktune_results.param` on the *Current intermediate parameter file:* Combobox.
870-
1. When asked *Should the FC values now be copied to the 25_quicktune_results.param file?* select `Yes`.
868+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `25_quicktune_results.param` file because you've completed the experiment.
871869
1. Press `Upload selected params to FC, and advance to next file` button.
872870
1. Close *ArduPilot Methodic Configurator*
873871

@@ -935,14 +933,14 @@ Follow the sequence below for tuning each axis as that particular order improves
935933
### 9.5.1 Roll axis autotune
936934

937935
1. On *ArduPilot Methodic Configurator* select `30_autotune_roll_setup.param` and upload it to the FC. It will activate the roll axis Autotune.
938-
1. When asked *Should the FC values now be copied to the 31_autotune_roll_results.param file?* select `No`.
936+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
939937
1. Outdoors on a non-windy day (or indoors in a big warehouse like we at IAV do) take off and fly in either [`AltHold`](https://ardupilot.org/copter/docs/altholdmode.html) or `Loiter` flight mode.
940938
1. At about 2 meters high, select `Autotune` flight mode in the RC transmitter to engage Autotune.
941939
1. Use the RC transmitter sticks to correct the vehicle position if it gets too high, too low or too close to obstacles.
942940
1. Once the Autotune is completed, land and disarm the vehicle without changing the flight mode.
943941
1. connect the flight controller to the PC
944942
1. On *ArduPilot Methodic Configurator* select `31_autotune_roll_results.param`.
945-
1. When asked *Should the FC values now be copied to the 31_autotune_roll_results.param file?* select `Yes`.
943+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `31_autotune_roll_results.param` file because you've completed the experiment.
946944

947945
The autotune might have found a poor solution, here are some indicators of a poor tune:
948946

@@ -963,14 +961,14 @@ If the battery got depleted before Autotune completion, change the initial PID p
963961
### 9.5.2 Pitch axis autotune
964962

965963
1. On *ArduPilot Methodic Configurator* select `32_autotune_pitch_setup.param` and upload it to the FC. It will activate the pitch axis Autotune.
966-
1. When asked *Should the FC values now be copied to the 33_autotune_pitch_results.param file?* select `No`.
964+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
967965
1. Outdoors on a non-windy day (or indoors in a big warehouse like we at IAV do) take off and fly in either `AltHold` or `Loiter` flight mode.
968966
1. At about 2 meters high, select `Autotune` flight mode in the RC Transmitter to engage Autotune.
969967
1. Use the RC transmitter sticks to correct the vehicle position if it gets too high, too low or too close to obstacles.
970968
1. Once the autotune is completed, land and disarm the vehicle without changing the flight mode.
971969
1. connect the flight controller to the PC
972970
1. On *ArduPilot Methodic Configurator* select `33_autotune_pitch_results.param`.
973-
1. When asked *Should the FC values now be copied to the 33_autotune_pitch_results.param file?* select `Yes`.
971+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `33_autotune_pitch_results.param` file because you've completed the experiment.
974972

975973
The autotune might have found a poor solution, here are some indicators of a poor tune:
976974

TUNING_GUIDE_ArduPlane.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Use Mission Planner to flash the latest stable [ArduCopter](https://firmware.ard
9797

9898
## 2.1 Used software summary
9999

100-
The table bellow summarizes the software used in this guide. Download and install them as you progress in the guide.
100+
The table below summarizes the software used in this guide. Download and install them as you progress in the guide.
101101

102102
| Software | Version | Description |
103103
|:----|:----|:----|
@@ -295,7 +295,7 @@ Propeller size has a big influence on the vehicle dynamics, this adapts controll
295295

296296
Repeat the steps from [Section 6.1.1](#611-use-ardupilot-methodic-configurator-to-edit-the-parameter-file-and-upload-it-to-the-flight-controller) to edit and upload the `11_initial_atc.param` file
297297

298-
When asked *Should the FC values now be copied to the 12_mp_setup_mandatory_hardware.param file?* select `No` and close the *ArduPilot Methodic Configurator* software.
298+
When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
299299

300300
## 6.9 Configure "Mandatory Hardware" Parameters
301301

@@ -384,8 +384,8 @@ Now do some general configuration
384384

385385
1. Connect the flight controller to the PC
386386
1. Start *ArduPilot Methodic Configurator* and select the vehicle directory where you previously stored your *intermediate parameter files*.
387-
1. When *ArduPilot Methodic Configurator* asks you *Should the FC values now be copied to the 12_mp_setup_mandatory_hardware.param file?* select `Yes`
388-
1. Select `13_general_configuration.param` on the *Current intermediate parameter file:* Combobox.
387+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `12_mp_setup_mandatory_hardware.param` file because you've completed the experiment.
388+
1. Press `Upload selected params to FC, and advance to next file` button.
389389
1. Read the documentation links inside the `13_general_configuration.param documentation`
390390
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
391391
1. Press `Upload selected params to FC, and advance to next file` button.
@@ -595,7 +595,7 @@ The estimation will be improved after the first flight.
595595

596596
Repeat the steps from [Section 6.1.1](#611-use-ardupilot-methodic-configurator-to-edit-the-parameter-file-and-upload-it-to-the-flight-controller) to edit and upload the `18_notch_filter_setup.param` file
597597

598-
When asked *Should the FC values now be copied to the 19_notch_filter_results.param file?* select `No` and close the *ArduPilot Methodic Configurator* software.
598+
When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
599599

600600
# 7. Assemble propellers and perform the first flight
601601

@@ -626,6 +626,8 @@ These are the very minimum tuning steps required for a stable flight:
626626

627627
Load the `.bin` log from the first flight onto the [online Ardupilot Filter Review tool](https://firmware.ardupilot.org/Tools/WebTools/FilterReview/)
628628
Follow the [instructions from Peter Hall on his Blog Post](https://discuss.ardupilot.org/t/new-fft-filter-setup-and-review-web-tool/102572) to configure the Harmonic Notch filter(s).
629+
Noise levels below -50dB are considered good enough.
630+
Do not use notch filters to reduce noise below that level as it introduces unwanted signal lag.
629631
The graph below is a bode diagram of the gyro signals before and after the low-pass and Harmonic Notch filters.
630632
As you can see, the filters remove most of the vibration noise from the gyro sensors.
631633

@@ -688,7 +690,7 @@ Perform the flight and afterward:
688690

689691
1. Connect the flight controller to the PC
690692
1. On *ArduPilot Methodic Configurator* select `23_quicktune_results.param` on the *Current intermediate parameter file:* Combobox.
691-
1. When asked *Should the FC values now be copied to the 23_quicktune_results.param file?* select `Yes`.
693+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `23_quicktune_results.param` file because you've completed the experiment.
692694
1. Press `Upload selected params to FC, and advance to next file` button.
693695
1. Close *ArduPilot Methodic Configurator*
694696

@@ -718,8 +720,7 @@ Follow these steps before the flight:
718720
1. Read the documentation links inside the `24_inflight_magnetometer_fit_setup.param documentation`
719721
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
720722
1. Press `Upload selected params to FC, and advance to next file` button.
721-
1. When asked *Should the FC values now be copied to the 25_inflight_magnetometer_fit_results.param file?* select `No`.
722-
1. Close *ArduPilot Methodic Configurator*
723+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
723724

724725
Perform the MagFit figure-eight flight and land
725726

@@ -731,7 +732,7 @@ Perform the MagFit figure-eight flight and land
731732
1. Perform the MagFit calculations. Save the tool-generated file as `25_inflight_magnetometer_fit_results.param` in your vehicle's intermediate parameter file directory.
732733
1. Connect your flight controller to the PC
733734
1. On *ArduPilot Methodic Configurator* select `25_inflight_magnetometer_fit_results.param` on the *Current intermediate parameter file:* Combobox.
734-
1. When asked *Should the FC values now be copied to the 25_inflight_magnetometer_fit_results.param file?* select `No`.
735+
1. When asked *Update file with values from FC?* select `No`.
735736
1. Press `Upload selected params to FC, and advance to next file` button.
736737
1. Close *ArduPilot Methodic Configurator*
737738

@@ -760,16 +761,15 @@ Setup the lua script using:
760761
1. Read the documentation links inside the `24_quicktune_setup.param documentation`
761762
1. Edit the parameters' `New Value` and `Change Reason` to suit your requirements
762763
1. Press `Upload selected params to FC, and advance to next file` button.
763-
1. When asked *Should the FC values now be copied to the 25_quicktune_results.param file?* select `No`.
764-
1. Close *ArduPilot Methodic Configurator*
764+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
765765

766766
Perform the flight and afterward:
767767

768768
### 9.2.2 Store quicktune results to file
769769

770770
1. Connect the flight controller to the PC
771771
1. On *ArduPilot Methodic Configurator* select `25_quicktune_results.param` on the *Current intermediate parameter file:* Combobox.
772-
1. When asked *Should the FC values now be copied to the 25_quicktune_results.param file?* select `Yes`.
772+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `25_quicktune_results.param` file because you've completed the experiment.
773773
1. Press `Upload selected params to FC, and advance to next file` button.
774774
1. Close *ArduPilot Methodic Configurator*
775775

@@ -837,14 +837,14 @@ Follow the sequence below for tuning each axis as that particular order improves
837837
### 9.5.1 Roll axis autotune
838838

839839
1. On *ArduPilot Methodic Configurator* select `30_autotune_roll_setup.param` and upload it to the FC. It will activate the roll axis Autotune.
840-
1. When asked *Should the FC values now be copied to the 31_autotune_roll_results.param file?* select `No`.
840+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
841841
1. Outdoors on a non-windy day (or indoors in a big warehouse like we at IAV do) take off and fly in either [`AltHold`](https://ardupilot.org/copter/docs/altholdmode.html) or `Loiter` flight mode.
842842
1. At about 2 meters high, select `Autotune` flight mode in the RC transmitter to engage Autotune.
843843
1. Use the RC transmitter sticks to correct the vehicle position if it gets too high, too low or too close to obstacles.
844844
1. Once the Autotune is completed, land and disarm the vehicle without changing the flight mode.
845845
1. connect the flight controller to the PC
846846
1. On *ArduPilot Methodic Configurator* select `31_autotune_roll_results.param`.
847-
1. When asked *Should the FC values now be copied to the 31_autotune_roll_results.param file?* select `Yes`.
847+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `31_autotune_roll_results.param` file because you've completed the experiment.
848848

849849
The autotune might have found a poor solution, here are some indicators of a poor tune:
850850

@@ -865,14 +865,14 @@ If the battery got depleted before Autotune completion, change the initial PID p
865865
### 9.5.2 Pitch axis autotune
866866

867867
1. On *ArduPilot Methodic Configurator* select `32_autotune_pitch_setup.param` and upload it to the FC. It will activate the pitch axis Autotune.
868-
1. When asked *Should the FC values now be copied to the 33_autotune_pitch_results.param file?* select `No`.
868+
1. When asked *Update file with values from FC?* select `Close` to close the application and go perform the experiment.
869869
1. Outdoors on a non-windy day (or indoors in a big warehouse like we at IAV do) take off and fly in either `AltHold` or `Loiter` flight mode.
870870
1. At about 2 meters high, select `Autotune` flight mode in the RC Transmitter to engage Autotune.
871871
1. Use the RC transmitter sticks to correct the vehicle position if it gets too high, too low or too close to obstacles.
872872
1. Once the autotune is completed, land and disarm the vehicle without changing the flight mode.
873873
1. connect the flight controller to the PC
874874
1. On *ArduPilot Methodic Configurator* select `33_autotune_pitch_results.param`.
875-
1. When asked *Should the FC values now be copied to the 33_autotune_pitch_results.param file?* select `Yes`.
875+
1. When asked *Update file with values from FC?* select `Yes` to copy current FC values to the `33_autotune_pitch_results.param` file because you've completed the experiment.
876876

877877
The autotune might have found a poor solution, here are some indicators of a poor tune:
878878

0 commit comments

Comments
 (0)