定义
Betaflight 使用 #define 宏语法来包含在构建时支持其他功能或特定硬件模块的软件组件。
每个板的配置文件中都包含一组基本的定义。在构建时，用户可以在地面站的固件闪存选项卡中添加额外的定义。
从 Other Options 列表中选择 GPS、Baro 等时，会自动添加任何其他所需或相关的定义。例如，如果用户请求 BARO，则会自动包含 USE_BARO 定义以及所有受支持的 baro 硬件定义。
可以添加额外的定义：
- 对于云构建，通过在
Custom Defines列表中输入定义名称，不带USE_前缀，并用空格分隔，例如ANA EXTI。 - 通过在与其他定义匹配的语法中添加定义来本地构建，
例如
-DUSE_ANA -DUSE_EXTI。
用户可以通过在刷新后检查构建日志来查看构建中定义的完整列表。刷新完成后，日志链接将出现在“刷新”选项卡中。稍后，可以使用右下角的 Log 按钮从地面站的主设置页面加载它。还可以使用附近的 Options 按钮显示所包含的构建选项的摘要。
下面提供了截至 2026 年 1 月的完整定义列表。该列表是使用 grep --exclude-dir=config -Irh '^[^/].*' src/main/ | grep -wo 'USE_[0-9A-Z_]\+' | sort | uniq 生成的
备注
并非此列表中的所有定义都是“安全的”；有些是过时的，有些没有得到积极维护。 注释掉的行上的定义不包含在列表中。 有些定义用于内部寄存器定义，而不是最终用户代码选项。
USE_64BIT_TIME
USE_ABSOLUTE_CONTROL
USE_ACC
USE_ACCGYRO_BMI160
USE_ACCGYRO_BMI270
USE_ACCGYRO_ICM40609D
USE_ACCGYRO_ICM45605
USE_ACCGYRO_ICM45686
USE_ACCGYRO_IIM42652
USE_ACCGYRO_IIM42653
USE_ACCGYRO_LSM6DSO
USE_ACCGYRO_LSM6DSV16X
USE_ACC_ICM20601
USE_ACC_ICM20602
USE_ACC_ICM20608G
USE_ACC_MPU6000
USE_ACC_MPU6050
USE_ACC_MPU6500
USE_ACC_SPI_ICM20601
USE_ACC_SPI_ICM20602
USE_ACC_SPI_ICM20608G
USE_ACC_SPI_ICM20649
USE_ACC_SPI_ICM20689
USE_ACC_SPI_ICM42605
USE_ACC_SPI_ICM42688P
USE_ACC_SPI_MPU6000
USE_ACC_SPI_MPU6500
USE_ACC_SPI_MPU9250
USE_ACRO_TRAINER
USE_ADC
USE_ADC_INTERNAL
USE_ADVANCED_TPA
USE_AIRMODE_LPF
USE_AKK_SMARTAUDIO
USE_ALTITUDE_HOLD
USE_ATBSP_DRIVER
USE_AUTO_ACKKNOWLEDGEMENT
USE_BARO
USE_BARO_2SMBP_02B
USE_BARO_BMP085
USE_BARO_BMP280
USE_BARO_BMP388
USE_BARO_DPS310
USE_BARO_LPS
USE_BARO_LPS22DF
USE_BARO_MS5611
USE_BARO_QMP6988
USE_BARO_SPI_2SMBP_02B
USE_BARO_SPI_BMP280
USE_BARO_SPI_BMP388
USE_BARO_SPI_DPS310
USE_BARO_SPI_LPS
USE_BARO_SPI_LPS22DF
USE_BARO_SPI_MS5611
USE_BARO_SPI_QMP6988
USE_BATTERY_CONTINUE
USE_BATTERY_VOLTAGE_SAG_COMPENSATION
USE_BEEPER
USE_BIND_ADDRESS_FOR_DATA_STATE
USE_BLACKBOX
USE_BLACKBOX_VIRTUAL
USE_BOARD_INFO
USE_BRUSHED
USE_BRUSHED_MOTORS
USE_BST
USE_BUTTONS
USE_CAMERA_CONTROL
USE_CANVAS
USE_CHIRP
USE_CLI
USE_CLI_BATCH
USE_CLI_DEBUG_PRINT
USE_CMS
USE_CMS_FAILSAFE_MENU
USE_CMS_GPS_LAP_TIMER_MENU
USE_CMS_GPS_RESCUE_MENU
USE_CONFIG
USE_CONFIG_TARGET_PREINIT
USE_CRAFTNAME_MSGS
USE_CRSF_CMS_TELEMETRY
USE_CRSF_LINK_STATISTICS
USE_CRSF_OFFICIAL_SPEC
USE_CRSF_V3
USE_CUSTOM_BOX_NAMES
USE_DASHBOARD
USE_DEBUG_PIN
USE_DMA
USE_DMA_MUX
USE_DMA_SPEC
USE_D_MAX
USE_DSHOT
USE_DSHOT_BITBAND
USE_DSHOT_BITBANG
USE_DSHOT_DMAR
USE_DSHOT_TELEMETRY
USE_DSHOT_TELEMETRY_STATS
USE_DYN_IDLE
USE_DYN_LPF
USE_DYN_NOTCH_FILTER
USE_EMFAT_AUTORUN
USE_EMFAT_ICON
USE_EMFAT_README
USE_EMFAT_TOOLS
USE_ESC_SENSOR
USE_ESC_SENSOR_INFO
USE_ESC_SENSOR_TELEMETRY
USE_ESCSERIAL
USE_ESCSERIAL_SIMONK
USE_EXST
USE_EXTENDED_CMS_MENUS
USE_F7_CHECK_TX
USE_FEEDFORWARD
USE_FIRMWARE_PARTITION
USE_FLASH
USE_FLASH_BOOT_LOADER
USE_FLASH_CHIP
USE_FLASHFS
USE_FLASH_M25P16
USE_FLASH_MEMORY_MAPPED
USE_FLASH_OCTOSPI
USE_FLASH_PY25Q128HA
USE_FLASH_QUADSPI
USE_FLASH_READS_USING_4LINES
USE_FLASH_SPI
USE_FLASH_TEST_PRBS
USE_FLASH_TOOLS
USE_FLASH_W25M
USE_FLASH_W25M02G
USE_FLASH_W25M512
USE_FLASH_W25N
USE_FLASH_W25N01G
USE_FLASH_W25N02K
USE_FLASH_W25Q128FV
USE_FLASH_WRITES_USING_4LINES
USE_FRSKYOSD
USE_FULL_LL_DRIVER
USE_GIMBAL
USE_GPS
USE_GPS_LAP_TIMER
USE_GPS_NMEA
USE_GPS_PLUS_CODES
USE_GPS_RESCUE
USE_GPS_UBLOX
USE_GYRO
USE_GYRO_CLKIN
USE_GYRO_DLPF_EXPERIMENTAL
USE_GYRO_ICM20601
USE_GYRO_ICM20602
USE_GYRO_ICM20608G
USE_GYRO_L3GD20
USE_GYRO_LPF2
USE_GYRO_MPU6050
USE_GYRO_MPU6500
USE_GYRO_OVERFLOW_CHECK
USE_GYRO_REGISTER_DUMP
USE_GYRO_SLEW_LIMITER
USE_GYRO_SPI_ICM20601
USE_GYRO_SPI_ICM20602
USE_GYRO_SPI_ICM20608G
USE_GYRO_SPI_ICM20649
USE_GYRO_SPI_ICM20689
USE_GYRO_SPI_ICM42605
USE_GYRO_SPI_ICM42688P
USE_GYRO_SPI_MPU6000
USE_GYRO_SPI_MPU6500
USE_GYRO_SPI_MPU9250
USE_HAL_DRIVER
USE_HARDWARE_REVISION_DETECTION
USE_HOTT_TEXTMODE
USE_HUFFMAN
USE_I2C
USE_I2C_DEVICE_0
USE_I2C_DEVICE_1
USE_I2C_DEVICE_2
USE_I2C_DEVICE_3
USE_I2C_DEVICE_4
USE_I2C_GYRO
USE_I2C_OLED_DISPLAY
USE_I2C_PULLUP
USE_IMU_CALC
USE_INTEGRATED_YAW_CONTROL
USE_INVERTER
USE_ITERM_RELAX
USE_LATE_TASK_STATISTICS
USE_LAUNCH_CONTROL
USE_LED_STRIP
USE_LED_STRIP_64
USE_LED_STRIP_STATUS_MODE
USE_LPUART
USE_LPUART1
USE_MAG
USE_MAG_AK8963
USE_MAG_AK8975
USE_MAG_DATA_READY_SIGNAL
USE_MAG_HMC5883
USE_MAG_IST8310
USE_MAG_LIS2MDL
USE_MAG_LIS3MDL
USE_MAG_MPU925X_AK8963
USE_MAG_QMC5883
USE_MAG_SPI_AK8963
USE_MAG_SPI_HMC5883
USE_MAIN_ARGS
USE_MAX7456
USE_MCO
USE_MCO_DEVICE1
USE_MCO_DEVICE2
USE_MOTOR
USE_MPU9250_MAG
USE_MSP_CURRENT_METER
USE_MSP_DISPLAYPORT
USE_MSP_DISPLAYPORT_FONT
USE_MSP_OVER_TELEMETRY
USE_MSP_PUSH_OVER_VCP
USE_MSP_UART
USE_MULTICORE
USE_MULTISHOT
USE_OCTOSPI
USE_OCTOSPI_DEVICE_1
USE_OCTOSPI_EXPERIMENTAL
USE_OLED_GPS_DEBUG_PAGE_ONLY
USE_ONESHOT
USE_OPTICALFLOW
USE_OPTICALFLOW_MT
USE_OSD
USE_OSD_ADJUSTMENTS
USE_OSD_HD
USE_OSD_OVER_MSP_DISPLAYPORT
USE_OSD_PROFILES
USE_OSD_QUICK_MENU
USE_OSD_SD
USE_OSD_STICK_OVERLAY
USE_OVERCLOCK
USE_OVERRIDE_SOFTSERIAL_BAUDRATE
USE_PARAMETER_GROUPS
USE_PERSISTENT_MSC_RTC
USE_PERSISTENT_OBJECTS
USE_PERSISTENT_STATS
USE_PID_AUDIO
USE_PINIO
USE_PINIOBOX
USE_PIN_PULL_UP_DOWN
USE_PIOUART
USE_PIOUART0
USE_PIOUART1
USE_PIOUART2
USE_PIOUART3
USE_PIOUART4
USE_PIOUART5
USE_PIOUART6
USE_PIOUART7
USE_PIOUART8
USE_PIOUART9
USE_POSITION_HOLD
USE_PROFILE_NAMES
USE_PROSHOT
USE_PWM_OUTPUT
USE_QUAD_MIXER_ONLY
USE_QUADSPI
USE_QUADSPI_DEVICE_1
USE_RACE_PRO
USE_RANGEFINDER
USE_RANGEFINDER_HCSR04
USE_RANGEFINDER_MT
USE_RANGEFINDER_TF
USE_RANGEFINDER_XXX
USE_RCDEVICE
USE_RC_SMOOTHING_FILTER
USE_RC_STATS
USE_RESOURCE_MGMT
USE_RPM_FILTER
USE_RPM_LIMIT
USE_RTC_TIME
USE_RUNAWAY_TAKEOFF
USE_RX_BIND
USE_RX_CC2500
USE_RX_CC2500_SPI_DIVERSITY
USE_RX_CC2500_SPI_PA_LNA
USE_RX_CX10
USE_RX_EXPRESSLRS
USE_RX_FLYSKY
USE_RX_FLYSKY_SPI_LED
USE_RX_FRSKY_SPI
USE_RX_FRSKY_SPI_D
USE_RX_FRSKY_SPI_TELEMETRY
USE_RX_FRSKY_SPI_X
USE_RX_H8_3D
USE_RX_INAV
USE_RX_KN
USE_RX_LINK_QUALITY_INFO
USE_RX_LINK_UPLINK_POWER
USE_RX_MSP
USE_RX_MSP_OVERRIDE
USE_RX_NRF24
USE_RX_PPM
USE_RX_PWM
USE_RX_REDPINE_SPI
USE_RX_RSNR
USE_RX_RSSI_DBM
USE_RX_SFHSS_SPI
USE_RX_SPEKTRUM
USE_RX_SPEKTRUM_TELEMETRY
USE_RX_SPI
USE_RX_SX127X
USE_RX_SX1280
USE_RX_SYMA
USE_RX_V202
USE_RX_XN297
USE_SBUS_CHANNELS
USE_SDCARD
USE_SDCARD_SDIO
USE_SDCARD_SPI
USE_SENSOR_NAMES
USE_SERIAL_4WAY_BLHELI_BOOTLOADER
USE_SERIAL_4WAY_BLHELI_INTERFACE
USE_SERIAL_4WAY_SK_BOOTLOADER
USE_SERIAL_PASSTHROUGH
USE_SERIAL_RX
USE_SERIALRX
USE_SERIALRX_CRSF
USE_SERIALRX_FPORT
USE_SERIALRX_GHST
USE_SERIALRX_IBUS
USE_SERIALRX_JETIEXBUS
USE_SERIALRX_MAVLINK
USE_SERIALRX_SBUS
USE_SERIALRX_SPEKTRUM
USE_SERIALRX_SRXL2
USE_SERIALRX_SUMD
USE_SERIALRX_SUMH
USE_SERIALRX_TARGET_CUSTOM
USE_SERIALRX_XBUS
USE_SERVOS
USE_SIGNATURE
USE_SIMPLIFIED_TUNING
USE_SMARTAUDIO_DPRINTF
USE_SMARTAUDIO_NOPULLDOWN
USE_SOFT_I2C
USE_SOFTSERIAL
USE_SOFTSERIAL1
USE_SOFTSERIAL2
USE_SPEC_PREARM_SCREEN
USE_SPEKTRUM_BIND
USE_SPEKTRUM_BIND_PLUG
USE_SPEKTRUM_CMS_TELEMETRY
USE_SPEKTRUM_REAL_RSSI
USE_SPEKTRUM_REGION_CODES
USE_SPEKTRUM_RSSI_PERCENT_CONVERSION
USE_SPEKTRUM_VIRTUAL_RSSI
USE_SPEKTRUM_VTX_CONTROL
USE_SPEKTRUM_VTX_TELEMETRY
USE_SPI
USE_SPI_DEVICE_0
USE_SPI_DEVICE_1
USE_SPI_DEVICE_2
USE_SPI_DEVICE_3
USE_SPI_DEVICE_4
USE_SPI_DEVICE_5
USE_SPI_DEVICE_6
USE_SPI_DMA_ENABLE_EARLY
USE_SPI_DMA_ENABLE_LATE
USE_SPI_GYRO
USE_SPI_MAG
USE_SPRACING_PERSISTENT_RTC_WORKAROUND
USE_STACK_CHECK
USE_TARGET_CONFIG
USE_TELEMETRY
USE_TELEMETRY_CRSF
USE_TELEMETRY_FRSKY_HUB
USE_TELEMETRY_GHST
USE_TELEMETRY_HOTT
USE_TELEMETRY_IBUS
USE_TELEMETRY_IBUS_EXTENDED
USE_TELEMETRY_JETIEXBUS
USE_TELEMETRY_LTM
USE_TELEMETRY_MAVLINK
USE_TELEMETRY_NRF24_LTM
USE_TELEMETRY_SENSORS_DISABLED_DETAILS
USE_TELEMETRY_SMARTPORT
USE_TELEMETRY_SRXL
USE_THROTTLE_BOOST
USE_THRUST_LINEARIZATION
USE_TIMEOUT_4WAYIF
USE_TIMER
USE_TIMER_AF
USE_TIMER_DMA
USE_TIMER_MAP_PRINT
USE_TIMER_MGMT
USE_TIMER_UP_CONFIG
USE_TRANSPONDER
USE_TXRX_LED
USE_UART
USE_UART0
USE_UART1
USE_UART10
USE_UART2
USE_UART3
USE_UART4
USE_UART5
USE_UART6
USE_UART7
USE_UART8
USE_UART9
USE_UNCOMMON_MIXERS
USE_USART6
USE_USART7
USE_USART8
USE_USB_ADVANCED_PROFILES
USE_USB_CDC_HID
USE_USB_DETECT
USE_USB_MSC
USE_VARIO
USE_VCP
USE_VIDEO_SYSTEM
USE_VIRTUAL_ACC
USE_VIRTUAL_BARO
USE_VIRTUAL_CURRENT_METER
USE_VIRTUAL_ESC
USE_VIRTUAL_GPS
USE_VIRTUAL_GYRO
USE_VIRTUAL_LED
USE_VIRTUAL_MAG
USE_VTX
USE_VTX_COMMON
USE_VTX_COMMON_FREQ_API
USE_VTX_CONTROL
USE_VTX_MSP
USE_VTX_RTC6705
USE_VTX_RTC6705_SOFTSPI
USE_VTX_SMARTAUDIO
USE_VTX_TABLE
USE_VTX_TRAMP
USE_WING
USE_WS2811_SINGLE_COLOUR
USE_YAW_SPIN_RECOVERY