Changeset 1746 in ntrip


Ignore:
Timestamp:
Mar 7, 2009, 4:36:57 PM (15 years ago)
Author:
weber
Message:

* empty log message *

Location:
trunk/BNC
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • trunk/BNC/bnchelp.html

    r1743 r1746  
    3636<li>retrieve real-time GNSS data streams available through NTRIP transport protocol,</li>
    3737<li>retrieve real-time GNSS data streams via TCP directly from an IP address without using the NTRIP transport protocol, and/or</li>
     38<li>retrieve real-time GNSS data streams from a serial port without using the NTRIP transport protocol, and/or</li>
    3839<li>generate high-rate RINEX Observation and Navigation files to support near real-time GNSS post-processing applications, and/or</li>
    3940<li>generate ephemeris and synchronized or unsynchronized observations epoch by epoch through an IP port to support real-time GNSS network engines, and/or</li>
     
    4243<li>monitor the performance of a network of real-time GNSS data streams to generate advisory notes, and/or</li>
    4344<li>scan RTCM streams for incoming antenna information as well as message types and their repetition rates, and/or</li>
    44 <li>feed a stream into a GNSS rover via serial communication link.</li>
     45<li>feed a stream into a GNSS receiver via serial communication link.</li>
    4546</ul>
    4647</p>
     
    116117&nbsp; &nbsp; &nbsp; 3.7.4. <a href=#syncfile>File</a><br>
    117118&nbsp; &nbsp; &nbsp; 3.7.5. <a href=#syncuport>Port (unsynchronized)</a><br>
    118 3.8. <a href=#serial>Serial Link</a><br>
     1193.8. <a href=#serial>Serial Output</a><br>
    119120&nbsp; &nbsp; &nbsp; 3.8.1. <a href=#sermount>Mountpoint</a><br>
    120121&nbsp; &nbsp; &nbsp; 3.8.2. <a href=#serport>Port Name</a><br>
    121122&nbsp; &nbsp; &nbsp; 3.8.3. <a href=#serbaud>Baud Rate</a><br>
    122 &nbsp; &nbsp; &nbsp; 3.8.4. <a href=#serparity>Parity</a><br>
    123 &nbsp; &nbsp; &nbsp; 3.8.5. <a href=#serdata>Data Bits</a><br>
    124 &nbsp; &nbsp; &nbsp; 3.8.6. <a href=#serstop>Stop Bits</a><br>
    125 &nbsp; &nbsp; &nbsp; 3.8.7. <a href=#serauto>NMEA</a><br>
    126 &nbsp; &nbsp; &nbsp; 3.8.8. <a href=#serfile>File</a><br>
    127 &nbsp; &nbsp; &nbsp; 3.8.9. <a href=#serheight>Height</a><br>
     123&nbsp; &nbsp; &nbsp; 3.8.4. <a href=#serflow>Flow Control</a><br>
     124&nbsp; &nbsp; &nbsp; 3.8.5. <a href=#serparity>Parity</a><br>
     125&nbsp; &nbsp; &nbsp; 3.8.6. <a href=#serdata>Data Bits</a><br>
     126&nbsp; &nbsp; &nbsp; 3.8.7. <a href=#serstop>Stop Bits</a><br>
     127&nbsp; &nbsp; &nbsp; 3.8.8. <a href=#serauto>NMEA</a><br>
     128&nbsp; &nbsp; &nbsp; 3.8.9. <a href=#serfile>File</a><br>
     129&nbsp; &nbsp; &nbsp; 3.8.10. <a href=#serheight>Height</a><br>
    1281303.9. <a href=#advnote>Outages</a><br>
    129131&nbsp; &nbsp; &nbsp; 3.9.1. <a href=#obsrate>Observation Rate</a><br>
     
    147149&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 3.12.1.5 <a href=#ntripv>NTRIP Version</a><br>
    148150&nbsp; &nbsp; &nbsp; 3.12.2 <a href=#streamip>Add Streams - Coming from TCP/IP Port</a><br>
    149 &nbsp; &nbsp; &nbsp; 3.12.3 <a href=#start>Start</a><br>
    150 &nbsp; &nbsp; &nbsp; 3.12.4 <a href=#stop>Stop</a><br>
     151&nbsp; &nbsp; &nbsp; 3.12.3 <a href=#streamser>Add Streams - Coming from Serial Port</a><br>
     152&nbsp; &nbsp; &nbsp; 3.12.4 <a href=#start>Start</a><br>
     153&nbsp; &nbsp; &nbsp; 3.12.5 <a href=#stop>Stop</a><br>
    1511543.13. <a href=#cmd>Command Line Options</a><br>
    152155&nbsp; &nbsp; &nbsp; 3.13.1. <a href=#nw>No Window Mode</a><br>
     
    572575<p>
    573576
    574 <p><a name="serial"><h4>3.8. Serial Link</h4></p>
    575 <p>
    576 You may use BNC to feed a serial connected device like an GNSS rover. For that one of the incoming streams can be forwarded to a serial port.
     577<p><a name="serial"><h4>3.8. Serial Output</h4></p>
     578<p>
     579You may use BNC to feed a serial connected device like an GNSS receiver. For that one of the incoming streams can be forwarded to a serial port.
    577580</p>
    578581
    579582<p><a name="sermount"><h4>3.8.1 Mountpoint - optional</h4></p>
    580583<p>
    581 Enter a 'Mountpoint' to forward its corresponding stream to a serial connected device.
    582 </p>
    583 <p>
    584 When selecting the serial communication options listed below, make sure that you pick those configured to the serial connected device.
     584Enter a 'Mountpoint' to forward its corresponding stream to a serial connected GNSS receiver.
     585</p>
     586<p>
     587When selecting the serial communication options listed below, make sure that you pick those configured to the serial connected receiver.
    585588</p>
    586589
    587590<p><a name="serport"><h4>3.8.2 Port Name - mandatory if 'Mountpoint' is set</h4></p>
    588591<p>
    589 Enter the serial 'Port name' selected on your host for communication with the serial connected device. Valid port names are
     592Enter the serial 'Port name' selected on your host for communication with the serial connected receiver. Valid port names are
    590593</p>
    591594<pre>
     
    604607<p><a name="serbaud"><h4>3.8.3 Baud Rate - mandatory if 'Mountpoint' is set</h4></p>
    605608<p>
    606 Select a 'Baud rate' for the serial link. Note that using a high baud rate is recommended.
    607 </p>
    608 
    609 <p><a name="serparity"><h4>3.8.4 Parity - mandatory if 'Mountpoint' is set</h4></p>
    610 <p>
    611 Select the 'Parity' for the serial link. Note that parity is often set to 'NONE'.
    612 </p>
    613 
    614 <p><a name="serdata"><h4>3.8.5 Data Bits - mandatory if 'Mountpoint' is set</h4></p>
    615 <p>
    616 Select the number of 'Data bits' for the serial link. Note that often '8' data bits are used.
    617 </p>
    618 
    619 <p><a name="serstop"><h4>3.8.6 Stop Bits - mandatory if 'Mountpoint' is set</h4></p>
    620 <p>
    621 Select the number of 'Stop bits' for the serial link. Note that often '1' stop bit is used.
    622 </p>
    623 
    624 <p><a name="serauto"><h4>3.8.7 NMEA - mandatory for VRS streams</h4></p>
    625 <p>
    626 Select 'Auto' to automatically forward all NMEA-GGA messages coming from your serial connected device to the NTRIP broadcaster and/or save them in a file.
    627 </p>
    628 <p>
    629 Forwarding valid NMEA-GGA messages to the NTRIP broadcaster is required for receiving 'Virtual Reference Station' (VRS) streams. Thus, in case your serial connected device is not capable to provide them, the alternative for VRS streams is a 'Manual' simulation of an initial NMEA-GGA message. Its contents is based on the approximate (editable) latitude/longitude from the broadcaster's source-table and an approximate VRS height to be specified.
    630 </p>
    631 <p>
    632 In summary: select 'Manual' only when handling a VRS stream and your serial connected device doesn't generate NMEA-GGA messages. Otherwise select 'Auto'.
    633 </p>
    634 
    635 <p><a name="serfile"><h4>3.8.8 File - optional if 'Auto' NMEA is set</h4></p>
    636 <p>Specify the full path to a file where NMEA messages coming from your serial connected device are saved.
    637 </p>
    638 <p><a name="serheight"><h4>3.8.9 Height - mandatory if 'Manual' NMEA is set</h4></p>
     609Select a 'Baud rate' for the serial output link. Note that using a high baud rate is recommended.
     610</p>
     611
     612<p><a name="serflow"><h4>3.8.4 Flow Control - mandatory if 'Mountpoint' is set</h4></p>
     613<p>
     614Select a 'Flow control' for the serial output link. Note that your selection must equal the flow control configured to the serial connected device. Select 'OFF' if you don't know better.
     615</p>
     616
     617<p><a name="serparity"><h4>3.8.5 Parity - mandatory if 'Mountpoint' is set</h4></p>
     618<p>
     619Select the 'Parity' for the serial output link. Note that parity is often set to 'NONE'.
     620</p>
     621
     622<p><a name="serdata"><h4>3.8.6 Data Bits - mandatory if 'Mountpoint' is set</h4></p>
     623<p>
     624Select the number of 'Data bits' for the serial output link. Note that often '8' data bits are used.
     625</p>
     626
     627<p><a name="serstop"><h4>3.8.7 Stop Bits - mandatory if 'Mountpoint' is set</h4></p>
     628<p>
     629Select the number of 'Stop bits' for the serial output link. Note that often '1' stop bit is used.
     630</p>
     631
     632<p><a name="serauto"><h4>3.8.8 NMEA - mandatory for VRS streams</h4></p>
     633<p>
     634Select 'Auto' to automatically forward all NMEA-GGA messages coming from your serial connected GNSS receiver to the NTRIP broadcaster and/or save them in a file.
     635</p>
     636<p>
     637Forwarding valid NMEA-GGA messages to the NTRIP broadcaster is required for receiving 'Virtual Reference Station' (VRS) streams. Thus, in case your serial connected receiver is not capable to provide them, the alternative for VRS streams is a 'Manual' simulation of an initial NMEA-GGA message. Its contents is based on the approximate (editable) latitude/longitude from the broadcaster's source-table and an approximate VRS height to be specified.
     638</p>
     639<p>
     640In summary: select 'Manual' only when handling a VRS stream and your serial connected GNSS receiver doesn't generate NMEA-GGA messages. Select 'Auto' otherweise.
     641</p>
     642
     643<p><a name="serfile"><h4>3.8.9 File - optional if 'Auto' NMEA is set</h4></p>
     644<p>Specify the full path to a file where NMEA messages coming from your serial connected receiver are saved.
     645</p>
     646<p><a name="serheight"><h4>3.8.10 Height - mandatory if 'Manual' NMEA is set</h4></p>
    639647<p>
    640648Specify an approximate 'Height' above mean sea level in meter for your VRS to simulate an inital NMEA-GGA message. Latitude and longitude for that (editable) are taken from the broadcaster's source-table.
     
    885893<li>Enter the IP address of the stream providing host.</li>
    886894<li>Enter the IP port number of the stream providing host.</li>
    887 <li>Specify a mountpoint. Recommended is a 4-character reference station ID. Example: FFMJ</li>
     895<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
    888896<li>Specify the stream format. Available options are 'RTCM_2', 'RTCM_3', 'RTIGS', and 'ZERO'.</li>
    889897<li>Enter the approximate latitude of the stream providing rover in degrees. Example: 45.32.</li>
     
    897905Note that this option works only if no proxy server is involved in the communication link.
    898906</p>
     907
     908<p><a name="streamser"><h4>3.12.3 Add Streams - Coming from Serial Port</h4></p>
     909<p>
     910Button 'Add Streams' > 'Coming from Serial Port' allows to retrieve streams from a GNSS receiver via serial port without using the NTRIP transport protocol. For that you:
     911<ul>
     912<li>Specify a mountpoint. Recommended is a 4-character station ID. Example: FFMJ</li>
     913<li>Specify the stream format. Available options are 'RTCM_2', 'RTCM_3', 'RTIGS', and 'ZERO'.</li>
     914<li>Enter the approximate latitude of the stream providing receiver in degrees. Example: 45.32.</li>
     915<li>Enter the approximate longitude of the stream providing receiver in degrees. Example: -15.20.</li>
     916<li>Enter the serial 'Port name' selected on your host for communication with the receiver. Valid port names are
     917<pre>
     918Windows:       COM1, COM2
     919Linux:         /dev/ttyS0, /dev/ttyS1
     920FreeBSD:       /dev/ttyd0, /dev/ttyd1
     921Digital Unix:  /dev/tty01, /dev/tty02
     922HP-UX:         /dev/tty1p0, /dev/tty2p0
     923SGI/IRIX:      /dev/ttyf1, /dev/ttyf2
     924SunOS/Solaris: /dev/ttya, /dev/ttyb
     925</pre>
     926</li>
     927<li>Select a 'Baud rate' for the serial input. Note that using a high baud rate is recommended.</li>
     928<li>Select the number of 'Data bits' for the serial input. Note that often '8' data bits are used.</li>
     929<li>Select the 'Parity' for the serial input. Note that parity is often set to 'NONE'.</li>
     930<li>Select the number of 'Stop bits' for the serial input. Note that often '1' stop bit is used.</li>
     931<li>Select a 'Flow control' for the serial link. Select 'OFF' if you don't know better.</li>
     932</ul>
     933</p>
     934<p>
     935When selecting the serial communication options listed above, make sure that you pick those configured to the serial connected GNSS receiver.
     936</p>
     937
     938<p>
     939Streams received from a serial connected GNSS receiver show up with an 'S' (for <u>S</u>erial Port, no NTRIP) in the 'Streams' canvas section on BNC's main window . Latitude and longitude are to be entered just for informal reasons.
     940<p>
    899941
    900942<p><a name="start"><h4>3.12.3 Start</h4></p>
     
    13161358<tr><td>rnxV3=0</td><td>RINEX Observation: Version 3</td></tr>
    13171359<tr><td>scanRTCM=0</td><td>Miscellaneous: Scan RTCM</td></tr>
    1318 <tr><td>serialAutoNMEA=Auto</td><td>Serial Link: NMEA</td></tr>
    1319 <tr><td>serialBaudRate=9600</td><td>Serial Link: Baud rate</td></tr>
    1320 <tr><td>serialDataBits=8</td><td>Serial Link: Data bits</td></tr>
    1321 <tr><td>serialHeightNMEA=</td><td>Serial Link: Height</td></tr>
    1322 <tr><td>serialMountPoint=</td><td>Serial Link: Mountpoint</td></tr>
    1323 <tr><td>serialParity=NONE</td><td>Serial Link: Parity</td></tr>
    1324 <tr><td>serialPortName=</td><td>Serial Link: Port name</td></tr>
    1325 <tr><td>serialStopBits=1</td><td>Serial Link: Stop bits</td></tr>
     1360<tr><td>serialAutoNMEA=Auto</td><td>Serial Output: NMEA</td></tr>
     1361<tr><td>serialBaudRate=9600</td><td>Serial Output: Baud rate</td></tr>
     1362<tr><td>serialDataBits=8</td><td>Serial Output: Data bits</td></tr>
     1363<tr><td>serialHeightNMEA=</td><td>Serial Output: Height</td></tr>
     1364<tr><td>serialMountPoint=</td><td>Serial Output: Mountpoint</td></tr>
     1365<tr><td>serialParity=NONE</td><td>Serial Output: Parity</td></tr>
     1366<tr><td>serialPortName=</td><td>Serial Output: Port name</td></tr>
     1367<tr><td>serialStopBits=1</td><td>Serial Output: Stop bits</td></tr>
    13261368<tr><td>startTab=0</td><td>Internal memory: Top tab</td></tr>
    13271369<tr><td>waitTime=5</td><td>Feed Engine: Wait for full epoch</td></tr>
  • trunk/BNC/bncserialport.cpp

    r1745 r1746  
    109109  editLayout->addWidget(new QLabel(tr("Longitude")),   1, 2, Qt::AlignRight);
    110110  editLayout->addWidget(_serialLonLineEdit,            1, 3);
    111   editLayout->addWidget(new QLabel(tr("Port")),        2, 0, Qt::AlignRight);
     111  editLayout->addWidget(new QLabel(tr("Port name")),   2, 0, Qt::AlignRight);
    112112  editLayout->addWidget(_serialPortLineEdit,           2, 1);
    113113  editLayout->addWidget(new QLabel(tr("Baud rate")),   2, 2, Qt::AlignRight);
  • trunk/BNC/bncwindow.cpp

    r1739 r1746  
    211211  _outUPortLineEdit   = new QLineEdit(settings.value("outUPort").toString());
    212212
    213   // Serial Link Options
    214   // -------------------
     213  // Serial Output Options
     214  // ---------------------
    215215  _serialMountPointLineEdit = new QLineEdit(settings.value("serialMountPoint").toString());
    216216  _serialPortNameLineEdit = new QLineEdit(settings.value("serialPortName").toString());
     
    353353  _miscMountLineEdit->setWhatsThis(tr("<p>Specify a mountpoint to apply any of the options shown below. Enter 'ALL' if you want to apply these options to all configured streams.</p><p>An empty option field (default) means that you don't want BNC to apply any of these options.</p>"));
    354354  _scanRTCMCheckBox->setWhatsThis(tr("<p>Tick 'Scan RTCM' to log the numbers of incomming message types as well as contained antenna coordinates, antenna heigt, and antenna descriptor.</p>"));
    355   _serialMountPointLineEdit->setWhatsThis(tr("<p>Enter a 'Mountpoint' to forward the corresponding stream to a serial connected device.</p>"));
    356   _serialPortNameLineEdit->setWhatsThis(tr("<p>Enter the serial 'Port name' selected for communication with your serial connected device. Valid port names are</p><pre>Windows:       COM1, COM2<br>Linux:         /dev/ttyS0, /dev/ttyS1<br>FreeBSD:       /dev/ttyd0, /dev/ttyd1<br>Digital Unix:  /dev/tty01, /dev/tty02<br>HP-UX:         /dev/tty1p0, /dev/tty2p0<br>SGI/IRIX:      /dev/ttyf1, /dev/ttyf2<br>SunOS/Solaris: /dev/ttya, /dev/ttyb</pre><p>Note that you must plug a serial cable in the port defined here before you start BNC.</p>"));
    357   _serialBaudRateComboBox->setWhatsThis(tr("<p>Select a 'Baud rate' for the serial link.</p><p>Note that your selection must equal the baud rate configured to the serial connected device. Note further that using a high baud rate is recommended.</p>"));
    358   _serialParityComboBox->setWhatsThis(tr("<p>Select the 'Parity' for the serial link.</p><p>Note that your selection must equal the parity selection configured to the serial connected device. Note further that parity is often set to 'NONE'.</p>"));
    359   _serialDataBitsComboBox->setWhatsThis(tr("<p>Select the number of 'Data bits' for the serial link.</p><p>Note that your selection must equal the number of data bits configured to the serial connected device. Note further that often 8 data bits are used.</p>"));
    360   _serialStopBitsComboBox->setWhatsThis(tr("<p>Select the number of 'Stop bits' for the serial link.</p><p>Note that your selection must equal the number of stop bits configured to the serial connected device. Note further that often 1 stop bit is used.</p>"));
    361   _serialFlowControlComboBox->setWhatsThis(tr("<p>Select a 'Flow control' for the serial link.</p><p>Note that your selection must equal the flow control configured to the serial connected device. Select 'OFF' if you don't know better.</p>"));
    362   _serialAutoNMEAComboBox->setWhatsThis(tr("<p>Select 'Auto' to automatically forward NMEA-GGA messages coming from your serial connected device to the NTRIP broadcaster and/or save them in a file.</p><p>Select 'Manual' only when handling a VRS stream and your serial connected device doesn't generate NMEA-GGA messages.</p>"));
    363   _serialFileNMEALineEdit->setWhatsThis(tr("<p>Specify the full path to a file where NMEA messages coming from your serial connected device are saved.</p>"));
     355  _serialMountPointLineEdit->setWhatsThis(tr("<p>Enter a 'Mountpoint' to forward the corresponding stream to a serial connected receiver.</p>"));
     356  _serialPortNameLineEdit->setWhatsThis(tr("<p>Enter the serial 'Port name' selected for communication with your serial connected receiver. Valid port names are</p><pre>Windows:       COM1, COM2<br>Linux:         /dev/ttyS0, /dev/ttyS1<br>FreeBSD:       /dev/ttyd0, /dev/ttyd1<br>Digital Unix:  /dev/tty01, /dev/tty02<br>HP-UX:         /dev/tty1p0, /dev/tty2p0<br>SGI/IRIX:      /dev/ttyf1, /dev/ttyf2<br>SunOS/Solaris: /dev/ttya, /dev/ttyb</pre><p>Note that you must plug a serial cable in the port defined here before you start BNC.</p>"));
     357  _serialBaudRateComboBox->setWhatsThis(tr("<p>Select a 'Baud rate' for the serial output link.</p><p>Note that your selection must equal the baud rate configured to the serial connected receiver. Note further that using a high baud rate is recommended.</p>"));
     358  _serialParityComboBox->setWhatsThis(tr("<p>Select the 'Parity' for the serial output link.</p><p>Note that your selection must equal the parity selection configured to the serial connected receiver. Note further that parity is often set to 'NONE'.</p>"));
     359  _serialDataBitsComboBox->setWhatsThis(tr("<p>Select the number of 'Data bits' for the serial output link.</p><p>Note that your selection must equal the number of data bits configured to the serial connected receiver. Note further that often 8 data bits are used.</p>"));
     360  _serialStopBitsComboBox->setWhatsThis(tr("<p>Select the number of 'Stop bits' for the serial output link.</p><p>Note that your selection must equal the number of stop bits configured to the serial connected receiver. Note further that often 1 stop bit is used.</p>"));
     361  _serialFlowControlComboBox->setWhatsThis(tr("<p>Select a 'Flow control' for the serial output link.</p><p>Note that your selection must equal the flow control configured to the serial connected receiver. Select 'OFF' if you don't know better.</p>"));
     362  _serialAutoNMEAComboBox->setWhatsThis(tr("<p>Select 'Auto' to automatically forward NMEA-GGA messages coming from your serial connected receiver to the NTRIP broadcaster and/or save them in a file.</p><p>Select 'Manual' only when handling a VRS stream and your serial connected receiver doesn't generate NMEA-GGA messages.</p>"));
     363  _serialFileNMEALineEdit->setWhatsThis(tr("<p>Specify the full path to a file where NMEA messages coming from your serial connected receiver are saved.</p>"));
    364364  _serialHeightNMEALineEdit->setWhatsThis(tr("<p>Specify an approximate 'Height' above mean sea level in meter for your VRS to simulate an inital NMEA-GGA message.</p><p>The setting of this option is ignored in case of streams coming from physical reference stations.</p>"));
    365365
     
    385385  aogroup->addTab(cgroup,tr("Broadcast Corrections"));
    386386  aogroup->addTab(sgroup,tr("Feed Engine"));
    387   aogroup->addTab(sergroup,tr("Serial Link"));
     387  aogroup->addTab(sergroup,tr("Serial Output"));
    388388  aogroup->addTab(agroup,tr("Outages"));
    389389  aogroup->addTab(rgroup,tr("Miscellaneous"));
     
    573573  }
    574574
    575   // Serial Link
    576   // -----------
     575  // Serial Output
     576  // -------------
    577577  QGridLayout* serLayout = new QGridLayout;
    578578  serLayout->setColumnMinimumWidth(0,14*ww);
     
    605605  serLayout->addWidget(new QLabel("Height"),                      4,20, Qt::AlignRight);
    606606  serLayout->addWidget(_serialHeightNMEALineEdit,                 4,21,1,11);
    607   serLayout->addWidget(new QLabel("Serial port settings to feed a serial connected device."),5,0,1,30);
     607  serLayout->addWidget(new QLabel("Serial port settings to feed a serial connected receiver."),5,0,1,30);
    608608
    609609  connect(_serialMountPointLineEdit, SIGNAL(textChanged(const QString &)),
     
    14151415  }
    14161416
    1417   // Serial Link
    1418   // -----------
     1417  // Serial Output
     1418  // -------------
    14191419  if (aogroup->currentIndex() == 6) {
    14201420    if (!isEmpty) {
Note: See TracChangeset for help on using the changeset viewer.