1.1. SD Card Contents

Before telemetry can be configured on the Taranis, you must ensure that your Taranis SD card is populated with the correct folder structure and contents.

• For OpenTx 2.2 - this is relatively easy to do, as OpenTx provide a download containing the full SD Card contents here: http://downloads.open-tx.org/2.2/nightly/sdcard/sdcard-taranis-x9-2.2V0009.zip (v9 was the latest revision at time of writing), so download this, and write the contents to your Taranis SD card (would suggest formatting the card initially to start from fresh, making sure to backup first in case you need any of the old files). Once done we will then remove the OpenTx sound files and replace them with our own sound files and scripts - covered in the following section.

• For OpenTx 2.1 - this is a little harder, as the downloads section on the OpenTx website does not provide a single download containing all the required SD card contents. Instead, you should ensure that your folder structure is configured manually as follows:

Once done we will then copy our own sound files and scripts - covered in the following section.

SD card content provided by this project

This project provides both LUA scripts and sound files which must be copied to your SD card.

LUA Scripts:

Copy the folder contents from the project download path (include all the folder contents):	to SD-Card Path	comments
Taranis/LUA_SD_Card/SCRIPTS/MIXES	/SCIPTS/MIXES	Holds mixer (lua) scripts
Taranis/LUA_SD_Card/SCRIPTS/TELEMETRY	/SCRIPTS/TELEMETRY	Holds main telemetry (lua) scripts
Taranis/LUA_SD_Card/SCRIPTS/TELEMETRY/DATA	/SCRIPTS/TELEMETRY/DATA	This folder is required for storing configuration (<model_name>.cfg) files
Taranis/LUA_SD_Card/SCRIPTS/TELEMETRY/LIBRARY	/SCRIPTS/TELEMETRY/LIBRARY	Holds LUA telemetry script library (lib) files

Sound Files:

Because of the different possible combinations of OpenTx version and Ardupilot versions supported by this project, the following sound file install instructions have been broken up into two parts:

• First we copy the soundpack specific to our OpenTx version - this will be either OpenTx 2.1.x or 2.2.x
• Then we copy the system files specific to our version of Ardupilot - this will be either 3.2 (for Ardupolit Plane/Copter 3.2) or 3.3 for Ardupilot Plane/Copter versions 3.3 or newer).

So in more detail:

Before starting, you should know that the soundfiles provided here are only provided in the English language. These will exist currently on your SD Card in the /SOUNDS/en folder. Apologies for those of you who prefer to use other languages - I would be happy to provide files in those other languages if you would be willing to provide the translated text, so please ask. The files provided by this project are intended to replace all your existing sound files (in /SOUNDS/en), so we would suggest deleting your existing sound files first. Note, if you have any custom sound files that you wish to keep, then make sure these are put aside at the start so you can put them back later.

Note - if you are running APM with Ardupilot v3.21 then we suggest you choose the Ava voice for your sound pack as both OpenTx and telemetry sound packs are available in the Ava voice for this Ardupilot version.

• First, copy one of the following OpenTx Soundpacks to your SDCard folder path: /SOUNDS/en (depending on your choice of voice and OpenTx version). Note that the our sound files also include those located in the path /SOUNDS/en/SYSTEM, so be sure to copy all these required files from your download of this repository.

Copy the folder contents from the project download path (include all the folder contents):	to your SD-Card Path:	Comments
Taranis/LUA_SD_Card/SOUNDS_OpenTx_Soundpack/SOUNDS_OTx2.1_Ava	/SOUNDS/en	This is the OpenTx 2.1 Soundpack - Ava voice
Taranis/LUA_SD_Card/SOUNDS_OpenTx_Soundpack/SOUNDS_OTx2.1_Samantha	/SOUNDS/en	This is the OpenTx 2.1 Soundpack - Samantha voice
Taranis/LUA_SD_Card/SOUNDS_OpenTx_Soundpack/SOUNDS_OTx2.2_Ava	/SOUNDS/en	This is the OpenTx 2.2 v5 Soundpack - Ava voice
Taranis/LUA_SD_Card/SOUNDS_OpenTx_Soundpack/SOUNDS_OTx2.2_Samantha	/SOUNDS/en	This is the OpenTx 2.2 v5 Soundpack - Samantha voice

Note - the above sound packs have been generated by this project following the OpenTx sound file specifications (for OpenTx 2.1 and 2.2 english (en) language. As well as containing the bare essential files covered by the OpenTx spec, we have also included additional sound files to cover many other aspects of RC model flying (including flight modes for AP and cleanflight). For OpenTx 2.2, before copying our provided soundpack files (mentioned above) you should first delete all sound files from the /SOUNDS/en folder of your SD card - these will initially exist if you have downloaded and installed the SD Card contents zip file from OpenTx.

• Finally, copy one of the following telemetry sound packs (as per your choice of voice and Ardupilot version), to your SDCard folder path: /SOUNDS/en/TELEM. These are copied to the SDcard folder path: /SOUNDS/en/TELEM

Copy the folder contents from the project download path:	to your SD-Card Path	Comments
Taranis/LUA_SD_Card/SOUNDS_Telemetry/SOUNDS_AC3.2_Ava/en/TELEM	/SOUNDS/en/TELEM	for Ardupilot 3.2 - only the Ava voice is available for AP3.2
Taranis/LUA_SD_Card/SOUNDS_Telemetry/SOUNDS_AC3.3_Ava/en/TELEM	/SOUNDS/en/TELEM	for Ardupilot 3.3 and newer
Taranis/LUA_SD_Card/SOUNDS_Telemetry/SOUNDS_AC3.3_Samantha/en/TELEM	/SOUNDS/en/TELEM	for Ardupilot 3.3 and newer

(Note - the 'en' in the folder path relates to the language selected in the Taranis radio configuration. This project currently only provides voice files in the English (en) language, although we would consider expanding this to other languages if there are any translators out there willing to get involved in the project.)

Resultant SD Card structure

For clarity, upon completion of the SD Card setup described above, the SD Card structure should be as follows: