Zero star

🚁 FLYAMASTER 飞控项目

⚠️ 版权警告 / COPYRIGHT WARNING ⚠️

本项目受版权保护，严格保留所有权利！

🚫 禁止 未经授权的复制、修改、分发、商用 🚫 禁止 Fork、Clone、Download 本仓库 🚫 禁止 转载、引用本项目任何内容

违者将依法追究法律责任！详见 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

项目名称: FLYAMASTER - F405 Mini 高性能穿越机飞控 版本: v2.4.0 最后更新: 2026-01-23 状态: 🟢 开发中 (软件完成，硬件设计完成，等待验证) 作者: LI 助手: Doro (Desktop Pet / 桌面宠物)

📖 项目简介

FLYAMASTER 是一款基于 STM32F405RGT6 的高性能、开源、易扩展的四轴飞行控制器。

🌟 项目由来

"每个飞手心中都有一个造飞控的梦。"

这个项目源于我对无人机的热爱。从第一次看到穿越机在空中翻滚、俯冲的那一刻起，我就被这种自由飞翔的感觉深深吸引。作为一名嵌入式开发者，我不满足于仅仅使用现成的飞控，而是想要从零开始，亲手打造一款属于自己的飞行控制器。

这不仅仅是一个技术项目，更是一段探索之旅——从最初的 Mahony 姿态解算调试，到 PID 参数的反复调优；从 DMA 通道冲突的抓狂，到最终看到四轴稳稳悬停的那一刻的成就感。每一行代码、每一条 PCB 走线，都凝聚着对飞行的热爱和对技术的追求。

FLYAMASTER = FLY (飞行) + A (一个) + MASTER (大师) —— 愿每一位使用者都能成为飞行大师！

🎯 多固件支持

本硬件设计兼容多种主流开源飞控固件：

💡 提示: 硬件引脚分配遵循 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 专业飞行仪表盘

🔧 问题发现与解决

开发过程中遇到了不少"坑"，这里记录一些典型问题和解决方案：

问题 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 后台发送。

🛠️ 技术栈

📐 硬件设计

PCB 渲染图

正面 (Top)	反面 (Bottom)

原理图

📄 原理图 PDF: Hardware/zero star/zero star.pdf

主要芯片

接口定义

📚 文档索引

🚀 快速开始

1. 环境准备

# 必需软件
- 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/                # 硬件设计

🎯 项目状态

✅ 已完成

• 硬件驱动 (IMU, PWM, CRSF, GPS, OSD)
• 姿态解算 (Mahony 互补滤波)
• 姿态控制 (串级 PID)
• 定高控制 (气压计 PID)
• GPS 定点 (位置环 PID)
• OSD 显示 (AT7456E)
• 匿名上位机协议 (V7)
• 硬件原理图设计 (KiCad)
• 7 颗 LED 状态指示系统
• 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