xref: /freebsd/contrib/ntp/html/drivers/driver31.html (revision 39ee7a7a6bdd1557b1c3532abf60d139798ac88b)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
3<html>
4
5	<head>
6		<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
7		<meta name="GENERATOR" content="Mozilla/4.06 [en] (X11; I; FreeBSD 3.0-CURRENT i386) [Netscape]">
8		<title>Rockwell Jupiter GPS Receiver</title>
9		<link href="../scripts/style.css" type="text/css" rel="stylesheet">
10	</head>
11
12	<body>
13		<h3>Rockwell Jupiter GPS receiver</h3>
14<p>Last update:
15  <!-- #BeginDate format:En2m -->21-Oct-2010  23:44<!-- #EndDate -->
16  UTC</p>
17		<hr>
18		<h4>Synopsis</h4>
19		<p>Address: 127.127.31.<i>u</i><br>
20			Reference ID: <tt>GPS</tt><br>
21			Driver ID: JUPITER<br>
22			Serial Port: <tt>/dev/gps</tt><i>u</i>; &nbsp;9600 baud, 8-bits, no parity.</p>
23		<h4>Description</h4>
24		<p>This driver supports at least some models of the <a href="http://www.navman.com/oem/products/receivers/jupiter/">Rockwell Jupiter <tt>GPS</tt> receivers</a> (Jupiter 11, Jupiter-T), they must at least support the <i>Zodiac Binary Protocol</i>.</p>
25		<p>The driver requires a standard <tt>PPS</tt> interface for the pulse-per-second output from the receiver. The serial data stream alone does not provide precision time stamps, whereas the PPS output is precise down to 40 ns (1 sigma) for the Jupiter 11 and 25 ns (1 sigma) for Jupiter-T according to the documentation. If you do not have the PPS signal available, then you should probably not be using the Jupiter receiver as a time source. This driver requires a <tt>PPS</tt> signal and the time output from Jupiter receivers is not predictable in <tt>NMEA</tt> mode; the reported time can take one second steps.</p>
26		<h4>Monitor Data</h4>
27		<p>The driver always puts a lot of useful information on the clockstats file, and when run with debugging can be quite chatty on stdout. When first starting to use the driver you should definitely review the information written to the clockstats file to verify that the driver is running correctly.</p>
28		<h4>Fudge Factors</h4>
29		<dl>
30			<dt><tt>time1 <i>time</i></tt>
31			<dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0.
32			<dt><tt>time2 <i>time</i></tt>
33			<dd>Not used by this driver. Should be left at zero.
34			<dt><tt>stratum <i>number</i></tt>
35			<dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0.
36			<dt><tt>refid <i>string</i></tt>
37			<dd>Specifies the driver reference identifier, an <tt>ASCII</tt> string from one to four characters, with default <tt>GPS</tt>.
38			<dt><tt>flag1 0 | 1</tt>
39			<dd>Not used by this driver.
40			<dt><tt>flag2 0 | 1</tt>
41			<dd>Specifies the mobility of the <tt>GPS</tt> receiver: 0 for walking (default), 1 for driving.
42			<dt><tt>flag3 0 | 1</tt>
43			<dd>Specifies the <tt>PPS</tt> signal on-time edge: 0 for assert (default), 1 for clear.
44			<dt><tt>flag4 0 | 1</tt>
45			<dd>Not used by this driver.
46		</dl>
47		<h4>Additional Information</h4>
48		<p>The driver was resurrected from a sorry state using the Windows NT port and a Jupiter 11, and has since seen little testing on other platforms. On Windows there exist a barrier though, as there is no publicly available <tt>PPSAPI</tt> implementation, at least not to my knowledge. However, there has been one success report using Linux 2.4.20 and PPSkit 2.1.1.</p>
49		<p>The Jupiter receivers seem to have quite a few names. They are referred to at least as Rockwell receivers, Navman receivers, Zodiac receivers, Conexant receivers and SiRF Technology receivers. Rockwell seems to be the original and most commonly used name and Navman seems to be the current supplier.</p>
50		<p><b>Configuration</b></p>
51		<p>The edge of the <tt>PPS</tt> signal that is `on-time' can be set with <tt>flag2</tt>. There is currently no way to cause the <tt>PPS</tt> signal to control the kernel <tt>PLL</tt>.</p>
52		<p><b>Performance</b></p>
53		<p>The performance is largely unexplored. I have achieved submillisecond stability using a Jupiter 11, but the poor result is more than likely due to the proprietary <tt>PPSAPI</tt> implementation or Windows itself.</p>
54		<p>This driver does not handle leap seconds.</p>
55		<hr>
56		<script type="text/javascript" language="javascript" src="../scripts/footer.txt"></script>
57	</body>
58
59</html>
60
61=
62