ArduPilot 板级移植指南Holybro KakuteF4-Wing 飞控硬件配置与固件刷写全解析【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot导读本文以 ArduPilot 仓库中 libraries/AP_HAL_ChibiOS/hwdef/KakuteF4-Wing/README.md 为骨架完整梳理 Holybro KakuteF4-Wing 固定翼飞控的硬件资源、串口/定时器/PWM 映射、电池监测参数、DFU 刷写流程并结合 hwdef.dat 等板级定义文件从源码层面解释每个外设配置的底层依据。读完本文你将能够独立完成该板卡在 ArduPlane 上的参数配置、外设接线与固件刷写。一、板卡概览一款面向固定翼 FPV 的 STM32F405 飞控KakuteF4-Wing 是 Holybro 公司推出的固定翼专用飞控。与多旋翼版的 KakuteF4 不同Wing 版将输出通道主要面向伺服舵机与电调并内置了大电流 BEC 与视频发射机供电是典型的 FPV 固定翼一体化方案。在 ArduPilot 中每块飞控都通过hwdef目录下的板级定义文件驱动KakuteF4-Wing 对应的目录为 libraries/AP_HAL_ChibiOS/hwdef/KakuteF4-Wing/其中hwdef.dat固件Firmware硬件定义ArduPilot 主固件的引脚、外设、默认参数均由此生成hwdef-bl.dat引导加载程序Bootloader硬件定义defaults.parm出厂默认参数。1.1 核心硬件规格根据 README.md 官方说明类别规格处理器STM32F405 32 位处理器Cortex-M41024KB Flash片上 OSDAT7456E由 hwdef.dat 中SPIDEV osd与define HAL_OSD_TYPE_DEFAULT 1启用惯性测量单元ICM42688 加速度计/陀螺仪SPI 接口气压计SLP06I2C 0x76见 hwdef.dat 的BARO SPL06 I2C:0:0x76输入电源2S–8S LiPo带电压监测BEC9V/12V 1.5A视频发射机6V/7.2V 伺服 BEC3.3V 1A接口7×PWM 输出全部支持 DShot其中 1–4 路支持 BiDirDShot、1×RC 输入、5×串口、1×I2C、USB-C注意README 中 BEC 电流参数原文档未完全标出伺服 BEC 电流以 ?A 标注属文档原始信息使用时以 Holybro 官方硬件手册为准。1.2 板级标识与内存布局hwdef.dat 中定义MCU STM32F4xx STM32F405xx APJ_BOARD_ID AP_HW_Holybro-KakuteF4-Wing OSCILLATOR_HZ 8000000 FLASH_SIZE_KB 1024 FLASH_RESERVE_START_KB 488MHz 外部晶振OSCILLATOR_HZ 8000000固件从 Flash 偏移 48KB 开始前 48KB 预留给 Bootloader 首扇区板卡 IDAP_HW_Holybro-KakuteF4-Wing十进制 5406见 Tools/AP_Bootloader/board_types.txtBootloader 依赖该 ID 识别固件合法性。Bootloader 版 hwdef-bl.dat 则相反FLASH_RESERVE_START_KB 0、FLASH_BOOTLOADER_LOAD_KB 48即 Bootloader 从零地址启动并将主固件加载到 48KB 偏移处——两者地址划分完全吻合。二、引脚分布与 UART 映射2.1 引脚图以下三张引脚图分别对应 ESC/电源接口侧、UART 排针侧以及板顶视图来自 hwdef 目录图中Rn/Tn分别表示 UARTn 的接收RX与发送TX引脚。2.2 串口映射表按 README.md 与 hwdef.dat逻辑串口物理串口默认用途DMA 状态SERIAL0USBOTG1地面站/控制台–SERIAL1UART1PB6/PB7GPSDEFAULT_SERIAL1_PROTOCOL SerialProtocol_GPSDMA 启用SERIAL2UART2PA2/PA3Telem1 遥测MAVLink2DMA 启用TXRX 为NODMASERIAL3UART3PC10/PC11RC 输入SerialProtocol_RCINDMA 启用SERIAL5UART5PC12/PD2用户自定义NODMASERIAL6USART6PC6/PC7用户自定义NODMA串口顺序由SERIAL_ORDER OTG1 USART1 USART2 USART3 EMPTY UART5 USART6决定其中EMPTY占位 UART4因此用户串口编号从 SERIAL5 起。用户可在地面站通过SERIAL5_PROTOCOL、SERIAL6_PROTOCOL等参数将 UART5/USART6 改为数传、Airspeed 或其他外设。2.3 一个值得注意的硬件细节SBUS 反相控制hwdef.dat 中有一行特殊配置PC13 USART3_RXINV OUTPUT HIGH GPIO(78) POL(1)它通过 GPIO(78) 控制 USART3_RX 的硬件反相器。由于 SBUS 是反相串口协议该引脚默认拉高OUTPUT HIGH并置反相标志POL(1)从而让 KakuteF4-Wing 无需外部反相器即可直连 SBUS 接收机而串口供电的 CRSF、FPort 等协议则不受影响。三、RC 输入与 OSD3.1 RC 输入RC 输入固定在 R3UART3_RXPC11引脚上支持所有串行 RC 协议SBUS、FPort、CRSF、DSM 等。由于 USART3 配置为 DMA 启用且默认协议为SerialProtocol_RCIN插上串口接收机后一般无需改参数即可使用。3.2 板上 OSDKakuteF4-Wing 内置 AT7456E OSD对应的 OSD 驱动类型为OSD_TYPE 1MAX7456 驱动。hwdef.dat 中的define OSD_ENABLED 1与define HAL_OSD_TYPE_DEFAULT 1将该默认值固化进固件因此用户只需在 OSD 菜单中开启显示项无需手工设置 OSD_TYPE。四、PWM 输出与定时器分组4.1 输出通道与分组KakuteF4-Wing 支持最多 7 路 PWM 输出全部支持 DShot其中 M1–M4输出 1–4支持双向 DShotBiDirDShot可用于遥测回传。根据 README.mdPWM 分为 4 组组 1PWM 1–2TIM1组 2PWM 3–4TIM3组 3PWM 5–6TIM8组 4PWM 7TIM54.2 定时器与通道级证据hwdef.dat 给出了完整映射PA8 TIM1_CH1 TIM1 PWM(1) GPIO(50) # M1 PA9 TIM1_CH2 TIM1 PWM(2) GPIO(51) BIDIR # M2 PB0 TIM3_CH3 TIM3 PWM(3) GPIO(52) # M3 PB1 TIM3_CH4 TIM3 PWM(4) GPIO(53) BIDIR # M4 PC8 TIM8_CH3 TIM8 PWM(5) GPIO(54) # M5 PC9 TIM8_CH4 TIM8 PWM(6) GPIO(55) # M6 PA1 TIM5_CH2 TIM5 PWM(7) GPIO(56) # M7同一组内的通道共享同一定时器必须使用相同的输出速率组内任一通道启用 DShot则组内所有通道都必须使用 DShotArduPilot 会按组统一配置BIDIR标记仅在 M2、M4 上出现但 README 声称输出 1–4 均支持 BiDirDShot——从源码结构看双向 DShot 能力最终取决于定时器输入捕获配置与固件对 PWM 通道的初始化方式实际使用请以固件行为与地面站检测结果为准。4.3 默认舵机/通道功能板卡默认参数 defaults.parm 仅含一行SERVO7_FUNCTION 120其中功能号 120 为 LED通知功能即第 7 路 PWMM7PA1在出厂时被配置为 LED 控制输出而非舵机。这一点与 hwdef.dat 中AP_NOTIFY_GPIO_LED_1_PINPC5 蓝色状态灯共同构成板上灯光体系用户若需将 M7 用作普通舵机应在 Mission Planner 中修改SERVO7_FUNCTION。五、电池监测参数5.1 内置传感器与官方推荐参数板载电压/电流传感器官方推荐参数如下见 README.md参数值说明BATT_MONITOR4模拟电压电流监测BATT_VOLT_PIN10电压采样引脚PC0ADC1BATT_CURR_PIN11电流采样引脚PC1ADC1BATT_VOLT_MULT11分压比引脚电压 × 11 电池电压BATT_AMP_PERVLT40每伏安培数电流传感器灵敏度5.2 源码级依据这些默认值并非凭空而来而是固化在 hwdef.datPC0 BATT_VOLTAGE_SENS ADC1 SCALE(1) define HAL_BATT_VOLT_PIN 10 define HAL_BATT_VOLT_SCALE 11.0 PC1 BATT_CURRENT_SENS ADC1 SCALE(1) define HAL_BATT_CURR_PIN 11 define HAL_BATT_CURR_SCALE 40 define HAL_BATT_MONITOR_DEFAULT 4ArduPilot 的模拟电池监测库 AP_BattMonitor_Analog.cpp 会优先读取这些 HAL 级宏作为BATT_VOLT_PIN/BATT_CURR_PIN的默认值而BATT_VOLT_MULT的含义在参数定义中明确为“引脚电压 × VOLT_MULT 实际电池电压”见 AP_BattMonitor_Analog.cpp。注意README 中“电压传感器可处理最高 6S”与特性章节的“2S–8S 输入”描述不一致且电流量程原文档未标注?? Amps。这是原文档的遗留信息请以 Holybro 硬件手册与实测校准为准。若实际飞行需要更高精度可在 Mission Planner 的电池设置页重新校准 VOLT_MULT 与 AMP_PERVLT。六、罗盘外部 I2C 磁力计KakuteF4-Wing 无板载磁力计需通过 SDA/SCLPB10/PB11I2C2外接 I2C 磁力计。hwdef.dat 配置了define AP_COMPASS_PROBING_ENABLED 1 define HAL_I2C_INTERNAL_MASK 0 define HAL_COMPASS_AUTO_ROT_DEFAULT 2AP_COMPASS_PROBING_ENABLED 1启动时自动探测 I2C 总线上各类常见外置磁力计型号HAL_I2C_INTERNAL_MASK 0内部 I2C 屏蔽为零避免误探测不存在的内置器件HAL_COMPASS_AUTO_ROT_DEFAULT 2默认按ROTATION_YAW_270处理外置罗盘安装方向实际应以安装姿态为准在参数COMPASS_ORIENT中修正。接线与安装后建议在完成磁力计校准并确认COMPASS_ORIENT正确后再解锁飞行。七、固件刷写与更新7.1 固件获取ArduPilot 官方固件服务器firmware.ardupilot.org的KakuteF4-Wing子目录提供了该板卡的预编译固件arduplane、arducopter等机型版本。7.2 首次刷写DFU 模式按住板上Boot 按键的同时通过 USB-C 连接电脑进入 DFU设备固件升级模式使用任意 DFU 刷写工具如dfu-util或 Mission Planner/STM32CubeProgrammer 的 DFU 功能首先刷入引导加载程序KakuteF4-Wing_bl.hex随后刷入对应机型的主固件。Bootloader 镜像由 hwdef-bl.dat 构建其中PA1 LED_BOOTLOADER OUTPUT LOW与define HAL_LED_ON 0定义了 Bootloader 运行时的指示灯行为可用于判断进入 DFU 是否成功。7.3 后续更新一旦 Bootloader 就绪后续固件升级即可通过Mission Planner的固件安装界面在线完成无需再进入 DFU。八、面向 FPV/OSD 场景的固件裁剪策略KakuteF4-Wing 仅有 1MB Flash为了给 OSD、视频发射机VTX等功能留出空间hwdef.dat 引用了共享裁剪文件include ../include/minimize_fpv_osd.inc该文件minimize_fpv_osd.inc专为 FPV/OSD 飞行场景设计主要削减了光流AP_OPTICALFLOW_ENABLED 0、S.BUS 输出、内燃机、高级失效保护、精准降落等非 FPV 常用功能大部分测距仪后端仅保留 Benewake TF 系列如 TFmini/TF02/TF03SMBUS 电池监测后端恢复启用 GPS NMEA 协议与 Quad/Hexa/Octa 电机框架强制保留 Tramp 与 CRSF 遥测文本支持与 OSD 联动。此外 hwdef.dat 通过AP_BARO_BACKEND_DEFAULT_ENABLED 0AP_BARO_SPL06_ENABLED 1只保留 SPL06 气压计驱动进一步压缩体积。这说明该板卡的固件是“功能被刻意裁剪、面向固定翼 FPV 实战”的配置用户若需要裁剪掉的功能应从源码重新编译定制固件而非期望现有二进制包含全部驱动。九、总结KakuteF4-Wing 在 ArduPilot 中的支持可归纳为一条完整的“硬件定义 → 固件生成 → 刷写 → 参数配置”链路硬件定义hwdef.dat/hwdef-bl.dat描述 MCU、外设、引脚与默认参数固件刷写首次 DFU 刷入 Bootloader之后用 Mission Planner 在线更新关键参数电池监测按BATT_MONITOR 4 官方 VOLT_PIN/CURR_PIN/MULT/AMP_PERVLT 组合配置RC 输入与 OSD 均为板级默认注意事项PWM 组内通道速率与协议必须一致无板载罗盘需外接并校准FPV 裁剪固件不含部分可选驱动。对于希望深入移植的开发者hwdef.dat 本身就是一份极佳的学习样本——从晶振频率、存储分区到每个 GPIO 的用途与默认电平都可以作为自行定义新板卡的参考模板。【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考