How okalachev/flix works
Flix is an ESP32 quadcopter flight-control product with firmware, MAVLink control, a Gazebo simulation that runs the Arduino firmware, and Python automation and log-analysis tools. The principal workflow is pilot or script input over Wi-Fi/ESP-NOW, firmware state estimation and control, then motor actuation; telemetry and logs flow back to operators. The tree and README establish the major capabilities, while sampled source confirms the simulator and Python message handling; some firmware wiring is represented only at subsystem level.
Main entry points: flix.ino Firmware entry · simulator.cpp Gazebo plugin · flix.py Python flight API · mavlink.ino MAVLink protocol
Components 26
Flight firmware
- Firmware entry
flix/flix.ino - RC input
flix/rc.ino - Wireless link
flix/wifi.ino - MAVLink protocol
flix/mavlink.ino - IMU acquisition
flix/imu.ino - State estimation
flix/estimate.ino - Flight control
flix/control.ino - Flight safety
flix/safety.ino - Motor output
flix/motors.ino - Power monitoring
flix/power.ino - Wireless CLI
flix/console.ino - Flight logging
flix/log.ino - Parameters
flix/parameters.ino
Gazebo simulation
- Gazebo plugin
gazebo/simulator.cpp - Drone world model
gazebo/flix.world - Arduino compatibility
gazebo/Arduino.h
Control and analysis
- Python flight API
tools/pyflix/flix.py - MAVLink proxy
tools/pyflix/proxy.py - Log download
tools/log.py - CSV to ULog
tools/csv_to_ulog/csv_to_ulog.cpp
Flight primitives
- Vector math
flix/vector.h - Quaternion math
flix/quaternion.h
Other components
- Pilot / QGroundControl
- Motors / ESCs
- IMU sensor
- CSV flight log
Connections 30
- Pilot / QGroundControl → RC input: pilot input
- Pilot / QGroundControl → Wireless link: MAVLink control
- Wireless link → MAVLink protocol: transports
- RC input → Firmware entry: control input
- MAVLink protocol → Firmware entry: commands
- Firmware entry → IMU acquisition: samples
- Firmware entry → State estimation: updates
- Firmware entry → Flight control: runs control
- Firmware entry → Flight safety: checks safety
- Firmware entry → Motor output: sets outputs
- Motor output → Motors / ESCs: drives
- IMU sensor → IMU acquisition: sensor data
- Firmware entry → Power monitoring: monitors voltage
- Firmware entry → Wireless CLI: serves commands
- Firmware entry → Flight logging: records state
- Firmware entry → Parameters: uses settings
- State estimation → Vector math: uses math
- State estimation → Quaternion math: uses rotations
- Gazebo plugin → Arduino compatibility: uses compatibility
- Gazebo plugin → Firmware entry: runs flight code
- Drone world model → Gazebo plugin: loads model
- Gazebo plugin → IMU acquisition: supplies virtual IMU
- Gazebo plugin → Motor output: applies forces
- Python flight API → Pilot / QGroundControl: scripted control
- Python flight API → MAVLink protocol: sends commands
- MAVLink protocol → Python flight API: telemetry
- MAVLink proxy → Python flight API: forwards packets
- Log download → Python flight API: downloads log
- Log download → CSV flight log: writes CSV
- CSV to ULog → CSV flight log: reads CSV