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 0208TSS1 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.
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 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.
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 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.
Plugins can be unloaded by using the "Remove" button.