How sailing-team-polimi/2025_software works
This is ROS 2 boat-operation software for the 2025 SuMoth competition. The intended operational workflow spans onboard CAN and GPS sensing, sensor conversion and state estimation, then flap control and operator monitoring. The sampled code confirms CAN packet parsing, IMU publication, and the PID controller’s topic-driven control loop; README descriptions establish the broader package capabilities. Several cross-package runtime links are not shown in the available excerpts, so those are omitted or marked unverified rather than presented as confirmed calls.
Main entry points: sensor_fusion.launch.py State Fusion · pid_node.cpp PID Controller Node · Parser.cpp CAN Parser · orca.launch.py Boat Operations Launcher
Components 20
Onboard Sensing
- UART CAN Interface
ros2_ws/src/can_bus/include/can_bus/BusInterface.hpp - CAN Parser
ros2_ws/src/can_bus/src/parsers/Parser.cpp - Sensor Interface
ros2_ws/src/can_bus/include/can_bus/sensors/Sensor.hpp - Potentiometer Sensor
ros2_ws/src/can_bus/src/sensors/PotenziometerSensor.cpp - IMU Parser
ros2_ws/src/can_bus/src/imu_parser_node.cpp - GPS Interface
ros2_ws/src/gps_interface/gps_interface/gps_node.py
State Estimation
- Sensor Estimates
ros2_ws/src/sensor_estimates/src/wand2est_node.cpp - GPS Local Conversion
ros2_ws/src/state_estimation/src/gps_to_local.cpp - GPS Coordinate Conversion
ros2_ws/src/state_estimation/src/local_to_gps.cpp - State Fusion
ros2_ws/src/state_estimation/launch/sensor_fusion.launch.py - Ride Height
ros2_ws/src/state_estimation/src/ride_height_node.cpp
Flap Control
- PID Controller Node
ros2_ws/src/flap_control/src/pid_node.cpp - PID Controller
ros2_ws/src/flap_control/include/flap_control/PIDController.hpp - Servo Mapping
ros2_ws/src/flap_control/src/ServoMapper.cpp - Wand Servo Control
ros2_ws/src/flap_control/src/wand2servo.cpp
Boat Operations
- Boat Operations Launcher
ros2_ws/src/orca/launch/orca.launch.py
Operator Monitoring
- Foxglove and RViz
ros2_ws/src/gui/launch/foxglove_full.launch.py - Custom Monitor Bridge
ros2_ws/src/poli_sail_gui/poli_sail_gui/send_to_monitor.py
Other components
- Boat Sensors
- CAN Microcontroller
Connections 22
- Boat Sensors → CAN Microcontroller: sends sensor data
- CAN Microcontroller → UART CAN Interface: sends CAN over UART
- UART CAN Interface → CAN Parser: provides packets
ros2_ws/src/can_bus/src/parsers/Parser.cpp - CAN Parser → Sensor Interface: dispatches packets
ros2_ws/src/can_bus/src/parsers/Parser.cpp - CAN Parser → Potentiometer Sensor: configures and dispatches
ros2_ws/src/can_bus/src/parsers/Parser.cpp - Potentiometer Sensor → Sensor Interface: implements interface
- IMU Parser → Boat Sensors: publishes IMU data
- GPS Interface → GPS Local Conversion: provides GPS data
- GPS Local Conversion → State Fusion: feeds localization
- Sensor Estimates → State Fusion: provides estimates
- State Fusion → GPS Coordinate Conversion: supports coordinate output
- State Fusion → Ride Height: supports ride-height state
- PID Controller Node → PID Controller: computes control
ros2_ws/src/flap_control/src/pid_node.cpp - PID Controller → PID Controller Node: returns control value
ros2_ws/src/flap_control/src/pid_node.cpp - State Fusion → PID Controller Node: provides measurement
- PID Controller Node → Servo Mapping: provides control output
- Wand Servo Control → Servo Mapping: uses mapping
- Boat Operations Launcher → CAN Parser: starts operations
- Boat Operations Launcher → State Fusion: starts operations
- Boat Operations Launcher → PID Controller Node: starts control
- State Fusion → Foxglove and RViz: visualizes boat state
- State Fusion → Custom Monitor Bridge: sends monitoring data