用統(tǒng)計數(shù)據揭示BaseFlight開源飛控代碼工程的全貌

1、背景

Baseflight是一款開源的飛行控制軟件，最初是MultiWii項目的32位分支，旨在為多旋翼、固定翼和直升機等飛行器提供高效的飛行控制解決方案。Baseflight的發(fā)展歷程可以追溯到MultiWii項目，它在性能和功能上進行了顯著的優(yōu)化和擴展，特別是在移植到更強大的32位處理器（如STM32）后，解決了早期8位單片機的性能瓶頸問題。

1.開源與社區(qū)支持

Baseflight是一個完全開源的項目，代碼托管在GitHub上（https://github.com/multiwii/baseflight，下載其實幾百k，純c代碼的空間都不大），獲得了全球眾多開發(fā)者和愛好者的貢獻和支持。

2.兼容多種硬件平臺：

Baseflight支持多種流行的飛行控制器硬件，例如NAZE32、SKYLINE32 Mini等，這些硬件具有高性價比和良好的性能表現(xiàn)（http://www.yinyanmodel.com/ch/ProductView.asp?ID=393）。

3.豐富的配置選項：

通過Baseflight Configurator圖形用戶界面，用戶可以方便地調整飛控參數(shù)，如PID值、傳感器校準等，以滿足不同的飛行需求。

所謂調整飛控參數(shù)，就是調整源碼中類似這種的變量：

float magneticDeclination = 0.0f; ? ? ? // calculated at startup from config

4.命令行CLI（command line）接口：

除了圖形界面外，Baseflight還提供了命令行接口（CLI），允許用戶直接通過串口進行高級設置和調試操作。

5.家族譜系：

Baseflight是Cleanflight和Betaflight等后續(xù)項目的前身。Cleanflight在其基礎上增加了更多特性，而Betaflight則進一步提升了性能，成為目前FPV競速無人機中最常用的固件之一https://oscarliang.com/baseflight-cleanflight-comparison/。

2、代碼結構概述

三層架構：驅動-計算-工具

BaseFlight代碼通常采用分層架構。最上層是與硬件交互的驅動層，負責采集傳感器數(shù)據（如加速度計、陀螺儀、磁力計等）并將控制信號輸出到電機驅動模塊。中間層是核心控制算法層，包含姿態(tài)估計、導航和控制算法等。最下層是一些基礎的工具函數(shù)庫。

圖1 筆者用source insight閱讀baseflight全代碼

主要文件的統(tǒng)計和解釋

整個項目不過1.6w行，78個文件。最大的文件是cli.c超過一千行（包含大量的交互處理，所以代碼多一點），其余文件均小于1k行，符合良好的c語言代碼設計規(guī)范。數(shù)量最多的是drv_開頭的驅動層程序。

其次是各種計算和控制文件，比如fw_nav,是前向導航的意思，也就是控制無人機往前飛。比如mixer是混合器，混合器是混合操控命令環(huán)境感知等等渠道的信息，形成最終的每個旋翼的電動機的控制命令。

最后是各種輔助文件，包含各種輔助函數(shù)，比如utils.c.h，比如printf.c.h。

還有一個不屬于上面三類的重要文件makefile，是把baseflight編譯成固件.bin的核心文件，一般不要去改。

圖2 baseflight的簡明項目報告

表1 全文件列表

里面的main.c，會把主循環(huán)拉起來。就像任何持續(xù)執(zhí)行的嵌入式系統(tǒng)，都是靠一個無限循環(huán)來保證器件的無限執(zhí)行的。

?// loopy?while?(1) {?//這里，main啟動無限循環(huán)? ??loop();?#ifdef?SOFTSERIAL_LOOPBACK? ??if?(loopbackPort1) {? ? ? ??while?(serialTotalBytesWaiting(loopbackPort1)) {? ? ? ? ? ??uint8_t?b =?serialRead(loopbackPort1);? ? ? ? ? ??serialWrite(loopbackPort1, b);? ? ? ? ? ??//serialWrite(core.mainport, 0x01);? ? ? ? ? ??//serialWrite(core.mainport, b);? ? ? ? };? ? }? ??if?(loopbackPort2) {? ? ? ??while?(serialTotalBytesWaiting(loopbackPort2)) {? ? ? ? ? ??serialRead(loopbackPort2);? ? ? ? };? ? }#endif}

區(qū)區(qū)幾行代碼，其內容卻很豐富：

1. 無限循環(huán) (while (1))

while (1) 創(chuàng)建了一個無限循環(huán)，使得代碼不斷重復執(zhí)行。后面會說如何終止無限循環(huán)。

2. 調用 loop() 函數(shù)

這個loop() 就是飛行的主要函數(shù)，不在main。c里面，而在mw.c里面。mw的意思就是main work。之所以分開無非是軟件工程良好代碼規(guī)范的需要：不要讓單個文件太過龐大。

3. 條件編譯 (#ifdef SOFTSERIAL_LOOPBACK)

a. #ifdef SOFTSERIAL_LOOPBACK 是一個預處理器指令，表示只有在定義了 SOFTSERIAL_LOOPBACK 宏的情況下，才會編譯下面的代碼塊。

4. 處理 loopbackPort1

a. 如果 loopbackPort1 存在（即不為 NULL 或假值），則進入一個內部循環(huán)。

b. while (serialTotalBytesWaiting(loopbackPort1))：此循環(huán)將持續(xù)運行，直到 loopbackPort1 上沒有任何數(shù)據等待讀取為止。

c. uint8_t b = serialRead(loopbackPort1);：從 loopbackPort1 讀取一個字節(jié)的數(shù)據并存儲在變量 b 中。

d. serialWrite(loopbackPort1, b);：將剛剛讀取到的數(shù)據再寫回到 loopbackPort1，這實際上是在模擬一個回環(huán)（loopback）操作。

5. 處理 loopbackPort2

a. 如果 loopbackPort2 存在，則進入另一個內部循環(huán)。

b. while (serialTotalBytesWaiting(loopbackPort2))：此循環(huán)將持續(xù)運行，直到 loopbackPort2 上沒有任何數(shù)據等待讀取為止。

c. serialRead(loopbackPort2);：從 loopbackPort2 讀取一個字節(jié)的數(shù)據，但沒有將其存儲或重新發(fā)送出去，因此這似乎只是簡單地丟棄數(shù)據。

其中值得注意的幾個點：

● 死循環(huán)：由于 while (1) 是一個死循環(huán)，除非通過外部中斷或其他方式終止程序，否則這段代碼會一直運行下去。

● 資源消耗：在沒有數(shù)據可讀的情況下，serialTotalBytesWaiting 函數(shù)會持續(xù)返回 false，導致循環(huán)快速結束。然而，如果端口上有大量數(shù)據等待讀取，這可能會導致 CPU 資源的高占用率。

● 調試和測試：#ifdef SOFTSERIAL_LOOPBACK 指令使得這部分代碼可以根據需要啟用或禁用。這對于調試和測試不同的功能場景非常有用。

3、如何安裝？

假設某一位讀者花了很大力氣根據自己的設備改寫了baseflight的程序，而且這位讀者可能就是某個無人機廠商的創(chuàng)始人或者總師，需要把自己的產品（這些改進就是你的產品）變現(xiàn)才能盈利，那么我們怎么把修改后的程序“注入”飛控里面。

Baseflight 主要運行在基于 STM32 系列微控制器 (MCU) 的硬件平臺上。STM32 是一種廣泛應用于無人機飛行控制器的 32 位 ARM Cortex-M 處理器，具有高性能和豐富的外設接口。具體來說，Baseflight 支持多種常見的飛控板，例如 Naze32、F3、CC3D 等 。

表2 安裝 Baseflight 固件到硬件中

那么固件哪來的？baseflight都是源文件啊。

表3 baseflight固件生成

特別注意，除非你改變了源工程的文件結構，否則不要改原先的makefile文件。