🦀 Ping Library 🔊

SONARs, or Sound Navigation And Ranging devices, transmit sound waves and measure their reflections to detect surrounding obstacles and objects.

Sonars and other acoustic devices can be crucial for marine robotics (ROVs, AUVs, boats, etc), as they can provide obstacle detection and distance estimates when the visual field is limited. Building robots with these capabilities enables precise navigation, target identification, and a considerably more efficient exploration of underwater environments.

The open source Ping Protocol allows precise control of sonar devices like those from Blue Robotics, enabling easy integration in your custom applications.

This library provides access to all capabilities of ping family devices, with all the benefits of the Rust development ecosystem!

Here is a minimal example:

use bluerobotics_ping::{
    device::{Ping1D, PingDevice},
    error::PingError,
};
use tokio_serial::{SerialPort, SerialPortBuilderExt};

#[tokio::main]
async fn main() -> Result<(), PingError> {
    let port = tokio_serial::new("/dev/ttyUSB0", 115200).open_native_async()?;
    port.clear(tokio_serial::ClearBuffer::All)?;
    let ping1d = Ping1D::new(port);

    println!("{:#?}", ping1d.device_information().await?);
    println!("{:#?}", ping1d.general_info().await?);
    println!("{:#?}", ping1d.distance().await?);
    Ok(())
}

Try ping today!

📖 Documentation:

• Ping Echosounder
  • 📘 Operating Principles and Usage Guide
  • 🔧 BlueROV2 Installation Guide
  • 🔧 BlueBoat Integration Guide
• Ping360 Scanning Imaging Sonar
  • 📘 Understanding and Usage Guide
  • 🔧 BlueROV2 Installation Guide
• 🦀 Getting started with Rust
• 🌊 Getting started with BlueOS
• 📚 Ping library docs.
• 📋 Check the examples folder for a quick start guide

🐳 How to Use This Crate:

To harness the capabilities of a Ping1D or Ping360 type device, instantiate the corresponding object provided by this library.

Ping has the capability to work with any kind of layer that implements asynchronous I/O traits. The current examples are focused on serial and UDP, which are the connection methods with official support from Blue Robotics.

Both device types have their own set of methods, as defined by the Ping Protocol specification.

Check the complete set of methods:

• Ping1D
• Ping360

🐬 To run examples use:

cargo run --example ping_1d -- --serial-port /dev/ttyUSB0

Result

Terminal output:

Parsing user provided values...
Creating your Ping 1D device
Testing set/get device id: 9
Testing set/get device id: 8
Testing set/get device id: 7
Testing set/get device id: 6
Testing set/get device id: 5
Testing set/get device id: 4
Testing set/get device id: 3
Testing set/get device id: 2
Testing set/get device id: 1
Set gain to auto: true
Test set & get with a new speed of sound: 343.0 m/s
Test set & get with default speed of sound: 1500.0 m/s
Protocol version is: 1.0.0
Device id is: 1
Gain setting is: 6
Processor temperature is: 42.63 °C
Voltage at 5V lane is: 5.006 V
The distance to target is: 4538 mm
Waiting for 30 profiles...
Received 30 profiles
Turning-off the continuous messages stream from Ping1D

⭐ Pro tip

For external use via UDP, consider using bridges to share your serial device to the network. Detailed instructions can be found here.

Setting up a host and client

On the host 📡 (Where ping device is connected):

bridges --port /dev/ttyUSB0:3000000 -u 0.0.0.0:8080 --no-udp-disconnection --abr

On the client 💻:

cargo run --example ping_1d -- --udp-address 192.168.0.191 --udp-port 8080

Enjoy exploring with ping-rs! 🌊