From 37b993473b0d1df57b19eab7661c6e4e68708f02 Mon Sep 17 00:00:00 2001 From: bnsgeyer Date: Thu, 5 Sep 2024 00:06:48 -0400 Subject: [PATCH] tradheli: rework of heli wiki --- common/source/docs/common-archived-topics.rst | 1 + copter/source/docs/flight-modes.rst | 8 ++-- copter/source/docs/loading-the-code.rst | 2 + copter/source/docs/throw-mode.rst | 4 ++ ...copter-autopilot-assembly-instructions.rst | 20 +++++++++ ...tional-helicopter-configuring-hardware.rst | 34 +++++++++++++++ .../traditional-helicopter-connecting-apm.rst | 43 ++----------------- ...traditional-helicopter-esc-calibration.rst | 16 +++++++ ...raditional-helicopter-first-time-setup.rst | 22 ++++++---- .../traditional-helicopter-rc-calibration.rst | 18 ++++++++ copter/source/docs/turtle-mode.rst | 4 ++ 11 files changed, 120 insertions(+), 52 deletions(-) create mode 100644 copter/source/docs/traditional-helicopter-autopilot-assembly-instructions.rst create mode 100644 copter/source/docs/traditional-helicopter-configuring-hardware.rst create mode 100644 copter/source/docs/traditional-helicopter-esc-calibration.rst create mode 100644 copter/source/docs/traditional-helicopter-rc-calibration.rst diff --git a/common/source/docs/common-archived-topics.rst b/common/source/docs/common-archived-topics.rst index 0d9503fa47..144823f761 100644 --- a/common/source/docs/common-archived-topics.rst +++ b/common/source/docs/common-archived-topics.rst @@ -66,6 +66,7 @@ value to users with old hardware. Advanced Tuning Basic Tuning Auxiliary Function Switches (3.6 and earlier) + TradHeli Loading Firmware [/site] [site wiki="rover"] Pre-4.0 Rover Avoidance diff --git a/copter/source/docs/flight-modes.rst b/copter/source/docs/flight-modes.rst index 435a09abfb..a4958cf6c0 100644 --- a/copter/source/docs/flight-modes.rst +++ b/copter/source/docs/flight-modes.rst @@ -46,8 +46,8 @@ The table below shows for each flight mode whether it provides altitude or posit SportssAlt-hold, but holds pitch & roll when sticks centered Stabilize-+Self-levels the roll and pitch axis SysID-+Special diagnostic/modeling mode - ThrowAAYHolds position after a throwing takeoff - Turtle--Allows reversing and spinning up adjacent pairs of motors in order to flip a crashed, inverted vehicle back upright + ThrowAAYHolds position after a throwing takeoff. Multirotors only. + Turtle--Allows reversing and spinning up adjacent pairs of motors in order to flip a crashed, inverted vehicle back upright. Multirotors only. ZigZagAAYUseful for crop spraying @@ -93,12 +93,12 @@ Additional flight modes: - :ref:`Land ` - :ref:`PosHold ` - :ref:`Sport ` -- :ref:`Throw ` +- :ref:`Throw ` for multirotors only. - :ref:`Follow Me ` - :ref:`Simple and Super Simple ` - :ref:`Smart RTL (Return-to-Launch) ` - :ref:`SysID (System Identification) ` -- :ref:`Turtle ` +- :ref:`Turtle ` for multirotors only. - :ref:`ZigZag ` - :ref:`Avoid_ADSB ` for ADS-B based avoidance of manned aircraft. Should not be set-up as a pilot selectable flight mode. diff --git a/copter/source/docs/loading-the-code.rst b/copter/source/docs/loading-the-code.rst index 237c1aceb9..dbf2220c2e 100644 --- a/copter/source/docs/loading-the-code.rst +++ b/copter/source/docs/loading-the-code.rst @@ -1,5 +1,7 @@ .. _loading-the-code: +**ARCHIVED** + ============================================= Traditional Helicopter – Loading the Firmware ============================================= diff --git a/copter/source/docs/throw-mode.rst b/copter/source/docs/throw-mode.rst index b3700c7ac9..bf85a14b4b 100644 --- a/copter/source/docs/throw-mode.rst +++ b/copter/source/docs/throw-mode.rst @@ -7,6 +7,10 @@ Throw Mode This slightly dangerous flight mode allows the pilot to throw the vehicle into the air (or drop the vehicle) in order to start the motors. Once in the air, this mode does not accept any input from the pilot. This mode requires GPS. +.. note:: + + This flight mode is available for multirotors only. + .. warning:: Use with caution! It is dangerous to get close to an armed multicopter as is required to throw the vehicle. It is recommended to takeoff normally instead of using throw mode whenever possible. diff --git a/copter/source/docs/traditional-helicopter-autopilot-assembly-instructions.rst b/copter/source/docs/traditional-helicopter-autopilot-assembly-instructions.rst new file mode 100644 index 0000000000..80408b607b --- /dev/null +++ b/copter/source/docs/traditional-helicopter-autopilot-assembly-instructions.rst @@ -0,0 +1,20 @@ +.. _traditional-helicopter-autopilot-assembly-instructions: + +====================================== +Autopilot System Assembly Instructions +====================================== + +This section contains the instructions for assembling the "essential +components" of Arducopter firmware on Pixhawk and other autopilots. The +instructions for adding other hardware are covered in +:ref:`Optional Hardware `. + +.. toctree:: + :maxdepth: 1 + + Mounting the Autopilot + Autopilot Wiring + NAVIO2 (Linux based) Wiring QuickStart + Installing GPS+Compass Module + Vibration Damping + Magnetic Interference diff --git a/copter/source/docs/traditional-helicopter-configuring-hardware.rst b/copter/source/docs/traditional-helicopter-configuring-hardware.rst new file mode 100644 index 0000000000..45c9c8b3f0 --- /dev/null +++ b/copter/source/docs/traditional-helicopter-configuring-hardware.rst @@ -0,0 +1,34 @@ +.. _traditional-helicopter-configuring-hardware: + +================================ +Mandatory Hardware Configuration +================================ + +As part of first time setup, you'll need to configure some required +hardware components. The linked articles describe the process for +selecting frame orientation and configuring the RC transmitter/receiver, +compass, and accelerometer using *Mission Planner* and how to configure +the ESCs. + +In addition to mandatory calibration, you may also choose to :ref:`Configure Optional Hardware ` +including battery monitor, sonar, airspeed sensor, optical flow, OSD, +camera gimbal, antenna tracker etc. + +.. toctree:: + :maxdepth: 1 + + Basic System Overview + Frame Type Configuration + Helicopter Parameter List at a Glance + Configuring Servo, Motor, and RC Connections with the autopilot + Radio Control Calibration + Accelerometer Calibration + Compass Calibration + RC Transmitter Mode Setup + ESC Calibration + Swashplate Setup + Tailrotor Setup + Rotor Speed Control Setup + Internal Rotor Speed Governor + Failsafe Mechanisms + Flight Modes diff --git a/copter/source/docs/traditional-helicopter-connecting-apm.rst b/copter/source/docs/traditional-helicopter-connecting-apm.rst index b450021eb2..2e17357e75 100644 --- a/copter/source/docs/traditional-helicopter-connecting-apm.rst +++ b/copter/source/docs/traditional-helicopter-connecting-apm.rst @@ -1,8 +1,8 @@ .. _traditional-helicopter-connecting-apm: -============================================================== -Traditional Helicopter — Connecting and Calibrating the System -============================================================== +===================================================================== +Traditional Helicopter — Configuring Servo, Motor, and RC Connections +===================================================================== This page covers how to make the physical connections between the autopilot, RC receiver, ESC and servos as well as calibrating the RC transmitter, Compass, Accelerometer, and ESC. The following video covers making the connections and setting up the transmitter to work with the autopilot. @@ -72,40 +72,3 @@ The throttle servo or ESC for the main rotor motor is defaulted to output 8. Th Check the docs for your selected autopilot but most require a separate power supply to the servo rail to power your servos at their appropriate rated voltage. Connect telemetry radios, GPS/compass module, power to autopilot itself, and any other peripherals as per the instructions in the owners manual for the unit. - -RC Calibration --------------- - -.. warning:: - - Before powering the autopilot and servo rail for the first time, - disconnect the rudder linkage from the tail servo or bellcrank on the tail - gearbox. If you have a piston engine helicopter, also disconnect the throttle - servo linkage. - -The RC MUST be calibrated before proceeding once the autopilot is powered up. RC calibration is identical to all other vehicles. With helicopters using the ArduPilot system there can be no mixes in the RC radio. All the outputs must be -"pure", i.e. use either airplane mode in your radio, or helicopter mode with H1 or "straight" swash. -:ref:`See this topic `. - -Compass Calibration -------------------- - -It is recommended to calibrate the compasses at this time as well. This is the same as all other vehicles. -:ref:`See this topic `. - -Accelerometer Calibration -------------------------- -If the accelerometers were not calibrated on the bench prior to installation it must be calibrated before proceeding.(It is usually easier to calibrate on the bench and then re-calibrate only the level position, if required, once installed.) -:ref:`See this topic `. - -ESC Calibration ---------------- - - -.. warning:: be sure to remove all blades when doing ESC calibration. - -Some ESCs must be calibrated to the throttle range (ie HeliRSC output range, which defaults to 1000 to 2000us). In addition, it is often required to change ESC settings, such as enabling the governor mode and/or setting voltage protection levels. - -In order to do this, you must be able to directly control the input to the ESC. By default the output function where it is attached is set to HeliRSC (:ref:`SERVO8_FUNCTION` = 31). In order to pass the throttle stick directly to the ESC for ESC programming per the ESC's instructions, temporarily change this to :ref:`SERVO8_FUNCTION` = 53. Remember to change it back to "31", after completing the ESC programming. - -In addition, check to see that :ref:`RC3_MIN` and :ref:`RC3_MAX` match the MIN and MAX range of the HeliRSC output, which defaults to SERVO8 output (:ref:`SERVO8_MIN`, :ref:`SERVO8_MAX`), since passing through the throttle input will be direct and ignore those values, hich you are trying to match in the calibration. If not, temporarily change them to match and then return them to the values when :ref:`common-radio-control-calibration` was done. diff --git a/copter/source/docs/traditional-helicopter-esc-calibration.rst b/copter/source/docs/traditional-helicopter-esc-calibration.rst new file mode 100644 index 0000000000..74d549d1c9 --- /dev/null +++ b/copter/source/docs/traditional-helicopter-esc-calibration.rst @@ -0,0 +1,16 @@ +.. _traditional-helicopter-esc-calibration: + +======================================== +Traditional Helicopter — ESC Calibration +======================================== + +This page covers specific details about calibrating the ESC for a helicopter. If using the ESC's internal governor, ESC calibration is not required. + + +.. warning:: be sure to remove all blades when doing ESC calibration. + +Some ESCs must be calibrated to the throttle range (ie HeliRSC output range, which defaults to 1000 to 2000us). In addition, it is often required to change ESC settings, such as enabling the governor mode and/or setting voltage protection levels. + +In order to do this, you must be able to directly control the input to the ESC. By default the output function where it is attached is set to HeliRSC (:ref:`SERVO8_FUNCTION` = 31). In order to pass the throttle stick directly to the ESC for ESC programming per the ESC's instructions, temporarily change this to :ref:`SERVO8_FUNCTION` = 53. Remember to change it back to "31", after completing the ESC programming. + +In addition, check to see that :ref:`RC3_MIN` and :ref:`RC3_MAX` match the MIN and MAX range of the HeliRSC output, which defaults to SERVO8 output (:ref:`SERVO8_MIN`, :ref:`SERVO8_MAX`), since passing through the throttle input will be direct and ignore those values, hich you are trying to match in the calibration. If not, temporarily change them to match and then return them to the values when :ref:`common-radio-control-calibration` was done. diff --git a/copter/source/docs/traditional-helicopter-first-time-setup.rst b/copter/source/docs/traditional-helicopter-first-time-setup.rst index 176db43666..bc8211b9c5 100644 --- a/copter/source/docs/traditional-helicopter-first-time-setup.rst +++ b/copter/source/docs/traditional-helicopter-first-time-setup.rst @@ -5,17 +5,23 @@ Traditional Helicopter Setup ============================ +First-time setup of the autopilot includes downloading and installing a Ground Control Station (GCS), +mounting the autopilot to the frame, +connecting it to the receiver, power and motors, +and then performing initial configuration and calibration. + +For more information on each of these tasks (sorted by autopilot +within the sections) see the topics below: + .. toctree:: :maxdepth: 1 + Install Ground Station Software + Autopilot System Assembly + Loading Firmware to boards with existing ArduPilot firmware + Loading Firmware to boards without existing ArduPilot firmware + Connect Mission Planner to AutoPilot Suggested Parts List - Loading the Firmware - Mounting the Autopilot - Helicopter Parameter List at a Glance - Connecting and Calibration - Swashplate Setup - Tailrotor Setup - Rotor Speed Control Setup - Internal Rotor Speed Governor + Configuration After initial setup, be sure to follow the instructions in :ref:`traditional-helicopter-first-flight` \ No newline at end of file diff --git a/copter/source/docs/traditional-helicopter-rc-calibration.rst b/copter/source/docs/traditional-helicopter-rc-calibration.rst new file mode 100644 index 0000000000..a9e2523cae --- /dev/null +++ b/copter/source/docs/traditional-helicopter-rc-calibration.rst @@ -0,0 +1,18 @@ +.. _traditional-helicopter-rc-calibration: + +======================================= +Traditional Helicopter — RC Calibration +======================================= + +This page covers specific details about calibrating the RC controller for a helicopter. + +.. warning:: + + Before powering the autopilot and servo rail for the first time, + disconnect the rudder linkage from the tail servo or bellcrank on the tail + gearbox. If you have a piston engine helicopter, also disconnect the throttle + servo linkage. + +The RC MUST be calibrated before proceeding once the autopilot is powered up. RC calibration is identical to all other vehicles. With helicopters using the ArduPilot system there can be no mixes in the RC radio. All the outputs must be +"pure", i.e. use either airplane mode in your radio, or helicopter mode with H1 or "straight" swash. +:ref:`General Radio Control Calibration Wiki `. diff --git a/copter/source/docs/turtle-mode.rst b/copter/source/docs/turtle-mode.rst index fd38deaed6..4d6ce1e670 100644 --- a/copter/source/docs/turtle-mode.rst +++ b/copter/source/docs/turtle-mode.rst @@ -6,6 +6,10 @@ Turtle Mode Turtle Mode is a special mode that can be invoked either as a :ref:`flight mode ` via the flight mode switch or as an :ref:`Auxilary function ` assigned to an RC switch (channel). Turtle mode allows a user to attempt to flip the Copter upright, if inverted, by reversing the direction of adjacent pairs of motors and producing thrust to un-invert the vehicle after a crash. +.. note:: + + This flight mode is available for multirotors only. + DShot capable ESCs are required for this mode to function, allowing the DShot reverse command to be sent to the ESCs. :ref:`SERVO_DSHOT_ESC` must be set to a non-zero value and :ref:`MOT_PWM_TYPE` to a DSHOT value also, to allow DShot commands to be sent to the ESC. Once in this mode, moving the roll and/or pitch stick of the transmitter away from center will reverse and spin up the designated pair of motors, increasing thrust to maximum at full stick throw.