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


Ignore:
Timestamp:
Dec 6, 2009, 8:59:27 PM (15 years ago)
Author:
weber
Message:

* empty log message *

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/BNC/bnchelp.html

    r2056 r2088  
    137137&nbsp; &nbsp; &nbsp; 3.10.2. <a href=#miscperf>Log Latency</a><br>
    138138&nbsp; &nbsp; &nbsp; 3.10.3. <a href=#miscscan>Scan RTCM</a><br>
    139 3.11. <a href=#streams>Streams</a><br>
    140 &nbsp; &nbsp; &nbsp; 3.11.1 <a href=#streamedit>Edit Streams</a><br>
    141 &nbsp; &nbsp; &nbsp; 3.11.2 <a href=#streamdelete>Delete Stream</a><br>
    142 &nbsp; &nbsp; &nbsp; 3.11.3 <a href=#streamconf>Reconfigure Streams On-the-fly</a><br>
    143 3.12. <a href=#logs>Logging</a><br>
    144 &nbsp; &nbsp; &nbsp; 3.12.1 <a href=#logfile>Log</a><br>
    145 &nbsp; &nbsp; &nbsp; 3.12.2 <a href=#throughput>Throughput</a><br>
    146 &nbsp; &nbsp; &nbsp; 3.12.3 <a href=#latency>Latency</a><br>
    147 3.13. <a href=#bottom>Bottom Menu Bar</a><br>
    148 &nbsp; &nbsp; &nbsp; 3.13.1. <a href=#streamadd>Add Stream - Coming from Caster</a><br>
    149 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.13.1.1 <a href=#streamhost>Caster Host and Port</a><br>
    150 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.13.1.2 <a href=#streamtable>Casters Table</a><br>
    151 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.13.1.3 <a href=#streamuser>User and Password</a><br>
    152 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.13.1.4 <a href=#gettable>Get Table</a><br>
    153 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.13.1.5 <a href=#ntripv>NTRIP Version</a><br>
    154 &nbsp; &nbsp; &nbsp; 3.13.2 <a href=#streamip>Add Stream - Coming from TCP/IP Port</a><br>
    155 &nbsp; &nbsp; &nbsp; 3.13.3 <a href=#streamudp>Add Stream - Coming from UDP Port</a><br>
    156 &nbsp; &nbsp; &nbsp; 3.13.4 <a href=#streamser>Add Stream - Coming from Serial Port</a><br>
    157 &nbsp; &nbsp; &nbsp; 3.13.5 <a href=#start>Start</a><br>
    158 &nbsp; &nbsp; &nbsp; 3.13.6 <a href=#stop>Stop</a><br>
    159 3.14. <a href=#cmd>Command Line Options</a><br>
    160 &nbsp; &nbsp; &nbsp; 3.14.1. <a href=#nw>No Window Mode</a><br>
    161 &nbsp; &nbsp; &nbsp; 3.14.2. <a href=#post>Offline Mode</a><br>
    162 &nbsp; &nbsp; &nbsp; 3.14.3. <a href=#conffile>Configuration File</a><br>
     1393.11. <a href=#pppclient>PPP Client</a><br>
     140&nbsp; &nbsp; &nbsp; 3.11.1 <a href=#pppmount>Mountpoint</a><br>
     141&nbsp; &nbsp; &nbsp; 3.11.2 <a href=#pppstatic>Static</a><br>
     142&nbsp; &nbsp; &nbsp; 3.11.3 <a href=#pppphase>Use phase obs</a><br>
     143&nbsp; &nbsp; &nbsp; 3.11.4 <a href=#ppptropo>Estimate tropo</a><br>
     1443.12. <a href=#streams>Streams</a><br>
     145&nbsp; &nbsp; &nbsp; 3.12.1 <a href=#streamedit>Edit Streams</a><br>
     146&nbsp; &nbsp; &nbsp; 3.12.2 <a href=#streamdelete>Delete Stream</a><br>
     147&nbsp; &nbsp; &nbsp; 3.12.3 <a href=#streamconf>Reconfigure Streams On-the-fly</a><br>
     1483.13. <a href=#logs>Logging</a><br>
     149&nbsp; &nbsp; &nbsp; 3.13.1 <a href=#logfile>Log</a><br>
     150&nbsp; &nbsp; &nbsp; 3.13.2 <a href=#throughput>Throughput</a><br>
     151&nbsp; &nbsp; &nbsp; 3.13.3 <a href=#latency>Latency</a><br>
     1523.14. <a href=#bottom>Bottom Menu Bar</a><br>
     153&nbsp; &nbsp; &nbsp; 3.14.1. <a href=#streamadd>Add Stream - Coming from Caster</a><br>
     154&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.14.1.1 <a href=#streamhost>Caster Host and Port</a><br>
     155&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.14.1.2 <a href=#streamtable>Casters Table</a><br>
     156&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.14.1.3 <a href=#streamuser>User and Password</a><br>
     157&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.14.1.4 <a href=#gettable>Get Table</a><br>
     158&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.14.1.5 <a href=#ntripv>NTRIP Version</a><br>
     159&nbsp; &nbsp; &nbsp; 3.14.2 <a href=#streamip>Add Stream - Coming from TCP/IP Port</a><br>
     160&nbsp; &nbsp; &nbsp; 3.14.3 <a href=#streamudp>Add Stream - Coming from UDP Port</a><br>
     161&nbsp; &nbsp; &nbsp; 3.14.4 <a href=#streamser>Add Stream - Coming from Serial Port</a><br>
     162&nbsp; &nbsp; &nbsp; 3.14.5 <a href=#start>Start</a><br>
     163&nbsp; &nbsp; &nbsp; 3.14.6 <a href=#stop>Stop</a><br>
     1643.15. <a href=#cmd>Command Line Options</a><br>
     165&nbsp; &nbsp; &nbsp; 3.15.1. <a href=#nw>No Window Mode</a><br>
     166&nbsp; &nbsp; &nbsp; 3.15.2. <a href=#post>Offline Mode</a><br>
     167&nbsp; &nbsp; &nbsp; 3.15.3. <a href=#conffile>Configuration File</a><br>
    163168</p>
    164169
     
    923928</p>
    924929
    925 <p><a name="streams"><h4>3.11. Streams</h4></p>
     930<p><a name="pppclient"><h4>3.11. PPP Client</h4></p>
     931<p>
     932BNC can derive coordinates for a rover position following the Precise Point Positioning (PPP) approach. It uses either code or phase data in ionosphere free linear combinations P3 or L3.
     933</p>
     934
     935<p><a name="pppmount"><h4>3.11.1 Mountpoint - optional</h4></p>
     936<p>
     937Specify a mountpoint if you want BNC to derive coordinates for the affected receiver position through a PPP solution.
     938</p>
     939
     940<p><a name="pppstatic"><h4>3.11.2 Static - optional</h4></p>
     941<p>
     942By default BNC considers the rover position as mobile. Tick 'Static' to consider a static observation sitatuion and adapt appropriate filter characteristics for that.
     943</p>
     944
     945<p><a name="pppphase"><h4>3.11.3 Use phase obs - optional</h4></p>
     946<p>
     947By default BNC applies a PPP solution using an ionosphere free P3 linear combination of code observations. Tick 'Use phase obs' to switch to an ionosphere free L3 linear combination of phase observations.
     948</p>
     949
     950<p><a name="ppptropo"><h4>3.11.4 Estimate tropo - optional</h4></p>
     951<p>
     952By default BNC does not introduce troposphere parameters when estimating coordinates. Tick 'Estimate tropo' to introduce troposphere parameters when estimating coordinates.
     953</p>
     954
     955<p><a name="streams"><h4>3.12. Streams</h4></p>
    926956<p>
    927957Each stream on an NTRIP broadcaster (and consequently on BNC) is defined using a unique source ID called mountpoint. An NTRIP client like BNC access the desired data stream by referring to its mountpoint. Information about streams and their 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.
     
    944974</p>
    945975
    946 <p><a name="streamedit"><h4>3.11.1 Edit Streams</h4></p>
     976<p><a name="streamedit"><h4>3.12.1 Edit Streams</h4></p>
    947977<ul>
    948978<li>
     
    959989</ul>
    960990
    961 <p><a name="streamdelete"><h4>3.11.2 Delete Stream</h4></p>
     991<p><a name="streamdelete"><h4>3.12.2 Delete Stream</h4></p>
    962992<p>
    963993To remove a stream from the 'Streams' canvas in the main window, highlight it by clicking on it and hit the 'Delete Stream' button. You can also remove multiple streams simultaneously by highlighting them using +Shift and +Ctrl.</p>
    964994
    965 <p><a name="streamconf"><h4>3.11.3 Reconfigure Streams On-the-fly</h4></p>
     995<p><a name="streamconf"><h4>3.12.3 Reconfigure Streams On-the-fly</h4></p>
    966996<p>
    967997The streams selection can be changed on-the-fly without interrupting uninvolved threads in the running BNC process.
     
    9731003</p>
    9741004
    975 <p><a name="logs"><h4>3.12. Logging</h4></p>
     1005<p><a name="logs"><h4>3.13. Logging</h4></p>
    9761006<p>
    9771007A tabs section on the bottom of the main window provides online controle of BNC's activities. Tabs are available to show the records saved in a logfile, for a plot to controle the bandwidth consumtion and for a plot showing stream latencies.
    9781008</p>
    979 <p><a name="logfile"><h4>3.12.1 Log</h4></p>
     1009<p><a name="logfile"><h4>3.13.1 Log</h4></p>
    9801010<p>
    9811011Records of BNC's activities are shown in the 'Log' tab. They can be saved into a file when a valid path is specified in the 'Logfile (full path)' field.
    9821012</p>
    9831013
    984 <p><a name="throughput"><h4>3.12.2 Throughput</h4></p>
     1014<p><a name="throughput"><h4>3.13.2 Throughput</h4></p>
    9851015<p>
    9861016The bandwidth consumtion per stream is shown in the 'Throughput' tab in bits per second (bps) or kilo bits per second (kbps).
    9871017</p>
    9881018
    989 <p><a name="latency"><h4>3.12.3 Latency</h4></p>
     1019<p><a name="latency"><h4>3.13.3 Latency</h4></p>
    9901020<p>
    9911021The latency of observations in each incoming stream is shown in the 'Latency' tab in milliseconds or seconds. Streams not carrying observations (i.e. those providing only broadcast ephemeris messages) are not considered here. Note that the calculation of correct latencies requires the clock of the host computer to be properly synchronized.
    9921022</p>
    9931023
    994 <p><a name="bottom"><h4>3.13. Bottom Menu Bar</h4></p>
     1024<p><a name="bottom"><h4>3.14. Bottom Menu Bar</h4></p>
    9951025<p>
    9961026The bottom menu bar allows to add or delete streams to BNC's configuration and to start or stop it. It also provides access to BNC's online help function.
    9971027</p>
    9981028
    999 <p><a name="streamadd"><h4>3.13.1 Add Stream - Coming from Caster</h4></p>
     1029<p><a name="streamadd"><h4>3.14.1 Add Stream - Coming from Caster</h4></p>
    10001030<p>
    10011031Button 'Add Stream' > 'Coming from Caster' opens a window that allows user to select data streams from an NTRIP broadcaster according to their mountpoints.
    10021032</p>
    10031033
    1004 <p><a name="streamhost"><h4>3.13.1.1 Caster Host and Port - mandatory</h4></p>
     1034<p><a name="streamhost"><h4>3.14.1.1 Caster Host and Port - mandatory</h4></p>
    10051035<p>
    10061036Enter the NTRIP broadcaster host IP and port number. 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>.
    10071037</p>
    10081038
    1009 <p><a name="streamtable"><h4>3.13.1.2 Casters Table - optional</h4></p>
     1039<p><a name="streamtable"><h4>3.14.1.2 Casters Table - optional</h4></p>
    10101040<p>
    10111041It may be that your are not sure about your NTRIP broadcasters host and port number or you are interested in other broadcaster installations operated elsewhere. Hit 'Show' for a table of known broadcasters maintained at <u>www.rtcm-ntrip.org/home</u>. A window opens which allows to select a broadcaster for stream retrieval.
    10121042</p>
    10131043
    1014 <p><a name="streamuser"><h4>3.13.1.3 User and Password - mandatory for protected streams</h4></p>
     1044<p><a name="streamuser"><h4>3.14.1.3 User and Password - mandatory for protected streams</h4></p>
    10151045<p>
    10161046Some streams on NTRIP broadcasters may be restricted. Enter a valid 'User' ID and 'Password' for access to protected 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>.
    10171047</p>
    10181048
    1019 <p><a name="gettable"><h4>3.13.1.4 Get Table</h4></p>
     1049<p><a name="gettable"><h4>3.14.1.4 Get Table</h4></p>
    10201050<p>
    10211051Use the 'Get Table' button 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 or 20 and 21 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 in order to produce RINEX Navigation files RTCM Version 3.x streams containing message types 1019 (GPS) and 1020 (GLONASS) are required. Select your streams line by line, use +Shift and +Ctrl when necessary.
     
    10281058</p>
    10291059
    1030 <p><a name="ntripv"><h4>3.13.1.5 NTRIP Version - mandatory</h4></p>
     1060<p><a name="ntripv"><h4>3.14.1.5 NTRIP Version - mandatory</h4></p>
    10311061<p>
    10321062Some limitations and deficiencies of the NTRIP version 1 stream transport protocol are solved in NTRIP version 2. Improvements mainly concern a full HTTP compatibility in view of requirements coming from proxy servers. Version 2 is backwards compatible to Version 1. Options implemented in BNC are:
     
    10491079</p>
    10501080
    1051 <p><a name="streamip"><h4>3.13.2 Add Stream - Coming from TCP/IP Port</h4></p>
     1081<p><a name="streamip"><h4>3.14.2 Add Stream - Coming from TCP/IP Port</h4></p>
    10521082<p>
    10531083Button 'Add Stream' > 'Coming from TCP/IP Port' allows to retrieve streams via TCP directly from an IP address without using the NTRIP transport protocol. For that you:
     
    10681098</p>
    10691099
    1070 <p><a name="streamudp"><h4>3.13.3 Add Stream - Coming from UDP Port</h4></p>
     1100<p><a name="streamudp"><h4>3.14.3 Add Stream - Coming from UDP Port</h4></p>
    10711101<p>
    10721102Button 'Add Stream' > 'Coming from UDP Port' allows to pick up streams arriving directly at one of the local host's UDP ports without using the NTRIP transport protocol. For that you:
     
    10831113<p>
    10841114
    1085 <p><a name="streamser"><h4>3.13.4 Add Stream - Coming from Serial Port</h4></p>
     1115<p><a name="streamser"><h4>3.14.4 Add Stream - Coming from Serial Port</h4></p>
    10861116<p>
    10871117Button 'Add Stream' > 'Coming from Serial Port' allows to retrieve streams from a GNSS receiver via serial port without using the NTRIP transport protocol. For that you:
     
    11171147<p>
    11181148
    1119 <p><a name="start"><h4>3.13.5 Start</h4></p>
     1149<p><a name="start"><h4>3.14.5 Start</h4></p>
    11201150<p>
    11211151Hit 'Start' to start retrieving, decoding, and converting GNSS data streams in real-time. Note that 'Start' generally forces BNC to begin with fresh RINEX which might overwrite existing files when necessary unless the option 'Append files' is ticked.
    11221152</p>
    11231153
    1124 <p><a name="stop"><h4>3.13.6 Stop</h4></p>
     1154<p><a name="stop"><h4>3.14.6 Stop</h4></p>
    11251155<p>
    11261156Hit the 'Stop' button in order to stop BNC.
    11271157</p>
    11281158
    1129 <p><a name="cmd"><h4>3.14. Command Line Options</h4></p>
     1159<p><a name="cmd"><h4>3.15. Command Line Options</h4></p>
    11301160<p>
    11311161Command line options are available to run BNC in 'no window' mode or let it read data from a file in offline mode. BNC will then use processing options from the configuration file. Note that the self-explaining contents of the configuration file can easily be edited. It is possible to introduce a specific configuration file name instead of using the default name 'BNC.ini'.
    11321162</p>
    11331163
    1134 <p><a name="nw"><h4>3.14.1 No Window Mode - optional</h4></p>
     1164<p><a name="nw"><h4>3.15.1 No Window Mode - optional</h4></p>
    11351165<p>
    11361166Apart from its regular windows mode, BNC can be started on all systems as a background/batch job with command line option '-nw'. BNC will then run in 'no window' mode, using processing options from its configuration file on disk. Terminate BNC using Windows Task Manager when running it in 'no window' mode on Windows systems.
     
    11411171</p>
    11421172
    1143 <p><a name="post"><h4>3.14.2 Offline Mode - optional</h4></p>
     1173<p><a name="post"><h4>3.15.2 Offline Mode - optional</h4></p>
    11441174<p>
    11451175Although BNC is primarily a real-time online tool, it can be run in offline mode to read data from a file for post processing purposes. Enter the following four command line options for that:
     
    11601190</p>
    11611191
    1162 <p><a name="conffile"><h4>3.14.3 Configuration File - optional</h4></p>
     1192<p><a name="conffile"><h4>3.15.3 Configuration File - optional</h4></p>
    11631193The default configuration file name is 'BNC.ini'. You may change this name at startup time using the command line option '--conf &#060;<u>confFileName</u>&#062;'. This allows to run several BNC jobs in parallel on the same host using different sets of configuration options. <u>confFileName</u> stands either for the full path to a configuration file or just for a file name. If you introduce only a filename, the corresponding file will be saved in the current working directory from where BNC is started.
    11641194</p>
Note: See TracChangeset for help on using the changeset viewer.