Taranis SD Card Storage

 FrSky Taranis SD Card, EEPROM, and

Firmware Storage

Contributed by: Scott Page

Click HERE for a printable PDF copy of this article.

Note:  This document prepared for v2.0.13 of OpenTX

Basic Storage Parameters

When you connect the Taranis to a PC using either the STM32 bootloader (transmitter off) or using OpentX 2.0 Taranis Bootloader (three finger boogie – transmitter on) you’ll see two volumes mount on the computer as removable drives. One is the SD card and one is called “Taranis”. The SD card can have a variety of different names such as “removable drive” but the contents make it obvious. The other volume is always called “TARANIS”. The Taranis volume is a Don’t Touch feature. Basically – leave it alone as there is nothing in the Taranis volume for the user to change directly.

TARANIS Contains two no touchy files. EEPROM.bin and FIRMWARE.bin. These files are stored in memory in the transmitter hardware, not on the SD card. These files are only altered through Companion.

EEPROM.bin: This file contains the Transmitter and model settings. When, in OpenTX Companion, you choose “Write Models and Settings to Radio” you are changing the EEPROM.bin but not the SD card.

FIRMWARE.bin: This file is the current version of OpenTX you have installed. When you choose “Write Firmware to radio” you are writing to the Taranis Volume and not the SD card.

 SD CARD You don’t need the SD card to operate the Taranis –without it you lose sounds, logging, and model icons.

Scott_SDcardmicroSD Card Structure as modified

SD Card

BMP: Contains model image files. Files must be.bmp files which are 4 bit and 64px by 32px. These files are accessed and assigned to specific models in the Model Setup screen. Files are limited to 8 characters + .bmp

FIRMWARES: Used by the Taranis Bootloader to flash firmware versions.  Name length is limited to 28 characters or 32 characters including the “.bin”.

LOGS: Transmitter will save .csv files here when logging is enabled in Custom Functions. The csv files can be used in companion for analysis of all gimbal controls, switch positions, and telemetry readings. Log frequency can be set as low as one sample every 0.1 second.

MODELS: Model Templates can be stored here which can be used when creating a new model in the model selection screen by choosing “Restore Model” when on an empty model. New templates can be created in the Model Selection Screen by choosing “Backup Model” when on the selected model.

Text files may also be stored in the models folder. If the text file has an identical name as a model (no spaces) this text file will be opened when choosing the model if “Display Checklist” is ticked in the Model Setup. Model specific text file can also be accessed by long pressing the ENT key and then choosing “View Notes”. Any text file can be viewed whether from that model or not by long pressing the MENU Key and then short press PAGE to get to SD-HC Card Screen and navigating to the text file you wish to view.

SCRIPTS: Contains Lua files. Lua is a programming language that allows all sorts of custom programs to be executed by the transmitter. The TX model creation wizard is included on the Plus and on the SD card I have for download.

SOUNDS: Sound files must be .wav files @ 32KHz or 16KHz. Names are limited to 8 characters + .wav. In my example the “en” will be replaced with the abbreviation of the appropriate language (fr, it, de, se, cz, es, pl, pt)

\SOUNDS\en – Contains files that you can select in the Special Functions to “Play Track” or “BGMusic”.

\SOUNDS\en\system – Contains files which are called by the Taranis firmware for specific purposes such as the startup sound (Tada.wav) and also switch warning, numbers….etc.

\SOUNDS\en\model_name – Contains sounds which are played for a specific model which has the exact same name as this folder. Sounds also must follow a specific naming scheme to be played by pre-defined circumstances. Some examples are L1-on.wav (logic switch 1), SA-down, SA-mid, SA-up (Switch A down, mid, and up).

Model Specific Sound Names

Wave files assigned a specific names will play when the function associated with that name occurs. The files must be in a folder that’s named the same as the model name. Neither the folder nor the model name can include have a space.

Switches: “S” followed by switch name (For Switches A-H) and then position (F and H only have up and down)
SAup.wav
SAmid.wav
SAdown.wav

Multipos switches: “P” followed by: first digit is switch number and second digit is switch position
P11.wav
P26.wav

Logical switches: L followed by logical switch number and condition
L1off.wav
L1on.wav

Flight Modes: Flight mode name followed by condition. No spaces in the flight mode name.
Mode_nameoff.wav
Mode_nameon.wav

SD Card Source

My SD can be downloaded @ https://dl.dropboxusercontent.com/u/17847149/TaranisMicroSD.zip. It contains two additional folders not on the original card:

Splash Screens: Splash screens which can be used as is or modified for use on Taranis startup

Resources for the user – not used directly by Taranis: For use on the PC – not the transmitter

 


Comments

Taranis SD Card Storage — 10 Comments

  1. Why can’t I access the list of .wav files in opentx when creating special functions? Only the ones I haves used previously show up in the list but when using the radio to program they are all there.

    • Check to see that the path in OPENTx Companion is set correctly to where you SD card files live. If you have not yet copied your SD card to your computer, you’ll need to do that, first. Then, check to see that the path on Companion is set correctly. You DO NOT have to go below the card root directory. In other words, do not include SOUNDS in the path. Companion will find it.

      Leonard (mac44mag)

  2. I have installed update version 2.1.17/2016-01-04.to Open TX Companion.
    Under Firmware Changes Release Notes.
    Notice:Lua model wizard was fixed(#3061) and needs to be installed on the radio SD card.Download from
    http://lua-21.open-tx-org/wizard.zip(Taranis)
    I have downloaded this to Open TX Companion on my Windows 10 computer.
    How do I install it on the radio SD card?

    • Hi, Malcolm!

      The easiest way is to:

      1. Download the firmware
      2. Open Companion
      3. From the toolbar, select, “Write Firmware to Radio” button. It’s the one with the gear and red arrow.
      4. When prompted, navigate to where you stored the firmware and follow the prompts.

      Hopefully, that will do it for you.

      Leonard

  3. I have my Taranis running version 2.0.17 and find that adding sound files to a model quite a pain as there is no dropdownlist available. Reading the above “\SOUNDS\en\model_name – Contains sounds which are played for a specific model which has the exact same name as this folder. ” When I open the Sounds\en I cannot find \model_name, is this a folder that the user has to add? As described above it would be a wonderful utility to have operating. I hope someone will reply and enlighten me.
    I would like to thank all contributors as they make this radio just fantastic!

    Thank Hank

    • Hi, Hank!

      I’ve never done that personally, but Scott Page has a nice little post here: http://www.rcgroups.com/forums/showpost.php?s=eaf380f037007fd5439ef8bf459cc9c2&p=28685386&postcount=1650

      In essence, it says:

      “If you have the name of a model you want read the name must be in the EN folder (if you’re configured for English).
      The file must be a .wav file 8 characters or less not including the .wav suffix.
      The .wav file must be 8, 16, or 32 hz mono file.
      See the configuration in the images below:
      You’ll notice that in Companion is reads “no repeat” but in the Tx is reads 1x (one time) — which is different from 1s (every 1 second)
      You’ll also notice that I have a leading “+” as a part of the model name – this is so all of the model names are grouped together in the list of sounds. Makes it easier to find them.”

      There are also a couple of links. From what he says, I infer that the “model_name” is a sound file named exactly like the model itself. The images show his configuration.

      Hope this helps!

      Leonard (mac44mag)

  4. Thank you Scott as a Novice flyer at 69yrs old I found your articles excellent to get to get started with my taranas plus
    Thank you again
    Colin

  5. Dear scott: i downloaded your SD on a 16 gig sd card i was wonder if i could use your sd card info that i just downloaded on my 16 gig card and replace it in my taranis or is the 16 gig too big of a sd card to put in a taranis,i was just wondering cause my sd card don’t have a place for firmware thanks i’ll wait on a permission reply thanks for all you do for us new B’s

    • I’ll take a shot at this one…..

      I’m not certain what the upper limit is for the card. The 2GB that comes with the TX is PLENTY for most folks. I log six to eight parameters at .5 sec. intervals, run Scott’s entire card with all of that information on it, and a bunch of images and lua scripts that I’ve picked up are also sitting there. I’ve never come close to filling up the card.

      If you’re concerned about the OEM SD card that ships with the transmitter, again, don’t worry about it. FrSky had a shipment of bad cards (some say there was paint on the contacts and/or internal problem in the card as well), but that was early last year, and since then the issue has gone away.

      Of far more relevance is the fact that for some unknown reason the SD card seems more susceptible to being corrupted than most other USB storage devices when you unplug the TX without practicing “Save Eject” on a Windows machine. Many of us (myself included) neglect taking that extra step. While I, personally, have never personally been bitten, too many others have reported the problem to ignore it.

      Hope this helps!

      Leonard (mac44mag)

Leave a Reply