Oculus M3000d Sonar ROS2 Driver

ROS2 (Jazzy) driver for the Blueprint Subsea Oculus M3000d dual-frequency multibeam sonar. This driver should work with any sonar of the M series.

A C++ (without ROS) sonar interface is under development in the cpp branch of this repo.

The purpose of this driver is to retrieve raw sonar data with custom code during sensor deployment, either in a ROS2 perception-control stack, or in a custom C++ architecture for the robotic system. It is not a substitute for the vendor application Oculus ViewPoint V2.

ROS2 communication architecture

Fig. 1: ROS2 communication architecture. The oculus_sonar node instantiates a driver client to establish TCP/UDP communication with the hardware. The sonar_viewer node converts the received echo to a cartesian (fan) image and a polar image, while the sonar_point_cloud node publishes the planar point cloud by thresholding high-intensity echoes. sonar_state_estimation is a prototype that uses the sensor AHRS and pressure sensor to estimate the sensor pose, but it is currently not reliable.

Software “Development”: Updating Existing Drivers

This package is adapted and extended from the M1200d ROS2 driver by ENSTA Bretagne Robotics, and the underlying low-level driver Sonar Interface.

The M1200d software has been updated for the M3000d using the up-to-date Blueprint Subsea proprietary oculus_sdk (kindly shared by the technical support team).

Some useful PDF documents to develop the sonar software, use the sensor and interpret the data are collected in the assets folder of the repository.

Requirements

This ROS2 metapackage (with the low-level sonar driver) was developed, tested, and built using:

  • Ubuntu 24.04 LTS

  • ROS2 Jazzy

  • CMake 3.28.3

A Dockerfile with instructions to build the image and run it from any machine is planned. (The current docker setup has not been tested.)

Repository Structure

This repository contains all the code necessary to build and use the Blueprint Subsea Oculus M3000d sonar driver. It also includes the original proprietary SDK (the one used in the official Blueprint ViewPoint V2) as reference code. Note that the SDK code is not used during the build process.

oculus-m3000d-ros2-cpp-driver/
├── docker/                  # Docker configuration files (work in progress...)
├── assets/                  # Documentation images and files
├── oculus_driver_lib/       # C++ driver library
├── oculus_ros2/             # ROS2 packages
│   ├── oculus_interfaces/   # Messages / services
│   ├── oculus_ros2/         # Main driver package
│   └── Data/                # Optional data directory
├── reference_oculus_sdk/    # Reference SDK code
├── LICENSE
└── README.md