Symmetricom Gps Receiver 58503B Users Manual

58503B to the manual 2f9a1b18-4686-451d-b1bd-e142896b65f6

2015-02-02

: Symmetricom Symmetricom-Gps-Receiver-58503B-Users-Manual-490659 symmetricom-gps-receiver-58503b-users-manual-490659 symmetricom pdf

Open the PDF directly: View PDF PDF.
Page Count: 262

DownloadSymmetricom Symmetricom-Gps-Receiver-58503B-Users-Manual-  Symmetricom-gps-receiver-58503b-users-manual
Open PDF In BrowserView PDF
097-58503-13
Issue 2: Jul 00

58503B
GPS Time and Frequency
Reference Receiver
and
59551A
GPS Measurements
Synchronization Module
Operating and Programming
Guide

Copyright © 2000 Symmetricom, Inc. All rights reserved. Printed in U.S.A.

This guide describes how to operate the Symmetricom 58503B GPS Time and Frequency Reference Receiver
and
59551A
GPS
Measurements
Synchronization Module via the RS-232C port(s).
The information in this guide applies to instruments
having the number prefix listed below, unless accompanied by a “Manual Updating Changes” package indicating otherwise.

Warning Symbols That May Be Used In This Book

Instruction manual symbol; the product will be marked with this
symbol when it is necessary for the user to refer to the
instruction manual.

SERIAL PREFIX NUMBER:3805A and above
(58503B), 3805A and above (59551A)
Instruments with serial numbers below 3805A may
have earlier versions of firmware installed. There
are no operator-specific differences in previous versions of firmware.

FIRMWARE REVISION:3805A and above
(58503B), 3805A and above (59551A)
Firmware revision can be identified by using a
“*IDN?” command sent to the Receiver via RS-232C
port. See the section “Connecting a Computer or Modem,” in Chapter 2, “Serial Interface Capabilities,”
of this guide for instructions on connecting a computer or modem to these products.
For assistance, contact:
Symmetricom, Inc.
2300 Orchard Parkway
San Jose, CA 95131-1017
U.S.A. Call Center:
888-367-7966 (from inside U.S.A. only – toll
free)
408-428-7907
U.K. Call Center:
+44.7000.111666 (Technical Assistance)
+44.7000.111888 (Sales)
Fax: 408-428-7998
E-mail: ctac@symmetricom.com
Internet: http://www.symmetricom.com

Indicates hazardous voltages.

Indicates earth (ground) terminal.

or

Indicates terminal is connected to chassis when such connection
is not apparent.

Indicates Alternating current.

Indicates Direct current.

Contents
In This Guide
1

Front and Rear Panels at a Glance
58503B Front Panel at a Glance 2
58503B/Option 001 Front-Panel Display/Keypad at a
Glance 3
58503B Rear Panel at a Glance 4
59551A Front Panel at a Glance 5
59551A Rear Panel at a Glance 6

2

Serial Interface Capabilities
Chapter Contents 2
About the RS-232C Serial Port(s) 3
PORT 1 Rear-Panel RS-232C Serial Port 3
PORT 2 Front-Panel RS-232C Serial Port (59551A Only) 4
Connecting a Computer or Modem 5
To Connect the GPS Receiver to a PC or Modem Via the
Rear-Panel PORT 1 6
Connecting to the Personal Computer (PC) 6
Connecting to a Modem 6
Making Your Own Cables 8
Configuring the RS-232C Port(s) 9
Making Changes to the Serial Port Settings (If Needed) 10
Configuring PORT 1 of the 59551A 10
Configuring PORT 1 of the 58503B and PORT 2 of the
59551A 10
Determining the Serial Port Settings 11
Standard 58503B and 59551A 11

3

Visual User Interface
Chapter Contents 2
Using and Reading the Visual User Interface (the Receiver
Status Screen) 3
Tutorial on Using the Status Screen to Interface With the
Receiver 3
Demonstration of Holdover Operation 8
Receiver Status Screen Data 11
SYNCHRONIZATION Section of the Status Screen 12
SYNCHRONIZATION Summary Line 12
SmartClock Mode 12
Operating and Programming Guide

iii

Contents

Reference Outputs 13
ACQUISITION Section of the Status Screen 14
ACQUISITION Line 14
Tracking, Not Tracking 14
Time 16
Position 17
HEALTH MONITOR Section of the Screen 18
The Receiver Status Screen at a Glance 20

4

Command Quick Reference
Chapter Contents 2
An Introduction to GPS Receiver Commands 4
SCPI Conformance Information 4
Command Syntax Conventions 4
Command Presentation 4
GPS Satellite Acquisition 5
1 PPS Reference Synchronization 7
Operating Status 8
System Time 10
Programmable Pulse Output (59551A Only) 11
Event Time Stamping (59551A Only) 12
Serial Interface Communication 13
Receiver Initialization 14
Receiver Identification/Upgrade 15
Receiver Commands at a Glance 17
Status Reporting System at a Glance 18

5

Command Reference
Chapter Contents 2
Command Syntax Conventions 4
Description Format 5
Commands and Returns 5
Query-Specific Information 6
Description of Response Formats (ASCII-encoded)

iv

6

Operating and Programming Guide

Contents

GPS Satellite Acquisition 7
1 PPS Reference Synchronization 27
Operating Status 39
System Time 73
Programmable Pulse Output (59551A Only)
Event Time Stamping (59551A Only) 89
Serial Interface Communication 100
Receiver Initialization 109
Receiver Identification/Upgrade 113

A

Error Messages
Introduction 2
Reading an Error 2
Error Queue 3
Error Types 4
No Error 4
Syntactic Error 4
Semantic Error 5
Hardware/Firmware Error
Query Error 5
General Error Behavior 6
List of Errors 7

B

83

5

Command Syntax and Style
Appendix Contents 2
Command Types, Format, and Elements 3
Command Types 3
Command Formats 3
Common Command Format 3
SCPI Command and Query Format 3
Elements of SCPI Commands 4
Common Command Syntax 4
Subsystem Command Syntax 4
Abbreviated Commands 5
Keyword Separator 5
Parameter Data Types 5
Parameter Separator 6
Query Parameters 6
Suffixes 6
Suffix Elements 6
Suffix Multipliers 7
Command Terminator 7
Operating and Programming Guide

v

Contents

Using Multiple Commands 7
Program Messages 7
Program Message Syntax 7
Elements of Response Messages 9
Response Messages 9
Response Message Syntax 9
Response Formats 10
Reference Documentation 12

C

Receiver Firmware Installation
Downloading New Firmware Using SatStat Program

D

2

Performance Tests
Introduction 2
Operational Verification 2
Complete Performance Tests 2
Test Record 2
Equipment Required 3
Before You Start 4
Operational Verification 5
Introduction 5
Power-Up Procedure 5
10 MHz Verification (58503B Only) 6
1 PPS Verification 6
IRIG-B Verification (59551A Only) 7
Time of Day and PORT 1 RS-232C Serial Interface
Verification 8
Antenna Power Verification 9
Front Panel Display/Keypad Verification (58503B Option 001
Only) 10
Time Tagging (Stamping) Verification and Programmable
Verification (59551A Only) 11
Programmable Pulse Verification (59551A Only) 13
Operational Verification Conclusion 15
In Case of Difficulty 16
Complete Performance Tests 17
Preliminary Test Setup 18
Test 1: 10 MHz Frequency Accuracy and 1 PPS Jitter (Locked to
GPS) 19
Specifications Tested 19
Procedure 19
Test 2: 10 MHz Holdover Aging and 1 PPS Accumulated Time
Error (Unlocked) 22
vi

Operating and Programming Guide

Contents

Specifications Tested 22
Procedure 22
Test 3: 1 PPS Time Accuracy (Locked) 24
Test 4: 10 MHz Frequency Stability (Time Domain) and Phase
Noise (Frequency Domain) Measurements 24
Frequency Stability (Time Domain) 24
Phase Noise (Frequency Domain) 24
58503B Performance Test Record 26
59551A Performance Test Record
27

E

58503B Specifications
Specifications and Characteristics
GPS Receiver Features 2
Other Information 5
Options and Accessories 5

F

2

59551A Specifications
Specifications and Characteristics
GPS Receiver Features 2
Other Information 5
Options and Accessories 5

2

Command Index
General Index

Operating and Programming Guide

vii

Contents

viii

Operating and Programming Guide

In This Guide
Chapter 1, “Front and Rear Panels at a Glance,” provides overview
of the Receiver’s indicators, inputs, and outputs.
Chapter 2, “Serial Interface Capabilities,” provides RS-232 serial
interface port connection and configuration instructions.
Chapter 3, “Visual User Interface,” which is subtitled “Using the
Receiver Status Screen,” provides information on how to use the
Receiver Status screen and the SatStat program. An illustrated foldout
of the Receiver Status screen, which is a comprehensive summary of
key operation conditions and settings, is provided at the end of this
chapter.
Chapter 4,“Command Quick Reference,” is a quick reference that
summarizes the Receiver commands. The commands are presented or
grouped by their functions. A foldout sheet that presents all of the
commands on one side (Receiver Commands at a Glance) and
illustrates the status reporting system on the other side (Status
Reporting System at a Glance) is provided at the end of this chapter.
Chapter 5, “Command Reference,” provides a description of each
command that can be used to operate the GPS Receiver.
The commands are grouped by functions. The functions are grouped
and ordered the same as they are in Chapter 4, “Command Quick
Reference,” and on the foldout “Receiver Commands at a Glance
(cont’d).” A comprehensive discussion on how you can monitor and
control alarm conditions using the status registers is also provided in
this chapter.
Appendix A, “Error Messages,” lists all error messages the Receiver
could generate along with descriptions of possible causes for the errors.
Appendix B, “Command Syntax and Style,” provides an overview of
the Standard Commands for Programming Instrument (SCPI) syntax
and style to help you program the Receiver.
Appendix C, “Receiver Firmware Installation,” provides a
procedure for downloading new firmware to the GPS Receiver.
Appendix D, “Performance Tests,” provides procedures that verify
the GPS Receivers operate properly and meet electrical performance
specifications. Electrical performance is tested against the
specifications listed in Appendix E, “58503B Specifications,” and
Appendix F, “59551A Specifications,” in this guide.

Operating and Programming Guide

ix

In This Guide

Appendix E, “58503B Specifications,” lists the product specifications
and characteristics.
Appendix F, “59551A Specifications,” lists the product specifications
and characteristics.
Command Index, lists all of the commands alphabetically and
provides page references.
General Index

x

Operating and Programming Guide

1

Front and Rear Panels at a Glance

Chapter 1 Front and Rear Panels at a Glance
58503B Front Panel at a Glance

58503B Front Panel at a Glance

1 When the Power indicator
3 When the Holdover indicator
illuminates, it indicates that the
illuminates, it indicates that the
proper input power is supplied to the
Receiver is NOT locked to the GPS
Receiver.
signal. The Receiver is keeping time
based on the internal reference
oscillator signal. The internal
2 When the GPS Lock indicator
reference oscillator will determine
illuminates, it indicates that the
the accuracy of the 1 PPS signal and
Receiver is receiving the GPS signal
the 10 MHz reference output.
and is locked on one or more
satellite(s).
4 When the Alarm indicator
illuminates, it indicates that the
Receiver has detected an internal
condition that requires attention.

1-2

Operating and Programming Guide

Chapter 1 Front and Rear Panels at a Glance
58503B/Option 001 Front-Panel Display/Keypad at a Glance

58503B/Option 001 Front-Panel
Display/Keypad at a Glance

1

An alphanumeric display for displaying time, position (i.e., longitude,
latitude, and altitude), and Receiver status. The display is a highly visible
twelve-character vacuum-fluorescent display.

2

Status LED indicators:
When the Power indicator is illuminated, it indicates that input power is
supplied to the Receiver.
When the GPS Lock indicator is illuminated, it indicates that the
Receiver is tracking satellites and has phase-locked its internal reference
to the reference provided by GPS.
When the Holdover indicator is illuminated, it indicates that the Receiver
is not phase-locking its internal reference to the reference provided by
GPS. Typically, this would happen due to loss of satellite tracking.
When the Alarm indicator is illuminated, it indicates that the Module has
detected a condition that requires attention.

3

Eight MODE keys with associated LEDs for front-panel access to time,
position, and status information: Time, Long (longitude), Lat (latitude)
Alt (altitude), Sat (number of satellites tracking), Status (Receiver or
system status), and Serial Port (serial port settings). Each key selects a
different display mode. Also, pressing Shift and Alt key in sequence clears
instrument alarm.

Operating and Programming Guide

1-3

Chapter 1 Front and Rear Panels at a Glance
58503B Rear Panel at a Glance

58503B Rear Panel at a Glance

1 ANT N-type (female) connector for
GPS Antenna connection.
2 PORT 1 RS-232C, DB-25 (female)
serial interface port for remote
control, monitoring, and
downloading of the Receiver’s
memory data and upgrading
Receiver software.

Option 002 1 PP2S
(One-Pulse-Per-Two-Seconds)
connector for outputting a pulse
every other second, synchronized to
the even seconds in GPS time.
Pulses occur on even-numbered
seconds (i.e., 2 seconds, 4 seconds,
etc.).

6 Alarm output for external devices
(such as red light, bell, or horn) to
3 10 MHz OUT output for user-specific
indicate that the Receiver has
applications.
detected an internal condition that
requires attention.
4 1 PPS connector for outputting a
continuous 1 Pulse Per Second
signal.

1-4

7 POWER input jack.

Operating and Programming Guide

Chapter 1 Front and Rear Panels at a Glance
59551A Front Panel at a Glance

59551A Front Panel at a Glance

1 When the Power indicator

illuminates, it indicates that the
proper input power is supplied to
the Module.

4 When the Alarm indicator
illuminates, it indicates that the
Module has detected an internal
condition that requires attention.

2 When the GPS Lock indicator
illuminates, it indicates that the
Module is receiving the GPS signal
and is locked on one or more
satellite(s).

5 PORT 2 RS-232C, DE-9S (female)
serial interface port for local
monitoring and retrieving data
stored in the Module’s memory
data.

3 When the Holdover indicator

illuminates, it indicates that the
Module is NOT locked to the GPS
signal. The Module is keeping time
based on the internal reference
oscillator signal. The internal
reference oscillator will determine
the accuracy of the 1 PPS signal.
(See specification for Accuracy in
Holdover in Appendix F, “59551A
Specifications,” in this guide.)

Operating and Programming Guide

1-5

Chapter 1 Front and Rear Panels at a Glance
59551A Rear Panel at a Glance

59551A Rear Panel at a Glance

1 1 PPS (One-Pulse-Per-Second)
connector for outputting a
continuous one pulse per second
signal.
2 Programmable Pulse output connector
for outputting pulses at user-specified
time/period.

3 IRIG-B output for outputting
formatted time-code signals. (This
signal is used for general purpose
time distribution and magnetic
tape annotation applications
requiring the time of year.)
4 Time tag input connectors for
receiving TTL conditioned time
tagging signals.

5 Alarm BITE (Built-In Test
Equipment) output for external
devices (such as red light, bell, or
horn) to indicate that the Module
has detected an internal condition
that requires attention. The relay
opens and closes with the Alarm
indicator. (Mating connector is
Amphenol part number 31-224
[glass-filled Noryl] or #31-2226
[Telfon]).
6 ANTENNA N-type (female)
connector for GPS antenna
connection.
7 PORT 1 RS-232C, DB-25 (female)
serial interface port for remote
control, monitoring, and retrieving
of the Module’s memory data and
upgrading Module software.
8 AC POWER input jack. The AC
input jack is standard. The unit
operates from ac voltage. It can also
be operated from dc voltage via this
ac jack by using the supplied IEC
320 dc connector plug.

1-6

Operating and Programming Guide

2

Serial Interface Capabilities

Chapter 2 Serial Interface Capabilities
Chapter Contents

Chapter Contents
This chapter describes how to operate the 59551A GPS Measurements
Synchronization Module and the 58503B GPS Time and Frequency
Reference Receiver via the RS-232C serial interface port. Hardware
connections and configuration are discussed.
This chapter is organized as follows:
•

•

•

2-2

About the RS-232C Serial Port(s)

page 2-3

–

PORT 1 Rear-Panel RS-232C Serial Port

page 2-3

–

PORT 2 Front-Panel RS-232C Serial Port
(59551A Only)

page 2-4

Connecting a Computer or Modem

page 2-5

–

To Connect the GPS Receiver to a PC or Modem Via page 2-6
the Rear-Panel PORT 1

–

To Connect the GPS Receiver to a PC or Modem Via page 2-6
the Rear-Panel PORT 1

Configuring the RS-232C Port(s)

page 2-9

–

Making Changes to the Serial Port Settings
(If Needed)

page 2-10

–

Determining the Serial Port Settings

page 2-11

Operating and Programming Guide

Chapter 2 Serial Interface Capabilities
About the RS-232C Serial Port(s)

About the RS-232C Serial Port(s)
The 58503B has only a rear-panel (PORT 1) RS-232C serial interface
port.
The 59551A has separate rear-panel (PORT 1) and front-panel
(PORT 2) RS-232C serial interface ports.
The rear-panel (PORT 1) RS-232C serial interface port is the only port
which can be used to upgrade the Receiver firmware; therefore, it is
referred to as the PRIMARY port. The 59551A’s front-panel (PORT 2)
RS-232C serial interface port is referred to as the SECONDARY port
because it cannot be used to upgrade the Receiver firmware. The
operation and configuration of these ports are described in the
following paragraphs. More information is provided in the sections
titled “Connecting a Computer or Modem” and “Configuring the
RS-232C Port(s)” in this chapter on page 2-5 and page 2-9,
respectively.
Either port allows you full communication with the Receiver. This can
be done by connecting any computer with an RS-232C serial interface
and suitable terminal emulation software, then sending the correct
commands for transmitting or retrieving data.

PORT 1 Rear-Panel RS-232C Serial Port
This 25-pin female subminiature D (DB-25) connector (PORT 1)
RS-232C Serial Interface Port is located on the rear panel.
The pins used for PORT 1 RS-232C communication are described in
Table 2-1.
NOTE

We reserve the right to impose signals on other pins; therefore, your
connection should be restricted to the pins described in Table 2-1.
Table 2-1. PORT 1 Rear-Panel RS-232C Serial Port Connections
*Pin
Number

Input/Output

Description

2

Output

Transmit Data (TxD). GPS Receiver output.

3

Input

Receive Data (RxD). GPS Receiver input.

7

_____

Signal Ground (SG)

Operating and Programming Guide

2-3

Chapter 2 Serial Interface Capabilities
About the RS-232C Serial Port(s)

Refer to the sections titled “Connecting a Computer or Modem” in this
chapter, on page 2-5, for wiring diagrams and more information on the
RS-232C interface cables.

PORT 2 Front-Panel RS-232C Serial Port
(59551A Only)
This 9-pin female subminiature D (DB-9) connector (PORT 2) RS-232C
Serial Interface Port is located on the front panel.
The pins used for PORT 2 RS-232C communication are described in
Table 2-2.
NOTE

We reserves the right to impose signals on other pins; therefore, your
connection should be restricted to the pins described in Table 2-2.
Table 2-2. PORT 2 Front-Panel RS-232C Serial Port Connections
(59551A Only)
*Pin
Number

Input/Output

Description

2

Input

Receive Data (RxD). GPS Receiver input.

3

Output

Transmit Data (TxD). GPS Receiver output.

5

_____

Signal Ground (SG)

Refer to the sections titled “Connecting a Computer or Modem” in this
chapter, on page 2-5, for wiring diagrams and more information on the
RS-232C interface cables.

2-4

Operating and Programming Guide

Chapter 2 Serial Interface Capabilities
Connecting a Computer or Modem

Connecting a Computer or Modem
To connect the GPS Receiver to a computer or modem, you must have
the proper interface cable. Most computers are DTE (Data Terminal
Equipment) devices. Since the Receiver is also a DTE device, you must
use a DTE-to-DTE interface cable when connecting to a computer.
These cables are also called “null-modem”, “modem-eliminator”, or
“crossover” cables.
Most modems are DCE (Digital Communication Equipment) devices;
thus, you must use a DTE-to-DCE interface cable.
The interface cable must also have the proper connector on each end
and the internal wiring must be correct. Connectors typically have
9 pins (DE-9 connector) or 25 pins (DB-25 connector) with a “male” or
“female” pin configuration. A male connector has pins inside the
connector shell and a female connector has holes inside the connector
shell.
To simplify interface cable selections, the following sections
tells you which cables to use.

Operating and Programming Guide

2-5

Chapter 2 Serial Interface Capabilities
Connecting a Computer or Modem

To Connect the GPS Receiver to a PC or Modem Via
the Rear-Panel PORT 1
Connecting to the Personal Computer (PC)
Use an HP 24542G interface cable or equivalent to connect the
Receiver’s rear-panel PORT 1 DB-25 female connector to a PC as
shown in Figure 2-1. See “Making Your Own Cables” starting on
page 2-8.

GPS Receiver
(Rear view)
WARNING:

Computer

NO OPERATOR SERVICEABLE PARTS INSIDE, REFER SERVICING TO SERVICE TRAINED PERSONNEL.

OUTPUTS
1 pps Programmable Irig-B
TOD

Time Tag
1

INPUTS
Time Tag
2

ANTENNA

ALARM BITE
Time Tag
3

!
POWER

!
Port 1

129 VDC

!
FOR LABORATORY USE BY
QUALIFIED PERSONNEL
FOUR USAGE EN LABORATOIRE
PAR PERSONNEL QUALIFIE

SERIAL PLATE

48 VDC
129 VDC

!

WARNING:

FOR CONTINUED FIRE PROTECTION, USE SPECIFIED ~ LINE FUSE.

HP 24542G
or equivalent

Figure 2-1. Connecting the GPS Receiver to a PC or Laptop

Connecting to a Modem
Use an HP 40242M interface cable or equivalent to connect the
Receiver’s rear-panel PORT 1 DB-25 female connector to a modem,
which is a DCE (Digital Communication Equipment) device, as shown
in Figure 2-2. See “Making Your Own Cables” starting on page 2-8.

2-6

Operating and Programming Guide

Chapter 2 Serial Interface Capabilities
Connecting a Computer or Modem

GPS Receiver
(Rear view)
WARNING:

NO OPERATOR SERVICEABLE PARTS INSIDE, REFER SERVICING TO SERVICE TRAINED PERSONNEL.

OUTPUTS
1 pps Programmable Irig-B
TOD

Time Tag
1

INPUTS
Time Tag
2

ANTENNA

ALARM BITE
Time Tag
3

!
POWER

!
Port 1

129 VDC

!
FOR LABORATORY USE BY
QUALIFIED PERSONNEL
FOUR USAGE EN LABORATOIRE
PAR PERSONNEL QUALIFIE

SERIAL PLATE

48 VDC
129 VDC

!

WARNING:

FOR CONTINUED FIRE PROTECTION, USE SPECIFIED ~ LINE FUSE.

HP 40242M
or equivalent

Modem set to
Auto-Answer

Telephone
Line

Figure 2-2 Connecting the GPS Receiver to a Modem

Operating and Programming Guide

2-7

Chapter 2 Serial Interface Capabilities
Connecting a Computer or Modem

Making Your Own Cables
If you choose to make your own cable, see Figure Figure 2-3 and
Figure Figure 2-4.
Figure Figure 2-3 illustrates how to make a DE-9S-to-DE-9P, DTEto-DCE interface cable that can replace the cable and adapter
combination of the HP 24542U cable and the HP 5181-6639 adapter for
use with PORT 2 of the 59551A.

Data
Terminal
Equipment
PC
RS-232C (9-pin)
PC input
PC output

RX
TX
GND

DE-9P
Male

DE-9S-to-DE-9P
(DTE-to-DCE) Interface Cable
1
2
3
4
5
6
7
8
9

1
2
3
4
5
6
7
8
9

DE-9S
Female

DE-9P
Male

Data
Communications
Equipment
59551A PORT 2
RS-232C (9-pin)
RX
TX

Instrument input
Instrument output

GND

DE-9S
Female

Figure 2-3 DE-9S-to-DE-9P (DTE-to-DCE) Serial Interface Connection
to PORT 2
Figure Figure 2-4 illustrates how to make a DE-9S-to-DB-25P,
DTE-to-DTE interface cable that can replace the HP 24542G cable
(25-pin male to 9-pin female connectors) for use with PORT 1.
Data
Terminal
Equipment
PC
RS-232C (9-pin)
PC input
PC output

RX
TX
GND

Data
Terminal
Equipment
PORT 1
RS-232C (25-pin)

DE-9S-to-DB-25P
(DTE-to-DTE)
Interface cable

1
2
3
4
5
6
7
8
9

DE-9P DE-9S
Male Female

1
2
3
4
5
6
7
8
20
22
DB-25P
Male

TX
RX

Instrument output
Instrument input

GND

DB-25S
Female

Figure 2-4 DE-9S-to-DB-25P (DTE-to-DTE) Serial Interface
Connection to PORT 1
2-8

Operating and Programming Guide

Chapter 2 Serial Interface Capabilities
Configuring the RS-232C Port(s)

Configuring the RS-232C Port(s)
The 59551A has separate rear-panel (PORT 1) and front-panel
(PORT 2) RS-232C serial interface ports.
The 58503B has one RS-232C serial interface port (PORT 1) on the
rear panel. Note: PORT 1 of the 58503B and PORT 2 of the 59551A
have the same configuration capabilities as indicated in Table 2-4.
Software pacing, baud rate, parity, data bits, and stop bits parameters
for each port are user-selectable and independent of the configuration
of the other.
Table 2-3 and Table 2-4 list the configuration factory-default values for
PORT 1 and PORT 2.
Table 2-3. Factory-Default Values for PORT 1 of the 59551A
Parameter

Default

Possible Choices

Software Pacing

NONE

XON or NONE

Baud Rate

9600

1200, 2400, 9600, or 19200

Parity

NONE

EVEN, ODD, or NONE

Data Bits

8

7 or 8

Stop Bits

1

1 or 2

Full Duplex

ON

ON or OFF

Table 2-4. Factory-Default Values for PORT 1 or the 58503B and
PORT 2 of the 59551A
Parameter

Default

Possible Choices

Software Pacing

NONE

XON or NONE

Baud Rate

9600

1200, 2400, 9600, or 19200

Parity

NONE

EVEN, ODD, or NONE

Data Bits

8

Fixed at 7 when parity is even or odd.
Fixed at 8 when parity is none.

Stop Bits

1

Fixed (no choices available)

Full Duplex

ON

ON or OFF

Procedures for configuring the RS-232C ports are provided in the
following paragraphs.

Operating and Programming Guide

2-9

Chapter 2 Serial Interface Capabilities
Configuring the RS-232C Port(s)

Making Changes to the Serial Port Settings
(If Needed)
CAUTION

If you change the serial port settings, your changes will be
stored in the Receiver. Cycling power will not reset to factory
defaults. Therefore, if you make a change, it is recommended
that you record the settings and keep the record with the
Receiver.
If you need to change the serial port settings, for example, to set
up for a different computer, use the guidelines given in this
section.
Serial port settings are changed by issuing commands.
It is recommended that you issue a single compound command which
simultaneously sets all the serial port parameters. Then connect the
other computer and begin using the instrument with the new settings.

NOTE

If you choose to set parameters one at a time, you will make the
procedure more difficult. That is, with each change, the instrument
will be updated, but your computer will retain its original settings.
At each step, you will have stopped serial communications and be
forced to modify your PC settings to match the Receiver in order to
continue. It is recommended that you make all changes in a single
compound command, verify the changes, and record all parameters.

Configuring PORT 1 of the 59551A
Complete configuration of PORT 1 of the 59551A requires that you set
five parameters. The command line sent in the following example
would set the RS-232C port pacing to XON, baud rate to 2400, parity to
EVEN, data bits to 7, and stop bits to 2. This command line must be
transmitted on PORT 1.
SYST:COMM:SER:PACE XON; BAUD 2400; PARITY EVEN; BITS 7; SBITS 2

Configuring PORT 1 of the 58503B and PORT 2 of the
59551A
Complete configuration of PORT 1 (58503B) and PORT 2 (59551A)
require that you set three parameters. The command line sent in the
following example would set the RS-232C port pacing to XON, baud
rate to 2400, and parity to EVEN. This command line must be
transmitted on PORT 1 or PORT 2.
SYST:COMM:SER2:PACE XON; BAUD 2400; PARITY EVEN

2-10

Operating and Programming Guide

Chapter 2 Serial Interface Capabilities
Configuring the RS-232C Port(s)

Determining the Serial Port Settings
Standard 58503B and 59551A
If you connect your PC, press Return, and do not get a scpi> prompt
back from the Receiver, your Receiver’s serial communication settings
may have been modified. You need to systematically step through the
data communication settings on your PC until your PC matches the
Receiver. The Receiver cannot communicate its settings until this
process is complete.
Iterate until you are able to verify that settings on your PC match the
Receiver.
When you are successful, you will have restored full RS-232C
communications, enabling you to query the Receiver’s communication
settings. Once you establish communications with one serial port, you
can query the Receiver for settings of either port.
Issue the following queries to either serial port to verify PORT 1’s
configuration.
SYST:COMM:SER:PACE?
SYST:COMM:SER:BAUD?
SYST:COMM:SER:PARITY?
SYST:COMM:SER:BITS?
SYST:COMM:SER:SBITS?

Issue the following queries to either serial port to verify PORT 2’s
configuration.
SYST:COMM:SER2:PACE?
SYST:COMM:SER2:BAUD?
SYST:COMM:SER2:PARITY?
SYST:COMM:SER2:BITS?
SYST:COMM:SER2:SBITS?

Operating and Programming Guide

2-11

Chapter 2 Serial Interface Capabilities
Configuring the RS-232C Port(s)

This page intentionally left blank.

2-12

Operating and Programming Guide

3

Visual User Interface
Using the Receiver Status Screen

Chapter 3 Visual User Interface
Chapter Contents

Chapter Contents
This chapter provides a tutorial section on how to use the Receiver
Status Screen, a comprehensive reference information section, and an
illustrated foldout of the Receiver Status Screen, which is a
comprehensive summary of key operation conditions and settings.
This chapter is organized as follows:
•

Using and Reading the Visual User Interface (the
Receiver Status Screen)

page 3-3

– Tutorial on Using the Status Screen to Interface With
the Receiver
page 3-3
•

•

3-2

– Demonstration of Holdover Operation

page 3-8

Receiver Status Screen Data

page 3-11

– SYNCHRONIZATION Section of the Status Screen

page 3-12

– ACQUISITION Section of the Status Screen

page 3-14

– HEALTH MONITOR Section of the Screen

page 3-18

The Receiver Status Screen at a Glance (foldout)

page 3-20

Operating and Programming Guide

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)

Using and Reading the Visual User
Interface (the Receiver Status Screen)
The combination of the PC and the GPS Receiver yields a visual user
interface called the Receiver Status Screen that lets you see what the
Receiver is doing and how it is progressing towards tracking satellites
to eventually lock to the GPS signal.
When connected to a properly configured PC, the Receiver Status
Screen can be accessed. There are two ways to access and use the
Receiver Status Screen:
•

By installing a commercially available terminal emulation
program, connecting the Receiver to a PC via the PORT 1 port, and
manually sending the :SYSTEM:STATUS? query. (Refer to Chapter 1,
“Getting Started,” in 58503B/59551A Getting Started Guide.)

•

By installing and operating the SatStat program, which
automatically generates continual status screen updates, and
connecting the Receiver to a PC via PORT 1. (Refer to the sections
titled “Installing the Automated SatStat Program for Continual
Status Updates” and “Operating the Automated SatStat Program”
in Chapter 1, “Getting Started,” of the 58503B/59551A Getting
Started Guide for details on installation and operation.)

The following tutorial demonstrates how you can use the Receiver
Status Screen to observe Receiver operation. The tutorial uses the
manual (:SYSTEM:STATUS?) method.

Tutorial on Using the Status Screen to Interface With
the Receiver
Type :SYSTEM:STATUS? at the scpi> prompt.
An initial power-up screen is displayed, which is similar to the
demonstration screen shown in Figure 3-1. The first data that you
should look at is in the SYNCHRONIZATION area of the screen. It is
telling you that it is in the Power-up state as indicated by the >>
marker. That is, the Receiver has just been put on line.

Operating and Programming Guide

3-3

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION ......................................... [ Outputs Invalid ]
Reference Outputs
SmartClock Mode
Locked
TFOM
9
FFOM
3
Recovery
1PPS TI -Holdover
HOLD THR 1.000 us
>> Power-up:GPS acquisition
Holdover Uncertainty
Predict -ACQUISITION ............................................. [GPS 1PPS Invalid]
Not Tracking: 6
Tracking: 0
Time
PRN El Az
UTC
12:00:00[?] 01 Jan 1996
*1 -- --GPS 1PPS Invalid: not tracking
*6 -- --ANT DLY 0 ns
*9 -- --Position
*14 -- --MODE
Survey: 0% complete
*22 -- --Suspended:track <4 sats
*24 -- --INIT LAT N
0:00:00.000
INIT LON W
0:00:00.000
INIT HGT
0 m (GPS)
ELEV MASK 10 deg *attempting to track
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK
Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-1. Receiver Status Screen at Powerup
The ACQUISITION area of the screen is telling you that no satellites
have been tracked. The identification numbers of several satellites
appear in the Not Tracking column. The asterisk next to the satellite
identification number, or pseudorandom noise code (PRN), indicates
the Receiver is attempting to track it.
The current time and date are shown in the Time quadrant of the
ACQUISITION area. The default power-up setting, indicated by [?], is
corrected when the first satellite is tracked. Since the Receiver is not
tracking any satellites, the GPS 1 PPS reference signal is invalid.
An accurate position is necessary to derive precise time from GPS. The
Position quadrant indicates that the Receiver is in survey mode, which
uses GPS to determine the position of the GPS antenna. This process
has not yet started, since position calculations can be performed only
while tracking four or more satellites. INIT LAT, INIT LON, and INIT
HGT are the initial estimate of the true position. These coordinates are
refined by the survey process. The Receiver uses this position and the
time-of-day to select satellites to track. Therefore, you can reduce
satellite acquisition time by specifying a close approximation of
position and time.
Now, let’s send the :SYSTEM:STATUS? query again to see what kind of
progress the Receiver has made.
3-4

Operating and Programming Guide

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)
You can now see that the Receiver is tracking several satellites as
shown in Figure 3-2. The process of acquiring and tracking satellites is
described in the following paragraphs.

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION ........................... [ Outputs Valid/Reduced Accuracy ]
Reference Outputs
SmartClock Mode
TFOM
6
FFOM
1
>> Locked to GPS: stabilizing frequency
Recovery
1PPS TI +71 ns relative to GPS
Holdover
HOLD THR 1.000 us
Power-up
Holdover Uncertainty
Predict -ACQUISITION ...............................................[GPS 1PPS Valid]
Not Tracking: 4
Tracking: 5
Time
PRN El Az C/N PRN El Az
UTC
17:56:44
31 Jan 1996
2 70 337
49
9 11 292
GPS 1PPS Synchronized to UTC
7 46 188
48
16 24 243
ANT DLY 0 ns
15 33 82
38 *26 Acq..
Position
19 28 113
36
31 -- --MODE
Survey: 1.2%
complete
22 65 91
49
AVG LAT N 37:19:34.746
AVG LON W 121:59:50.502
AVG HGT
+34.14 m (GPS)
ELEV MASK 10 deg *attempting to track
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-2. Receiver Status Screen Displaying Initial Satellite
Acquisition
An asterisk (*) next to the PRN of a satellite in the Not Tracking
column indicates the Receiver is attempting to track it. The elevation
(El) and azimuth (Az) angles of the satellite are indicated. Acq . or
Acq .. tell you that the Receiver is attempting to track that satellite.
One dot after the Acq indicator shows that the Receiver is attempting
to acquire its signal, and two dots indicate impending lock. Eventually,
you will see the satellite move to the Tracking column, which shows
the satellite PRN, the elevation angle of the satellite in the sky (90°
being zenith), the azimuth angle (number of degrees bearing from true
north), and the carrier-to-noise ratio (C/N). A good carrier-to-noise
ratio is a number above 35, which would be efficient for the Receiver to
operate. Numbers below 35, suggest intermittent tracking of the
satellite or no tracking; check your antenna system should this be the
case.
As indicated by the demonstration screen in Figure 3-2, the Receiver is
now surveying for position. It is tracking four satellites which is the
minimum number that must be tracked to determine postion. As you
can see, the Position MODE line indicates survey is 1.2% complete. A
complete survey would take two hours during which four satellites or
more are continuously tracked.
Operating and Programming Guide

3-5

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)
Also, you can see the initial (estimated) position has been replaced
with a computed position, which the Receiver continuous to refine until
it gets a very accurate position. The status screen indicates that a
computed position is being used by displaying the averaged latitude,
and longitude height (AVG LAT, AVG LON, and AVG HGT).
If the position were not precise, GPS timing information would be
inaccurate by an amount corresponding to the error in the computed
position. An error in the computed position of the antenna translates
into an error in the derived time and will compromise the Receiver’s
ability to be a timing source.
Let’s consider a case where four satellites are not visible at powerup
because of a poor antenna location, such as an “urban canyon” (located
between tall city buildings). If accurate position is known from a
Geodetic survey of that site, it can be programmed with the position
command, thereby bypassing the survey operation. This is useful when
four satellites cannot be tracked for an extended period of time.
Let’s send the :SYSTEM:STATUS? query again to observe the current
status of the Receiver.
The updated demonstration status screen in Figure 3-3 indicates that
the position survey is now 5.4% complete. Thus, the survey task is
beginning to iterate toward an accurate position. In the Time
quadrant, the UTC time is now correct. The date is correct, and the
GPS reference signal is synchronized to UTC.

3-6

Operating and Programming Guide

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION ............................[ Outputs Valid/Reduced Accuracy ]
Reference Outputs
SmartClock Mode
4
1
TFOM
FFOM
>> Locked to GPS: stabilizing frequency
Recovery
1PPS TI +20 ns relative to GPS
Holdover
HOLD THR 1.000 us
Power-up
Holdrover Uncertainty
Predict 432.0 us/initial 24 hrs
ACQUISITION ............................................... [GPS 1PPS Valid]
Not Tracking: 1
Tracking: 6
Time
PRN El Az C/N PRN El Az
UTC
2 70 301
40
16 13 258
18:47:07
31 Jan 1996
GPS 1PPS Synchronized to UTC
7 35 186
38
19 40 102
38
ANT DLY 0 ns
Position
22 71 60
39
Survey: 5.4%
complete
MODE
26 19 317
36
31 16 41
35
AVG LAT N 37:19:34.937
AVG LON W 121:59:50.457
+67.94 m (GPS)
AVG HGT
ELEV MASK 10 deg
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK
Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-3. Receiver Status Screen Displaying Progress Towards
Steady-State Operation
In the SYNCHRONIZATION area, the >> marker is pointed at the
Locked to GPS line, indicating that the Receiver is locked to GPS and
stabilizing the frequency of its oscillator. This means that the Receiver
has phase-locked its oscillator to the 1 PPS reference signal provided
by GPS, but it is not at its final, or most stable, state. The Receiver is
locked and the front-panel GPS Lock LED is illuminated.
For users without the command interface (PC/Terminal emulator
connected to the Receiver), the illuminated GPS Lock LED is probably
the first indication that after powerup that the Receiver is moving
towards a stable state.
With the command interface and status screen, you can get more
detailed information. For example, you can read the reference outputs
quality indicators in the Reference Outputs area of the status screen.
These are the Time Figure of Merit (TFOM) and Frequency Figure of
Merit (FFOM) indicators. As shown in Figure 3-3, the TFOM is 4 and
the FFOM is 1. These values will eventually decrease towards the
ultimate values that represent steady-state performance. Refer to the
subsection titled ““Reference Outputs” on page 3-13 in this chapter for
more information about TFOM and FFOM.
Operating and Programming Guide

3-7

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)
Also indicated is a prediction of the accuracy of the Receiver should it
go into holdover operation.

Demonstration of Holdover Operation
CAUTION

The Receiver typically reaches stable state 24 to 72 hours after
powerup, and it will learn best if its experiences no holdover in the first
24 hours. Therefore, the holdover demonstration in the following
paragraphs will compromise the Receiver’s ability to learn the
characteristics of its internal reference oscillator. For the purpose of
education only, you will be shown how to initiate a holdover.
A user should never initiate holdover during the first 24 hours while
the Receiver is learning its internal oscillator characteristics. The
Receiver should maintain GPS lock during this time because it is using
the GPS signal to discipline the oscillator. It will learn what the
oscillator drift characteristics are relative to the GPS signal. It will
learn how the oscillator ages, and the software will learn how to
compensate for that aging.
Thus, it is recommended that the Receiver is always kept locked to
GPS during the first 24 hours.

For demonstration purposes, and since the Receiver has been powered
up for a while, let’s put the Receiver into holdover by simply removing
the antenna connection. (Note that holdover also can be manually
initiated by sending the SYNCHRONIZATION:HOLDOVER:INITIATE
command; however, for this demonstration, disconnect the antenna
cable.) The following will occur after a verification delay:
•

The front-panel Holdover LED will illuminate, and

•

after sending the :SYSTEM:STATUS? query again, a screen similar to
Figure 3-4 should appear.

Let’s send the :SYSTEM:STATUS? query. Figure 3-4 should appear.

3-8

Operating and Programming Guide

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION ........................... [ Outputs Valid/Reduced Accuracy ]
Reference Outputs
SmartClock Mode
TFOM
FFOM
3
2
Locked to GPS
Recovery
1PPS TI ->> Holdover: GPS 1PPS invalid
HOLD THR 1.000 us
Power-up
Holdover Uncertainty
Predict 432.0 us/initial 24 hrs
Holdover Duration: 0m 14s
Present 1.0 us
ACQUISITION ............................................. [GPS 1PPS Invalid]
Not Tracking: 7
Tracking: 0
Time
PRN El Az PRN El Az
UTC
20:56:14
31 Jan 1996
*2
71 316 *31 12 29
GPS 1PPS Inaccurate: not tracking
*7
41 186
ANT DLY 0 ns
15 11 86
Position
*19 35 107
MODE
Survey: 71.1% complete
*22 68 78
*26 23 314
LAT
N 37:19:32.472
LON
W 121:59:51.784
HGT
+42.19 m (GPS)
ELEV MASK 10 deg *attempting to track
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-4. Receiver Status Screen Displaying Holdover Operation
In the SYNCHRONIZATION area, you can see that the Receiver has
gone into holdover as indicated by >> marker that is pointing at the
Holdover line. The status screen indicates that the reason the Receiver
is in holdover is because the GPS 1 PPS reference signal is invalid.
You would expect this since the antenna has been disconnected.
The status screen shows loss of the GPS signal. As you can see on the
screen, all of the satellites in the Tracking column moved into the Not
Tracking column.
The status screen in Figure 3-4 shows that the Receiver has been in
holdover operation for 14 seconds.
If the Receiver SmartClock had had enough time to learn the internal
oscillator characteristics, the Receiver Status Screen would show that
the Receiver went into holdover, and the Receiver’s outputs were
maintained during holdover by the SmartClock.

Operating and Programming Guide

3-9

Chapter 3 Visual User Interface
Using and Reading the Visual User Interface (the Receiver Status
Screen)
When the GPS antenna is re-connected and the GPS signal has been
re-acquired, the Receiver has the ability to recover from holdover by
itself. The SYNCHRONIZATION area of the screen will show the >>
marker pointing at the Recovery line (and then eventually at the
Locked to GPS line), the GPS Lock LED will illuminate, and the screen
will look similar toFigure 3-5.

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION ............................[ Outputs Valid/Reduced Accuracy ]
Reference Outputs
SmartClock Mode
3
1
TFOM
FFOM
>> Locked to GPS: Stabilizing frequency
Recovery
1PPS TI +10.6 ns relative to GPS
Holdover
HOLD THR 1.000 us
Power-up
Holdover Uncertainty
Predict 432.0 us/initial 24 hrs
ACQUISITION ............................................... [GPS 1PPS Valid]
Not Tracking: 0
Tracking: 6
Time
PRN El Az C/N
UTC
20:59:28
31 Jan 1996
2 71 317
40
GPS 1PPS Synchronized to UTC
7 34 185
38
ANT DLY 0 ns
19 41 101
37
Position
22 67 80
40
MODE
Survey: 71.4% complete
26 24 312
37
31 12 27
36
LAT
N 37:19:32.486
LON
W 121:59:52.082
HGT
+40.06 m (GPS)
ELEV MASK 10 deg
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-5. Receiver Status Screen Following Recovery from
Holdover Operation
You can see the Receiver has recovered from holdover almost
immediately and it has returned to locked operation.

3-10

Operating and Programming Guide

Chapter 3 Visual User Interface
Receiver Status Screen Data

Receiver Status Screen Data
This section defines the data displayed in the Receiver Status Screen,
shown in Figure 3-6.
---------------------------- Receiver Status ---------------------------SYNCHRONIZATION .......................................... [ Outputs Valid ]
Reference Outputs
SmartClock Mode
>> Locked to GPS
TFOM
3
FFOM
0
Recovery
1PPS TI +7.2 ns relative to GPS
Holdover
HOLD THR 1.000 us
Power-up
Holdover Uncertainty
Predict 49.0 us/initial 24 hrs
ACQUISITION ................................................[GPS 1PPS Valid]
Not Tracking: 1
Tracking: 6
Time
PRN El Az C/N
PRN El Az
+1 leap second pending
UTC
2
49 243
49
14 11 82
23:59:59
31 Dec 1995
GPS 1PPS Synchronized to UTC
16 24 282
46
120 ns
ANT DLY
47
18 38 154
Position
49
19 65 52
Survey: 17.5% complete
MODE
49
27 62 327
47
31 34 61
AVG LAT N 37:19:32.264
AVG LON W 121:59:52.112
+41.86 m (GPS)
AVG HGT
ELEV MASK 10 deg
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

Figure 3-6. Sample Status Screen
The status screen has three major sections:
•

SYNCHRONIZATION

•

ACQUISITION

•

HEALTH MONITOR

The SYNCHRONIZATION section of the status screen shows how the
GPS Receiver’s SmartClock technology is progressing towards its
objective, which is to synchronize the Receiver’s oscillator to the 1 PPS
reference signal produced by the Receiver’s internal GPS Engine.
The ACQUISITION section of the status screen shows how the
Receiver’s internal GPS Engine is progressing towards its objective,
which is to produce an accurate internal 1 PPS reference signal. It does
so through tracking GPS satellites.
The HEALTH MONITOR section of the status screen summarizes the
overall health of the product.

Operating and Programming Guide

3-11

Chapter 3 Visual User Interface
Receiver Status Screen Data

SYNCHRONIZATION Section of the Status Screen
SYNCHRONIZATION Summary Line
The SYNCHRONIZATION line in the screen summarizes the
SmartClock Status and Reference Outputs. One of three
SYNCHRONIZATION messages is shown:
Outputs Invalid
Outputs Valid/
Reduced Accuracy
Outputs Valid

while the Receiver (unit) is warming up,
while the unit is in holdover or is locked but has
not achieved steady-state operation, or
while the unit is in steady-state operation.

SmartClock Mode
The SmartClock Mode area of the screen shows the four operating
modes:
•

Locked to GPS

•

Recovery

•

Holdover

•

Power-up

As shown in the sample status screen in Figure 3-6, a >> symbol
indicates the current operating mode.
Locked to GPS indicates that the Receiver is locked to GPS. The
front-panel GPS Lock LED will be illuminated.
When stabilizing frequency ... is shown, the time output (1 PPS) signal is
locked and can be used, but the frequency outputs (10 MHz) are not at
their final or most stable state.
Recovery indicates that the Receiver is actively working to become
locked to GPS. All conditions needed to proceed towards a lock have
been met. Expect an eventual spontaneous transition to a lock (unless
changing external conditions prevent this, such as loss of tracked
satellites.)
Holdover indicates that the Receiver is waiting for conditions that are
needed to allow the process of recovery from holdover to begin. Once
these conditions are met, the Receiver will transition on its own to the
recovery mode.
When the GPS 1PPS CLK invalid message follows the Holdover label,
the internal GPS 1 PPS reference signal is inaccurate.
3-12

Operating and Programming Guide

Chapter 3 Visual User Interface
Receiver Status Screen Data

When the manually initiated message follows the Holdover label, the
Receiver has been placed in holdover by the user. An explicit command
is required to initiate an exit from manual holdover.
When the 1 PPS TI exceeds hold threshold message follows the
Holdover label, the phase difference between the 1 PPS time output
signal and the internal GPS 1 PPS reference signal has exceeded the
user-entered holdover threshold value.
When the internal hardware problem message follows the Holdover
label, a measurement hardware error exists.
The Holdover Duration message indicates the duration that the Receiver
has been operating in holdover (and recovery). Thus, this message
gives you an assessment of the quality of the outputs. The longer the
Receiver is in holdover the more degraded the outputs become.
Power-up indicates that the Receiver hasn’t yet achieved GPS lock or
acquired satellites since it has been powered up. The Receiver is
measuring the internal reference oscillator’s frequency and adjusting it
to 10 MHz during this power-up period. Other queries can provide
insight as to the cause if the Receiver is remaining in powerup longer
than expected.

Reference Outputs
TFOM (Time Figure of Merit) indicates the accuracy of the Receiver’s
internal 1 PPS signal. A low TFOM value indicates a more accurate
signal. In the sample screen of Figure 3-6, a value of 3 is displayed,
meaning that the Time Error ranges from 100 to 1000 nanoseconds.
The following table lists the TFOM values that could be displayed and
the corresponding Time Error.

TFOM Value

Time Error
(in nanoseconds)

TFOM Value

Time Error
(in nanoseconds)

*0

less than 1

5

104 – 105

*1

1 – 10

6

105 – 106

*2

10 – 100

7

106 – 107

3

100 – 1000

8

107 – 108

4

103 – 104

9

greater than 108

*The TFOM values 0, 1, and 2 are not presently used in the Receiver. The Receiver will display
TFOM values ranging from 9 to 3, which is consistent with the specified accuracies of each product.

Operating and Programming Guide

3-13

Chapter 3 Visual User Interface
Receiver Status Screen Data

FFOM (Frequency Figure of Merit) indicates the stability of the
Receiver’s internal 10 MHz signal. The 10 MHz signal is controlled by
the SmartClock’s Phase-Locked Loop (PLL). Thus, the FFOM value is
determined by monitoring the status of the PLL.
In the sample screen of Figure 3-6, the 0 indicates that the
SmartClock’s PLL is stabilized. The following table lists and defines
the FFOM values that could be displayed.
FFOM Value

Definition

0

PLL stabilized — internal 10 MHz signal within
specification.

1

PLL stabilizing

2

PLL unlocked (holdover) — Initially the 10 MHz signal
will be within specifications. However, when in holdover,
the 10 MHz signal will eventually drift out of
specification.

3

PLL unlocked (not in holdover) — Do not use the output.

1PPS TI indicates the difference (timing shift) between the SmartClock
1 PPS and the internal GPS 1 PPS signals.
HOLD THR (holdover threshold) displays the user-entered time error
value.

ACQUISITION Section of the Status Screen
ACQUISITION Line
The ACQUISITION line in the screen summarizes the state of the
internal GPS Engine as indicated by the Tracking, Not Tracking, and
Position areas of the screen.
If the Receiver Engine was considered to be synchronized to the GPS
signal, the [GPS 1 PPS Valid] message will appear at the end of the
ACQUISITION line. If the Receiver has not yet synchronized to GPS,
the [GPS 1 PPS CLK Invalid] message will be displayed.

Tracking, Not Tracking
The Tracking table indicates the number of satellites the Receiver is
tracking.
The Not Tracking table indicates satellites predicted to be visible that
are not tracked, and all of the satellites that are assigned to a GPS
Engine channel but are not currently tracked.
3-14

Operating and Programming Guide

Chapter 3 Visual User Interface
Receiver Status Screen Data

Health and status indicators in the tables are defined as follows:
PRN

indicates the pseudorandom noise code assigned to the
satellite.

El

indicates the predicted elevation angle, from a range of 0
to 90°. The predicted elevation is derived from the
almanac.

--

indicates that the elevation angle is unknown (the
almanac did not provide this data).

Az

indicates the predicted azimuth angle, from a range of 0
to 359°. The predicted azimuth angle is referenced to true
north, and is derived from the almanac.

---

indicates that the azimuth angle is unknown (the
almanac did not provide this data).

C/N

indicates the carrier-to-noise ratio of the received the
signal, from a range of 26 to 55. A ratio below 35 is a
weak signal that may not be acquired by the Receiver.

(58503B)

or
SS
(59551A)

indicates the strength of the signal, from a range of 0 to
255. A signal strength of 20 to 30 is a weak signal that
may not be acquired by the Receiver.

The health and status indicators in the Not Tracking table are
described as follows:
Ignore

indicates that the user has chosen to exclude this
satellite from a list of satellites available for tracking.

Not OK

indicates GPS has reported that this satellite is
unhealthy.

Acq

indicates the unit is attempting to acquire the satellite
signal.

Acq .

indicates the unit is reading timing information from
the satellite.

Acq . .

indicates the unit is reading satellite orbital
information.

ELEV MASK indicates the elevation mask angle in degrees. Satellites
at or above this elevation angle are considered for
tracking.
*attempting
to track

indicates that the Receiver is attempting to track a
satellite.

Operating and Programming Guide

3-15

Chapter 3 Visual User Interface
Receiver Status Screen Data

Time
When you first power up the unit the time and date that is stored in
the internal GPS Engine may not be the actual date. The actual time
and date will be valid after one satellite has been tracked by the
Receiver.
NOTE

There are two accurate ways to express time (GPS or UTC). GPS time
is offset from UTC time by the number of accumulated leap seconds
since midnight of January 6, 1980 UTC.

The Time area of the status screen provides three types of information:
Time, 1PPS CLK, and ANT DLY.
Time has four possible modes: GPS, UTC, LOCL GPS, and LOCAL.
GPS indicates current time and date collected from a satellite in GPS
Time.
LOCL GPS indicates GPS Time, offset for the local time zone.
UTC indicates current time and date collected from a satellite in UTC
time.
LOCAL indicates current time and date collected from a satellite offset
from UTC for the local time zone.
1PPS CLK can indicate several possible advisory messages. These
messages are:
Synchronized 1 PPS locked to GPS, referenced to GPS Time.
to GPS Time
Synchronized 1 PPS locked to GPS, referenced to UTC.
To UTC
Assessing
stability ...

applying hysteresis to locked 1 PPS signal.

Inaccurate,
not tracking

not tracking satellites.

Inaccurate,
in survey mode, but has not yet calculated a position.
inacc position
Absent or freq no 1PPS signal; or the internal GPS Engine is idle.
incorrect

3-16

Operating and Programming Guide

Chapter 3 Visual User Interface
Receiver Status Screen Data

ANT DLY (antenna delay) displays the user-entered value that is used
to compensate for the propagation delay of the antenna cable.

Position
Position area of the status screen provides four types of information:
MODE (hold or survey), LAT (latitude), LON (longitude), and HGT
(height).
MODE indicates whether the unit is set to Hold or Survey position
mode.
When Hold is displayed, the unit’s antenna position has been provided
by the user, or the average position has been found after completion of
survey.
If the unit is in the position Hold mode, the LAT, LON, and HGT “held”
position coordinates will be displayed.
If Survey: 57.3% complete is displayed, for example, the Receiver is
set to survey mode trying to determine the position of the antenna. The
% value indicates the progress of the surveying.
At the beginning of a survey (0% completion), the following “estimated”
position coordinates will be displayed:
INIT LAT indicates the estimated latitude (North or South) position of
the unit in degrees, minutes, and seconds.
INIT LON indicates the estimated longitude (East or West) position of
the unit in degrees, minutes, and seconds.
INIT HGT indicates estimated height of the unit’s antenna, in meters
above the GPS ellipsoid for 58503B (in meters above mean sea level,
MSL, for the 59551A).
Once survey starts, the following “averaged” position coordinates will
be displayed:
AVG LAT indicates the average latitude (North or South) position of the
unit in degrees, minutes, and seconds.
AVG LON indicates the average longitude (East or West) position of the
unit in degrees, minutes, and seconds.
AVG HGT indicates average height of the unit’s antenna, in meters
above the GPS ellipsoid for 58503B (in meters above mean sea level,
MSL, for the 59551A).

Operating and Programming Guide

3-17

Chapter 3 Visual User Interface
Receiver Status Screen Data

The possible advisory messages that can be displayed when position
mode is Survey are:
Suspended: track <4 sats
Suspended: poor geometry
Suspended: no track data

HEALTH MONITOR Section of the Screen
The HEALTH MONITOR section of the status screen reports errors or
failures of the key hardware functions. The OK summary message at
the end of the HEALTH MONITOR line indicates that no errors or
failures were detected. Error indicates that one or more hardware tests
failed.
For each hardware function, OK is reported when it is operating
normally; Err is displayed when a failure or an error is detected.
Hardware functions are monitored periodically, with the exception of
Self Test, which is performed at powerup or when requested.
The health and status indicators in the HEALTH MONITOR section
are described as follows:
Self Test

Last diagnostic check of the microprocessor system,
reference oscillator, satellite receiver, and power
supplies failed.

Int Pwr

Internal power supply voltage(s) exceeds tolerance.

Oven Pwr

Oscillator oven power supply voltage exceeds tolerance.

OCXO

Oscillator output failed.

EFC

Oscillator control voltage is at or near full-scale.

GPS Rcv

Satellite receiver communication failed, or GPS 1PPS
reference is absent.

3-18

Operating and Programming Guide

Chapter 3 Visual User Interface
Receiver Status Screen Data

This Page Intentionally Left Blank.

Operating and Programming Guide

3-19

Chapter 3 Visual User Interface
The Receiver Status Screen at a Glance

The Receiver Status Screen at a Glance

3-20

Operating and Programming Guide

Chapter 3 Visual User Interface
The Receiver Status Screen at a Glance

The Receiver Status Screen at a Glance (cont’d)

Operating and Programming Guide

3-21

Chapter 3 Visual User Interface
The Receiver Status Screen at a Glance

3-22

Operating and Programming Guide

4

Command Quick Reference

Chapter 4 Command Quick Reference
Chapter Contents

Chapter Contents
This chapter is a quick reference that summarizes the GPS Receiver
commands which allow you to operate and program the Receiver.
This chapter is organized as follows:
•

•

•

•

4-2

An Introduction to GPS Receiver Commands

page 4-4

–

SCPI Conformance Information

page 4-4

–

Command Syntax Conventions

page 4-4

–

Command Presentation

page 4-4

GPS Satellite Acquisition

page 4-5

–

Facilitating Initial Tracking

page 4-5

–

Establishing Position

page 4-5

–

Selecting Satellites

page 4-6

–

Compensating for Antenna Delay

page 4-6

–

Monitoring Acquisition

page 4-6

1 PPS Reference Synchronization

page 4-7

–

Monitoring 1 PPS Synchronization

page 4-7

–

Assessing 1 PPS Quality

page 4-7

–

Operating in Holdover

page 4-7

Operating Status

page 4-8

–

Receiver Operation at a Glance

page 4-8

–

Reading the Error Queue

page 4-8

–

Reading the Diagnostic Log

page 4-8

–

Monitoring Status/Alarm Conditions

page 4-8

–

Assessing Receiver Health

page 4-9

Operating and Programming Guide

Chapter 4 Command Quick Reference
Chapter Contents

•

System Time

page 4-10

–

Identifying Time of Next 1 PPS Reference Edge

page 4-10

–

Reading Current Time

page 4-10

–

Applying Local Time Zone Offset

page 4-10

–

Defining the 1 PPS Reference Edge (59551A Only)

page 4-10

–

Reading Leap Second Status

page 4-10

•

Programmable Pulse Output (59551A Only)

page 4-11

•

Event Time Stamping (59551A Only)

page 4-12

–

Defining the Time-stamped Edge

page 4-12

–

Clearing Time Stamp Memory

page 4-12

–

Reading Time Stamps

page 4-12

–

Processing Memory Overflow

page 4-12

Serial Interface Communication

page 4-13

–

Configuring I/O Port 1

page 4-13

–

Configuring I/O Port 2 (59551A Only)

page 4-13

–

Recovering the Last Query Response

page 4-13

•

•

Receiver Initialization

page 4-14

•

Receiver Identification/Upgrade

page 4-15

–

Reading Product Identification

page 4-15

–

Installing Firmware via I/O Port 1

page 4-15

•

Receiver Commands at a Glance (cont’d)/Status
Reporting System at a Glance (foldout)

Operating and Programming Guide

page 4-17

4-3

Chapter 4 Command Quick Reference
An Introduction to GPS Receiver Commands

An Introduction to GPS Receiver
Commands
SCPI Conformance Information
The SCPI commands used in the GPS Receiver are in conformance
with the SCPI Standard Version 1994.0.
Details of all the GPS Receiver commands can be found in Chapter 5,
“Command Reference,” of this guide.
Information on the SCPI commands format, syntax, parameter, and
response types is provided in Appendix B, “Command Syntax and
Style,” of this guide.

Command Syntax Conventions
POSition

NOTE

Means you MUST use either all the upper case letters or
the entire word. The lower case letters are optional.
For example, POS and POSITION are both valid.
However, POSI is not valid. (Note: POSition is used here
as an example, but this convention is true for all
command keywords.) In other words, the short form of
the keywords is shown in uppercase.

When you see quotation marks in the command’s parameter, you must
send the quotation marks with the command.

Command Presentation
The shaded commands listed in the following sections are the “basic”
(fundamental) or most commonly used commands. These commands
are essential for operating the Receiver; thus, a brief description of
each of these commands is included in this section. More complete
descriptions are provided in Chapter 5, “Command Reference.”
The non-shaded commands listed in this section are not fundamental
or not commonly used. These commands are used for one-time setup,
advanced, or specialized operation of the Receiver. Descriptions of
these commands are provided in Chapter 5 only.

4-4

Operating and Programming Guide

Chapter 4 Command Quick Reference
GPS Satellite Acquisition

GPS Satellite Acquisition
The following commands are provided to facilitate initial GPS satellite
tracking, to establish accurate GPS antenna position, to select or ignore
satellites, to compensate for antenna cable delay, and to monitor the
acquisition.

Facilitating Initial Tracking
:GPS:INITial:DATE , , 
:GPS:INITial:POSition N or S, ,
,
,
E or W, ,
,
,

or

:GPS:INITial:TIME , , 

Establishing Position
:GPS:POSition

N or S, ,
,
,
E or W, ,
,
,

or

Specifies the position of the GPS antenna.
:GPS:POSition?
Returns the current average position of the GPS antenna.

:GPS:POSition:ACTual?
Returns the current instantaneous position of the GPS antenna.

:GPS:POSition LAST
:GPS:POSition SURVey
:GPS:POSition:HOLD:LAST?
:GPS:POSition:HOLD:STATe?
:GPS:POSition:SURVey:PROGress?
:GPS:POSition:SURVey:STATe ONCE
:GPS:POSition:SURVey:STATe?
:GPS:POSition:SURVey:STATe:POWerup ON or OFF
:GPS:POSition:SURVey:STATe:POWerup?

Basic command

Operating and Programming Guide

4-5

Chapter 4 Command Quick Reference
GPS Satellite Acquisition

Selecting Satellites
:ALL
:GPS:SATellite:TRACking::NONE
:GPS:SATellite:TRACking::ALL
:GPS:SATellite:TRACking::STATe?

Operating and Programming Guide

(59551A)
(59551A)
(59551A)
(59551A)
(59551A)
...

5-7

Chapter 5 Command Reference
GPS Satellite Acquisition

! Compensating for Antenna Delay
:GPS:REFerence:ADELay ...
:GPS:REFerence:ADELay?

! Monitoring Acquisition
:GPS:REFerence:VALid?
:GPS:SATellite:TRACking?
:GPS:SATellite:VISible:PREDicted?
:GPS:SATellite:TRACking:COUNt?
:GPS:SATellite:VISible:PREDicted:COUNt?

5-8

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Facilitating Initial Tracking ______________________________

:GPS:INITial:DATE . . .
Sets an approximate date for faster initial GPS acquisition.

:SYSTem:PRESet
Not affected

VOLATILE

This command sets an approximate date for faster initial GPS acquisition.
Following powerup, the Receiver obtains the current date from satellite data.
This process occurs automatically. Providing an approximate date, however,
reduces the time to initial GPS tracking by assisting the Receiver in finding
satellites.
Expanded Syntax
:GPS:INITial:DATE ,,
Parameter

Range: the year, month, and day must be valid.
Context Dependencies

This command is valid prior to first satellite tracked (see bit 0 of the Operation
Status Register). Sending this command after this time will generate
error -221.
The initial date and time needs to be within 3 minutes of the actual date and
time to be effective in enabling faster initial GPS acquisition.

Operating and Programming Guide

5-9

Chapter 5 Command Reference
GPS Satellite Acquisition

Facilitating Initial Tracking ____________________ (continued)

:GPS:INITial:POSition . . .

:SYSTem:PRESet

Sets an approximate position for faster initial GPS acquisition.

:Not affected

VOLATILE

This command sets an approximate position for faster initial GPS acquisition.
Following powerup, the Receiver refines its position from the satellite data.
This process occurs automatically. This command is most effective when the
retained position differs significantly from the Receiver’s true position.
Expanded Syntax
:GPS:INITial:POSition N or S, ,
,
,
E or W, ,
,
,

or

Parameter

This command requires three position coordinates: latitude, longitude, and
height. Position must be specified with respect to the World Geodetic System
1984 (WGS-1984) datum absolute earth coordinates.
The latitude coordinate is preceded by either N or S, which denotes the
northern or southern hemisphere, respectively. The longitude coordinate is
preceded by either E or W, which denotes the eastern or western hemisphere,
respectively.
The following table lists the allowed settings of other parameters:
Parameter

Range

Precision

Parameter

Range

Precision



0 to 90

1



0 to 180

1



0 to 59

1



0 to 59

1



0 to 59.999

0.001



0 to 59.999

0.001



-1000.00 to
18,000.00

0.01

Context Dependencies

This command is valid while the Receiver is in survey mode prior to first
computed position. Sending this command while the Receiver is not in survey
mode will generate error -221.

5-10

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Facilitating Initial Tracking ____________________ (continued)

:GPS:INITial:TIME . . .

:SYSTem:PRESet

Sets an approximate time for faster initial GPS acquisition.

Not affected

VOLATILE

This command sets an approximate time for faster initial GPS acquisition.
Following powerup, the Receiver obtains the current time from satellite data.
This process occurs automatically. Providing an approximate time, however,
reduces the time to initial GPS tracking by assisting the Receiver in finding
satellites.
Expanded Syntax
:GPS:INITial:TIME ,,
Parameter

Range: all parameters (hour, minutes, seconds) must be valid.
Context Dependencies

This command is valid prior to first satellite tracked (see bit 0 of the Operation
Status Register). Sending this command after this time will generate
error -221.
The initial date and time needs to be within 3 minutes of the actual date and
time to be effective in enabling faster initial GPS acquisition.

Operating and Programming Guide

5-11

Chapter 5 Command Reference
GPS Satellite Acquisition

Establishing Position_____________________________________

:GPS:POSition . . .

:SYSTem:PRESet

Defines the position of the Receiver.

latitude:
longitude:
height:

N 0:00:00.000
E 0:00:00.000
0 meters

NON-VOLATILE

This command defines the position of the Receiver. The Receiver uses this
position to predict satellite visibility and to determine time. An accurate
position is necessary for precise time transfer.
Expanded Syntax
:GPS:POSition

N or S, ,
,
,
E or W, ,
,
,

or


:GPS:POSition LAST
:GPS:POSition SURVey
Parameter

The numeric form of this command requires three position coordinates:
latitude, longitude, and height. Position must be specified with respect to the
World Geodetic System 1984 (WGS-1984) datum absolute earth coordinates.
The latitude coordinate is preceded by either N or S, which denotes the
northern or southern hemisphere, respectively. The longitude coordinate is
preceded by either E or W, which denotes the eastern or western hemisphere,
respectively.
The following table lists the allowed settings of other parameters:
Parameter

Range

Precision

Parameter

Range

Precision



0 to 90

1



0 to 180

1



0 to 59

1



0 to 59

1



0 to 59.999

0.001



0 to 59.999

0.001



-1000.00 to
18,000.00

0.01

5-12

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Establishing Position ___________________________ (continued)
LAST denotes the last specified position. This parameter is provided to cancel
surveying (automatic position computation) and restore the last position
setting.
SURVey directs the Receiver to stop surveying and use the computed position.
This position is the average of individual position computations.
Context Dependencies

Error -221 is generated if this command is sent as SURV and no valid survey
calculation has ever been computed.
Side Effects

This command stops position surveying. The computed position is retained and
applied only when SURVey is specified.

:GPS:POSition?

RESPONSE FORMAT

Returns the current average position of the GPS antenna.

XYZ or
± dd or
± d.dEe,
...

This query returns the current average position of the Receiver.
Response

Returns a list of values defining the Receiver position:
N or S, , , ,
E or W, ,, ,
 or .

Context Dependencies

Error -230 is generated if in survey and first calculation has not occurred.

Operating and Programming Guide

5-13

Chapter 5 Command Reference
GPS Satellite Acquisition

Establishing Position___________________________ (continued)

:GPS:POSition:ACTual?

RESPONSE FORMAT

Returns the current instantaneous position of the GPS antenna.

XYZ or
± dd or
± d.dEe,
...

This query returns the current instantaneous position of the GPS antenna.
Response

Returns a list of values defining the Receiver position:
N or S, , , ,
E or W, ,, ,
 or .
Context Dependencies

Error -230 is generated if in survey and first calculation has not occurred.

:GPS:POSition:HOLD:LAST?

RESPONSE FORMAT

Returns the last position-hold setting.

XYZ or
± dd or
± d.dEe,
...

This query returns the last position-hold setting, which is restored when the
:GPS:POSition LAST command is sent. Refer to the description of the
:GPS:POSition command on page 5-13 for details.
Response

Returns a list of values defining the Receiver position:
N or S, , , ,
E or W, ,, ,
 or .
Context Dependencies

This query is always valid, but if the Receiver has not been in position-hold
mode since it was preset (see :SYSTem:PRESet), the value returned will be the
preset position.

5-14

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Establishing Position ___________________________ (continued)

:GPS:POSition:HOLD:STATe?
Identifies whether the Receiver is in position-hold or survey mode.

RESPONSE FORMAT

0 or 1

This query identifies whether the Receiver is in position-hold or survey mode.
In survey mode, the Receiver continually refines its position. In position-hold
mode, the position setting does not change.
Response

A value of 0 indicates not in position hold (in survey mode); a value of 1
indicates in position hold.

:GPS:POSition:SURVey:PROGress?
Returns percent completed while in survey mode.

RESPONSE FORMAT

± d.d

This query returns percent completed while in survey mode. Automatic
transition to position-hold mode occurs following completion of survey mode
(indicated by 100).
Response

The range is 0 to 100%. The units are percent.
Context Dependencies

This query is only valid while surveying for position (:GPS:POS:SURV:STATe?
returns ONCE or status bit 3 = 0 in the Operation Status Register). If queried
while not surveying, error -221 is generated.

:GPS:POSition:SURVey:STATe . . .
Initiates survey mode during which the Receiver determines its
position from satellite data.

:SYSTem:PRESet

ONCE

This command initiates survey mode during which the Receiver determines its
position from satellite data. The Receiver refines successive positional
estimates to obtain a final position, transitions from survey to position-hold
mode.
Expanded Syntax
:GPS:POSition:SURVey:STATe ONCE

Operating and Programming Guide

5-15

Chapter 5 Command Reference
GPS Satellite Acquisition

Establishing Position___________________________ (continued)

:GPS:POSition:SURVey:STATe?

RESPONSE FORMAT

Identifies whether the Receiver is in survey or position-hold mode.

XYZ or 0

This query identifies whether the Receiver is in survey or position-hold mode.
In survey mode, the Receiver continually refines its position. In position-hold
mode, the position does not change.
Response

A response of ONCE indicates that the Receiver is in survey mode. A response
of 0 indicates the Receiver is in position-hold mode.

:GPS:POSition:SURVey:STATe:POWerup . . .

:SYSTem:PRESet

Selects position mode to be used at powerup.

ON
NON-VOLATILE

This command specifies whether the Receiver always surveys at powerup or
restores its last position at powerup.
Expanded Syntax
:GPS:POSition:SURVey:STATe:POWerup ON or OFF
Parameter

OFF sets the Receiver to powerup in the last valid position. ON sets the
Receiver to survey on powerup.

:GPS:POSition:SURVey:STATe:POWerup?

RESPONSE FORMAT

Returns the position mode to be used at powerup.

0 or 1

This query returns the position mode to be used at powerup.
Response

A value of 0 indicates the Receiver is set to powerup in the last valid position.
A value of 1 indicates the Receiver is set to survey on powerup.

5-16

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Selecting Satellites _______________________________________

:GPS:SATellite:TRACking:EMANgle . . .
Sets the GPS elevation mask angle value (in degrees).

:SYSTem:PRESet

10
NON-VOLATILE

This command instructs the Receiver to allow tracking those satellites for
which the elevation angle is greater than this elevation mask angle. Satellites
below this elevation are visible, but will not be tracked.
Expanded Syntax
:GPS:SATellite:TRACking:EMANgle 
Parameter

 range is 0 degrees (horizon) to 89 degrees. The resolution is
1 degree.
The maximum recommended value while the position is being surveyed is
15 degrees, to allow tracking of four satellites needed for an accurate position
determination.
Once the survey is complete, the elevation mask angle can be increased to avoid
interference problems caused by buildings and trees and minimize effects of
multipath, if necessary.
Values above 40 degrees severely limit GPS signal availability, and are not
recommended.

:GPS:SATellite:TRACking:EMANgle?
Returns the GPS elevation mask angle value.

RESPONSE FORMAT

± dd

This query returns the GPS elevation mask angle value.
Response

The range is 0 degrees to 89 degrees.

Operating and Programming Guide

5-17

Chapter 5 Command Reference
GPS Satellite Acquisition

Selecting Satellites _____________________________(continued)
59551A

:GPS:SATellite:TRACking:IGNore . . .

:SYSTem:PRESet

Adds the specified satellites to the list that the Receiver ignores
for tracking.

No satellites ignored

NON-VOLATILE

This command adds the specified satellites to the list that the Receiver ignores
for tracking. Each satellite is identified by its pseudorandom noise code (PRN).
Expanded Syntax
:GPS:SATellite:TRACking:IGNore , . . ., 
:GPS:SATellite:TRACking:IGNore:NONE
:GPS:SATellite:TRACking:IGNore:ALL
Parameter

 parameter is the pseudorandom noise code of the satellite(s) you want
the Receiver to ignore. Each satellite has its own unique PRN.
Context Dependencies

This command is always valid. On send, if any item in the  list is
invalid, the entire list will be rejected. Error -222 will be generated.

59551A

:GPS:SATellite:TRACking:IGNore?
Returns list of satellites to ignore.

RESPONSE FORMAT

± dd, ...

This query returns a list of satellites to ignore for tracking. Each satellite is
identified by its pseudorandom noise code (PRN). Zero (0) indicates no
satellites being ignored.
Response

A value of 0 indicates no satellites being ignored. If any satellite is being
ignored, the pseudorandom noise code (PRN) of the satellite is returned.
Context Dependencies

This query is always valid.

5-18

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Selecting Satellites _____________________________(continued)
59551A

:GPS:SATellite:TRACking:INCLude . . .
Adds the specified satellites to the list that the Receiver considers
for tracking.

:SYSTem:PRESet
All satellites included

NON-VOLATILE

This command adds the specified satellites to the list that the Receiver
considers for tracking. Actual satellite selection is based on satellite visibility,
geometry, and health.
Expanded Syntax
:GPS:SATellite:TRACking:INCLude , . . ., 
:GPS:SATellite:TRACking:INCLude:NONE
:GPS:SATellite:TRACking:INCLude:ALL
Parameter

 parameter is the pseudorandom noise code of the satellite(s) you want
the Receiver to include. Each satellite has its own unique PRN.
Context Dependencies

This command is always valid. On send, if any item in the  list is
invalid, the entire list will be rejected. Error -222 will be generated.

59551A

:GPS:SATellite:TRACking:INCLude?
Returns a list of satellites to include.

RESPONSE FORMAT

± dd, ...

This query returns a list of satellites to include for tracking. Each satellite is
identified by its pseudorandom noise code (PRN). Zero (0) indicates no
satellites being included (i.e., the satellites are still on the ignored list).
Context Dependencies

This query is always valid.

Operating and Programming Guide

5-19

Chapter 5 Command Reference
GPS Satellite Acquisition

Selecting Satellites______________________________ (continued)

:GPS:SATellite:TRACking:IGNore:COUNt?
Returns the number of satellites that are on the list to ignore for
tracking.

RESPONSE FORMAT

± dd

:GPS:SATellite:TRACking:INClude:COUNt?
Returns the number of satellites that are on the list to include for
tracking.

± dd

The query :GPS:SATellite:TRACking:IGNore:COUNt? returns the number of
satellites that are on the list to ignore for tracking.
The query :GPS:SATellite:TRACking:INClude:COUNt? returns the number of
satellites that are on the list to be included for tracking.
Response

There may be some delay between changes made to the list of satellites being
ignored and their actual removal and inclusion in the tracking process.
At :SYSTem:PRESet, all satellites are put on the list to include for tracking.

5-20

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Selecting Satellites______________________________ (continued)

:GPS:SATellite:TRACking:IGNore:STATe? . . .
Returns the ignored status of individual satellites.

RESPONSE FORMAT

0 or 1

:GPS:SATellite:TRACking:INClude:STATe? . . .
Returns the include status of the specified satellite.

0 or 1

The query :GPS:SATellite:TRACking:IGNore:STATe? returns the ignored
status of the specified satellite. A satellite is specified by its pseudorandom
noise code (PRN).
The query :GPS:SATellite:TRACking:INClude:STATe? returns the include
status of the specified satellite. A satellite is specified by its pseudorandom
noise code (PRN).
There may be some delay between changes made to the list of satellites being
ignored and their actual removal and inclusion in the tracking process.
Expanded Syntax
:GPS:SATellite:TRACking:IGNore:STATe? 
:GPS:SATellite:TRACking:INClude:STATe? 
Parameter

 parameter is the pseudorandom noise code of the satellite(s) you want
the Receiver to ignore or include. Each satellite has its own unique PRN.
Response

A value of 0 indicates not on the selected list.
A value of 1 indicates on the selected list.
Context Dependencies

After a :SYSTem:PRESet, all satellites are removed from the list to ignore.

Operating and Programming Guide

5-21

Chapter 5 Command Reference
GPS Satellite Acquisition

Compensating for Antenna Delay_________________________

:GPS:REFerence:ADELay . . .

:SYSTem:PRESet

Sets the GPS antenna delay value in seconds.

0.0
NON-VOLATILE

This command sets the GPS antenna delay value in seconds. It instructs the
Receiver to output its 1 PPS output pulse earlier in time to compensate for
antenna cable delay.
CAUTION

Using this command while the Receiver is in normal locked operation could
cause the Receiver go into holdover.
Expanded Syntax
:GPS:REFerence:ADELay 
Parameter

Numeric_value range is 0 to 0 .000999999 seconds. The resolution is
1 nanosecond.
Zero cable delay is set for a zero-length antenna cable. Consult a cable data
book for the delay per meter for the particular antenna cable used in order to
compute the total cable delay needed for a particular installation.
See Also
:GPS:REFerence:ADELay?

The tables below list the delay values that you need to use with the
:GPS:REFERENCE:ADELAY  command for the available cable
assemblies.

Delay Values for the 58518A/519A and 58518AA/519AA RG-213 Antenna
Cables
Cable Option

Length

RG 213 or Belden 8267
Antenna Delay
Value

001

1m

5.0 nanoseconds

002

2m

10.3 nanoseconds

005

5m

25.2 nanoseconds

010

10 m

50.5 nanoseconds

015

15 m

75.7 nanoseconds

030

30 m

151.5 nanoseconds

050

50 m

252.5 nanoseconds

The nominal delay value is labeled on the cables. Refer to the Designing Your
GPS Antenna System Configuration Guide for more information.

5-22

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Compensating for Antenna Delay_____________(continued)

Delay Values for the 58520A/521A and 58520AA/521A LMR 400
Antenna Cables
Cable Option

Length

LMR 400 Antenna Delay Value

001

1m

3.9 nanoseconds

002

2m

8.0 nanoseconds

005

5m

19.6 nanoseconds

010

10 m

39.3 nanoseconds

015

15 m

59.0 nanoseconds

030

30 m

118.0 nanoseconds

060

60 m

236.1 nanoseconds

110

110 m

432.9 nanoseconds

The nominal delay value is labeled on the cables. Refer to the Designing Your
GPS Antenna System Configuration Guide for more information.

:GPS:REFerence:ADELay?
Returns the GPS antenna delay value in seconds.

RESPONSE FORMAT

± d.dEe

This query returns the GPS antenna delay value in seconds. This is the delay
value set by the system installer (or the factory default). It is not a value
measured by the Receiver.
Response

The time units are seconds.

Operating and Programming Guide

5-23

Chapter 5 Command Reference
GPS Satellite Acquisition

Monitoring Acquisition ___________________________________

:GPS:REFerence:VALid?

RESPONSE FORMAT

Identifies whether the 1 PPS signal is valid.

0 or 1

This query identifies that the 1 PPS signal has locked to a valid GPS reference
and the 1 PPS signal itself is valid.
Response

A value of 1 indicates signal is valid.
A value of 0 indicates signal is not valid.

:GPS:SATellite:TRACking?

RESPONSE FORMAT

± dd, ...

Returns a list of all satellites being tracked.

This query returns a list of all satellites being tracked. Each satellite is
identified by its pseudorandom noise code (PRN).
Response

A comma-separated list of satellite pseudorandom noise codes ().
The range of each  is 1 to 32.
A response of 0 indicates no satellites being tracked.

5-24

Operating and Programming Guide

Chapter 5 Command Reference
GPS Satellite Acquisition

Monitoring Acquisition _________________________ (continued)

:GPS:SATellite:VISible:PREDicted?

RESPONSE FORMAT

± dd, ...

Returns the list of satellites (PRN) that the almanac predicts
should be visible, given date, time, and location.

This query returns the list of satellites (PRN) that the almanac predicts should
be visible, given date, time, and location (if any of these values are incorrect,
the prediction will be incorrect). Each satellite is identified by its
pseudorandom noise code (PRN).
Response

A comma-separated list of satellite pseudorandom noise codes ().
The range of each  is 1 to 32.
A response of 0 indicates no satellites predicted visible.
Theory

Satellites must be in view to be tracked. At least four satellites must be in view,
and tracked, to determine the position in position survey operation. Only one
satellite must be in view, and tracked, to maintain operation of the reference
oscillator locked to GPS when in position hold operation.

:GPS:SATellite:TRACking:COUNt?

RESPONSE FORMAT

Returns the number of satellites being tracked.

± dd

This query returns the number of satellites being tracked.
Response

If there are no satellites being tracked, this query returns a 0.

Operating and Programming Guide

5-25

Chapter 5 Command Reference
GPS Satellite Acquisition

Monitoring Acquisition _________________________ (continued)

:GPS:SATellite:VISible:PREDicted:COUNt?
Returns the number of satellites that the almanac predicts should
be visible, given date, time, and location.

RESPONSE FORMAT

± dd

This query returns the number of satellites that the almanac predicts should
be visible, given date, time, and location (if any of these are incorrect, the
prediction will be incorrect).
Response

Number of satellites predicted visible.
Theory

Satellites must be in view to be tracked. At least four satellites must be in view,
and tracked, to determine the position in position survey operation. Only one
satellite must be in view, and tracked, to maintain operation of the reference
oscillator locked to GPS when in position hold operation.

5-26

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

1 PPS Reference Synchronization
1 PPS and 10 MHz (58503B only) output signals are generated by the
Receiver’s internal reference oscillator. This oscillator is synchronized
(phased locked) to GPS while a sufficient number of satellites are tracked.
When the GPS signal is interrupted or absent, the Receiver maintains timing
and frequency accuracy through its oscillator “holdover” process. While in
holdover, the frequency of the reference oscillator is adjusted as necessary to
compensate for aging characteristics. The Receiver returns to “locked”
operation through a “holdover recovery” process.
The following commands are provided to monitor the operating mode of the
reference oscillator, to determine the accuracy and stability of the reference
output signal(s), and to control the oscillator holdover process.
! Monitoring 1 PPS Synchronization
:SYNChronization:STATe?
:DIAGnostic:ROSCillator:EFControl:RELative?
:LED:GPSLock?
:LED:HOLDover?

! Assessing 1 PPS Quality
:SYNChronization:FFOMerit?
:SYNChronization:HOLDover:TUNCertainty:PREDicted?
:SYNChronization:HOLDover:TUNCertainty:PRESent?
:SYNChronization:TFOMerit?
:SYNChronization:TINTerval?
:SYNChronization:HOLDover:DURation?
:SYNChronization:HOLDover:DURation:THReshold ...
:SYNChronization:HOLDover:DURation:THReshold?
:SYNChronization:HOLDover:DURation:THReshold:EXCeeded?

! Operating in Holdover
" Initiating Manual Holdover
:SYNChronization:HOLDover:INITiate

" Recovering from Holdover
:SYNChronization:HOLDover:WAITing?
:SYNChronization:HOLDover:RECovery:INITiate
:SYNChronization:HOLDover:RECovery:LIMit:IGNore
:SYNChronization:IMMediate

Operating and Programming Guide

5-27

Chapter 5 Command Reference
1 PPS Reference Synchronization

Monitoring 1 PPS Synchronization _______________________

:SYNChronization:STATe?

RESPONSE FORMAT

Returns the Receiver state.

XYZ

This query returns the Receiver state.
Response

OFF, or HOLD, or WAIT, or REC, or LOCK, or POW.
OFF indicates in diagnostic mode or a temporary start-up mode; HOLD
indicates in manual holdover; WAIT indicates waiting for external conditions
to allow recovery from holdover; REC indicates actively recovering from
holdover; LOCK indicates locked to GPS; POW indicates in powerup prior to
first lock.
Context Dependencies

:SYSTem:PRESet sets the state to POWerup.

:DIAGnostic:ROSCillator:EFControl:RELative?
Returns the Electronic Frequency Control (EFC) output value of
the internal reference oscillator.

RESPONSE FORMAT

± d.dEe

This query returns the Electronic Frequency Control (EFC) output value of the
internal reference oscillator. It returns a percentage value.
Response

Range is -100% to +100%.

5-28

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

Monitoring 1 PPS Synchronization _____________ (continued)

:LED:GPSLock?
Returns the state of the front-panel GPS Lock LED.

RESPONSE FORMAT

0 or 1

This query returns the state of the front-panel GPS Lock LED. The Receiver
sets this indicator during normal operation when it has locked the internal
reference oscillator and 1 PPS output to GPS.
Response

A value of 0 indicates the LED is off.
A value of 1 indicates the LED is on.

:LED:HOLDover?
Returns the state of the front–panel Holdover LED.

RESPONSE FORMAT

0 or 1

This query returns the state of the front-panel Holdover LED. The Receiver
sets this indicator when in holdover operation.
Response

A value of 0 indicates the LED is off.
A value of 1 indicates the LED is on.

Operating and Programming Guide

5-29

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality__________________________________

:SYNChronization:FFOMerit?
Returns the Frequency Figure of Merit.

RESPONSE FORMAT

± dd

This query returns the Frequency Figure of Merit (FFOM). Use this query
when you want to know the stability of the Receiver’s 10 MHz output.
The 10 MHz output is controlled by the SmartClock’s Phase-Locked Loop
(PLL). Thus, the FFOM value is determined by monitoring the status of
the PLL.
Response

The following table lists and defines the FFOM values (0 thru 3) that could be
returned.
FFOM Value

Definition

0

PLL stabilized—10 MHz output within specification.

1

PLL stabilizing

2

PLL unlocked (holdover)—Initially the 10 MHz output will be
within specifications. However, when in holdover, the 10 MHz
output will eventually drift out of specification.

3

PLL unlocked (not in holdover)—Do not use the output.

5-30

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality ________________________ (continued)

:SYNChronization:HOLDover:TUNCertainty:PREDicted?
Returns an estimate of the time interval error that can be expected
for a one day holdover, given the current state of SmartClock
learning in the Receiver.

RESPONSE FORMAT

± d.dEe, 0 or 1

This query returns an estimate of the time interval error that can be expected
for a one day holdover, given the current state of SmartClock learning in the
Receiver.
Response

The first number in the response is the estimated time interval error. The units
are seconds, the resolution is 100 nanoseconds.
The second number in the response identifies the holdover state. A value of 0
indicates the Receiver is not in holdover; a value of 1 indicates the Receiver is
in holdover.
Context Dependencies

This query is not valid prior to first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet. Sending this query before first
lock will generate error -230.

:SYNChronization:HOLDover:TUNCertainty:PRESent?
Returns the current time interval error during holdover operation,
given the current state of SmartClock learning in the Receiver.

RESPONSE FORMAT

± d.dEe

This query returns the current time error during holdover operation, given the
current state of SmartClock learning in the Receiver.
Response

The time error units are seconds.
Context Dependencies

This query is valid when the Receiver is in holdover. If not in holdover,
error -230 is generated.

Operating and Programming Guide

5-31

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality ________________________ (continued)

:SYNChronization:TFOMerit?

RESPONSE FORMAT

± dd

Returns the Time Figure of Merit.

This query returns the Time Figure of Merit. Use this query when you want to
know the accuracy of the Receiver’s 1 PPS output. A low TFOM value indicates
a more accurate output. A value of 3 indicates that the Time Error ranges from
100 to 1000 nanoseconds.
Response

The following table lists the TFOM values that could be returned and provides
the corresponding Time Error.
TFOM Value

Time Error
(in nanoseconds)

TFOM Value

Time Error
(in nanoseconds)

0*

less than 1

5

104–105

1*

1–10

6

105–106

2*

10–100

7

106–107

3

100–1000

8

107–108

4

103–104

9

greater than 108

* The TFOM values 0, 1, and 2 are not presently used in the 58503B and 59551A products. The
58503B and 59551A products will display TFOM values ranging from 9 to 3, which is consistent with
the specified accuracies of each product

:SYNChronization:TINTerval?

RESPONSE FORMAT

Returns the difference or timing shift between the SmartClock 1
PPS and the GPS 1 PPS signals.

± d.dEe

This query returns the difference or timing shift between the SmartClock
1 PPS and the GPS 1 PPS signals. It generates an error when this interval is
unavailable (That is, if no GPS 1 PPS).
Response

Time interval units are seconds.
Resolution is 1E-10 seconds.

5-32

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality ________________________ (continued)

:SYNChronization:HOLDover:DURation?
Returns the duration of the present or most recent period of
operation in the holdover and holdover processes.

RESPONSE FORMAT

± d.dEe, 0 or 1

This query returns the duration of the present or most recent period of
operation in the holdover and holdover processes. This is the length of time the
reference oscillator was not locked to GPS. The time units are seconds.
Response

The first number in the response is the holdover duration. The duration units
are seconds, and the resolution is 1 second.
If the Receiver is in holdover, the response quantifies the current holdover
duration. If the Receiver is not in holdover, the response quantifies the
previous holdover.
The second number in the response identifies the holdover state. A value of 0
indicates the Receiver is not in holdover; a value of 1 indicates the Receiver is
in holdover.
Context Dependencies

This query is always valid. If this query is sent before the first holdover has
occurred, the response will be 0,0, indicating that the Receiver is currently not
in holdover and last holdover duration was 0 seconds (user infers there has not
been one yet).
Set to 0,0 after a :SYSTem:PRESet. If there was a prior holdover, the duration
will be lost.

Operating and Programming Guide

5-33

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality ________________________ (continued)

:SYNChronization:HOLDover:DURation:THReshold . . .
Sets the duration (in seconds) to be used as a limit each time
holdover begins.

:SYSTem:PRESet

86400
(i.e., 1 day)
NON-VOLATILE

This command sets the duration (in seconds) which represents a limit against
which the elapsed time of holdover is compared. If the elapsed time in holdover
(and associated processes) exceeds the limit, a flag is set. The flag indicating
the limit is exceeded can be queried using the
:SYNC:HOLD:DUR:THR:EXCeeded? query.
Expanded Syntax
:SYNChronization:HOLDover:DURation:THReshold 
Parameter

Resolution of the  parameter is 1 second.

:SYNChronization:HOLDover:DURation:THReshold?
Returns the duration (in seconds) which represents a limit against
which the elapsed time of holdover is compared.

RESPONSE FORMAT

± dd

This query returns the duration (in seconds) which represents a limit against
which the elapsed time of holdover is compared. If the elapsed time of holdover
(and associated processes) exceeds the limit, a flag is set.
Expanded Syntax
:SYNChronization:HOLDover:DURation:THReshold?
Response

The threshold units are seconds.
The resolution is 1 second

5-34

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

Assessing 1 PPS Quality ________________________ (continued)

:SYNChronization:HOLDover:DURation:THReshold
:EXCeeded?
Identifies if the Receiver has been in holdover longer than the
amount of time specified by the THReshold command.

RESPONSE FORMAT

0 or 1

This query identifies if the Receiver has been in holdover longer than the
amount of time specified by the THReshold command. If it has, 1 will be
returned.
Response

A value of 1 indicates that the Receiver is in holdover, and has been operating
in holdover for a duration that exceeds the specified duration.
The value 0 indicates either the Receiver is not in holdover, or it has been in
holdover for less than the specified duration.

Operating and Programming Guide

5-35

Chapter 5 Command Reference
1 PPS Reference Synchronization

Operating in Holdover ____________________________________
" Initiating Manual Holdover __________________________________

:SYNChronization:HOLDover:INITiate
Places the Receiver in holdover mode.

EVENT

This command places the Receiver in holdover mode. The Receiver will stay in
holdover until you send :SYNC:HOLD:REC:INIT.
Context Dependencies

This command is not valid prior to the first lock following powerup (see bit 2 of
the Powerup Status Register) or :SYSTem:PRESet. Sending this command
before the first lock will generate error -221.
See Also
:SYNChronization:HOLDover:RECovery:INITiate

5-36

Operating and Programming Guide

Chapter 5 Command Reference
1 PPS Reference Synchronization

Operating in Holdover __________________________ (continued)
" Recovering from Holdover _________________________________

:SYNChronization:HOLDover:WAITing?
Returns prioritized reason for why the Receiver is waiting to
recover.

RESPONSE FORMAT

XYZ

This query returns prioritized reason for why the Receiver is waiting to
recover.
Response

HARD indicates there is an internal hardware reason, GPS indicates there are
no satellites, LIM indicates the time interval between GPS and internal
oscillator is exceeding the limit, and NONE indicates the Receiver isn’t waiting
to recover.
Note that if holdover has been initiated by sending the :SYNC:HOLD:INIT
command, the Receiver is not waiting to recover; the response is NONE.
This query is always valid. If not in holdover and waiting to recover, NONE will
be the response.

:SYNChronization:HOLDover:RECovery:INITiate
Initiates a recovery from manually initiated holdover.

EVENT

This command initiates a recovery from manually initiated holdover. Use this
command to take the Receiver out of a manually selected holdover. This
command is not needed to initiate holdover recovery in any other situation.
See Also
:SYNChronization:HOLDover:INITiate

Operating and Programming Guide

5-37

Chapter 5 Command Reference
1 PPS Reference Synchronization

Operating in Holdover __________________________ (continued)
" Recovering from Holdover (continued)

:SYNChronization:HOLDover:RECovery:LIMit:IGNore
Initiates recovery from holdover if recovery was inhibited by time
intervals exceeding limit.

EVENT

This command initiates recovery from holdover if recovery was inhibited by
time intervals exceeding limit.
The time interval used for this comparison is the time interval between the
internal oscillator’s 1 PPS edge and the GPS system’s 1 PPS edge. When this
time interval consistently exceeds the specified limit, the instrument enters
the holdover state, “Waiting to Recover.”
Recovery is initiated when the time intervals consistently fall within limits,
or when the limit is ignored by issuing this command.

:SYNChronization:IMMediate
Initiates a near-instantaneous alignment of the GPS 1 PPS and
Receiver output 1 PPS if the command is issued during recovery
from holdover.

EVENT

This command initiates a near-instantaneous alignment of the GPS 1 PPS and
Receiver output 1 PPS if the command is issued during recovery from holdover.
Context Dependencies

This command is only valid when recovering from holdover. See bit 2 of the
Holdover Status Register (if it is 1, this command is okay). Sending this
command when the Receiver is not recovering will generate error -221.

5-38

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Operating Status
This section describes the commands that can be use to obtain Receiver status
information. There are several ways to obtain Receiver status using
commands. For example, you can send a command to display the Receiver
Status screen, to read the error queue, and to read the diagnostic log. You can
also send a sequence of commands to read and control the status registers for
alarm generation.
This section defines all of the commands used for status reporting.
A comprehensive discussion on how you can monitor and control alarm
conditions using the status registers is included.
! Receiver Operation at a Glance
:SYSTem:STATus?
:SYSTem:STATus:LENGth?

! Reading the Error Queue
:SYSTem:ERRor?

! Reading the Diagnostic Log
:DIAGnostic:LOG:CLEar
:DIAGnostic:LOG:READ:ALL?
:DIAGnostic:LOG:CLEar ...
:DIAGnostic:LOG:COUNt?
:DIAGnostic:LOG:READ?
:DIAGnostic:LOG:READ? ...

! Monitoring Status/Alarm Conditions
" Clearing and Presetting Alarms
*CLS
:STATus:PRESet:ALARm

" Reading and Qualifying Alarms
:LED:ALARm?
*SRE ...
*SRE?
*STB?

Operating and Programming Guide

5-39

Chapter 5 Command Reference
Operating Status

" Reading and Qualifying Receiver Status
 = OPERation
 = OPERation:HARDware
 = OPERation:HOLDover
 = OPERation:POWerup

 = QUEStionable

:STATus::CONDition?
:STATus::EVENt?
:STATus::ENABle ...
:STATus::ENABle?
:STATus::NTRansition ...
:STATus::NTRansition?
:STATus::PTRansition ...
:STATus::PTRansition?

" Reading and Qualifying Command Error Status
*ESE ...
*ESE?
*ESR?

" Reporting Questionable Status
:STATus:QUEStionable:CONDition:USER ...
:STATus:QUEStionable:EVENt:USER ...

! Assessing Receiver Health
*TST?
:DIAGnostic:LIFetime:COUNt?
:DIAGnostic:TEST? ...
:DIAGnostic:TEST:RESult?

5-40

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Receiver Operation at a Glance ___________________________

:SYSTem:STATus?
Outputs a formatted status screen.

RESPONSE FORMAT

ASCII Data

This query outputs a formatted Receiver Status screen. Use this screen to
monitor GPS acquisition, derivation of time and position, and synchronization
of reference outputs to GPS.
Refer to Chapter 3, “Visual User Interface,” for detailed information on the
Receiver Status screen.
Response

Sending this command will display a status screen similar to the following
figure (58503B screen is shown in this figure).

---------------------------- Receiver Status ---------------------------SYNCHRONIZATION .......................................... [ Outputs Valid ]
Reference Outputs
SmartClock Mode
>> Locked to GPS
TFOM
FFOM
3
0
Recovery
1PPS TI +7.2 ns relative to GPS
Holdover
HOLD THR 1.000 us
Power-up
Holdover Uncertainty
Predict 49.0 us/initial 24 hrs
ACQUISITION ................................................[GPS 1PPS Valid]
Not Tracking: 1
Tracking: 6
Time
+1 leap second pending
PRN El Az C/N
PRN El Az
UTC
23:59:59
31 Dec 1995
2
49 243
49
14 11 82
GPS 1PPS Synchronized to UTC
16 24 282
44
ANT DLY
120 ns
49
18 38 154
Position
43
19 65 52
MODE
Survey: 17.5% complete
44
27 62 327
38
31 34 61
AVG LAT N 37:19:32.264
AVG LON W 121:59:52.112
AVG HGT
+41.86 m (GPS)
ELEV MASK 10 deg
HEALTH MONITOR ...................................................... [ OK ]
Self Test: OK Int Pwr: OK Oven Pwr: OK
OCXO: OK
EFC: OK
GPS Rcv: OK

:SYSTem:STATus:LENGth?
Returns the number of lines of formatted text that are in the
Receiver Status screen.

RESPONSE FORMAT

± dd

This query returns the number of lines of formatted text that are in the
Receiver Status screen.

Operating and Programming Guide

5-41

Chapter 5 Command Reference
Operating Status

Reading the Error Queue _________________________________

:SYSTem:ERRor?

RESPONSE FORMAT

Returns the oldest error in the Error Queue and removes that error
from the queue (first in, first out).

± dd,“XYZ”

This query returns the oldest error in the Error Queue and removes that error
from the queue (first in, first out).
See Appendix A, “Error Messages,” in this guide for detailed error information.
Response

The error response format is: , “”, where
•

The  is an integer transferred as ASCII bytes in
format (integer). The range is -32768 to 32767.

•

Negative error numbers are defined by the SCPI standard.

•

Positive error numbers are defined specifically for this Receiver.

•

An error number value of zero indicates that the Error Queue is empty.

•

The maximum length of the  is 255 characters.

Context Dependencies

:SYSTem:PRESet clears the Error Queue.
The queue is cleared (emptied) on *CLS, power-on, or upon reading the last
error from the queue.
If the Error Queue overflows, the last error in the queue is replaced with the
error -350, "Queue overflow". Any time the queue overflows, the least recent
errors remain in the queue and the most recent error is discarded.
The maximum length of the Error Queue is 30.

5-42

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Reading the Diagnostic Log ______________________________
The Diagnostic Log is one way to obtain Receiver status.
The following activities and events are recorded in the diagnostic log:
•

power-on sequence,

•

automatic or manual transitions between locked, and holdover,

•

automatic or manual transitions between position survey and position
hold operation,

•

alarm indications, and

•

self-test failures.

Each entry is date-and-time tagged. The log entries are stored in non-volatile
memory so all data remains valid even if power is lost. Access to the diagnostic
log entries is through commands in the :DIAGnostic:LOG subtree.
For example, to read the first diagnostic log entry, use the command
:DIAG:LOG:READ? 1

The possible log messages that can be displayed on your computer display are
listed in the following table.

Table 5-1. Diagnostic Log Messages
Log Message

Comments

Log cleared

Always becomes first log message when the log is cleared.
See :DIAG:LOG:CLEAR.

Power on

Indicates Receiver has been powered on.

Re-boot

Indicates Receiver processor has re-booted.

Survey mode started

Indicates beginning of survey for position.

Position hold mode started

Indicates transition from survey to position hold.

GPS lock started

Indicates transition into locked operation.

GPS reference valid at
yyyymmdd.hh:mm:ss

Indicates when GPS reference first become valid. Time in log is the present
time from GPS.

Holdover started, manual

Indicates transition to holdover based on user request. See
:SYNC:HOLD:INIT.

Holdover started, TI error

Indicates transition to holdover due to problem detected with Receiver
ability to properly measure interval between GPS 1 PPS and internal
oscillator 1 PPS.

Holdover started, TI limit exceeded

Indicates transition to holdover due to the interval from GPS 1 PPS to
internal oscillator 1 PPS exceeding a limit threshold for numerous
measurements.

Holdover started, not tracking GPS

Indicates transition to holdover since GPS is not tracking sufficient
satellites.

Operating and Programming Guide

5-43

Chapter 5 Command Reference
Operating Status

Reading the Diagnostic Log ____________________ (continued)
Table 5-1. Diagnostic Log Messages (Continued)
Log Message

Comments

Holdover started, GPS RAIM alarm

Indicates transition to holdover since time RAIM algorithm has detected
GPS 1PPS timing inaccuracy.

Holdover started, GPS Alarm

Indicates transition to holdover due to GPS engine communication failure.

Holdover started, invalid GPS 1 PPS

Indicates transition to holdover due to problem with the GPS 1 PPS signal.

Holdover started, GPS

Indicates transition to holdover due to some other GPS problem.

Holdover started, HW error

Indicates transition to holdover due to internal hardware error.

Holdover started, temporary

Indicates temporary transition to holdover due to changing of certain
settings.

Holdover started

Indicates transition to holdover for any reason not covered above.

Self-test failed

Indicates self-test failed on powerup.

System preset

Indicates that the Receiver has been preset to factory settings.

Hardware failure

Indicates that a hardware failure has been detected. See Hardware Status
Register for details.

EEPROM save failed

Indicates that an attempt to save information to the EEPROM has failed.

The DIAGnostic commands for the log are described in the following text.

5-44

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Reading the Diagnostic Log _____________________
(continued)

:DIAGnostic:LOG:CLEar
Clears the diagnostic log.

:SYSTem:PRESet
Log is cleared

NON-VOLATILE

This command is an event that removes all previous diagnostic log entries, and
effectively sets the number of diagnostic log entries to one.

:DIAGnostic:LOG:READ:ALL?

RESPONSE FORMAT

Returns all of the most recent diagnostic log entries.

“XYZ”, ...

This query returns all of the most recent diagnostic log entries.

:DIAGnostic:LOG:CLEar . . .

:SYSTem:PRESet

Clears only the current diagnostic log.

Log is cleared

NON-VOLATILE

This command clears the diagnostic log. The optional log count parameter is
provided to ensure that no log entries are unread at the time of the clear.
Expanded Syntax
:DIAGnostic:LOG:CLEar 
Parameter

If the value sent for the optional log parameter does not match the current log
entry count (use :DIAG:LOG:COUN? to obtain this number), the clear will not
take place.
Context Dependencies

This command is always valid. If the optional log count parameter is sent, and
the current and actual log count does not match log count value, the clear will
not be performed and error -222 will be generated.

Operating and Programming Guide

5-45

Chapter 5 Command Reference
Operating Status

Reading the Diagnostic Log _____________________
(continued)

:DIAGnostic:LOG:COUNt?

RESPONSE FORMAT

Identifies the number of entries in the diagnostic log.

± dd

This query identifies the number of entries in the diagnostic log.
Response

Range is 1 to 222, maximum is subject to change.

:DIAGnostic:LOG:READ?

RESPONSE FORMAT

Returns the most recent diagnostic log entry.

“XYZ”

This query returns the most recent diagnostic log entry.
Response

The diagnostic log entry format is: “Log NNN: YYYYMMDD.HH:MM:SS:
”, where:
Log indicates a diagnostic log entry, and NNN is the log entry number
YYYYMMDD.HH:MM:SS is the date and time of the diagnostic log entry.
The  is a sequence of up to 255 characters.

5-46

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Reading the Diagnostic Log _____________________
(continued)

:DIAGnostic:LOG:READ? . . .
Returns the user-specified diagnostic log entry. Returns the most
recent diagnostic log entry if no parameter is supplied.

RESPONSE FORMAT

“XYZ”

This query returns the user-specified diagnostic log entry.
Expanded Syntax
:DIAGnostic:LOG:READ? 
Parameter

Range is 1 to current log count.
Response

The diagnostic log entry format is: “Log NNN: YYYYMMDD.HH:MM:SS:
”, where:
Log indicates a diagnostic log entry, and NNN is the log entry number
YYYYMMDD.HH:MM:SS is the date and time of the diagnostic log entry.
The  is a sequence of up to 255 characters.
Context Dependencies

This query is always valid. If no log message is associated with the requested
log number, error -222 is generated.

Operating and Programming Guide

5-47

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions _____________________
The Receiver is at all times monitoring various operating conditions through a
status/alarm reporting system. The Receiver is shipped from the factory with
the status system set to generate an alarm under a default set of operating
conditions.
The monitored operating conditions are organized by function into three major
groups: Questionable status, Command Error status, and Operation status.
The Operation status group has three functional subgroups: Powerup status,
Holdover status, and Hardware status.
All of the operating conditions are summarized by the Alarm status.
Figure 5-1, on the next page, includes the identification of the default alarm
conditions. Those conditions which are enabled to “feed” all the way through
the system will generate an alarm in a Receiver configured with the factory
defaults. (Note a diagram identical to Figure 5-1 is provides as part of the
Receiver Commands at a Glance (cont’d)/Status Reporting System at a Glance
foldout—pages 4-17 and 4-18, respectively.)

5-48

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)

Questionable

Binary Weights
1
0
2
1
4
2
8
3
4 16
5 32
6 64
7 128

0
1

8
256
9
512
10 1024
11 2048
12 4096
13 8192
14 16384
15 32768

"OR"

Time Reset
User-reported

Alarm
Command Error

not used
not used

not used

3

not used

2
3
4
5

Query Error
Hardware/Firmware Error
Semantic Error
Syntactic Error

"OR"
5
6
7

not used

7

Powerup
0
1
2

0
1
2

Holdover
0
1
2
3

Holding
Waiting to Recover
Recovering
Exceeding Threshold

0
1
2
3
4

Selftest Failure
+15V Supply Exceeds Tolerance
-15V Supply Exceeds Tolerance
+5V Supply Exceeds Tolerance
Oven Supply Exceeds Tolerance

6
7
8
9
10
11
12

EFC Voltage Near Full-Scale
EFC Voltage Full-Scale
GPS 1 PPS Failure
GPS Failure
TI Measurement Failed
EEPROM Write Failed
Internal Reference Failure

"OR"

Questionable Summary
not used

Alarm

Command Error Summary
Master Summary
Operation Summary

Power Cycled

Operation

"OR"

First Satellite Tracked
Oscillator Oven Warm
Date & Time Valid

"OR"

not used

3
4
5
6

Powerup Summary
Locked
Holdover Summary
Position Hold
1 PPS Reference Valid
Hardware Summary
Log Almost Full

"OR"

Hardware

not used

"OR"

Shading identifies
summary bit.

Powerup Summary
Default Transition Filter

Default Event Enable

False-to-true (positive)
transition latches event.

Event enabled to report to
summary bit.

Not applicable

Event disabled

Figure 5-1. 59551A/58503B Status Reporting System Diagram

Operating and Programming Guide

5-49

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
The following describes, for each functional group of operating status shown in
Figure 5-1, each of the operating conditions that is monitored through the
status/alarm system.
Each monitored condition bit is “set” (to one) when the named condition is true
and “cleared” (to zero) when the named condition is false.
Each monitored event bit is set when the named event has occurred and
cleared at powerup and when the user executes a command which reads or
clears the event register.
All of the conditions and events are cleared at powerup and :SYSTem:PRESet.

Alarm Status
The Alarm Status summarizes condition changes from the three major
functional status groups (Questionable, Command Error, and Operation).
•

The Questionable Summary condition (bit 3) reflects one or more latched
condition changes in the Questionable status group.

•

The Command Error Summary condition (bit 5) reflects one or more
latched condition changes in the Command Error status group.

•

The Master Summary condition (bit 6) indicates that there was at least
one reason for generating an Alarm.

•

The Operation Summary condition (bit 7) reflects one or more latched
condition changes in the Operation status group.

Operation Status
The Operation Status is comprised of the Operation subgroup (Powerup,
Holdover, and Hardware) summaries, Locked, Position Hold, 1 PPS Reference
Valid, and Log Almost Full status.
•

The Powerup Summary condition (bit 0) reflects one or more latched
condition changes in the Powerup status group.

•

The Locked condition (bit 1) indicates whether or not the Receiver is
locked to GPS.

•

The Holdover Summary condition (bit 2) reflects one or more latched
condition changes in the Holdover status group.

•

The Position Hold condition (bit 3) indicates whether the Receiver is in
position hold or survey mode.

•

The 1 PPS Reference Valid condition (bit 4) indicates that the GPS 1 PPS
signal is suitable to use as a locking reference.

•

The Hardware Summary condition (bit 5) reflects one or more latched
condition changes in the Hardware status group.

•

The Log Almost Full condition (bit 6) indicates whether or not the
diagnostic log is approaching the point where new entries will no longer be
logged.

5-50

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
Hardware Status
This Operation subgroup comprises operating status that indicates the health
of the Receiver hardware.
One or more of the condition changes from this group are summarized in the
Operation Status group.
•

The Selftest Failure condition (bit 0) indicates whether a failure was
detected during the powerup or last user-initiated self-test.

•

The following conditions reflect the status of specific hardware that is
continuously monitored by the Receiver:

•

+15V Supply Exceeds Tolerance condition

(bit 1)

−15V Supply Exceeds Tolerance condition

(bit 2)

+5V Supply Exceeds Tolerance condition

(bit 3)

Oven Supply Exceeds Tolerance condition

(bit 4)

EFC Voltage Near Full-Scale condition

(bit 6)

EFC Voltage Full-Scale condition

(bit 7)

GPS 1 PPS Failure condition

(bit 8)

GPS Failure condition

(bit 9)

Time Interval Measurement Failed event

(bit 10)

Internal Reference Failure condition

(bit 12)

The EEPROM Write Failed event (bit 11) indicates that an attempt to
write to the non-volatile memory failed.

Operating and Programming Guide

5-51

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
Holdover Status
This Operation subgroup is comprised of operating status that occurs during
holdover.
One or more of the condition changes from this group are summarized in the
Operation Status group.
•

•

The following conditions indicate that the Receiver is in holdover, and the
specific holdover state:
Holding condition

(bit 0)

Waiting to Recover condition

(bit 1)

Recovering condition

(bit 2)

The Exceeding User-Threshold condition (bit 3) indicates whether or not
the user-specified holdover duration
(:SYNC:HOLDover:DURation:THReshold) is being exceeded.

Powerup Status
This Operation subgroup is comprised of operating status that occurs at
powerup.
One or more of the condition changes from this group are summarized in the
Operation Status group.
•

The First Satellite Tracked condition (bit 0) is cleared at powerup and set
when the first satellite becomes tracked following powerup.

•

The Oscillator Oven Warm condition (bit 1) is cleared at powerup and set
when the internal oscillator has warmed up following powerup.

•

The Date & Time Valid event (bit 2) is cleared at powerup and set when
the date and time are set during the first lock is attained after powerup.

Questionable Status
The Time Reset status event (bit 0) indicates that the Receiver reset its time
because the Receiver's time was found to be different from the time being
reported by the satellites. This could occur after an extensive holdover period.
The User-reported condition (bit 1) indicates the setting reported by the user
with the :STATus:QUEStionable:CONDition:USER or
:STATus:QUEStionable:EVENt:USER command. This is the only condition in
the status/alarm reporting that the user can directly affect.

5-52

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
Command Error Status
This group contains events which indicate a command error has occurred, and
an event which indicates that the power has cycled. (See Figure 5-1.)
The following status events indicate that a command error occurred:
•

The Query Error status event (bit 2). Errors -400 through -499 are query
errors.

•

The Hardware/Firmware Error status event (bit 3). Errors -300 through
-399 are hardware/firmware errors.

•

The Semantic Error status event (bit 4). Errors -200 through -299 are
semantic errors.

•

The Syntactic Error status event (bit 5). Errors -100 through -199 are
syntactic errors.

•

The Power Cycled status event (bit 7) is set at powerup.

Operating and Programming Guide

5-53

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Clearing and Presetting Alarms ______________________________

*CLS
Clears the current alarm and prepares the Receiver for the next
alarm activation.

EVENT

When the *CLS command clears the event status registers and error queue, the
Receiver’s Alarm LED and Alarm BITE output will no longer indicate that
there was a reason to alarm. Furthermore, the Receiver is then ready to detect
a new alarm.
Context Dependencies

In the 59551A, the error queue (and corresponding serial port prompt) of the
I/O port which transmitted *CLS will be cleared.
Side Effects

The Alarm LED is extinguished.
The Alarm BITE output is set “inactive/off.”
The prompt of the serial I/O port (which transmits *CLS) reflects error queue
clearing.
The event status registers are cleared.
The error queue (and corresponding serial port prompt) of the I/O port which
transmitted *CLS will be cleared.
Theory

The *CLS command clears the event status registers and error queue.
(They are also cleared at power-up.)
Since the Alarm Condition register summarizes the event registers, it is
cleared as a result of the clearing of all of the event registers.
The alarm remains active even after the condition that caused it has gone
away.
If the condition that caused the alarm to occur is still set, a new alarm cannot
be detected until the condition clears and resets.
This command has no effect on condition, enable, or transition filter registers.

5-54

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Clearing and Presetting Alarms (continued)

:STATus:PRESet:ALARm
Presets the status/alarm reporting system to generate an alarm
when a factory default set of operating conditions occurs.

EVENT

When the configurable portion of the status/alarm reporting system is preset,
the Receiver is configured to generate an alarm under the factory default set of
operating conditions.
Use this command to restore only the status/alarm reporting system to the
factory (:SYSTem:PRESet) settings.
Theory

The configurable portion of the status/alarm reporting system consists of
enable and transition filter registers. Figure 5-1 identifies the factory default
enables and transitions.
The status/alarm reporting configuration is stored in non-volatile memory.
This command performs a subset of the :SYSTem:PRESet command in that it
only presets the configuration associated with status/alarm reporting system.
This command does not affect condition or event registers.

Operating and Programming Guide

5-55

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Alarms _____________________________

Alarm
Condition
Register
not used
not used
not used

STB?

*

3

Questionable Summary
not used

5
6
7

Command Error Summary
Master Summary
Operation Summary

"AND"

&

Alarm
Enable
Register

"OR"

&

:LED:ALARm?
Alarm

not used
not used

&

not used

*SRE 
*SRE?

3

Questionable Summary
not used

5

Command Error Summary
not used

7

Operation Summary

Figure 5-2. Alarm Condition and Enable Registers

:LED:ALARm?

RESPONSE FORMAT

Returns the status of the front-panel Alarm LED.

0 or 1

This query returns the status of the front-panel Alarm LED, which indicates
that a change in operating conditions was recorded. The alarm remains active
even after the condition that caused it has gone away.
Theory

This query essentially reads the Master Summary bit (bit 6) of the Alarm
Condition Register.
At power-up, the alarm status is cleared.

5-56

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Alarms (continued)

*SRE . . .
Sets the Alarm Enable Register.

:SYSTem:PRESet

136
NON-VOLATILE

The setting of the Alarm Enable Register (Figure 5-2) selects which summary
status from the Alarm Condition Register is enabled to generate an alarm.
Expanded Syntax
*SRE 
Semantics

The  has a range of 0 to 255.
The  value represents the sum of the binary-weighted values of the
register. Attempts to set unused bits in the register are ignored—the value of
unused bits is zero.

*SRE?
Identifies the status conditions enabled to generate an alarm.

RESPONSE FORMAT

± dd

This query identifies the status conditions enabled to generate an alarm.
Reading the Alarm Enable Register identifies which summary status from the
Alarm Condition Register is enabled to generate an alarm.
Response

The range is 0 to 255.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
Theory

Reading/Querying the Alarm Enable Register does not change its contents.

Operating and Programming Guide

5-57

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Alarms (continued)

*STB?

RESPONSE FORMAT

Reads the Alarm Condition Register.

± dd

This query reads the Alarm Condition Register (Figure 5-2).
Response

The range is 0 to 255.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
Theory

The Alarm Condition Register continuously monitors the summary status of
the instrument.
The Alarm Condition Register bits are updated in real time—there is no
latching or buffering.
Reading/Querying the Alarm Condition Register does not change its contents.
At powerup, the Alarm Condition Register is cleared.

5-58

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status ____________________
Condition
Register

Transition
Filter

Event
Register

0
1
2

*
*
*

0
1
2

"AND"

&
n
Continuously monitors
conditions
:STATus::CONDition?

n

*
Enables condition changes to
report to Event Register
:STATus::PTR . . .
:STATus::PTR?
:STATus::NTR . . .
:STATus::NTR?

&
Latches condition changes
:STATus::EVENt?

&

Event
Enable
Register

&

"OR"
Summary
Bit

0
1
2

*=

positive transition or
negative transition or
either transition or

n

neither transition
 = OPERation or
QUEStionable or
OPERation:HARDware or
OPERation:HOLDover or
OPERation:POWerup

Enables events to
report to summary bit
:STATus::ENABle 
:STATus::ENABle?

Figure 5-3. Condition, Transition Filter, Event Enable, and Event
Registers

Operating and Programming Guide

5-59

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::CONDition?

RESPONSE FORMAT

Reads the specified condition register.

± dd

This query reads the specified condition register (figures 5-3 and 5-1).
Expanded Syntax
:STATus:OPERation:CONDition?
:STATus:QUEStionable:CONDition?
:STATus:OPERation:HARDware:CONDition?
:STATus:OPERation:HOLDover:CONDition?
:STATus:OPERation:POWerup:CONDition?
Response

The range is 0 to 65535.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
Note that some bits, those which are “event-only”, have no corresponding
conditions.
Theory

A condition register continuously monitors the hardware and firmware status
(that is, the operating conditions) of the instrument.
Conditions register bits are updated in real time—there is no latching or
buffering.
Reading/Querying a condition register does not change its contents.
At powerup, the conditions registers are cleared.

5-60

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::EVENt?
Reads the specified event register.

RESPONSE FORMAT

± dd

This query reads the specified event register (figures 5-3 and 5-1), retrieving
information about what has happened to the instrument since it was last
queried, or cleared by :SYSTem:PRESet or *CLS.
Expanded Syntax
:STATus:OPERation:EVENt?
:STATus:QUEStionable:EVENt?
:STATus:OPERation:HARDware:EVENt?
:STATus:OPERation:HOLDover:EVENt?
:STATus:OPERation:POWerup:EVENt?
Response

The range is 0 to 65535.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
Side Effects

Reading/Querying an event register clears it.
Theory

An event register captures changes in conditions. When a transition occurs, the
corresponding bit in the event register is set TRUE. The instrument can be
configured (using :STATus::NTRansition and
:STATus::PTRansition), for each bit position, to capture the positive,
the negative, either, or neither transition.
Event register bits, once set, are latched. That is, they remain set until they are
read. When they are read, they are cleared.
At powerup, the event registers are cleared.
See Also
:STATus::NTRansition . . .
:STATus::PTRansition . . .

Operating and Programming Guide

5-61

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::ENABle . . .

:SYSTem:PRESet

Sets the specified enable register.

See Figure 5-1 for Default
Event Enable identification
NON-VOLATILE

The setting of an enable register (figures 5-3 and 5-1) selects which events from
the corresponding event register are enabled to report to the corresponding
summary bit of the summarizing condition register.
Expanded Syntax
:STATus:OPERation:ENABle 
:STATus:QUEStionable:ENABle 
:STATus:OPERation:HARDware:ENABle 
:STATus:OPERation:HOLDover:ENABle 
:STATus:OPERation:POWerup:ENABle 
Parameter

The  has a range of 0 to 65535.
The  value represents the sum of the binary-weighted values of the
register. Attempts to set unused bits in an enable register are ignored—the
value of unused bits is zero.

5-62

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::ENABle?
Reads the specified enable register.

RESPONSE FORMAT

± dd

Reading an enable register (figures 5-3 and 5-1) identifies which events from
the corresponding event register are enabled to report to the corresponding
summary bit of the summarizing condition register.
Expanded Syntax
:STATus:OPERation:ENABle?
:STATus:QUEStionable:ENABle?
:STATus:OPERation:HARDware:ENABle?
:STATus:OPERation:HOLDover:ENABle?
:STATus:OPERation:POWerup:ENABle?
Response

The range is 0 to 65535.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
Theory

Reading/Querying an enable register does not change its contents.

Operating and Programming Guide

5-63

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::NTRansition . . .
:STATus::PTRansition . . .

:SYSTem:PRESet

Sets the specified transition filter registers.

See Figure 5-1 for Default
Transition Filter
identification
NON-VOLATILE

The setting of the transition filter registers selects which condition transitions
(positive, negative, either, or neither) are enabled to report events.
Expanded Syntax
:STATus:OPERation:NTRansition 
:STATus:QUEStionable:NTRansition 
:STATus:OPERation:HARDware:NTRansition 
:STATus:OPERation:HOLDover:NTRansition 
:STATus:OPERation:POWerup:NTRansition 
:STATus:OPERation:PTRansition 
:STATus:QUEStionable:PTRansition 
:STATus:OPERation:HARDware:PTRansition 
:STATus:OPERation:HOLDover:PTRansition 
:STATus:OPERation:POWerup:PTRansition 
Parameter

The  has a range of 0 to 65535.
The  value represents the sum of the binary-weighted values of the
register. Attempts to set unused bits in the transition filter are ignored—the
value of unused bits is zero.
To enable negative (one to zero) transitions of specific conditions, set the
corresponding bits to one in the  for the NTRansition register
command.
To enable positive (zero to one) transitions of specific conditions, set the
corresponding bits to one in the  for the PTRansition register
command.
Note that some bits, those which are “event-only”, have no transition filter
setting. Attempts to set these bits are ignored.

5-64

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Receiver Status (continued)

:STATus::NTRansition?
:STATus::PTRansition?
Reads the specified transition filter registers.

RESPONSE FORMAT

± dd

Reading the transition filter registers identifies which condition transitions
(positive, negative, either, or neither) are enabled to report events.
Expanded Syntax
:STATus:OPERation:NTRansition?
:STATus:QUEStionable:NTRansition?
:STATus:OPERation:HARDware:NTRansition?
:STATus:OPERation:HOLDover:NTRansition?
:STATus:OPERation:POWerup:NTRansition?
:STATus:OPERation:PTRansition?
:STATus:QUEStionable:PTRansition?
:STATus:OPERation:HARDware:PTRansition?
:STATus:OPERation:HOLDover:PTRansition?
:STATus:OPERation:POWerup:PTRansition?
Response

The range is 0 to 65535.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.
The bits which are set to one in the  of the NTRansition query
response indicate the enabled negative transitions of corresponding conditions.
The bits which are set to one in the  of the PTRansition query
response indicate the enabled positive transitions of corresponding conditions.
Theory

Reading/Querying a transition filter register does not change its contents.

Operating and Programming Guide

5-65

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Command Error Status ____________

Command Error
Event
Register
not used
not used

ESR?

*

2
3
4
5

Query Error
Hardware/Firmware Error
Semantic Error
Syntactic Error

7

Power Cycled

"AND"
&

not used

Command Error
Enable
Register

&
"OR"
&

Command Error
Summary Bit of
Alarm Condition
Register

not used
not used

ESE 
ESE?

*
*

2
3
4
5

Query Error
Hardware/Firmware Error
Semantic Error
Syntactic Error

&

&

not used

7

Power Cycled

Figure 5-4. Command Error Event and Enable Registers

*ESE . . .
Sets the Command Error Enable Register.

:SYSTem:PRESet

0
NON-VOLATILE

The setting of the Command Error Enable Register (Figure 5-4) selects which
events from the Command Error Event Register are enabled to report to the
Command Error Summary bit of the Alarm Condition Register.
Expanded Syntax
*ESE 
Parameter

The  has a range of 0 to 255.
The  value represents the sum of the binary-weighted values of the
register. Attempts to set unused bits in the register are ignored—the value of
unused bits is zero.

5-66

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reading and Qualifying Command Error Status (continued)

*ESE?
Reads the Command Error Enable Register.

RESPONSE FORMAT

± dd

This query identifies the status conditions enabled to generate an alarm.
Reading the Command Error Enable Register (Figure 5-4) identifies which
events from the Command Error Event Register are enabled to report to the
Command Error Summary bit of the Alarm Condition Register.
Response

The range is 0 to 255.
The response value represents the sum of the binary–weighted values of the
register. The value of unused bits is zero.
Theory

Reading/Querying the Command Error Enable Register does not change its
contents.

*ESR?
Reads the Command Error Event Register.

RESPONSE FORMAT

± dd

This query reads the Command Error Event Register, retrieving information
about errors (or power cycles) that have occurred since the instrument was last
queried, or cleared by SYSTem:PRESet or *CLS.
Response

The range is 0 to 255.
The response value represents the sum of the binary-weighted values of the
register. The value of unused bits is zero.

Operating and Programming Guide

5-67

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reporting Questionable Status ____________________________

:STATus:QUEStionable:CONDition:USER . . .
Sets the User-reported bit of the Questionable Condition Register.

:SYSTem:PRESet

Clear
NON-VOLATILE

This command sets the User-reported bit of the Questionable Condition
Register.
Expanded Syntax
:STATus:QUEStionable:CONDition:USER SET or CLEar
Parameter

SET will cause the User-reported bit of Questionable Condition Register to be
set to 1.
CLEar will cause the User-reported bit of Questionable Condition Register to
be set to 0.
Side Effects

The User-reported bit of the Questionable Condition Register is set or cleared
by this command.
Theory

A condition change (from SET to CLEAR, or CLEAR to SET) of the Userreported bit of the Questionable Condition Register, and the appropriate
configuration of the Questionable Transition Filter is necessary to generate an
event in the Questionable Event Register.
Furthermore, when the User-reported bit of Questionable Event Enable
Register is enabled, and the Questionable Summary bit of the Alarm Enable
Register is enabled, then a transition of the User-reported condition will
generate an ALARM.

5-68

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Monitoring Status/Alarm Conditions ___________ (continued)
! Reporting Questionable Status (continued)

:STATus:QUEStionable:EVENt:USER . . .
Generates a transition of the User-reported bit of the Questionable
Condition Register.

EVENT
NON-VOLATILE

This command generates a transition of the User-reported bit of the
Questionable Condition Register.
Expanded Syntax
:STATus:QUEStionable:EVENt:USER PTRansition or NTRansition
Parameter

PTRansition will cause the User-reported bit of Questionable Condition
Register to transition from a setting of 0 to a setting of 1.
NTRansition will cause the User-reported bit of Questionable Condition
Register to transition from a setting of 1 to a setting of 0.
Context Dependencies

Issuing PTRansition, while the User-reported bit of the Questionable Positive
Transition Register is enabled, sets the User-reported bit of the Questionable
Event register.
Issuing NTRansition, while the User-reported bit of the Questionable Negative
Transition Register is enabled, sets the User-reported bit of the Questionable
Event register.
Side Effects

The user-reported bit of the Questionable Condition Register is set by the
PTRansition parameter or cleared by the NTRansition parameter.
Theory

A positive or negative (PTRansition or NTRansition) of the User-reported bit of
the Questionable Condition Register, and the appropriate configuration of the
Questionable Transition Filter is necessary to generate an event in the
Questionable Event Register.
Furthermore, when the User-reported bit of Questionable Event Enable
Register is enabled, and the Questionable Summary bit of the Alarm Enable
Register is enabled, then a User-reported event will generate an ALARM.

Operating and Programming Guide

5-69

Chapter 5 Command Reference
Operating Status

Assessing Receiver Health ________________________________

*TST?

RESPONSE FORMAT

Executes an internal selftest and reports the results.

± dd

This query causes an internal selftest and the response indicates whether any
errors were detected. This test takes about 40 seconds to complete.
Error -330, “Self test failed” is generated if the selftest fails.
NOTE

Manual operation of internal diagnostics will affect normal Receiver
operation, including disruption of any or all of the following: GPS satellite
tracking, reference oscillator frequency, 1 PPS output timing, and Receiver
status information. When invoked manually, any of these diagnostics should
be considered to be destructive tests.
The following elements and functions are tested:
CPU
EPROM
RAM
EEPROM
UART
QSPI
FPGA logic
Interpolators
GPS engine
Power supply levels
Reference oscillator
Response

A value of 0 indicates the tests passed, a non-zero value indicates the selftest
was not completed or was completed with errors detected.

5-70

Operating and Programming Guide

Chapter 5 Command Reference
Operating Status

Assessing Receiver Health ______________________ (continued)

:DIAGnostic:LIFetime:COUNt?
Returns the lifetime count, indicating the total powered-on time.

RESPONSE FORMAT

± dd

This query returns the lifetime count, indicating the total powered-on time.
Response

Range of the integer is 0 to 4,294,967,296 with a resolution of 1. Each count
represents three hours of operation.

:DIAGnostic:TEST? . . .
Returns information for user-specified test.

RESPONSE FORMAT

± dd

This query returns information for user-specified test.
Expanded Syntax
:DIAGnostic:TEST? ALL or DISPlay or PROCessor or RAM or EEPRom or UART or QSPI
or FPGA or INTerpolator or GPS or POWer.
Response

A value of 0 (zero) indicates test passed.
Parameter

ALL returns test information for all of the tests.

Operating and Programming Guide

5-71

Chapter 5 Command Reference
Operating Status

Assessing Receiver Health ______________________ (continued)

:DIAGnostic:TEST:RESult?

RESPONSE FORMAT

Returns the result of the last test and the type of test performed.

± dd, XYZ

This query returns the result of the last test and the type of test performed.
Use this query, for example, following powerup to check the outcome of the
powerup selftest.
Response

A value of 0 indicates test passed. Non-zero value indicates test failed.
The literal or alphanumeric characters portion of the response identifies the
specific test.

5-72

Operating and Programming Guide

Chapter 5 Command Reference
System Time

System Time
The GPS Receiver is designed to allow you access to a very accurate system
clock that provides both date and time, to customize the clock for a local time
zone, to identify the exact time, to identify the accumulated time difference (in
seconds) between the GPS and UTC timelines, and to monitor and adjust for
leap second occurrences.
The following commands are provided to allow you to monitor and control the
system date and time.
" Identifying Time of Next 1 PPS Reference Edge
:PTIMe:TCODe?

" Reading Current Time
:PTIMe:DATE?
or
:PTIMe:TIME?
or
:PTIMe:TIME:STRing?

:SYSTem:DATE?
:SYSTem:TIME?

" Applying Local Time Zone Offset
:PTIMe:TZONe ...
:PTIMe:TZONe?

" Defining the 1 PPS Reference Edge (59551A Only)
:PTIMe:PPS:EDGE ...
:PTIMe:PPS:EDGE?

" Reading Leap Second Status
:PTIMe:LEAPsecond:ACCumulated?
:PTIMe:LEAPsecond:DATE?
:PTIMe:LEAPsecond:DURation?
:PTIMe:LEAPsecond:STATe?

Operating and Programming Guide

5-73

Chapter 5 Command Reference
System Time

Identifying Time of Next 1 PPS Reference Edge __________

:PTIMe:TCODe?

RESPONSE FORMAT

Returns timecode message 980 to 20 ms prior to 1 PPS of
indicated time.

ASCII Data

This query returns timecode message 980 to 20 ms prior to 1 PPS of indicated
time. This special query provides not only accurate time but also provides the
user the opportunity to correctly correlate this time with a corresponding
1 PPS edge.
Response

The query response provides the following type of information:
•

date and time of next on-time edge,

•

Time Figure of Merit,

•

Frequency Figure of Merit,

•

leap second indicator,

•

alarm indication, and

•

service request.

An example response is:
T2199505112055233000049
This example is in the "T2YYYYMMDDHHMMSSMFLRVcc" format, where
T2

indicates a timecode message.

YYYYMMDD is the calendar date at the next 1 PPS on-time edge.
HHMMSS

is the 24 hour time at the next 1 PPS on-time edge.
Note that this value is influenced by the ptim:tzon setting.

M

is time figure of merit.

F

is frequency figure of merit.

L

is leapsecond indicator (- means a -1 leapsecond is pending,
0 means no leapsecond pending, + means a 1 leapsecond is
pending).

R

is the request for service bit from the status system (0 = no
service requested, 1 = service requested). An alarm will be
generated when this byte transitions to 1.

V

is validity byte. 1 indicates that time-related information isn't
valid, 0 indicates that it is valid.

cc

is the checksum of the prior bytes (two Hex bytes).

5-74

Operating and Programming Guide

Chapter 5 Command Reference
System Time

Reading Current Time____________________________________

:PTIMe:DATE?
:SYSTem:DATE?
Returns the current calendar date.

RESPONSE FORMAT

± dd, ± dd, ± dd

This query returns the current calendar date. The local calendar date is always
referenced to UTC time, offset by any local time zone value that has been
provided by the user. The year, month, and day are returned.
Response

Three fields are separated by commas: ,,.
•

The  range is 1994 to 2077.

•

The  range is 1 to 12.

•

The  range is 1 to 31.

Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet. Sending this query before the
first lock will generate error -230.

:PTIMe:TIME?
:SYSTem:TIME?
Returns the current 24-hour time.

RESPONSE FORMAT

± dd, ± dd, ± dd

This query returns the current 24-hour time. The local time is always
referenced to UTC time, offset by any local time zone value that has been
provided by the user. The hour, minute, and second is returned.
Response

Three fields are separated by commas: ,,.
•

The  range is 0 to 23.

•

The  range is 0 to 59.

•

The  range is 0 to 60. The value of 60 only occurs as the UTC
leapsecond.

Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet. Sending this query before the
first lock will generate error -230.

Operating and Programming Guide

5-75

Chapter 5 Command Reference
System Time

Reading Current Time__________________________ (continued)

:PTIMe:TIME:STRing?

RESPONSE FORMAT

Returns the current 24-hour time suitable for display.

“XYZ”

This query returns the current 24-hour time suitable for display (for example,
15:23:06).
Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet. Sending this query before the
first lock will generate error -230.

5-76

Operating and Programming Guide

Chapter 5 Command Reference
System Time

Applying Local Time Zone Offset _________________________

:PTIMe:TZONe . . .
Sets the time zone local time offset to provide an offset from UTC
to serve as the basis for all reported time.

:SYSTem:PRESet

0,0
NON-VOLATILE

This command sets the time zone local time offset to provide an offset from
Universal Coordinated Time (UTC) to serve as the basis for all reported time.
The local 24-hour time and local calendar date depend on the present setting
of the time zone parameter, which is used to indicate the offset from UTC.
Typical application of this command is to account for time zone differences
between the installed Receiver location and the prime meridian at Greenwich,
which uses UTC uncorrected.
Expanded Syntax
:PTIMe:TZONe , 
Parameter

•

The  range is -12 to +12, and is rounded to the nearest integer.

•

The optionally supplied  range -59 to +59, and is rounded to the
nearest integer. The  is defaulted to 0 if not supplied.

Context Dependencies

:SYSTem:PRESet sets the time zone to zero (0,0).

:PTIMe:TZONe?
Returns the local time zone offset.

RESPONSE FORMAT

± dd, ± dd

This query returns the local time zone offset.
Response

The first returned value is offset hours. The second returned value is offset
minutes.

Operating and Programming Guide

5-77

Chapter 5 Command Reference
System Time

Defining the 1 PPS Reference Edge (59551A Only) ____
59551A

:PTIMe:PPS:EDGE . . .

:SYSTem:PRESet

Selects the polarity of the 1 PPS on-time edge.

RISing
NON-VOLATILE

This command selects the polarity of the 1 PPS on-time edge.
Expanded Syntax
:PTIMe:PPS:EDGE RISing or FALLing
Parameter

The RISing parameter sets the 1 PPS rising edge as the on-time edge.
The FALLing parameter sets the 1 PPS falling edge as the on-time edge.

59551A

:PTIMe:PPS:EDGE?

RESPONSE FORMAT

Returns the polarity of the 1 PPS on-time edge.

XYZ

This query returns the polarity of the 1 PPS on-time edge.
Response

RIS indicates that the 1 PPS on-time edge is the rising edge.
FALL indicates that the 1 PPS on-time edge is the falling edge.

5-78

Operating and Programming Guide

Chapter 5 Command Reference
System Time

Reading Leap Second Status ______________________________

:PTIMe:LEAPsecond:ACCumulated?
Returns the leap second difference accumulated between GPS
time and UTC time since the beginning of GPS time. The time
units are seconds.

RESPONSE FORMAT

± dd

This query returns the leap second difference accumulated between GPS time
and UTC time since the beginning of GPS time. The time units are seconds.
Response

An example response is:
+10
which indicates that the accumulated leap second difference between the GPS
time and UTC is 10 seconds.
Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet. Sending this query before the
first lock will generate error -230.
Theory

The leap second value is initialized during the power-on sequence by
evaluating :PTIMe:LEAPsecond:ACC = GPS time - UTC time. In July 1994,
the value was 10 seconds.
The value is automatically adjusted immediately following the occurrence of a
leap second correction to the UTC time scale. When a 1 leap second addition is
made to the UTC time scale, the extra second delays the arrival of midnight
UTC causing :PTIM:LEAP:ACC? to increase by 1 second. When a 1 leap second
subtraction is made to the UTC time scale, the missing second hastens the
arrival of UTC midnight causing :PTIM:LEAP:ACC? to decrease by 1 second.

Operating and Programming Guide

5-79

Chapter 5 Command Reference
System Time

Reading Leap Second Status ____________________ (continued)

:PTIMe:LEAPsecond:DATE?

RESPONSE FORMAT

Returns the UTC calendar date of next leap second.

± dd, ± dd, ± dd

This query returns the UTC calendar date of next leap second. The year,
month, and day are returned.
Response

Three fields are separated by commas: ,,.
•

The  range is 1994 to 2077.

•

The  range is 1 to 12.

•

The  range is 1 to 31.

Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet, or if no leap second is pending.
Sending this query before the first lock or if no leap second is pending will
generate error -230.

5-80

Operating and Programming Guide

Chapter 5 Command Reference
System Time

Reading Leap Second Status ____________________ (continued)

:PTIMe:LEAPsecond:DURation?

RESPONSE FORMAT

Returns the duration of the minute corrected by the next leap
second.

± dd

This query identifies whether a leap second is pending, distinguishes between
leap seconds which extend the minute, and leap seconds which shorten the
minute. This query returns the duration of the minute corrected by the next
leap second. The duration units are seconds.
Response

Returns a value of 59, 60 or 61:
•

A value of 59 indicates subtraction of 1 second is pending.

•

A value of 60 indicates no leap second pending.

•

A value of 61 indicates addition of 1 second is pending.

Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet, or if no leap second is pending.
Sending this query before the first lock or if no leap second is pending will
generate error -230.

Operating and Programming Guide

5-81

Chapter 5 Command Reference
System Time

Reading Leap Second Status ____________________ (continued)

:PTIMe:LEAPsecond:STATe?

RESPONSE FORMAT

Identifies if leap second is pending.

0 or 1

This query identifies if a leap second is pending. This query looks ahead to
indicate a pending leap second.
Response

A value of 0 indicates no leap second is pending.
A value of 1 indicates a leap second is pending. The leap second adjustment can
be either the addition of a second or the subtraction of a second.
Context Dependencies

This query is not valid prior to the first lock following powerup (see bit 2 of the
Powerup Status Register) or :SYSTem:PRESet (but is valid if no leap second is
pending). Sending this query before the first lock will generate error -230.

5-82

Operating and Programming Guide

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

Programmable Pulse Output
(59551A Only)
The Programmable Pulse output feature provides a means of using the GPS
Receiver as a pulse generator. The pulse output, which is programmable by the
user, can either generate a stream of pulses at a specified start time and
repetition interval, or it can produce a single pulse at a specified time and then
stop.
The following commands are provided to allow you to operate and control the
programmable output of the 59551A GPS Receiver.
Note that the configuring of the Programmable Pulse output requires
consideration of five settings: start date, start time, continuous on/off, pulse
period, and pulse polarity. Changing any one of the settings will stop any
previously configured pulse stream and reassert all five settings. If the start
date has already passed when you modify the repetition interval, the pulse
output will halt until you provide a new start date.

:PULSe:CONTinuous:PERiod ...
:PULSe:CONTinuous:PERiod?
:PULSe:CONTinuous:STATe ...
:PULSe:CONTinuous:STATe?
:PULSe:REFerence:EDGE ...
:PULSe:REFerence:EDGE?
:PULSe:STARt:DATE ...
:PULSe:STARt:DATE?
:PULSe:STARt:TIME ...
:PULSe:STARt:TIME?

Operating and Programming Guide

5-83

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

59551A

:PULSe:CONTinuous:PERiod . . .

:SYSTem:PRESet

Sets the interval between pulses in seconds.

1
NON-VOLATILE

This command sets the interval between pulses in seconds.
Expanded Syntax
:PULSe:CONTinuous:PERiod 
Parameter

The  parameter range is 1 to 31536000, equivalent to one year.
Resolution is 1.
Context Dependencies

The interval set by this command is only used if :PULSe:CONTinuous:STATe
is ON.

59551A

:PULSe:CONTinuous:PERiod?

RESPONSE FORMAT

Returns the interval between pulses in seconds.

± dd

This query returns the interval between pulses in seconds.

5-84

Operating and Programming Guide

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

59551A

:PULSe:CONTinuous:STATe . . .
Controls whether the Programmable Pulse output will be just one
pulse or a sequence of pulses.

:SYSTem:PRESet

OFF
NON-VOLATILE

This command controls whether the Programmable Pulse output will be just
one pulse or a sequence of pulses.
Expanded Syntax
:PULSe:CONTinuous:STATe ON or OFF
Parameter

OFF selects one pulse. ON selects a sequence of pulses.
Context Dependencies

With either state (OFF or ON) the output commences at the time and date
defined by :PULSe:STARt:DATE and :PULSe:STARt:TIME commands.

59551A

:PULSe:CONTinuous:STATe?
Identifies whether the Programmable Pulse output is set to output
a single pulse or a sequence of pulses.

RESPONSE FORMAT

0 or 1

This query identifies whether the Programmable Pulse output is set to output
a single pulse or a sequence of pulses.
Response

•

A value of 0 indicates the Receiver is set to output one pulse.

•

A value of 1 indicates the Receiver is set to output a sequence of pulses.

Operating and Programming Guide

5-85

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

59551A

:PULSe:REFerence:EDGE . . .

:SYSTem:PRESet

Selects the polarity of the Programmable Pulse on-time edge.

RISing
NON-VOLATILE

This command selects the polarity of the Programmable Pulse on-time edge.
Expanded Syntax
:PULSe:REFerence:EDGE RISing or FALLing
Parameter

The RISing parameter sets the Programmable Pulse rising edge as the on-time
edge.
The FALLing parameter sets the Programmable Pulse falling edge as the
on-time edge.

59551A

:PULSe:REFerence:EDGE?

RESPONSE FORMAT

Returns the polarity of the Programmable Pulse on-time edge.

XYZ

This query returns the polarity of the Programmable Pulse on-time edge.
Response

RIS indicates that the Programmable Pulse on-time edge is the rising edge.
FALL indicates that the Programmable Pulse on-time edge is the falling edge.

5-86

Operating and Programming Guide

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

59551A

:PULSe:STARt:DATE . . .
Identifies the date when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output.

:SYSTem:PRESet

1994, 1, 1
NON-VOLATILE

This command identifies the date when the individual pulse (or first pulse of
the pulse sequence) is generated at the Programmable Pulse output.
Expanded Syntax
:PULSe:STARt:DATE ,,
Parameter

•

The  range is 1994 to 3000.

•

The  range is 1 to 12.

•

The  range is 1 to 31.

Context Dependencies

If you select a date and time which occurs prior to the current time or prior to
the completion of powerup and first GPS lock, the Receiver will not successfully
find a start—and therefore will produce no pulses.
If the Receiver has been set up to use a time zone offset to produce local date
and time, the parameters provided should also be expressed as local date and
time.

59551A

:PULSe:STARt:DATE?
Returns the date when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output.

RESPONSE FORMAT

± dd, ± dd, ± dd

This query returns the date when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output. This query
returns year, month, and day.
Response

Three fields are separated by commas: ,,.
•

The  range is 1994 to 3000.

•

The  range is 1 to 12.

•

The  range is 1 to 31.

Operating and Programming Guide

5-87

Chapter 5 Command Reference
Programmable Pulse Output (59551A Only)

59551A

:PULSe:STARt:TIME . . .

:SYSTem:PRESet

Identifies the time when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output.

0,0,0
NON-VOLATILE

This command identifies the time when the individual pulse (or first pulse of
the pulse sequence) is generated at the Programmable Pulse output.
Expanded Syntax
:PULSe:STARt:TIME ,,
Parameter

Three fields are separated by commas: ,, .
•

The  range is 0 to 23.

•

The  range is 0 to 59.

•

The  range is 0 to 59.

Context Dependencies

If you select a date and time which occurs prior to the current time or prior to
the completion of powerup and first GPS lock, the Receiver will not successfully
find a start—and therefore will produce no pulses.
If the Receiver has been set up to use a time zone offset to produce local date
and time, the parameters provided should also be expressed as local date and
time.

59551A

:PULSe:STARt:TIME?

RESPONSE FORMAT

Returns the time when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output.

± dd, ± dd, ± dd

This query returns the time when the individual pulse (or first pulse of the
pulse sequence) is generated at the Programmable Pulse output.
Response

Three fields are separated by commas: , , .
•

The  range is 0 to 23.

•

The  range is 0 to 59.

•

The  range is 0 to 59.

5-88

Operating and Programming Guide

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Event Time Stamping (59551A Only)
The time stamping feature allows you to use the Receiver with equipment such
as a fault analyzer or a surge detector that produces a TTL edge when some
important event happens in the base station. The Receiver has three time
tagging inputs (Time Tag 1, Time Tag 2, Time Tag 3) which record the time
of occurrence of TTL edge(s).
The following commands are provided to allow you to tag and record events
such as power surges and power outages.
" Defining the Time-stamped Edge
:SENSe:TSTamp:EDGE ...
:SENSe:TSTamp:EDGE?

" Clearing Time Stamp Memory
:SENSe:DATA:CLEar
:SENSe:DATA:CLEar ...

" Reading Time Stamps
:SENSe:DATA? ...
:FORMat:DATA ...
:FORMat:DATA?
:SENSe:DATA:POINts?
:SENSe:DATA:POINts? ...
:SENSe:DATA:TSTamp? ...

" Processing Memory Overflow
:SENSe:DATA:MEMory:OVERflow:COUNt?
:SENSe:DATA:MEMory:OVERflow:COUNt? ...
:SENSe:DATA:MEMory:SAVE ...
:SENSe:DATA:MEMory:SAVE?

Operating and Programming Guide

5-89

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Defining the Time-stamped Edge _________________________
59551A

:SENSe:TSTamp:EDGE . . .

:SYSTem:PRESet

Selects the polarity of the edges the Receiver will time stamp.

RISing
NON-VOLATILE

This command selects the polarity of the edges the Receiver will time stamp.
Expanded Syntax
:SENSe:TSTamp1:EDGE RISing or FALLing
:SENSe:TSTamp2:EDGE RISing or FALLing
:SENSe:TSTamp3:EDGE RISing or FALLing
Parameter

•

The RISing parameter sets the time-stamped edge as the rising edge.

•

The FALLing parameter sets the time-stamped edge as the falling edge.

59551A

:SENSe:TSTamp:EDGE?

RESPONSE FORMAT

Returns the polarity of the edges the Receiver will time stamp.

XYZ

This query returns the polarity of the edges the Receiver will time stamp.
Response

RIS indicates that the time-stamped edge is the rising edge.
FALL indicates that the time-stamped edge is the falling edge.

59551A

c

a b

:SENSe:DATA:CLEar
Clears the data in the measurement buffer for all Time Tag inputs.

EVENT

This command clears the data in the measurement buffer and clears the
overflow counts for all Time Tag inputs.
Context Dependencies

:SYSTem:PRESet clears the time stamp measurement buffers and overflow
counts.

5-90

Operating and Programming Guide

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Clearing Time Stamp Memory ____________________________
59551A

:SENSe:DATA:CLEar . . .
Clears the data in the time stamp measurement buffer for the userspecified Time Tag input.

EVENT

This command clears the data in the time stamp measurement buffer for the
user-specified Time Tag input. Use "TSTamp 1" or "TSTamp 2" or "TSTamp 3"
to select one input.
Expanded Syntax
:SENSe:DATA:CLEar "TSTamp 1" or "TSTamp 2" or "TSTamp 3"
Parameter

"TSTamp 1" clears the data in Time Tag 1 input buffer.
"TSTamp 2" clears the data in Time Tag 2 input buffer.
"TSTamp 3" clears the data in Time Tag 3 input buffer.
Context Dependencies

:SYSTem:PRESet clears the time stamp measurement buffers.

Operating and Programming Guide

5-91

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Reading Time Stamps ____________________________________
59551A

:SENSe:DATA? . . .

RESPONSE FORMAT

Outputs data from the one specified time stamp measurement
buffer.

FORMAT = ASCii

± dd, ...
FORMAT = INTeger

BINARY Data

This query outputs data from the one specified time stamp measurement buffer
(or Time Tag input). This query does not clear the buffer. Each time stamp
provides the year, month, day, hours, minutes, seconds, milliseconds,
microseconds, nanoseconds, and TFOM (Time Figure of Merit).
Expanded Syntax
:SENSe:DATA? "TSTamp 1" or "TSTamp 2" or "TSTamp 3"
Response

If the format is ASCii (the default format), the response is a sequence of
comma-separated integers.
If the format is INTeger, the response is BINARY Data (see Table B-3, in
Appendix B, “Command Syntax and Style,” in this guide for details).
To determine which format is selected, use query :FORmat:DATA?.
Parameter

Use "TSTamp 1" or "TSTamp 2" or "TSTamp 3" to select one input at a time:
•

"TSTamp 1" outputs the data from Time Tag 1 input buffer.

•

"TSTamp 2" outputs the data from Time Tag 2 input buffer.

•

"TSTamp 3" outputs the data from Time Tag 3 input buffer.

Context Dependencies

:SYSTem:PRESet clears the time stamp measurement buffers and overflow
counts.
Time stamps are not collected until after the Receiver has completed its
powerup, and has reached initial lock to GPS.
Time stamps are not collected while the user is reading/clearing or otherwise
accessing the time stamp buffers.

5-92

Operating and Programming Guide

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Reading Time Stamps __________________________ (continued)
59551A

:FORMat:DATA . . .

:SYSTem:PRESet

Selects output format for the time stamps.

ASCii
NON-VOLATILE

This command selects the output format for the time stamps.
Expanded Syntax
:FORMat:DATA ASCii or INTeger
Parameter

If the format is ASCii (the default format), the response is a sequence of
comma-separated integers.
If the format is INTeger, the response to the :SENSe:DATA? query is BINARY
Data (see Table B-3, in Appendix B, “Command Syntax and Style,” in this
guide for details).
When ASCii formatting is selected the output stream data is buffered. In
general, INT mode will provide faster output than ASC, but will require special
data-handling routines to interpret the BINARY Data.

59551A

:FORMat:DATA?
Returns the output format for time stamp data.

RESPONSE FORMAT

XYZ

This query returns the output format for time stamp data.
Response

ASC or INT is returned.

Operating and Programming Guide

5-93

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Reading Time Stamps __________________________ (continued)
59551A

:SENSe:DATA:POINts?

RESPONSE FORMAT

Returns the number of time stamps in each of the three Time Tag
inputs.

± dd, ...

This query returns the number of time stamps in each of the three Time Tag
inputs.
Response

Returns three comma-separated integers corresponding to the number of time
stamps recorded for inputs 1, 2, and 3.
The numeric range for each integer is 0 to 256.
Context Dependencies

:SYSTem:PRESet clears the time stamp measurement buffers and overflow
counts.
Time stamps are not collected until after the Receiver has completed its
powerup and has reached initial GPS lock.

59551A

:SENSe:DATA:POINts? . . .

RESPONSE FORMAT

Returns the number of time stamps recorded for the one specified
Time Tag input.

± dd

This query returns the number of time stamps recorded for the one specified
Time Tag input. Use "TSTamp 1", "TSTamp 2", or "TSTamp 3" to select one
input.
Expanded Syntax
:SENSe:DATA:POINts? "TSTamp 1" or "TSTamp 2" or "TSTamp 3"
Response

Returns an integer corresponding to the number of time stamps recorded for
the specified input.
•

Numeric range is 0 to 256.

5-94

Operating and Programming Guide

Chapter 5 Command Reference
Event Time Stamping (59551A Only)

Reading Time Stamps __________________________ (continued)
Parameter

"TSTamp 1"queries for the number of points in Time Tag 1 input buffer.
"TSTamp 2" queries for the number of points in Time Tag 2 input buffer.
"TSTamp 3" queries for the number of points in Time Tag 3 input buffer.
Context Dependencies

:SYSTem:PRESet clears the time stamp measurement buffers and overflow
counts.
Time stamps are not collected until after the Receiver has completed its
powerup and has reached initial GPS lock.

59551A

:SENSe:DATA:TSTamp? . . .

RESPONSE FORMAT

Returns a single time stamp.

± dd, ...

This query returns a single time stamp. Use "TSTamp 1" or "TSTamp 2" or
"TSTamp 3" to select an input channel. Use 

Source Exif Data:
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.3
Linearized                      : Yes
Page Count                      : 262
XMP Toolkit                     : XMP toolkit 2.9.1-14, framework 1.6
About                           : uuid:4a1ab36d-6b90-45bc-ad7e-8acec276b25d
Producer                        : Acrobat Distiller 4.05 for Windows
Modify Date                     : 2005:05:26 17:09:24-05:00
Create Date                     : 2000:07:06 16:31:25Z
Metadata Date                   : 2005:05:26 17:09:24-05:00
Document ID                     : uuid:8dff6d0b-e999-4733-b33b-b165d375f2a5
Format                          : application/pdf
EXIF Metadata provided by EXIF.tools

Navigation menu