ROV Autonomous Inspection System — ROS2 workspace
Go to file
Grant 406bad8fbe docs: record corrected in-mission recovery intent, top-priority FSM rework, paused W1 button, build fix
v2.26, same-day continuation of v2.25:

- Records the DIR-7 in-mission-recovery intent correction just made in
  docs/design_intent_register.md v1.4 (255096f): the condition-clear-commits-
  to-recovery entry trigger built earlier today (2a3e577) is KNOWN-WRONG —
  it produced a contradictory live state (W1 GREEN while the vehicle sat in
  RETURN_TO_SAFE). Corrected model (pointer to the DIR, not duplicated):
  GREEN is unconditionally a working state; committed recovery is triggered
  by fault persistence/recurrence, never by condition-clear.

- Marks the FSM entry-trigger rework as the new top-priority NEXT item,
  ahead of everything previously listed. Confirmed Working, Open Items, and
  PARKED sections rewritten so nothing claims mode-aware recovery works
  correctly end to end — the mode-awareness mechanism (2a3e577) and the
  safe-zone-reached arrival exit (bf815cc) are both confirmed correct and
  unaffected; only entry into committed recovery was wrong.

- Records the W1 safe-zone-reached button as PAUSED, not abandoned: the
  rov_api endpoint and external/rov-failsafe-state variable are built and
  committed (2def2b1), the pre-edit W1 widget backup exists, but the widget
  edit itself was not started since the FSM state it would surface is
  currently known-wrong.

- Records a recurring rov_mission build failure, root-caused and fixed:
  stray nested build/install/log directories inside src/rov-autonomy
  (from colcon being run from the wrong directory) collided with the real
  workspace at /data/ros2_ws. Local filesystem cleanup only, no git change.
  Durable guard recorded: colcon build only ever from /data/ros2_ws.

New §15g narrative section; Recent Commits, Version History, and Changelog
all updated. Documentation only — no code, widget, or DIR file touched in
this commit. Not uploaded to Claude project knowledge; that remains a
manual step.
2026-07-13 18:13:14 +02:00
deploy Add deploy/ folder — systemd units and launch wrappers 2026-07-05 15:50:42 +00:00
docs docs: record corrected in-mission recovery intent, top-priority FSM rework, paused W1 button, build fix 2026-07-13 18:13:14 +02:00
src feat(nav-arrival): rov_api safe_zone_reached endpoint + cockpit_bridge failsafe_state variable 2026-07-13 17:12:58 +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