BKG Ntrip Client (BNC)

The BKG Ntrip Client (BNC) is a program for simultaneously retrieving real-time GNSS data streams from NTRIP broadcasters like http://www.euref-ip.net/home or http://www.igs-ip.net/home.

BNC has been developed for the Federal Agency for Cartography and Geodesy (BKG) within the framework of the EUREF-IP Pilot Project (EUREF-IP) and the Real-Time IGS Working Group (RTIGS).

BNC is written under GNU General Public License (GPL). Binaries for BNC are available for Windows, Linux, and Solaris systems. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4 are available.

Contents

A - Purpose
B - Options
C - Limitations
D - Authors
E - Links
F - Annex


A - Purpose

The purpose of BNC is to

BNC decodes and converts GNSS data streams carrying phase data coming in

B - Options

B - 1. File
B - 2. Help
B - 3. Proxy
B - 4. Synchronized Output
      B - 4.1. Wait for Full Epoch
      B - 4.2. ASCII Output File
      B - 4.3. Port for Binary Output
B - 5. RINEX
      B - 5.1. RINEX Directory Path
      B - 5.2. RINEX Script
      B - 5.3. RINEX File Interval
      B - 5.4. RINEX Sampling
      B - 5.5. RINEX Skeleton Extension
B - 6. Mountpoints
      B - 6.1. Add Mountpoints
      B - 6.2. Broadcaster Host and Port
      B - 6.3. Broadcaster User and Password
      B - 6.4. Get Table
      B - 6.5. Delete Mountpoints
      B - 6.6. Edit Mountpoints
B - 7. Log File
B - 8. Start
B - 9. Stop
B - 10. No Window

B - 1. File

The 'File' button lets you

B - 2. Help

The 'Help' button provides access to

B - 3. Proxy - mandatory if BNC is operated in a protected LAN

You may like to run BNC in a Local Area Network (LAN). LAN's are often protected by a proxy server. Enter your proxy server IP and port number in case one is operated in front of BNC. If you don't know the IP and port of your proxy server, check out the proxy server settings of your Windows browser or ask your network administrator.

Note that IP streaming may be generally denied in a LAN. In such a case you need to request an appropriate modification of the security policy from your network administrator or ask for the installation of a TCP relay to involved NTRIP broadcasters. If that doesn't work out, run BNC on a host that is connected to the Internet through an Internet Service Provider (ISP).

B - 4. Synchronized Output

BNC lets you output synchronized observations epoch by epoch. This output is made available in ASCII format and in a binary format. The output comprises the following observations if available:

StatID, SVPRN, GPSWeek, GPSWeeks, sec, C1, P2, L1, L2, SNR1, SNR2, pCodeIndicator, cumuLossOfCont.

B - 4.1 Wait for Full Epoch - optional

When feeding a real-time GNSS engine waiting for input epoch by epoch, BNC ignores whatever is received later then 'Wait for full epoch' seconds. A value of 2 to 5 seconds may be an appropriate choice for that, depending on the delay you can accept for your real-time GNSS product. Default value for 'Wait for full ecpch' is 1 second.

Note that 'Wait for full epoch' does not influence the RINEX file contents. Observations received later than 'Wait for full epoch' seconds will still be included in the RINEX files.

B - 4.2 ASCII Output File - optional

Enter the full path for a file to save synchronized observations in plain ASCII format. Default value is an empty option field, meaning that no ASCII output file is created.

B - 4.3 Port for Binary Output - optional

BNC makes synchronized observations available in a binary format through an IP port on your local host IP 127.0.0.1. Enter the port number to activate this function. Default is an empty option field, meaning that no binary output is generated.

The binary output is provided as a continuous stream in the order

begEpoch
begObs  
Observation
begObs  
Observation
begObs  
Observation
...
endEpoch
begEpoch
...

where the corresponding structures are defined as

const char begEpoch = 'A';
const char begObs   = 'B';
const char endEpoch = 'C';
struct Observation {
  char     StatID[5+1];    // Station ID
  char     SVPRN;          // Satellite PRN
  short    GPSWeek;        // Week of GPS-Time
  int      GPSWeeks;       // Second of Week (GPS-Time)
  double   sec;            // second 
  double   C1;             // CA or P1-code pseudorange (meters)
  double   P2;             // P2-code pseudorange (meters)
  double   L1;             // L1-carrier phase (meters)
  double   L2;             // L2-carrier phase (meters)
  short    SNR1;           // Signal-to noise ratio (0.1 dB)
  short    SNR2;           // Signal-to noise ratio (0.1 dB)
  int      pCodeIndicator; // 0 ... CA Code, 1 ... P Code
  unsigned cumuLossOfCont; // Loss of lock indicator (0 to 31)
} ;

B - 5. RINEX

Observations are converted to RINEX Version 2.1. RINEX file names are derived by BNC from the first 4 characters of the corresponding mountpoint (4Char Station ID) while truncating the residual part of the mountpoint string. Thus, retrieving data from mountpoints FRANKFURT and WETTZELL leads to RINEX files named FRAN*.* and WETT*.*.

If you retrieve streams that show mountpoints with an identical 4Char Station ID (same first 4 characters), the mountpoint string is split in two sub-strings and both become part of the RINEX file name. Example: When simultaneously retrieving data from mountpoints FRANKFURT and FRANCE, there RINEX file names are defined as FRAN*_KFURT.* and FRAN*_CE.*.

Note that RINEX file names for file intervals less than 1 hour are created following the file name convention for 15 minute RINEX files.

B - 5.1 RINEX Directory Path - optional

Enter a path for saving the RINEX files in a directory. If this directory does not exist, BNC will not create RINEX files. Default value for 'RINEX directory path' is an empty option field, meaning that streams are not converted to RINEX.

B - 5.2 RINEX Script - optional

Whenever a RINEX file is generated, you may like to compress, copy, or upload it immediately. For that you enter the full path of a script or batch file carrying out these operations. The RINEX file path and name will be passed to the script as a command line parameter (%1 on Windows systems, $1 on UNIX/Linux systems).

B - 5.3 RINEX File Interval - mandatory if 'RINEX directory path' set

Select the interval for RINEX file generation. Default for 'RINEX file interval' is 15 minutes.

B - 5.4 RINEX Sampling - mandatory if 'RINEX directory path' set

Select the RINEX sample interval in seconds. Zero '0' stands for converting all incoming epochs to RINEX. Default for 'RINEX sampling' is '0'.

B - 5.5 RINEX Skeleton Extension - optional

BNC lets you introduce RINEX header skeleton files that contain the header records you would like to see instead of a default header. You may like to derive RINEX skeleton files from the information given in sitelogs. A file in the 'RINEX directory path' with the 'RINEX skeleton extension' is understood by BNC as a RINEX header skeleton file for the affected stream.

Example: Mountpoint FRAN0 leads to the generation of RINEX files FRAN*.*. The header part of this files would be overwritten by the content of an existing skeleton file named FRAN.skl if 'RINEX skeleton extension' is set to 'skl' .

Note the following conditions regarding RINEX header skeleton files.

B - 6. Mountpoints

Each stream on an NTRIP broadcaster is defined through a unique source ID called mountpoint. An NTRIP client like BNC can access the data of a desired stream by its mountpoint. Information about mountpoints is available through the sourcetable maintained by the NTRIP broadcaster.

B - 6.1 Add Mountpoints

Button 'Add Mountpoints' opens a window that lets you select data streams from an NTRIP broadcaster by their mountpoints.

B - 6.2 Broadcaster Host and Port - mandatory

Enter the NTRIP broadcaster host IP and port number. http://www.rtcm-ntrip.org/home provides information about known NTRIP broadcaster installations. Note that EUREF and IGS operate NTRIP broadcasters at http://www.euref-ip.net/home and http://www.igs-ip.net/home.

B - 6.3 Broadcaster User and Password - mandatory for protected streams

Streams on NTRIP broadcasters may be password protected. Enter a valid User ID and Password for access to protected NTRIP broadcaster streams. Accounts are usually provided per NTRIP broadcaster through a registration procedure. Register through http://igs.bkg.bund.de/index_ntrip_reg.htm for access to protected streams on www.euref-ip.net and www.igs-ip.net.

B - 6.4 Get Table

Hit button 'Get Table' to download the sourcetable from the NTRIP broadcaster. Pay attention to data fields 'format' and 'format-details'. Have in mind that BNC can only decode and convert streams that come in RTCM 2.x, RTCM 3, or RTIGS format. RTCM 2.x streams must contain message types 18 and 19 while RTCM 3 streams must contain message types 1001 or 1003, better 1003 or 1004, see data field 'format-details' for available message types and their repetition rates in brackets. Select your streams line by line, use +Shift and +Ctrl when necessary. Hit 'OK' to return to the main window.

B - 6.5 Delete Mountpoints

To delete a stream shown under 'Mountpoints' in the main window select it by mouse click and hit 'Delete Mountpoints'. For simultaneous deletion of several streams single them out through using +Shift and +Ctrl.

B - 6.6 Edit Mountpoints

BNC automatically selects one out of several internal decoders for a stream based on its 'format' and 'format-details' as given in the sourcetable. It may happen that you need to overrule the automated decoder selection because of sourcetable setup deficiencies. Therefore BNC allows to edit the decoder part for each stream shown under 'Mountpoints'. Accepted decoder strings allowed to be introduced are 'RTCM_2.x', 'RTCM_3', and 'RTIGS'.

B - 7. Log File - optional

BNC comments its activities in the 'Log file' section on the main windows. Comments can be saved and concatenated in a file when entering a full path for 'Log file'. Information is given about the communication between BNC and the NTRIP broadcaster as well as about problems that occur concerning communication link, stream availability, stream delay, stream conversion etc. Default value for 'Log file' is an empty option field, meaning that BNC comments are not saved in a file.

B - 8. Start

Hit 'Start' to start retrieving, decoding, and converting GNSS data streams in real-time.

B - 9. Stop

Hit the 'Stop' button to stop BNC.

B - 10. No Window - optional

You can use BNC in batch mode with the command line option -nw. BNC then runs in 'no window' mode, reading options from the configuration file ${HOME}/.config/BKG/BNC_NTRIP_Client (Unix/Linux) or from the registers (Windows).

Note that the self-explaining contents of the configuration file or the Windows registers can easily be edited.


C - Limitations

D - Authors

The BKG Ntrip Client (BNC) Qt Graphic User Interface (GUI) has been developed for the Federal Agency for Cartography and Geodesy (BKG) by Leos Mervart, Czech Technical University Prague, Department of Advanced Geodesy. BNC integrates the following GNU GPL software components:

Note that this is a betta version of BNC provided for test and evaluation. Make sure you installed the latest version available from http://igs.bkg.bund.de/index_ntrip_down.htm. We are still working on the program and would appreciate if you could send your comments, suggestions, or bug reports to:

Georg Weber
Federal Agency for Cartography and Geodesy (BKG)
Frankfurt, Germany
euref-ip@bkg.bund.de


E - Links

NTRIP  http://igs.bkg.bund.de/index_ntrip.htm
EUREF-IP NTRIP broadcaster  http://www.euref-ip.net/home
IGS-IP NTRIP broadcaster  http://www.igs-ip.net/home
NTRIP broadcaster overview  http://www.rtcm-ntrip.org/home
EUREF-IP Pilot Project  http://www.epncb.oma.be/euref_IP
Real-Time IGS Working Group  http://igscb.jpl.nasa.gov/projects/rtwg/index.html

F - Annex

F - 1. NTRIP
      E - 1.1 Sourcetable
F - 2. RTCM
      F - 2.1 RTCM Version 2.x
      F - 2.2 RTCM Version 3
F - 3. RTIGS
      F - 3.1 SOC


F - 1. NTRIP

'Networked Transport of RTCM via Internet Protocol' Version 1.0 (NTRIP) stands for an application-level protocol streaming Global Navigation Satellite System (GNSS) data over the Internet. NTRIP is a generic, stateless protocol based on the Hypertext Transfer Protocol HTTP/1.1. The HTTP objects are enhanced to GNSS data streams.

NTRIP Version 1.0 is an RTCM standard designed for disseminating differential correction data (e.g in the RTCM-104 format) or other kinds of GNSS streaming data to stationary or mobile users over the Internet, allowing simultaneous PC, Laptop, PDA, or receiver connections to a broadcasting host. NTRIP supports wireless Internet access through Mobile IP Networks like GSM, GPRS, EDGE, or UMTS.

NTRIP is implemented in three system software components: NTRIP clients, NTRIP servers and NTRIP broadcasters. The NTRIP broadcaster is the actual HTTP server program whereas NTRIP client and NTRIP server are acting as HTTP clients.

NTRIP is an open none-proprietary protocol. Major characteristics of NTRIP's dissemination technique are:

F - 1.1 Sourcetable

The NTRIP broadcaster maintains a sourcetable containing information on available NTRIP streams, networks of NTRIP streams, and NTRIP broadcasters. The sourcetable is sent to an NTRIP client on request. Sourcetable records are dedicated to one of the following: Data STReams (record type STR), CASters (record type CAS), or NETworks of streams (record type NET).

Sourcetable records of type STR contain the following data fields: 'mountpoint', 'identifier', 'format', 'format-details', 'carrier', 'nav-system', 'network', 'country', 'latitude', 'longitude', 'nmea', 'solution', 'generator', 'compr-encryp', 'authentication', 'fee', 'bitrate', 'misc'.

Sourcetable records of type NET contain the following data fields: 'identifiey', 'operator', 'authentication', 'fee', 'web-net', 'web-str', 'web-reg', 'misc'.

Sourcetable records of type CAS contain the following data fields: 'host', 'port', 'identifier', 'operator', 'nmea', 'country', 'latitude', 'longitude', 'misc'.

F - 2. RTCM

The Radio Technical Commission for Maritime Services (RTCM) is an international non-profit scientific, professional and educational organization. Special Committees provide a forum in which government and non-government members work together to develop technical standards and consensus recommendations in regard to issues of particular concern. RTCM is engaged in the development of international standards for maritime radionavigation and radiocommunication systems. The output documents and reports prepared by RTCM Committees are published as RTCM Recommended Standards. Topics concerning Differential Global Navigation Satellite Systems (DGNSS) and handled by the Special Committee SC 104.

Copies of RTCM Recommended Standards can be ordered through http://www.rtcm.org/orderinfo.php.


F - 2.1 RTCM Version 2.x

Transmitting GNSS carrier phase data can be done through RTCM Version 2.x messages. Messages that may be of interest here are types 1, 2, 3, 6, 9, 16,18/19, 20/21, and 22.

F - 2.2 RTCM Version 3

RTCM Version 3 has been developed as a more efficient alternative to RTCM 2.x. Service providers and vendors have asked for a new standard that would be more efficient, easy to use, and more easily adaptable to new situations. The main complaint was that the Version 2 parity scheme was wasteful of bandwidth. Another complaint was that the parity is not independent from word to word. Still another was that even with so many bits devoted to parity, the actual integrity of the message was not as high as it should be. Plus, 30-bit words are awkward to handle. The new standard, Version 3, is intended to correct these weaknesses.

RTCM Version 3 defines a number of message types. Messages that may be of interest here are:

F - 3. RTIGS

Input from Ken?

F - 3.1 SOC

Input from Ken?