📖
Cerulean Sonar Docs
Docs DirectoryStore
Ethernet ROV Locator
Ethernet ROV Locator
  • ROV Locator
  • Overview
  • General Specifications
  • Quick Start for BlueROV
  • Fundamentals Useful to System Designers
    • Sound Reflection and Absorption
    • Multipath
    • Ping Length
    • What to Do About Multipath and Other Issues
    • Clock Drift Expectations
    • Accuracy Expectations
      • Accuracy Test: Topside GPS
      • Accuracy Test: 110 Meter Slant Range
      • Accuracy Test: 295 Meter Slant Range
    • Operation in a Pool
  • Configuring the ROVLe
    • Finding the Configuration Web Page
    • Example Configuration Web Page
    • Live Status Page
    • Setting Device Type
    • Setting the Static IP Address
    • Setting the Fallback IP Address
    • Setting the MAVLink REST Server Parameters
    • Setting the Secondary (GNSS) MAVLink Interface
    • GPS/GNSS Forwarding (Re-tweeting)
    • Magnetic Declination
    • CIMU Calibration Offsets
    • Speed of Sound
    • GNSS Antenna Mounting Rotation
    • Output Messages
    • Configure Simulation
  • System Variants
  • Autosync
    • Autosync Mission Scenarios and Mission Suitability
    • Autosync Availability
    • Autosync GPS/GNSS Output
    • ROVL Channels (Autosync only; Operating Multiple Units in Proximity)
  • Communicating With the ROVL
    • Serial Parameters
    • The Ethernet Interface
      • Tips on How to Find the IP Address Assigned to Your Ethernet Adapter
      • Blue Robotics Discovery Protocol (Ethernet Only)
    • Packet Format
    • Messages from ROVL to Host
      • $USRTH Receiver-Transmitter Relative Angles Message
      • $USTLC Target Location Message
      • $USINF/$USTXT Information Message
      • $USERR Error Message
      • $USNVM Non-Volatile Memory Message
    • Messages from Host to ROVL
      • NMEA-Format Messages to Receiver
      • Valid Commands from Host to ROVL, Serial and Ethernet
      • Valid Commands from Host to ROVL, Ethernet Only
        • Command: DHCP
        • Command: FALLBACK-ADDRESS
        • Command: IP-ADDRESS
        • Command: HOST-ADDRESS
        • Command: MAVLINK-ADDRESS
        • Command: MAVLINK-AUTO-ORIGIN
        • Command: MAVLINK-SYSID
        • Command: PAUSE
        • Command: RESUME
        • Command: RETWEET-GPS
        • Command: RETWEET-GPS-ADDRESS
        • Command: RETWEET-message
        • Command: SEND-ROV-POS-TO-MAP
        • Command: SEND-TOPSIDE-TO-MAP
        • Command: SEND-USRTH
        • Command: SEND-USTLC
        • Command: UNICAST-TO-ME
  • Cerulean Inertial Measurement Unit (CIMU)
    • CIMU Calibration Background
      • CIMU Magnetometer Calibration
      • CIMU Accelerometer Calibration
      • CIMU Gyro Calibration
  • Operating and Accuracy Considerations
  • Multi-Unit Operation (Swarms)
    • Multi-Unit 1:1
    • Multi-Unit 1:2
    • Multi-Unit 2x1:1
  • ROVL Mounting
    • ROV/Deepside Mounting
    • Topside Mounting
    • Simple Topside Deployment Fixture
  • ROVL Wiring
    • Standard Cabling Options
    • ROVL-e PC Board Internal Connections
      • JST-GH Connector Pin 1 Identification
      • Ethernet/Power Connections
      • Serial Connection
      • USB Connection
      • GNSS Compass Main (4-pin) RS-232 Connection
      • GNSS Compass RTK (2-pin) RS-422 Connection
    • Electrical Noise
  • Connecting and Powering Your ROVLe Ethernet Receiver or Transceiver
    • Example Power Injectors
    • Data Connection
    • Example Power/Wi-Fi Setup for Remote Usage
    • Battery
  • Mounting Dimensions
    • Mk II Receiver with Omnitrack Top
    • Transmitter/Transceiver/Receiver with Standard Top
    • Mk III Transcceiver
    • ROVLe Omnitrack Top
    • ROVLe Standard Top
    • Example Mounting Scheme with 3D-Printed Bracket
  • ROVL Coordinate Systems and Angles
    • Definitions
    • NED or "Compass" vs. ENU or "Math" Angles
    • Math to Compass Frame Conversions
    • Transducer Down Orientation
    • Transducer Up Orientation
    • Receiver/Transceiver Orientation Frames
    • Best Operating Envelope
  • Appendix: Math for Computing Remote Latitude/Longitude
    • Receiver & GPS at Topside and Transmitter Deepside
    • Transmitter & GPS Topside and Receiver Deepside
  • Appendix: Factory Usage Command Set
  • Troubleshooting
    • How to Tell if Your Mk II Receiver is Working
    • How to tell if your Mk II Transmitter is working
    • What to do when you find an unresolvable problem when troubleshooting
  • Copyright
Powered by GitBook
On this page
  1. Communicating With the ROVL

Packet Format

The units send data using an ASCII packet mostly compatible with NMEA-0183 sentence format [some messages exceed the 80-character NMEA limit and may no be forwarded by intervening software]. All transmitter/transponder messages can be ignored (you don’t need to bother to connect the serial wires to the transmitter/transponder unless you are updating firmware). The ROVLe's NMEA sentence talker device type is "US". The message format is:

$USxxx, … *hh

Where:

‘xxx’ is message type ID

… is/are variable comma-separated data fields per the sentence definition

*hh is an asterisk followed by a NMEA-compatible hex checksum

All packets end in ASCII return/linefeed (0x0D, 0x0A)

Fields within a message may be “empty” as noted in the sentence definition, and “empty” means there is a comma for the field but no characters in the field. For example, the message below has an empty field between the fields containing “FIELD1” and the field containing “FIELD3”.

$USTXT,FIELD1,,FIELD3*2A

Possible messages are:

$USRTH – receiver-transmitter relative angles and range

$USINF – informational message

$USTXT — information message interchangeble with #USINF

$USERR – error message

$USDEB – developer debug message

$Gxyyy – GPS or GNSS retweeted messages, where 'x' is either 'P" or 'N'.

Beta releases may send other data formats for developer use. Some oddball messages may be provided for specific customer usage. Any message not beginning with ‘$’ may be safely ignored.

PreviousBlue Robotics Discovery Protocol (Ethernet Only)NextMessages from ROVL to Host

Last updated 1 month ago