Skip to content

1. Installation

Jesper Frickmann edited this page May 9, 2020 · 29 revisions

All FrSky Taranis models, and Jumper T12 transmitters are currently supported. Unfortunately, FrSky Horus models and Jumper T16 cannot currently be supported. Your transmitter must run OpenTX version 2.3.x to use the SoarOTX programs.

Xlite users, copy models from the Xlite.otx file. Everyone else, open the X9D+.otx file, and let Companion convert to your transmitter. Then copy the models over.

If you are running OpenTX 2.2.x

Download OpenTX Companion 2.3.x here.

After installing Companion on your computer, create a radio profile matching your radio, click Download and Check for Updates. Download the firmware and the SD card files. To connect your radio to the computer, press the rudder and aileron trim buttons together towards the middle, and turn on the radio. Then connect it with a mini-USB B cable. First click Backup Radio to File, and also make a backup copy of your SD card. Then click Write Firmware to Radio and select the newly downloaded firmware. Finally, unzip the SD card files, format your SD card, and copy the fresh card content over.

Install SoarOTX models and SD card files on your radio

Download a ZIP archive with the SoarOTX program files and the SD card files for SoarOTX from here.

Copy the content from SD-CARD over to your transmitter's SD card. Always copy directly from the SoarOTX Zip archive; not files that may have been used by Companion on your computer. Copy the SCRIPTS and IMAGES folders on top of the existing ones, so files will merge to the right places. If you have an earlier version of SoarOTX already, then it is a good idea to delete the existing script files, to avoid conflicts. Next, copy the models over to your radio:

  • Open the SoarOTX radio file. If you have an Xlite radio, open the Xlite file, otherwise open the X9D+ file and let Companion convert it to your radio.
  • Read models and settings from your own radio.
  • Drag the model templates over to your own radio’s file.
  • Write models and settings to the radio from your own radio's file.

Now you should be ready to setup your first model from a SoarOTX template.

Troubleshooting

If Companion crashes when you load the SoarOTX file, then check that you are using Companion 2.3.x. Since the files were created with Companion 2.3.7, they will crash Companion 2.2.x.

If it says "No telemetry screens", then check that you have copied the lua script files to the right place on your SD card. Verify that you have e.g. the following files: /SCRIPTS/FUNCTIONS/JFutil.lua, /SCRIPTS/TELEMETRY/JF3Ksk.lua and /SCRIPTS/TELEMETRY/JF/CHANNELS.lua.

If your script crashes, then:

  • Sometimes, the telemetry menus crash the first time they are opened. Just cycle power on your radio, and it should work then. Lua errors do not affect control of the plane. Otherwise proceed:

  • Make sure that you do not have old scripts from previous versions mixed in with the current version. If you do not have scripts from other parties, then just delete /SCRIPTS/TELEMETRY/ and /SCRIPTS/FUNCTIONS/ on your SD card, and copy a fresh set of files over.

  • Make sure that your model templates are also from the current version. You cannot mix the current and past versions.

  • Delete all *.luac files from your SD card, in case you copied them over from your computer. *.luac files are generated the first time that a script is run, and the ones generated by your computer if you run Companion are not compatible with the ones generated by your transmitter.

  • Maybe your SD card is corrupted - that has happened to me, and many others. Take a backup of anything on the SD card that you want to keep, then do a full format (not quick). Finally, copy fresh SD card files matching your version of OpenTX, and fresh SoarOTX files over. Your models are stored in the transmitter's internal flash memory, and will not be deleted by this procedure. Model backups are stored in the SD card's MODELS folder, and you may want to save these before formatting.

Clone this wiki locally