NTRIP Server connection settings

For outgoing connections you can distribute the GNSS data in real-time through the Internet using the Ntrip protocol. The Ntrip Server connection type is used to send the GNSS data to the Ntrip caster, where an Ntrip client can connect to the stream.

Tip - For more information on the basics of the Ntrip concept and its main components (the NtripSources generating data streams, the NtripServer providing the data streams, the NtripCaster making the data streams available using source-tables, and the NtripClients requesting the data streams), see the description of the Trimble NtripCaster. Detailed information on the Ntrip concept is available from igs.bkg.bund.de/ntrip/index.

To configure an outgoing connection as an NTRIP Server connection, select the NTRIP Server connection type. It will allow the use of Ntrip protocol standards for the communication between the computers. The properties of the Connection Settings category adjust themselves for the selected connection type.

Caster name: Specifies the name (IP address or Internet host domain name) of the Ntrip Caster computer. Both address formats are allowed. Defaults to localhost (127.0.0.1), when setting up a new connection. Enter a valid address that allows you to request a source-table.

Port: Specifies the IP port number of the caster host. The default port number is 2101, which is registered by IANA (Internet Assigned Numbers Authority) in the list of well known ports for the usage of GNSS data.

Automatic reconnect: When the program is running on different computers, a shutdown of one of the computers or a breakdown of the network connection (for example, an unplugged network cable) may cause an attempt to automatically re-connect. If set to Yes, the Reconnect delay setting becomes available.

Reconnect delay: Only available if Automatic reconnect is set to Yes. Specifies a time delay, after which the module will attempt a re-connection to the to the Ntrip caster. Note that in the case of an unplugged network cable, the module will now continuously try to access the Ntrip caster in the specified interval until it succeeds. Default: 10 seconds.

Depending on the module for which the NTRIP Server connection will be used, different properties are available for specifying the mountpoint name used to identify the outgoing GNSS data stream at the Ntrip caster.

Dynamic mountpoint: Only available for modules using station information or added below such a module. With the default setting No, the Mountpoint property becomes available. Use it to specify the caster mountpoint. For setting up several modules of the same type in one step, set the Dynamic mountpoint value to Yes and specify a string that will be added to the station code using the Mountpoint suffix property. Trimble 4D Control Server then will dynamically create mountpoints for each module.

Mountpoint: Editing field available for all NTRIP Server connections. (For modules using station information or added below such a module, only available, if the Dynamic mountpoint property is set to No.) Specifies the mountpoint name used to identify the outgoing GNSS data stream at the Ntrip caster. Empty for a new connection: Enter the name of the new mountpoint to be set up.

Mountpoint suffix: Only available, if the Dynamic mountpoint property is set to Yes. Specifies a string which will be the second part of the composed mountpoint (that is, the "suffix"). The first part is derived from the station code of the station used by the module or its parent. An underscore will separate the components of the mountpoint string. The following is an example for a Mountpoint suffix value of a Router set up as "_Network1" and its parent GNSS Receiver module based on a station whose code is AB01. In this case, the automatically generated mountpoint for the Router module results in "AB01_Network1".

NTRIP version: Specifies the version of the Ntrip protocol used to communicate. Ntrip version 1.0 (default) and Ntrip version 2.0 are supported versions. If Ntrip version 2.0 is selected, additional properties become available.

Authentication: Specifies whether user authentication is necessary. The following authentication modes are available for selection:

User: Only available, if Authentication is not set to None. Specifies the user name.

Password: Only available, if Authentication is not set to None. Specifies the password for the user.

Use NTRIP-STR in Http header: Only available, if the NTRIP version property is set to Ntrip version 2.0. If set to Yes (default selection), an additional property becomes available that lets one specify the full NTRIP-STR string for the http header. If set to No, the NTRIP-STR in the http header is automatically filled with the mountpoint name specified using the Mountpoint property.

NTRIP-STR for the http header: Only available, if the NTRIP version property is set to Ntrip version 2.0 and if Use NTRIP-STR in Http header is set to Yes. Specifies the string in the http header of the Ntrip message. Per default, the string starts with "NTRIP-STR:". It is then followed by the mountpoint name specified using the Mountpoint property and more information related to mountpoints.

Tip - One might use the default setting of the NTRIP-STR for the http header property as a template for how to edit the http header of the Ntrip message.

SSL/TLS: The Secure Sockets Layer (SSL) protocol and its successor Transport Layer Security (TLS) are encryption protocols which provide secure communication on the Internet. This settings specifies whether (Yes) or not (No) the connection is only built up, if both sides communicate using either SSL v3.0 or any TLS protocol version. If different or multiple versions of encryption protocols are available at the connecting computers, the latest version that is supported by both, the client and the server, will be used. If set to Yes, additional properties become available that specify whether additionally authentication certificates are needed for the local computer to identify itself at the remote side (Select certificate) or for the remote side to be accepted at the local machine (Remote certificate required). Only available, if the Ntrip version property is not set to Ntrip version 1.0, because this version does not support SSL encryption.

Remote certificate required: Only available, if the SSL/TLS property is set to Yes. Specifies whether or not the remote side has to identify itself using a valid certificate which must be known at the local computer. With the default No selection, the counterpart needs not to identify itself. If you set the property to Yes, the computer hosting this module needs to have a valid client certificate from the counterpart in its Trusted Root Certificates Authorities folder. If such an certificate is not provided or if the counterpart does not identify itself correctly, the connection will not be built up.

Select certificate: Only available, if the SSL/TLS property is set to Yes. Specifies the personal certificate (that is, the certificate that identifies the current user account running the Trimble 4D Control Server system on the local computer). This certificate proves the identity to any counterpart to which you want to connect, if the counterpart has received a copy of your certificate in advance.