How itu-auv/auv-software works
This repository is the ITU AUV Team’s ROS software stack. Its principal workflow is mission state machines selecting task behavior, planning paths, and executing vehicle control through thruster allocation; hardware bridges connect ROS to vehicle devices. Separate branches provide perception, localization and mapping, teleoperation, and simulation. The tree and excerpts establish some module relationships, but many runtime ROS-topic and action-server connections are not shown, so those links are omitted or marked unverified.
Main entry points: common.py Mission Behaviors · controller_ros.h ROS Controller · path_planners.py Path Planners · follow_path_action_server.py Follow Path Server
Components 21
Mission & Navigation
- Mission State Machine
auv_smach/scripts/main_state_machine.py - Task States
auv_smach/src/auv_smach - Mission Behaviors
auv_smach/src/auv_smach/common.py - Path Planners
auv_navigation/auv_navigation/src/auv_navigation/path_planning/path_planners.py - Path Helpers
auv_navigation/auv_navigation/src/auv_navigation/path_planning/path_planning_helpers.py - Follow Path Server
auv_navigation/auv_navigation/scripts/follow_path_action_server.py - Follow Path Client
auv_navigation/auv_navigation/src/auv_navigation/follow_path_action/follow_path_client.py
Vehicle Control
- ROS Controller
auv_control/auv_control/include/auv_control/controller_ros.h - 6-DOF PID
auv_control/auv_controllers/include/auv_controllers/multidof_pid_controller.h - Vehicle Model
auv_control/auv_controllers/include/auv_controllers/model.h - Thruster Manager
auv_control/auv_control/include/auv_control/thruster_manager_ros.h - Thruster Allocator
auv_control/auv_control/include/auv_control/thruster_allocation.h
Sensing & Mapping
- Camera Nodes
auv_hardware/auv_cam/src - Vision & Detection
auv_vision/auv_vision/scripts - Localization
auv_navigation/auv_localization/scripts - Mapping & Objects
auv_navigation/auv_mapping
Hardware & Teleop
- Serial Bridge
auv_hardware/auv_hardware_bridge/src/serial_to_ros_bridge.cpp - Teleoperation GUI
auv_teleop/scripts/taluy_gui.py
Simulation
- Simulation Mock
auv_sim/auv_sim_bridge/include/auv_sim_bridge/simulation_mock_ros.h - Sim Thrusters
auv_sim/auv_sim_bridge/include/auv_sim_bridge/sim_thruster_ros.h
Other components
- Operator
Connections 19
- Operator → Mission State Machine: starts missions
- Mission State Machine → Task States: dispatches tasks
- Task States → Mission Behaviors: uses behaviors
auv_smach/src/auv_smach/pipeline.py - Mission Behaviors → Path Planners: plans paths
auv_smach/src/auv_smach/common.py - Mission Behaviors → Follow Path Client: sends goals
auv_smach/src/auv_smach/common.py - Path Planners → Path Helpers: generates waypoints
auv_navigation/auv_navigation/src/auv_navigation/path_planning/path_planners.py - Path Planners → Follow Path Server: provides paths
- Follow Path Client → Follow Path Server: sends action goals
- Follow Path Server → ROS Controller: requests control
- ROS Controller → 6-DOF PID: calls controller
auv_control/auv_control/include/auv_control/controller_ros.h - 6-DOF PID → Vehicle Model: uses model
- ROS Controller → Thruster Manager: publishes wrench
- Thruster Manager → Thruster Allocator: allocates thrust
auv_control/auv_control/include/auv_control/thruster_manager_ros.h - Camera Nodes → Vision & Detection: provides images
- Vision & Detection → Mapping & Objects: provides detections
- Localization → Mission Behaviors: provides pose
- Teleoperation GUI → ROS Controller: sends commands
- Serial Bridge → Thruster Manager: bridges device I/O
- Simulation Mock → Sim Thrusters: publishes thruster inputs
auv_sim/auv_sim_bridge/include/auv_sim_bridge/simulation_mock_ros.h