source: ntrip/trunk/ntripclient/ReadmeLinuxClient.txt@ 466

Last change on this file since 466 was 466, checked in by stoecker, 17 years ago

updated release stuff

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