企业官网建设流程全解析

从 0 到起飞：ESP-Drone 无人机固件一次搞定的上手指南

【免费下载链接】esp-droneMini Drone/Quadcopter Firmware for ESP32 and ESP32-S Series SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-drone

ESP-Drone 是基于乐鑫 ESP32/ESP32-S2/ESP32-S3 Wi-Fi 芯片的开源迷你无人机方案，飞控固件用 C 语言在 ESP-IDF 框架上开发。跟着本文做完，你就能用手机 APP 或游戏手柄通过 Wi-Fi 连接无人机，让它完成自稳定、定高飞行。

项目速览

• 支持三种飞行模式：自稳定（自动保持机身水平）、定高、定点，后两种需要加装扩展板（一块提供额外传感器的电路板）
• 手机 APP 或 PC 上位机 + 游戏手柄两种控制方式，全部走 Wi-Fi，不用额外买遥控
• 飞控代码移植自 Crazyflie 开源工程，任务划分清晰，方便你读懂飞行控制逻辑
• 硬件就是主控板 + 可选扩展板，适合 STEM 教学和创客练手

动手前的准备清单

硬件

• ESP32-S2 Drone V1.2 主控板（或用 ESP32 / ESP32-S3 开发板起步）
• 电机、螺旋桨，建议同时准备桨叶保护罩
• 锂电池 + USB 数据线
• 可选：气压定高模块或光流 + TOF 定点扩展板

软件

• 操作系统：Windows / Linux / macOS 均可
• ESP-IDF：建议用 release/v5.0 分支，与本项目固件 API 匹配，其他版本可能编译不过
• Git（用于拉取代码）
• 编辑器：VS Code 或你顺手的任意一款

清单齐了就可以开工。整个流程分四步：装工具链、拉代码、编译、烧录，一次下来大概半小时。

分步搭建

把 ESP-IDF 工具链装好

ESP-IDF 里含编译器、底层库和烧录工具，一次装好后面通用。先到乐鑫官网下载 release/v5.0 版本的 ESP-IDF，解压到不含空格的路径（例如~/esp/esp-idf），然后依次运行安装脚本和环境脚本：

./install.sh # Linux/macOS 安装依赖与工具链；Windows 运行 install.bat . ./export.sh # 加载环境变量；Windows 运行 export.bat，每次开新终端都要执行

✅ 完成标志：运行idf.py --version能打印版本号，说明环境就绪。

把 ESP-Drone 代码拉下来

接下来把项目源码克隆到本地，进入目录后你会看到main/、components/等目录，这就是无人机固件的工程结构：

git clone https://gitcode.com/GitHub_Trending/es/esp-drone cd esp-drone

✅ 完成标志：ls能看到main/、components/、docs/等目录。

设置目标芯片并编译固件

同一套代码支持三种芯片，set-target决定按哪个芯片编译。以 ESP32-S2 为例，你的主控板是什么芯片就改成对应的esp32或esp32s3：

idf.py set-target esp32s2 idf.py build

首次编译会花几分钟，耐心等它跑完。✅ 完成标志：结尾出现 "Project build complete"，build/目录里生成了.bin固件文件。

把固件烧录到主控板

用 USB 线连上主控板，执行下面命令烧录。<PORT>替换成你的实际端口，Linux 常见/dev/ttyUSB0，Windows 常见COM3：

idf.py -p <PORT> flash

✅ 完成标志：出现写入进度并以 "Hash of data verified." 收尾，固件就进去了。

第一次飞起来

先确认固件跑起来了：运行idf.py -p <PORT> monitor打开串口监视，能看到连续的启动日志且无报错即正常（按Ctrl+4退出）。

如果走 cfclient 上位机 + 游戏手柄路线，界面长这样，需要在其中配置 Roll、Pitch、Yaw、Thrust 四个控制轴：

走手机 APP 路线更简单：

1. 手机 Wi-Fi 搜索到ESP-DRONE_XXXX（XXXX 随设备 MAC 变化），密码固定12345678
2. 打开 ESP-Drone APP 点Connect，飞机尾部绿灯快闪就是连上了
3. 轻推油门起飞，在屏幕上滑动控制方向

🛡️ 第一次起飞前，请一定做好这几件事：装好螺旋桨保护罩；选择开阔、远离人群和玻璃的场地；上电后确认头部电量红灯不亮；油门只轻推，动作不对随时松油门，飞机会自动降落。

接下来可以玩什么

• 在 cfclient 里在线调 PID 参数并实时查看传感器波形，完整操作流程见 快速入门文档
• 加扩展板解锁定高、定点模式，主控板引脚与扩展接口参考 硬件说明
• 读懂 APP 与固件之间的通信协议后动手魔改，见 通信协议文档

现在你的无人机已经在手，可以放心大胆地把参数调出更顺滑的手感了。

【免费下载链接】esp-droneMini Drone/Quadcopter Firmware for ESP32 and ESP32-S Series SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-drone