Skip to main content

Firmware Flasher Tab

Here you update your firmware and select the features you require for you build.

info

The Firmware contains only hardware support. Board configuration defines board specific hardware. With the Build Configuration you can add or remove features you need.

Firmware Flasher tab

Preparation

  • Upgrade to the latest Betaflight Configurator.

  • Before upgrading always save a diff of the current configuration. Using status command you get some info about hardware being used.

  • You can also save a diff using Presets tab using the save backup button.

  • Except master and profile most settings should be able to migrate from a previous version.

caution

Please follow these steps in order to be able to restore in the event something is not supported.

Configurator only supports Betaflight version 4.0 and newer. Older versions only have access to the firmware flasher tab or CLI.

Flashing

TypeVersion
ReleaseStable
CandidatePreview
DevelopmentTest
  • After selecting a build type select the board using the list or use the Auto-detect button.
  • Always use Full Chip Erase unless instructed otherwise.
note

Using Show Release Candidates with Expert Mode enabled gives access to development builds.

Board Defines

We have defines for ACC, BARO, FLASH, GYRO, MAX7456, FLASH or SDCARD in the board configuration.

info

If your board pheriperals are not recognized please help us add the required configuration details.


Reach out to us on our [Discord server](https://discord.betaflight.com/invite) or create an issue in the Betaflight unified targets repo.
To get the required information follow this procedure:

1. Flash your board with the Core Only switch enabled
2. Go to the CLI tab and click the Submit Support Data button.
3. With this generated support ID we have all required information to update board configuration files.

Radio Protocols

Select the receiver wire protocol used. The most common are:

ProtocolReceiver
CRSFTBS Crossfire or ExpressLRS
GHSTImmersion RC Ghost
SBUSFrSky or Futaba
note

EXPRESSLRS (SPI) receivers uses CRSF protocol.
FrSky (SPI) receivers uses SBUS or FPORT protocol depending on the receiver firmware used.

Telemetry Protocols

Select the telemetry protocol used. For CRSF, ELRS or GHST protocols this is included by default to ease configuraton.

note

ExpressLRS uses CRSF protocol. SPI configuration is done in the board configuration.

Motor Protocol

Select ESC protocol being used. DShot is default.

tip

When needed additional protocols like PWM or SERVOS please add them using Custom Defines.

Other Options

OptionDescription
AKK (SA Fix)Smartaudio patch for AKK hardware
Acro TrainerEnable Acro Trainer support
Batt. ContinueSee #11084
Cam. ControlEnable Camera Control
DashboardEnable Post-flight overview screen
EMFAT (AutoRun, Icon)Enable FAT emulation and icon for onboard flash or MSC
ESC Serial (SK) Inc. 4wayEnable SimonK and ESC Serial support for flasing via 4way interface
Flash StorageEnable blackbox Flash Tools
FrSky OSDEnable FrSky OSD support
GPSEnable GPS and GPS_PLUS_CODES
LED StripEnable 32 LEDs
LED Strip 64Enable 64 LEDs
MagnetometersEnable magnetometer
OSD (SD)Enable SD OSD (onboard MAX7456 required)
OSD (HD)Enable HD OSD
PIN IOEnable PINIO
ServosEnable Servo support
VTXEnable VTX

Troubeshooting

tip
  • Use a good quality data cable not a power cable.
  • USB hubs or OTG cables are sometimes needed with recent computers and in other cases they can cause issues.
  • Try disconnecting all cables from your PC first, try rebooting, other ports, upgrade system drivers. Remove other USB connections.
  • Try DFU mode (use boot button on FC while plugging in, use Activate Boot Loader / DFU button in setup tab or use bl command in CLI.
  • Sometimes peripherals on the flight controller such as receivers or GPS devices can hijack port communication requiring de-soldering.
  • Linux needs configuration to allow flashing.
  • MacOS or Windows do not need any drivers.
  • If it still doesn't work try IRC Driver Fix or Zadig on Windows platform.

Expert Options

Custom Defines

This is mostly for development as you can add a custom defines to bake a feature into the build. Please omit the USE_ part of a #define. To remove a feature simple add the minus sign before it.

Commit Field

For development we can choose a specific PR from the list or even build a PR by adding the firmware PR number into the field. Prepend the number with the number # sign.

Local Flashing

To flash local development firmware with optional custom configuration use the Load Firmware local button to load board configuration or click Auto-detect or when in DFU mode select a board manually.

note

If using a local configuration file use the same button again to load a local hex file.