Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The Tools page in Radio Settings is where you can select Lua script-based tools for execution. Lua scripts that are located on the SD card in the Tools folder will be listed here. Selecting a tool will execute it in full-screen mode. By default, EdgeTX includes several tools. Other tools can be downloaded and added to the SD card as well. The following tools are included in the default EdgeTX SD card.
The Model Locator tool helps to find a lost model based on the RSSI (if still available). The widget produces an audio representation (variometer style) of the RSSI from the lost model. The widget will also display the RSSI in a visible colorized bar (0-100%).
The Spectrum Analyzer tool will show the strength of signals in the 2.4GHz band. It uses the internal MULTI-Module as a 2.4GHz spectrum analyzer.
The display shows frequencies on the 2.4GHz spectrum, from 2400MHz to 2480MHz. The X (horizontal) axis shows the frequency in MHz and the Y (vertical) axis shows relative signal strength.
T: Frequency at the center of the plot (fixed at 2440MHz) S: Bandwidth of the plot (fixed at 80MHz) T: Position of the cursor (vertical line)
Pressing ENT and scrolling left and right allows the T value to be changed, which will move the vertical line to highlight a specific frequency.
The Wizard Loader tool assists you in setting up a new model by running a setup wizard for a particular model type. Once the model type is selected, the wizard will take you through a series of prompts and then configure your selected model based on the information provided.
NOTE: The wizard does not create a new model, it only configures the currently selected model. You must manually create a new model first and then run the wizard. If you run this wizard on an already configured model, it will overwrite your model settings!
Additional EdgeTX compatible Lua scripts can be downloaded from: https://github.com/EdgeTX/lua-scripts
The SD Card screen shows you the contents of your SD card, allows you to navigate the folders and interact with the files in the folders. All folders contain a README.txt file that describes what type of files belong in this folder. After selecting a file in one of the folders, you will be presented with some of the options below, depending on the file type that was selected:
Assign bitmap - Assigns the selected image file as the model image of the currently selected model.
Copy - Copies the selected file.
Delete - Deletes the selected file.
Execute - Executes a Lua script. Used for files ending in .lua
Flash [target]- Flashes the selected firmware file to the select target module. Examples: Flash Bootloader, Flast Internal Multi.
Paste - Pastes the copied file.
Play - Plays the selected sound file.
Rename - Renames the file.
View text - Views the selected .txt or .csv file.
The folders listed on the SD card screen are the same as what you will see when connecting your radio to your computer. Below are the folder names and explanations for all the folders that come with the default EdgeTX SD Card.
Place the firmware files that you want to flash in this folder. This folder is empty by default (except for the readme.txt file). When selecting a .bin file you will be given the option to flash the firmware to a particular module. Also, only firmware files in this location will be visible from the bootloader menu.
Place your custom model or splash screen image files in this folder. This folder is empty by default (except for the readme.txt file). Selecting an image file will give you the option to Assign Bitmap, which assigns the selected image file as the model image of the currently selected model.
The ideal image size for model images is 192x114 pixels. The picture format should be .png. The image file name should not exceed 9 characters.
Note: Although larger image sizes will work as they will be scaled, they take up more memory and will cause degraded performance with the user interface.
This is where the model files, label information, and preflight checklists are stored. Each model will have a model[#].yml file that contains all configured options. Additionally, there is a labels.yml file that contains all the label information for your models.
Models that are deleted via the radio will be moved to the DELETED folder that is included in this folder. The remaining model files are what will be visible on the Model Select screen.
If you have configured the Display checklist option in model settings, the model notes file goes in this folder. The model notes file must be a .txt file and must have the EXACT same name as the model it is for, for example: Mobula6.txt. The text in the file is up to the user.
This folder contains the radio.yml file. This file contains all the radio configuration data. If this file is corrupted or missing, the radio will go into Emergency Mode and will create a new radio.yml file with the default settings.
If the radio.yml file is manually edited, the manuallyEdited: tag must be set to 1 in the radio.yml file or the radio will think it is corrupted, go into Emergency Mode and will create a new radio.yml file with the default settings. The original .yml file will be saved in the folder.
This folder is where the EdgeTX sound packs for your radio get placed. The sound packs are language-specific and correlate to the Voice language option in Radio Setup. Selecting a sound file from this folder will give you the option Play, which plays the selected sound file.
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
This is where model template files are stored. By default, it will have the following sub-folders:
PERSONAL - If you save your models as templates, then they get stored here.
SoarETX - A collection of sailplane templates by: Jesper Frickmann
Wizard - Simple model templates that use the Lua Wizard scripts to configure the models.
This folder contains the theme packs for EdgeTX. The EdgeTX SD card comes with several theme packs automatically installed.
The ideal image size for Splash Screen images is the actual radio screen size (480x272 pixels for most color screen radios). The picture format should be .png. The image file name must be splash.png. Screen dimensions for the supported color screen radios can be found .
has a large repository of free image files that can be used with EdgeTX.
This is where the log files that are configured in the SD Logs are written. These files can be viewed with the View text option. This folder is empty by default (except for the readme.txt file).
This is where the screenshot image files that are configured in the Screenshot are written. This folder is empty by default (except for the readme.txt file).
This folder and its subfolders are where the Lua scripts get placed. It contains the following sub-folders by default. You can download additional Lua scripts from .
Functions - This folder is where the functions Lua scripts that can be activated by the Lua Script must be placed. This folder is empty by default (except for the readme.txt file). More information about function Lua scripts can be found here: .
Mixes - This folder is where the Lua mixer scripts shall be placed. This folder is empty by default (except for the readme.txt file). More information about Mixer Lua scripts can be found here:
Tools - Contains the Lua scripts that are available in the screen.
Wizards - Contains the Wizard Lua scripts that are available in the screen.
Sound packs are available for manual download at: . It is also possible to create custom sounds to use in EdgeTX. For your custom sounds to be playable by EdgeTX ensure that they meet the following criteria:
For a demonstration video of how to make your own custom sounds that will work with EdgeTX, check out:
You can download and add additional themes from: .
This is where the widget files are stored. You can add additional widgets to this folder to use with EdgeTX. For more information about the widgets that are pre-installed with EdgeTX, see . You can download additional widgets from .
The Radio Settings section contains all the options to configure your radio. Across the top of the page you will see icons that will take you to different pages of radio settings when selected. The default screen for the radio settings is the Tools screen.
Icons at the top of the radio settings screen include (in order from left to right):
The Theme screen allows you to apply different colored themes to your radio. By default, the EdgeTX SD card comes with the themes shown above. Long pressing on a selected theme will give you the following options:
Set Active - Sets the selected theme as the active theme.
Edit - Opens the theme editor to edit the selected theme.
Duplicate - Makes a copy of the selected theme.
Delete - Deletes the selected theme.
You can find more user-created themes and additional theme creation resources here: https://github.com/EdgeTX/themes
To edit a theme in the Theme Editor, select the color variable from the list on the left side of the screen. Once you do, the Edit Color screen will be shown.
Select the color using either the color scales on the left side of the screen. You can choose between the RGB and HSV color scales with the buttons at the upper right side of the screen.
Once you have your desired color, press the theme logo in the upper left corner to go back to the Edit Theme screen to select another color variable to edit. Once you are finished, press the theme logo to exit the Theme Editor and save your changes.
The Version screen displays information about the current EdgeTX version that is being used:
FW - Firmware name
VERS - Firmware version
DATE - Date firmware was compiled
TIME - Time firmware was compiled
OPTS - Build options that were enabled when compiled.
The Modules / RX Version gives you information about the activated RX modules for the currently selected model.
A complete list of build options can be found here:
The Trainer screen in Radio Settings is used to configure how the radio in Master mode will handle the signals from the radio in Slave mode.
For each of the four main control inputs (Ail, Ele, Thr, Rud), the following options can be configured (for each row, from left to right).
Mode - How the instructor’s radio will handles the signals from the student's radio
OFF - Stick values from the radio in Master mode will be used - no input from the radio in Slave mode.
+= Adds the stick values from both the radios in Master and Slave modes.
:= Replaces the stick values from the radio in Master mode with the stick values from the radio in Slave mode. (Default)
Source channel - The channel from the radio in Slave mode that is mapped the control input.
Weight - Percentage of stick travel to use of the radio in Slave mode. Use negative values to change the stick direction.
Cal (calibrate)- Sets the center stick value of the radio in Slave mode.
Multiplier - This value changes the weight of all the sticks together.
The trim from the radio in Master mode is usually used. Set the trims on the radio in Slave mode to their center.
The radio in Master mode is the one that gets bound to the model receiver.
Selecting one of the 6 buttons on the Radio Setup screen will take you to one of the additional setting screens below.
Many of the additional settings here are self-explanatory. Only those settings needing clarification will be mentioned below.
Mode - configures when to play sounds.
All - Beeps when the buttons are pressed and sounds are played when there are alerts or warnings.
No Key - No beeps when buttons are pressed or the scroll wheel is turned but does play sounds when there are alerts or warnings. Also plays sounds triggered by special functions.
Alarm - Only plays alarm or warning sounds. Also plays sounds triggered by special functions.
Quiet - No Beeps or sounds are played.
Volume
The master volume for the radio.
Wav volume
The volume for alerts and warnings and sounds that are played with the Play track special function
Background volume
The volume for background .wav files (music) that are played with the BGMusic special function
Repeat Zero
The time before the tone repeats in milliseconds.
Note: In order for the variometer to function, it must be turned on via the Vario special or global function. See Special Functions for more information on how to configure this.
Mode - configures when the radio vibrates.
All - Vibrates when the buttons are pressed and when there are alerts or warnings.
No Key - No vibrations when buttons are the pressed or scroll wheel is turned but does vibrate when there are alerts or warnings.
Alarm - Only vibrates for alarms or warning sounds.
Quiet - No vibrations are made.
An "alarms disabled" visual warning is displayed when the transmitter is turned on if the sound mode is set to quiet.
Checks if a receiver is still connected to the radio on attempted shutdown. Makes a audio and visual alert if one is detected.
Mode
Off – Always off.
Keys – Turns on when buttons are pressed.
Ctrl – Turns on when sticks, switches, and knobs are used.
Both – Turns on when buttons, sticks, switches, and knobs are used.
ON – Always on.
The length in seconds that the backlight is on. The minimum value is 5 seconds. The maximum value is 600 seconds.
The backlight turns on when there are alarms or warnings.
The GPS configuration settings are only for when a GPS has been installed on the radio, not the model's GPS.
The GPS coordinate format that will be displayed.
Adjust the transmitter's real-time clock to match the time determined by the GPS.
The Radio Setup screen is where you configure basic settings for your radio. It contains the following options:
Date - The current date. This date is used for the SD card log files.
Time - The current time. This time is used for the SD card log files.
Pwr Off delay - The delay between when the power button is pushed and when the radio shuts off. The options are: 0s, 1s, 2s, 3s, 4s. It is recommended to set at least a 1s delay in order to prevent the radio from being shut off in the case of an accidental button press.
Owner ID - Custom registration ID used only for users with ISRM modules.
Country code - Used by some RF modules to ensure adherence to local regulatory RF requirements. Options are America, Japan, Europe.
Voice language - Language for the voice pack. This setting and the voice pack folder on the SD card must match for the sounds to be played.
Units - Units of measure. Options are metric or imperial.
Play delay (sw. mid pos) - The minimum time in milliseconds a switch must be in the middle position before a special function will get activated. This is used to prevent the middle position from being activated on a three-position switch when switching from low position to high position.
USB Mode - Sets the default action when a USB cable is plugged into the USB data port and the radio is powered on. Options are: Ask, Joystick, Storage, and Serial.
Rotary Encoder Mode - Set to Normal by default. The Inverted option reverses the direction of the roller.
Default Channel Order - The default channel order for new models and the trainer screen. The letters stand for: A = Aileron, E = Elevator, T = Throttle, R = Rudder. Changing this setting does not affect existing models.
Mode - The stick mode that will be used for the transmitter. Defined by what actions the left stick takes. The options are:
1: Left = yaw+pit (pitch)
2: Left = yaw+thr (throttle)
3: Left = rol (roll)+pit (pitch)
4: Left = rol (roll)+thr (throttle)
Model quick select - Affects model selection screen. Both options require you first to mark the desired model using the scroll wheel or short tap.
When OFF: short/long tap (short/long ENTER) on the marked model will show the menu, where you can "Select model";
When ON: short tap (short ENTER) on the marked model will select it immediately. To activate the menu, make a long tap or long ENTER.
Global functions are special functions that apply to all models on the Radio. They are configured exactly as model Special Functions and the same functions are available. For more information about configuring Global Functions, refer to the Special Functions section as they are essentially the same.
The Hardware screen is where you configure hardware specific-settings for your radio. It contains the following configuration options:
Battery meter range - Sets the maximum and minimum voltage for the battery meter. This should be set based on the type of battery you are using.
Battery Calibration - Set this value to match the transmitter battery voltage.
Check RTC voltage - When enabled, checks the RTC battery at startup and warns you if the battery voltage is low.
ADC Filter - Enables or disables the ADC Filter. This filter can also be enabled/disabled per model in the model settings.
The ADC filter is a filter for the proportional channels (sticks, pots, sliders), smoothing out smaller fast movements that occur due to noise in the system electronics. Normally, this filter should be disabled for models with flight controllers.
Internal RF Type - Select the module type for the internal module bay. Options are: Multi, XJT, ISRM, CRSF. When CRSF is selected, you can also select the baud rate. You can read more about baud rates here.
External RF Sample Mode - Options are Normal and OneBit. The default setting of Normal should be used by most users. Only users of X9D+ and X7 radios may want to use OneBit mode.
The X9D+ and X7 radios have a slow inverter that causes problems with the reception of fast UART signals, resulting in telemetry warnings and issues with LUA scripts using the CRSF protocol. A 10k resistor on the circuit board could be replaced to fix the issue, but this was not always effective. EdgeTX has developed OneBit Mode, which changes the UART sampling behavior to ignore slow leading edges, allowing the CRSF protocol to be run at the full 400k baud rate without hardware modifications to the radio.
Serial Port - Displays a list of available auxiliary serial ports that can be configured and used. The listed ports are based on the ports that are available in the particular radio hardware. The ports listed below are for example only and may not be present in your radio.
AUX1 - First available auxiliary serial port can be configured with the below options:
OFF - Turned off.
Telem Mirror - The same telemetry data that goes to the external module bay is sent to the serial port.
Telemetry In - Receive telemetry data over the serial port.
SBUS Trainer - Connect the Instructor and Student radios over the serial port.
LUA - Send/receive data to/from Lua script.
GPS - Receive GPS telemetry data over the serial port.
CLI - Send commands to the radio via the command line.
Port Power - Enables or disables the power output on the power supply pins next to serial ports that are available on some radios (presently only TX16S has this feature).
Calibration - For calibrating your physical radio controls (sticks, pots, sliders, & 6-position switch). The radio will prompt you through the calibration steps.
For your gimbal calibration, use a left-to-right & up-to-down movement for the gimbals, not a circular movement! Additionally, use the normal amount of pressure at the endpoints. Excessive endpoint pressure will cause the gimbal to be miscalibrated. Also, do not forget to calibrate your 6-position switch!
Selecting one of the Inputs, Sticks, Pots, or Switches Buttons will open the configuration screen. On this screen, you will see all the physical radio controls pre-defined by EdgeTX. Here you can add a 3 character label to the control as well as change the type of control as needed.
The debug section allows for testing and debugging of the analog controls and keys.
Debug Analogs - These screens will show you the data for your analog controls (Sticks, Sliders, Pots, 6-position switch) and the touch screen on your radio. There are three views - Calibrated analog, Filtered Raw Analog with deviation, Unfiltered raw analog, and Min Max and range.
Debug Keys - This screen will show you the digital data for your keys, switches, trims, and the rotary encoder (roller).