How pcb-yun/logcar works
This is a RoboCup logistics robot project with STM32/FreeRTOS control firmware and a Raspberry Pi vision program. The main operational workflow sequences pickup, navigation, sorting or transfer, and return-home actions; navigation turns targets into chassis motion, while sensor and actuator drivers interface with the hardware. Separate branches provide vision-based recognition, OLED/media display, and a serial command shell with games. Relationships reflect the README and shown source references/calls; unsampled implementations are represented only where documented.
Main entry points: mission.c Mission scheduler · nav_core.c Navigation core · turntable_port.c Turntable control · main.py Vision dispatcher
Components 26
Mission orchestration
- STM32 firmware
Core/Src/main.c - Mission scheduler
Applications/LogCar_mission/mission.c - RTOS events
Drivers/User/RTOS/Events.h
Navigation and motion
- Navigation core
Applications/nav/nav_core.c - Map and targets
Applications/nav/nav_map.c - Localization
Applications/nav/localization/nav_local.c - Path tracking
Applications/nav/nav_track.c - Chassis control
Applications/chassis/chassis.c - Motion control
Applications/chassis/motion/motion_control.c - Wheel kinematics
Applications/chassis/kinematics/kinematics.c
Handling and hardware
- Arm actions
Applications/arm/arm_action.c - Turntable control
Applications/turntable/turntable_port.c - Turntable mechanism
Applications/turntable/turntable_ctrl.c - Sensor drivers
Drivers/User/SENSOR/sensor.c - Vision serial link
Drivers/User/SENSOR/rpi_sensor_port.c - Stepper driver
Drivers/User/STEP/step_port_dlc.c - Servo driver
Drivers/User/SERVO/servo_driver.c
Vision system
- Vision dispatcher
vision/main.py - Color detection
vision/yanse.py - Ring detection
vision/yuanhuan.py
Operator interfaces
- Serial shell
Applications/letter_shell/src/shell.c - Shell port
Applications/letter_shell/shell_port.c - OLED display
Applications/Display/dsp_tool.c - Display media
Applications/Display/show_media.c
Other components
- Operator
- CSI camera
Connections 28
- Mission scheduler → Navigation core: navigates
Applications/LogCar_mission/mission.c - Mission scheduler → Map and targets: reads targets
Applications/LogCar_mission/mission.c - Mission scheduler → Path tracking: starts tracking
Applications/LogCar_mission/mission.c - Mission scheduler → Chassis control: commands motion
Applications/LogCar_mission/mission.c - Mission scheduler → Arm actions: runs actions
Applications/LogCar_mission/mission.c - Mission scheduler → Turntable control: sorts materials
Applications/LogCar_mission/mission.c - Mission scheduler → Sensor drivers: reads sensors
Applications/LogCar_mission/mission.c - Mission scheduler → Vision serial link: requests recognition
Applications/LogCar_mission/mission.c - Navigation core → Map and targets: looks up targets
Applications/nav/nav_core.c - Navigation core → Localization: uses localization
Applications/nav/nav_core.c - Navigation core → Motion control: sets velocity
Applications/nav/nav_core.c - Chassis control → Motion control: delegates motion
Applications/chassis/chassis.c - Motion control → Wheel kinematics: solves wheel speeds
Applications/chassis/motion/motion_control.c - Motion control → Stepper driver: sends motor commands
Applications/chassis/motion/motion_control.c - Turntable control → Turntable mechanism: controls mechanism
Applications/turntable/turntable_port.c - Turntable control → Sensor drivers: detects color
Applications/turntable/turntable_port.c - Turntable control → Vision serial link: requests color
Applications/turntable/turntable_port.c - Turntable mechanism → Servo driver: drives servos
- CSI camera → Vision dispatcher: provides frames
README.md - Vision dispatcher → Color detection: dispatches color
vision/main.py - Vision dispatcher → Ring detection: dispatches ring
vision/main.py - Vision dispatcher → Vision serial link: sends results
README.md - Operator → Serial shell: enters commands
README.md - Serial shell → Shell port: uses serial port
- Operator → OLED display: views status
README.md - OLED display → Display media: renders media
Applications/Display/dsp_tool.c - Mission scheduler → RTOS events: waits on flags
Applications/LogCar_mission/mission.c - STM32 firmware → Mission scheduler: runs mission task