Frequently asked questions
Requirements, whether tuning results apply to a real aircraft, things people run into, accounts and pricing. If your question is not here, use “✉ Report” in the app.
Before you start
What is TuneKata, and how is it different from a flight simulator?
It runs the real ArduCopter flight-controller firmware in your browser, so parameters, flight-controller messages, mode changes and AutoTune behave exactly as they do on a real aircraft. The aircraft physics is a model written by this site. The course follows the official ArduPilot tuning guide in eight steps, and each task ticks itself off when you do it correctly.
What computer and browser do I need?
A computer with Windows 10 (64-bit) or 11 and the latest Chrome or Edge; nothing to install, the first visit downloads about 4 MB of firmware. Phones and tablets are not supported; Safari and Firefox are not supported yet; Chrome on macOS and Linux is not something we test regularly, so check it during the trial. Minimum (usable at medium quality): a 4-core CPU (Core i5 / Ryzen 3 from 2018 or later), 8 GB of RAM, integrated graphics (Intel UHD 620 or better) with hardware acceleration enabled in the browser, a 1366×768 screen. Recommended: Core i5 / Ryzen 5 from 2020 or later, 16 GB, a discrete graphics card (GTX 1050 or better), 1920×1080. Below the minimum it may be slow or fail to start; please confirm it runs well during the trial before subscribing.
Can I use my own transmitter?
Yes. Connect it by USB and map each channel to a stick or switch on the Transmitter tab. Without a transmitter you can use the on-screen sticks or the keyboard, or let the coach fly for you.
Can I get through it without reading much?
Yes. A “Do now” line above each step tells you only the next action, and “Show me” lights up the control to press. The default “Quick” mode folds the theory away until you want it; switch to “Full” on the right.
Is there a fixed-wing or VTOL edition?
Multirotor only for now. A fixed-wing / VTOL edition is under consideration: if you want one, email support@tunekata.com with the subject “Fixed-wing edition”, or use “Other vehicle types? Tell us…” at the bottom of the Airframe menu in the app; we will build it if enough people ask, and your answers directly affect what we build next.
About the tuning results
Can I copy the PID gains from here to my real aircraft?
No, and do not use them as a starting point either. The simulated aircraft's inertia and motor response are estimated from its specification and will differ from your real aircraft. We compared airframes that have published real-world tunes: gains tuned in the simulator can differ from the published values by a factor of two or more, in either direction. On a real aircraft, start from the official ArduPilot initial parameters and repeat the process you practised here. What you learn here is the process and the judgement: what to do first, how to tell a good tune from a bad one, and what to do when something goes wrong.
How close is the simulation to a real aircraft, and what is outside it?
The flight controller is the real ArduCopter; the aircraft physics is a model written by this site and has not yet been checked item by item against flight logs from real aircraft (that is the next piece of work). Known gaps: the high-frequency motor vibration of small aircraft (5-inch class) is not reproduced, so use airframes of 10 inches or more for the notch-filter practice in step 4. The feel and the tuned numbers of the simulated aircraft will differ from your real aircraft (see the previous question).
How do I compare with my real aircraft?
Fly your real aircraft through the course steps, then drop the flight controller’s .BIN log (the APM/LOGS folder on the SD card, or a .bin downloaded with Mission Planner) into the app’s real flight log comparison. You can open it from the end of step 8, the final-parameters window, the “⋯” menu, or the card on the home page after you sign in. It lists, step by step, how that flight compares with the course: within range, how far outside, or not visible in the log. The log is analysed in your browser and never uploaded; only ArduCopter multirotor logs are read; like step 3 onwards, it needs an active trial or a subscription. You are responsible for judging the safety of real flights; the steps here are the course procedure, not instructions for your particular aircraft.
Which ArduPilot version is simulated?
ArduCopter 4.8 development; the exact revision is listed on the licences page. Some parameters were renamed and changed units in 4.7; the course uses the new names and step 1 explains how they map to the old ones.
Things people run into
Arming does nothing or is refused?
The flight controller needs ten-odd seconds after boot to finish its self-checks, and it will not arm during that time. The throttle must also be at minimum. When arming is refused, the Messages tab shows a line starting with PreArm giving the reason, exactly as on a real aircraft.
In Loiter the aircraft keeps accelerating, and coasts after I release the stick?
That is normal, not a fault. In Loiter the stick commands speed, not lean angle; after you release it the flight controller brakes to a stop according to its braking settings. For your own aircraft, tune it in step 8 of the course, which lets you try it and explains it.
AutoTune finished but the new gains were not saved?
The new gains are saved only if you land and disarm while the AutoTune switch is still on. If you turn the switch off or change mode before landing, the flight controller discards the result. The coach's “Land” does it the right way automatically.
Step 4 (notch filter) shows no spectrum?
First set INS_LOG_BAT_MASK to 1 in step 2 (the flight controller reboots automatically), then fly once and land and disarm. Only then does the flight controller have vibration data to analyse.
My three-position switch is detected as two positions?
When detecting the switch on the Transmitter tab, move it from one end to the other so that it goes through all three positions. The page then shows how many positions it found.
The view stutters, or the simulation speed at the top left is below 1?
Keep this tab in the foreground and close other heavy tabs such as video. A box at the top left shows three numbers: simulation speed, state interval and frame rate, normally about 1.00×, 50 ms and 60 fps. If the speed stays below 0.97 your computer cannot keep up; tell us with “✉ Report” in the title bar, which attaches your computer details automatically.
I crashed, or want to start again?
Press the coach's “Reset to pad”: the aircraft goes back to the pad and your tuned parameters are kept. When the battery runs out, press “Swap battery”.
Account and pricing
On how many computers can I use one account?
One at a time. When you sign in on another computer the first one shows “account in use on another computer”, and one click takes it back.
Is my progress saved? What if I change computer?
Yes. Course progress, transmitter settings and flight-controller parameters are stored in your browser and synced to the cloud. Sign in with the same account on another computer and they come back automatically.
How do the trial and pricing work?
A new account gets a 7-day free trial with all eight steps. After the trial the first two steps (parameters and first flight), free flight, transmitter calibration and pilot settings stay free for good; steps 3 onward, changing parameters by hand (the parameter list, AutoTune, QuikTune), random airframes and challenge mode need a subscription. Prices are on the plans page; payments are handled by Paddle and you can cancel any time, keeping access to the end of the period.
Is there a reward if you adopt my suggestion?
Yes. Report a real bug, or make a suggestion that we adopt (course steps, explanations, interface), and we will give you two weeks of access; just use “✉ Report” in the app’s title bar. Parameter values from before and after tuning your real aircraft are welcome too, but we only use them to compare the simulator with real aircraft: they do not go into the product and are not shared with anyone.
What do you do with my data?
It is used only to provide the service. What is collected, how long it is kept and how to ask for deletion are set out in the Privacy Policy. The leaderboard shows only the nickname you choose and your score.
Other
How do I report a problem or suggest something?
Press “✉ Report” in the app's title bar and write a sentence or two. Your computer details, performance figures and current step are attached automatically so we can reproduce the problem.
Is TuneKata an official ArduPilot product?
No. This site uses ArduPilot's GPLv3 open-source code and is not affiliated with the ArduPilot project. The version used and links to the source are on the licences page.