How m-logeshwaran/mining_monitor_rover works
DrillPulse is a ROS 2 underground reconnaissance and rescue rover with onboard autonomy, safety supervision, hardware interfaces, adaptive communications, and a ground station. Its principal documented workflow is rover sensing and state estimation into mission/navigation decisions, then safety-gated actuation and telemetry to the station for operator decisions. The repository also contains an earlier autonomous-controller prototype and a ROS diagnostic_updater overlay; those are represented separately. README relationships are documented at system level; unsampled package wiring is not asserted.
Main entry points: autonomous_controller.py Prototype controller · navigation_manager.py Prototype navigation · dashboard_node.py Station dashboard · mobility_controller_node.py Motor bridge
Components 34
Hardware and sensing
- Drive motors
- Recovery jacks
- Encoder firmware
- Motor bridge
rover_ws/src/drillpulse_hardware/drillpulse_hardware/mobility_controller_node.py - Actuator bridge
rover_ws/src/drillpulse_hardware/drillpulse_hardware/actuator_bridge.py - Encoder bridge
rover_ws/src/drillpulse_hardware/drillpulse_hardware/stm32_encoder_bridge.py - IMU driver
rover_ws/src/drillpulse_imu/drillpulse_imu/sparkfun_imu_node.py - Environment monitor
rover_ws/src/drillpulse_environment/drillpulse_environment/environment_monitor_node.py - State estimation
rover_ws/src/drillpulse_odometry/drillpulse_odometry/odometry_manager_node.py
Autonomy and safety
- Mission manager
rover_ws/src/drillpulse_mission/drillpulse_mission/mission_manager_node.py - Frontier exploration
rover_ws/src/drillpulse_mission/drillpulse_mission/frontier_exploration_node.py - Nav2 navigation
rover_ws/src/drillpulse_navigation/launch/navigation.launch.py - Safety monitor
rover_ws/src/drillpulse_safety/drillpulse_safety/safety_monitor_node.py - Rollover recovery
rover_ws/src/drillpulse_recovery/drillpulse_recovery/recovery_controller_node.py
Communications
- Video streaming
rover_ws/src/drillpulse_camera/drillpulse_camera/video_streamer_node.py - LoRa transport
rover_ws/src/drillpulse_transport/drillpulse_transport/lora_transceiver_node.py - Session logging
rover_ws/src/drillpulse_transport/drillpulse_transport/session_logger.py
Ground station
- Station dashboard
station_ws/src/drillpulse_dashboard/drillpulse_dashboard/dashboard_node.py - Browser console
station_ws/src/drillpulse_dashboard/drillpulse_dashboard/web/app.js - Mission reporting
station_ws/src/drillpulse_report/drillpulse_report/report_generator_node.py
Prototype and diagnostics
- Prototype controller
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype navigation
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/navigation_manager.py - Prototype safety
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/safety_manager.py - Ultrasonic sensing
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/ultrasonic_manager.py - Coordinates
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/coordinate_manager.py - Camera stream
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/camera_stream.py - Vision manager
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/vision_manager.py - C++ diagnostics
diagnostic_updater_overlay/opt/ros/jazzy/include/diagnostic_updater/diagnostic_updater.hpp - C++ status wrapper
diagnostic_updater_overlay/opt/ros/jazzy/include/diagnostic_updater/diagnostic_status_wrapper.hpp - Python diagnostics
diagnostic_updater_overlay/opt/ros/jazzy/lib/python3.12/site-packages/diagnostic_updater/_diagnostic_updater.py - Python status wrapper
diagnostic_updater_overlay/opt/ros/jazzy/lib/python3.12/site-packages/diagnostic_updater/_diagnostic_status_wrapper.py - Diagnostic publisher
diagnostic_updater_overlay/opt/ros/jazzy/lib/python3.12/site-packages/diagnostic_updater/_publisher.py
Other components
- Mine hazards
- Rescue team
Connections 32
- Mine hazards → Environment monitor: exposes hazards
- Drive motors → Motor bridge: controlled by
- Recovery jacks → Actuator bridge: controlled by
- Encoder firmware → Encoder bridge: sends encoder data
- IMU driver → State estimation: feeds estimation
- Encoder bridge → State estimation: feeds estimation
- State estimation → Mission manager: informs state
- Mission manager → Frontier exploration: dispatches exploration
- Mission manager → Nav2 navigation: dispatches navigation
- Safety monitor → Motor bridge: locks motion
- Safety monitor → Rollover recovery: triggers recovery
- Motor bridge → Drive motors: drives
- Actuator bridge → Recovery jacks: controls
- LoRa transport → Station dashboard: sends telemetry
- Video streaming → Station dashboard: streams video
- Session logging → Mission reporting: records for audit
- Station dashboard → Browser console: serves console
- Station dashboard → Rescue team: informs decisions
- Prototype controller → Ultrasonic sensing: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype controller → Prototype safety: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype controller → Prototype navigation: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype controller → Camera stream: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype controller → Vision manager: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype controller → Coordinates: initializes
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/autonomous_controller.py - Prototype navigation → Prototype safety: evaluates safety
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/navigation_manager.py - Prototype navigation → Ultrasonic sensing: reads distances
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/navigation_manager.py - Prototype navigation → Motor bridge: sends commands
- Vision manager → Camera stream: uses stream
ros2_proto_ws/src/drillpulse_autonomous/drillpulse_autonomous/drillpulse_autonomous/vision_manager.py - Vision manager → Prototype navigation: informs navigation
- C++ diagnostics → C++ status wrapper: fills status
diagnostic_updater_overlay/opt/ros/jazzy/include/diagnostic_updater/diagnostic_updater.hpp - Python diagnostics → Python status wrapper: fills status
diagnostic_updater_overlay/opt/ros/jazzy/lib/python3.12/site-packages/diagnostic_updater/_diagnostic_updater.py - Python diagnostics → Diagnostic publisher: publishes diagnostics