----------------------------------------------------------------------
                  Ntrip Server Perl, Version 0.2
----------------------------------------------------------------------

(c) German Federal Agency for Cartography and Geodesy (BKG), 2002-2004

Files in NtripServerPerl.zip
-----------------------------
ReadmeServerPerl.txt:  Readme file for NtripServerPerl
NtripServerPerl:       Perl script
NtripServerPerl.conf:  Configuration file for NtripServerPerl
StartNtripServerPerl:  Shell script to start NtripServerPerl
NtripProvider.doc:     Server password/mountpoit request form
SiteLogExample.txt:    Example Station Logfile

Ntrip
-----
NtripServerPerl is a server perl script based on Networked Transport 
of RTCM via Internet Protocol (Ntrip). This is 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.

Ntrip is 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.

Ntrip is implemented in three system software components:
NtripClients, NtripServers and NtripCasters. The NtripCaster is the
actual HTTP server program whereas NtripClient and NtripServer are
acting as HTTP clients.

NtripServerPerl
----------------
The script NtripServerPerl is designed to provide real-time data
from a single NtripSource. Basically the NtripServerPerl grabs a GNSS
byte stream from standard input and sends it off over an
Internet TCP connection to the NtripCaster.

Mind that the NtripServerPerl script may not be able to handle your
proxyserver. When using it in a proxy-protected Local Area Network
(LAN), a TCP-relay may have to be established connecting the
proxyserver and the NtripCaster. Establishing the Internet connection
for an NtripServerPerl script by using an Internet Service Provider
(ISP) is an alternative. 

Installation
------------
To install the NtripServerPerl script unzip the archive and copy files
NtripServerPerl, NtripServerPerl.conf, and StartNtripServerPerl into
a separate directory. The configuration file NtripServerPerl.conf
allows to define an NtripCaster IP address, port number, and server
password.

Usage
-----
You may call the NtripServerPerl script with the following options:
        -h     For a short help
        -c     Configuration file
        -v     Version

Example:
NtripServerPerl -c NtripServerPerl.conf

It is recommended to start NtripServerPerl through shell script
StartNtripServerPerl. This shell script ensures that
NtripServerPerl reconnects to the NtripCaster after a broken
connection.  Note that you may need to adjust the COM port
settings in StartNtripServerPerl when reading data from a 
serial port.

NtripCaster IP address
----------------------
The current Internet address of the Ntrip Broadcaster which has to be
introduced in the NtripServerPerl.conf configuration file is
"213.20.239.197". The port number is "80" or "2101".

Server password and mountpoint
------------------------------
Feeding data streams into the Ntrip system using the NtripServerPerl
scripts needs a server password and one mountpoint per stream.
Currently this is available from euref-ip@bkg.bund.de
(see "NtripProvider.doc").

Station Logfile
---------------
A user of your data stream may need detailed information about the
GNSS hardware and firmware that generates your signal. This
information will be made available through a station logfile. Please
find an example station logfile in "SiteLogExample.txt". Create a
similar logfile describing your GNSS receiver hardware and firmware
and include the requested information as far as it is available for
you. Note that the form of this document follows an IGS
recommendatation that can be downloaded from
ftp://igscb.jpl.nasa.gov/pub/station/general/sitelog_instr.txt
The content of your station logfile has to be kept up to date.
Thus, please inform the NtripCaster operator about all changes at
your station by sending an updates version of your station logfile.
Providing a station logfile is not necessary in case you generate
a Virtual Reference Station (VRS) data stream.

Disclaimer
----------
Note that this example server implementation is currently an
experimental software. The BKG disclaims any liability nor
responsibility to any person or entity with respect to any loss or
damage caused, or alleged to be caused, directly or indirectly by the
use and application of the Ntrip technology.

Further information
-------------------
http://igs.ifag.de/index_ntrip.htm
euref-ip@bkg.bund.de
