ESP-Drone
Based on published sources · Not tested by us ·
Overview
ESP32-based educational quadcopter with a documented S2 V1.2 build and sensor-dependent assisted flight modes. [S001] [S005] [S006]
ESP-Drone is Espressif's small Wi-Fi-controlled quadcopter project, with flight-control code derived from Crazyflie. This profile selects the documented ESP32-S2-Drone V1.2 configuration. The repository supports other ESP32-family targets, but their board layouts and setup requirements should not be combined into one build. Upstream states that support has been limited since December 2022. [S001] [S005]
Specifications
| Detail | Description |
|---|---|
| Type | Small quadcopter; selected ESP32-S2-Drone V1.2 Reported by source [S005] · Checked 2026-10-01 |
| Intended users | Embedded developers and supervised robotics learners Editorial assessment [S001] · Checked 2026-10-01 |
| Assembly | Not known |
| Calibration | Not known |
| Operating system | Not known |
| Computer needed | Not known |
3D preview
Preview not available yet. A model has not yet been prepared and approved for display on this page. This does not mean the project lacks CAD files; see Source files and licenses for the reviewed source availability.
Assembly and use
What the base configuration contains
The V1.2 parts list specifies an ESP32-S2-WROVER/MPU6050 main board, four 716 motors with rubber mounting rings, two A and two B 46 mm propellers, a 300 mAh 1S LiPo battery, a separate 1S charger and pin headers. It lists 720 motors, 55 mm propellers and a 350 mAh battery as alternatives. Selecting the 720 motor also requires changing the motor setting in menuconfig; these alternatives are not extra items to add to the base bill. A current delivered cost was not established. [S005]
The selected board integrates the airframe arrangement rather than using the separate frame required by the older ESPlane-FC-V1. The assembly guide includes motor soldering and a separate A/B propeller-direction diagram. Follow the diagram for the exact board rather than assuming all four propellers are interchangeable. No assembly or flight was performed for this review. [S005] [S006] [S011]
Assisted flight requires additional hardware
The main-board MPU6050 supports the basic flight configuration. The position-hold extension uses PMW3901 optical flow plus VL53L1X ranging and mounts underneath, facing the ground. A pressure-sensor route uses MS5611. The guide further distinguishes pressure-based altitude hold from ranging-based height hold, so the word “hold” alone is insufficient to identify the required sensors or operating conditions. [S005] [S006]
These documented modes are upstream capabilities, not catalog-tested performance. The guide includes level-surface startup, sensor orientation and battery-status checks. A successful Wi-Fi connection does not establish that the sensor stack, motor directions or control mapping are correct. [S006]
Keep the development and control software matched
The documented development environment is ESP-IDF release/v5.0. Upstream's preserved build workflow includes v4.4 and v5.0 containers, but that workflow configuration is not evidence that this review built either version successfully. Record the source revision, target chip and selected hardware settings together before flashing. [S007] [S009]
Control can use a mobile app, with a customized cfclient route for PC debugging and gamepad input. The README points to the leeebo cfclient fork while the detailed guide names qljz1993. That mismatch remains unresolved here; compatibility of either fork with the selected firmware was not tested. The guide also warns that online parameter changes are for debugging and do not survive power-down. Preserve final tuning in the appropriate persistent configuration rather than relying on a running session. [S001] [S006]
Source coverage and remaining gaps
The main repository carries GPL-3.0 and attributes its Crazyflie-derived code. Its third-party table leaves the DSP library's license field blank, so the root license is not presented as a complete audit of every dependency. External mobile applications and client forks require their own source and license checks. [S001] [S003] [S008]
The archive includes hardware schematics, PCB PDFs and BOM spreadsheets, including the S2 V1.2 board and flow deck. Their presence does not establish a complete editable manufacturing package or specific hardware reuse terms. BOM rows and circuit correctness were not validated. No firmware build, flashing, radio-control test or flight test was performed. [S005] [S010]
Cost
No current, complete configuration-specific build cost has been established for this profile.
Source files and licenses
Available project sources support research coverage; complete build and commercial qualification remain separate.
| Layer | Availability / license |
|---|---|
| mechanical design | not found · License not fully assessed Selected PCB-based assembly is documented, but a separately licensed editable mechanical fabrication package was not established. [S005] [S010] |
| electronics | available · License not fully assessed Schematics, PCB PDFs and BOM spreadsheets are present. Specific hardware reuse terms and editable manufacturing completeness were not established; not inferred from firmware GPL. [S005] [S010] |
| firmware | available · GPL-3.0 Repository GPL3 license; DSP attribution table leaves its license blank. No blanket dependency-license or compatibility certification. [S001] [S003] [S008] [S010] |
| software | not found · License not fully assessed External Android/iOS repositories and customized cfclient forks are linked, but their matched sources and licenses were not included in this review. This is not a closed-source finding. [S001] [S006] |
| documentation | available · GPL-3.0 Repository GPL3 license; DSP attribution table leaves its license blank. No blanket dependency-license or compatibility certification. [S001] [S003] [S008] [S010] |
Selected flight-control route does not require learned weights or training data.
References
Links identify the documentation and revisions used in this profile. Access dates record when each source was retrieved.
- S001 · espressif / project contributors
Upstream project overview
Accessed 2026-10-01 · README.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S002 · espressif / project contributors
Repository revision and release metadata
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5faSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S003 · espressif / project contributors
Repository license
Accessed 2026-10-01 · LICENSESource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S004 · espressif / project contributors
Pinned repository artifact inventory
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa archive file inventorySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S005 · espressif / project contributors
docs/en/rst/hardware.rst
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / docs/en/rst/hardware.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S006 · espressif / project contributors
docs/en/rst/gettingstarted.rst
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / docs/en/rst/gettingstarted.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S007 · espressif / project contributors
docs/en/rst/getespidf.rst
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / docs/en/rst/getespidf.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S008 · espressif / project contributors
docs/en/rst/notice.rst
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / docs/en/rst/notice.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S009 · espressif / project contributors
.github/workflows/build_project.yml
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / .github/workflows/build_project.ymlSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S010 · espressif / project contributors
Complete archive inventory
Accessed 2026-10-01 · Pinned archive filenamesSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S011 · espressif / project contributors
Assembly image labels
Accessed 2026-10-01 · db0f6562e4f67cccee3acac4dff39c9aaea4e5fa / docs/_static/assembling_en.png; visual transcriptionSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1