ESP-Drone 安装上手：30 分钟烧录你的第一台 ESP32 无人机
【免费下载链接】esp-droneMini Drone/Quadcopter Firmware for ESP32 and ESP32-S Series SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-drone
ESP-Drone 是基于 ESP32 系列芯片的开源四旋翼方案，支持手机 App 或游戏手柄通过 Wi-Fi 遥控飞行。本文带你完成无人机安装与配置：搭好 ESP-IDF 环境、克隆代码、编译烧录，最后打开串口确认系统就绪。
它到底能做什么
- Wi-Fi 遥控：无人机自身发射 Wi-Fi 热点，手机连上即可下发控制指令，不依赖路由器。
- 三种飞行模式：Stabilize（自稳定，自动保持机身水平）、Height-hold（定高）、Position-hold（定点），后两者需要扩展板。
- 两种操控入口：手机 App 或游戏手柄任选，手柄经 cfclient 上位机接入。
- 基于 ESP32 / ESP32-S2 / ESP32-S3 芯片，代码架构清晰，适合教学与二次开发。
动手前，先核对硬件与软件清单
硬件（对照打勾）
- ESP32-S2-Drone V1.2 主板 ×1（内置 MPU6050 姿态传感器）
- 716 无刷电机 ×4 + 电机橡胶圈 ×4
- 46mm 螺旋桨 A、B 各 ×2（正反转桨别装混）
- 300mAh 1S 锂电池 ×1 + 1S 充电板 ×1
- USB 数据线 ×1（烧录、供电共用）
- 可选扩展板：气压定高（MS5611）或光流定点（PMW3901 + VL53L1X）
软件（三样就够）
- 操作系统：Windows / Linux / macOS 均可
- ESP-IDF（乐鑫官方开发框架）：建议 release/v5.0 分支，与 README 推荐一致
- 代码编辑器：VS Code 足够
从克隆仓库到点亮串口：完整配置流程
1. 装好 ESP-IDF 工具链并载入环境变量
后续每条命令都依赖这一步。
# 运行官方安装脚本，esp 表示乐鑫官方发行版 ./install.sh esp # 载入环境变量，新开终端后要重新执行 . ./export.sh🔌 验证标志：另开一个终端跑idf.py --version，能打印版本号即说明工具链就绪。
2. 克隆 esp-drone 代码
git clone https://gitcode.com/GitHub_Trending/es/esp-drone cd esp-dronecomponents/是飞控内核与传感器驱动，main/是程序入口，docs/是文档；根目录sdkconfig.defaults已预置默认参数，不用手工改。
3. 设置目标芯片（ESP-IDF 烧录前的关键一步）
set-target决定固件编译到哪款芯片，并自动匹配默认硬件。
# 默认开发板 ESP32-S2-Drone V1.2 对应 esp32s2 idf.py set-target esp32s2📡 用 ESPlane-FC-V1 旧硬件则改设esp32，再运行idf.py menuconfig在 ESPDrone Config 里核对板型与电机型号。
4. 编译与烧录固件
# 编译固件，首次编译耗时较长 idf.py build # 烧录到开发板，<PORT> 换成实际串口号 idf.py -p <PORT> flash<PORT>换成开发板连接电脑的串口号：Windows 形如 COM3，Linux/macOS 形如 /dev/ttyUSB0。
5. 打开串口观察启动输出
idf.py -p <PORT> monitor上电后日志滚动，系统就绪时蓝色 LED 正常闪烁即为成功；按Ctrl+]退出监控。
三种飞行模式怎么选
| 模式 | 行为 | 适用场景 |
|---|---|---|
| Stabilize 自稳定 | 只保持机身水平 | 首飞练习、室外 |
| Height-hold 定高 | 自动维持恒定高度 | 需要稳定高度 |
| Position-hold 定点 | 悬停在固定位置 | 室内精准悬停 |
基础配置开箱只有 Stabilize 可用；定高依赖气压/ToF 扩展板，定点依赖光流 + ToF 扩展板。
接下来可以玩什么
手机搜索 Wi-Fi 热点ESP-DRONE_XXXX（密码 12345678），用 App 推杆即可起飞。 想切到手柄？cfclient 里给 Roll / Pitch / Yaw / Thrust 四个轴加一个模式键做映射就行。 想改代码？从components/core/crazyflie/modules/的飞控模块和docs/下的驱动文档入手。
【免费下载链接】esp-droneMini Drone/Quadcopter Firmware for ESP32 and ESP32-S Series SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-drone
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
