Generic tide plugin for Hydromagic

The generic tide plugin can be used to decode serial data from a tide receiver of tide logger without a dedicated plugin. In this generic plugin, you can define the data format which is expected to be received from the tide receiver. By defining a header, a tide value offset, a tide value length and an optional scale, you should be able to decode tide data from almost any tide receiver(as long as the output is in ASCII or NMEA0183).

Loading the generic tide 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.

Select the "Devices" tab in the "Preferences" dialog.

A list of available plugins will be displayed. In this list, select the "Hydromagic Generic Tide Plugin" item and click "OK" to load and display the configuration dialog.

Select the "Hydromagic Generic Tide Plugin" item from the list and click "OK".

Configuring the generic tide plugin

Serial or Ethernet Communications

First you must configure the serial or Ethernet communication with the tide. 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.

Configuring the data format

In this example we will show an example on how to configure a custom data format. although a dedicated plugin exists for the DESO25 data format, we will use it as an example here:

 $PRVAT,00.115,M,0010.100,dBar*39
 $PRVAT,00.116,M,0010.000,dBar*3d

Tide Value

Now we need to tell the software where the actual depth is. Please note that this only will work when the depth is sent as an ASCII (readable) value. Also note that the characters are zero indexed, which means that the first character is at index zero (D = 0, A = 1 etc..).

The depth value starts at index '3' and is '5' characters long. This is the same for both frequencies, so we enter 3 as start offset and 5 for length. For size, always count the number of digits including the dot (.).

Scale / Units

Use a scale only when the depth is not in meters. For instance, when the depth is in centimeters, please use 0.01, when the depth is in feet, used .3048 to convert to meters.

Use the configuration dialog to set the communication settings.

Testing the plugin configuration

When data is received, you should be able to see the incoming yaw, pitch, and roll data information in the data window. If no data is displayed, you can check whether data is coming in by using the "Communications Monitor". The "Communications Monitor" can also be used to determine which data format is used by the motion sensor.

Open the preferences window by selecting "Preferences..." from the "Options" menu. In the window that appears, select the "Devices" tab. Next select the "Hydromagic Generic Motion Sensor" and click the "Monitor..." button. The communication monitor appears, and should display incoming ASCII or NMEA0183 sentences. When the monitor does not display any incoming data, the serial port or serial speed settings 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 generic tide plugin settings using the device monitor.

Unloading the generic tide plugin

To unload the generic tide plugin, open the preferences window by selecting "Preferences..." from the "Options" menu. In the window that appears, select the "Devices" tab. Next select the "Hydromagic Generic Tide Plugin" and click the "Remove..." button.

Plugins can be unloaded using the "Remove" button.