1. 为什么要在WFG100上折腾四套固件手里这块WFG100飞控是基于STM32H743VIT6做的480MHz主频、2MB Flash、1MB RAM双BMI088、ICM42688、BMP388、MS5611这些传感器都焊上了接口也拉得比较全。板子本身硬件底子是够的但真正决定它能干什么的是上面跑什么固件。我一开始只打算跑PX4后来发现身边玩固定翼的、玩穿越的、玩水下机器人的朋友都在问同一块板子能不能跑他们熟悉的固件索性就把APM、PX4、INAV、BF这四套都编译适配了一遍。这件事的意义不在于“证明H743性能强”而在于同一块硬件在不同固件下的资源占用、外设映射、编译工具链、参数体系差异极大。你如果只玩过其中一套换到另一套时踩的坑会非常密集。比如BF的target配置文件里一个定时器通道写错电机就直接不转PX4的board config里UART映射搞反GPS和数传就互相抢口INAV对H743的DMA冲突比F4时代敏感得多APM虽然老牌但ChibiOS下的H743支持并不是“插上就能用”。这篇内容适合三类人一是手里有H743板子想自己刷固件的二是做飞控硬件想验证固件兼容性的三是已经会飞但想搞明白底层编译适配逻辑的。我会把四套固件的编译环境、board配置、外设映射、烧录验证、常见报错都拆开讲参数和步骤尽量给到能直接抄的程度。注意以下所有操作基于Ubuntu 22.04 LTS物理机或WSL2环境STM32CubeProgrammer和dfu-util版本会影响烧录结果建议先统一工具版本。2. 四套固件的定位差异与选型逻辑2.1 各自的核心场景与代码体量先把四套固件的“性格”说清楚不然后面编译时你会不知道为什么有的要改Makefile有的要改hwdef。固件主要场景代码体量编译系统H743支持成熟度APM多旋翼/固定翼/车/船大历史包袱重waf中等需手动配hwdefPX4多旋翼/固定翼/VTOL/无人车很大模块化CMakeNinja较好官方有H743 boardINAV固定翼/穿越/长航时中等Make较好target机制清晰BF穿越/竞速小精简Make好target文件成熟APM和PX4都是“大而全”路线但APM的ChibiOS分支对H743的时钟树配置需要自己核对PX4则从v1.12之后对H7系列支持明显完善。INAV和BF同源但分家已久INAV偏导航和固定翼BF偏纯手动和竞速两者target文件结构相似但参数体系完全不同。2.2 为什么同一块板子要分别适配WFG100的硬件设计里UART和定时器分配是固定的。比如UART4接了GPSUART7接了数传TIM1和TIM8分别驱动两组电机。不同固件对这些外设的默认映射不一样BF的target里通常把MOTOR1放TIM1_CH1但WFG100实际焊的是TIM8_CH1不改target电机不转。PX4的board config里UART7默认可能是作为TELEM2但WFG100的TELEM2实际走UART2需要改default.px4board。INAV的target.c里需要显式声明TIM_USE_MOTOR和TIM_USE_LED否则LED和蜂鸣器冲突。APM的hwdef.dat里要手动写PE8 TIM1_CH1OUT这类引脚定义写错一个就是“无输出”。所以适配的本质是把硬件真实连接翻译成各固件能识别的配置语言而不是简单“编译通过就行”。2.3 选型建议先问自己飞什么如果你飞穿越机直接BF别折腾PX4代码体量和调参逻辑完全不适合。如果你飞固定翼做长航时INAV的导航和OSD更顺手。如果你要做多旋翼编队或避障PX4的模块化和MAVLink生态更完整。APM适合已经有一套APM参数体系、不想迁移的老玩家。WFG100这块板子四套都能跑但没必要都跑选一套深入即可。3. 编译环境搭建与工具链统一3.1 Ubuntu 22.04基础依赖四套固件对工具链版本要求不同但可以共存。我习惯先装一套通用依赖sudo apt update sudo apt install -y git make cmake ninja-build gcc-arm-none-eabi \ binutils-arm-none-eabi libnewlib-arm-none-eabi \ python3 python3-pip python3-venv dfu-util这里有个坑Ubuntu 22.04自带的gcc-arm-none-eabi是10.3版本PX4 v1.14要求至少10.3BF和INAV用9-10都能编APM的waf脚本对12以上版本反而会报错。所以不要盲目升级到最新ARM GCC10.3是四套固件的最大公约数。3.2 各固件独立环境隔离我建议用不同的目录和Python虚拟环境隔离避免pip包冲突mkdir -p ~/fw cd ~/fw git clone https://github.com/ArduPilot/ardupilot.git apm git clone https://github.com/PX4/PX4-Autopilot.git px4 git clone https://github.com/iNavFlight/inav.git inav git clone https://github.com/betaflight/betaflight.git bfPX4需要额外装pip install -r Tools/setup/requirements.txtAPM需要pip install -r requirements.txtINAV和BF基本只用makePython依赖少。3.3 串口权限与烧录工具H743通常用DFU或串口烧录。DFU模式下lsusb能看到0483:df11如果看不到检查BOOT0是否拉高。串口烧录需要把用户加入dialout组sudo usermod -aG dialout $USER然后重新登录。烧录工具我统一用dfu-util版本0.11以上对H7支持稳定。STM32CubeProgrammer也可以但它的CLI在WSL下有时识别不到USB物理机更稳。提示WSL2的USB直通需要usbipd配置麻烦且容易断烧录环节建议在物理Ubuntu或Windows下用STM32CubeProgrammer完成。4. BF固件在WFG100上的编译与target适配4.1 target文件结构解析BF的target文件在src/main/target/WFG100/下核心是target.h和target.c。target.h定义引脚和定时器target.c定义定时器通道用途。WFG100的电机输出实际接在TIM8的CH1-CH4所以#define MOTOR1_PIN PE8 // TIM8_CH1 #define MOTOR2_PIN PE9 // TIM8_CH2 #define MOTOR3_PIN PE10 // TIM8_CH3 #define MOTOR4_PIN PE11 // TIM8_CH4如果你直接抄别的H743 target很可能写成TIM1编译能过但电机不动。target.c里要加timerHardware_t timerHardware[] { DEF_TIM(TIM8, CH1, PE8, TIM_USE_MOTOR, 0, 0), DEF_TIM(TIM8, CH2, PE9, TIM_USE_MOTOR, 0, 0), DEF_TIM(TIM8, CH3, PE10, TIM_USE_MOTOR, 0, 0), DEF_TIM(TIM8, CH4, PE11, TIM_USE_MOTOR, 0, 0), };4.2 编译命令与常见报错cd ~/fw/bf make WFG100如果报undefined reference to timerHardware说明target.c没被包含进Makefile检查src/main/target/WFG100/下是否有CMakeLists.txt或Makefile引用。BF 4.4之后用CMake需要mkdir build cd build cmake .. -DTARGETWFG100 make -j8常见报错还有region FLASH overflowed说明功能开太多关掉USE_GPS或USE_MAG再试。4.3 烧录与验证生成的betaflight_4.4.x_WFG100.hex用dfu-util烧dfu-util -a 0 -s 0x08000000:leave -D betaflight_4.4.x_WFG100.hex烧完接BF Configurator看传感器是否全部识别。如果陀螺仪数据不动检查SPI引脚定义如果电机测试不转回查TIM8映射。实操心得BF的target文件里TIM_USE_MOTOR的最后一个参数是DMA选项H743的DMA冲突比F4多如果电机和LED同时用TIM8需要错开DMA stream否则编译不报错但运行异常。5. INAV固件的target配置与编译5.1 INAV target与BF的异同INAV的target也在src/main/target/下但多了一个target.c里的timerHardware和target.h里的BOARD_HAS_*宏。WFG100的INAV target需要定义#define BOARD_HAS_BARO #define BOARD_HAS_MAG #define BOARD_HAS_SDCARD #define USE_UART4 #define USE_UART7INAV对H743的DMA要求更严格timerHardware里要显式指定DMADEF_TIM(TIM8, CH1, PE8, TIM_USE_MOTOR, 0, 0),最后一个0是DMA option如果和SDIO冲突SD卡会初始化失败。5.2 编译与固件生成cd ~/fw/inav make WFG100INAV的Makefile会自动找src/main/target/WFG100/。如果报No such file or directory: target.mk说明target目录名大小写不对INAV要求全大写。生成的inav_7.x.x_WFG100.hex烧录方式和BF一样。烧完接INAV Configurator重点看GPS和磁罗盘。如果GPS不识别检查UART4的TX/RX是否在target.h里定义反了。5.3 参数迁移注意INAV和BF的参数不通用但遥控通道映射逻辑相似。从BF转INAV时rxConfig和motorConfig要重设。INAV的mixer默认是MIXER_FLYING_WING多旋翼要改成MIXER_QUADX。注意INAV 7.x对H743的Flash分区有要求如果开了BlackboxFLASH区域可能不够建议用SD卡存日志。6. PX4固件的board config与编译6.1 PX4的board目录结构PX4的board在boards/下WFG100需要新建boards/wfg/wfg100/包含default.px4board定义UART、SPI、I2C映射board_config.h定义GPIO和电源init/rc.board_defaults启动脚本default.px4board里关键行CONFIG_BOARD_SERIAL_TEL1/dev/ttyS0 CONFIG_BOARD_SERIAL_GPS1/dev/ttyS3 CONFIG_DRIVERS_GPSy CONFIG_DRIVERS_IMU_BMI088y这里ttyS0对应UART4ttyS3对应UART7写错就找不到设备。6.2 编译命令与依赖cd ~/fw/px4 make wfg_wfg100_defaultPX4 v1.14用CMakeNinja第一次编译会下载很多子模块建议先git submodule update --init --recursive。如果报python3 -m pip install kconfiglib失败手动装pip3 install kconfiglib编译产物在build/wfg_wfg100_default/下px4_fmu-v6x_default.px4类似文件用QGC烧录。6.3 外设映射验证PX4烧完后接QGC看mavlink status。如果GPS不亮检查/dev/ttyS3是否存在。H743的UART7默认引脚是PE8/PE9但WFG100可能用了PF6/PF7需要在board_config.h里重映射#define GPIO_USART7_TX GPIO_PF7 #define GPIO_USART7_RX GPIO_PF6实操心得PX4的board config里CONFIG_BOARD_SERIAL_*的顺序决定了/dev/ttyS*编号不是按物理UART编号来的第一次配很容易搞反建议画个映射表再写。7. APM固件的hwdef配置与编译7.1 hwdef.dat编写要点APM的hwdef在libraries/AP_HAL_ChibiOS/hwdef/WFG100/下核心是hwdef.datMCU STM32H743xx APJ_BOARD_ID 1234 FLASH_SIZE_KB 2048 RAM_SIZE_KB 1024 PA0 UART4_TX PA1 UART4_RX PE8 TIM1_CH1OUT注意APM的定时器命名是TIM1_CH1OUT不是TIM8_CH1。如果WFG100电机接TIM8要写PE8 TIM8_CH1OUT。写错编译能过但motors测试无输出。7.2 编译命令cd ~/fw/apm ./waf configure --board WFG100 ./waf copterAPM的waf对Python版本敏感建议用Python 3.8-3.10。如果报ImportError: cannot import name collections是Python 3.10的兼容问题装python3.9再试。7.3 烧录与参数生成的arducopter.apj用Mission Planner烧。APM的参数体系和PX4完全不同SERIAL4_PROTOCOL对应UART4SERIAL7_PROTOCOL对应UART7。如果数传不通信检查SERIAL7_BAUD是否和数传波特率一致。注意APM的H743支持在ChibiOS 21.11之后才稳定老版本编译可能卡在chibios子模块建议用最新master。8. 四套固件编译适配对比与排查速查8.1 关键差异对照表项目BFINAVPX4APM编译系统Make/CMakeMakeCMakeNinjawaftarget文件target.h/ctarget.h/cdefault.px4boardhwdef.dat定时器命名TIM8_CH1TIM8_CH1TIM8_CH1TIM8_CH1OUTUART映射宏定义宏定义CONFIG_BOARD_SERIALSERIALx_PROTOCOL烧录工具dfu-utildfu-utilQGCMission PlannerH743 DMA敏感度中高中低8.2 常见问题速查现象可能原因排查方法编译通过但电机不转定时器映射错查target/hwdef的TIM通道GPS不识别UART TX/RX反对调引脚定义陀螺仪数据不动SPI片选错查SPI CS引脚烧录后无启动BOOT0未拉低检查BOOT0电平Flash溢出功能开太多关GPS/MAG/Blackbox8.3 独家避坑技巧第一先编BF再编INAV因为BF的target最简单能快速验证硬件基本通路。第二PX4的board config改完后先make clean否则旧配置缓存会导致外设映射不生效。第三APM的hwdef.dat里引脚定义顺序不重要但定时器通道必须和物理连接一致我见过有人把TIM8写成TIM1结果电机测试时只有一路抖。第四H743的DMA冲突在INAV上最明显如果SD卡和电机同时用DMA优先给电机分配独立stream。9. 烧录验证与首飞前检查四套固件烧完后首飞前必须做三件事传感器校准、电机方向测试、失控保护测试。BF和INAV在Configurator里直接校准PX4用QGC的Sensors页APM用Mission Planner的Initial Setup。电机方向测试时不要装桨用motor test逐个转确认编号和转向。失控保护测试把遥控关掉看飞控是否进入failsafe模式。提示H743的USB和UART同时使用时如果USB枚举失败检查VBUS检测引脚是否配置正确WFG100上可能是PA9。10. 我个人在实际适配中的体会四套固件里BF和INAV的适配最快因为target机制直观改完编译烧录就能验证。PX4的board config最繁琐但一旦配好后续二次开发最舒服。APM的hwdef.dat写起来最像“手写汇编”但它的参数体系对老玩家最友好。WFG100这块板子硬件底子好四套都能跑但没必要都跑。我的建议是穿越选BF固定翼选INAV多旋翼编队选PX4老APM用户继续APM。编译适配的核心不是“让代码跑起来”而是“让硬件真实连接和固件配置一一对应”。每次改完target或hwdef先画一张引脚映射表比反复烧录试错快得多。