How ckflight/ckflight-h7 works
CKFLIGHT H7 is bare-metal STM32H743 flight-controller firmware. Its principal workflow initializes board hardware and enabled peripherals, then runs a deterministic loop that samples receiver and motion inputs, computes control outputs, drives motors, and updates telemetry, OSD, and logging. The README also documents navigation, sensor options, USB/MSP configuration, and fault handling. The excerpts show only parts of the loop and selected implementations; dashed, uncited links mark documented capabilities whose call sites were not shown.
Main entry points: main.c Firmware loop · CK_MIXER.c Motor mixer · CK_GYRO.c Gyroscope · CK_USBD_INTERFACE.c USB CDC
Components 25
Real-time control
- Firmware loop
Core/Src/main.c - Receiver input
Core/Inc/FLIGHT/CK_RECEIVER.c - RC processing
Core/Inc/FLIGHT/CK_RC.c - Adjustments
Core/Inc/FLIGHT/CK_ADJUSTMENT.c - PID control
Core/Inc/FLIGHT/CK_PID.c - Motor mixer
Core/Inc/FLIGHT/CK_MIXER.c - ESC output
Core/Inc/FLIGHT/CK_ESC.c - Failsafe / landing
Core/Inc/FLIGHT/CK_LAND.c - Fault handler
Core/Inc/FLIGHT/CK_FAULTHANDLER.c
Sensors and navigation
- IMU fusion
Core/Inc/MOTION/CK_IMU.c - Gyroscope
Core/Inc/MOTION/CK_GYRO.c - Accelerometer
Core/Inc/MOTION/CK_ACC.c - GPS navigation
Core/Inc/FLIGHT/CK_GPS.c - Altitude sensing
Core/Inc/FLIGHT/CK_ALTITUDE.c - Navigation control
Core/Inc/FLIGHT/CK_NAVIGATION.c - Sensor drivers
Core/Inc/SENSORS/CK_ICM42688P.c
Communications and display
- USB CDC
Core/Inc/COMMUNICATION/USBD_CDC/CK_USBD_INTERFACE.c - MSP protocol
Core/Inc/COMMUNICATION/CK_MSP.c - Telemetry printer
Core/Inc/COMMUNICATION/CK_PRINTER.c - OSD rendering
Core/Inc/OSD/CK_OSD.c - MAX7456 display
Core/Inc/OSD/CK_MAX7456.c
Hardware and persistence
- Flight logging
Core/Inc/FLIGHT/CK_LOG.c - SD card storage
Core/Inc/DRIVERS/CK_MICROCARD.c - Peripheral drivers
Core/Inc/DRIVERS/CK_SPI.c
Other components
- Pilot / RC
Connections 29
- Pilot / RC → Receiver input: sends input
- Firmware loop → Receiver input: updates
Core/Src/main.c - Firmware loop → RC processing: updates
Core/Src/main.c - Firmware loop → Adjustments: updates
Core/Src/main.c - Firmware loop → Gyroscope: updates
Core/Src/main.c - Firmware loop → Accelerometer: updates
Core/Src/main.c - Firmware loop → PID control: runs control
Core/Src/main.c - Firmware loop → Motor mixer: updates
Core/Src/main.c - Firmware loop → OSD rendering: updates
Core/Src/main.c - Firmware loop → Flight logging: updates
Core/Src/main.c - PID control → Motor mixer: sets output
- Motor mixer → ESC output: drives motors
- Gyroscope → IMU fusion: provides motion data
Core/Inc/MOTION/CK_IMU.c - Accelerometer → IMU fusion: provides motion data
Core/Inc/MOTION/CK_IMU.c - Sensor drivers → Gyroscope: supplies readings
Core/Inc/SENSORS/CK_ICM42688P.c - Firmware loop → IMU fusion: estimates attitude
- Firmware loop → GPS navigation: uses GPS
- Firmware loop → Altitude sensing: uses barometer
- Firmware loop → Navigation control: runs navigation
- Firmware loop → Failsafe / landing: handles failsafe
- USB CDC → MSP protocol: carries protocol
Core/Inc/COMMUNICATION/CK_MSP.c - MSP protocol → USB CDC: writes responses
Core/Inc/COMMUNICATION/CK_MSP.c - Firmware loop → USB CDC: services USB
- Firmware loop → Telemetry printer: emits telemetry
- OSD rendering → MAX7456 display: renders through
Core/Inc/OSD/CK_MAX7456.c - Firmware loop → SD card storage: logs to storage
- Flight logging → SD card storage: writes flight data
- Peripheral drivers → Sensor drivers: communicates with
Core/Inc/SENSORS/CK_ICM42688P.c - Fault handler → ESC output: stops motors
Core/Inc/FLIGHT/CK_FAULTHANDLER.c