Compilation Options¶

This page documents the CMake options available when building EdgeTX firmware. Most options have sensible defaults set by the target's CMakeLists.txt — you only need to override them when you have a specific reason to.

Target Selection¶

These are the most important options to set, as they determine which radio you are building for.

PCB¶

Selects the radio target.

PCBREV¶

Selects a specific variant within a PCB target. Valid values depend on the selected PCB:

TRANSLATIONS¶

Firmware language. Default: EN

Valid values: CN CZ DA DE EN ES FI FR HE HU IT JP KO NL PL PT RU SE SK TW UA

Feature Options¶

These options enable or disable firmware features. Defaults are typically set by the target, so you only need to override them if you want to add or remove a feature for a specific build.

Safety and Sanitizer Options¶

Runtime sanitizers are for native host tests and simulator/fuzzer binaries only. Do not flash sanitizer builds to a radio; firmware builds should use compiler/static safety checks instead.

AddressSanitizer and UndefinedBehaviorSanitizer should run together for regular native radio tests:

cmake --preset san-asan-ubsan
cmake --build --preset san-asan-ubsan

ThreadSanitizer is intentionally a separate build:

cmake --preset san-tsan
cmake --build --preset san-tsan

MemorySanitizer requires Clang and should be run separately because it cannot be combined with AddressSanitizer or ThreadSanitizer:

CC=clang CXX=clang++ cmake --preset san-msan
cmake --build --preset san-msan

The fuzzer smoke targets are available with Clang:

CC=clang CXX=clang++ cmake --preset fuzzers
cmake --build --preset fuzz-smoke

fuzz-smoke currently covers YAML parsing and the mixer/output control path. The mixer fuzzer feeds fuzzed model mixes, expos, limits, and analog inputs through repeated evalFlightModeMixes() calls under ASan+UBSan.

Recommended sanitizer runtime options are wired into the native test and CI targets. Leak detection is disabled for these automated smoke runs because the current native UI test harness retains process-lifetime LVGL objects at exit; ASan still checks invalid accesses and UBSan still checks undefined behavior.

ASAN_OPTIONS=abort_on_error=1:detect_leaks=0:check_initialization_order=1
UBSAN_OPTIONS=halt_on_error=1:print_stacktrace=1
TSAN_OPTIONS=halt_on_error=1:second_deadlock_stack=1

Hardware Configuration¶

These string options configure hardware behaviour and are normally set by the target.

PWR_BUTTON¶

How the power button works. Default is target-specific.

PPM_UNIT¶

PPM display unit. Default is target-specific.

DEFAULT_MODE¶

Default sticks mode. Leave blank to use the firmware default.

INTERNAL_GPS_BAUDRATE¶

Baud rate for the internal GPS, where supported. Default: 9600

LUA_SCRIPT_LOAD_MODE¶

Controls how Lua scripts are loaded and compiled. Leave blank to use the firmware default (bt on radio, T on simulator/debug builds). Accepts a combination of the following flags:

POPUP_LEVEL¶

Controls the verbosity of popup notifications. Default: 2 (set to 3 for FRSKY_RELEASE builds).

Debug & Tracing¶

These options are for development and debugging. All default to OFF.

Simulator Options¶

Release Build Options¶

These options are used to produce official manufacturer-specific firmware releases and are not needed for general development builds.

Compiler & Build Flags¶