driver29.html revision 280849
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 <title>Trimble Palisade and Thunderbolt Receivers</title> 8 <link href="scripts/style.css" type="text/css" rel="stylesheet"> 9 </head> 10 11 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 12 <h1><font size="+2">Trimble Palisade and Thunderbolt Receivers</font> 13<p>Last update: 14 <!-- #BeginDate format:En2m -->21-Oct-2010 23:44<!-- #EndDate --> 15 UTC</p> 16 <hr> 17 </h1> 18 <table> 19 <tr> 20 <td> 21 <h2><img src="../pic/driver29.gif" alt="gif" nosave height="100" width="420"></h2> 22 </td> 23 <td> 24 <h2><img src="../pic/thunderbolt.jpg" alt="jpg" nosave height="270" width="420"></h2> 25 </td> 26 </tr> 27 </table> 28 <h2><font size="+1">Synopsis</font></h2> 29 <table> 30 <tr> 31 <td> 32 <div align="right"> 33 <tt>Address: </tt></div> 34 </td> 35 <td><b>127.127.29.<i>u</i></b></td> 36 </tr> 37 <tr> 38 <td> 39 <div align="right"> 40 <tt>Reference ID:</tt></div> 41 </td> 42 <td><a name="REFID"></a><b>GPS</b></td> 43 </tr> 44 <tr> 45 <td> 46 <div align="right"> 47 <tt>Driver ID:</tt></div> 48 </td> 49 <td><b>GPS_PALISADE</b></td> 50 </tr> 51 <tr> 52 <td> 53 <div align="right"> 54 <tt>Serial Port:</tt></div> 55 </td> 56 <td><b>/dev/palisade<i>u</i></b></td> 57 </tr> 58 <tr> 59 <td> 60 <div align="right"> 61 <tt><font size="+1">Serial I/O:</font></tt></div> 62 </td> 63 <td><b>9600 baud, 8-bits, 1-stop, odd parity</b></td> 64 </tr> 65 <tr> 66 <td> 67 <div align="right"> 68 <tt><font size="+1">Serial I/O (Thunderbolt):</font></tt></div> 69 </td> 70 <td><b>9600 baud, 8-bits, 1-stop, no parity</b></td> 71 </tr> 72 </table> 73 <h2><font size="+1">Description</font></h2> 74 The <b>refclock_palisade</b> driver supports <a href="http://www.trimble.com/products/ntp">Trimble Navigation's Palisade Smart Antenna GPS receiver</a>.<br> 75 Additional software and information about the Palisade GPS is available from: <a href="http://www.trimble.com/oem/ntp">http://www.trimble.com/oem/ntp</a>.<br> 76 Latest NTP driver source, executables and documentation is maintained at: <a href="ftp://ftp.trimble.com/pub/ntp">ftp://ftp.trimble.com/pub/ntp</a> 77 <p>This documentation describes version 7.12 of the GPS Firmware and version 2.46 (July 15, 1999) and later, of the driver source.<br> </p> 78 <p>This documentation describes version 1 of the Thunderbolt Receiver Firmware, no tests have been made on further firmwares, please read "Notes on the Thunderbolt Receiver's Firmware" at the end of this documentation for more information.</p> 79 <h2><font size="+1">Operating System Compatibility</font></h2> 80 The Palisade driver has been tested on the following software and hardware platforms:<br> 81 <center> 82 <table> 83 <tr> 84 <td valign="CENTER" width="23%">Platform</td> 85 <td valign="CENTER">Operating System</td> 86 <td>NTP Sources</td> 87 <td>Accuracy</td> 88 </tr> 89 <tr> 90 <td valign="CENTER" width="23%">i386 (PC) </td> 91 <td valign="CENTER">Linux</td> 92 <td>NTP Distribution</td> 93 <td>10 us</td> 94 </tr> 95 <tr> 96 <td>i386 (PC) </td> 97 <td>Windows NT</td> 98 <td><a href="ftp://ftp.trimble.com/pub/ntp">ftp://ftp.trimble.com/pub/ntp</a></td> 99 <td>1 ms</td> 100 </tr> 101 <tr> 102 <td valign="CENTER" width="23%">SUN</td> 103 <td valign="CENTER">Solaris 2.x</td> 104 <td>NTP Distribution</td> 105 <td>50 us</td> 106 </tr> 107 <tr> 108 <td valign="CENTER" width="23%">Hewlett-Packard</td> 109 <td valign="CENTER">HPUX 9, 10, 11</td> 110 <td><a href="http://us-support.external.hp.com">http://us-support.external.hp.com</a></td> 111 <td>50 us</td> 112 </tr> 113 <tr> 114 <td>Various</td> 115 <td>Free BSD</td> 116 <td>NTP Distribution</td> 117 <td>20 us</td> 118 </tr> 119 </table> 120 </center><P> 121 <b>Attention</b>: Thunderbolt Receiver has not being tested on the previous software and hardware plataforms. 122 <h2><font size="+1">GPS Receiver</font></h2> 123 The Palisade GPS receiver is an 8-channel smart antenna, housing the GPS receiver, antenna and interface in a single unit, and is designed for rooftop deployment in static timing applications. 124 <p>Palisade generates a PPS synchronized to UTC within +/- 100 ns. The Palisade's external event input with 40 nanosecond resolution is utilized by the Palisade NTP driver for asynchronous precision time transfer.</p> 125 <p>No user initialization of the receiver is required. This driver is compatible with the following versions of Palisade:<br> </p> 126 <center> 127 <table> 128 <tr> 129 <td valign="CENTER"> 130 <center> 131 Version</center> 132 </td> 133 <td valign="TOP"> 134 <center> 135 Event Input</center> 136 </td> 137 <td valign="CENTER"> 138 <center> 139 Trimble Part Number</center> 140 </td> 141 </tr> 142 <tr> 143 <td valign="CENTER"> 144 <center> 145 7.02</center> 146 </td> 147 <td valign="TOP"> 148 <center> 149 No</center> 150 </td> 151 <td valign="CENTER"> 152 <center> 153 26664-00</center> 154 </td> 155 </tr> 156 <tr> 157 <td align="CENTER" valign="CENTER"> 158 <center> 159 7.02E</center> 160 </td> 161 <td valign="TOP"> 162 <center> 163 Yes</center> 164 </td> 165 <td valign="CENTER"> 166 <center> 167 26664-10</center> 168 </td> 169 </tr> 170 <tr> 171 <td valign="CENTER"> 172 <center> 173 7.12</center> 174 </td> 175 <td valign="TOP"> 176 <center> 177 Yes</center> 178 </td> 179 <td valign="CENTER"> 180 <center> 181 38158-00</center> 182 </td> 183 </tr> 184 </table> 185 </center> 186 <dl> 187 <dl> 188 Note: When using Palisade 26664-00, you must set fudge flag2 to 1 in <b>ntp.conf</b>. See <a href="#Configuration">configuration</a>. 189 </dl> 190 <dl> 191 <h3><font size="+1">GPS <a name="Installation"></a>Installation</font></h3> 192 A location with unobstructed view of the horizon is recommended. Palisade is designed to be securely mounted atop standard 3/4 inch threaded pipe. 193 <p>The 12 conductor (dia. 10 mm) power and I/O cable must be routed from the rooftop site to the NTP server and properly strain relieved.</p> 194 <h3><font size="+1">GPS <a name="Connection"></a>Connection</font></h3> 195 The Palisade is equipped with dual (A & B) RS-422 serial interfaces and a differential TTL PPS output. An RS-232 / RS-422 Interface Module is supplied with the Palisade NTP Synchronization Kit. Palisade <a href="#PortA">port A</a> must be connected to the NTP host server. Maximum antenna cable length is 500 meters. See the <a href="#Pinouts">pinouts</a> table for detailed connection Information. 196 <p>Palisade's <a href="#PortB">port B</a> provides a TSIP (Trimble Standard Interface Protocol) interface for diagnostics, configuration, and monitoring. Port B and the PPS output are not currently used by the Palisade NTP reference clock driver.<br> </p> 197 </dl> 198 </dl> 199 <h2><font size="+1">O/S Serial Port Configuration</font></h2> 200 The driver attempts to open the device <b><tt><a href="#REFID">/dev/palisade<i>u</i></a></tt></b> where <b><i>u</i></b> is the NTP refclock unit number as defined by the LSB of the refclock address. Valid refclock unit numbers are 0 - 3. 201 <p>The user is expected to provide a symbolic link to an available serial port device. This is typically performed by a command such as:</p> 202 <blockquote> 203 <tt>ln -s /dev/ttyS0 /dev/palisade0</tt></blockquote> 204 Windows NT does not support symbolic links to device files. COM<b>x</b>: is used by the driver, based on the refclock unit number, where unit 1 corresponds to COM<b>1</b>: and unit 3 corresponds to COM3:<br> 205 <h2><a name="Configuration"></a><font size="+1">NTP Configuration</font></h2> 206 Palisade NTP configuration file <b><tt>"ntp.conf"</tt></b> with event polling:<br> 207 <tt>#------------------------------------------------------------------------------</tt><br> 208 <tt># The Primary reference</tt><br> 209 <tt>server 127.127.29.0 # Trimble Palisade GPS Refclock Unit #0</tt><br> 210 <tt>peer terrapin.csc.ncsu.edu # internet server</tt><br> 211 <tt># Drift file for expedient re-synchronization after downtime or reboot.</tt><br> 212 <tt>driftfile /etc/ntp.drift</tt><br> 213 <tt>#------------------------------------------------------------------------------</tt> 214 <p>Configuration without event polling:<br> 215 <tt>#------------------------------------------------------------------------------</tt><br> 216 <tt># The Primary reference</tt><br> 217 <tt>server 127.127.29.0 # Trimble Palisade GPS (Stratum 1).</tt><br> 218 <tt># Set packet delay</tt><br> 219 <tt><a href="#time1">fudge 127.127.29.0 time1 0.020</a></tt><br> 220 <tt># and set flag2 to turn off event polling.</tt><br> 221 <tt><a href="#flag2">fudge 127.127.29.0 flag2 1</a></tt><br> 222 <tt>#------------------------------------------------------------------------------</tt><br> </p> 223 224 <h4>Thunderbolt NTP Configuration file</h4> 225 <tt>#------------------------------------------------------------------------------</tt> 226 <p>Configuration without event polling:<br> 227 <tt>#------------------------------------------------------------------------------</tt><br> 228 <tt># The Primary reference</tt><br> 229 <tt>server 127.127.29.0 mode 2 # Trimble Thunderbolt GPS (Stratum 1).</tt><br> 230 <tt># Set packet delay</tt><br> 231 <tt><a href="#time1">fudge 127.127.29.0 time1 0.020</a></tt><br> 232 <tt># and set flag2 to turn off event polling.</tt><br> 233 <tt><a href="#flag2">fudge 127.127.29.0 flag2 1</a></tt><br> 234 <tt>#------------------------------------------------------------------------------</tt><br> </p> 235 Currently the Thunderbolt mode doesn't support event polling, the reasons are explained on the "Notes on the Thunderbolt Receiver's Firmware" section at the end of this documentation. 236 <h2><a name="TimeTransfer"></a><font size="+1">Time Transfer and Polling</font></h2> 237 Time transfer to the NTP host is performed via the Palisade's comprehensive time packet output. The time packets are output once per second, and whenever an event timestamp is requested. 238 <p>The driver requests an event time stamp at the end of each polling interval, by pulsing the RTS (request to send) line on the serial port. The Palisade GPS responds with a time stamped event packet.</p> 239 <p>Time stamps are reported by the Palisade with respect to UTC time. The GPS receiver must download UTC offset information from GPS satellites. After an initial UTC download, the receiver will always start with correct UTC offset information.<br> </p> 240 <h2><font size="+1">Run NTP in Debugging Mode</font></h2> 241 The following procedure is recommended for installing and testing a Palisade NTP driver: 242 <ol> 243 <li>Perform initial checkout procedures. Place the GPS receiver outdoors; with clear view of the sky. Allow the receiver to obtain an UTC almanac. 244 <li>Verify presence of timing packets by observing the 1 Hz (PPS) led on the interface module. It should flash once per second. 245 <li>Connect Palisade's port A to the NTP host. 246 <li>Configure NTP and the serial I/O port on the host system. 247 <li>Initially use <tt><a href="#flag2">fudge flag2</a></tt> in <b><a href="#Configuration">ntp.conf</a>,</b> to disable event polling (see configuration). 248 <li>Run NTP in debug mode (-d -d), to observe Palisade_receive events. 249 <li>The driver reports the <a href="#TrackingStatus">tracking status of the receiver</a>. Make sure it is tracking several satellites. 250 <li>Remove fudge flag2 and restart <b>ntpd</b> in debug mode to observe palisade_receive events. 251 <li>If event polling fails, verify the <a href="#Pinouts">connections</a> and that the host hardware supports RTS control. 252 </ol> 253 <h2><font size="+1">Event Logging</font></h2> 254 System and Event log entries are generated by NTP to report significant system events. Administrators should monitor the system log to observe NTP error messages. Log entries generated by the Palisade NTP reference clock driver will be of the form: 255 <blockquote> 256 <pre>Nov 14 16:16:21 terrapin ntpd[1127]: Palisade #0: <i>message</i></pre> 257 </blockquote> 258 <h2><font size="+1">Fudge Factors</font></h2> 259 <dl> 260 <dt><a name="time1"></a><tt><font size="+1"><a href="#Configuration">time1 <i>time</i></a></font></tt> 261 <dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0. If event capture is not used, time1 should be set to 20 milliseconds to correct serial line and operating system delays incurred in capturing time stamps from the synchronous packets. 262 <dt><tt><font size="+1">stratum <i>number</i></font></tt> 263 <dd>Specifies the driver stratum, in decimal from 0 to 15, with default 0. 264 <dt><tt><font size="+1"><a href="#REFID">refid <i>string</i></a></font></tt> 265 <dd>Specifies the driver reference identifier, <b>GPS</b>. 266 <dt><a name="flag2"></a><tt><font size="+1"><a href="#Configuration">flag2 0 | 1</a></font></tt> 267 <dd>When set to 1, driver does not use hardware event capture. The synchronous packet output by the receiver at the beginning of each second is time stamped by the driver. If triggering the event pulse fails, the driver falls back to this mode automatically. 268 </dl> 269 <h2><font size="+1">Mode Parameter</font></h2> 270 <dl> 271 <dt><tt><font size="+1">mode <i>number</i></font></tt> 272 <dd>The mode parameter to the server command specifies the specific hardware this driver is for. The default is 0 for a normal Trimble Palisade. The other options are <b>1</b> for an <b>Endrun Praecis</b> in Trimble emulation mode, and <b>2</b> for the <b>Trimble Thunderbolt</b> GPS Disciplined Clock Receiver. 273 </dl> 274 <h2><font size="+1">DEFINEs</font></h2> 275 The following constants are defined in the driver source code. These defines may be modified to improve performance or adapt to new operating systems.<br> 276 <center> 277 <table border> 278 <tr> 279 <td><b>Label</b></td> 280 <td>Definition</td> 281 <td>Default Value</td> 282 </tr> 283 <tr> 284 <td>DEVICE</td> 285 <td>The serial port device to be used by the driver</td> 286 <td>/dev/palisade<b><i>u</i></b></td> 287 </tr> 288 <tr> 289 <td>PRECISION</td> 290 <td>Accuracy of time transfer</td> 291 <td>1 microsecond</td> 292 </tr> 293 <tr> 294 <td>CURRENT_UTC</td> 295 <td>Valid GPS - UTC offset</td> 296 <td>13</td> 297 </tr> 298 <tr> 299 <td>SPEED232</td> 300 <td>Host RS-232 baud rate</td> 301 <td>B9600</td> 302 </tr> 303 <tr> 304 <td>TRMB_MINPOLL </td> 305 <td>Minimum polling interval</td> 306 <td>5 (32 seconds)</td> 307 </tr> 308 <tr> 309 <td>TRMB_MAXPOLL</td> 310 <td>Maximum interval between polls</td> 311 <td>7 (128 seconds)</td> 312 </tr> 313 </table> 314 </center> 315 <h2><a name="DataFormat"></a><font size="+1">Data Format</font></h2> 316 Palisade port A can output two synchronous time packets. The NTP driver can use either packet for synchronization. Packets are formatted as follows: 317 <h3><b><font size="+0">Packet 8F-AD (Primary NTP Packet)</font></b></h3> 318 <center> 319 <table> 320 <tr> 321 <td>Byte</td> 322 <td>Item</td> 323 <td>Type</td> 324 <td>Meaning</td> 325 </tr> 326 <tr> 327 <td>0</td> 328 <td>Sub-Packet ID</td> 329 <td>BYTE</td> 330 <td>Subcode 0xAD</td> 331 </tr> 332 <tr> 333 <td>1 - 2</td> 334 <td>Event Count</td> 335 <td>INTEGER</td> 336 <td>External event count recorded (0 = PPS)</td> 337 </tr> 338 <tr> 339 <td>3 - 10</td> 340 <td>Fractional Second</td> 341 <td>DOUBLE</td> 342 <td>Time elapsed in current second (s)</td> 343 </tr> 344 <tr> 345 <td>11</td> 346 <td>Hour</td> 347 <td>BYTE</td> 348 <td>Hour (0 - 23)</td> 349 </tr> 350 <tr> 351 <td>12</td> 352 <td>Minute</td> 353 <td>BYTE</td> 354 <td>Minute (0 - 59)</td> 355 </tr> 356 <tr> 357 <td>13</td> 358 <td>Second</td> 359 <td>BYTE</td> 360 <td>Second (0 - 59; 60 = leap)</td> 361 </tr> 362 <tr> 363 <td>14</td> 364 <td>Day</td> 365 <td>BYTE</td> 366 <td>Date (1 - 31)</td> 367 </tr> 368 <tr> 369 <td>15</td> 370 <td>Month</td> 371 <td>BYTE</td> 372 <td>Month (1 - 12)</td> 373 </tr> 374 <tr> 375 <td>16 - 17</td> 376 <td>Year</td> 377 <td>INTEGER</td> 378 <td>Year (4 digit)</td> 379 </tr> 380 <tr> 381 <td>18</td> 382 <td>Receiver Status</td> 383 <td>BYTE</td> 384 <td>Tracking Status</td> 385 </tr> 386 <tr> 387 <td>19</td> 388 <td>UTC Flags</td> 389 <td>BYTE</td> 390 <td>Leap Second Flags</td> 391 </tr> 392 <tr> 393 <td>20</td> 394 <td>Reserved</td> 395 <td>BYTE</td> 396 <td>Contains 0xFF</td> 397 </tr> 398 <tr> 399 <td>21</td> 400 <td>Reserved</td> 401 <td>BYTE</td> 402 <td>Contains 0xFF</td> 403 </tr> 404 </table> 405 </center> 406 407 <blockquote> 408 <h4>Leap Second Flag Definition:</h4>Bit 0: (1) UTC Time is available<br> 409 Bits 1 - 3: Undefined<br>Bit 4: (1) Leap Scheduled: Leap second pending asserted by GPS control segment.<br>Bit 5: (1) Leap Pending: set 24 hours before, until beginning of leap second.<br>Bit 6: (1) GPS Leap Warning: 6 hours before until 6 hours after leap event<br>Bit 7: (1) Leap In Progress. Only set during the leap second. 410 <h4><a name="TrackingStatus"></a>Tracking Status Flag Definitions:</h4> 411 </blockquote> 412 <center> 413 <table width="712" border="0" cellspacing="0"> 414 <tr> 415 <td valign="CENTER" width="5%">Code</td> 416 <td valign="CENTER" width="59%">Meaning</td> 417 <td>Accuracy</td> 418 <td>Receiver Mode</td> 419 </tr> 420 <tr> 421 <td>0</td> 422 <td>Receiver is Navigating</td> 423 <td>+/- 1 us</td> 424 <td>Self Survey</td> 425 </tr> 426 <tr> 427 <td valign="CENTER" width="5%">1</td> 428 <td valign="CENTER" width="59%">Static 1 Sat. Timing Mode </td> 429 <td>+/- 1 us</td> 430 <td>1-D Timing</td> 431 </tr> 432 <tr> 433 <td valign="CENTER" width="5%">2</td> 434 <td valign="CENTER" width="59%">Approximate Time</td> 435 <td>20 - 50 ms</td> 436 <td>Acquisition</td> 437 </tr> 438 <tr> 439 <td valign="CENTER" width="5%">3</td> 440 <td valign="CENTER" width="59%">Startup</td> 441 <td>N/A</td> 442 <td>Initialization</td> 443 </tr> 444 <tr> 445 <td valign="CENTER" width="5%">4</td> 446 <td valign="CENTER" width="59%">Startup</td> 447 <td>N/A</td> 448 <td>Initialization</td> 449 </tr> 450 <tr> 451 <td valign="CENTER" width="5%">5</td> 452 <td valign="CENTER" width="59%">Dilution of Position too High </td> 453 <td>5 ppm</td> 454 <td>Self Survey</td> 455 </tr> 456 <tr> 457 <td valign="CENTER" width="5%">6</td> 458 <td valign="CENTER" width="59%">Static 1 Sat. Timing: Sat. not usable</td> 459 <td>5 ppm</td> 460 <td>1-D Timing</td> 461 </tr> 462 <tr> 463 <td valign="CENTER" width="5%">7</td> 464 <td valign="CENTER" width="59%">No Satellites Usable</td> 465 <td>N/A</td> 466 <td>Self Survey</td> 467 </tr> 468 <tr> 469 <td valign="CENTER" width="5%">8</td> 470 <td valign="CENTER" width="59%">Only 1 Satellite Usable</td> 471 <td>20 - 50 ms</td> 472 <td>Self Survey</td> 473 </tr> 474 <tr> 475 <td valign="CENTER" width="5%">9</td> 476 <td valign="CENTER" width="59%">Only 2 Satellite Usable</td> 477 <td>20 - 50 ms</td> 478 <td>Self Survey</td> 479 </tr> 480 <tr> 481 <td valign="CENTER" width="5%">10</td> 482 <td valign="CENTER" width="59%">Only 3 Satellites Usable</td> 483 <td>20 - 50 ms</td> 484 <td>Self Survey</td> 485 </tr> 486 <tr> 487 <td valign="CENTER" width="5%">11</td> 488 <td valign="CENTER" width="59%">Invalid Solution</td> 489 <td>N/A</td> 490 <td>Error</td> 491 </tr> 492 <tr> 493 <td valign="CENTER" width="5%">12</td> 494 <td valign="CENTER" width="59%">Differential Corrections </td> 495 <td>N/A</td> 496 <td>N/A</td> 497 </tr> 498 <tr> 499 <td valign="CENTER" width="5%">13</td> 500 <td valign="CENTER" width="59%">Overdetermined Fixes</td> 501 <td>+/- 100 ns</td> 502 <td>Timing Steady State</td> 503 </tr> 504 </table> 505 </center> 506 <h3><b><font size="+0">Packet 8F-0B (Comprehensive Timing Packet)</font></b></h3> 507 <center> 508 <table border="0" cellspacing="0"> 509 <tr> 510 <td valign="CENTER" width="9%">Byte</td> 511 <td valign="CENTER" width="27%">Item</td> 512 <td valign="CENTER" width="16%">Type</td> 513 <td valign="CENTER" width="48%">Meaning</td> 514 </tr> 515 <tr> 516 <td valign="CENTER" width="9%">0</td> 517 <td valign="CENTER" width="27%">Sub-Packet ID</td> 518 <td valign="CENTER" width="16%">BYTE</td> 519 <td valign="CENTER" width="48%">Subcode 0x0B</td> 520 </tr> 521 <tr> 522 <td valign="TOP" width="9%">1 - 2</td> 523 <td valign="TOP" width="27%">Event Count</td> 524 <td valign="TOP" width="16%">INTEGER</td> 525 <td valign="TOP" width="48%">External event count recorded (0 = PPS)</td> 526 </tr> 527 <tr> 528 <td valign="TOP" width="9%">3 - 10</td> 529 <td valign="TOP" width="27%">UTC / GPS TOW</td> 530 <td valign="TOP" width="16%">DOUBLE</td> 531 <td valign="TOP" width="48%">UTC / GPS time of week (seconds)</td> 532 </tr> 533 <tr> 534 <td valign="CENTER" width="9%">11</td> 535 <td valign="CENTER" width="27%">Date</td> 536 <td valign="CENTER" width="16%">BYTE</td> 537 <td valign="CENTER" width="48%">Day of Month</td> 538 </tr> 539 <tr> 540 <td valign="CENTER" width="9%">12</td> 541 <td valign="CENTER" width="27%">Month</td> 542 <td valign="CENTER" width="16%">BYTE</td> 543 <td valign="CENTER" width="48%">Month of Event</td> 544 </tr> 545 <tr> 546 <td valign="CENTER" width="9%">13 - 14</td> 547 <td valign="CENTER" width="27%">Year</td> 548 <td valign="CENTER" width="16%">INT</td> 549 <td valign="CENTER" width="48%">Year of event</td> 550 </tr> 551 <tr> 552 <td valign="TOP" width="9%">15</td> 553 <td valign="TOP" width="27%">Receiver Mode</td> 554 <td valign="TOP" width="16%">BYTE</td> 555 <td valign="TOP" width="48%">Receiver operating dimensions: <br>0: Horizontal (2D) <br>1: Full Position (3D) <br>2: Single Satellite (0D) <br>3: Automatic (2D / 3D) <br>4: DGPS reference <br>5: Clock hold (2D) <br> 556 6: Over determined Clock</td> 557 </tr> 558 <tr> 559 <td valign="CENTER" width="9%">15 - 17</td> 560 <td valign="CENTER" width="27%">UTC Offset</td> 561 <td valign="CENTER" width="16%">INTEGER</td> 562 <td valign="CENTER" width="48%">UTC Offset value (seconds)</td> 563 </tr> 564 <tr> 565 <td valign="CENTER" width="9%">18 - 25</td> 566 <td valign="CENTER" width="27%">Oscillator Bias</td> 567 <td valign="CENTER" width="16%">DOUBLE</td> 568 <td valign="CENTER" width="48%">Oscillator BIAS (meters)</td> 569 </tr> 570 <tr> 571 <td valign="TOP" width="9%">26 - 33</td> 572 <td valign="TOP" width="27%">Oscillator Drift Rate</td> 573 <td valign="TOP" width="16%">DOUBLE</td> 574 <td valign="TOP" width="48%">Oscillator Drift (meters / second)</td> 575 </tr> 576 <tr> 577 <td valign="CENTER" width="9%">34 - 37</td> 578 <td valign="CENTER" width="27%">Bias Uncertainty</td> 579 <td valign="CENTER" width="16%">SINGLE</td> 580 <td valign="CENTER" width="48%">Oscillator bias uncertainty (meters)</td> 581 </tr> 582 <tr> 583 <td valign="CENTER" width="9%">38 - 41</td> 584 <td valign="CENTER" width="27%">Drift Uncertainty</td> 585 <td valign="CENTER" width="16%">SINGLE</td> 586 <td valign="CENTER" width="48%">Oscillator bias rate uncertainty (m / sec)</td> 587 </tr> 588 <tr> 589 <td valign="CENTER" width="9%">42 - 49</td> 590 <td valign="CENTER" width="27%">Latitude</td> 591 <td valign="CENTER" width="16%">DOUBLE</td> 592 <td valign="CENTER" width="48%">Latitude in radians</td> 593 </tr> 594 <tr> 595 <td valign="CENTER" width="9%">50 - 57</td> 596 <td valign="CENTER" width="27%">Longitude</td> 597 <td valign="CENTER" width="16%">DOUBLE</td> 598 <td valign="CENTER" width="48%">Longitude in radians</td> 599 </tr> 600 <tr> 601 <td valign="CENTER" width="9%">58 - 65</td> 602 <td valign="CENTER" width="27%">Altitude</td> 603 <td valign="CENTER" width="16%">DOUBLE</td> 604 <td valign="CENTER" width="48%">Altitude above mean sea level, in meters</td> 605 </tr> 606 <tr> 607 <td valign="CENTER" width="9%">66 - 73</td> 608 <td valign="CENTER" width="27%">Satellite ID</td> 609 <td valign="CENTER" width="16%">BYTE</td> 610 <td valign="CENTER" width="48%">SV Id No. of tracked satellites</td> 611 </tr> 612 </table> 613 </center> 614 <h3>Thunderbolt Timing packets Data Format</h3> 615 Thunderbolt can output 2 synchronous packets. 616 <h4><b>Primary Timing Packet - 0x8FAB</h4> 617 <center> 618 <table> 619 <tr> 620 <td><b>Byte</b></td> 621 <td><b>Bit</b></td> 622 <td><b>Item</b></td> 623 <td><b>Type</b></td> 624 <td><b>Value</b></td> 625 <td><b>Description</b></td> 626 </tr> 627 <tr> 628 <td>0</td> 629 <td></td> 630 <td>Subcode</td> 631 <td>UINT8</td> 632 <td></td> 633 <td>0xAB</td> 634 </tr> 635 <tr> 636 <td>1-4</td> 637 <td></td> 638 <td>Time of Week</td> 639 <td>UINT32</td> 640 <td></td> 641 <td>GPS seconds of week</td> 642 </tr> 643 <tr> 644 <td>5-6</td> 645 <td></td> 646 <td>Week Number</td> 647 <td>UINT16</td> 648 <td></td> 649 <td>GPS Week Number</td> 650 </tr> 651 <tr> 652 <td>7-8</td> 653 <td></td> 654 <td>UTC Offset</td> 655 <td>SINT16</td> 656 <td></td> 657 <td>UTC Offset (seconds)</td> 658 </tr> 659 <tr> 660 <td valign="top">9</td> 661 <td><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</tr><tr><td>4</tr></table></td> 662 <td valign="top">Timing Flag</td> 663 <td valign="top">Bit field</td> 664 <td valign="top"><table><tr><td>0 or 1</td></tr><tr><td>0 or 1</td></tr><tr><td>0 or 1</td></tr><tr><td>0 or 1</tr><tr><td>0 or 1</tr></table></td></td> 665 <td valign="top"><table><tr><td>GPS Time or UTC Time</td></tr><tr><td>GPS PPS or UTC PPS</td></tr><tr><td>time is set or time is not set</td></tr><tr><td>have UTC info or no UTC info</td></tr><tr><td>Time from GPS or time from user</td></tr></table></td> 666 </tr> 667 <tr> 668 <td>10</td> 669 <td></td> 670 <td>Seconds</td> 671 <td>UINT8</td> 672 <td>0-59</td> 673 <td>(60 for UTC leap second event)</td> 674 </tr> 675 <tr> 676 <td>11</td> 677 <td></td> 678 <td>Minutes</td> 679 <td>UINT8</td> 680 <td>0-59</td> 681 <td>Minutes of Hour</td> 682 </tr> 683 <tr> 684 <td>12</td> 685 <td></td> 686 <td>Hours</td> 687 <td>UINT8</td> 688 <td>0-23</td> 689 <td>Hour of Day</td> 690 </tr> 691 <tr> 692 <td>13</td> 693 <td></td> 694 <td>Day of Month</td> 695 <td>UINT8</td> 696 <td>1-31</td> 697 <td>Day of Month</td> 698 </tr> 699 <tr> 700 <td>14</td> 701 <td></td> 702 <td>Month</td> 703 <td>UINT8</td> 704 <td>1-12</td> 705 <td>Month of Year</td> 706 </tr> 707 <tr> 708 <td>15-16</td> 709 <td></td> 710 <td>Year</td> 711 <td>UINT16</td> 712 <td></td> 713 <td>Four digits of Year (e.g. 1998)</td> 714 </tr> 715 </table> 716 </center> 717 <h4><b>Supplemental Timing Packet - 0x8FAC</h4> 718 <center> 719 <table> 720 <tr> 721 <td><b>Byte</b></td> 722 <td><b>Bit</b></td> 723 <td><b>Item</b></td> 724 <td><b>Type</b></td> 725 <td><b>Value</b></td> 726 <td><b>Description</b></td> 727 </tr> 728 <tr> 729 <td>0</td> 730 <td></td> 731 <td>Subcode</td> 732 <td>UINT8</td> 733 <td></td> 734 <td>0xAC</td> 735 </tr> 736 <tr> 737 <td valign="top">1</td> 738 <td></td> 739 <td valign="top">Receiver Mode</td> 740 <td valign="top">UINT8</td> 741 <td valign="top"><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</td></tr><tr><td>4</td></tr><tr><td>5</td></tr><tr><td>6</td></tr></table></td> 742 <td valign="top"><table><tr><td>Automatic (2D/3D)</td></tr><tr><td>Single Satellite (Time)</td></tr><tr><td>Horizontal (2D)</td></tr><tr><td>Full Position (3D)</td></tr><tr><td>DGPS Reference</td></tr><tr><td>Clock Hold (2D)</td></tr><tr><td>Overdetermined Clock</td></tr></table></td> 743 </tr> 744 <tr> 745 <td valign="top">2</td> 746 <td></td> 747 <td valign="top">Disciplining Mode</td> 748 <td valign="top">UINT8</td> 749 <td valign="top"><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</td></tr><tr><td>4</td></tr><tr><td>5</td></tr><tr><td>6</td></tr></table></td> 750 <td valign="top"><table><tr>Normal<td></td></tr><tr><td>Power-Up</td></tr><tr><td>Auto Holdover</td></tr><tr><td>Manual Holdover</td></tr><tr><td>Recovery</td></tr><tr><td>Not Used</td></tr><tr><td>Disciplining disabled</td></tr></table></td> 751 </tr> 752 <tr> 753 <td>3</td> 754 <td></td> 755 <td>Self-Survey Progress</td> 756 <td>UINT 8</td> 757 <td>0-100%</td> 758 <td></td> 759 <tr> 760 <td>4-7</td> 761 <td></td> 762 <td>Holdover Duration</td> 763 <td>UINT 32</td> 764 <td></td> 765 <td>seconds</td> 766 </tr> 767 <tr> 768 <td valign="top">8-9</td> 769 <td><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</tr><tr><td>4</tr></table></td> 770 <td valign="top">Critical Alarms</td> 771 <td valign="top">UINT16</td> 772 <td valign="top">Bit field</td> 773 <td valign="top"><table><tr><td>ROM checksum error</td></tr><tr><td>RAM check has failed</td></tr><tr><td>Power supply failure</td></tr><tr><td>FPGA check has failed</td></tr><tr><td>Oscillator control voltage at rail</td></tr></table></td> 774 </tr> 775 <tr> 776 <td valign="top">10-11</td> 777 <td valign="top"><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</tr><tr><td>4</tr><tr><td>5</td></tr><tr><td>6</td></tr></table></td> 778 <td valign="top">Minor Alarms</td> 779 <td valign="top">UINT16</td> 780 <td valign="top">Bit field</td> 781 <td valign="top"><table><tr><td>Normal</td></tr><tr><td>Power-Up</td></tr><tr><td>Auto Holdover</td></tr><tr><td>Manual Holdover</tr><tr><td>Recovery</tr><tr><td>Not Used</td></tr><tr><td>Disciplining disabled</td></tr></table></td> 782 </tr> 783 <tr> 784 <td valign="top">12</td> 785 <td></td> 786 <td valign="top">GPS Decoding Status</td> 787 <td valign="top">UINT8</td> 788 <td valign="top"><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>3</td></tr><tr><td>8</tr><tr><td>9</tr><tr><td>0x0A</td></tr><tr><td>0x0B</td></tr><tr><td>0x0C</td></tr><tr><td>0x10</tr></table></td> 789 <td valign="top"><table><tr><td>Doing fixes</td></tr><tr><td>Don t have GPS time</td></tr><tr><td>PDOP is too high</td></tr><tr><td>No usable sats</tr><tr><td>Only 1 usable sat</tr><tr><td>Only 2 usable sats</td></tr><tr><td>Only 3 usable sats</td></tr><tr><td>The chosen sat is unusable</td></tr><tr><td>TRAIM rejected the fix</tr></table></td> 790 </tr> 791 <tr> 792 <td valign="top">13</td> 793 <td></td> 794 <td valign="top">Disciplining Activity</td> 795 <td valign="top">UINT8</td> 796 <td><table><tr><td>0</td></tr><tr><td>1</td></tr><tr><td>2</td></tr><tr><td>3</tr><tr><td>4</tr><tr><td>5</td></tr><tr><td>6</td></tr><tr><td>7</td></tr><tr><td>8</tr></table></td> 797 <td><table><tr><td>Phase locking</td></tr><tr><td>Oscillator warming up</td></tr><tr><td>Frequency locking</td></tr><tr><td>Placing PPS</tr><tr><td>Initializing loop filter</tr><tr><td>Compensating OCXO</td></tr><tr><td>Inactive</td></tr><tr><td>Not used</td></tr><tr><td>Recovery mode</tr></table></td> 798 </tr> 799 <tr> 800 <td>14</td> 801 <td></td> 802 <td>Spare Status 1</td> 803 <td>UINT8</td> 804 <td>0</td> 805 <td></td> 806 </tr> 807 <tr> 808 <td>15</td> 809 <td></td> 810 <td>Spare Status 2</td> 811 <td>UINT8</td> 812 <td>0</td> 813 <td></td> 814 </tr> 815 <tr> 816 <td>16-19</td> 817 <td></td> 818 <td>PPS Offset</td> 819 <td>Single</td> 820 <td></td> 821 <td>Estimate of UTC/GPS offset (ns)</td> 822 </tr> 823 <tr> 824 <td>20-23</td> 825 <td></td> 826 <td>10 MHz Offset</td> 827 <td>Single</td> 828 <td></td> 829 <td>Estimate of UTC/GPS offset (ns)</td> 830 </tr> 831 <tr> 832 <td>24-27</td> 833 <td></td> 834 <td>DAC Value</td> 835 <td>UINT32</td> 836 <td></td> 837 <td>Offset binary (0x00 - 0xFFFFF)</td> 838 </tr> 839 <tr> 840 <td>28-31</td> 841 <td></td> 842 <td>DAC Voltage</td> 843 <td>Single</td> 844 <td></td> 845 <td>Volts</td> 846 </tr> 847 <tr> 848 <td>32-35</td> 849 <td></td> 850 <td>Temperature</td> 851 <td>Single</td> 852 <td></td> 853 <td>degrees C</td> 854 </tr> 855 <tr> 856 <td>36-43</td> 857 <td></td> 858 <td>Latitude</td> 859 <td>Double</td> 860 <td></td> 861 <td>radians</td> 862 </tr> 863 <tr> 864 <td>44-51</td> 865 <td></td> 866 <td>Longitude</td> 867 <td>Double</td> 868 <td></td> 869 <td>radians</td> 870 </tr> 871 <tr> 872 <td>52-59</td> 873 <td></td> 874 <td>Altitude</td> 875 <td>Double</td> 876 <td></td> 877 <td>Meters</td> 878 </tr> 879 <tr> 880 <td>60-67</td> 881 <td></td> 882 <td>Spare</td> 883 <td></td> 884 <td></td> 885 <td>For Future Expantion</td> 886 </tr> 887 </table> 888 </center> 889 <h2><a name="Pinouts"></a><font size="+1">Pinouts</font></h2> 890 <a href="#Connection">The following connections are required when connecting Palisade with a host:</a><br> <br> 891 <center> 892 <table> 893 <tr> 894 <td><u>Description</u></td> 895 <td><b>Host</b></td> 896 <td></td> 897 <td></td> 898 <td><b>Palisade </b></td> 899 <td></td> 900 <td></td> 901 </tr> 902 <tr> 903 <td><a name="PortA"></a><b>Port A</b></td> 904 <td><u>DB-9</u></td> 905 <td><u>DB-25</u></td> 906 <td></td> 907 <td><u>RS-232</u></td> 908 <td><u>RS-422</u></td> 909 <td><u>Palisade Pin</u></td> 910 </tr> 911 <tr> 912 <td>Receive Data </td> 913 <td>2</td> 914 <td>3</td> 915 <td><--></td> 916 <td>Green</td> 917 <td>Green / Blue</td> 918 <td>8 (T-) & 10 (T+)</td> 919 </tr> 920 <tr> 921 <td>Request to Send</td> 922 <td>7</td> 923 <td>4</td> 924 <td><--></td> 925 <td>Gray</td> 926 <td>Gray / White</td> 927 <td>6 (R-) & 7 (R+)</td> 928 </tr> 929 <tr> 930 <td>Signal Ground</td> 931 <td>5</td> 932 <td>7</td> 933 <td><--></td> 934 <td>Black</td> 935 <td>Black</td> 936 <td>9 (GND)</td> 937 </tr> 938 <tr> 939 <td></td> 940 <td></td> 941 <td></td> 942 <td></td> 943 <td></td> 944 <td></td> 945 <td></td> 946 </tr> 947 <tr> 948 <td><a name="PortB"></a><b>Port B</b></td> 949 <td></td> 950 <td></td> 951 <td></td> 952 <td></td> 953 <td></td> 954 <td></td> 955 </tr> 956 <tr> 957 <td>Receive Data </td> 958 <td>2</td> 959 <td>3</td> 960 <td><--></td> 961 <td>Brown</td> 962 <td>Brown / Yellow</td> 963 <td>4 (T-) & 5 (T+)</td> 964 </tr> 965 <tr> 966 <td>Transmit Data</td> 967 <td>3</td> 968 <td>2</td> 969 <td><--></td> 970 <td>Violet</td> 971 <td>Orange/ Violet</td> 972 <td>2 (R-) & 3 (R+)</td> 973 </tr> 974 <tr> 975 <td>Signal Ground</td> 976 <td>5</td> 977 <td>7</td> 978 <td><--></td> 979 <td>Black</td> 980 <td>Black</td> 981 <td>9 (GND)</td> 982 </tr> 983 </table> 984 </center> 985 <blockquote> 986 Note: If driving the RS-422 inputs on the Palisade single ended, i.e. using the Green and Gray connections only, does not work on all serial ports. Use of the Palisade NTP Synchronization Interface Module is recommended.</blockquote> 987 <blockquote> 988 The 12 pin connector pinout definition:<br> 989 Face the round 12 pin connector at the end of the cable, with the notch turned upwards.<br> 990 Pin 1 is to the left of the notch. Pins 2 - 8 wrap around the bottom, counterclockwise to pin 9 on the right of the notch. Pin 10 is just below the notch. Pins 10 (top), 11 (bottom left) and 12 (bottom right) form a triangle in the center of the connector.</blockquote> 991 <blockquote> 992 <a name="SIM"></a>Pinouts for the Palisade NTP host adapter (Trimble PN 37070) DB-25 M connector are as follows:</blockquote> 993 <center> 994 <table width="682" border="0" cellspacing="0"> 995 <tr> 996 <td valign="CENTER" width="12%">DB-25M</td> 997 <td valign="CENTER" width="31%">Conductor </td> 998 <td valign="CENTER" width="16%">Palisade</td> 999 <td valign="CENTER" width="41%">Description</td> 1000 </tr> 1001 <tr> 1002 <td valign="CENTER" width="12%">1 </td> 1003 <td valign="CENTER" width="31%">Red</td> 1004 <td valign="CENTER" width="16%">1</td> 1005 <td valign="CENTER" width="41%">Power</td> 1006 </tr> 1007 <tr> 1008 <td valign="CENTER" width="12%">7 </td> 1009 <td valign="CENTER" width="31%">Black</td> 1010 <td valign="CENTER" width="16%">9</td> 1011 <td valign="CENTER" width="41%">Ground</td> 1012 </tr> 1013 <tr> 1014 <td valign="CENTER" width="12%">9</td> 1015 <td valign="CENTER" width="31%">Black/White</td> 1016 <td valign="CENTER" width="16%">12</td> 1017 <td valign="CENTER" width="41%">PPS -</td> 1018 </tr> 1019 <tr> 1020 <td valign="CENTER" width="12%">10 </td> 1021 <td valign="CENTER" width="31%">Green</td> 1022 <td valign="CENTER" width="16%">8</td> 1023 <td valign="CENTER" width="41%">Transmit Port A (T-)</td> 1024 </tr> 1025 <tr> 1026 <td valign="CENTER" width="12%">11 </td> 1027 <td valign="CENTER" width="31%">Brown</td> 1028 <td valign="CENTER" width="16%">4</td> 1029 <td valign="CENTER" width="41%">Transmit Port B (T-)</td> 1030 </tr> 1031 <tr> 1032 <td valign="CENTER" width="12%">12 </td> 1033 <td valign="CENTER" width="31%">Gray</td> 1034 <td valign="CENTER" width="16%">7</td> 1035 <td valign="CENTER" width="41%">Receive Port A (R+)</td> 1036 </tr> 1037 <tr> 1038 <td valign="CENTER" width="12%">13</td> 1039 <td valign="CENTER" width="31%">Orange</td> 1040 <td valign="CENTER" width="16%">3</td> 1041 <td valign="CENTER" width="41%">Receive Port B (R+)</td> 1042 </tr> 1043 <tr> 1044 <td valign="CENTER" width="12%">21</td> 1045 <td valign="CENTER" width="31%">Orange/White</td> 1046 <td valign="CENTER" width="16%">11</td> 1047 <td valign="CENTER" width="41%">PPS +</td> 1048 </tr> 1049 <tr> 1050 <td valign="CENTER" width="12%">22</td> 1051 <td valign="CENTER" width="31%">Blue</td> 1052 <td valign="CENTER" width="16%">10</td> 1053 <td valign="CENTER" width="41%">Transmit Port A (T+)</td> 1054 </tr> 1055 <tr> 1056 <td valign="CENTER" width="12%">23</td> 1057 <td valign="CENTER" width="31%">Yellow</td> 1058 <td valign="CENTER" width="16%">5</td> 1059 <td valign="CENTER" width="41%">Transmit Port B (T+)</td> 1060 </tr> 1061 <tr> 1062 <td valign="CENTER" width="12%">24</td> 1063 <td valign="CENTER" width="31%">White</td> 1064 <td valign="CENTER" width="16%">6</td> 1065 <td valign="CENTER" width="41%">Receive Port A (R-)</td> 1066 </tr> 1067 <tr> 1068 <td valign="CENTER" width="12%">25</td> 1069 <td valign="CENTER" width="31%">Violet</td> 1070 <td valign="CENTER" width="16%">2</td> 1071 <td valign="CENTER" width="41%">Receive Port B (R-)</td> 1072 </tr> 1073 </table> 1074 </center> 1075 1076 <b><h3>Notes on the Thunderbolt Receiver's Firmware</h3></b> 1077 1078 The support for Thunderbolt Receiver in the palisade driver doesn't support (for now) event-polling, the reason is that the Thunderbolt receiver the patch is written for doesn't support time-on-request, so you just have to sit there and wait for the time to arrive with the PPS. We tried to contact Trimble because there's presumably a firmware update that support it, but we didn't have much luck. 1079Here is a link explaining the situation:<p> 1080<a href="https://lists.ntp.isc.org/pipermail/hackers/2006-April/002216.html">https://lists.ntp.isc.org/pipermail/hackers/2006-April/002216.html 1081 <p></p> 1082 <hr> 1083 <p>Questions or Comments:<br> 1084 <a href="mailto:sven_dietrich@trimble.com">Sven Dietrich</a><br> 1085 <a href="http://www.trimble.com/">Trimble Navigation Ltd.</a></p> 1086 <a href="mailto:fernandoph@iar.unlp.edu.ar">Fernando P. Hauscarriaga</a><br> 1087 <p>(last updated January 15, 2007)</p> 1088 <hr> 1089 <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> 1090 ; 1091 </body> 1092 1093</html> 1094