Contact Info

Crumbtrail

eye4software.com » HydroMagic » Documentation » Manual » Plugins » TSS1 motion sensor plugin


TSS1 motion sensor plugin for Hydromagic

The TSS1 motion sensor plugin can be used to decode serial data from a motion sensor or an IMU supporting the proprietary datagram format created by Teledyne TSS, without needing a dedicated plugin plugin. Teledyne TSS1 is a proprietary datagram format created by Teledyne TSS Navigation Systems for heave, roll and pitch compensation. The number of sensor variables in this datagram format is fixed.

This format consists of five fields containing 27 ASCII characters. Accelerations are supplied in ASCII hexadecimal values and heave, pitch and roll are supplied as ASCII coded decimal values. For the TSS1 protocol to run at a data update frequency of 100Hz the sensor bit rate must be set at a minimum of 38400 bps. To run the sensor at a Bit Rate of 19200 bps, the data update frequency needs to be below 50Hz.

NOTE: Some motion sensors support the so-called "Polling Mode". Make sure that your motion sensor device is in "Continuous Output Mode" when it is used with this plugin. Please refer to the documentation on how to switch between modes if supported.

:04008C  0001F 0044  0216
:020156  0001F 0043  0216
:0402AE  0001F 0042  0215
:030172  0001F 0042  0215
:0100D8  0001F 0041  0214
:020048  0001F 0040  0214
:020067  0001F 0040  0213
:01001A  0001F 0039  0212
:050025  0001F 0038  0212
:030004  0001F 0037  0211
:0400E2  0001F 0036  0210
:040166  0001F 0035  0209
:05002A  0001F 0034  0209
:02003C  0001F 0033  0208
TSS1 data example taken from an IMU sensor.


Loading the TSS1 motion sensor plugin for Hydromagic

To load this plugin, open the preferences window by selecting "Preferences..." from the "Options" menu. In the window that appears, select the "Devices" tab. Next, click the 'Add...' button.

the devices tab in the preferences dialog
The devices tab in the "Preferences" dialog.

A list of available plugins will be displayed. In this list, Select the TSS1 Motion Sensor plugin from the list and click 'OK' to load and display its configuration dialog.

select the TSS1 Motion Sensor plugin from the list of plugins
select the TSS1 Motion Sensor plugin from the list of plugins and click "OK".


Configuring the TSS1 motion sensor plugin

First, configure the serial, Ethernet, or WiFi communication with the motion sensor. This plugin supports incoming data over a serial port, Ethernet or WiFi. For more information on this, please see the General information on using plugins document.

Configure the generic motion sensor plugin
The TSS1 motion sensor plugin configuration window.


Testing the plugin configuration

When data is received, you should be able to see the incoming heave, pitch, and roll data in the data window. If no data is displayed, check for incoming data using the "Communications Monitor". Open the preferences window by selecting "Preferences..." from the "Options" menu. In the window that appears, select the "Devices" tab. Next, select the "TSS1 plugin for Hydromagic" plugin, and click the "Monitor..." button. The communication monitor appears, and should display incoming ASCII sentences. If the monitor does not display any incoming data, the serial port or serial speed setting might be incorrect.

When you encounter problems getting the serial port to receive data, we suggest you look at our YouTube tutorial on troubleshooting serial communications using the puTTY software (free software).

Testing plugin settings using the device monitor
Testing the TSS1 motion sensor plugin using the device monitor.


Unloading the TSS1 motion sensor plugin

To unload the TSS1 motion sensor plugin, open the preferences window by selecting "Preferences..." from the "Options" menu. In the window that appears, select the "Devices" tab. Next select the "TSS1 plugin for Hydromagic" plugin and click the "Remove..." button.

Unload the generic motion sensor plugin
Plugins can be unloaded by using the "Remove" button.