Changeset 658 in ntrip for trunk/BNC/bnchelp.html
- Timestamp:
- Jan 28, 2008, 3:50:05 PM (16 years ago)
- File:
-
- 1 edited
-
trunk/BNC/bnchelp.html (modified) (6 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/BNC/bnchelp.html
r644 r658 77 77 3.6.2. <a href=#ephvers>RINEX Version</a><br> 78 78 3.6.3. <a href=#ephinterval>Ephemeris File Interval</a><br> 79 3.7. <a href=#mountpoints>Mountpoints</a><br> 80 3.7.1. <a href=#AddMounts>Add Mountpoints</a><br> 81 3.7.2. <a href=#HostPort>Broadcaster Host and Port</a><br> 82 3.7.3. <a href=#account>Broadcaster User and Password</a><br> 83 3.7.4. <a href=#GetTable>Get Table</a><br> 84 3.7.5. <a href=#delete>Delete Mountpoints</a><br> 85 3.7.6. <a href=#edit>Edit Mountpoints</a><br> 86 3.8. <a href=#log>Log</a><br> 87 3.9. <a href=#start>Start</a><br> 88 3.10. <a href=#stop>Stop</a><br> 89 3.11. <a href=#nw>No Window</a> 79 3.7. <a href=#thresholds>Notice Advisories</a><br> 80 3.7.1. <a href=#threshFail>Failure Threshold</a><br> 81 3.7.2. <a href=#threshReco>Recovery Threshold</a><br> 82 3.7.3. <a href=#inspectSegm>Inspect Segment</a><br> 83 3.7.4. <a href=#noteScript>Notice Script</a><br> 84 3.8. <a href=#mountpoints>Mountpoints</a><br> 85 3.8.1. <a href=#AddMounts>Add Mountpoints</a><br> 86 3.8.2. <a href=#HostPort>Broadcaster Host and Port</a><br> 87 3.8.3. <a href=#account>Broadcaster User and Password</a><br> 88 3.8.4. <a href=#GetTable>Get Table</a><br> 89 3.8.5. <a href=#delete>Delete Mountpoints</a><br> 90 3.8.6. <a href=#edit>Edit Mountpoints</a><br> 91 3.9. <a href=#log>Log</a><br> 92 3.10. <a href=#start>Start</a><br> 93 3.11. <a href=#stop>Stop</a><br> 94 3.12. <a href=#nw>No Window</a> 90 95 </p> 91 96 … … 354 359 </p> 355 360 356 <p><a name="mountpoints"><h4>3.7. Mountpoints</h4></p> 361 <p><a name="thresholds"><h4>3.7. Notice Advisories</h4></p> 362 <p> 363 It may happen at any time that a stream becomes unavailable or corrupted. Understanding problem situations is of importance for BNC's operator as well as for the affected stream providers so that maintenance efforts can be initiated. Furthermore, continuously trying to decode a corrupted stream can generate an unnecessary workload for BNC. 364 </p> 365 <p> 366 <u>Stream outages:</u> Connection to an NTRIP broadcaster can sometimes be disrupted or a stream requested may temporarily be unavailable. Connection is defined by BNC as broken if no data is coming in for a period of 20 seconds. When this occurs, reconnects are attempted at decreasing rate. BNC first attempts to reconnect with ~1 second lag, if unsuccessful, again in ~2 seconds since the previous attempt. If it is still unsuccessful, it will attempt to reconnect within ~4 seconds since the previous attempt etc. Each attempt doubles the wait time from the previous attempt. The maximum delay between attempts is limited to ~256 seconds. This reconnection process is documented in the 'Log' file/section. 367 </p> 368 <p> 369 <u>Stream corruption:</u> Not each transfer of a chunk of bits (as received) to BNC's internal decoders necessarily results in the return of valid observations. It may need several chunks till the next observation can be derived. Hence BNC collects all returns (success or failure) coming from a decoder within a certain short 'Inspect segment' time span to then decide whether a stream content is okay or not. When a stream is corrupted, the decoding process can be stopped temporarily. Decodings are tried again at decreasing rate. BNC first attempts to decode again after a 30 second lag, if unsuccessful, again in 60 seconds since the previous attempt. If it is still unsuccessful, it will attempt to decode after 120 seconds since the previous attempt etc. Each decoding attempt doubles the wait time from the previous attempt. The maximum delay between attempts is limited to 960 seconds. 370 </p> 371 <p> 372 If a persistent stream failure or recovery caused by a stream outage or corruption exceeds the 'Failure' or 'Recovery' threshold, BNC can inform its users about this event. The information becomes available in the 'Log' file/section as a 'Begin_Outage', 'End_Outage', 'Begin_Corrupted', or 'End_Corrupted' message. It can also be passed on as a Notice advisory to a 'Notice script' or batch file to keep BNC's operator or affected stream providers up-to-date by email. This functionality lets you use BNC as a real-time performance monitor and alarm system for the network of GNSS reference stations in use. 373 </p> 374 375 <p><a name="threshFail"><h4>3.7.1 Failure Threshold - optional</h4></p> 376 <p>A Notice advisory is generated if no or only corrupted observations are received throughout the 'Failure' threshold time span. Specifying a value of 15 min (default) is recommendable to not bother a BNC user with too much information. 377 </p> 378 <p> 379 Note that specifying a value of zero '0' for both, the 'Failure' and the 'Recovery' threshold means that BNC immediately informs about any failure/recovery and that decoding efforts shall never pause. 380 </p> 381 <p> 382 Note further that using this function for corrupted streams needs an 'Inspect segment' greater zero '0'. 383 </p> 384 385 <p><a name="threshReco"><h4>3.7.2 Recovery Threshold - optional</h4></p> 386 <p> 387 Following a longer lasting stream outage or series of completely corrupted observations, a Notice advisory is generated as soon as a valid observation is received again at least once within the 'Recovery' threshold time span. Specifying a value of 5 min (default) is recommendable to not bother a BNC user with too much information. 388 </p> 389 <p> 390 Note that specifying a value of zero '0' for both, the 'Failure' and the 'Recovery' threshold means that BNC immediately informs about any failure/recovery and that decoding efforts shall never pause. 391 </p> 392 <p> 393 Note further that using this function for corrupted streams needs an 'Inspect segment' greater zero '0'. 394 </p> 395 396 <p><a name="inspectSegm"><h4>3.7.3 Inspect Segment - mandatory for 'Failure' and 'Recovery' thresholds</h4></p> 397 <p> 398 BNC can collect all returns (failure or success) coming from a decoder within a short 'Inspect segment' time span to then decide whether a stream content is corrupted or not. If a continuous problem (or recovery) is detected, BNC informs about this event. A value of about 15 sec (default) as 'Inspect segment' is recommended when handling 1Hz data. If this value is specified too small, temporary communication bottlenecks my lead to an additional loss of some data of the affected stream. 399 </p> 400 <p> 401 Specifying a value of zero '0' means that you by-pass BNC's corruption check. However, this may result in an additional workload in case of long-lasting stream corruptions. Note that specifying an 'Inspect segment' greater zero '0' is mandatory to generate Notice advisories informing about corrupted streams. 402 </p> 403 404 <p><a name="noteScript"><h4>3.7.4 Notice Script - optional </h4></p> 405 <p> 406 Specify the full path to a script or batch file to handle Notice advisories generated in case of outages or currupted streams. The affected mountpoint and of a comment 'Begin_Outage', 'End_Outage', 'Begin_Currupted', or 'End_Corrupted' are transfered to the script as command line parameters (%1 and %2 on Windows systems, $1 and $2 on Unix/Linux systems). 407 </p><p>The script may contain commands to archive outage/corrupt information or to send an email to BNC's operator and/or to the affected stream provider. An empty option field or invalid path means that you don't want to use this option. 408 </p> 409 410 <p><a name="mountpoints"><h4>3.8. Mountpoints</h4></p> 357 411 <p> 358 412 Each stream on an NTRIP broadcaster 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 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. … … 371 425 </table> 372 426 373 <p><a name="AddMounts"><h4>3. 7.1 Add Mountpoints</h4></p>427 <p><a name="AddMounts"><h4>3.8.1 Add Mountpoints</h4></p> 374 428 <p> 375 429 Button 'Add Mountpoints' opens a window that allows user to select data streams from an NTRIP broadcaster according to their mountpoints. 376 430 </p> 377 431 378 <p><a name="HostPort"><h4>3. 7.2 Broadcaster Host and Port - required</h4></p>432 <p><a name="HostPort"><h4>3.8.2 Broadcaster Host and Port - required</h4></p> 379 433 <p> 380 434 Enter 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>. 381 435 </p> 382 436 383 <p><a name="account"><h4>3. 7.3 Broadcaster User and Password - required for protected streams</h4></p>437 <p><a name="account"><h4>3.8.3 Broadcaster User and Password - required for protected streams</h4></p> 384 438 <p> 385 439 Some 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>. 386 440 </p> 387 441 388 <p><a name="GetTable"><h4>3. 7.4 Get Table</h4></p>442 <p><a name="GetTable"><h4>3.8.4 Get Table</h4></p> 389 443 <p> 390 444 Use 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 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. … … 397 451 </p> 398 452 399 <p><a name="delete"><h4>3. 7.5 Delete Mountpoints</h4></p>453 <p><a name="delete"><h4>3.8.5 Delete Mountpoints</h4></p> 400 454 <p> 401 455 To remove a stream from the 'Mountpoints' list in the main window, highlight it by clicking on it and hit the 'Delete Mountpoints' button. You can also remove multiple mountpoints simultaneously by highlighting them using +Shift and +Ctrl.</p> 402 456 403 <p><a name="edit"><h4>3. 7.6 Edit Mountpoints</h4></p>457 <p><a name="edit"><h4>3.8.6 Edit Mountpoints</h4></p> 404 458 <ul> 405 459 <li> … … 416 470 </ul> 417 471 418 <p><a name="log"><h4>3. 8. Log - optional</h4></p>472 <p><a name="log"><h4>3.9. Log - optional</h4></p> 419 473 <p> 420 474 Records of BNC's activities are shown in the 'Log' section of the main windows. These logs can be saved into a file when a valid path is specified in the 'Log (full path)' field. The message log covers the communication status between BNC and the NTRIP broadcaster as well as problems that may occur in the communication link, stream availability, stream delay, stream conversion etc. The default value for 'Log (full path)' is an empty option field, meaning that BNC logs will not saved into a file. 421 475 </p> 422 476 423 <p><a name="start"><h4>3. 9. Start</h4></p>477 <p><a name="start"><h4>3.10. Start</h4></p> 424 478 <p> 425 479 Hit '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. 426 480 </p> 427 481 428 <p><a name="stop"><h4>3.1 0. Stop</h4></p>482 <p><a name="stop"><h4>3.11. Stop</h4></p> 429 483 <p> 430 484 Hit the 'Stop' button in order to stop BNC. 431 485 </p> 432 486 433 <p><a name="nw"><h4>3.1 1. No Window - optional</h4></p>487 <p><a name="nw"><h4>3.12. No Window - optional</h4></p> 434 488 <p> 435 489 On all systems BNC can be started in batch mode with the command line option '-nw'. BNC will then run in 'no window' mode, using 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). … … 440 494 <p><a name="limits"><h3>4. Limitations</h3></p> 441 495 <ul> 442 <li>443 Connection to an NTRIP broadcaster can sometimes be disrupted or a stream requested may temporarily be unavailable. Connection is defined by BNC as broken if no data is coming in for a period of 20 seconds. When this occurs, reconnects are attempted at decreasing rate. BNC first attempts to reconnect with ~1 second lag, if unsuccessful, again in ~2 seconds since the previous attempt. If it is still unsuccessful, it will attempt to reconnect within ~4 seconds since the previous attempt etc. Each attempt doubles the wait time from the previous attempt. The maximum delay between attempts is limited to ~256 seconds. This reconnection process is documented in the 'Log' file/section.444 </li>445 496 <li> 446 497 Currently BNC only handles GPS, SBAS and GLONASS data. Galileo is not yet supported.
Note:
See TracChangeset
for help on using the changeset viewer.
