-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Multirotor guide
Note
This page provides a general guide for things specific to Multicopter setup and tuning.
It assumes you have already setup your Ports, Modes, Navigation, Receiver, GPS, OSD etc. They are outside the scope of this document.
-
Download latest configurator from here.
-
Flash newest INAV with the full chip erase option selected.
-
When asked, select your model preset type.
If the type of model you have is not under the presets. Go to theMixer Taband select one of theMixer presetsin the drop-down menu. Many of the more common mixers are available here. (Tri, Hex, Octo etc)
Press Load and Apply to make your choice.
For even less common mixer types, also see Custom mixes for exotic setups. Other Mixer related information can also be found here and here. -
Go to the
Calibration Taband follow the instructions given to perform anAccelerometer Calibration. Run the advanced 6-point sensor calibration. -
If you use a magnetometer (recommended), it will also require setup in the
Alignment Tool TabandCalibration Tab. More specific information with regards to Flight Controller / Magnetometer alignment and calibration can be under GPS and Compass setup. You may need to attach a battery for magnetometer calibration if your GNSS/mag module is not powered by the FCs 4.5v USB pins. -
Once the above is complete. Make sure the Copter moves identical to the virtual image in the
Status Tab. It must do this on all 3 axis's. An deviation indicates incorrect alignment or calibration. -
Now go to the
Outputs Tab, and Enable Motor and Servo output. -
While in the
Outputs Tab, select the ESC protocol of your choice. -
If the motor output plug on your flight controller does not align with the input plug of the 4 in 1 ESC. e.g. S1 to S1 and S2 to S2 etc. But instead, they may be something like S1 to S4 and S4 to S1. You can use the
Motor Mixer Wizardin theMixer Tab, to allocate a motor output from the flight Controller, to the corresponding position each motor is located, according to which of the 4 ESC's it is wired to. -
Select motor direction if required. Depending on whether you want to run
Props INorProps OUT.
Adjusting these setting won't take long, but they are often over looked in setup. Leading to poor navigation performance or a crash landing in a Failsafe condition.
-
nav_mc_hover_thr- Please read here for a more detailed explanation of why it is important to adjust this setting. -
failsafe_throttleandfailsafe_of_delay- Please read through this short explanation here to help understand why adjusting these settings is required.
More advanced MC operation and tuning information can be found under Navigation modes and Navigation PID tuning (MC).
INAV multicopter tuning can be made easier for new users with EZ-Tune.
When you load a platform preset after flashing your hardware. Multicopter EZ-Tune will be enabled by default in the Tuning Tab.
If you wish to run your own tune. Turn off the ENABLED button.
Tip
The default presets many not always be correct. Due to the influence your selected hardware can have upon the PID tune.
Example: A lower powered 5" cruiser running on a 3 cell battery, will generally require a different tune to a 5" race quad running on a 6 cell battery.
The reason being is because the 6s quad will provide far more thrust for the PID controller to work with. Actually making tuning easier. But often requiring the PID values to be lower, because the PID setpoint error can be dealt with much faster.
The image below shows an example of the preset tune for a 7" multicopter.
But in the case mentioned above under the TIP. Such a tune is better suited to a multicopter that is NOT running a stronger power train. Like a 6 cell install.
The tune below has the Integral and Derivative gains on the pitch and roll reduced, to better suit a multicopter that has a higher power to weight ratio.
If you have migrated from BetaFlight to INAV. These gains will provide a safer start point to begin tuning from. Whether it be a 3", 5" or 7" build.
Add your batteries specifications into the CLI, under # battery_profile. Or in the Configurator Configuration Tab. This is a very important step.
Overlooking this step can cause your battery to become over discharged during the flight, leading to a crash.
-
vbat_warning_cell_voltage- Pre-warning. Set to 3.6v is good for a LiPo. -
vbat_min_cell_voltage- Time to land. Set to 3.4v is good for a LiPo. -
battery_capacity- Set to the ratedmAhcapacity of your battery pack. -
battery_capacity_warning- Generally set to 25%. Which is 25% of the batteries rated capacity. -
battery_capacity_critical- Set to 20%.
Note
Continually discharging many lithium chemistry batteries below 20% of their rated capacity under higher loads, can reduce its capacity, and also shorten the batteries life expectancy.
More in-depth battery setup information can be found here.
At the time of writing this. INAV has the following software filter methods. They are used to isolate and remove vibrations from the Gyro and Accelerometer data.
Gyro -
-
gyro_filter_mode- STATIC, DYNAMIC, ADAPTIVE -
dynamic_gyro_notch_enabled(default ON - aka Matrix filter) -
rpm_gyro_filter_enabled(default OFF - ESC telemetry, non bi-directional Dshot) -
gyro_anti_aliasing_lpf_hz(default ON - zero = OFF) -
gyro_lulu_enabled(default OFF) -
smith_predictor_delay(zero = default OFF) -
setpoint_kalman_enabled(default ON - aka Unicon filter)
Accelerometer -
-
acc_lpf_hz(default of 15Hz is a good balance between performance and noise handling) -
acc_lpf_type(filter type) - BIQUAD, PT1 -
acc_notch_hz(center frequency of the noise peak) - Should only be used if the peak is narrow and known by log data -
acc_notch_cutoff(lowest practical frequency the notch should be set). Only set if the above is used
Tip
Accelerometer vibrations more often cause issues for navigation control, then Gyro induced vibrations.
Lowering acc_lpf_hz below 7Hz in an attempt to filtering out vibrations, will begin to cause it's own problems. Making navigation control loose.
Filters add signal delay. And they can only remove so much noise before it begins to effect flight performance. For this reason it is always better to mechanically setup your hardware first, and eliminate as many vibrations as possible. By balancing the motors and the props.
Just because the hardware is new. Does not mean it is well balanced from factory.
If a motor isn't balanced correctly. You can generally hear it audibly, by REMOVING THE PROPS and running each motors individually through its rev range, using the motor sliders in the Outputs Tab.
It's better to run a few good filters, than to run every filter available. Which will only add even more gyro delay, with little to no benefit.
I've placed the gyro filters in the order of the ones I personally use from flight experience, from first to last.
Use silicon vibration dampeners for your flight controller. Do not tighten the stack bolts too tight. This will crush the dampener, reducing their ability to adsorb vibrations. Only tighten them firm enough to stop movement. You may have to use thread lock to prevent the nuts coming loose.
INAV offers a lot of customization through CLI variables. It is strongly recommended to read through CLI Variable reference and available CLI variables
INAV Version Release Notes
9.0.0 Release Notes
8.0.0 Release Notes
7.1.0 Release Notes
7.0.0 Release Notes
6.0.0 Release Notes
5.1 Release notes
5.0.0 Release Notes
4.1.0 Release Notes
4.0.0 Release Notes
3.0.0 Release Notes
2.6.0 Release Notes
2.5.1 Release notes
2.5.0 Release Notes
2.4.0 Release Notes
2.3.0 Release Notes
2.2.1 Release Notes
2.2.0 Release Notes
2.1.0 Release Notes
2.0.0 Release Notes
1.9.1 Release notes
1.9.0 Release notes
1.8.0 Release notes
1.7.3 Release notes
Older Release Notes
QUICK START GUIDES
Getting started with iNav
Fixed Wing Guide
Howto: CC3D flight controller, minimOSD , telemetry and GPS for fixed wing
Howto: CC3D flight controller, minimOSD, GPS and LTM telemetry for fixed wing
INAV for BetaFlight users
launch mode
Multirotor guide
YouTube video guides
DevDocs Getting Started.md
DevDocs INAV_Fixed_Wing_Setup_Guide.pdf
DevDocs Safety.md
Connecting to INAV
Bluetooth setup to configure your flight controller
DevDocs Wireless Connections (BLE, TCP and UDP).md\
Flashing and Upgrading
Boards, Targets and PWM allocations
Upgrading from an older version of INAV to the current version
DevDocs Installation.md
DevDocs USB Flashing.md
Setup Tab
Live 3D Graphic & Pre-Arming Checks
Calibration Tab
Accelerometer, Compass, & Optic Flow Calibration
Alignment Tool Tab
Adjust mount angle of FC & Compass
Ports Tab
Map Devices to UART Serial Ports
Receiver Tab
Set protocol and channel mapping
Mixer Tab
Set aircraft type and how its controlled
Outputs Tab
Set ESC Protocol and Servo Parameters
Modes Tab
Assign flight modes to transmitter switches
Standard Modes
Navigation Modes
Return to Home
Fixed Wing Autolaunch
Auto Launch
Configuration Tab
No wiki page currently
Failsafe Tab
Set expected behavior of aircraft upon failsafe
PID Tuning
Navigation PID tuning (FW)
Navigation PID tuning (MC)
EZ-Tune
PID Attenuation and scaling
Tune INAV PID-FF controller for fixedwing
DevDocs Autotune - fixedwing.md
DevDocs INAV PID Controller.md
DevDocs INAV_Wing_Tuning_Masterclass.pdf
DevDocs PID tuning.md
DevDocs Profiles.md
Rangefinder & Optic Flow
Optic Flow and Rangefinder Setup
Setup and usage for terrain following & GPS-free position hold
OSD and VTx
DevDocs Betaflight 4.3 compatible OSD.md
OSD custom messages
OSD Hud and ESP32 radars
DevDocs OSD.md
DevDocs VTx.md
LED Strip
DevDocs LedStrip.md
Programming
DevDocs Programming Framework.md
Adjustments
DevDocs Inflight Adjustments.md
Mission Control
iNavFlight Missions
DevDocs Safehomes.md
MultiWii Serial Protocol
MSP V2
MSP Messages reference guide
MSP Navigation Messages
INAV MSP frames changelog
Telemetry
INAV Remote Management, Control and Telemetry
MAVlink Control and Telemetry
Lightweight Telemetry (LTM)
Tethered Logging
Log when FC is connected via USB
Blackbox
DevDocs Blackbox.md
INAV blackbox variables
DevDocs USB_Mass_Storage_(MSC)_mode.md
CLI
iNav CLI variables
DevDocs Cli.md
DevDocs Settings.md
VTOL
DevDocs MixerProfile.md
DevDocs VTOL.md
TROUBLESHOOTING
"Something" is disabled Reasons
Blinkenlights
Sensor auto detect and hardware failure detection
Pixel OSD FAQs
TROUBLESHOOTING
Why do I have limited servo throw in my airplane
ADTL TOPICS, FEATURES, DEV INFO
AAT Automatic Antenna Tracker
Building custom firmware
Default values for different type of aircrafts
Source Enums
Features safe to add and remove to fit your needs.
Developer info
Making a new Virtualbox to make your own INAV[OrangeRX LRS RX and OMNIBUS F4](OrangeRX-LRS-RX-and-OMNIBUS-F4)
Rate Dynamics
Target and Sensor support
Ublox 3.01 firmware and Galileo
DevDocs Controls
DevDocs 1wire.md
DevDocs ADSB.md
DevDocs Battery.md
DevDocs Buzzer.md
DevDocs Channel forwarding.md
DevDocs Display.md
DevDocs Fixed Wing Landing.md
DevDocs GPS_fix_estimation.md
DevDocs LED pin PWM.md
DevDocs Lights.md
DevDocs OSD Joystick.md
DevDocs Servo Gimbal.md
DevDocs Temperature sensors.md
OLD LEGACY INFO
Supported boards
DevDocs Boards.md
Legacy Mixers
Legacy target ChebuzzF3
Legacy target Colibri RACE
Legacy target Motolab
Legacy target Omnibus F3
Legacy target Paris Air Hero 32
Legacy target Paris Air Hero 32 F3
Legacy target Sparky
Legacy target SPRacingF3
Legacy target SPRacingF3EVO
Legacy target SPRacingF3EVO_1SS
DevDocs Configuration.md
Request form new PRESET
DevDocs Introduction.md
Welcome to INAV, useful links and products
UAV Interconnect Bus
DevDocs Rangefinder.md
DevDocs Rssi.md
DevDocs Runcam device.md
DevDocs Serial.md
DevDocs Telemetry.md
DevDocs Rx.md
DevDocs Spektrum bind.md
DevDocs INAV_Autolaunch.pdf