ROV Autonomous Inspection System — ROS2 workspace
Go to file
Grant 2a3e5777af feat(failsafe): mode-dependent recovery per DIR-7 addendum (gate commits, advisory holds)
Implements the DIR-7 addendum "In-mission recovery is mode-dependent" (11 Jul
2026, docs/design_intent_register.md). failsafe_monitor now subscribes to
/rov/mode/profile (latched) for health_role and branches condition-clear
recovery behaviour on it, replacing the mode-blind unconditional-NORMAL
recovery added in 1b0050d:

- gate (AUV): HOLD_AND_RECOVER commits to RETURN_TO_SAFE on condition-clear
  instead of returning to NORMAL; an in-progress RETURN_TO_SAFE is left
  alone (recovery runs to completion). Mission resumption stays a separate
  deliberate action (DIR-10) — not touched here.
- advisory (ROV): stays in its current recovery state on condition-clear;
  only an explicit operator resume (new placeholder topic
  /rov/failsafe/operator_resume, pending the real rov_api endpoint) returns
  it to NORMAL.

health_role defaults to gate (not advisory) until the first ModeProfile
message arrives, per DIR-7's absence-of-data-is-not-health guidance applied
to mode assumption. Cause text ("Recovering to safe zone" /
"Holding — awaiting operator decision") flows through the existing
message-prefix mechanism, so cockpit_bridge and W1 need no changes.

FailsafeStatus.msg, mission_executor, and mission-resume logic are
out of scope and untouched.
2026-07-12 13:33:18 +02:00
deploy Add deploy/ folder — systemd units and launch wrappers 2026-07-05 15:50:42 +00:00
docs docs: restructure into docs/, CLAUDE.md rules-only, DIR v1.2, handover v2.24 2026-07-11 18:46:58 +02:00
src feat(failsafe): mode-dependent recovery per DIR-7 addendum (gate commits, advisory holds) 2026-07-12 13:33:18 +02:00
tools Task 11: rewrite publisher as WebSocket server for Cockpit v1.18.0 2026-05-13 05:24:55 +02:00
widgets fix(w1): move cause text to footer, keep message line state-driven to stop flicker 2026-07-11 17:31:31 +02:00
.gitattributes Add .gitattributes for consistent line endings 2026-05-03 22:22:51 +00:00
.gitignore Initial workspace — six-package autonomy stack 2026-05-03 09:26:04 +00:00
CLAUDE.md docs: restructure into docs/, CLAUDE.md rules-only, DIR v1.2, handover v2.24 2026-07-11 18:46:58 +02:00
docker-entrypoint.sh Initial workspace — six-package autonomy stack 2026-05-03 09:26:04 +00:00
Dockerfile Initial workspace — six-package autonomy stack 2026-05-03 09:26:04 +00:00
README.md Initial workspace — six-package autonomy stack 2026-05-03 09:26:04 +00:00

ROV Autonomy Stack

ROS2 Jazzy workspace for the BlueROV2 Heavy autonomous inspection system.

Package Structure

Package Purpose
rov_interfaces Custom messages and services
rov_navigation State estimation, EKF, depth
rov_perception Camera nodes, feature detection
rov_control Motion controller, failsafe monitor
rov_mission Mission executor, waypoint sequencing
rov_bringup Top-level launch files

Quick Start (on RPi5)

# Pull image from Harbor
docker pull registry.symbytech.com/rov-autonomy/rov-stack:latest

# Run full stack (dev environment)
docker run --rm --network host \
  registry.symbytech.com/rov-autonomy/rov-stack:latest \
  ros2 launch rov_bringup rov_full.launch.py env:=dev blueos_ip:=<RPi4_IP>

Building Locally (on server with buildx)

docker buildx build --platform linux/arm64 \
  -t registry.symbytech.com/rov-autonomy/rov-stack:dev \
  --push .

Topic Reference

Topic Type Publisher Subscribers
/imu/data sensor_msgs/Imu Xsens driver state_estimator
/mavros/imu/data sensor_msgs/Imu MAVROS state_estimator
/rov/state nav_msgs/Odometry state_estimator motion_controller, mission_executor
/rov/cmd_vel geometry_msgs/Twist mission_executor motion_controller
/rov/failsafe rov_interfaces/FailsafeStatus failsafe_monitor motion_controller, mission_executor
/rov/mission/status rov_interfaces/MissionStatus mission_executor web UI
/camera/front/image_raw sensor_msgs/Image camera_node feature_detector