Audio
OpenTX makes sounds in two ways: 1. Generating tones/beeps of different frequencies and durations 2. Playing audio files if present on a microSD card
One of the main features of OpenTX is its use of a sound pack placed on a microSD card. This sound pack contains audio files files used for sounds and announcements.
Sounds & Announcements take place in response to
- Model Independent event (events not related to the model loaded)
- Model Dependent events (events related to the model loaded)
- Global & Special Function triggers
The sound mapping/definitions file is used to generate audio files with phrases such as telemetry lost/recovered and units.
- SOUNDS/language/SYSTEM/language-country-tx.csvE.g. SOUNDS/en/SYSTEM/en-US-taranis.csv
It is a text file with lines of text. One line per sound file. Each line has three parts separated by semicolons.
- directory/;file_name.wav;Spoken phraseE.g. SOUNDS/en/SYSTEM;hello.wav;Welcome to open tea ex!
- File Name: 123456.wav (up to 6 characters plus .wav)
- Sample Rate: 32 kHz (or 16 Khz, 8Khz)
- Bits / Sample: 16 (or 8)
- Tracks: 1, mono
- Compression Codec: PCM (or u-law, a-law)
On the Tx SD CARD in the following folders
- SOUNDS/
- The root, top level
- SOUNDS/language/
- Files used by Global & Special Functions
- Different languages are supported
- E.g. SOUNDS/en/, SOUNDS/de/
- The language is set on the RADIO SETUP screen
- SOUNDS/language/SYSTEM/
- Files used by the system
- SOUNDS/en/model_name_folder/
- Files used for some model events
These sounds and announcements are not related to which model is loaded. They are configured in one of the following ways:
- Adding to or removing a sound file from the folder
- SOUNDS/language/SYSTEM/
- Configuring options on the Radio SETUP screen
- Radio GLOBAL FUNCTIONS screen
Events that may generate sounds and announcements are:
- Transmitter turned on and off
- E.g. SOUNDS/en/SYSTEM/hello.wav and SOUNDS/en/SYSTEM/bye.wav
- Note: bye.wav is not provided but will be played if present
- Trim up, down, center, ends/limits
- Telemetry lost, recovered
- Tx battery level low
- RF signal level low or critical
- Inactivity period reached (no sticks, switches, buttons or knobs were used)
- Throttle stick not all the way down when model is loaded
- Bad eeprom
- Tx antenna defective
- Trainer signal lost, recovered
- Sensor signal lost
- Servo, Receiver power overload (when using the FrSKY Redundancy Bus)
- Tx button presses and scroll wheel/knob turn
- Binding
- Range check
These sounds and announcements are related to which model is loaded. They are configured in one of the following ways:
- Adding to or removing a sound file from the folder
- SOUNDS/language/model_name
- Configuring options on the Radio SETUP screen
- Radio SPECIAL FUNCTIONS screen
Events that may generate sounds and announcements are:
- Timer seconds, count down reaches zero
- Switch, Slider or Pot not in a particular position when model loaded
- Center position beep for sticks, sliders and potentiometers
- Switch position changes
- Flight mode changes
To play sounds specific to a model without configuring them as a Special Function place sound files in the following folder:
- /SOUNDS/language/model_name/
- Replace model name spaces with an underscore "_"
- E.g. /SOUNDS/en/my_model/
The file names use the following format:
- Switches
- switchID-position.wav
- SA-up.wav
- SA-mid.wav (if position present)
- SA-down.wav
- Note: There is no equivalent for SA not up.
- Logical Switches
- switchID-condition.wav
- L1-up.wav (true)
- L1-down.wav (false)
- Note: There is no equivalent for L1 not up.
- Multiple Position Switches / Stepped Potentiometers
- P-switchNumber-position.wav
- P11.wav
- P16.wav
- P24.wav
- Flight Modes
- modeName-condition.wav
- No spaces in the flight mode name
- ABC–off.wav
- ABC–on.wav
Play Actions
- Play Track
- Pick a file from the list.
- Uses files placed in SOUNDS/language/
- Play Value
- Say the value of the selected parameter when the switch is active.
Enable options for both of the above are
- Played once, not during start up
- Play once when triggered but not when model is loaded, don't repeat it
- No repeat
- Play once when triggered, don't repeat it
- 1s to 60s
- Play once and then again every interval specified from 1 to 60 seconds
Music Actions
- BgMusic
- Starts playback of a background sound track picked from a list
- Uses files placed in SOUNDS/language/
- The switch must stay on to continue playback
- If the switch is turned off and then on again playback starts from the beginning
- BgMusic II
- Pauses the active BgMusic
- When the switch is turned off playback continues from where it was paused
- The BgMusic switch must remain on
Other Actions
- Vario
- Generates the tone/sound of a glider variometer
- Uses altitude or vertical speed telemetry data
- Volume
- Adjusts the audio volume for the entire radio
- Use any input from the list
- E.g. S1
The audio volume may be configured and controlled from three locations: 1. RADIO SETUP screen 2. GLOBAL FUNCTIONS screen 3. SPECIAL FUNCTIONS screen
Details of each are covered under the relevant sections.
Last modified 2yr ago