source: ntrip/trunk/BNC/bnchelp.html@ 1256

Last change on this file since 1256 was 1247, checked in by weber, 16 years ago

* empty log message *

File size: 72.3 KB
RevLine 
[1233]1<h3>BKG Ntrip Client (BNC) Version 1.6</h3>
2
3<p>
4The BKG Ntrip Client (BNC) is a program for simultaneously retrieving, decoding and converting real-time GNSS data streams from NTRIP broadcasters like <u>http://www.euref-ip.net/home</u> or <u>http://www.igs-ip.net/home</u>.
5</p>
6
7<p>
8BNC has been developed for the Federal Agency for Cartography and Geodesy (BKG) within the framework of EUREF's Real-time GNSS Project (EUREF-IP, IP for Internet Protocol) and the Real-Time IGS Pilot Project (RTIGS).
9</p>
10
11<p>
12BNC 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. We used the MinGW Version 5.3.1 compiler to create the Windows binary. It is likely that BNC can be compiled on other systems where a GNU compiler and Qt Version 4.3.2 are installed.
13</p>
14
15<p>
16Please ensure that you have installed the latest version of BNC available from <u>http://igs.bkg.bund.de/index_ntrip_down.htm</u>. We are continuously working on the program and would appreciate if you could send any comments, suggestions, or bug reports to [euref-ip@bkg.bund.de] or [igs-ip@bkg.bund.de].
17</p>
18
19<h3>Contents</h3>
20<p>
21<h4>
22<a href=#purpose>1. Purpose</a><br>
23<a href=#resources>2. Modes & Resources</a><br>
24<a href=#options>3. Options</a><br>
25<a href=#limits>4. Limitations</a><br>
26<a href=#authors>5. Authors</a><br>
27<a href=#annex>8. Annex</a><br>
28</h4>
29</p>
30
31<p><a name="purpose"><h3>1. Purpose</h3></p>
32
33<p> The purpose of BNC is to
34
35<ul>
36<li>retrieve real-time GNSS data streams available through NTRIP transport protocol,</li>
37<li>generate high-rate RINEX Observation and Navigation files to support near real-time GNSS post-processing applications, and/or</li>
38<li>generate ephemeris and synchronized or unsynchronized observations epoch by epoch through an IP port to support real-time GNSS engines, and/or</li>
39<li>generate clock and orbit corrections to broadcast ephemeris through an IP port to support real-time Precise Point Positioning on GNSS rovers, and/or</li>
40<li>generate synchronized clock and orbit corrections to broadcast ephemeris epoch by epoch through an IP port to support the combination of such streams as coming simultaneously from various correction providers, and/or</li>
41<li>monitor the performance of a network of real-time GNSS data streams to generate advisory notes, and/or</li>
42<li>scan RTCM streams for incoming antenna information as well as message types and their repetition rates.</li>
43</ul>
44</p>
45<p>
46BNC supports the following GNSS data formats:
47</p>
48<p>
49<ul>
50<li>RTCM Version 2.x containing message types 18 and 19 or 20 and 21 together with 3 and 22 (GPS and GLONASS), </li>
51<li>RTCM Version 3.x containing message types 1002 (GPS, SBAS) or 1004 (GPS), 1010 or 1012 (GLONASS), 1019 or 1020 (broadcast ephemeris), 4056 and 4057 (premature messages for combined orbit and clock corrections to GPS and GLONASS broadcast ephemeris)</li>
52<li>RTIGS containing GPS record types 200 (observations) and 300 (ephemeris).</li>
53</ul>
54BNC allows to by-pass its decoding and conversion algorithms, leave whatever is received untouched and save it in files.
55</p>
56<p><a name="resources"><h3>2. Modes & Resources</h3></p>
57<p>
58Although BNC is a real-time tool to be operated in online mode, it can be run offline for post processing of data made availabe from a file. Furthermore, apart from its regular window mode, BNC can be run as a batch/background job in a 'no window' mode using processing options from previously saved configuration.
59</p>
60<p>
61Unless in offline mode, BNC
62</p>
63<ul>
64<li>requires 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. You need to make sure that the connection can sustain the required bandwidth.</li>
65<li>requires the clock of the host computer to be properly synchronized.</li>
66<li>has the capacity to retrieve hundreds of GNSS data streams simultaneously. Please be aware that such usage may incur a heavy load on the NTRIP broadcaster side depending on the number of streams requested. We recommend limiting the number of streams where possible to avoid unnecessary workload.</li>
67</ul>
68</p>
69
70<p><a name="options"><h3>3. Options</h3></p>
71<p>
72All options for running BNC on Unix/Linux/Mac systems are saved in file ${HOME}/.config/BKG/BKG_NTRIP_Client.conf, see annexed 'Configuration File' example. On Windows systems options are saved in register BKG_NTRIP_Client. The self-explaining contents of the configuration file or the Windows register can easily be edited. Some options can be changed on-the-fly.
73</p>
74<p>
753.1. <a href=#file>File</a><br>
763.2. <a href=#help>Help</a><br>
773.3. <a href=#proxy>Proxy</a><br>
783.4. <a href=#general>General</a><br>
79&nbsp; &nbsp; &nbsp; 3.4.1. <a href=#genlog>Logfile</a><br>
80&nbsp; &nbsp; &nbsp; 3.4.2. <a href=#genapp>Append Files</a><br>
81&nbsp; &nbsp; &nbsp; 3.4.3. <a href=#reconf>Reread Configuration</a><br>
823.5. <a href=#rinex>RINEX - Observations</a><br>
83&nbsp; &nbsp; &nbsp; 3.5.1. <a href=#rnxname>File Names</a><br>
84&nbsp; &nbsp; &nbsp; 3.5.2. <a href=#rnxdir>Directory</a><br>
85&nbsp; &nbsp; &nbsp; 3.5.3. <a href=#rnxinterval>File Interval</a><br>
86&nbsp; &nbsp; &nbsp; 3.5.4. <a href=#rnxsample>Sampling</a><br>
87&nbsp; &nbsp; &nbsp; 3.5.5. <a href=#rnxskl>Skeleton Extension</a><br>
88&nbsp; &nbsp; &nbsp; 3.5.6. <a href=#rnxscript>Script</a><br>
89&nbsp; &nbsp; &nbsp; 3.5.7. <a href=#rnxvers>Version</a><br>
903.6. <a href=#ephemeris>RINEX - Ephemeris</a><br>
91&nbsp; &nbsp; &nbsp; 3.6.1. <a href=#ephdir>Directory</a><br>
92&nbsp; &nbsp; &nbsp; 3.6.2. <a href=#ephint>Interval</a><br>
93&nbsp; &nbsp; &nbsp; 3.6.3. <a href=#ephport>Port</a><br>
94&nbsp; &nbsp; &nbsp; 3.6.4. <a href=#ephvers>Version</a><br>
953.7. <a href=#syncout>Feed Engine</a><br>
96&nbsp; &nbsp; &nbsp; 3.7.1. <a href=#syncport>Port (synchronized)</a><br>
97&nbsp; &nbsp; &nbsp; 3.7.2. <a href=#syncwait>Wait for Full Epoch</a><br>
98&nbsp; &nbsp; &nbsp; 3.7.3. <a href=#syncuport>Port (unsynchronized)</a><br>
99&nbsp; &nbsp; &nbsp; 3.7.4. <a href=#syncfile>File</a><br>
100&nbsp; &nbsp; &nbsp; 3.7.5. <a href=#syncsample>Sampling</a><br>
1013.8. <a href=#correct>Ephemeris Corrections</a><br>
102&nbsp; &nbsp; &nbsp; 3.8.1. <a href=#corrdir>Directory</a><br>
103&nbsp; &nbsp; &nbsp; 3.8.2. <a href=#corrint>Interval</a><br>
104&nbsp; &nbsp; &nbsp; 3.8.3. <a href=#corrport>Port</a><br>
105&nbsp; &nbsp; &nbsp; 3.8.4. <a href=#corrwait>Wait for Full Epoch</a><br>
1063.9. <a href=#advnote>Monitor</a><br>
107&nbsp; &nbsp; &nbsp; 3.9.1. <a href=#obsrate>Observation Rate</a><br>
108&nbsp; &nbsp; &nbsp; 3.9.2. <a href=#advfail>Failure Threshold</a><br>
109&nbsp; &nbsp; &nbsp; 3.9.3. <a href=#advreco>Recovery Threshold</a><br>
110&nbsp; &nbsp; &nbsp; 3.9.4. <a href=#pause>Pause</a><br>
111&nbsp; &nbsp; &nbsp; 3.9.5. <a href=#advscript>Advisory Script</a><br>
112&nbsp; &nbsp; &nbsp; 3.9.6. <a href=#perflog>Performance Log</a><br>
1133.10. <a href=#messtypes>RTCM Scan</a><br>
114&nbsp; &nbsp; &nbsp; 3.10.1. <a href=#messmount>Mountpoint</a><br>
1153.11. <a href=#mountpoints>Mountpoints</a><br>
116&nbsp; &nbsp; &nbsp; 3.11.1. <a href=#mountadd>Add Mountpoints</a><br>
117&nbsp; &nbsp; &nbsp; 3.11.2. <a href=#mounthost>Broadcaster Host and Port</a><br>
118&nbsp; &nbsp; &nbsp; 3.11.3. <a href=#mountuser>Broadcaster User and Password</a><br>
119&nbsp; &nbsp; &nbsp; 3.11.4. <a href=#mounttable>Get Table</a><br>
120&nbsp; &nbsp; &nbsp; 3.11.5. <a href=#mountdelete>Delete Mountpoints</a><br>
121&nbsp; &nbsp; &nbsp; 3.11.6. <a href=#mountedit>Edit Mountpoints</a><br>
[1234]122&nbsp; &nbsp; &nbsp; 3.11.7. <a href=#mountconf>Reconfigure Mountpoints On-the-fly</a><br>
[1233]1233.12. <a href=#start>Start</a><br>
1243.13. <a href=#stop>Stop</a><br>
1253.14. <a href=#cmd>Command Line Options</a><br>
126&nbsp; &nbsp; &nbsp; 3.14.1. <a href=#nw>No Window Mode</a><br>
127&nbsp; &nbsp; &nbsp; 3.14.2. <a href=#post>Offline Mode</a><br>
128</p>
129
130<p><a name="file"><h4>3.1. File</h4></p>
131
132<p>
133The 'File' button lets you
134<ul>
135<li>
136select an appropriate font.<br>
137Use smaller font size if the BNC main window exceeds the size of your screen.
138</li>
139<li> save selected options in configuration file resp. Windows register.<br>
140When using 'Save & Activate Options' while BNC is already processing data, some configuration options become immediately effective on-the-fly without interrupting uninvolved threads. See annexed section 'Configuration File' for a list of on-the-fly changeable configuration options.
141</li>
142<li>
143quit the BNC program.
144</li>
145</ul>
146</p>
147
148<p><a name="help"><h4>3.2. Help</h4></p>
149
150<p>
151The 'Help' button provides access to
152<ul>
153<li>
154help contents.<br>
155You may keep the 'Help Contents' window open while configuring BNC.
156</li>
157<li>
158a 'Flow Chart' showing BNC linked to a real-time GNSS engine such as RTNet.
159</li>
160<li>
161general information about BNC.<br>
162Close the 'About BNC' window to continue working with BNC.
163</li>
164</ul>
165</p>
166<p>
167BNC 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 disappears 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.
168</p>
169
170<p><a name="proxy"><h4>3.3. Proxy - for usage in a protected LAN</h4></p>
171
172<p>
173If you are running BNC within a protected Local Area Network (LAN), you might need to use a proxy server to access the Internet. 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 the proxy server settings in your Internet browser or ask your network administrator.</p>
174<p>
175Note that IP streaming is often not allowed in a LAN. In this case you need to ask your network administrator for an appropriate modification of the local security policy or for the installation of a TCP relay to the NTRIP broadcasters. If these are not possible, you might need to run BNC outside your LAN on a host that has unobstructed connection to the Internet.
176</p>
177<p><a name="general"><h4>3.4. General</h4></p>
178<p>
179The following defines general settings for BNC's logfile, file handling and reconfiguration on-the-fly.
180</p>
181
182<p><a name="genlog"><h4>3.4.1 Logfile - optional</h4></p>
183<p>
184Records of BNC's activities are shown in the Log section on the bottom of the main window. 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. All times are given in UTC. The default value for 'Log (full path)' is an empty option field, meaning that BNC logs will not saved into a file.
185</p>
186
187<p><a name="genapp"><h4>3.4.2 Append Files - optional</h4></p>
188<p>
189When BNC is started, new files are created by default and any existing files with the same name will be overwritten. However, users might want to append existing files following a restart of BNC, a system crash or when BNC crashed. Tick 'Append files' to continue with existing files and keep what has been recorded so far. Note that option 'Append files' affects all types of files created by BNC.
190</p>
191
192<p><a name="reconf"><h4>3.4.3 Reread Configuration - optional</h4></p>
193<p>
194When operating BNC online in 'no window' mode (command line option -nw), some configuration options can nevertheless be changed on-the-fly without interrupting the running process. For that you force the program to reread parts of its configuration in pre-defined intervals. Select '1 min', '1 hour', or '1 day' to let BNC reread on-the-fly changeable configuration options every full minute, hour, or day. This lets in between edited options become effective without interrupting uninvolved threads. See annexed section 'Configuration File' for a Unix/Linux/Mac configuration file example and a list of on-the-fly changeable options.
195</p>
196
197<p><a name="rinex"><h4>3.5. RINEX - Observations</h4></p>
198<p>
199Observations 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 the 'RINEX TYPE' field in the RINEX Observation file header is always set to 'M(MIXED)' even if the file does not contain any GLONASS or SABAS data.
200</p>
201
202<p><a name="rnxname"><h4>3.5.1 RINEX File Names</h4></p>
203<p>
204RINEX file names are derived by BNC from the first 4 characters of the corresponding mountpoint (4Char Station ID). For example, data from mountpoints FRANKFURT and WETTZELL will have hourly RINEX Observation files named</p>
205<p>
206FRAN{ddd}{h}.{yy}O<br>
207WETT{ddd}{h}.{yy}O
208</p>
209<p>
210where 'ddd' is the day of year, 'h' is a letter which corresponds to an hour long UTC time block and 'yy' is the year.
211</p>
212<p>
213If there are more than one stream with identical 4Char Station ID (same first 4 characters for their mountpoints), the mountpoint strings are split into two sub-strings and both become part of the RINEX file name. For example, when simultaneously retrieving data from mountpoints FRANKFURT and FRANCE, their hourly RINEX Observation files are named as</p>
214<p>
215FRAN{ddd}{h}_KFURT.{yy}O<br>
216FRAN{ddd}{h}_CE.{yy}O.
217</p>
218<p>
219If several streams show exactly the same mountpoint name (example: BRUS0 from <u>www.euref-ip.net</u> and BRUS0 from <u>www.igs-ip.net</u>), BNC adds an integer number to the file name leading i.e. to hourly RINEX Observation files like</p>
220<p>
221BRUS{ddd}{h}_0.{yy}O<br>
222BRUS{ddd}{h}_1.{yy}O.
223</p>
224<p>
225Note that RINEX file names for all intervals less than 1 hour follow the file name convention for 15 minutes RINEX Observation files i.e.</p>
226<p>
227FRAN{ddd}{h}{mm}.{yy}O
228</p>
229<p>
230where 'mm' is the starting minute within the hour.
231</p>
232
233<p><a name="rnxdir"><h4>3.5.2 Directory - optional</h4></p>
234<p>
235Here you can specify the path to where the RINEX Observation files will be stored. If the specified directory does not exist, BNC will not create RINEX Observation files. Default value for 'Directory' is an empty option field, meaning that no RINEX Observation files will be written.
236</p>
237
238<p><a name="rnxinterval"><h4>3.5.3 File Interval - mandatory if 'Directory' is set</h4></p>
239<p>
240Select the length of the RINEX Observation file generated. The default value is 15 minutes.
241</p>
242
243<p><a name="rnxsample"><h4>3.5.4 Sampling - mandatory if 'Directory' is set </h4></p>
244<p>
245Select the RINEX Observation sampling interval in seconds. A value of zero '0' tells BNC to store all received epochs into RINEX. This is the default value.
246</p>
247
248<p><a name="rnxskl"><h4>3.5.5 Skeleton Extension - optional</h4></p>
249<p>
250Whenever 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. A 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 of a public RINEX header skeleton file for the Brussels EPN station.
251</p>
252<p>
253However, sometimes public RINEX header skeleton files are not available, its contents is not up to date, or you need to put additional/optional records in the RINEX header. For that BNC allows using personal skeleton files that contain the header records you would like to include. You can derive a personal RINEX header skeleton file from the information given in an up to date sitelog. A file in the RINEX 'Directory' with a 'Skeleton extension' is interpreted by BNC as a personal RINEX header skeleton file for the corresponding stream.
254</p>
255<p>
256Examples 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>
257<p>
258WETT.skl<br>
259FRAN_KFURT.skl<br>
260FRAN_CE.skl<br>
261BRUS_0.skl<br>
262BRUS_1.skl</p>
263<p>
264if RINEX 'Skeleton extension' is set to 'skl'.
265</p>
266<p>
267Note the following regulations regarding personal RINEX header skeleton files:
268<ul>
269<li>If such a file exists in the 'RINEX directory', the corresponding public RINEX header skeleton file is ignored. The RINEX header is generated solely from the contents of the personal skeleton.</li>
270<li>Personal skeletons should contain a complete first header record of type</li>
271<br>- &nbsp; RINEX VERSION / TYPE
272<li>They should then contain an empty header record of type</li>
273<br>- &nbsp; PGM / RUN BY / DATE
274<br>BNC will complete this line and include it in the actual RINEX file header.
275<li>They should further contain complete header records of type</li>
276<br>- &nbsp; MARKER NAME
277<br>- &nbsp; OBSERVER / AGENCY
278<br>- &nbsp; REC # / TYPE / VERS
279<br>- &nbsp; ANT # / TYPE
280<br>- &nbsp; APPROX POSITION XYZ
281<br>- &nbsp; ANTENNA: DELTA H/E/N
282<br>- &nbsp; WAVELENGTH FACT L1/2
283<li>They may contain any other optional complete header record as defined in the RINEX documentation.</li>
284<li>They should then contain empty header records of type</li>
285<br>- &nbsp; # / TYPES OF OBSERV
286<br>- &nbsp; TIME OF FIRST OBS
287<br>BNC will include these lines in the final RINEX file header together with an additional
288<br>- &nbsp; COMMENT
289<br>line describing the source of the stream.
290<li>They should finally contain an empty header record of type</li>
291<br>- &nbsp; END OF HEADER (last record)
292</ul>
293<p>
294If neither a public nor a personal RINEX header skeleton file is available for BNC, a default header will be used.
295</p>
296
297<p><a name="rnxscript"><h4>3.5.6 Script - optional</h4></p>
298<p>
299Whenever a RINEX Observation file is saved, you might want to compress, copy or upload it immediately via FTP. BNC allows you to execute a script/batch file to carry out these operations. To do that specify the full path of the script/batch file here. BNC will pass the RINEX Observation file path to the script as a command line parameter (%1 on Windows systems, $1 on Unix/Linux/Mac systems).
300</p>
301<p>
302The triggering event for calling the script or batch file is the end of a RINEX Observation file 'Interval'. If that is overridden by a stream outage, the triggering event is the stream reconnection.
303</p>
304<p>
305As an alternative to initiating file uploads through BNC, you may like to call an upload script or batch file through your crontable or Task Scheduler (independent from BNC) once every 2 or 3 minutes after the end of each RINEX file 'Interval'.
306</p>
307
308<p><a name="rnxvers"><h4>3.5.7 Version - optional</h4></p>
309<p>
310The default format for RINEX Observation files is RINEX Version 2.11. Select 'Version 3' if you would like to save observations in RINEX Version 3 format.
311</p>
312
313<p><a name="ephemeris"><h4>3.6. Ephemeris</h4></p>
314<p>
315Broadcast ephemeris can be saved as RINEX Navigation files when received via RTCM Version 3.x as message types 1019 (GPS) and 1020 (GLONASS) or via RTIGS records type 300. The file name convention follows the details given in section 'RINEX File Names' except that the first four characters are 'BRDC' and the last character is
316</p>
317<ul>
318<li>'N' or 'G' for GPS or GLONASS ephemeris in two separate RINEX Version 2.11 Navigation files, or</li>
319<li>'P' for GPS plus GLONASS ephemeris saved together in one RINEX Version 3 Navigation file.
320</ul>
321
322<p><a name="ephdir"><h4>3.6.1 Directory - optional</h4></p>
323<p>
324Specify the path for saving broadcast ephemeris data as RINEX Navigation files. If the specified 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 will be created.
325</p>
326
327<p><a name="ephint"><h4>3.6.2 Interval - mandatory if 'Directory' is set</h4></p>
328<p>
329Select the length of the RINEX Navigation file generated. The default value is 1 day.
330</p>
331
332<p><a name="ephport"><h4>3.6.3 Port - optional</h4></p>
333<p>
334BNC can output broadcast ephemeris in RINEX Version 3 ASCII format on your local host (IP 127.0.0.1) through an IP 'Port'. This function is introduced in order to support i.e. the 'BKG Ntrip Sate Space Server' (BNS) which transforms IGS clocks and orbits into corrections to broadcast ephemeris. Specify an IP port number to activate this function. The default is an empty option field, meaning that no ASCII ephemeris output via IP port is generated.
335</p>
336<p>
337The source code for BNC comes with an example perl script 'test_bnc_eph.pl' that allows you to read BNC's ASCII ephemeris output from the IP port.
338</p>
339
340<p><a name="ephvers"><h4>3.6.4 Version - optional</h4></p>
341<p>
342Default format for RINEX Navigation files containing broadcast ephemeris is RINEX Version 2.11. Select 'Version 3' if you want to save the ephemeris in RINEX Version 3 format.
343</p>
344<p>
345Note that this does not concern the broadcast ephemeris output throug IP port which is always in RINEX Version 3 format.
346</p>
347
348<p><a name="syncout"><h4>3.7. Feed Engine</h4></p>
349<p>
350BNC can generate synchronized or unsynchronized observations epoch by epoch from all stations and satellites to feed a real-time GNSS engine. The output can be produced in a binary format through an IP port and/or a plain ASCII format to save the observations in a local file. It comprises the following observations where available:</p>
351<p>
352StatID, SVPRN, GPSWeek, GPSWeeks, C1, C2, P1, P2, L1, L2, slip_cnt_L1, slip_cnt_L2, lock_timei_L1, lock_timei_L2, S1, S2, SNR1, SNR2
353</p>
354<p>
355Note that slip_cnt stands for the cumulative loss of continuity indicator, lock_timei for the lock time indicator, and SNR for the signal-to-noise ratio 'S' mapped to integer numbers 1 to 9. In case an observation is not available, its value is set to zero '0.000'. Loss of continuity indicator and lock time indicator are set to nedative values if undefined.
356</p>
357
358<p><a name="syncport"><h4>3.7.1 Port (synchronized) - optional</h4></p>
359<p>
360BNC can produce synchronized observations in binary format on your local host (IP 127.0.0.1) through an IP 'Port'. Specify an IP port number here to activate this function. The default is an empty option field, meaning that no binary output is generated.</p>
361<p>The binary output is a continuous stream in the following order:</p>
362<pre>
363begEpoch
364t_obsInternal
365t_obsInternal
366...
367t_obsInternal
368endEpoch
369begEpoch
370t_obsInternal
371...
372</pre>
373
374<p>The corresponding structures are defined as follow:</p>
375<pre>
376 const char begEpoch[] = "BEGEPOCH";
377 const char endEpoch[] = "ENDEPOCH";
378...
379...
380class t_obsInternal {
381 public:
382 int flags;
383 char StatID[20+1]; // Station ID
384 char satSys; // Satellite System ('G' or 'R')
385 int satNum; // Satellite Number (PRN for GPS NAVSTAR)
386 int slot; // Slot Number (for Glonass)
387 int GPSWeek; // Week of GPS-Time
388 double GPSWeeks; // Second of Week (GPS-Time)
389 double C1; // CA-code pseudorange (meters)
390 double C2; // CA-code pseudorange (meters)
391 double P1; // P1-code pseudorange (meters)
392 double P2; // P2-code pseudorange (meters)
393 double L1; // L1 carrier phase (cycles)
394 double L2; // L2 carrier phase (cycles)
395 int slip_cnt_L1; // L1 cumulative loss of continuity indicator (negative value = undefined)
396 int slip_cnt_L2; // L2 cumulative loss of continuity indicator (negative value = undefined)
397 int lock_timei_L1; // L1 last lock time indicator (negative value = undefined)
398 int lock_timei_L2; // L2 last lock time indicator (negative value = undefined)
399 double S1; // L1 signal-to noise ratio
400 double S2; // L2 signal-to noise ratio
401 int SNR1; // L1 signal-to noise ratio (mapped to integer)
402 int SNR2; // L2 signal-to noise ratio (mapped to integer)
403};
404</pre>
405
406<p>
407The source code for BNC comes with an example program called 'test_bnc_qt.cpp' that allows you to read BNC's binary observation output from the IP port and print the observations in a plain ASCII format on standard output.
408</p>
409<p>
410Note that any socket connection of an application to BNC's synchronized observations 'Port' is recorded in the Log section on the bottom of the main window together with a connection counter, leading to log records like 'New Connection # 1'.
411</p>
412
413<p><a name="syncwait"><h4>3.7.2 Wait for Full Epoch - mandatory if 'Port (synchronized)' is set</h4></p>
414<p>
415When feeding a real-time GNSS engine waiting for synchronized input epoch by epoch, BNC drops 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 acceptable for your real-time GNSS product. Default value for 'Wait for full epoch' is 5 seconds.
416</p>
417<p>
418Note that 'Wait for full epoch' does not effect the RINEX Observation file content. Observations received later than 'Wait for full epoch' seconds will still be included in the RINEX Observation files.
419</p>
420
421<p><a name="syncuport"><h4>3.7.3 Port (unsynchronized) - optional</h4></p>
422An application may want to receive unsynchronized observations from reference stations. If so, BNC can produce such unsynchronized observations in binary format on your local host (IP 127.0.0.1) through an IP 'Port'. Specify an IP port number here to activate this function. The default is an empty option field, meaning that no binary unsynchronized output is generated.</p>
423
424<p>
425The example program 'test_bnc_qt.cpp' allows you to read BNC's unsynchronized binary observation output from the IP port and print the observations in a plain ASCII format on standard output.
426</p>
427<p>
428Note that any socket connection of an application to BNC's unsynchronized observations 'Port' is recorded in the Log section on the bottom of the main window together with a connection counter, leading to log records like 'New Connection # 1'.
429</p>
430
431
432<p><a name="syncfile"><h4>3.7.4 File - optional</h4></p>
433<p>
434Specifies the full path to a 'File' where synchronized or unsynchronized observations are saved in plain ASCII format. The default value is an empty option field, meaning that no ASCII output file is created.
435</p>
436<p>
437Beware that the size of this file can rapidly increase depending on the number of incoming streams. This option is primarily meant for testing and evaluation.
438</p>
439
440<p><a name="syncsample"><h4>3.7.5 Sampling - mandatory if 'File' or 'Port' is set</h4></p>
441<p>
442Select the observation output sampling interval in seconds. A value of zero '0' tells BNC to send/store all received epochs. This is the default value.
443<p>
444
445<p><a name="correct"><h4>3.8. Ephemeris Corrections</h4></p>
446<p>
447</p>
448RTCM is in the process of developing new Version 3 messages to transport satellite clock and orbit corrections in real-time. Based on the latest available proposal, the following premature messages currently under discussion have been implemented in BNC:
449<ul>
450<li>Message type 4050: GPS orbit corrections to Broadcast Ephemeris</li>
451<li>Message type 4051: GPS clock corrections to Broadcast Ephemeris</li>
452<li>Message type 4052: GPS code biases</li>
453<li>Message type 4053: GLONASS orbit corrections to Broadcast Ephemeris</li>
454<li>Message type 4054: GLONASS clock corrections to Broadcast Ephemeris</li>
455<li>Message type 4055: GLONASS code biases</li>
456<li>Message type 4056: Combined orbit and clock corrections to GPS Broadcast Ephemeris</li>
457<li>Message type 4057: Combined orbit and clock corrections to GLONASS Broadcast Ephemeris</li>
458</ul>
459<p>
460RTCM Version 3 streams carrying these messages may be used i.e. to support real-time Precise Point Positioning (PPP) applications.
461</p>
462
463<p><a name="corrdir"><h4>3.8.1 Directory - optional</h4></p>
464<p>
465Specify a directory for saving Ephemeris Corrections in files. If the specified directory does not exist, BNC will not create Ephemeris Correction files. Default value for Ephemeris Corrections 'Directory' is an empty option field, meaning that no Ephemeris Correction files will be created.
466</p>
467<p>
468The file name convention for Ephemeris Correction files follows the convention for RINEX files except for the last character of the file name suffix which is set to "C".
469</p>
470
471<p><a name="corrint"><h4>3.8.2 Interval - mandatory if 'Directory' is set</h4></p>
472<p>
473Select the length of the Ephemeris Correction files. The default value is 1 day.
474</p>
475
476<p><a name="corrport"><h4>3.8.3 Port - optional</h4></p>
477<p>
478BNC can output epoch by epoch synchronized Ephemeris Corrections in ASCII format on your local host (IP 127.0.0.1) through an IP 'Port'. Specify an IP port number to activate this function. The default is an empty option field, meaning that no Ephemeris Correction output via IP port is generated.
479</p>
480<p>
481The source code for BNC comes with an example perl script 'test_bnc_eph.pl' that allows you to read BNC's Ephemeris Corrections from the IP port. In case of a stream carrying message types 4056 and 4057, the script produces ASCII records containing the following set of parameters:
482</p>
483<p>
484<ul>
485<li>GPS Week</li>
486<li>Second in GPS Week</li>
487<li>GNSS Indicator and Satellite Vehicle Pseudo Random Number</li>
488<li>IOD refering to Broadcast Ephemeris set</li>
489<li>Clock Correction to Broadcast Ephemeris [m]</li>
490<li>Radial Component of Orbit Correction to Broadcast Ephemeris [m]</li>
491<li>Along-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
492<li>Cross-track Component of Orbit Correction to Broadcast Ephemeris [m]</li>
493<li>Mountpoint</li>
494</ul>
495</p>
496<p>
497The following is an example output from two RTCM Version 3 streams (CLCK1 and CLCK4) containing message types 4056 and 4057:
498<pre>
499...
5001490 115710.0 R17 18 -1.903 2.348 -1.343 -1.403 CLCK1
5011490 115710.0 R10 18 -4.131 2.416 -0.646 -1.054 CLCK1
5021490 115710.0 G27 97 5.291 1.201 -1.964 0.821 CLCK4
5031490 115710.0 G26 14 -11.247 1.003 -1.168 0.074 CLCK4
504...
5051490 115711.0 R17 18 -1.902 2.349 -1.342 -1.403 CLCK1
5061490 115711.0 R10 18 -4.131 2.415 -0.647 -1.052 CLCK1
5071490 115711.0 G27 97 5.288 1.200 -1.964 0.820 CLCK4
5081490 115711.0 G26 14 -11.246 1.004 -1.168 0.074 CLCK4
509...
510</pre>
511</p>
512
513<p><a name="corrwait"><h4>3.8.4 Wait for Full Epoch - mandatory if 'Port' is set</h4></p>
514<p>
515When feeding a real-time GNSS engine waiting epoch by epoch for synchronized Ephemeris Corrections, BNC drops (only concering IP port output) whatever is received later than 'Wait for full epoch' seconds. A value of 2 to 5 seconds could be an appropriate choice for that, depending on the latency of the incoming Ephemeris Corrections stream and the delay acceptable by your application. A message such as "COCK1: Correction overaged by 5 sec" shows up in BNC's logfile if 'Wait for full epoch' is exceeded.
516</p>
517
518<p><a name="advnote"><h4>3.9. Monitor</h4></p>
519
520<p>
521At various times, the incoming stream might become unavailable or corrupted. In such cases, it is important that the BNC operator and/or the stream providers become aware of the situation so that necessary measures can be taken to restore the stream. Furthermore, continuous attempts to decode corrupted stream(s) can generate unnecessary workload for BNC. Outages and corruptions are handled by BNC as follows:
522</p>
523<p>
524<u>Stream outages:</u> BNC considers a connection to be broken when there are no incoming data detected for more than 20 seconds. When this occurs, BNC will attempt to reconnect at a decreasing rate. It will first try to reconnect with 1 second delay, and again in 2 seconds if the previous attempt failed. If the attempt is still unsuccessful, it will try to reconnect within 4 seconds after the previous attempt and so on. The wait time doubles each time with a maximum wait time of 256 seconds.
525</p>
526<p>
527<u>Stream corruption:</u> Not all bits chunk transfers to BNC's internal decoders return valid observations. Sometimes several chunks might be needed before the next observation can be properly decoded. BNC buffers all the outputs (both valid and invalid) from the decoder for a short time span (size derived from the expected 'Observation rate') and then determines whether a stream is valid or corrupted.
528</p>
529<p>
530Outage and corruption events are reported in the Log file/section. They can also be passed on as parameters to a shell script or batch file to generate an advisory note to BNC operator or affected stream providers. This functionality lets users utilise BNC as a real-time performance monitor and alarm system for a network of GNSS reference stations.
531</p>
532
533<p><a name="obsrate"><h4>3.9.1 Observation Rate - mandatory if 'Failure threshold', 'Recovery threshold', 'Pause' and 'Advisory Script' is set</h4></p>
534<p>
535BNC can collect all returns (success or failure) coming from a decoder within a certain short time span to then decide whether a stream has an outage or its content is corrupted. This procedure needs a rough a priory estimate of the expected observation rate of the incoming streams.</p><p>An empty option field (default) means that you don't want an explicit information from BNC about stream outages and incoming streams that can not be decoded and that the special procedure for handling of corrupted streams is by-passed (decoding attempt will never get paused).
536</p>
537
538<p><a name="advfail"><h4>3.9.2 Failure Threshold - optional</h4></p>
539<p>
540Event 'Begin_Failure' will be reported if no data is received continuously for longer than the 'Failure threshold' time. Similarly, event 'Begin_Corrupted' will be reported when corrupted data is detected by the decoder continuously for longer than this 'Failure threshold' time. The default value is set to 15 minutes and is recommended so not to innundate user with too many event reports.
541</p>
542<p>
543Note that specifying a value of zero '0' for the 'Failure threshold' will force BNC to report any stream failure immediately. Note also that for using this function you need to specify the 'Observation rate'.
544</p>
545
546<p><a name="advreco"><h4>3.9.3 Recovery Threshold - optional</h4></p>
547<p>
548Once a 'Begin_Failure' or 'Begin_Corrupted' event has been reported, BNC will check for when the stream again becomes available or uncorrupted. Event 'End_Failure' or 'End_Corrupted' will be reported as soon as valid observations are again detected continuously throughout the 'Recovery threshold' time span. The default value is set to 5 minutes and is recommended so not to innundate users with too many event reports.
549</p>
550<p>
551Note that specifying a value of zero '0' for the 'Recovery threshold' will force BNC to report any stream recovery immediately. Note also that for using this function you need to specify the 'Observation rate'.
552</p>
553
554<p><a name="pause"><h4>3.9.4 Pause - optional</h4></p>
555<p>
556In case of a corrupted stream, the decoding process can be paused and decodings are then attempted again at decreasing rate. BNC will first attempt to decode again after a 30 second lag and if unsuccessful, make another attempt within 60 seconds after the previous attempt. If it is still unsuccessful, it will make another attempt to decode within 120 seconds after the previous attempt and so on. Each decoding attempt doubles the wait time since the previous attempt. The maximum wait time between attempts is limited to 960 seconds. Tick 'Pause' to activate this function. Note that it is only effective if an 'Observation rate' is specified.
557</p>
558<p>
559Do not tick 'Pause' if you want to prevent BNC from making any decoding pause. Be aware that this may incur an unnecessary workload.
560</p>
561
562<p><a name="advscript"><h4>3.9.5 Advisory Script - optional </h4></p>
563<p>
564As mentioned previously, BNC can trigger a shell script or a batch file to be executed when one of the events described are reported. This script can be used to email an advisory note to network operator or stream providers. To enable this feature, specify the full path to the script or batch file in the 'Script' field. The affected mountpoint and type of event reported ('Begin_Outage', 'End_Outage', 'Begin_Corrupted' or 'End_Corrupted') will then be passed on to the script as command line parameters (%1 and %2 on Windows systems or $1 and $2 on Unix/Linux/Mac systems) together with date and time information.
565</p>
566<p>
567Leave the 'Script' field empty if you do not wish to use this option. An invalid path will also disable this option.
568</p>
569<p>
570Examples for command line parameter strings passed on to the advisory 'Script' are:
571<pre>
572FFMJ0 Begin_Outage 08-02-21 09:25:59
573FFMJ0 End_Outage 08-02-21 11:36:02 Begin was 08-02-21 09:25:59
574</pre>
575Sample script for Unix/Linux/Mac systems:
576<pre>
577#!/bin/bash
578sleep $((60*RANDOM/32767))
579cat | mail -s "NABU: $1" email@address &lt;&lt;!
580Advisory Note to BNC User,
581Please note the following advisory received from BNC.
582Stream: $*
583Regards, BNC
584!
585</pre>
586</p>
587<p>
588Note the sleep command in this script which causes the system to wait for a random period of up to 60 seconds before sending the email. This should avoids overloading your mail server in case of a simultaneous failure of many streams.
589</p>
590
591<p><a name="perflog"><h4>3.9.6 Performance Log - optional </h4></p>
592<p>
593<u>Latency:</u> Latency is defined in BNC by the following equation:
594</p>
595<pre>
596 UTC time provided by BNC's host
597 - GPS time of currently processed epoch
598 + Leap seconds between UTC and GPS time
599 --------------
600 = Latency
601</pre>
602<p>
603 BNC can average the latencies per stream over a certain period of GPS time, the 'Performance log' interval. Mean latencies are calculated from the individual latencies of at most one (first incoming) observation or correction to Broadcast Ephemeris per second. Note that computing correct latencies requires the clock of the host computer to be properly synchronized.
604</p>
605<p>
606<u>Statistics:</u> BNC counts the number of GPS seconds covered by at least one observation. It also estimates an observation rate (independent from the a priory specified 'Observation rate') from all observations received throughout the first full 'Performance log' interval. Based on this rate, BNC estimates the number of data gaps when appearing in subsequent intervals.
607</p>
608<p>
609Latencies of observations or corrections to Broadcast Ephemeris and statistical information can be recorded in the Log file/section at the end of each 'Performance log' interval. A typical output from a 1 hour 'Performance log' interval would be:
610</p>
611<pre>
61208-03-17 15:59:47 BRUS0: Mean latency 1.47 sec, min 0.66, max 3.02, rms 0.35, 3585 epochs, 15 gaps
613</pre>
614<p>
615Select a 'Performance log' interval to activate this function or select the empty option field if you do not want BNC to log latencies and statistical information.
616</p>
617
618<p><a name="messtypes"><h4>3.10. RTCM Scan</h4></p>
619<p>
[1235]620When configuring a GNSS receiver for RTCM stream generation, the setup interface may not provide details about RTCM message types. As reliable information concerning stream contents should be available i.e. for NTRIP broadcaster operators to maintain the broadcaster's sourcetable, BNC allows to scan RTCM streams for incoming message types and printout some of the contained meta-data. The idea for this option arose from 'InspectRTCM', a comprehensive stream analyzing tool written by D. Stoecker.
[1233]621</p>
622
623<p><a name="messmount"><h4>3.10.1 Mountpoint - optional</h4></p>
624<p>
[1235]625Specify the mountpoint of an RTCM Version 3.x stream to scan it and log all contained
[1233]626</p>
627<ul>
628<li>numbers of incoming message types</li>
629<li>Antenna Reference Point (ARP) coordinates in ITRF reference system</li>
[1235]630<li>antenna height above ARP</li>
[1233]631<li>antenna descriptor.</li>
632</ul>
633</p>
[1235]634<p>
635Specify the mountpoint of an RTCM Version 2.x stream and the 'RINEX Observations' directory to scan the stream and log the very first incoming
[1233]636</p>
[1235]637<ul>
638<li>Antenna Reference Point (ARP) coordinates</li>
639<li>ECEF corrections to ARP for the L1 Antenna Phase Center (APC)</li>
640<li>ECEF corrections to ARP for the L2 Antenna Phase Center (APC).</li>
641</ul>
642<p>
[1233]643
[1235]644<p>Logged time stamps refer to message reception time and - in case of an RTCM Version 3.x stream - allow to understand repetition rates. Enter 'ALL' if you want to log this information from all configured streams. Beware that the size of the logfile can rapidly increase depending on the number of incoming RTCM streams.
645</p>
646<p>This option is primarily meant for testing and evaluation. Use it to figure out what exactly is produced by a specific GNSS receiver's configuration. An empty option field (default) means that you don't want BNC to print the message type numbers and antenna information carried in RTCM streams.
647</p>
648
[1233]649<p><a name="mountpoints"><h4>3.11. Mountpoints</h4></p>
650<p>
651Each 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.
652</p>
653
654Streams selected for retrieval are listed under the 'Mountpoints' section on BNC's main window. The list provides the following information extracted from source-table(s) produced by the NTRIP broadcasters:
655
656<table>
657<tr></tr>
658<tr><td>'broadcaster:port' &nbsp;</td><td>NTRIP broadcaster URL and port.</td></tr>
659<tr><td>'mountpoint' &nbsp;</td><td>Mountpoint on NTRIP broadcaster.</td></tr>
660<tr><td>'decoder' &nbsp;</td><td>Type of decoder used to handle the incoming stream content according to its format; editable.</td></tr>
661<tr><td>'lat' &nbsp;</td><td>Approximate latitude of reference station, in degrees, north; editable if 'nmea' = 'yes'.</td></tr>
662<tr><td>'long' &nbsp;</td><td>Approximate longitude of reference station, in degrees, east; editable if 'nmea' = 'yes'.</td></tr>
663<tr><td>'nmea' &nbsp;</td><td>Indicates whether or not streaming needs to be initiated by BNC through sending NMEA-GGA message carrying position coordinates in 'lat' and 'long'.</td></tr>
664<tr><td>'bytes' &nbsp;</td><td>Number of bytes retrieved.
665</table>
666
667<p><a name="mountadd"><h4>3.11.1 Add Mountpoints</h4></p>
668<p>
669Button 'Add Mountpoints' opens a window that allows user to select data streams from an NTRIP broadcaster according to their mountpoints.
670</p>
671
672<p><a name="mounthost"><h4>3.11.2 Broadcaster Host and Port - required</h4></p>
673<p>
674Enter 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>.
675</p>
676
677<p><a name="mountuser"><h4>3.11.3 Broadcaster User and Password - required for protected streams</h4></p>
678<p>
679Some 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>.
680</p>
681
682<p><a name="mounttable"><h4>3.11.4 Get Table</h4></p>
683<p>
684Use 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.
685</p>
686<p>
687The contents of data field 'nmea' tells you whether a stream retrieval needs to be initiated by BNC through sending an NMEA-GGA message carrying position coordinates (virtual reference station).
688</p>
689<p>
690Hit 'OK' to return to the main window. If you wish you can click on 'Add Mountpoints' and repeat the process again to retrieve mountpoints from different casters.
691</p>
692
693<p><a name="mountdelete"><h4>3.11.5 Delete Mountpoints</h4></p>
694<p>
695To 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>
696
697<p><a name="mountedit"><h4>3.11.6 Edit Mountpoints</h4></p>
698<ul>
699<li>
700BNC automatically allocates one of its internal decoders to a stream based on the stream's 'format' and 'format-details' as given in the source-table. However, there might be cases where you need to override the automatic selection due to incorrect source-table for example. BNC allows users to manually select the required decoder by editing the decoder string. Double click on the 'decoder' field, enter your preferred decoder and then hit Enter. The accepted decoder strings are 'RTCM_2.x', 'RTCM_3.x', and 'RTIGS'.
701</li>
702<li>
703In case you need to log the raw data as is, BNC allows users to by-pass its decoders and and directly save the input in daily log files. To do this specify the decoder string as 'ZERO'. The generated file names are created from the characters of the mountpoints plus two-digit numbers each for year, month, and day. Example: Setting the 'decoder' string for mountpoint WTZZ0 to 'ZERO' and running BNC on March 29, 2007 would save the raw data in a file named WTZZ0_070329.
704</li>
705<li>
706BNC can also retrieve streams from virtual reference stations (VRS). To initiate these streams, an approximate rover position needs to be sent in NMEA format to the NTRIP broadcaster. In return, a user-specific data stream is generated, typically by a Network-RTK software. This stream is customized to the exact latitude and longitude as shown in the 'lat' and 'long' columns under 'Mountpoints'. These VRS streams are indicated by a 'yes' in the 'nmea' column under 'Mountpoints' as well as in the source-table.
707<br>The default 'lat' and 'long' values are taken from the source-table however in most cases you would probably want to change this according to your requirement. Double-click on 'lat' and 'long' fields, enter the values you wish to send and then hit Enter. The format is in positive north latitude degrees (e.g. for northern hemisphere: 52.436, for southern hemisphere: -24.567) and eastern longitude degrees (example: 358.872 or -1.128). Only mountpoints with a 'yes' in its 'nmea' column can be edited. The position must preferably be a point within the service area of the network. RINEX files generated from these streams will contain an additional COMMENT line in the header beginning with 'NMEA' showing the 'lat' and 'long' used.
708<br>Note that when running BNC in a Local Area Network (LAN), NMEA strings may be blocked by a proxy server, firewall or virus scanner.
709</li>
710</ul>
711
[1234]712<p><a name="mountconf"><h4>3.11.7 Reconfigure Mountpoints On-the-fly</h4></p>
[1233]713<p>
714The mountpoints selection can be changed on-the-fly without interrupting uninvolved threads in the running BNC process.
715</p>
716<p>
717<u>Window mode:</u> Hit 'Save & Activate Options' while BNC is in window mode and already processing data to let changes of your mountpoints selection immediately become effective.
718<p>
719<u>No window mode:</u> When operating BNC online in 'no window' mode (command line option -nw), you force BNC to reread its 'mountPoints' configuration option in pre-defined intervals. Select '1 min', '1 hour', or '1 day' as 'Reread configuration' option to reread the 'mountpoints' option every full minute, hour, or day. This lets a 'mountPoints' option edited in between in the configuration file or Windows register become effective without terminating uninvolved threads. See annexed section 'Configuration File' for a Unix/Linux/Mac configuration file example and a list of other on-the-fly changeable options.
720</p>
721
722<p><a name="start"><h4>3.12. Start</h4></p>
723<p>
724Hit '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.
725</p>
726
727<p><a name="stop"><h4>3.13. Stop</h4></p>
728<p>
729Hit the 'Stop' button in order to stop BNC.
730</p>
731
732<p><a name="cmd"><h4>3.14. Command Line Options</h4></p>
733<p>
734Command 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 (Unix/Linux/Mac) or from the register BKG_NTRIP_Client (Windows). Note that the self-explaining contents of the configuration file or the Windows register can easily be edited.
735</p>
736
737<p><a name="nw"><h4>3.14.1 No Window Mode - optional</h4></p>
738<p>
739Apart 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. Terminate BNC using Windows Task Manager when running it in 'no window' mode on Windows systems.
740</p>
741<p>
742Example:<br><br>
743bnc.exe -nw
744</p>
745
746<p><a name="post"><h4>3.14.2 Offline Mode - optional</h4></p>
747<p>
748Although 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:
749</p>
750<p>
751<ul>
752<li>'--file &#060;<u>file</u>&#062;' to enter the full path to an input <u>file</u> containing data in RTCM Version 2.x, or Version 3.x, or RTIGS/SOC format.</li>
753<li>'--format &#060;<u>format</u>&#062;' to enter one of the file <u>format</u> describing strings 'RTCM_2', 'RTCM_3' or 'RTIGS'.</li>
754<li>'--date YYYY-MM-DD' to enter a date for the first epoch.</li>
755<li>'--time HH:MM:SS' to enter a time for the first epoch.</li>
756</ul>
757<p>
758Example:<br><br>
759./bnc --file FFMJ.dat --format RTCM_3 --date 2008-10-27 --time 23:12:56
760</p>
761<p>
762Note that it is necessary to define a date and time for the first epoch because RTCM streams do not contain complete time stamps as needed for RINEX. Note further that when running BNC in offline mode, it will use options for file saving, interval, sampling etc. from its configuration file.
763</p>
764
765<p><a name="limits"><h3>4. Limitations</h3></p>
766<ul>
767<li>
768In Qt-based desktop environments (like KDE) on Unix/Linux platforms it may happen that you experience a crash of BNC at startup even when running the program in the background using the '-nw' option. This is a known bug most likely resulting from an incompatibility of Qt libraries in the environment and in BNC. Entering the command 'unset SESSION_MANAGER' before running BNC may help as a work-around.
769</li>
770<li>
771Currently BNC only handles GPS, SBAS and GLONASS data. Galileo is not yet supported.
772</li>
773<li>
774BNC currently will only handle C1, C2, P1, P2, L1, L2, S1, and S2 observations. Which observables are available on a particular stream will depend on the setup of source receiver and the data format used. RTCM Version 2.x streams do not carry signal-to-noise ratio 'S' values while RTCM Version 3.x streams can only transport one code observable per frequency. Note that signal-to-noise ratios 'S' are also logged mapped to integer numbers 1 to 9.
775</li>
776<li>
777Using RTCM Version 3.x, BNC will properly handle message types 1002, 1004, 1010, and 1012. Note that when handling message types 1001, 1003, 1009 and 1011 where the ambiguity field is not set, the output will be no valid RINEX. All values will be stored modulo 299792.458 (speed of light).
778</li>
[1246]779Concerning the length of data fields in RTCM Version 3.x premature message types 4056 and 4057 (combined orbit and clock corrections to GPS and GLONASS Broadcast Ephemeris, see RTCM document 026-2008-SC104-429 'Version 1 Proposed SSR Messages prepared by Geo++'). A final decision on his is not yet available. Note the what's implemented in BNC is just a temporary solutions.
[1233]780<li>
781Using RTCM Version 2.x, BNC will only handle message types 18 and 19 or 20 and 21 together with position and the antenna offset information carried in types 3 and 22. Note that processing carrier phase corrections and pseudo-range corrections contained in message types 20 and 21 needs access to broadcast ephemeris. Hence, whenever dealing with message types 20 and 21, make sure that broadcast ephemeris become available for BNC through also retrieving at least one RTCM Version 3.x stream carrying message types 1019 (GPS ephemeris) and 1020 (GLONASS ephemeris).
782</li>
783<li>
784Streams coming in RTIGS format carry only GPS data.
785</li>
786<li>
787BNC's 'Get Table' function only shows the STR records of a source-table. 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 of http://host:port. Data field number 8 in the NET records may provide information about where to register for an NTRIP broadcaster account.
788</li>
789<li>
790EUREF as well as IGS adhere to 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. There is no indication up until now how many users will need to be supported simultaneously. The given situation may develop in such a way that it might become difficult to serve all registered users at the same times. In cases where limited resources on the NTRIP broadcaster side (software restrictions, bandwidth limitation etc.) dictates, first priority in stream provision will be given to stream providers followed by re-broadcasting activities and real-time analysis centers while access to others might be temporarily denied.
791</li>
792<li>
793We experienced a limitation of the Standard Version of Microsoft Windows related to socket communication where sockets are not always handled properly. Since BNC makes intensive use of communication through sockets, we recommend to use the Server Version of Microsoft Windows when running BNC continuously for extended on a Windows platform.
794</li>
795<li>
796The source code provided by NRCan for decoding RTIGS streams is 32-bit dependent. Hence the BNC executable generated for 64-bit Linux systems would only run when compiled using the -m32 compiler option.
797</li>
798<li>
799Once BNC has been started, many of its configuration options can not be changed as long as it is stopped. See chapter 'Reread Configuration' for on-the-fly configuration exceptions.
800</li>
801<br>
802</ul>
803<p><a name="authors"><h3>5. Authors</h3></p>
804<p>
805The 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 includes the following GNU GPL software components:
806<ul>
807<li> RTCM 2.x decoder, written by Oliver Montenbruck, German Space Operations Center, DLR, Oberpfaffenhofen</li>
808<li> RTCM 3.x decoder, written for BKG by Dirk Stoecker, Alberding GmbH, Schoenefeld</li>
809<li> RTIGS decoder, written by Ken MacLeod, Natural Resources, Canada.</li>
810</ul>
811</p>
812<p>
813Georg Weber<br>
814Federal Agency for Cartography and Geodesy (BKG)<br>
815Frankfurt, Germany<br>
816[euref-ip@bkg.bund.de] or [igs-ip@bkg.bund.de]
817</p>
818<p>
819<b>Acknowledgements</b><br>
820BNC's Help Contents has been proofread by Thomas Yan, University of New South Wales, Australia.<br>
821Scott Glazier, OmniSTAR Australia, included the decoding of broadcast ephemeris from RTIGS streams and has been helpful in finding BNC's bugs.<br>
822James Perlt, BKG, helped fixing bugs and redesigned BNC's main window.<br>
823Andre Hauschild, German Space Operations Center, DLR, revised the RTCMv2 decoder.<br>
824Zdenek Lukes, Czech Technical University Prague, Department of Geodesy, extended the RTCMv2 decoder to handle message types 3, 20, 21, and 22 and added loss of lock indicator.<br>
825</p>
826
827<p><a name="annex"><h3>8. Annex</h3></p>
828<p>
8298.1. <a href=#history>History</a><br>
8308.2. <a href=#rtcm>RTCM</a><br>
831&nbsp; &nbsp; &nbsp; 8.2.1 <a href=#ntrip>NTRIP</a><br>
832&nbsp; &nbsp; &nbsp; 8.2.2 RTCM <a href=#rtcm2>Version 2.x</a><br>
833&nbsp; &nbsp; &nbsp; 8.2.3 RTCM <a href=#rtcm3>Version 3.x</a><br>
8348.3. <a href=#rtigs>RTIGS</a><br>
835&nbsp; &nbsp; &nbsp; 8.3.1 <a href=#soc>SOC</a><br>
8368.4. <a href=#config>Configuration File</a><br>
8378.5. <a href=#links>Links</a><br>
838</p>
839
840<p><a name=history><h3>8.1 History</h3></p>
841<table>
842<tr></tr>
843<tr><td>Dec 2006 &nbsp;</td><td>Version 1.0b &nbsp;</td><td>[Add] First Beta Binaries published based on Qt 4.2.3.</td></tr>
844<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>
845<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>
846<tr><td>May 2007 &nbsp;</td><td>Version 1.3 &nbsp;</td><td>[Add] Source code published.
847<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>
848<tr><td>Apr 2008 &nbsp;</td><td>Version 1.5 &nbsp;</td><td>[Add] Handle 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<br> [Bug] RINEX skeleton download following stream outage<br> [Add] Handle ephemeris from RTIGS streams<br> [Add] Monitor stream failure/recovery and latency<br> [Mod] Redesign of main window<br> [Bug] Freezing of About window on Mac systems<br> [Bug] Fixed problem with PRN 32 in RTCMv2 decoder<br> [Bug] Fix for Trimble 4000SSI receivers in RTCMv2 decoder<br> [Mod] Major revision of input buffer in RTCMv2 decoder</td></tr>
[1247]849<tr><td>Dec 2008 &nbsp;</td><td>Version 1.6 &nbsp;</td><td>[Mod] Fill blanc columns in RINEXv3 with 0.000<br> [Add] RTCMv3 decoder for clock and orbit corrections<br>[Add] Check RTCMv3 streams for incoming message types<br> [Add] Decode RTCMv2 message types 3, 20, 21, and 22<br> [Add] Loss of lock and lock time indicator<br> [Bug] Rounding error in RTCMv3 decoder concerning GLONASS height<br> [Mod] Accept GLONASS in RTCMv3 when transmitted first<br> [Add] Leap second 1 January 2009<br> [Add] Offline mode, read data from file<br> [Add] Output antenna descriptor, coordinates and excentricities from RTCMv3<br> [Add] Reconfiguration on-the-fly <br>[Mod] Binary ouput of synchronized observations <br> [Add] Binary output of unsynchronized observations</td></tr>
[1233]850</table>
851</p>
852
853<p><a name="rtcm"><h4>8.2. RTCM</h4></p>
854
855<p>
856The Radio Technical Commission for Maritime Services (RTCM) is an international non-profit scientific, professional and educational organization. Special Committees provide a forum in which governmental and non-governmental 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) are handled by the Special Committee SC 104.
857<p>
858Personal copies of RTCM Recommended Standards can be ordered through <u>http://www.rtcm.org/orderinfo.php</u>.
859</p>
860
861<p><a name="ntrip"><h4>8.2.1 NTRIP</h4></p>
862
863<p>
864'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.
865</p>
866
867<p>
868NTRIP 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.
869</p>
870
871<p>
872NTRIP 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.
873</p>
874
875<p>
876NTRIP is an open none-proprietary protocol. Major characteristics of NTRIP's dissemination technique are:
877<ul>
878<li>Based on the popular HTTP streaming standard; comparatively easy to implement when having limited client and server platform resources available.</li>
879<li>Application not limited to one particular plain or coded stream content; ability to distribute any kind of GNSS data.</li>
880<li>Potential to support mass usage; disseminating hundreds of streams simultaneously for thousands of users possible when applying modified Internet Radio broadcasting software.</li>
881<li>Considering security needs; stream providers and users don't necessarily get into contact, streams often not blocked by firewalls or proxy servers protecting Local Area Networks.</li>
882<li>Enables streaming over mobile IP networks because of using TCP/IP.</li>
883</ul>
884</p>
885
886<p>
887The NTRIP broadcaster maintains a source-table containing information on available NTRIP streams, networks of NTRIP streams and NTRIP broadcasters. The source-table is sent to an NTRIP client on request. Source-table records are dedicated to one of the following: Data Streams (record type STR), Casters (record type CAS), or Networks of streams (record type NET).
888</p>
889
890<p>
891Source-table 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'.
892</p>
893<p>
894Source-table records of type NET contain the following data fields: 'identifiey', 'operator', 'authentication', 'fee', 'web-net', 'web-str', 'web-reg', 'misc'.
895</p>
896<p>
897Source-table records of type CAS contain the following data fields: 'host', 'port', 'identifier', 'operator', 'nmea', 'country', 'latitude', 'longitude', 'misc'.
898</p>
899
900
901<p><a name="rtcm2"><h4>8.2.2 RTCM Version 2.x</h4></p>
902<p>
903Transmitting 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:
904</p>
905
906<ul>
907<li>
908Type 1 message is the range correction message and is the primary message in code-phase differential positioning (DGPS). It is computed in the base receiver by computing the error in the range measurement for each tracked SV.
909</li>
910<li>
911Type 2 message is automatically generated when a new set of satellite ephemeris is downloaded to the base receiver. It is the computed difference between the old ephemeris and the new ephemeris. Type 2 messages are used when the base station is transmitting Type 1 messages.
912</li>
913<li>
914Type 3 and 22 messages are the base station position and the antenna offset. Type 3 and 22 are used in RTK processing to perform antenna reduction.
915</li>
916<li>
917Type 6 message is a null frame filler message that is provided for data links that require continuous transmission of data, even if there are no corrections to send. As many Type 6 messages are sent as required to fill in the gap between two correction messages (type 1). Message 6 is not sent in burst mode.
918</li>
919<li>
920Type 9 message serves the same purpose as Type 1, but does not require a complete satellite set. As a result, Type 9 messages require a more stable clock than a station transmitting Type 1 's, because the satellite corrections have different time references.
921</li>
922<li>
923Type 16 message is simply a text message entered by the user that is transmitted from the base station to the rover. It is used with code-phase differential.
924</li>
925<li>
926Type 18 and 20 messages are RTK uncorrected carrier phase data and carrier phase corrections.
927</li>
928<li>
929Type 19 and 21 messages are the uncorrected pseudo-range measurements and pseudo-range corrections used in RTK.
930</li>
931<li>
932Type 23 message provides the information on the antenna type used on the reference station.
933</li>
934<li>
935Type 24 message carries the coordinates of the installed antenna's ARP in the GNSS coordinate system coordinates.
936</li>
937</ul>
938
939<p><a name="rtcm3"><h4>8.2.3 RTCM Version 3.x</h4></p>
940<p>
941RTCM 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.x standard is intended to correct these weaknesses.
942</p>
943<p>
944RTCM Version 3.x defines a number of message types. Messages that may be of interest here are:
945</p>
946<ul>
947<li>Type 1001, GPS L1 code and phase.</li>
948<li>Type 1002, GPS L1 code and phase and ambiguities and carrier to noise ratio.</li>
949<li>Type 1003, GPS L1 and L2 code and phase.</li>
950<li>Type 1004, GPS L1 and L2 code and phase and ambiguities and carrier to noise ratio.</li>
951<li>Type 1005, Station coordinates XZY for antenna reference point.</li>
952<li>Type 1006, Station coordinates XYZ for antenna reference point and antenna height.</li>
953<li>Type 1007, Antenna descriptor and ID.</li>
954<li>Type 1008, Antenna serial number.</li>
955<li>Type 1009, GLONASS L1 code and phase.</li>
956<li>Type 1010, GLONASS L1 code and phase and ambiguities and carrier to noise ratio.</li>
957<li>Type 1011, GLONASS L1 and L2 code and phase.</li>
958<li>Type 1012, GLONASS L1 and L2 code and phase and ambiguities and carrier to noise ratio.</li>
959<li>Type 1013, Modified julian date, leap second, configured message types and interval.</li>
960<li>Type 1014 and 1017, Network RTK (MAK) messages (under development).</li>
961<li>Type 1019, GPS ephemeris.</li>
962<li>Type 1020, GLONASS ephemeris.</li>
963<li>Type 4088 and 4095, Proprietary messages (under development).
964</li>
965</ul>
966
967<p><a name="rtigs"><h4>8.3. RTIGS</h4></p>
968<p>
969RTIGS 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:
970</p>
971<p>
972Station record number 100<br>
973Observation record (O_T) number 200<br>
974Ephemeris record (E_T) number 300<br>
975Meteorological record (M_T) number 400
976</p>
977<p>
978Every station has one of the following unique numbers:
979</p>
980<p>
9811-99 reserved for JPL<br>
982100-199 reserved for NRCan<br>
983200-299 reserved for NGS<br>
984300-399 reserved for ESOC<br>
985400-499 reserved for GFZ<br>
986500-599 reserved for BKG<br>
987600-699 reserved for GEOSCIENCE AUS<br>
988700-799 others<br>
989etc
990</p>
991<p>
992The number of bytes in each real time message includes the header as well as the data content, but NOT the pointer.
993</p>
994<p>
995For example:
996</p>
997<ul>
998<li>A station message is output once per hour and is 20 bytes.</li>
999<li>An observation message is output once per second. The header is 12 bytes long and the SOC data is 21 bytes per PRN. So a typical RTIGSO_T message will be 390 bytes if 8 sats are being tracked.</li>
1000<li>An ephemeris message is output when the ephemeris is decoded by the GPS receiver. The time in the ephemeris header is the collected time. Only one ephemeris can be bundled in a RTIGSE_T message.<br>
1001A RTIGSE_T message contains one eph. The message consists of 12 header bytes and 72 ephemeris bytes, for a total of 84 bytes.</li>
1002<li>The RTIGSM_T (met) message should be issued once every 15 minutes. A basic met message consists of a 12 byte header and 3 longs (temp, press and relative humidity) for a total of 24 bytes.</li>
1003</ul>
1004<p>
1005All records are related to a station configuration indicated by the Issue of Data Station (IODS). The IODS will enable the user to identify the equipment and software that was used to derive the observation data.
1006</p>
1007<p>
1008Each record header contains the GPS Time in seconds which flows continuously from 6 Jan-1980 onwards.
1009</p>
1010<p>
1011The data payload of each record consists of observations. The structures indicate a pointer to data but in fact the broadcast messages do not contain the pointer, only the data. Users will have to manage the data and the pointer is shown in order to illustrate where the data is located in the message and one possible data management option.
1012</p>
1013<p>
1014All record data are in network byte order (Big Endian), i.e. IA32 users have to swap bytes.
1015</p>
1016<p>
1017Visit <u>http://igscb.jpl.nasa.gov/mail/igs-rtwg/2004/msg00001.html</u> for further details.
1018</p>
1019
1020<p><a name="soc"><h4>8.3.1 SOC</h4></p>
1021<p>
1022The 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.
1023</p>
1024<p>
1025Visit <u>http://gipsy.jpl.nasa.gov/igdg/papers/SOC_FORMAT.ppt</u> for further details.
1026</p>
1027<p>
1028</p>
1029<p><a name="config"><h4>8.4. Configuration File</h4></p>
1030<p>
1031The following is an example for the contents of a Unix/Linux/Mac 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' :
1032<pre>
1033[General]
1034adviseFail=15
1035adviseReco=5
1036adviseScript=
1037binSampl=0
1038casterHost=www.euref-ip.net
1039casterPassword=pass
1040casterPort=80
1041casterUser=user
1042corrIntr=1 day
1043corrPath=
1044corrPort=
1045corrTime=5
1046ephIntr=1 day
1047ephPath=/home/user/rinex
1048ephV3=2
1049logFile=/home/user/log.txt
1050makePause=0
1051mountPoints=//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
1052obsRate=
1053onTheFlyInterval=1 day
1054outEphPort=2102
1055outFile=/home/user/ascii
1056outPort=2101
1057outUPort=
1058perfIntr=
1059proxyHost=proxyhost
1060proxyPort=8001
1061rnxAppend=2
1062rnxIntr=15 min
1063rnxPath=/home/user/rinex
1064rnxSampl=0
1065rnxScript=/home/user/up2archive
1066rnxSkel=SKL
1067rnxV3=2
1068waitTime=5
1069</pre>
1070</p>
1071<p>
1072Note that on Windows systems configuration options are saved in register BKG_NTRIP_Client.
1073</p>
1074<p>
1075Note further that configuration options that can be changed/edited on-the-fly while BNC is already processing data are
1076</p>
1077<p>
1078<ul>
1079<li>'mountPoints' to change the selection of streams to be processed, see section 'Mountpoints',</li>
1080<li>'waitTime' to change the 'Wait for full epoch' option, see section 'Synchronized Observations', and</li>
1081<li>'binSampl' to change the 'Sampling' option, see section 'Synchronized Observations'.</li>
1082</ul>
1083</p>
1084
1085<p><a name="links"><h3>8.5 Links</h3></p>
1086<table>
1087<tr></tr>
1088<tr><td>NTRIP &nbsp;</td><td><u>http://igs.bkg.bund.de/index_ntrip.htm</u></td></tr>
1089<tr><td>EUREF-IP NTRIP broadcaster &nbsp;</td><td><u>http://www.euref-ip.net/home</u></td></tr>
1090<tr><td>IGS-IP NTRIP broadcaster &nbsp;</td><td><u>http://www.igs-ip.net/home</u></td></tr>
1091<tr><td>NTRIP broadcaster overview &nbsp;</td><td><u>http://www.rtcm-ntrip.org/home</u></td></tr>
1092<tr><td>EUREF-IP Project &nbsp;</td><td><u>http://www.epncb.oma.be/euref_IP</u></td></tr>
1093<tr><td>Real-time IGS Pilot Project &nbsp;</td><td><u>http://www.rtigs.net/pilot</u></td></tr>
1094<tr><td>Radio Technical Commission<br>for Maritime Services &nbsp;</td><td><u>http://www.rtcm.org</u>
1095</table>
1096
Note: See TracBrowser for help on using the repository browser.