Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Getting started with iNav
Where to download?!
Install the latest version of iNav Configurator and use to download and flash firmware. Note that the Chrome app is no longer supported by Google.
Be aware on first boot after a reflash or clean erase INAV tries to auto detect MAG, BARO and SPEED (Pitot-tube). If none are detected it will indicate this with red icons on the sensor bar. It will also fail on
Hardware health on the Pre-arming checks. To fix reboot and its fine.
Go through the index on the right side to find useful information.
Hardware needed for GPS assisted modes.
- Multirotors: GPS, magnetometer, barometer.
- Fixed wings: GPS. (Can also use magnetometer and barometer but not needed.)
iNav supports Ublox, DJI NAZA, NMEA, multiwii's i2c-nav board and MultiWiiCopter's i2c-gps modules
With default iNav settings iNav will configure ublox GPS for you, no need to use software like u-center.
Also be aware that some of our flight controllers can cause interference with the GPS causing low satellites or even no satellites at all, keep GPS as far as possible away and think of either shield your GPS or flight controller and other equipment that can cause interference.
You can learn how to setup your GPS unit for use with iNav on on this page.
Notes / Common issues
Old version of iNav configurator, verify that your on the latest version see link. If it has failed to update, simple uninstall configurator and install it again.
Unable to enable NAV related modes, See Link for possible reasons for why.
iNav does not show "GPS Signal Strength" for each satellite in the Cleanflight configurator, instead only the first one is used to show HDOP
iNav has only one PID controller called fp-pid.
iNav has extra safety feature that prevents you from arming your aircraft if certain condition are met, or not met. This is controlled by CLI variable "Nav_extra_arming_safety" which is default turned on.
- No valid GPS lock. (Needs 3d lock and more satelites than inav_gps_min_sats)
- Navigation modes are turned on while trying to arm.
iNav has other GPS modes than cleanflight, or names them differently. Read this wiki page for how to use them, and combine them to get wanted position hold.
If your copter is toilet-bowling, which means, in the beginning it holds its position and then starts to make bigger and bigger circles, you probably have your magnetometer not calibrated correctly or it’s seeing the magnetic field of you power lines or the beeper.
If you are using your FC onboard mag, try to place the the FC as far away as possible from the magnetic interference causing parts e.g. mounting it on/under the top plate on small racers.
No GPS lock after setting it up and the GPS icon lights up green are often due to electric noise from flight controller or other equipment such as 1.2ghz video TX. Try getting the GPS on a mast and also you can shield using alufoil or copper foil.
Barometer is held at 0 meter until first arm, this is to ensure that it starts at 0 meter instead of 10 meters because of temperatur drift. ( This is why raising your flightcontroller while connected to configurator it shows increasing altitude but then is dragged to 0 meter )
When installing or upgrading INAV on a board with OSD, always load one OSD font from the configurator OSD tab. INAV uses its own OSD fonts and usually every release adds new characters or icons.
Checklist if you're having issue with something:
- Try and look through the wiki regarding the issue you have. You can also search the Wiki.
- Read the first post rcgroups Cleanflight iNav thread. Also read the last 5 pages in the thread to see if someone else has already mentioned it. Also try and search in the thread.
- Explain your issue, include CLI dump and blackbox log if you have a logger. Mention what you have tried, and also if it's working as intended in stock Cleanflight / Earlier versions of iNav
- Template for asking for help