# FLYAMASTER **Repository Path**: micolifar/FLYAMASTER ## Basic Information - **Project Name**: FLYAMASTER - **Description**: STM32F407 + 树莓派双主控开源飞控 - **Primary Language**: Unknown - **License**: CC-BY-SA-4.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 1 - **Created**: 2026-01-15 - **Last Updated**: 2026-03-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🚁 FLYAMASTER 飞控项目 > ⚠️ **版权警告 / COPYRIGHT WARNING** ⚠️ > > **本项目受版权保护，严格保留所有权利！** > > 🚫 **禁止** 未经授权的复制、修改、分发、商用 > 🚫 **禁止** Fork、Clone、Download 本仓库 > 🚫 **禁止** 转载、引用本项目任何内容 > > 违者将依法追究法律责任！详见 [LICENSE](LICENSE) > > --- > > **This project is protected by copyright. All rights strictly reserved!** > > 🚫 **PROHIBITED**: Unauthorized copying, modification, distribution, commercial use > 🚫 **PROHIBITED**: Fork, Clone, Download this repository > 🚫 **PROHIBITED**: Repost or cite any content from this project > > Violators will be prosecuted! See [LICENSE](LICENSE) --- **项目名称**: FLYAMASTER - F405 Mini 高性能穿越机飞控 **版本**: v2.4.0 **最后更新**: 2026-01-23 **状态**: 🟢 开发中 (软件完成，硬件设计完成，等待验证) **作者**: LI **助手**: Doro *(Desktop Pet / 桌面宠物)* --- ## 📖 项目简介 FLYAMASTER 是一款基于 **STM32F405RGT6** 的高性能、开源、易扩展的四轴飞行控制器。 ### 🌟 项目由来 > *"每个飞手心中都有一个造飞控的梦。"* 这个项目源于我对无人机的热爱。从第一次看到穿越机在空中翻滚、俯冲的那一刻起，我就被这种自由飞翔的感觉深深吸引。作为一名嵌入式开发者，我不满足于仅仅使用现成的飞控，而是想要**从零开始**，亲手打造一款属于自己的飞行控制器。 这不仅仅是一个技术项目，更是一段探索之旅——从最初的 Mahony 姿态解算调试，到 PID 参数的反复调优；从 DMA 通道冲突的抓狂，到最终看到四轴稳稳悬停的那一刻的成就感。每一行代码、每一条 PCB 走线，都凝聚着对飞行的热爱和对技术的追求。 **FLYAMASTER** = **FLY** (飞行) + **A** (一个) + **MASTER** (大师) —— 愿每一位使用者都能成为飞行大师！ ### 🎯 多固件支持 本硬件设计兼容多种主流开源飞控固件： | 固件 | 适用场景 | 支持状态 | |------|----------|----------| | **INAV** | 固定翼 / 长航时无人机 / GPS 导航 | ✅ 完全兼容 | | **Betaflight** | 穿越机 / 竞速无人机 / 花飞 | ✅ 完全兼容 | | **ArduPilot** | 专业航拍 / 测绘 / 自主任务 | ✅ 完全兼容 | | **FLYAMASTER (自研)** | 学习研究 / 定制开发 | ✅ 原生支持 | > 💡 **提示**: 硬件引脚分配遵循 Betaflight 标准，可直接使用 Betaflight Configurator 进行配置。 > 对于 INAV 和 ArduPilot，需要创建对应的 Target 定义文件。 ### 核心特性 - **高性能 MCU**: STM32F405RGT6 (168MHz, 1MB Flash, 192KB RAM) - **多固件兼容**: 支持 INAV / Betaflight / ArduPilot / 自研固件 - **宽电压输入**: 支持 **2S-9S 电池** (4.5V-40V)，兼容各类电调 - **板载 OSD**: AT7456E 视频叠加芯片，实时显示飞行数据 - **实时操作系统**: FreeRTOS CMSIS_V2 (自研固件) - **姿态解算**: Mahony 互补滤波 (500Hz) - **控制算法**: 串级 PID (角度环 + 角速度环) - **传感器融合**: IMU + 气压计 + 磁力计 + GPS + 光流 - **遥控接收**: ELRS/CRSF 协议 (420kbps, 双向遥测) - **黑匣子**: W25Q128 Flash 日志记录 (16MB) - **状态指示**: 7 颗专业级 LED 飞行仪表盘 - **USB 反灌保护**: 肖特基二极管隔离，安全可靠 ### 设计哲学 1. **控制回路隔离**: 姿态解算与 PID 控制拥有最高优先级 2. **DMA 满载策略**: 所有高吞吐量接口强制开启 DMA 3. **资源冲突零容忍**: 针对 F405 的 DMA 通道冲突采用硬件重映射方案 --- ## 🧠 核心算法原理 ### 姿态解算 - Mahony 互补滤波 飞控的"大脑"是姿态解算算法。我们采用 **Mahony 互补滤波器**，它巧妙地融合了陀螺仪和加速度计的数据： ``` ┌─────────────────────────────────────────┐ │ Mahony 互补滤波器 │ └─────────────────────────────────────────┘ 陀螺仪 (高频响应) 加速度计 (低频稳定) │ │ ▼ ▼ ┌─────────┐ ┌─────────┐ │ 角速度 │ │ 重力向量│ │ ω │ │ a │ └────┬────┘ └────┬────┘ │ │ │ ┌──────────────────────────┐ │ └───►│ 四元数微分方程积分 │◄────┘ │ q̇ = ½ q ⊗ ω_corrected │ └───────────┬──────────────┘ │ ▼ ┌─────────┐ │ 四元数 q │ ──► Roll, Pitch, Yaw └─────────┘ ``` **核心公式**: - 误差估计: `e = a × v` (加速度计测量值与估计重力方向的叉积) - PI 校正: `ω_corrected = ω_gyro + Kp·e + Ki·∫e·dt` - 四元数更新: `q += ½·q⊗ω·dt` ### 串级 PID 控制 采用**角度环 + 角速度环**的串级结构，外环输出作为内环的设定值： ``` 目标角度 ──┬──► [角度环 PID] ──► 目标角速度 ──┬──► [角速度环 PID] ──► 电机输出 │ │ 当前角度 ──┘ 当前角速度 ──┘ ``` **为什么用串级？** - 外环 (角度环): 响应慢但稳定，负责"往哪飞" - 内环 (角速度环): 响应快，负责"怎么飞" - 两环配合，既稳定又灵敏 ### 电机混控 - Airmode 算法 X 型机架的混控公式： ``` M1 (右前) = Throttle - Roll - Pitch - Yaw M2 (左后) = Throttle + Roll + Pitch - Yaw M3 (左前) = Throttle + Roll - Pitch + Yaw M4 (右后) = Throttle - Roll + Pitch + Yaw ``` **Airmode 的精髓**: 当电机输出超限时，整体平移油门中心，保证姿态控制差分不变——"姿态优先，油门让步"。 --- ## ⚡ 电路设计亮点 ### 宽电压电源架构 (2S-9S) ``` 电池 (4.5-40V) ──► SY8303 DCDC ──► 5V/3A ──► RT9193 LDO ──► 3.3V/500mA │ │ │ │ ├──► USB 5V (带反灌保护) ├──► MCU │ ├──► 蜂鸣器 ├──► 传感器 │ └──► 外设接口 └──► Flash/OSD │ ├──► 电机 (直接电池供电) └──► ADC 电压检测 (1:11 分压) ``` **为什么选 SY8303？** - 输入范围 4.5-40V，覆盖 2S-9S 电池 - 效率高达 95%，发热小 - SOT-23-6 封装，体积小巧 - 价格仅 ¥0.8，性价比极高 ### USB 反灌保护 **问题**: 电池供电时，5V 会通过 USB 反灌到电脑，导致 MCU 误判 USB 已连接。 **解决方案**: 肖特基二极管 (SS14) 隔离 + PB9 检测引脚 ``` USB VBUS ──┬──[SS14 二极管]──► +5V_USB │ └──[10kΩ]──► PB9 (USB_DETECT, Pull-down) ``` ### 7 颗 LED 专业飞行仪表盘 | 分组 | LED | 颜色 | 功能 | |:---|:---|:---|:---| | 核心系统 | LED_SYS | 蓝 | 系统心跳 (闪烁=待机, 常亮=已解锁) | | 核心系统 | LED_ERR | 红 | 警告/错误 (快闪=传感器故障) | | 导航链路 | LED_GPS | 绿 | GPS 状态 (闪烁=搜星, 常亮=3D Fix) | | 导航链路 | LED_RX | 黄 | 遥控信号 (常亮=正常, 灭=Failsafe) | | 飞行任务 | LED_MODE | 白 | 飞行模式指示 | | 飞行任务 | LED_LOG | 橙 | 黑匣子记录状态 | | 飞行任务 | LED_VTX | 青 | 图传状态 | --- ## 🔧 问题发现与解决 开发过程中遇到了不少"坑"，这里记录一些典型问题和解决方案： ### 问题 1: DMA 通道冲突 **现象**: WS2812 RGB 灯和 SBUS 接收机同时工作时，数据错乱。 **原因**: STM32F4 的 DMA 通道是硬件绑定的，TIM3_CH4 和 UART4_RX 共用 DMA1_Stream2。 **解决**: 将 WS2812 从 TIM3_CH4 (PB1) 迁移到 TIM1_CH1 (PA8)，使用 DMA2 通道，彻底隔离。 ### 问题 2: I2C 总线竞争 **现象**: 多任务环境下，MPU6050 和 SPL06 偶发读取失败。 **原因**: 两个任务同时访问 I2C1 总线，导致冲突。 **解决**: 引入 FreeRTOS 互斥锁 (`i2c1MutexHandle`)，所有 I2C 操作前加锁，操作后解锁。 ### 问题 3: Failsafe 油门被覆盖 (严重!) **现象**: 失控保护触发后，飞机不下降反而继续按遥控器油门飞行。 **原因**: 代码中先设置 `throttle = FAILSAFE_DESCENT_THROTTLE`，后又被 `throttle = SBUS_GetThrottle()` 覆盖。 **解决**: 在读取遥控器油门前检查 Failsafe 状态，Failsafe 期间跳过遥控器输入。 ### 问题 4: 偏航角漂移 **现象**: 飞机静止时，Yaw 角缓慢漂移。 **原因**: 仅使用 6 轴 IMU (加速度计+陀螺仪)，无法校正偏航。 **解决**: 集成 QMC5883L 磁力计，升级为 9 轴 AHRS，利用地磁场校正偏航。 ### 问题 5: 高频 printf 导致控制抖动 **现象**: 在 500Hz 的 IMU 任务中加 printf 调试，飞机开始抖动。 **原因**: printf 是阻塞式的，每次调用耗时 1-2ms，严重影响控制回路。 **解决**: 开发 RingBuffer 异步日志系统，`Log_Printf()` 仅需 <10us，数据通过 DMA 后台发送。 --- ## 🛠️ 技术栈 | 类别 | 技术选型 | 说明 | |------|----------|------| | **MCU** | STM32F405RGT6 | ARM Cortex-M4F @ 168MHz | | **RTOS** | FreeRTOS | CMSIS_V2 接口 | | **IDE** | Keil MDK-ARM | ARM Compiler 6 | | **配置工具** | STM32CubeMX | HAL 库生成 | | **EDA** | KiCad 9.0 | PCB 设计 | | **调试** | 匿名上位机 V7 | 实时数据可视化 | --- ## 📐 硬件设计 ### PCB 渲染图 | 正面 (Top) | 反面 (Bottom) | |:---:|:---:| | ![PCB 正面](Hardware/zero%20star/zero%20star-rounded.png) | ![PCB 反面](Hardware/zero%20star/zero%20star-rounded2.png) | ### 原理图 📄 **原理图 PDF**: [Hardware/zero star/zero star.pdf](Hardware/zero%20star/zero%20star.pdf) ### 主要芯片 | 芯片 | 功能 | 接口 | |------|------|------| | STM32F405RGT6 | 主控 MCU | - | | MPU6050 | 6轴 IMU | I2C1 (0x68) | | SPL06-001 | 气压计 | I2C1 (0x76) | | QMC5883L | 磁力计 | I2C1 (0x0D) | | W25Q128 | 16MB Flash | SPI1 | | AT7456E | OSD 视频叠加 | SPI1 | | SY8303 | DCDC 5V/3A (2S-9S 输入) | - | | RT9193-33 | LDO 3.3V/500mA | - | ### 接口定义 | 接口 | 引脚 | 功能 | 波特率 | |------|------|------|--------| | J1 | USB-C | 固件升级/调参 | CDC | | J2 | PA2/PA3 | GPS 模块 | 115200 | | J3 | PA9/PA10 | K210 上位机 | 921600 | | J4 | PC6-PC9 | 4-in-1 ESC | PWM 400Hz | | J5 | PC12/PD2 | 光流模块 | 115200 | | J6 | PC10/PC11 | VTX SmartAudio | 115200 | | J22 | PB10/PB11 | ELRS 接收机 | 420000 (CRSF) | --- ## 📚 文档索引 | 编号 | 文档名称 | 说明 | 链接 | |------|----------|------|------| | 00 | README.md | 项目总览与索引 (本文档) | - | | 01 | 01_definitions.md | 命名规范与接口定义 | [查看](plans/01_definitions.md) | | 02 | 02_project_roadmap.md | 项目路线图与待办事项 | [查看](plans/02_project_roadmap.md) | | 03 | 03_issue_tracker.md | 问题追踪日志 (Bug/Risk) | [查看](plans/03_issue_tracker.md) | | 04 | 04_algo_design.md | 算法设计与优化记录 | [查看](plans/04_algo_design.md) | | 05 | 05_changelog.md | 版本更新日志 | [查看](plans/05_changelog.md) | | 06 | 06_operation_guide.md | 操作指南与环境搭建 | [查看](plans/06_operation_guide.md) | | 07 | 07_research_and_ideas.md | 调研分析与创意池 | [查看](plans/07_research_and_ideas.md) | | 08 | 08_hardware_design.md | 硬件架构与 PCB 设计 | [查看](plans/08_hardware_design.md) | --- ## 🚀 快速开始 ### 1. 环境准备 ```bash # 必需软件 - Keil MDK-ARM v5.38+ - STM32CubeMX v6.10+ - ST-Link 驱动 ``` ### 2. 编译项目 1. 打开 `FLYAMASTER/MDK-ARM/FLYAMASTER.uvprojx` 2. 点击 `Build` (F7) 编译 3. 点击 `Download` (F8) 烧录 ### 3. 调试连接 - **SWD 接口**: PA13 (SWDIO), PA14 (SWCLK) - **USB 虚拟串口**: PA11/PA12 (CDC) - **匿名上位机**: USART1 (PA9/PA10) @ 921600 baud --- ## 📁 目录结构 ``` FLYAMASTER/ ├── 3D/ # 3D 模型文件 ├── FLYAMASTER/ # 固件源代码 │ ├── Core/ │ │ ├── Inc/ # 头文件 │ │ │ ├── mpu6050.h # IMU 驱动 │ │ │ ├── mahony.h # 姿态解算 │ │ │ ├── pid.h # PID 控制器 │ │ │ ├── motor.h # 电机混控 │ │ │ ├── sbus.h # CRSF 接收 │ │ │ ├── gps.h # GPS 解析 │ │ │ ├── at7456e.h # OSD 驱动 │ │ │ └── ... │ │ └── Src/ # 源文件 │ │ ├── freertos.c # RTOS 任务 │ │ ├── mpu6050.c # IMU 驱动实现 │ │ ├── mahony.c # Mahony 滤波 │ │ ├── pid.c # PID 算法 │ │ ├── motor.c # 电机控制 │ │ └── ... │ └── MDK-ARM/ # Keil 工程 │ ├── FLYAMASTER.uvprojx │ └── ... ├── Hardware/ # 硬件设计 │ └── zero star/ # KiCad 工程 │ ├── zero star.kicad_sch # 原理图 │ ├── zero star.kicad_pcb # PCB │ └── zero star.pdf # 原理图 PDF ├── plans/ # 项目文档 │ ├── README.md # 文档索引 │ ├── 01_definitions.md # 接口定义 │ ├── 02_project_roadmap.md # 路线图 │ ├── 03_issue_tracker.md # 问题追踪 │ ├── 04_algo_design.md # 算法设计 │ ├── 05_changelog.md # 更新日志 │ ├── 06_operation_guide.md # 操作指南 │ ├── 07_research_and_ideas.md # 调研分析 │ ├── 08_hardware_design.md # 硬件设计 │ └── archive/ # 废弃文档归档 ├── .gitignore # Git 忽略规则 └── LICENSE # 版权声明 ``` --- ## 🎯 项目状态 ### ✅ 已完成 - [x] 硬件驱动 (IMU, PWM, CRSF, GPS, OSD) - [x] 姿态解算 (Mahony 互补滤波) - [x] 姿态控制 (串级 PID) - [x] 定高控制 (气压计 PID) - [x] GPS 定点 (位置环 PID) - [x] OSD 显示 (AT7456E) - [x] 匿名上位机协议 (V7) - [x] 硬件原理图设计 (KiCad) - [x] 7 颗 LED 状态指示系统 - [x] USB 插入检测 (反灌保护) ### 🚧 进行中 - [ ] PCB 布局优化 - [ ] 打样验证 ### 📋 计划中 - [ ] EKF 状态估计 (可选) - [ ] 航点飞行 - [ ] 自动返航 (RTH) --- ## 👥 贡献者 - **LI** - 项目作者 & 核心开发者 - **Doro** *(Desktop Pet / 桌面宠物)* - AI 助手 & 文档撰写 --- ## ⚖️ 版权声明 ``` ================================================================================ FLYAMASTER 飞控项目 - 版权声明 ================================================================================ 版权所有 (C) 2026 FLYAMASTER 项目组 Copyright (C) 2026 FLYAMASTER Project Team 严格保留所有权利 ALL RIGHTS STRICTLY RESERVED 未经版权所有者明确书面授权，严禁： 1. 复制、下载、存储本项目的任何部分 2. 修改、改编、翻译本项目的任何内容 3. 分发、传播、共享本项目的任何文件 4. 将本项目用于任何商业目的 5. 基于本项目创建衍生作品 6. 对本项目进行逆向工程 7. 在任何平台转载、引用本项目内容 任何未经授权的使用将被视为侵权，版权所有者保留追究法律责任的权利。 详见 LICENSE 文件 ================================================================================ ``` --- ## 🙏 致谢 感谢开源社区的前辈们，特别是： - **Betaflight** / **INAV** / **ArduPilot** 项目，提供了宝贵的参考 - **Mahony** 和 **Madgwick** 的姿态解算算法论文 - **立创开源硬件平台**，提供了电源方案参考 - 所有在 GitHub Issues 中提供反馈的朋友们 --- **文档版本**: v2.4.0 **最后更新**: 2026-01-23 **作者**: LI | **助手**: Doro