My Requests

Drivers Manual

TSS 320 R-P-H - 03


Driver to be used to decode roll-pitch-heave observations from TSS motion reference units.

Two versions of the driver are available: a Serial version and a Network version (UDP). The internal workings of the drivers are the same except for the data reception.

Note that this driver only decodes the so-called TSS1 or TSS3 telegram format, it does not decode the TSS2 telegram format.

Driver Information

Driver TSS R-P-H (320-335-DMS)  Interface Type UDP / Serial Driver Class Type Counted 
UTC Driver (question) No Input / Output Input Executable DrvTSSNewUDP.exe 
Related Systems
Related Pages

Decoding Notes

Accelerations and remote heave data (fields 2 and 3 in both formats) are not decoded by the Qinsy driver.

The status symbols of the TSS message are decoded according to the following table:

Status symbol


QI number in Qinsy


No quality info



Heave bad quality

-1.0 for heave, 0.0 for pitch & roll


Unaided mode: still settling



GPS aided mode: still settling



Heading aided mode: still settling



Full aided mode: still settling



Unaided mode



GPS aided mode



Heading aided mode



Full aided mode


If the QI number (quality indicator) is negative, the data is decoded correctly, but is not used in Qinsy.

To prevent this, driver "03 - TSS DMS R-P-H (Ignore Status)" can be used. This driver turns all quality indicator values into positive numbers so that bad quality data is also used.

Interfacing Notes

QPS recommends to set the update rate of the MRU system to a maximum of 25 Hz for marine applications.

Setting the unit to Continuous Data Stream may cause problems in Qinsy because of the possibility of a buffer overflow.

Drivers IO Notes

Command line parameter "320" or "DMS" indicate TSS unit types, but make no difference.

Command line parameter "OCTANS" indicates a reversed heave value input; the driver will correct for this (!).

Command line parameter "OI" indicates that the timetags are obtained from preceding "OiSTAR" headers, if available. Otherwise the first incoming byte is timetagged.

Command line parameter "NOCS" indicates that all decoded data will be accepted, even when the status indicator flag of the message states that the unit is still settling (i.e. lower case "u", "g", "h" and/or "f")