Making an ESP32-based quadcopter from scratch
Python arduinoautopilotcontrol-theorydroneesp32flight-controlflight-controllermavlinkquadcopterquadcopter-firmwareuav
Update docs Use nicer youtube video previews. Add Robocamp 2026 section.
Oleg Kalachev517b2cfef356
diff --git a/README.md b/README.mdindex f1bc75e..085aa81 100644--- a/README.md+++ b/README.md@@ -53,13 +53,13 @@ The official PCB *(Flix2)* is in development now. Follow the [project's channel]Outdoor flights demo video of the current prototype:-<a href="https://youtu.be/KXlNmvUTi4g"><img width=300 src="https://i3.ytimg.com/vi/KXlNmvUTi4g/maxresdefault.jpg"></a>+<a href="https://youtu.be/KXlNmvUTi4g"><img width=300 src="https://quadcopter.dev/video/KXlNmvUTi4g.svg"></a>### Position controlThe position control feature is in development. RoboCamp 2026 demo (using an overhead camera, [sources](https://github.com/xTimop/flix-poscontrol/compare/robolager2026...xTimop:flix-poscontrol:poscontrol)):-<a href="https://youtu.be/369Xowm4HcU"><img width=300 src="https://i3.ytimg.com/vi/369Xowm4HcU/maxresdefault.jpg"></a>+<a href="https://youtu.be/369Xowm4HcU"><img width=300 src="https://quadcopter.dev/video/369Xowm4HcU.svg"></a>## Simulationdiff --git a/docs/troubleshooting.md b/docs/troubleshooting.mdindex 28af53f..147fbf6 100644--- a/docs/troubleshooting.md+++ b/docs/troubleshooting.md@@ -28,7 +28,7 @@ Do the following:* **Calibrate the accelerometer.** if is wasn't done before. Type `ca` command in Serial Monitor and follow the instructions.* **Check the attitude estimation**. Connect to the drone using QGroundControl. Rotate the drone in different orientations and check if the attitude estimation is shown exactly as on the video below:- <a href="https://youtu.be/yVRN23-GISU"><img width=200 src="https://i3.ytimg.com/vi/yVRN23-GISU/maxresdefault.jpg"></a>+ <a href="https://youtu.be/yVRN23-GISU"><img width=200 src="https://quadcopter.dev/video/yVRN23-GISU.svg"></a>* **Check the IMU output**. Connect to the drone using QGroundControl on your computer. Go to the *Analyze* tab, *MAVLINK Inspector*. Plot the data from the `SCALED_IMU` message. The gyroscope and accelerometer data should change according to the drone movement.* **Check the motors type**. Motors with exact 3.7V voltage are needed, not ranged working voltage (3.7V — 6V).diff --git a/docs/usage.md b/docs/usage.mdindex 1b8b13f..b109276 100644--- a/docs/usage.md+++ b/docs/usage.md@@ -210,7 +210,7 @@ After this setup, you should see the battery voltage in QGroundControl top panel2. Check the attitude estimation: connect to the drone using QGroundControl, rotate the drone in different orientations and check if the attitude estimation shown in QGroundControl is correct. Compare your attitude indicator (in the *large vertical* mode) to the video:- <a href="https://youtu.be/yVRN23-GISU"><img width=300 src="https://i3.ytimg.com/vi/yVRN23-GISU/maxresdefault.jpg"></a>+ <a href="https://youtu.be/yVRN23-GISU"><img width=300 src="https://quadcopter.dev/video/yVRN23-GISU.svg"></a>3. Perform motor tests. Use the following commands **— remove the propellers before running the tests!**diff --git a/docs/user.md b/docs/user.mdindex ee57b6f..51aedd4 100644--- a/docs/user.md+++ b/docs/user.md@@ -2,6 +2,22 @@This page contains user-built drones based on the Flix project. Publish your projects into the official Telegram-chat: [@opensourcequadcopterchat](https://t.me/opensourcequadcopterchat) or send materials as a pull request.+## RoboCamp 2026++<p align=center>+ <a href="https://quadcopter.dev/img/user/robocamp2026/1.jpg"><img height=200 src="https://quadcopter.dev/img/user/robocamp2026/1.preview.jpg"></a> <a href="https://quadcopter.dev/img/user/robocamp2026/2.jpg"><img height=200 src="https://quadcopter.dev/img/user/robocamp2026/2.preview.jpg"></a> <a href="https://quadcopter.dev/img/user/robocamp2026/3.jpg"><img height=200 src="https://quadcopter.dev/img/user/robocamp2026/3.preview.jpg"></a>+</p>++The second Flix RoboCamp event took place in July 2026 in Saint Petersburg. The main goal for the competitors was to build a Flix-based quadcopter and implement **autonomous position control** using distance sensors and an overhead camera. Several participants were able to implement altitude hold, and two participants implemented stable position hold.++### Highlights++The winning project performed an automatic takeoff, stable position hold (2 min+), and navigation to a point selected by the user by clicking on the camera image.++See the demonstration video:++<a href="https://youtu.be/369Xowm4HcU"><img width=300 src="https://quadcopter.dev/video/369Xowm4HcU.svg"></a>+---Author: [Oleg1405](https://t.me/Oleg1405).<br>@@ -41,7 +57,7 @@ Repository with all the code and PCB sources: https://github.com/Frapais/Sprig-DDetailed video about making the drone:-<a href="https://youtu.be/82Q-uBq6s48"><img width=400 src="https://i3.ytimg.com/vi/82Q-uBq6s48/maxresdefault.jpg"></a>+<a href="https://youtu.be/82Q-uBq6s48"><img width=400 src="https://quadcopter.dev/video/82Q-uBq6s48.svg"></a>---@@ -173,7 +189,7 @@ RoboCamp took place in July 2025, Saint Petersburg, where 9 participants designeSee the detailed video about the event:-<a href="https://youtu.be/Wd3yaorjTx0"><img width=500 src="https://img.youtube.com/vi/Wd3yaorjTx0/sddefault.jpg"></a>+<a href="https://youtu.be/Wd3yaorjTx0"><img width=500 src="https://quadcopter.dev/video/Wd3yaorjTx0.sd.svg"></a>Built drones: