How liren197968/sweeprobot works
Project type and purpose
• This is an embedded-firmware project for a “SweepRobot” (a vacuum-cleaning robot) running primarily on an STM32F4 microcontroller.
• There is also a Cortex-A53 directory (likely Linux or higher-level code) and a smaller “JoystickProject” that demonstrates USB-host joystick support on STM32F4.
File structure
• Top-level:
• CortexA53 – higher-level code (Linux? analysis tools)
• Stm32F4 – two subprojects: JoystickProject and RobotProject
• Document – design docs, schematics, PCA9685 spec
• RobotProject layers:
• Drivers – CMSIS core + DSP libraries, STM32 HAL driver, RTOS template, USB-host middleware
• Middlewares – ST USB-Host stack (HID class)
• Robot – application modules (control algorithms, DH math)
• RobotDriver – sensor and actuator drivers (IMU, gas sensor, LoRa, motors, servos, OLED, beeper, battery monitor, Bluetooth, EEPROM, etc.)
• Src/Inc – board-specific initialization, peripheral wrappers (GPIO, I2C, SPI, ADC, DMA, TIM, USART, USB host)
• .ioc, MDK-ARM – CubeMX and Keil project configurations
README.md
• Confirms this is the open-source code for a sweep-robot.
Final advice
• Be very detailed: capture each bus, driver module, and external device as its own block.
• Explicitly separate layers and show how data flows from sensor inputs through drivers into the control algorithm, and back out as motor commands.