Skip to content
Jetrell edited this page Mar 27, 2026 · 19 revisions

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.

1. Getting your flight controller ready.

  • 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 the Mixer Tab and select one of the Mixer presets in 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 Tab and follow the instructions given to perform an Accelerometer Calibration. Run the advanced 6-point sensor calibration.

  • If you use a magnetometer (recommended), it will also require setup in the Alignment Tool Tab and Calibration 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 Wizard in the Mixer 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 IN or Props OUT.

2. Setup failsafe and a couple of important navigation settings

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_throttle and failsafe_of_delay - Please read through this short explanation here to help understand why adjusting these settings is required.

Guide for setting up failsafe

More advanced MC operation and tuning information can be found under Navigation modes and Navigation PID tuning (MC).

3. Tune your copter's Pitch/Roll/Yaw/Level PIDs and other values

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.

7 inch MC preset

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.

Higher performance quad starting tune

4. Battery settings

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 rated mAh capacity 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.

5. Selecting filters

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.

6. Get to know the CLI values.

INAV offers a lot of customization through CLI variables. It is strongly recommended to read through CLI Variable reference and available CLI variables

WIKI TOPICS

Wiki Home Page

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

GPS

GPS and Compass setup
GPS Failsafe and Glitch Protection

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

ADVANCED

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

Clone this wiki locally