一、项目概述
Betterflight 是一套完整开源的四轴 FPV 穿越机飞控全栈工程,基于主流飞控系统 Betaflight 二次衍生开发,由 IDV7 维护开源,核心定位是深度适配 HDZero 高清数字图传机载 DVR 录制功能,同时提供硬件 PCB、STM32 底层固件、PC 端可视化调参上位机三位一体全套资源。
项目整体使用 C/C++ 嵌入式技术栈开发,固件主体为 C 语言,配套上位机采用 QT 图形框架,硬件工程独立配套,硬件层面保持与 Betaflight 生态通用兼容。项目最后一次更新距今两年,属于面向 HDZero 图传玩家的实验性定制飞控方案。

二、整体工程目录架构
仓库严格划分为三大独立模块,每个模块配套独立文档与开发分支:稳定代码存放于 main 主分支,未验证、待测试功能存放于各子分支。
1. software:STM32 飞控底层固件模块
核心内容:STM32 单片机完整飞控源代码,全部采用 C 语言编写,包含姿态解算、电机输出、PID 控制、HDZero 图传联动录像逻辑等底层驱动;
编译构建:使用 CMake 工具链完成源码编译,输出可直接烧录至飞控硬件的二进制固件文件;
核心差异化逻辑:在原版 Betaflight 飞控算法基础上,新增 HDZero 图传 DVR 联动控制逻辑,实现机载录像与飞行器飞行状态同步。
2. configurator:PC 端可视化调参上位机
开发框架:基于 C++ + QT Framework 跨平台图形界面开发,可在 PC 端可视化配置飞控;
基础调参功能:支持飞行器核心参数修改,包含电机转速、电机转向、电机排布顺序、全通道 PID 参数、陀螺仪滤波等常规飞控设置;
专属开发调试工具:内置串口监视器、一键固件烧录按钮、陀螺仪实时观测窗口、PID 曲线调试器,大幅降低固件二次开发与调试门槛。
3. hardware:配套飞控硬件工程
工程文件:提供整套飞控板原理图、PCB 布线文件,可直接打板生产配套硬件;
兼容性设计:硬件电路完全适配 Betaflight 固件标准,硬件板卡可直接刷写 Betaflight v3 系列固件,兼顾通用 FPV 玩家生态;
硬件适配优化:PCB 预留 HDZero 图传模块专用焊盘、供电与通信接口,原生支持数字图传录像信号交互。
三、核心兼容性特性
固件互通:硬件完全兼容 Betaflight,若无需 HDZero 专属功能,可直接刷写标准 Betaflight v3 目标固件使用;
图传专属适配:原生内置 HDZero DVR 驱动逻辑,可实现飞行过程中图传自动启停录制、飞行数据叠加录像画面等独有功能,原版 Betaflight 无原生深度适配;
跨工具兼容:自研 QT 上位机可读取、修改 Betaflight 通用参数,参数逻辑与主流飞控统一,降低玩家学习成本。
四、项目核心优势与适用人群
核心优势
一站式全栈开源:市面上多数飞控项目仅开放固件,本项目同时提供硬件 PCB、底层固件、专属调参软件,软硬件同步定制;
HDZero 深度定制:专门针对 HDZero 数字高清图传做底层联动优化,解决原版 Betaflight 图传录像适配不完善的问题;
轻量化开发工具链:上位机集成全套调试工具,嵌入式开发者可快速二次修改飞控算法、新增自定义功能;
生态兼容不锁闭:硬件兼容通用 Betaflight 固件,玩家可按需切换标准飞控方案,无生态绑定限制。
适用人群
FPV 穿越机玩家:使用 HDZero 数字图传,需要机载同步录像、追求图传与飞控联动效果的爱好者;
嵌入式开发爱好者:想要学习 STM32 飞控开发、PCB 硬件设计、QT 上位机开发的技术学习者;
小众飞控定制开发者:基于成熟 Betaflight 算法,快速开发带专属外设(数字图传)的定制飞控方案。
五、项目应用场景
个人 DIY 穿越机:自行打板制作配套飞控,搭配 HDZero 图传组装轻量化 FPV 机型;
嵌入式学习实训:完整飞控软硬件工程可作为 STM32 嵌入式、PCB 设计、QT 桌面开发综合实训案例;
小众飞控二次开发:以本项目为基底,快速迭代自有定制飞控产品,复用成熟姿态控制算法。
六、License
unlicense-未注明协议,请勿商业使用
