Support/FAQ for Pro Templates

Mike Shellim
Last updated 16 June 2018

This page is for support of the pro templates, though some of the material will also be of general interest. Here you can find out the recommended versions of OpenTx, how to migrate your templates to a different transmitter or to a newer version of OpenTx, and any current issues affecting the Pro templates.

Background: OpenTx versions and data formats

There are two separate branches of OpenTx, identified by their major version numbers '2.1' and '2.2'. Each branch has its own data format. Recommended stable versions of each:

Note: The following are not supported by the Pro templates:

Pro templates FAQ

Which transmitters can I use with the Pro templates?
X9D, X9D Plus, X9E, X10 and X12
Can I use my Q-X7?
The Q-X7 is compatible with the F3F and Wingy templates. Others will require modification due to the X7's lack of sliders.
Are the Pro templates compatible with OpenTx 2.2.x?
All current templates and associated sound files are fully compatible with OpenTx 2.2. (Templates in the older 2.1 format are automatically converted to 2.2 format when opened in Companion 2.2.x, or the first time the transmitter is powered after flashing 2.2.x.)
Are the Pro templates compatible with OpenTx 2.1?
Check the template's Download page for supported versions of OpenTx. If the latest version your chosen template does not support OpenTx 2.1, then go to the template's Version History page and download the most recent 2.1-compatible version. (Even better, flash your transmitter to OpenTx 2.2.x and use the latest version of the template!).

Conversion of model data from 2.1 to 2.2 format

When you flash your transmitter to OpenTx 2.2, all model data is automatically converted to 2.2 format. There are just a couple of potential issues to be aware of:

Sounds don't work after migrating to 2.2
After flashing your transmitter to OpenTx 2.2, older setups may appear to lose their custom sounds. This is because of a 6-character limit for the sound (.wav) filenames introduced in OpenTx 2.2. To fix this, go to the Special Functions menu and identify all the sound files referenced in 'Play Track' lines. In the SD card, shorten the names of these files to 6 characters + .wav. Then alter the references in Special Functions to match.
Servo centres shift after migrating to OpenTx 2.2
Two possible explanations:
1. Sticks/sliders not correctly calibrated. Calibrate and try again.
2. A known bug in OpenTx 2.1: channel values are not correctly calculated if PPM Centre has a value other than default 1500µS. This bug is fixed in OpenTx 2.2; In consequence, after migration to 2.2, any channels with non-default PPM Centre will have an unwanted offset. To fix this quickly: enter CAL mode, open the Outputs menu, identify channels with values other than 1500 in the PPM Centre column, and recalibrate by adjusting the PPM Centre value.

Migrating to a different transmitter

Can I migrate my model data and radio settings to a different transmitter (e.g. X9D to X10)?
Yes, as long as the target transmitter has the same or higher major version of OpenTx, for example X9D/2.1 to X10/2.2 is OK, but X10/2.2 to X9D/2.1 is not. If migrating to 2.2, then please also read the section above.
Assuming you're good to go: backup the data from your old transmitter ("backup radio to file"). Start Companion and select a profile for the target transmitter. Open the backup; the model data is automatically translated for the target transmitter. Transfer data to the target transmitter ("write models and settings"). Check that all knobs and sliders function correctly, if not then see below. Finally, recalibrate the sticks.
Sliders and/or knobs not functioning
All the Pro Templates target the X9D. If using a transmitter other than X9D, you may find that mixer sources with LS, RS, S1 or S2 are not translated correctly and fail to function. Instructions for fixing are in the Setup Guides for all current templates. For older templates, you can fix this yourself: open Companion and create a profile for the X9D/D+. Open a fresh copy of the template and go to the MIXERS menu. Note down all mixers with source = LS, RS, S1 or S2. In the target transmitter, check if these mixer sources are translated correctly and amend in situ as necessary.

Other stuff

How do I re-order the servo channels (e.g. for mixed S-Bus/PWM operation)?
Re-ordering of servo channels can be done via a Lua script or manually. For more info see here.
How do I check for errors in my setup?
If you suspect you made a data entry error, then use Companion's 'Compare models' tool to compare your working version with a known good version.

Current Issues

There are no known issues affecting current templates when used with the recommended versions of OpenTx.

Historical issues

Issues affecting older templates and/or versions of OpenTx:

Date Problem description
2017-10-23 [OpenTx 2.2.0] Cannot calibrate flap neutral (fixed in 2.2.1)
2017-12-05 [OpenTx 2.2.1 RC1] GV's corrupted in Companion after conversion
2017-04-07 [OpenTx 2.2 RC14/ N366] Cannot reverse left flap CH4
2017-04-06 [E-Soar and E-Soar Plus] CAL and/or arming gesture not recognised
2017-02-17 [E-Soar Plus 2.0 & OTX 2.2] Timer starts at startup
2016-12-23 [F3J/TD 3.0.0 & X9E] 'Speed' callout not working
2016-02-01 [X9E] LS, RS not mapped correctly on X9E
2015-10-03 [OpenTx 2.1.2 - 2.1.4] Can't switch flight modes
2014-11-05 [F3F 3.0.0] Incorrect Inputs spec

Bug reports

If you find an issue, please email me with the following detailed info:

If there's insufficient info to reproduce the problem, I'll just pass it back, so please take the time to document the steps carefully.


Comments and queries are always welcome, I can be contacted by email.