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 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.
Selecting the Details button will open the Edit Theme Details screen. Here you can edit the name, author and description of the them.
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.
You can find more user-created themes and additional theme creation resources here:
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 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 radio in Master mode will handle the signals from the radio in Slave mode.
OFF - Stick values from the radio in Master mode will be used - no input from the radio in Slave mode.
Add - Adds the stick values from both the radios in Master and Slave modes.
Replace - 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.
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 section as they are essentially the same.
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.
A complete list of build options can be found here: https://github.com/EdgeTX/edgetx/wiki/Compilation-options
The Modules / RX Version gives you information about the activated RX modules for the currently selected model.
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 Enabled Features section of Radio Setup allows you to configure the Global settings for which tabs are visible in the Radio Setup and Model Settings area of EdgeTX.
Note: Turning off a tab only hides the tab and does not change the items already configured in that tab. For example, if you configure a special function and then turn off the special functions tab, the special function will still work as configured.
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. Selecting a .frsk file will give you the option to "Flash RX by int OTA".
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 used for thumbnails on the Model Manager screen is 156x92 pixels. If you plan to use the Model Info widget, you may want a increase the image size to 192x114 pixels for better visual quality at the increased size. For performance reasons, it is NOT recommeded to use a higher resolution image. The picture format should be .png. The image file name should not exceed 9 characters.
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 here.
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.#
Note: The maximum number of image files that EdgeTX can properly display in the image select dropdown is 799. Therefore, the maximum number of files in this folder should not exceed 799.
https://www.skyraccoon.com/ 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 special function 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 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.
Any model files that are found in this folder that are not listed in the Models.yml file (if used) will be moved to the UNUSED folder.
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 is where the screenshot image files that are configured in the special function 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 https://github.com/EdgeTX/lua-scripts.
Functions - This folder is where the functions Lua scripts that can be activated by the special function 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: Function Scripts.
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: Custom Mixer Scripts
Tools - Contains the Lua scripts that are available in the Tools screen.
Wizards - Contains the Wizard Lua scripts that are available in the Tools screen.
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.
Sound packs are available for manual download at: https://github.com/EdgeTX/edgetx-sdcard-sounds/releases. 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:
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
Note: The maximum number of sound files that EdgeTX can properly display in the sound select dropdown is 799. Therefore, the maximum number of files in this folder should not exceed 799.
For a demonstration video of how to make your own custom sounds that will work with EdgeTX, check out: https://www.youtube.com/watch?v=DqF7HUsFrnE
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.
You can download and add additional themes from: https://github.com/EdgeTX/themes.
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 Widgets. You can download additional widgets from https://github.com/EdgeTX/lua-scripts.
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.
Additional Settings Buttons - Additional configuration options for the named areas are available when selecting these buttons. More information about these configuration settings is on the next page - Additional Radio Settings
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.
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.
Mute if no sound: - When enabled, puts the transmitter in mute mode until a sound needs to be played. This prevents interference noise from high-powered TX modules from coming out of the transmitter speakers.
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.
Note: This option is only visible on custom compiled versions of EdgeTX with the Bluetooth flag enabled.
Mode - mode that the bluetooth module will be used in. The options are:
--- - Off
Telemetry - used for sending telemtry data over bluetooth.
Trainer - used for bluetooth trainer mode
Name - the name the bluetooth device will be seen as.
Settings Cog Icon - when selected will show you:
PIN Code - PIN code for bluetooth device in the radio (visible in Telemetry mode only)
Local addr - Identifying address of the bluetooth device in the radio.
Dist addr - Identifying address of bluetooth device that radio is connected to.
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.
AUX2 - Second available auxiliary serial port (depending on hardware), which has the same options as AUX1, except for External Module
USB-VCP - Virtual COM Port. This is one of the options presented when connecting your radio to the PC with most radios. Is often set to 'CLI' for radios with internal ExpressLRS RF modules in order to do firmware updates.
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 four 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).
External Module - This allows configuring the external access mod on runtime rather than by compilation option. First, configure the hardware port (only available on AUX1 as AUX2 has no TX DMA)
