Special Functions
Last updated
Last updated
The Special Functions section is where you can configure the special functions that are included in EdgeTX. These special functions add additional functionality beyond normal model controls, such as enabling trainer mode, playing a sound, adjusting the radio backlight, adjusting radio volume, etc. On the special functions screen, you will see all configured special functions as well as some of the configured options such as function name, activation switch, if the function is enabled, and other configuration options.
To configure a special function, select the desired special function row and press the [Enter] button. Then, scroll with the [Roller] to select the attribute that you want to edit (it will be highlighted) and press the [Enter] button to edit it (it will now be blinking). Edit the option by scrolling with the [Roller] and pressing the [Enter] button to select the desired option. Once all the options are configured, press the [Return] button to exit out of editing mode for the special function.
All special functions have the configuration options below. Additional options may be added based on the selected function. See the Functions section below for these additional options.
Trigger - The switch or trigger that will make the special function active. Long pressing on this section will allow you to quickly select the category of the switch and filter the results. You can select the following filters: Switches, Trims, Logical Switches, Other and Invert
Function - The function that will be used. See below for function descriptions.
Enable - Toggle on/off to enable the function. To be able to activate the special function by a switch, it must be enabled. This option is usually the last option listed as a checkbox on the far right of the screen. Disabled special functions will not function regardless of the configured switch position.
Below are all the available functions in EdgeTX, what they do, as well as what additional configuration options that will be shown when the function is selected.
Adjust (Adjust Global Variable) - Changes the value of the specified global variable.
Global var - Select the global variable that you want to adjust.
Mode - Select the mode to change the global variable. Options are: Constant, Mixer Source, Global var, Inc/Decrement. Long-press the [Enter] button to select the mode.
Constant - Sets the specified global variable to the defined constant value.
Mixer Source - Sets the specified global variable to the defined mixer source value.
Global Var - Sets the specified global variable to the defined global variable value.
Inc/Decrement - Increments/decrements the specified global variable by the specified amount.
Audio Amp Off (select radios) - Disables the Audio Amplifier so that no sound comes from the speaker, including annoying feedback or interferance. This option is only available on select radios.
Backlight - adjusts the screen contrast (LED screens) or OLED brightness (OLED screens) based on the source defined in the value dropdown.
BgMusic - Plays the .wav file selected in the value field on a loop when enabled. The file shall be in the SOUNDS/(language)/ folder on the SD card.
BgMusic II - Temporarily pauses the .wav file playback specified in the BgMusic
Haptic - Causes the radio to vibrate (haptic feedback) when enabled.
Value - Type of vibration pattern. Options are: 0 - 3.
Repeat - Frequency to repeat the vibration pattern. Options are !- (do not vibrate at startup even if the switch is active), - (vibrate once), 1 thru 60 (vibrate every xx seconds).
Inst. Trim (Instant Trim) - Sets all trims to the current values of their respective sticks.
Lua (Lua Script) - Executes the Lua script defined in the value field. The Lua script must be located in /SCRIPTS/FUNCTIONS/ folder on the SD card. Lua scripts that display information on the screen cannot be executed with this special function.
Value - LUA script file to play from the SD card.
Repeat - Frequency to repeat the Lua script. Options are: ON (repeat indefinitely as long as switch is active) or 1x (once)
Overr.= (Channel Override) - Overrides the defined channel with the defined value.
CH - Channel to be overridden
Value - Value to replace the normal channel value. (Range -100 to +100)
Play Sound - Plays the sound selected in the value field when activated.
Value - Sound to play. Possible values are Beep1/2/3, Warn1/2, Cheep, Ratata, Tick, Siren, Ring, SciFi, Robot, Chirp, Tada, Crickt, AlmClk. Note: SD card sound pack is not required.
Repeat - Frequency to repeat the sound. Options are !- (do not play at startup even if the switch is active), - (play once), 1 thru 60 (play every xx seconds).
Play Track - Plays the .wav sound file selected in the value field when activated.
Value - .wav sound file to play from the SD card.
Repeat - Frequency to repeat the track. Options are !- (do not play at startup even if the switch is active), - (play once), 1 thru 60 (play every xx seconds).
Play Val - Announces the value of the selected element in the value field.
Value - The source for the value to announce. It can be an input, stick, pot, slider, trim, physical and logical switch, trainer import channel value, global variable, telemetry sensor or channel.
Repeat - Frequency to repeat the announcement. Options are !- (do not announce at startup even if the switch is active), - (announce once), 1 thru 60 (announce every xx seconds).
Push CS - (Push Customizable Switch) (select radios) - Presses the designated switch for the designated period of time.
Switch - Which customizable switch to press
Time - How long to press the customizable switch for. Options are 0.0 to 25.5 seconds. Input to the button will be ignored while this time is being served, allowing this to automate a press of the button, and block input (and retrigger of the function) until the time has elapsed.
RacingMode - Enables racing mode (low latency) for FrSky Archer RS receivers. Racing mode must also be enabled in External RF Module Settings.
Reset (Reset Timer)- Resets the timer or telemetry specified in the value back to their initial values.
Reset - Options are Tmr 1, Tmr 2, Tmr 3, All, and Telemetry. See Reset Telemetry for more information on what data is reset for each option.
RGB Led (select radios) - Run the selected LED related Lua script to animate RGB leds on the handset.
Value - LUA script file to play from the SD card (in the /SCRIPTS/RGBLED folder).
Repeat - Frequency to repeat the Lua script. Options are: ON (repeat indefinitely as long as switch is active) or 1x (once).
Screenshot - Creates screenshot as a .bmp file in the SCREENSHOT folder on the SD Card.
SD Logs - Creates a log .csv file of the radio and telemetry values in the LOGS folder on the SD Card. The radio will create a new entry into the log file based on the frequency configured in the Value setting. The value options are 0.0s - 25.5s (Note: 0.0 effectively disables this option). Each time the function is activated, the radio will create a new log file provided that the function is activated at least as long as the value setting. Note: Logging will not start if SD card has less than 50mb of free space.
Set (Set Timer) - Sets the specified timer to the specified value.
Timer - Options are Tmr 1, Tmr 2, Tmr 3
Value - The range is 00:00:00 to 08:59:59
SetFailsafe - Sets the custom failsafe values for the configured RF module (Internal/External) to the current stick position when activated. For this option to work, the Failsafe mode for the RF module must be set to custom.
Set Screen - Sets the telemetry screen or return to main view screen.
Value - 0 - 4. When set to 0, the normal main view will be loaded. When set to 1 - 4, the corresponding telemetry screen will be shown (if configured).
Repeat - Options are !- (do not trigger at startup even if the switch is active) and - (trigger once).
Trainer - Enables trainer mode.
Value - Specifies which controls will be given over to the student. Options include Axis (all sticks/primary inputs), Rud (Rudder), Ele (Elevator), Thr (Throttle), Ail (Aileron), and Chans (all channels).
Vario - Enables the variometer beeping sound for the ascent and descent of the model.
Volume - Changes the radio volume. The change source is specified in the Volume dropdown.
Pressing the [PAGE>] button will take you to the Telemetry screen.
