How betaflight/betaflight-configurator works
Betaflight App is a cross-platform flight-controller configuration and management application. The main workflow is to connect to a controller, exchange MSP commands and state, then use configuration tabs to inspect or change settings; other major branches include firmware flashing and Blackbox log analysis. The README documents the PWA and Android wrapper, while source-index references and excerpts establish only selected internal calls. Several feature directories are unsampled, so their internals and connections are intentionally left unspecified.
Main entry points: App.vue App shell · connection.ts Connection state · msp.ts MSP transport · tabs Configuration features
Components 22
Application shell
- App shell
src/App.vue - Device picker
src/components/device-picker/ConnectButton.vue
Device connectivity
- Connection state
src/stores/connection.ts - Device handling
src/js/device_handler.ts - Serial backends
src/js/serial_backend.ts - Device protocols
src/js/protocols/devices.ts - MSP transport
src/js/msp.ts - MSP codes
src/js/msp/MSPCodes.ts - MSP codecs
src/js/msp/MSPHelper.ts
Controller management
- Controller state
src/stores/fc.ts - Configuration features
src/components/tabs - CLI session
src/composables/useMspCliSession.ts - Firmware flashing
src/composables/useFirmwareFlashing.ts
Blackbox analysis
- Blackbox viewer
src/blackbox-viewer/App.vue - Flight log state
src/blackbox-viewer/stores/log.ts - Log parser
src/blackbox-viewer/flightlog.ts - Graph state
src/blackbox-viewer/stores/graph.ts - Graph rendering
src/blackbox-viewer/grapher.ts
Platform bridges
- Android wrapper
android/app/src/main/java/betaflight/app/MainActivity.java - Native plugins
android/app/src/main/java/betaflight/app/protocols/serial/BetaflightSerialPlugin.java - Desktop bridges
src-tauri/src/lib.rs
Other components
- App user
Connections 24
- App user → App shell: uses
README.md - App shell → Device picker: renders
src/App.vue - App shell → Connection state: reads state
src/App.vue - Device picker → Connection state: initiates connection
- Connection state → Device handling: uses
src/stores/connection.ts - Connection state → MSP transport: uses
src/stores/connection.ts - MSP transport → Serial backends: uses transport
- MSP transport → MSP codes: dispatches commands
- MSP codecs → Controller state: updates state
src/js/msp/MSPHelper.ts - MSP codecs → MSP codes: encodes commands
src/js/msp/MSPHelper.ts - App shell → Configuration features: hosts tabs
- Configuration features → MSP transport: requests controller data
- Configuration features → Controller state: uses controller state
- CLI session → Controller state: checks version
src/composables/useMspCliSession.ts - CLI session → Serial backends: schedules reconnect
src/composables/useMspCliSession.ts - App shell → Blackbox viewer: opens viewer
- Blackbox viewer → Flight log state: uses log state
src/blackbox-viewer/App.vue - Flight log state → Log parser: parses logs
src/blackbox-viewer/stores/log.ts - Blackbox viewer → Graph state: uses graph state
src/blackbox-viewer/App.vue - Graph state → Flight log state: reads log state
src/blackbox-viewer/stores/graph.ts - Graph state → Graph rendering: registers renderer
src/blackbox-viewer/stores/graph.ts - App shell → Android wrapper: runs as wrapper
README.md - Android wrapper → Native plugins: registers plugins
android/app/src/main/java/betaflight/app/MainActivity.java - Desktop bridges → Device protocols: provides bridges