Changeset 572 in ntrip for trunk/BNC/bnchelp.html


Ignore:
Timestamp:
Nov 12, 2007, 11:50:59 AM (17 years ago)
Author:
weber
Message:

* empty log message *

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/BNC/bnchelp.html

    r569 r572  
    1 <h3>BKG Ntrip Client (BNC)</h3>
     1<h3>BKG Ntrip Client (BNC) Version 1.5</h3>
    22
    33<p>
    … …  
    88</p>
    99<p>
    10 BNC has been written under GNU General Public License (GPL). Binaries for BNC are available for Windows, 32-bit Linux, 64-bit Linux (compiled using option -m32), Solaris, and MAC systems. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.3.2 are installed.
    11 <table>
    12 <tr></tr>
    13 <tr><td><b>History</b></td></tr>
    14 <tr><td>Dec 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td><td>Binaries of first beta version published.</td></tr>
    15 <tr><td>Jan 2007 &nbsp;</td><td>Version 1.1b &nbsp;</td><td>[Add] Observables C2, S1, and S2<br>[Add] Virtual reference station access<br>[Bug] RTCM2 decoder time tag fixed<br>[Mod] Small letters for public RINEX skeleton files<br>[Add] Online help through Shift+F1</td></tr>
    16 <tr><td>Apr 2007 &nbsp;</td><td>Version 1.2b &nbsp;</td><td>[Bug] Output only through IP port<br>[Bug] Method 'reconnecting' now thread-save<br> [Add] ZERO decoder added<br> [Mod] Download public RINEX skeletons once per day<br> [Mod] Upgrade to Qt Version 4.2.3<br> [Mod] Replace 'system' call for RINEX script by 'QProcess'<br> [Add] HTTP Host directive for skeleton file download<br> [Add] Percent encoding for user IDs and passwords<br> [Bug] Exit execution of calling thread for RTCM3 streams<br> [Bug] Signal-slot mechanism for threads</td></tr>
    17 <tr><td>May 2007 &nbsp;</td><td>Version 1.3 &nbsp;</td><td>Source code published.
    18 <tr><td>Jul 2007 &nbsp;</td><td>Version 1.4 &nbsp;</td><td>[Bug] Skip messages from proxy server<br> [Bug] Call RINEX script through 'nohup'</td></tr>
    19 <tr><td>Nov 2007 &nbsp;</td><td>Version 1.5 &nbsp;</td><td>[Add] Save Ephemeris from RTCM Version 3.x streams<br> [Add] Upgrade to Qt Version 4.3.2<br> [Add] Optional RINEX v3 output<br> [Add] SBAS support</td></tr>
    20 </table>
     10BNC has been written under GNU General Public License (GPL). Binaries for BNC are available for Windows, 32-bit Linux, 64-bit Linux (compiled using option -m32), Solaris, and Mac systems. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.3.2 are installed.
    2111</p>
    2212<h3>Contents</h3>
    2313<p>
    2414<h4>
    25 <a href=#purpose>A - Purpose</a><br>
    26 <a href=#options>B - Options</a><br>
    27 <a href=#limits>C - Limitations</a><br>
    28 <a href=#authors>D - Authors</a><br>
    29 <a href=#links>E - Links</a><br>
    30 <a href=#annex>F - Annex</a><br>
     15<a href=#purpose>1. Purpose</a><br>
     16<a href=#resources>2. Resources</a><br>
     17<a href=#options>3. Options</a><br>
     18<a href=#limits>4. Limitations</a><br>
     19<a href=#authors>5. Authors</a><br>
     20<a href=#history>6. History</a><br>
     21<a href=#links>7. Links</a><br>
     22<a href=#annex>8. Annex</a><br>
    3123</h4>
    3224</p>
    3325
    34 <p><a name="purpose"><h3>A - Purpose</h3></p>
     26<p><a name="purpose"><h3>1. Purpose</h3></p>
    3527
    3628<p> The purpose of BNC is to
    … …  
    5143<li>RTIGS format (only GPS).</li>
    5244</ul>
    53 BNC also handles RTCM Version 3.x message types 1019 and 1029 carrying Broadcast Ephemeris data.
     45BNC also handles RTCM Version 3.x message types 1019 and 1019 carrying Broadcast Ephemeris data.
    5446Furthermore, BNC allows to by-pass its decoding and conversion algorithms, leave whatever is received untouched and save it in files.
    5547</p>
    56 <p><b>Resources</b><br>
    57 BNC needs access to the Internet with a minimum of about 2 to 6 kbits/sec per stream depending on the stream format. You need to make sure that you have always the necessary bandwidth available. BNC has the capacity to retrieve hundreds of GNSS data streams simultaneously. Please be aware that it is a powerful tool that may generate a heavy workload on the NTRIP broadcaster side depending on the number of streams it requests. We suggest to limited the number of streams where possible to avoid unnecessary workload.
     48<p><a name="resources"><h3>2. Resources</h3></p>
     49<p>
     50BNC needs access to the Internet with a minimum of about 2 to 6 kbits/sec per stream depending on the stream format and the number of visible satellites. Make sure that you always have the necessary bandwidth available.
    5851</p>
    5952<p>
    6053Note that running BNC requires that the clock of the hosting computer is synchronized.
    6154</p>
    62 
    63 <p><a name="options"><h3>B - Options</h3></p>
    64 <p>
    65 B - 1. <a href=#file>File</a><br>
    66 B - 2. <a href=#help>Help</a><br>
    67 B - 3. <a href=#proxy>Proxy</a><br>
    68 B - 4. <a href=#output>Synchronized Output</a><br>
    69 &nbsp; &nbsp; &nbsp; B - 4.1. <a href=#wait>Wait for Full Epoch</a><br>
    70 &nbsp; &nbsp; &nbsp; B - 4.2. <a href=#ascii>ASCII Output File</a><br>
    71 &nbsp; &nbsp; &nbsp; B - 4.3. <a href=#binary>Port for Binary Output</a><br>
    72 B - 5. <a href=#rinex>RINEX</a><br>
    73 &nbsp; &nbsp; &nbsp; B - 5.1. <a href=#rnxname>RINEX File Names</a><br>
    74 &nbsp; &nbsp; &nbsp; B - 5.2. <a href=#rnxpath>RINEX Directory</a><br>
    75 &nbsp; &nbsp; &nbsp; B - 5.3. <a href=#rnxversion>RINEX Version</a><br>
    76 &nbsp; &nbsp; &nbsp; B - 5.4. <a href=#rnxscript>RINEX Script</a><br>
    77 &nbsp; &nbsp; &nbsp; B - 5.5. <a href=#rnxinterval>RINEX File Interval</a><br>
    78 &nbsp; &nbsp; &nbsp; B - 5.6. <a href=#rnxsample>RINEX Sampling</a><br>
    79 &nbsp; &nbsp; &nbsp; B - 5.7. <a href=#rnxskeleton>RINEX Skeleton Extension</a><br>
    80 &nbsp; &nbsp; &nbsp; B - 5.8. <a href=#rnxappend>Append Files</a><br>
    81 B - 6. <a href=#mountpoints>Ephemeris</a><br>
    82 &nbsp; &nbsp; &nbsp; B - 6.1. <a href=#ephpath>Ephemeris Directory</a><br>
    83 &nbsp; &nbsp; &nbsp; B - 6.2. <a href=#ephvers>RINEX Version</a><br>
    84 &nbsp; &nbsp; &nbsp; B - 6.3. <a href=#ephinterval>Ephemeris File Interval</a><br>
    85 B - 7. <a href=#mountpoints>Mountpoints</a><br>
    86 &nbsp; &nbsp; &nbsp; B - 7.1. <a href=#AddMounts>Add Mountpoints</a><br>
    87 &nbsp; &nbsp; &nbsp; B - 7.2. <a href=#HostPort>Broadcaster Host and Port</a><br>
    88 &nbsp; &nbsp; &nbsp; B - 7.3. <a href=#account>Broadcaster User and Password</a><br>
    89 &nbsp; &nbsp; &nbsp; B - 7.4. <a href=#GetTable>Get Table</a><br>
    90 &nbsp; &nbsp; &nbsp; B - 7.5. <a href=#delete>Delete Mountpoints</a><br>
    91 &nbsp; &nbsp; &nbsp; B - 7.6. <a href=#edit>Edit Mountpoints</a><br>
    92 B - 8. <a href=#log>Log</a><br>
    93 B - 9. <a href=#start>Start</a><br>
    94 B - 10. <a href=#stop>Stop</a><br>
    95 B - 11. <a href=#nw>No Window</a>
    96 </p>
    97 
    98 <p><a name="file"><h4>B - 1. File</h4></p>
     55<p>
     56BNC has the capacity to retrieve hundreds of GNSS data streams simultaneously. Be aware that it is a powerful tool that may generate a heavy workload on the NTRIP broadcaster side depending on the number of streams it requests. We suggest to limited the number of streams where possible to avoid unnecessary workload.
     57</p>
     58
     59<p><a name="options"><h3>3. Options</h3></p>
     60<p>
     613.1. <a href=#file>File</a><br>
     623.2. <a href=#help>Help</a><br>
     633.3. <a href=#proxy>Proxy</a><br>
     643.4. <a href=#output>Synchronized Output</a><br>
     65&nbsp; &nbsp; &nbsp; 3.4.1. <a href=#wait>Wait for Full Epoch</a><br>
     66&nbsp; &nbsp; &nbsp; 3.4.2. <a href=#ascii>ASCII Output File</a><br>
     67&nbsp; &nbsp; &nbsp; 3.4.3. <a href=#binary>Port for Binary Output</a><br>
     683.5. <a href=#rinex>RINEX</a><br>
     69&nbsp; &nbsp; &nbsp; 3.5.1. <a href=#rnxname>RINEX File Names</a><br>
     70&nbsp; &nbsp; &nbsp; 3.5.2. <a href=#rnxpath>RINEX Directory</a><br>
     71&nbsp; &nbsp; &nbsp; 3.5.3. <a href=#rnxversion>RINEX Version</a><br>
     72&nbsp; &nbsp; &nbsp; 3.5.4. <a href=#rnxscript>RINEX Script</a><br>
     73&nbsp; &nbsp; &nbsp; 3.5.5. <a href=#rnxinterval>RINEX File Interval</a><br>
     74&nbsp; &nbsp; &nbsp; 3.5.6. <a href=#rnxsample>RINEX Sampling</a><br>
     75&nbsp; &nbsp; &nbsp; 3.5.7. <a href=#rnxskeleton>RINEX Skeleton Extension</a><br>
     76&nbsp; &nbsp; &nbsp; 3.5.8. <a href=#rnxappend>Append Files</a><br>
     773.6. <a href=#mountpoints>Ephemeris</a><br>
     78&nbsp; &nbsp; &nbsp; 3.6.1. <a href=#ephpath>Ephemeris Directory</a><br>
     79&nbsp; &nbsp; &nbsp; 3.6.2. <a href=#ephvers>RINEX Version</a><br>
     80&nbsp; &nbsp; &nbsp; 3.6.3. <a href=#ephinterval>Ephemeris File Interval</a><br>
     813.7. <a href=#mountpoints>Mountpoints</a><br>
     82&nbsp; &nbsp; &nbsp; 3.7.1. <a href=#AddMounts>Add Mountpoints</a><br>
     83&nbsp; &nbsp; &nbsp; 3.7.2. <a href=#HostPort>Broadcaster Host and Port</a><br>
     84&nbsp; &nbsp; &nbsp; 3.7.3. <a href=#account>Broadcaster User and Password</a><br>
     85&nbsp; &nbsp; &nbsp; 3.7.4. <a href=#GetTable>Get Table</a><br>
     86&nbsp; &nbsp; &nbsp; 3.7.5. <a href=#delete>Delete Mountpoints</a><br>
     87&nbsp; &nbsp; &nbsp; 3.7.6. <a href=#edit>Edit Mountpoints</a><br>
     883.8. <a href=#log>Log</a><br>
     893.9. <a href=#start>Start</a><br>
     903.10. <a href=#stop>Stop</a><br>
     913.11. <a href=#nw>No Window</a>
     92</p>
     93
     94<p><a name="file"><h4>3.1. File</h4></p>
    9995
    10096<p>
    … …  
    114110</p>
    115111
    116 <p><a name="help"><h4>B - 2. Help</h4></p>
     112<p><a name="help"><h4>3.2. Help</h4></p>
    117113
    118114<p>
    … …  
    130126</p>
    131127<p>
    132 BNC comes with a help system providing online information about its functionality and usage. Simple descriptions are available for any widget. Focus to the relevant widget and press Shift+F1 to request help information. A help text appears immediately; it goes away as soon as the user does something else. Some dialogs may provide a "?" button that users can click; they then click the relevant widget to pop up the help text.
    133 </p>
    134 
    135 <p><a name="proxy"><h4>B - 3. Proxy - mandatory if BNC is operated in a protected LAN</h4></p>
     128BNC comes with a help system providing online information about its functionality and usage. Short descriptions are available for any widget. Focus to the relevant widget and press Shift+F1 to request help information. A help text appears immediately; it goes away as soon as the user does something else. The dialogs on some operating systems may provide a "?" button that users can click; they then click the relevant widget to pop up the help text.
     129</p>
     130
     131<p><a name="proxy"><h4>3.3. Proxy - mandatory if BNC is operated in a protected LAN</h4></p>
    136132
    137133<p>
    138134You may like to run BNC in a Local Area Network (LAN). LANs 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 Internet browser or ask your network administrator.</p>
    139135<p>
    140 Note that IP streaming may generally be denied in a LAN. In such a case you need to ask your network administrator for an appropriate modification of his security policy or for the installation of a TCP relay to involved NTRIP broadcasters. If that doesn't work out, run BNC outside your LAN on a host that is connected to the Internet through an Internet Service Provider (ISP).
    141 </p>
    142 
    143 <p><a name="output"><h4>B - 4. Synchronized Output</h4></p>
    144 <p>
    145 BNC lets you output synchronized observations from all stations and satellites epoch by epoch. This output is made available in a plain ASCII format and/or a binary format. The output comprises the following observations if available:</p>
     136Note that IP streaming may generally be denied in a LAN. In such a case you need to ask your network administrator for an appropriate modification of his security policy or for the installation of a TCP relay to involved NTRIP broadcasters. If that doesn't work out, run BNC outside your LAN on a host that is connected to the Internet through an Internet Service Provider.
     137</p>
     138
     139<p><a name="output"><h4>3.4. Synchronized Output</h4></p>
     140<p>
     141BNC lets you output synchronized observations (no ephemeris) from all stations and satellites epoch by epoch. This output is made available in a plain ASCII format and/or a binary format. The output comprises the following observations if available:</p>
    146142<p>
    147143StatID, SVPRN, GPSWeek, GPSWeeks, C1, C2, P1, P2, L1, L2, S1, S2, SNR1, SNR2
    148144</p>
    149145<p>
    150 Note that SNR stands for the signal-to-noise ratio S mapped to integer numbers 1 to 9. Note further that in case an observation is unavailable, its value is set to zero '0.000'.
    151 </p>
    152 <p><a name="wait"><h4>B - 4.1 Wait for Full Epoch - optional</h4></p>
    153 <p>
    154 When feeding a real-time GNSS engine waiting for input epoch by epoch, BNC ignores whatever is received later than 'Wait for full epoch' seconds. A value of 3 to 5 seconds could be an appropriate choice for that, depending on the latency of the incoming streams and the delay you can accept for your real-time GNSS product. Default value for 'Wait for full epoch' is 1 second.
     146Note that SNR stands for the signal-to-noise ratio 'S' mapped to integer numbers 1 to 9. Note further that in case an observation is unavailable, its value is set to zero '0.000'.
     147</p>
     148<p><a name="wait"><h4>3.4.1 Wait for Full Epoch - optional</h4></p>
     149<p>
     150When feeding a real-time GNSS engine waiting for input epoch by epoch, BNC ignores whatever is received later than 'Wait for full epoch' seconds. A value of 3 to 5 seconds could be an appropriate choice for that, depending on the latency of the incoming streams and the delay you can accept for your real-time GNSS product. Default value for 'Wait for full epoch' is 5 seconds.
    155151</p>
    156152<p>
    … …  
    158154</p>
    159155
    160 <p><a name="ascii"><h4>B - 4.2 ASCII Output File - optional</h4></p>
     156<p><a name="ascii"><h4>3.4.2 ASCII Output File - optional</h4></p>
    161157<p>
    162158Enter the full path for a file to save synchronized observations in a plain ASCII format. Default value is an empty option field, meaning that no ASCII output file is created.
    … …  
    166162</p>
    167163
    168 <p><a name="binary"><h4>B - 4.3 Port for Binary Output - optional</h4></p>
     164<p><a name="binary"><h4>3.4.3 Port for Binary Output - optional</h4></p>
    169165<p>
    170166BNC makes synchronized observations available in a binary format on your local host (IP 127.0.0.1) through an IP port. Enter an IP port number to activate this function. Default is an empty option field, meaning that no binary output is generated.</p>
    … …  
    210206<p>Note that the source code for BNC comes with an example program named 'test_bnc_qt.cpp' that lets you read BNC's binary output from the IP port.</p>
    211207
    212 <p><a name="rinex"><h4>B - 5. RINEX</h4></p>
     208<p><a name="rinex"><h4>3.5. RINEX</h4></p>
    213209<p>
    214210Observations will be converted to RINEX if they come in either RTCM Version 2.x, RTCM Version 3.x, or RTIGS format. BNC's RINEX Observation files generally contain C1, C2, P1, P2, L1, L2, S1, and S2 observations. In case an observation is unavailable, its value is set to zero '0.000'. Note that even if a RINEX Observation file does not contain GLONASS or SBAS data, the 'RINEX TYPE' field in the RINEX Observation file header may be set to 'M (MIXED)'.
    215211</p>
    216 <p><a name="rnxname"><h4>B - 5.1 RINEX File Names</h4></p>
     212<p><a name="rnxname"><h4>3.5.1 RINEX File Names</h4></p>
    217213<p>
    218214RINEX file names are derived by BNC from the first 4 characters of the corresponding mountpoint (4Char Station ID) while omitting the residual part of the mountpoint string. Thus, retrieving data from mountpoints FRANKFURT and WETTZELL leads to hourly RINEX Observation files named</p>
    … …  
    245241</p>
    246242
    247 <p><a name="rnxpath"><h4>B - 5.2 RINEX Directory - optional</h4></p>
     243<p><a name="rnxpath"><h4>3.5.2 RINEX Directory - optional</h4></p>
    248244<p>
    249245Enter a path for saving the RINEX Observation files in a directory. If this directory does not exist, BNC will not create RINEX Observation files. Default value for 'RINEX directory' is an empty option field, meaning that streams are not converted to RINEX.
    250246</p>
    251247
    252 <p><a name="rnxversion"><h4>B - 5.3 RINEX Version - optional</h4></p>
     248<p><a name="rnxversion"><h4>3.5.3 RINEX Version - optional</h4></p>
    253249<p>
    254250Default format for RINEX Observation files is RINEX Version 2.11. Select 'RINEX v3' if you want to save observations in RINEX Version 3 format.
    255251</p>
    256252
    257 <p><a name="rnxscript"><h4>B - 5.4 RINEX Script - optional</h4></p>
     253<p><a name="rnxscript"><h4>3.5.4 RINEX Script - optional</h4></p>
    258254<p>
    259255Whenever a RINEX Observation file is saved, you may like to compress, copy or upload it immediately via FTP. For that you enter the full path of a script or batch file which is then called to carry out these operations. The RINEX Observation file path will be passed to the script as a command line parameter (%1 on Windows systems, $1 on Unix/Linux systems).
    … …  
    266262</p>
    267263
    268 <p><a name="rnxinterval"><h4>B - 5.5 RINEX File Interval - mandatory if 'RINEX directory' set</h4></p>
     264<p><a name="rnxinterval"><h4>3.5.5 RINEX File Interval - mandatory if 'RINEX directory' set</h4></p>
    269265<p>
    270266Select the interval for the RINEX Observation file generation. Default for RINEX 'File interval' is 15 minutes.
    271267</p>
    272268
    273 <p><a name="rnxsample"><h4>B - 5.6 RINEX Sampling - mandatory if 'RINEX directory' set </h4></p>
     269<p><a name="rnxsample"><h4>3.5.6 RINEX Sampling - mandatory if 'RINEX directory' set </h4></p>
    274270<p>
    275271Select the RINEX Observation sample interval in seconds. Zero '0' stands for converting all incoming epochs to RINEX. Default for RINEX 'Sampling' is '0'.
    276272</p>
    277273
    278 <p><a name="rnxskeleton"><h4>B - 5.7 RINEX Skeleton Extension - optional</h4></p>
     274<p><a name="rnxskeleton"><h4>3.5.7 RINEX Skeleton Extension - optional</h4></p>
    279275<p>
    280276Whenever BNC starts generating RINEX Observation files (and then once every day at midnight), it first tries to retrieve information needed for RINEX headers from so-called public RINEX header skeleton files which are derived from sitelogs. An HTTP link to a directory containing these skeleton files may be available through data field number 7 of the affected NET record in the source-table. See <u>http://www.epncb.oma.be:80/stations/log/skl/brus.skl</u> for an example for a public RINEX header skeleton file concerning the EPN station Brussels.
    … …  
    284280</p>
    285281<p>
    286 Examples for file name convention: RINEX files for mountpoints WETTZELL, FRANKFURT and FRANCE (same 4Char Station ID), BRUS0 from <u>www.euref-ip.net</u> and BRUS0 from <u>www.igs-ip.net</u> (same 4Char Station ID, identical mountpoint stings) would accept personal skeleton files named</p>
     282Examples for personal skeleton file name convention: RINEX Observation files for mountpoints WETTZELL, FRANKFURT and FRANCE (same 4Char Station ID), BRUS0 from <u>www.euref-ip.net</u> and BRUS0 from <u>www.igs-ip.net</u> (same 4Char Station ID, identical mountpoint stings) would accept personal skeleton files named</p>
    287283<p>
    288284WETT.skl<br>
    … …  
    322318</ul>
    323319<p>
    324 If neither a public nor a personal RINEX header skeleton file is available for BNC, a default header is generated for the affected RINEX file.
     320If neither a public nor a personal RINEX header skeleton file is available for BNC, a default header is generated for the affected RINEX Observation file.
    325321</p>
    326322
    327323<p>
    328324
    329 <p><a name="rnxappend"><h4>B - 5.8 Append Files</h4></p>
    330 <p>
    331 When starting BNC, new RINEX Observation files are created by default. Probably existing files will be overwritten. However, it may be desirable to append observations (and ephemeris) to already existing RINEX files following a restart of BNC after an intentional 'Stop', a system crash or a crash of BNC. Hit 'Append files' to continue with already existing files and thus save what has been recorded so far. Note that option 'Append files' also concerns RINEX Navigation files, the 'ASCII output file' and the 'Log' file.
    332 </p>
    333 <p><a name="mountpoints"><h4>B - 6. Ephemeris</h4></p>
     325<p><a name="rnxappend"><h4>3.5.8 Append Files</h4></p>
     326<p>
     327When starting BNC, new RINEX Observation files are created by default. Probably existing files will be overwritten. However, it may be desirable to append observations to already existing RINEX Observation files following a restart of BNC after an intentional 'Stop', a system crash or a crash of BNC. Hit 'Append files' to continue with already existing files and thus save what has been recorded so far. Note that option 'Append files' also concerns RINEX Navigation files, the 'ASCII output file' and the 'Log' file.
     328</p>
     329<p><a name="mountpoints"><h4>3.6. Ephemeris</h4></p>
    334330<p>
    335331Broadcast Ephemeris can be saved in RINEX Navigation files if received in RTCM Version 3.x as message types 1019 (GPS) and 1020 (GLONASS). The file name convention follows the details given in section 'RINEX File Names' except that the first four characters are 'GPS_' and 'GLO_' for RINEX Version 2.11 Navigation files and 'MIX_' for RINEX Version 3 Navigation files.
    336332</p>
    337333
    338 <p><a name="ephpath"><h4>B - 6.1 Ephemeris Directory - optional</h4></p>
     334<p><a name="ephpath"><h4>3.6.1 Ephemeris Directory - optional</h4></p>
    339335<p>
    340336Enter a path for saving Broadcast Ephemeris data as RINEX Navigation files in a directory. If this directory does not exist, BNC will not create RINEX Navigation files. Default value for 'Ephemeris directory' is an empty option field, meaning that no RINEX Navigation files are created.
    341337</p>
    342338
    343 <p><a name="ephvers"><h4>B - 6.2 RINEX Version - optional</h4></p>
     339<p><a name="ephvers"><h4>3.6.2 RINEX Version - optional</h4></p>
    344340<p>
    345341Default format for RINEX Navigation files containing Broadcast Ephemeris is RINEX Version 2.11. Select 'RINEX v3' if you want to save the ephemeris in RINEX Version 3 format.
    346342</p>
    347343
    348 <p><a name="ephinterval"><h4>B - 6.3 Ephemeris Interval - mandatory if 'Ephemeris directory' set</h4></p>
    349 <p>
    350 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' is an empty option field, meaning that streams are not converted to RINEX.
    351 Default for Ephemeris 'File interval' is 1 day.
    352 </p>
    353 
    354 <p><a name="mountpoints"><h4>B - 7. Mountpoints</h4></p>
     344<p><a name="ephinterval"><h4>3.6.3 Ephemeris Interval - mandatory if 'Ephemeris directory' set</h4></p>
     345<p>
     346Select the interval for the RINEX Navigation file generation. Default for Ephemeris 'File interval' is 1 day.
     347</p>
     348
     349<p><a name="mountpoints"><h4>3.7. Mountpoints</h4></p>
    355350<p>
    356351Each 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 source-table maintained by the NTRIP broadcaster. Note that mountpoints could show up in BNC more than once when retrieving streams from several NTRIP broadcasters.
    … …  
    369364</table>
    370365
    371 <p><a name="AddMounts"><h4>B - 7.1 Add Mountpoints</h4></p>
     366<p><a name="AddMounts"><h4>3.7.1 Add Mountpoints</h4></p>
    372367<p>
    373368Button 'Add Mountpoints' opens a window that allows you to select data streams from an NTRIP broadcaster by their mountpoints.
    374369</p>
    375370
    376 <p><a name="HostPort"><h4>B - 7.2 Broadcaster Host and Port - mandatory</h4></p>
     371<p><a name="HostPort"><h4>3.7.2 Broadcaster Host and Port - mandatory</h4></p>
    377372<p>
    378373Enter the NTRIP broadcaster host IP and port number. <u>http://www.rtcm-ntrip.org/home</u> provides information about known NTRIP broadcaster installations. Note that EUREF and IGS operate NTRIP broadcasters at <u>http://www.euref-ip.net/home</u> and <u>http://www.igs-ip.net/home</u>.
    379374</p>
    380375
    381 <p><a name="account"><h4>B - 7.3 Broadcaster User and Password - mandatory for protected streams</h4></p>
     376<p><a name="account"><h4>3.7.3 Broadcaster User and Password - mandatory for protected streams</h4></p>
    382377<p>
    383378Streams on NTRIP broadcasters may be protected by password. 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 <u>http://igs.bkg.bund.de/index_ntrip_reg.htm</u> for access to protected streams on <u>www.euref-ip.net</u> and <u>www.igs-ip.net</u>.
    384379</p>
    385380
    386 <p><a name="GetTable"><h4>B - 7.4 Get Table</h4></p>
    387 <p>
    388 Hit button 'Get Table' to download the source-table from the NTRIP broadcaster. Pay attention to data fields 'format' and 'format-details'. Keep 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 GPS or SBAS message types 1002 or 1004 and may contain GLONASS message types 1010 or 1012, see data field 'format-details' for available message types and their repetition rates in brackets. Note that RINEX Navigation files containing Broadcast Ephemeris need RTCM 3 streams containing message types 1019 (GPS) and 1020 (GLONASS). Select your streams line by line, use +Shift and +Ctrl when necessary.
     381<p><a name="GetTable"><h4>3.7.4 Get Table</h4></p>
     382<p>
     383Hit button 'Get Table' to download the source-table from the NTRIP broadcaster. Pay attention to data fields 'format' and 'format-details'. Keep in mind that BNC can only decode and convert streams that come in RTCM Version 2.x, RTCM Version 3.x, or RTIGS format. RTCM Version 2.x streams must contain message types 18 and 19 while RTCM Version 3.x streams must contain GPS or SBAS message types 1002 or 1004 and may contain GLONASS message types 1010 or 1012, see data field 'format-details' for available message types and their repetition rates in brackets. Note that RINEX Navigation files containing Broadcast Ephemeris need RTCM Version 3.x streams containing message types 1019 (GPS) and 1020 (GLONASS). Select your streams line by line, use +Shift and +Ctrl when necessary.
    389384</p>
    390385<p>
    … …  
    395390</p>
    396391
    397 <p><a name="delete"><h4>B - 7.5 Delete Mountpoints</h4></p>
     392<p><a name="delete"><h4>3.7.5 Delete Mountpoints</h4></p>
    398393<p>
    399394To delete a stream shown under 'Mountpoints' in the main window, select it by mouse click and hit 'Delete Mountpoints'. For a simultaneous deletion of several streams highlight them using +Shift and +Ctrl.</p>
    400395
    401 <p><a name="edit"><h4>B - 7.6 Edit Mountpoints</h4></p>
     396<p><a name="edit"><h4>3.7.6 Edit Mountpoints</h4></p>
    402397<ul>
    403398<li>
    … …  
    414409</ul>
    415410
    416 <p><a name="log"><h4>B - 8. Log - optional</h4></p>
    417 <p>
    418 BNC comments its activities in the 'Log' section on the main windows. Comments can be saved in a file when entering a full path for a 'Log' file. Information is given on the communication between BNC and the NTRIP broadcaster as well as on problems that may occur concerning communication link, stream availability, stream delay, stream conversion etc. Default value for 'Log' is an empty option field, meaning that BNC comments are not saved in a file.
    419 </p>
    420 
    421 <p><a name="start"><h4>B - 9. Start</h4></p>
     411<p><a name="log"><h4>3.8. Log - optional</h4></p>
     412<p>
     413BNC comments its activities in the 'Log' section of the main windows. Comments can be saved in a file when entering a full path for a 'Log' file. Information is given on the communication between BNC and the NTRIP broadcaster as well as on problems that may occur concerning communication link, stream availability, stream delay, stream conversion etc. Default value for 'Log' is an empty option field, meaning that BNC comments are not saved in a file.
     414</p>
     415
     416<p><a name="start"><h4>3.9. Start</h4></p>
    422417<p>
    423418Hit 'Start' to start retrieving, decoding, and converting GNSS data streams in real-time. Note that 'Start' generally forces BNC to begin with fresh RINEX files and thus overwrite probably existing files when necessary unless option 'Append files' is set.
    424419</p>
    425420
    426 <p><a name="stop"><h4>B - 10. Stop</h4></p>
     421<p><a name="stop"><h4>3.10. Stop</h4></p>
    427422<p>
    428423Hit the 'Stop' button in order to stop BNC.
    429424</p>
    430425
    431 <p><a name="nw"><h4>B - 11. No Window - optional</h4></p>
    432 <p>
    433 You can use BNC on all systems 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.conf (Unix/Linux) or from the register BNC_NTRIP_Client (Windows).
     426<p><a name="nw"><h4>3.11. No Window - optional</h4></p>
     427<p>
     428You can use BNC on all systems 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.conf (Unix/Linux, see Config File example in the Annex) or from the register BKG_NTRIP_Client (Windows).
    434429</p>
    435430<p>
    436431Note that the self-explaining contents of the configuration file or the Windows register can easily be edited. Terminate BNC using the Windows Task Manager when running it in 'no window' mode on Windows systems.
    437432</p>
    438 <p><a name="limits"><h3>C - Limitations</h3></p>
    439 <ul>
    440 <li>
    441 The connection to an NTRIP broadcaster may possibly break or a stream requested may be temporarily unavailable. Furthermore, a connection is interpreted by BNC to be broken if no data is coming in for a period of 20 seconds. When this happens, a reconnect is being attempted with decreasing frequency. BNC first tries to reconnect with ~1 second delay, if unsuccessful, tries again in ~2 seconds from the last attempt, if still unsuccessful tries with ~4 seconds from the last attempt etc. Each attempt doubles the delay from the previous attempt. The maximum delay between attempts is limited to ~128 seconds. The reconnection process is documented in the 'Log' file/section.
     433<p><a name="limits"><h3>4. Limitations</h3></p>
     434<ul>
     435<li>
     436The connection to an NTRIP broadcaster may possibly break or a stream requested may be temporarily unavailable. Furthermore, a connection is interpreted by BNC to be broken if no data is coming in for a period of 20 seconds. When this happens, a reconnect is being attempted with decreasing frequency. BNC first tries to reconnect with ~1 second delay, if unsuccessful, tries again in ~2 seconds from the last attempt, if still unsuccessful tries with ~4 seconds from the last attempt etc. Each attempt doubles the delay from the previous attempt. The maximum delay between attempts is limited to ~256 seconds. The reconnection process is documented in the 'Log' file/section.
    442437</li>
    443438<li>
    … …  
    445440</li>
    446441<li>
    447 BNC's function is limited today to processing C1, C2, P1, P2, L1, L2, S1, and S2 observations. Which observables become available through a specific stream depends on the setup of the affected receiver and the applied data format. Note that RTCM Version 2.x streams can not transport signal-to-noise ratios (S) and RTCM Version 3.x streams can only transport one code observable per frequency. Note further that signal-to-noise ratios (S) are also made available mapped to integer numbers 1 to 9.
    448 </li>
    449 <li>
    450 Concerning RTCM Version 2.x, BNC handles only message types 18 and 19. Concerning RTCM Version 3.x, BNC correctly handles the message types 1002, 1004, 1010, and 1012. Note that when handling message types 1003 where the ambiguity field is not set, the output will be no valid RINEX. All values will be stored modulo 299792.458.
     442BNC's function is limited today to processing C1, C2, P1, P2, L1, L2, S1, and S2 observations. Which observables become available through a specific stream depends on the setup of the affected receiver and the applied data format. Note that RTCM Version 2.x streams can not transport signal-to-noise ratios 'S' and RTCM Version 3.x streams can only transport one code observable per frequency. Note further that signal-to-noise ratios 'S' are also made available mapped to integer numbers 1 to 9.
     443</li>
     444<li>
     445Concerning RTCM Version 2.x, BNC handles only message types 18 and 19. Concerning RTCM Version 3.x, BNC handles the message types 1002, 1004, 1010, and 1012. Note that when handling message types 1003 where the ambiguity field is not set, the output will be no valid RINEX. All values will be stored modulo 299792.458.
    451446</li>
    452447<li>
    … …  
    454449</li>
    455450<li>
    456 BNC's 'Get Table' function only informs about the STR records of a source-table. Note that you can use an Internet browser to download the full source-table contents of any NTRIP broadcaster by simply entering its URL plus a dummy string in the form http://host:port/dummy. Data field number 8 of the NET records that may show up may provide information about where to register for an NTRIP broadcaster account.
    457 </li>
    458 <li>
    459 EUREF as well as IGS follow an open data policy. Streams are made available through NTRIP broadcasters at <u>www.euref-ip.net</u> and <u>www.igs-ip.net</u> free of charge to anyone for any purpose. Up to now it is not clear how many users will have to be supported simultaneously. The given situation may develop in a way that it becomes difficult to serve all registered users at all times. In case limited dissemination resources on the NTRIP broadcaster side (software restrictions, bandwidth limitation etc.) make it necessary, first priority in stream provision will be given to stream providers, re-broadcasting activities, and real-time analysis centers while access for others might be temporarily denied.
     451BNC's 'Get Table' function only informs about the STR records of a source-table. Note that you can use an Internet browser to download the full source-table contents of any NTRIP broadcaster by simply entering its URL in the form http://host:port. Data field number 8 of the NET records that may show up may provide information about where to register for an NTRIP broadcaster account.
     452</li>
     453<li>
     454EUREF as well as IGS follow an open data policy. Streams are made available through NTRIP broadcasters at <u>www.euref-ip.net</u> and <u>www.igs-ip.net</u> free of charge to anyone for any purpose. Up to now it is not clear how many users will have to be supported simultaneously. The given situation may develop in a way that it becomes difficult to serve all registered users at all times. In case limited dissemination resources on the NTRIP broadcaster side (software restrictions, bandwidth limitation etc.) make it necessary, first priority in stream provision will be given to stream providers followed by re-broadcasting activities and real-time analysis centers while access for others might be temporarily denied.
    460455</li>
    461456<li>
    … …  
    467462<br>
    468463</ul>
    469 <p><a name="authors"><h3>D - Authors</h3></p>
     464<p><a name="authors"><h3>5. Authors</h3></p>
    470465<p>
    471466The 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 Geodesy. BNC integrates the following GNU GPL software components:
    472467<ul>
    473468<li> RTCM 2.x decoder, written by Oliver Montenbruck, German Space Operations Center, DLR, Oberpfaffenhofen</li>
    474 <li> RTCM 3 decoder, written for BKG by Dirk Stoecker, Alberding GmbH, Schoenefeld</li>
     469<li> RTCM 3.x decoder, written for BKG by Dirk Stoecker, Alberding GmbH, Schoenefeld</li>
    475470<li> RTIGS decoder, written by Ken MacLeod, Natural Resources, Canada.</li>
    476471</ul>
    … …  
    483478Federal Agency for Cartography and Geodesy (BKG)<br>
    484479Frankfurt, Germany<br>
    485 euref-ip@bkg.bund.de
    486 </p>
    487 
    488 <p><a name="links"><h3>E - Links</h3></p>
     480euref-ip@bkg.bund.de or igs-ip@bkg.bund.de
     481</p>
     482
     483<p><a name="history"><h3>6. History</h3></p>
     484<p>
     485<table>
     486<tr></tr>
     487<tr><td>Dec 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td><td>Binaries of first beta version published.</td></tr>
     488<tr><td>Jan 2007 &nbsp;</td><td>Version 1.1b &nbsp;</td><td>[Add] Observables C2, S1, and S2<br>[Add] Virtual reference station access<br>[Bug] RTCM2 decoder time tag fixed<br>[Mod] Small letters for public RINEX skeleton files<br>[Add] Online help through Shift+F1</td></tr>
     489<tr><td>Apr 2007 &nbsp;</td><td>Version 1.2b &nbsp;</td><td>[Bug] Output only through IP port<br>[Bug] Method 'reconnecting' now thread-save<br> [Add] ZERO decoder added<br> [Mod] Download public RINEX skeletons once per day<br> [Mod] Upgrade to Qt Version 4.2.3<br> [Mod] Replace 'system' call for RINEX script by 'QProcess'<br> [Add] HTTP Host directive for skeleton file download<br> [Add] Percent encoding for user IDs and passwords<br> [Bug] Exit execution of calling thread for RTCM3 streams<br> [Bug] Signal-slot mechanism for threads</td></tr>
     490<tr><td>May 2007 &nbsp;</td><td>Version 1.3 &nbsp;</td><td>Source code published.
     491<tr><td>Jul 2007 &nbsp;</td><td>Version 1.4 &nbsp;</td><td>[Bug] Skip messages from proxy server<br> [Bug] Call RINEX script through 'nohup'</td></tr>
     492<tr><td>Nov 2007 &nbsp;</td><td>Version 1.5 &nbsp;</td><td>[Add] Save Ephemeris from RTCM Version 3.x streams<br> [Add] Upgrade to Qt Version 4.3.2<br> [Add] Optional RINEX v3 output<br> [Add] SBAS support</td></tr>
     493</table>
     494</p>
     495
     496<p><a name="links"><h3>7. Links</h3></p>
    489497<table>
    490498<tr></tr>
    … …  
    493501<tr><td>IGS-IP NTRIP broadcaster &nbsp;</td><td><u>http://www.igs-ip.net/home</u></td></tr>
    494502<tr><td>NTRIP broadcaster overview &nbsp;</td><td><u>http://www.rtcm-ntrip.org/home</u></td></tr>
    495 <tr><td>EUREF-IP Pilot Project &nbsp;</td><td><u>http://www.epncb.oma.be/euref_IP</u></td></tr>
     503<tr><td>EUREF-IP Project &nbsp;</td><td><u>http://www.epncb.oma.be/euref_IP</u></td></tr>
     504<tr><td>Real-time IGS Pilot Project &nbsp;</td><td><u>http://www.rtigs.net/pilot</u></td></tr>
    496505<tr><td>Radio Technical Commission<br>for Maritime Services &nbsp;</td><td><u>http://www.rtcm.org</u>
    497506</table>
    498507
    499 <p><a name="annex"><h3>F - Annex</h3></p>
    500 <p>
    501 F - 1. <a href=#ntrip>NTRIP</a><br>
    502 &nbsp; &nbsp; &nbsp; E - 1.1 <a href=#source>Source-table</a><br>
    503 F - 2. <a href=#rtcm>RTCM</a><br>
    504 &nbsp; &nbsp; &nbsp; F - 2.1 RTCM <a href=#rtcm2> Version 2.x</a><br>
    505 &nbsp; &nbsp; &nbsp; F - 2.2 RTCM <a href=#rtcm3> Version 3</a><br>
    506 F - 3. <a href=#rtigs>RTIGS</a><br>
    507 &nbsp; &nbsp; &nbsp; F - 3.1 <a href=#soc>SOC</a><br>
    508 F - 4. <a href=#config>Config File</a>
    509 </p>
    510 
    511 <p><a name="ntrip"><h4>F - 1. NTRIP</h4></p>
     508<p><a name="annex"><h3>8. Annex</h3></p>
     509<p>
     5108.1. <a href=#ntrip>NTRIP</a><br>
     511&nbsp; &nbsp; &nbsp; 8.1.1 <a href=#source>Source-table</a><br>
     5128.2. <a href=#rtcm>RTCM</a><br>
     513&nbsp; &nbsp; &nbsp; 8.2.1 RTCM <a href=#rtcm2> Version 2.x</a><br>
     514&nbsp; &nbsp; &nbsp; 8.2.2 RTCM <a href=#rtcm3> Version 3</a><br>
     5158.3. <a href=#rtigs>RTIGS</a><br>
     516&nbsp; &nbsp; &nbsp; 8.3.1 <a href=#soc>SOC</a><br>
     5178.4. <a href=#config>Config File</a>
     518</p>
     519
     520<p><a name="ntrip"><h4>8.1. NTRIP</h4></p>
    512521
    513522<p>
    … …  
    534543</p>
    535544
    536 <p><a name="source"><h4>F - 1.1 Source-table</h4></p>
     545<p><a name="source"><h4>8.1.1 Source-table</h4></p>
    537546
    538547<p>
    … …  
    550559</p>
    551560
    552 <p><a name="rtcm"><h4>F - 2. RTCM</h4></p>
     561<p><a name="rtcm"><h4>8.2. RTCM</h4></p>
    553562
    554563<p>
    … …  
    558567</p>
    559568
    560 <p><a name="rtcm2"><h4>F - 2.1 RTCM Version 2.x</h4></p>
     569<p><a name="rtcm2"><h4>8.2.1 RTCM Version 2.x</h4></p>
    561570<p>
    562571Transmitting GNSS carrier phase data can be done through RTCM Version 2.x messages. Please note that only RTCM Version 2.2 and 2.3 streams may include GLONASS data. Messages that may be of some interest here are:
    … …  
    596605</ul>
    597606
    598 <p><a name="rtcm3"><h4>F - 2.2 RTCM Version 3.x</h4></p>
    599 <p>
    600 RTCM Version 3.x has been developed as a more efficient alternative to RTCM 2.x. Service providers and vendors have asked for a 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 Version 3 standard is intended to correct these weaknesses.
     607<p><a name="rtcm3"><h4>8.2.2 RTCM Version 3.x</h4></p>
     608<p>
     609RTCM Version 3.x has been developed as a more efficient alternative to RTCM Version 2.x. Service providers and vendors have asked for a 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 Version 3 standard is intended to correct these weaknesses.
    601610</p>
    602611<p>
    … …  
    624633</ul>
    625634
    626 <p><a name="rtigs"><h4>F - 3. RTIGS</h4></p>
     635<p><a name="rtigs"><h4>8.3. RTIGS</h4></p>
    627636<p>
    628637RTIGS stands for a data format and transport protocol for GPS observations. It was defined by the Real-Time IGS Working Group (RTIGS WG). Its definition is based on the SOC format. Every RTIGS record has one of the following numbers:
    … …  
    677686</p>
    678687
    679 <p><a name="soc"><h4>F - 3.1 SOC</h4></p>
     688<p><a name="soc"><h4>8.3.1 SOC</h4></p>
    680689<p>
    681690The SOC format has been designed in July 1999 by the Jet Propulsion Laboratory (JPL) and the California Institute of Technology (CalTech) to transport 1Hz GPS data with minimal bandwidth over the open Internet. SOC follows the 'little-endian' byte order meaning that the low-order byte of a number is stored in memory at the lowest address, and the high-order byte at the highest address. Because the transport layer is UDP, the format does not include sync bits, a checksum, or cyclic redundancy checksum (CRC). SOC allows to transport the GPS observable CA, P1, P2, L1, and L2, efficiently compressed down to 14 bytes with 1 mm range resolution and 0.02 mm phase resolution. SOC contains epochs for cycle slips, a stand-alone time-tag per epoch, a minimum representation of the receiver's clock solution, 3 SNR numbers, a unique site id, a modulo 12 hour sequence number and flags for receiver type and GPS health. SOC's simple structure comprises an 8 byte header, a 9 byte overhead for timetag, number of gps, etc., plus 21 data bytes per gps.
    … …  
    686695<p>
    687696</p>
    688 <p><a name="config"><h4>F - 4. Config File</h4></p>
     697<p><a name="config"><h4>8.4. Config File</h4></p>
    689698<p>
    690699The following is an example for the contents of a Unix/Linux configuration file ${HOME}/.config/BKG/BKG_NTRIP_Client.conf. It enables the retrieval of stream ACOR0 form www.euref-ip.net and FFMJ3 from www.igs-ip.net for the generation of 15 min RINEX files. RINEX files are uploaded to an archive using script 'up2archive' :
    … …  
    699708ephV3=2
    700709logFile=/home/user/log.txt
    701 mountPoints=//user:pass@www.euref-ip.net:80/ACOR0 RTCM_2.3 43.36 351.60 no, //user:pass@www.igs-ip.net:80/FFMJ3 RTCM_3.0 41.58 1.40 no
     710mountPoints=//user:pass@www.euref-ip.net:2101/ACOR0 RTCM_2.3 43.36 351.60 no, //user:pass@www.igs-ip.net:2101/FFMJ3 RTCM_3.0 41.58 1.40 no
    702711outFile=/home/user/ascii
    703712outPort=2101
Note: See TracChangeset for help on using the changeset viewer.