How bitcraze/crazyflie-clients-python works
This repository provides four host applications: the graphical and headless Crazyflie clients, a firmware loader, and a ZeroMQ interface. In the main GUI workflow, the client initializes the radio drivers and Crazyflie link, then exposes connection management and flight, parameter, logging, and visualization features. Input-device discovery, mapping, and multiplexing provide a separate control-input branch; Lighthouse positioning provides a specialized configuration and estimation branch. Edges are limited to relationships visible in the supplied excerpts, source index, or README; several capabilities are documented but their detailed wiring was not sampled.
Main entry points: main.py GUI runtime · __init__.py Input manager · lighthouse_tab.py Lighthouse positioning · gui.py Desktop client
Components 19
Client applications
- Desktop client
src/cfclient/gui.py - GUI runtime
src/cfclient/ui/main.py - Headless client
src/cfclient/headless.py - Firmware loader
src/cfloader/__init__.py
Control and connection
- Crazyflie link
- Connection controls
src/cfclient/ui/connectivity_manager.py - Input manager
src/cfclient/utils/input/__init__.py - Input readers
src/cfclient/utils/input/inputreaders - Input multiplexers
src/cfclient/utils/input/mux - Input mappings
src/cfclient/utils/config_manager.py
Flight and configuration
- Flight and data tabs
src/cfclient/ui/tabs - Tab framework
src/cfclient/ui/tab_toolbox.py - Firmware service UI
src/cfclient/ui/dialogs/bootloader.py - Lighthouse positioning
src/cfclient/ui/tabs/lighthouse_tab.py - Geometry estimator
src/cfclient/ui/widgets/geo_estimator_widget.py - App configuration
src/cfclient/utils/config.py
Host interfaces
- ZeroMQ interface
src/cfzmq/__init__.py - cflib
Other components
- Operator
Connections 21
- Operator → Desktop client: launches
- Desktop client → GUI runtime: starts
src/cfclient/gui.py - GUI runtime → cflib: initializes drivers
src/cfclient/ui/main.py - GUI runtime → Connection controls: uses
src/cfclient/ui/main.py - GUI runtime → Input manager: uses
src/cfclient/ui/main.py - GUI runtime → App configuration: reads
src/cfclient/ui/main.py - GUI runtime → Flight and data tabs: hosts
src/cfclient/ui/main.py - GUI runtime → Tab framework: uses
src/cfclient/ui/main.py - GUI runtime → Firmware service UI: opens
src/cfclient/ui/main.py - GUI runtime → cflib: creates Crazyflie
src/cfclient/ui/main.py - Input manager → Input readers: discovers
src/cfclient/utils/input/__init__.py - Input manager → Input multiplexers: dispatches through
src/cfclient/utils/input/__init__.py - Input manager → Input mappings: loads mappings
src/cfclient/utils/input/__init__.py - Lighthouse positioning → Geometry estimator: embeds
src/cfclient/ui/tabs/lighthouse_tab.py - Lighthouse positioning → Tab framework: extends
src/cfclient/ui/tabs/lighthouse_tab.py - Operator → Headless client: launches
- Headless client → Input manager: uses
src/cfclient/headless.py - Operator → Firmware loader: invokes
- Firmware loader → cflib: flashes firmware
src/cfloader/__init__.py - Operator → ZeroMQ interface: connects via
- ZeroMQ interface → cflib: controls and queries
src/cfzmq/__init__.py