Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Notice that receiving data from, and sending data to, is done via the same serial COMport. (See the Interfacing Notes at the end of this document.)


Driver Information

Viewport Tabs Container
Viewport Tab
titleInfo
DriverCDL MiniPOS3 (Binary) Interface TypeSerial Driver Class TypeTerminated 
UTC Driver (question) YesInput / OutputInput ExecutableDrvQPSTerminatedUI.exe 
Related Systems
Content by Label
showLabelsfalse
spacesdm
showSpacefalse
excerpttrue
excerptTypesimple
cqllabel = "dm-0344" and space = "dm"
labelsdm-0344
Related Pages
Table of Contents
Table of Contents
maxLevel3
stylesquare
typeflat
separatorpipe
Viewport Tab
titleFormat
Include Page
DM-0344 - FormatDM-0344 - Format
Viewport Tab
titlegg
Viewport Tab
titlegg
Viewport Tab
titlegg
Deck of Cards
id0002
Card
labelInfo

Driver Information

DriverCDL MiniPOS3 (Binary) Interface TypeSerial Driver Class TypeTerminated 
UTC Driver (question) YesInput / OutputInput ExecutableDrvQPSTerminatedUI.exe 
Related Systems
Content by Label
showLabelsfalse
spacesdm
showSpacefalse
excerpttrue
excerptTypesimple
cqllabel = "dm-0344" and space = "dm"
labelsdm-0344
Related Pages
Table of Contents
Table of Contents
maxLevel3
stylesquare
typeflat
separatorpipe
Show If
groupqps-staff, confluence-driver_format_access
Card
labelFormat

Include Page
DM-0344 - Format
DM-0344 - Format

Card
labelInterfacing

Interfacing Notes

  • Navigation message
    When the MiniPOS3 unit is also interfaced with an external PPS/GPS input (Aux2/GPS port), then it may be useful to use the time from the incoming message in order to time stamp the data.

    This can be achieved when the following criteria are met:
    • Your template setup has a valid PPS system
    • The so-called 'UTC' driver is selected (See Drivers.io Options below)
    • Control bits 'UTC Latency' and 'Latency Compensation' are set to True (See Online Setup, General Setup below)
  • USBL Position message
    The time inside the outputted message will be the exact time for the computed ROV node position.
    In case option Deskew ROV Node Output is enabled, then it will be the exact moment of output.
  • COMport
    Outputting the USBL Position message to the MiniPOS3 system goes via the same serial COMport as the incoming Navigation message; therefore one should take the following full-duplex wiring diagram into account when using I/O cables and connectors: 

Card
labelDbSetup

Database Setup

In order to decode the position from the system, add a Position Navigation System to the template and select driver "CDL MiniPOS3 (Binary) Position".

On the second wizard page, select for Horizontal Datum 'WGS84', but for Vertical Datum select the Mean Sea Level Model (because the height will be derived from the decoded depth, with a negative sign). However, it is highly recommended to set the Height Status to 'Unreliable' in the on-line Computation Setup, in combination with the use of an ROV Depth observation (see below).

In order to decode the heading from the system, add a Gyro Compass System to the template and select driver "CDL MiniPOS3 (Binary) Heading".
Use the same I/O parameters (COMport, baudrate, etc.).

In order to decode the pitch and roll (there is no heave) from the MiniPOS3, add a Pitch, Roll and Heave Sensor System to the template and select driver "CDL MiniPOS3 (Binary) R-P-H". Use the same I/O parameters.
Notice that the exact pitch and roll conventions (second wizard page) are not known at the time of this writing.

In order to decode a depth observation from the MiniPOS3, add an Underwater Sensor to the template and select driver "CDL MiniPOS3 (Binary) Depth & Altitude". Use the same I/O parameters.
On the second wizard page, add an ROV Depth observation. Select for At Node the correct node on the ROV object. 

You may also decode the altitude (or height above bottom) which comes directly from a valid Doppler input into the MiniPOS3: 
Add an ROV Altitude observation, and select for the At Node the bathy sensor location on the ROV object.
The units on the last wizard page must be Meters. 
Notice that this type of observation is not used by the Computation Setup, but it will be decoded, displayed and stored.

In order to decode velocitiesaccelerations along and rotation rates around the three axes, add an Acceleration Velocity Sensor system to your database and select the driver "CDL MiniPOS3 (Binary) Velo, Acc, Rot". Use the same I/O parameters. 
Add the following observations on the second wizard page: Velocity (Easting Speed, Northing Speed and Vertical Speed), Acceleration (X, Y and Z) and/or Rate-Of-Turn (X, Y and Z). 
On the next wizard page, select for the velocity observation unit: Meters / Second, for the acceleration observations: Meters / Second^2, and for the rate-of-turn select Degrees / Second.

In order to decode status information from the MiniPOS3, add a Miscellaneous System to the template and select driver "CDL MiniPOS3 (Binary) Status". Use the same I/O parameters.
On the second wizard page, add the following seven Generic observations:
Observation representing the System Mode, with Slot ID 'SYSTEMMODE'
Observation representing the Navigation Monitor, with Slot ID 'NAVMONITOR'
Observation representing the Operational Event Flags, with Slot ID'OPSEVENTS'
Observation representing the Input Data Validity Logicals, with Slot ID 'INPUTDATA'
Observation representing the Mode Control Logicals, with Slot ID 'CNTRLMODE'
Observation representing the Control Data, with Slot ID 'CNTRLDATA'
Observation representing the Cycle Counter, with Slot ID 'COUNTER'
All Slot ID's in capitals. 


It is recommended to use a Generic Display on-line  in order to visualize the individual status information. In the Generic Layout Editor you may use the 'MASK' operator e.g. for the Navigation Monitor value, in order to extract the individual 'bit' information. 

Download Generic Display Layout XML from this link as example. 
(Copy the file into the current Project's \Settings\Display folder, and open it using a new Generic Display. Do not forget to select the correct system and observations).

Furthermore, you do not need to define an extra output driver in the template setup. The driver will automatically output the USBL Position messages to the same COMport as the incoming data.
The output update rate can be selected while on-line. The information in the USBL Position message depends on the settings as selected by the user in the Setup menu. See for more information below in the Online Setup.

Card
labelDrivers.io

Drivers IO Notes

  • PPS
    The UTC Time, part of the incoming Navigation message, will be used for time-stamping the data. Only in combination with a valid PPS system. See also paragraph Timing for more information. 
    Notice that this command-line parameter is automatically used when you select the driver with "(UTC)" in the driver's name.
  • NOCS
    This command line parameter (meaning No CheckSum) will let the driver ignore the checksum of the incoming Navigation Message. It is not recommended to use this parameter.
Card
labelOnline

Online

The driver has user-interface, and therefore will always be present in the Windows taskbar. When going on-line for the first time, locate the driver and adjust the Setup parameters:

Driver Layout Menu: Setup


GENERAL SETUP

Vessel:

Select from the available defined objects the vessel from which the ROV will be launched. This should be the vessel that has the USBL Transducer mounted.

Control Data Bits:

Use the [...] button to invoke a dialog for enabling and/or disabling the Control Data Bits.
The individual bits will be constructed as four bytes and outputted in the USBL Position message as the so-called Control Data value. This Control Data value will also be part of the incoming Navigation Message

Notice that the displayed four bytes are in hexadecimal representation.

Salinity:

Enter the salinity in parts per thousand.
This value will be formatted and outputted in the USBL Position message.


ROV USBL POSITIONING

ROV:

Select from the available defined objects the ROV object that is positioned by a USBL system.

ROV Computation:

Select the USBL computation and node for the ROV. This node position will be formatted and outputted as the USBL Position message, but whether it is actually used depends on the Output and Source selection in the Options menu:
Set the USBL Position Source selection to 'From USBL [Every nth Trigger]'

ROV Node:

Select the USBL computation and the node for the ROV. This node position will be formatted and outputted as the USBL Position message.

CEPOS:

Enter manually the Position Quality (CEPOS) for the USBL Position message. Value in meters.


ROV GPS/LBL POSITIONING

ROV:

Select from the available defined objects the ROV object that is positioned by an LBL system

ROV Computation:

Select the LBL computation and node for the ROV. This node position will be formatted and outputted as the USBL Position message, but whether it is actually used depends on the Output and Source selection in the Options menu:
Set the USBL Position Source selection to 'From LBL [Every nth Trigger]'

ROV Node:

Select the LBL computation and node for the ROV. This node position will be formatted and outputted as the USBL Position message.

CEPOS:

Enter manually the Position Quality (CEPOS) for the USBL Position message. Value in meters.


ROV MANUAL POSITIONING

Latitude:

This manual position will be formatted and outputted as the USBL Position message, but whether it is actually used depends on the Output and Source selection in the Options menu:
Set the USBL Position Source selection to 'From Manual [Every second]'.
Enter here the latitude in decimal degrees.

Longitude:

Enter the longitude in decimal degrees.

Depth:

Enter the depth in meters.

CEPOS:

Enter manually the Position Quality (CEPOS) for the USBL Position message. Value in meters.


Driver Layout Menu: Results

ROV:

The last encoded position for the selected ROV which will be outputted as USBL Position message. Displayed are the [Update Time], the Easting and Northing, the Height and the age of the data (between brackets) in seconds. If this age exceeds 5 seconds, then the last encoded values are displayed in the color red.

USBL Trigger:

Information about the last updated USBL Transponder. This row is only visible when the USBL Position message is outputted on USBL Trigger (see Options Menu). Displayed are the [Update Time], the Transponder Slot, the Seconds between the last two updates and the age of data (between brackets). If this age exceeds 5 seconds, then the last encoded values are displayed in red.

CDL Position:

The last decoded position data from the incoming Navigation messages. Displayed are the [Update Time], the Latitude and Longitude, Depth, Altitude and the age of the data (between brackets) in seconds.
If this age exceeds 5 seconds, then the last decoded values are displayed in red.
Notice that the same information can also be monitored using an Observation Physics display.

CDL Attitude:

The last decoded attitude data from the incoming Navigation messages. Displayed are the [Update Time], the Heading, Pitch and Roll and the age of the data (between brackets) in seconds. If this age exceeds 5 seconds, then the last decoded values are displayed in red.
Notice that the same information can also be monitored using an Observation Physics display.

CDL Velocities:

The last decoded velocities and vehicle acceleration data from the incoming Navigation messages. Displayed are the [Update Time], the East, North and Down velocity, the vehicle X, Y and Z acceleration and the age of the data (between brackets) in seconds. If this age exceeds 5 seconds, then the last decoded values are displayed in red.
Notice that the same information can also be monitored using an Observation Physics display.


Driver Layout Menu: Raw I/O

Output:

Last outputted USBL Position message to the serial COMport. The indicator cycles when a complete message has been sent. If the last output took place more than 5 seconds ago, it will be displayed in gray.
Notice that a hexadecimal representation is displayed, purely for reading purposes.

Input:

Last received raw data at the serial COMport. The indicator cycles when a complete Navigation message is received. If no CDL MiniPOS3 data is received for more than 5 seconds, then the last received data is displayed in the color gray.
Notice that a hexadecimal representation is displayed, purely for reading purposes.

Log Raw Data:

Enable this option only for analyzing or debugging purposes
When enabled, all incoming binary data (Navigation message) will be streamed to a log file in your project's LogFiles folder, but only during recording sessions.
Name of these log files will be automatically <System Name> - <Storage Db name>.bin


Driver Layout Menu: Options

Decode MiniPOS3 Position:

Reduce the number of decoded positions from the incoming Navigation message. Useful when the CDL MiniPOS3 is broadcasting at high update rate, e.g. at 100Hz, but you don't want to store all these positions in the database. Notice that this does not affect the decoding of the attitude and velocity data, only the position message.
Max 2Hz is recommended.

USBL Position Output:

USBL Position Message will output the USBL Position message.

[No Output] will disable any output to the serial COMport.

USBL Position Source:

Select the source and the desired output update rate for the outputted USBL Position message.
The position source should come from either the USBL or LBL Computation, or from the Manual entered position, as defined in the Setup menu under ROV Positioning.

Deskew ROV Node Output:

Select Yes in order to skew the time and position of the ROV node to the time of output (USBL Position message), using the current SOG and COG. Notice that the SOG and COG depend on the Controller's Computation Setup, Object COG/SOG - Prediction Parameters Settings.
The depth value is not deskewed.

Dialog Buttons

[Setup ]

Invoke the Setup Menu

[Results ]

Invoke the Results Menu

[Raw ]

Invoke the Raw Menu

[Options ]

Invoke the Options Menu

[Clear ]

The last 500 history messages are displayed in the message view. Use the Clear button to empty the list.

Card
labelRegistry Options

Registry Options

 Information in the Results menu will be displayed in red color when the age of the data exceeds five seconds. 

  • This age limit (default 5 seconds) may be changed by modifying the registry key: 
    'HKEY_CURRENT_USER\Software\QPS\QINSy\8.0\Drivers\DrvQPSTerminatedUI\<YourDriverName>\Settings\ MaxAgeRawInput'. 
    (Changing this age value is purely for display purposes. It has nothing to do with the actual decoding of the data)

Information in the Raw menu will be displayed in gray color when the age of the data exceeds five seconds. 

  • This age limit (default 5 seconds) may be changed by modifying the registry key: 
    'HKEY_CURRENT_USER\Software\QPS\QINSy\8.0\Drivers\DrvQPSTerminatedUI\<YourDriverName>\Settings\ MaxAgeRawOutput'. 
    (Changing this age value is purely for display purposes. It has nothing to do with the actual output of the data)

Change the following registry key (from '00' (default) to '01') if you also want to show the 'Lock Settings' and 'Show Tooltips' option in the Options menu: 

  • 'HKEY_CURRENT_USER\Software\QPS\QINSy\8.0\Drivers\DrvQPSTerminatedUI\<YourDriverName>\Settings\ ShowAllOptions'
    Change the following registry key (from '01' (default) to '00') if you want to hide the four dark gray separator lines in the Setup menu: 
  • 'HKEY_CURRENT_USER\Software\QPS\QINSy\8.0\Drivers\DrvQPSTerminatedUI\<YourDriverName>\Settings\ ShowSetupHeaders'

...