$USTLC Target Location Message

The USTLC message provides the basic information needed to find the ROV in geographic coordinates. It is the message typically sent by Omniscan ROVLs with connected GNSS compasses.

Note: From time to time, Cerulean adds features to the ROVL as requested by users, some of which require changes to this message. Cerulean undertakes to maintain backward compatibly on this message, so once a field is defined and published, we try not to not move it or change its behavior. We may add new fields to the end of the message, so we recommend you allow for extra fields that you can ignore if writing a parser for this message, rather than requiring a specific field count.

Example:

$USTLC,1.0,MkIII,A,T,44.98628360,-93.57620830,45.0,0.923816,-0.001850,-0.004582,0.382806,100.0,0.0,0.0,44.98691899,-93.57531047,76,148,*2B

Format: $USTLC,mv,di,ch,cc,lt,ln,hd,qw,qx,qy,qz,sr,rb,re,ta,to,gn,sn,*hh

mv: version number of message format

di: device identifier {MkII, MkIII}

ch: channel {A, B}

cc: GNSS Compass connected {T, F}

lt: latitude where GNSS Compass is (blank if no position lock or no compass connected)

ln: longitude where GNSS Compass is (blank if no position lock or no compass connected)

hd: GNSS Compass heading (NED) (blank if no heading lock or no compass connected)

qw, qx, qy, qz: quaternion of ROVL receiver platform (ENU)

sr: slant range to ROV (blank if no ping detected)

rb: relative bearing to ROV (ENU) (blank if no ping detected)

re: relative elevation to ROV (ENU) (blank if no ping detected)

ta: latitude of ROV (blank if can't be computed)

to: longitude of ROV (blank if can't be computed)

gn: analog AGC gain, in decibels (range 16 – 82)

sn: Seconds since last autosync or distance sync command (valid Mk II only)