| 1 | ----------------------------------------------------------------------
|
|---|
| 2 | NTRIP Client for Linux/Unix Version
|
|---|
| 3 | ----------------------------------------------------------------------
|
|---|
| 4 |
|
|---|
| 5 | Easy example NTRIP client for Linux/Unix.
|
|---|
| 6 | Copyright (C) 2003-2007 by Dirk Stoecker <soft@dstoecker.de>
|
|---|
| 7 |
|
|---|
| 8 | This program is free software; you can redistribute it and/or modify
|
|---|
| 9 | it under the terms of the GNU General Public License as published by
|
|---|
| 10 | the Free Software Foundation; either version 2 of the License, or
|
|---|
| 11 | (at your option) any later version.
|
|---|
| 12 |
|
|---|
| 13 | This program is distributed in the hope that it will be useful,
|
|---|
| 14 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 16 | GNU General Public License for more details.
|
|---|
| 17 |
|
|---|
| 18 | You should have received a copy of the GNU General Public License
|
|---|
| 19 | along with this program; if not, write to the Free Software
|
|---|
| 20 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|---|
| 21 | or read http://www.gnu.org/licenses/gpl.txt
|
|---|
| 22 |
|
|---|
| 23 | Files in NtripLinuxClient.zip
|
|---|
| 24 | -----------------------------
|
|---|
| 25 | NtripLinuxClient.c: Ntrip Linux/UNIX client source code
|
|---|
| 26 | ReadmeLinuxClient.txt: Readme file for 'NtripLinuxClient'
|
|---|
| 27 | StartNtripLinuxClient: Shell script to start 'NtripLinuxClient'
|
|---|
| 28 | makefile: Easy makefile to build source
|
|---|
| 29 |
|
|---|
| 30 | Ntrip
|
|---|
| 31 | -----
|
|---|
| 32 | The NtripLinuxClient is an HTTP client based on 'Networked Transport
|
|---|
| 33 | of RTCM via Internet Protocol' (Ntrip). This is an application-level
|
|---|
| 34 | protocol streaming Global Navigation Satellite System (GNSS) data over
|
|---|
| 35 | the Internet. Ntrip is a generic, stateless protocol based on the
|
|---|
| 36 | Hypertext Transfer Protocol HTTP/1.1. The HTTP objects are enhanced
|
|---|
| 37 | to GNSS data streams.
|
|---|
| 38 |
|
|---|
| 39 | Ntrip is designed for disseminating differential correction data
|
|---|
| 40 | (e.g in the RTCM-104 format) or other kinds of GNSS streaming data to
|
|---|
| 41 | stationary or mobile users over the Internet, allowing simultaneous PC,
|
|---|
| 42 | Laptop, PDA, or receiver connections to a broadcasting host. Ntrip
|
|---|
| 43 | supports Wireless Internet access through Mobile IP Networks like GSM,
|
|---|
| 44 | GPRS, EDGE, or UMTS.
|
|---|
| 45 |
|
|---|
| 46 | Ntrip is implemented in three system software components: NtripClients,
|
|---|
| 47 | NtripServers and NtripCasters. The NtripCaster is the actual HTTP
|
|---|
| 48 | server program whereas NtripClient and NtripServer are acting as HTTP
|
|---|
| 49 | clients.
|
|---|
| 50 |
|
|---|
| 51 | NtripLinuxClient
|
|---|
| 52 | ----------------
|
|---|
| 53 | This Linux/UNIX NtripClient program is written under GNU General Public
|
|---|
| 54 | License in C programming language. The program reads data from an Ntrip
|
|---|
| 55 | Broadcaster and writes on standard output for further redirection
|
|---|
| 56 | of data to a file or COM-port. PLEASE NOTE THAT THIS PROGRAM VERSION
|
|---|
| 57 | DOES NOT HANDLE POTENTIALLY OCCURRING INTERRUPTIONS OF COMMUNICATION
|
|---|
| 58 | OR NETWORK CONGESTION SITUATIONS. Its distribution may stimulate
|
|---|
| 59 | those intending to write their own client program.
|
|---|
| 60 |
|
|---|
| 61 | Call the program with following arguments:
|
|---|
| 62 |
|
|---|
| 63 | NtripLinuxClient -d mountpoint
|
|---|
| 64 | -s Ntrip Broadcaster IP adress
|
|---|
| 65 | -p password
|
|---|
| 66 | -r Ntrip Broadcaster Port number
|
|---|
| 67 | -u username
|
|---|
| 68 | -n NMEA string for sending to server
|
|---|
| 69 | -b output bitrate
|
|---|
| 70 |
|
|---|
| 71 | or using an URL:
|
|---|
| 72 | ./NtripLinuxClient ntrip:mountpoint[/username[:password]][@server[:port]][;nmea]
|
|---|
| 73 |
|
|---|
| 74 |
|
|---|
| 75 | The argument '-h' will cause a HELP on the screen.
|
|---|
| 76 | Without any argument NtripLinuxClient will provide the a table of
|
|---|
| 77 | available resources (source table).
|
|---|
| 78 |
|
|---|
| 79 | Compilation/Installation
|
|---|
| 80 | ------------------------
|
|---|
| 81 | Please unzip the archive and copy its contents into an appropriate
|
|---|
| 82 | directory. Compile the source code under Linux through entering e.g.
|
|---|
| 83 | the command 'cc -o NtripLinuxClient NtripLinuxClient.c'.
|
|---|
| 84 |
|
|---|
| 85 | Registration
|
|---|
| 86 | ------------
|
|---|
| 87 | Some of the data streams (mountpoints) from an NtripCaster may be
|
|---|
| 88 | available for test, demonstration, and evaluation purposes and
|
|---|
| 89 | accessible without authentication/authorization. For accessing other
|
|---|
| 90 | data streams (mountpoints) the user needs a user-ID and a
|
|---|
| 91 | user password. Authorization can be provided for a single stream,
|
|---|
| 92 | for a group of streams (network) or for all available streams.
|
|---|
| 93 | Currently, registration can be requested via the registration form
|
|---|
| 94 | on http://igs.ifag.de/ntrip/ntrip_register.htm.
|
|---|
| 95 |
|
|---|
| 96 | Ntrip Broadaster Address and Port
|
|---|
| 97 | ---------------------------------
|
|---|
| 98 | The current Internet address of the Ntrip Broadcaster is
|
|---|
| 99 | www.euref-ip.net. The port number is 80.
|
|---|
| 100 |
|
|---|
| 101 | Disclaimer
|
|---|
| 102 | ----------
|
|---|
| 103 | Note that this NtripLinuxClient program is for experimental use
|
|---|
| 104 | only. The BKG disclaims any liability nor responsibility to any
|
|---|
| 105 | person or entity with respect to any loss or damage caused, or alleged
|
|---|
| 106 | to be caused, directly or indirectly by the use and application of the
|
|---|
| 107 | Ntrip technology.
|
|---|
| 108 |
|
|---|
| 109 | Further Information
|
|---|
| 110 | -------------------
|
|---|
| 111 | http://igs.ifag.de/index_ntrip.htm
|
|---|
| 112 | euref-ip@bkg.bund.de
|
|---|
