[ Print this page ]

Real Time Export from Greensea Workspace

Real Time Export requires an application that can receive NMEA sentences in real time via a computer port, and the use of gss_gss2nmea.

Real Time Export Example

If your application can import NMEA sentences in real time to a computer port, you will need to know how to configure it. The application's documentation should provide the information you need. For example, if your application can import an NMEA GGA sentence (LAT/LON coordinate data) using UDP address 192.168.1.102, port 29470, and you want the export rate set to 10 Hz, you would execute the following command in a terminal window before starting Greensea Workspace (this command should be entered on one line):

gss_gss2nmea transport=udp subscribe_channel=OPENINS_NAV_SOLUTION serial_message_out=GGA serial_mesage_out=PAUV udp_src_adr=192.168.1.215 udp_dst_adr=192.168.1.102 udp_port=29470 publish_hz-10

Where:

gss_gss2nmea is the helper program
transport=udp tells the program to use the UDP protocol for communication
subscribe channel=OPENINS_NAV_SOLUTION tells the helper program to use (listen to) the OPENINS_NAV_SOLUTION channel
serial_message_out=GGA tells the helper program to send the GGA sentence to the other application
serial_message_out=PAUVA is the helper program to send the PAUV sentence to the other application
usd_src_adr=192.168.1.215 is the UDP address of the source of the data (192.168.1.215 is the default address of the Operator Control console computer)
usd_dst_adr=192.168.1.102 is the UDP address that the application uses for its import
udp_port=29470 is the UDP port that the other application uses for its import
publish_hz=10 sets the frequency of output messages to 10 Hz

You can export more than one serial message - in this case the GGA and PAUV sentences will be exported.

Using a Shell Script to Start the Helper Program

To create a shell script, the above command can be entered into a .sh file as follows (using the "\" to indicate more data for the command follows on the next line, which makes the file easier to read):

#!/bin/bash

gss_gss2nmea \
transport=udp \
subscribe_channel=OPENINS_NAV_SOLUTION \
serial_message_out=GGA \
serial_mesage_out=PAUV \
udp_src_adr=192.168.1.215 \
udp_dst_adr=192.168.1.102 \
udp_port=29470 \
publish_hz=10

A desktop shortcut can be created for this .sh file to make it easier to execute. Information about creating a shortcut can be found online.

Options for gss_gss2nmea

You can add the help=true option to the gss_gss2nmea command to display a complete list of supported channels and export parameters.

gss_gss2nmea help=true

View the gss_gss2nmea help information.

Modifying Greensea's Workspace Configuration for Export

Here is a sample excerpt of the modification required to be added to the process_server_config.yml file.

    - client_name: videoray
      uuid: USER_CREATED_NAME
      process_name: /home/videoray/USER_CREATED_SHELL_SCRIPT_NAME.sh
      arguments:
        - ~
      process_cmd: keep_alive
      publish_console: 0
      keep_alive_ms: 1000

USER_CREATED_NAME and USER_CREATED_SHELL_SCRIPT_NAME should be replaced with the names based on your preference and the filename of your shell script.

For assistance modifying the Greensea Workspace configuration or managing processes, please contact VideoRay Support at support@videoray.com.