097 59551 02 Iss 1
097 59551 02 Iss 1
Issue 1: Apr 00
59551A
GPS Measurements
Synchronization Module
and
58503A
GPS Time and Frequency
Reference Receiver
Fax: 408-428-7998
E-mail: ctac@symmetricom.com
Internet: http://www.symmetricom.com
ii
Contents
Warning Symbols Used In This Book ii
iii
Contents
Chapter Contents 2
Chapter Contents 2
Operating Status 8
Clearing and Presetting Alarms 8
Reading and Qualifying Alarms 8
Reading and Qualifying Receiver Status 9
Reading and Qualifying Command Error Status 9
Reporting Questionable Status 9
Assessing Receiver Health 9
System Time 10
Identifying Time of Next 1 PPS Reference Edge 10
Reading Current Time 10
Applying Local Time Zone Offset 10
Defining the 1 PPS Reference Edge (59551A
Only) 10
Reading Leap Second Status 10
Receiver Initialization 14
Receiver Identification/Upgrade 15
Reading Product Identification 15
Installing Firmware via I/O Port 1 15
Description Format 4
Commands and Returns 4
Query-Specific Information 5
Description of Response Formats
(ASCII-encoded) 5
Operating Status 29
System Time 55
vi
Contents
Receiver Initialization 85
Receiver Identification/Upgrade 89
Introduction 2
Reading an Error 2
Error Queue 3
Error Types 4
No Error 4
Syntactic Error 4
Semantic Error 4
Hardware/Firmware Error 5
Query Error 6
List of Errors 8
Appendix Contents 2
Reference Documentation 2
viii
In This Guide
ix
In This Guide
x
1
1 2 3 4 5
1 When the Power indicator is illuminated, 4 When the Alarm indicator is illuminated, it
it indicates that the proper input power is indicates that the Module has detected a
supplied to the Module. condition that requires attention.
2 When the GPS Lock indicator is 5 PORT 2 RS-232C serial interface port for
illuminated, it indicates that the Module local control, monitoring, and retrieving of
is tracking satellites and has phase-locked the Module’s memory data.
its internal reference to the reference
provided by GPS.
WARNING: NO OPERATOR SERVICEABLE PARTS INSIDE, REFER SERVICING TO SERVICE TRAINED PERSONNEL.
! ! !
~ POWER
1 PPS Programmable IRIG-B
SERIAL PLATE
! Pulse
120-240 VAC
PORT 1 WARNING: 50/60 Hz
This unit must be 50 VA MAX
earth grounded.
CAUTION:
METRIC & INCH
HARDWARE.
!
7 8
1 2 3 4
WARNING: NO OPERATOR SERVICEABLE PARTS INSIDE, REFER SERVICING TO SERVICE TRAINED PERSONNEL.
!
! CAUTION: POWER
METRIC & INCH HARDWARE
CONSULT SERVICE MANUAL
110 VAC
I/O
PORT 1 WARNING: 24 VDC
This unit must be
earth grounded.
5 POWER ~ POWER
120-240 VAC
24 VDC
50/60 Hz
50 VA MAX
48 VDC
! 50 VA MAX !
Chapter Contents
This chapter describes how to operate the 59551A GPS Measurements
Synchronization Module and the 58503A 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:
• About the RS-232C Serial Port(s) page 2-2
– PORT 1 Rear-Panel RS-232C Serial Interface Port page 2-3
– PORT 2 Front-Panel RS-232C Serial Interface
Port (59551A Only) page 2-4
• Connecting a Computer or Modem page 2-5
– To Connect the 59551A to a PC or Modem
Via the Rear-Panel DB-25 Serial Port page 2-6
– To Connect the 59551A to a Laptop
Computer Via the Front-Panel DB-9 Serial Port page 2-7
• Configuring the RS-232C Port(s) page 2-9
– If You Need To Make Changes to the Serial Port
Settings page 2-10
– If Changes Have Already Been Made to the
Serial Port Settings page 2-11
ANT
! !
5181-6640
Adapter Computer
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-3.
GPS Receiver
(Rear view)
WARNING: NO OPERATOR SERVICEABLE PARTS INSIDE, REFER SERVICING TO SERVICE TRAINED PERSONNEL.
!
POWER
129 VDC
! !
Port 1 FOR LABORATORY USE BY
QUALIFIED PERSONNEL 48 VDC
FOUR USAGE EN LABORATOIRE
PAR PERSONNEL QUALIFIE
59551A
59551A
GPS MEASUREMENTS SYNCHRONIZATION MODULE OUTPUT
Computer
If you choose to make your own cable, see figures 2-5 and 2-6.
Figures 2-5 and 2-6 illustrate the 24542U cable (9-pin female to 9-pin
female connectors) and the 24542G cable (25-pin male to 9-pin female
connectors), respectively. Each of these cables are null-modem cables.
Note that pins 2 and 3 of the 24542G 25-pin (male) to 9-pin (female)
cable, shown in Figure 2-6, DO NOT cross; nevertheless, this cable is a
null-modem cable.
Data Data
Terminal Communications
Equipment Equipment
PC 24542U or F1015-80002 PORT 2
RS-232 (9-pin) Interface Cable Adapter RS-232 (9-pin)
1 1 1 1
PC input RXD 2 2 2 2 RXD Instrument input
PC output TXD 3 3 3 3 TXD Instrument output
4 4 4 4
GND 5 5 5 5 GND
6 6 6 6
7 7 7 7
8 8 8 8
9 9 9 9
Data Data
Terminal Communications
Equipment DE-9S-to-DE-9P Equipment
PC (DTE-to-DCE) Interface Cable 59551A PORT 2
RS-232C (9-pin) RS-232C (9-pin)
1 1
PC input RX 2 2 RX Instrument input
PC output TX 3 3 TX Instrument output
4 4
GND 5 5 GND
6 6
7 7
8 8
9 9
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.
Configuring PORT 1
Complete configuration of PORT 1 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
Chapter Contents
This chapter is organized as follows:
• Overview of the Visual User Interface page 3-7
• Setting Up the GPS Receiver page 3-4
– To Connect Antenna System to the Receiver page 3-4
– To Connect PC to the Receiver page 3-5
– To Power Up the Receiver page 3-7
• Accessing the Receiver Status Screen
(the Visual User Interface) page 3-7
– To Access the Manually Operated Receiver
Status Screen page 3-7
– To Install the Automated SatStat Program
for Continual Status Updates page 3-8
– To Operate the Automated SatStat Program page 3-9
• Using and Reading the Receiver Status Screen page 3-10
– Tutorial on Using the Status Screen to Interface
With the Receiver page 3-10
– Demonstration of Holdover Operation page 3-15
• The Receiver Status Screen at a Glance page 3-17
NOTE
Do not apply power to the Receiver unless a fully operational antenna system is connected to
the rear-panel ANTENNA input connector. Power applied with no antenna input or a
non-functioning antenna will initiate an extended search process that may increase time to
reach GPS lock. You can halt the extended search by cycling the Receiver power (you may
need to leave power off for greater than five seconds).
!
POWER
129 VDC
! !
Port 1 FOR LABORATORY USE BY
QUALIFIED PERSONNEL 48 VDC
FOUR USAGE EN LABORATOIRE
PAR PERSONNEL QUALIFIE
or any other terminal emulation program. (Note: Symmetricom is not endorsing any of
these products.)
If you are using a Windows-based PC, perform procedure in the subsection titled “To Configure
Terminal Communications for Windows-based PC ” on page 3-5.
If you are using a DOS-based PC (no Windows application), perform procedure in the
subsection titled “To Configure Terminal Communications for DOS-based PC (No Windows)”
on page 3-6.
To Configure Terminal Communications for Windows-based PC
1 Select or double click on the Terminal icon (a picture of a PC with a telephone in front of it)
in the Accessories window.
3 Set the RS-232C port of your PC to match the following default values:
Pace: NONE
Baud Rate: 9600
Parity: NONE
Data Bits: 8
Stops Bits: 1
NOTE
The RS-232C port configurations of the Receiver and the PC must be the same for
communications between the two. Thus, for this power-up procedure, set your PC to match
the default values listed above if this Receiver is being powered up for the first time from
the factory.
If the default values have been changed, as would be indicated by an error generation or no
scpi> prompt displayed after pressing Return (or Enter) on your PC, then refer to the
subsection titled “If Changes Have Already Been Made to the Serial Port Settings” in
Chapter 2 of this guide for more information.
NOTE
Do not apply power to the Receiver unless a fully operational antenna system is connected to
the rear-panel ANTENNA input connector. Power applied with no antenna input or a
non-functioning antenna will initiate an extended search process that may increase time to
reach GPS lock. You can halt the extended search by cycling the Receiver power (you may
need to leave power off for greater than five seconds).
4 In the Communications dialog box, be sure to select the appropriate port or connector
(COM2, for example).
5 Next, perform the power-up procedure described in the subsections titled “To Power Up the
Receiver.”
b. After a moment, the Receiver runs through its self-test diagnostics as indicated by
the flashing front-panel indicators.
c. After the self test is completed, just the Power indicator remains illuminated, and
the scpi> prompt is displayed on the screen of the PC. (There could also be an E xxx>
prompt if a pre-existing error has occurred.)
If the Alarm indicator lights, a failure may have occurred during the self test. Refer
to the section titled “Operating Status” in Chapter 5, “Command Reference,” of the
Operating and Programming guide for a complete description of the Alarm
capability.
d. The Receiver begins to search the sky for all available satellites.
The computer displays the status screen as shown in the sample status screen in
Figure 3-2.
(Note that you must re-enter the SYSTEM:STATUS? command each time you want an
updated status screen.)
2 See the section titled “Using and Reading the Receiver Status Screen" on page 3-10 of this
guide for a description of how to use and read the satellite acquisition information
displayed in the status screen.
2 From the File menu in either the Program Manager or File Manager, choose Run.
3 Type a:setup, and click OK or press Enter (Return). The SatStat Setup screen will appear,
and installation will proceed.
4 Once the program is installed, you can start it by double-clicking the SatStat icon that was
created during the installation.
5 You should establish communication with the GPS Receiver. This requires connection from
a serial RS-232C port on your PC to the GPS Receiver’s serial port (a 25-pin RS-232C
connection). Assuming you’ve got the cable attached to make this connection, you may want
to check the settings.
b. If you made any changes on this Settings form, select OK, otherwise you can just
Cancel.
2 Refer to the section titled “Using and Reading the Receiver Status Screen” on page 3-10 for
a tutorial and demonstration of what to look for when viewing the status screen.
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-5 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.
Figure 3-5. 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-5, 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,” in Chapter 2, “Features and Functions,” of
the Getting Started guide for more information about TFOM and FFOM.
Also indicated is a prediction of the accuracy of the Receiver should it go into holdover
operation.
CAUTION
The Receiver typically reaches stable state 24 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 :
• The front-panel Holdover LED will illuminate, and
• after sending the :SYSTEM:STATUS? query again, a screen similar to Figure 3-6
should appear.
Let’s send the :SYSTEM:STATUS? query. Figure 3-6 should appear.
Figure 3-7. 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.
nanoseconds.
nanoseconds.
nanoseconds. Az
Az
Az
Holdover
Holdover
HoldoverUncertainty
Uncertainty
Uncertainty
FFOM
FFOM
FFOM(Frequency
(Frequency
(FrequencyFigure Figure
Figureof of
ofMerit)
Merit)
Merit)
Frequency
Frequency
Frequencystability
stability
stabilityofof
ofthe
the
the10-MHz
10-MHz
10-MHzreference:
reference:
reference: Estimations
Estimations
Estimationsof of
oftiming
timing
timingaccuracy
accuracy
accuracywhile
while
whilein
in
inholdover
holdover
holdovermode,
mode,
mode,which
which
which C/N
C/N
C/N
000 Stable,
Stable,
Stable,signal
signal
signalwithin
within
withinspecification
specification
specification reflect
reflect
reflectthe
the
theextent
extent
extentto to
towhich
which
which SmartClock
SmartClock
SmartClockhas has
haslearned
learned
learnedthe
the
the
111 Stabilizing
Stabilizing
Stabilizingthis this
thissignal
signal
signal oscillator's
oscillator's
oscillator'scharacteristics:
characteristics:
characteristics:
222 Holdover
Holdover
Holdovermode; mode;
mode;frequency
frequency
frequencywill will
willdrift
drift
drift Predict
Predict
Predict Acq
Acq
Acq
333 Signal
Signal
Signalisisisunusable.
unusable.
unusable. Maximum
Maximum
Maximumtiming
timing
timingerror
error
errorthat
that
thatcan
can
canbebe
beexpected
expected
expectedover over
overthe
the
theinitial
initial
initial
1PPS
1PPS
1PPSTI TI
TI(Time
(Time
(TimeInterval)
Interval)
Interval) 24
24
24hours
hours
hoursofof
ofholdover
holdover
holdoveroperation.
operation.
operation. Acq
Acq
Acq ...
Average
Average
Averagephase
phase
phasedifference
difference
differencebetween
between
betweenthe the
theGPS
GPS
GPSreference
reference
referenceand
and
and Present
Present
Present
oscillator
oscillator
oscillator1PPS
1PPS
1PPSsignals.
signals.
signals. Maximum
Maximum
Maximumtiming
timing
timingerror
error
errorcurrently
currently
currentlyexpected.
expected.
expected. Acq
Acq
Acq ..
..
..
HOLD
HOLD
HOLDTHR THR
THR(Holdover
(Holdover
(HoldoverThreshold)
Threshold)
Threshold)
1PPS
1PPS
1PPSphase
phase
phasedifference
difference
differencethat that
thatwhile
while
whileexceeded
exceeded
exceededforcesforces
forcesholdover
holdover
holdover Ignore
Ignore
Ignore
operation.
operation.
operation. Not
Not
Not OK
OK
OK
Receiver
Receiver Status
Status ----------------------------
----------------------------
ACQUISITION
ACQUISITION
[ Outputs Valid/Reduced Accuracy ]
Reference
Reference Outputs
Outputs
TFOM
TFOM 3
3 FFOM
FFOM 22 ACQUISITION profiles
ACQUISITION profiles the
the process
process ofof acquiring
acquiring precise
precise time
time from
from
GPS.
GPS. GPS
GPS provides
provides time-of-day
time-of-day information
information and
and aa 1PPS
1PPS reference
reference
1PPS
1PPS TI
TI ---- signal
signal used
used to
to discipline
discipline the
the internal
internal oscillator.
oscillator.
HOLD
HOLD THR
THR 1.000
1.000 usus
Holdover
Holdover Uncertainty
Uncertainty
Predict
Predict 55.8
55.8 us/initial
us/initial 24
24 hrs
hrs
Present
Present 1.0
1.0 us
us Time
Time
[
[ GPS
GPS 1PPS
1PPS Valid
Valid ]
]
Time
Time Time
Time of of day:
day:
Az
Az PRN
PRN El
El Az
Az UTC
UTC UTC
UTC Coordinated
Coordinated Universal
Universal TimeTime
03:11:57
03:11:57 31
31 Jan
Jan 1996
1996 LOCAL
LOCAL UTC
UTC with
with local
local time
time zone
zone offset
offset
29
29 Not
Not OK
OK GPS
GPS 1PPS
1PPS Synchronized
Synchronized to
to UTC
UTC GPS
GPS GPS
GPS Time
Time
ANT
ANT DLY
DLY 120
120 ns
ns LOCL
LOCL GPS GPS GPS
GPS Time,
Time, with
with time
time zone
zone offset.
offset.
.
. Position
Position [[ ?? ]] identifies
identifies aa default
default power-up
power-up setting
setting that
that is
is corrected
corrected when
when the
the
MODE
MODE Survey:
Survey: 26.1%
26.1% complete
complete first
first satellite
satellite is
is tracked.
tracked.
Suspended:
Suspended: track
track <4
<4 sats
sats +1 (or
+1 (or -1)
-1) leap
leap second pending is
second pending is reported
reported ifif aa leap
leap second
second
..
.. AVG
AVG LAT
LAT N
N 37:19:31.797
37:19:31.797 correction
correction to to UTC
UTC isis pending.
pending.
AVG
AVG LON
LON W
W 121:59:52.018
121:59:52.018
AVG
AVG HGT
HGT 60.52
60.52 mm (GPS)
(GPS) GPS
GPS 1PPS
1PPS indicates
indicates the
the validity
validity of
of the
the GPS
GPS 1PPS
1PPS reference:
reference:
Synchronized
Synchronized to UTC (or
to UTC (or GPS
GPS Time)
Time)
[
[ OK
OK ]] 1PPS
1PPS reference
reference is
is synchronous
synchronous with with GPS
GPS
Questionable
Questionable accuracy...
accuracy...
Oven
Oven Pwr:
Pwr: OK
OK OCXO:
OCXO: OK
OK EFC:
EFC: OK
OK GPS
GPS Rcv:
Rcv: OK
OK Assessing
Assessing stability...
stability...
1PPS
1PPS must
must be
be accurate
accurate forfor 35
35 seconds
seconds
Inaccurate:
Inaccurate: not not tracking
tracking
Tracking
Tracking One
One or
or more
more satellites
satellites must
must bebe tracked
tracked
Inaccurate:
Inaccurate: inaccinacc position
position
Satellites
Satellites currently
currently tracked
tracked byby the
the receiver.
receiver. Four
Four or
or more
more satellites
satellites Postition
Postition must
must be
be known
known to to derive
derive time
time
must
must be
be tracked
tracked to to determine
determine position.
position. Timing
Timing information
information is
is Inaccurate:
Inaccurate: Time Time RAIMRAIM err err
derived
derived from
from all
all tracked
tracked satellites,
satellites, and
and is
is considered
considered accurate
accurate while
while GPS
GPS timing
timing integrity
integrity is
is suspect.
suspect.
tracking
tracking at
at least
least one
one satellite
satellite from
from aa known
known position.
position. The
The receiver
receiver
selects
selects satellites
satellites highest
highest in
in the
the sky
sky that
that are
are at
at or
or above
above the
the minimum
minimum ANT
ANT DLY
DLY offsets
offsets the
the GPS
GPS 1PPS
1PPS reference
reference to to compensate
compensate for
for
signal
signal propagation
propagation delays
delays introduced
introduced by by the
the antenna
antenna system.
system.
elevation
elevation angle
angle specified
specified byby ELEV
ELEV MASK.
MASK. (Time
(Time is
is referenced
referenced toto the
the position
position of
of the
the antenna.)
antenna.)
Not
Not Tracking
Tracking
Satellites
Satellites considered
considered for
for tracking.
tracking. These
These satellites
satellites are
are predicted
predicted toto
be
be visible
visible or
or are
are selected
selected byby the
the "sky
"sky search"
search" algorithm.
algorithm. Visibility
Visibility is
is Position
Position
predicted
predicted from
from the
the satellite
satellite almanac,
almanac, current
current time
time and
and position.
position.
An
An accurate
accurate position
position isis necessary
necessary to to transfer
transfer time
time from
from GPS.
GPS.
Tracking
Tracking and
and NotNot Tracking
Tracking tables
tables provide
provide supplemental
supplemental information
information Two
Two position
position MODEs
MODEs are are provided,
provided, hold hold and
and survey.
survey.
about
about satellite
satellite position,
position, signal
signal strength
strength and
and health:
health:
In
In Hold
Hold mode,
mode, aa fixed
fixed position
position is is used
used to to derive
derive time.
time. This
This position
position
PRN
PRN Identification
Identification number
number (pseudorandom
(pseudorandom noise noise code)
code) may
may bebe specified
specified ifif known,
known, or or determined
determined by by the
the survey
survey process.
process.
assigned
assigned to to the
the satellite.
satellite. Satellites
Satellites are
are sorted
sorted byby
ascending
ascending PRNs.
PRNs. In
In Survey
Survey mode,
mode, position
position isis determined
determined from from GPS.
GPS. Four Four or
or more
more
EI
EI Elevation
Elevation of of the
the satellite
satellite (degrees)
(degrees) predicted
predicted by by the
the satellites
satellites must
must bebe tracked.
tracked. Successive
Successive positional
positional estimates
estimates
almanac.
almanac. "---"
"---" denotes
denotes itit isis unknown,
unknown, such such as
as when
when (pseudoranges)
(pseudoranges) are are refined
refined toto obtain
obtain the the true
true position,
position, which
which is
is
the
the satellite
satellite is
is not
not predicted
predicted to to be
be visible
visible butbut is
is selected
selected entered
entered asas the
the held
held position
position atat the
the completion
completion of of this
this process.
process.
for
for tracking
tracking byby the
the sky
sky search
search algorithm.
algorithm. Averaged
Averaged (AVG)
(AVG) position
position coordinates
coordinates and and progress
progress are are reported
reported
Az
Az Azimuth
Azimuth of of the
the satellite
satellite (degrees),
(degrees), referenced
referenced to to true
true while
while surveying.
surveying. When
When surveying
surveying is is suspended,
suspended, an an advisory
advisory
north,
north, predicted
predicted by by the
the almanac;
almanac; "---"
"---" ifif unknown.
unknown. message
message describes
describes the the reason:
reason:
C/N
C/N Carrier-to-noise
Carrier-to-noise ratio ratio of
of the
the received
received signal.
signal. TheThe maximum
maximum Suspended:
Suspended: track track <4 <4 sats
sats
value
value is
is 50;
50; 3535 isis the
the minimum
minimum range range forfor stable
stable tracking.
tracking. Four
Four or
or more
more satellites
satellites must
must be be tracked
tracked to to determine
determine position
position
Suspended:
Suspended: poor poor geometry
geometry
Acq
Acq Locking
Locking code
code andand carrier
carrier tracking
tracking loops
loops to to initially
initially DOP
DOP (dilution
(dilution of
of precision)
precision) isis too
too large
large for
for an
an accurate
accurate pseudo-
pseudo-
acquire
acquire the
the satellite
satellite signal.
signal. range
range measurement.
measurement.
Acq
Acq .. Demodulating
Demodulating the the satellite
satellite broadcast
broadcast (NAV)
(NAV) message,
message, Specifying
Specifying an an approximate
approximate initial
initial (INIT)
(INIT) position
position will
will reduce
reduce
and
and determining
determining current
current time.
time. satellite
satellite acquisition
acquisition time.
time.
Acq
Acq ..
.. Reading
Reading thethe satellite
satellite ephemeris
ephemeris (orbital
(orbital information)
information)
from
from the
the NAV
NAV message.
message.
Ignore
Ignore The
The satellite
satellite is
is excluded
excluded from
from the
the selection
selection process.
process.
Not
Not OK
OK GPS
GPS oror Time
Time RAIM
RAIM reports
reports the
the satellite
satellite is
is unhealthy.
unhealthy.
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:
• An Introduction to the 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-4
– Facilitating Initial Tracking page 4-4
– 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-29
– Monitoring Status/Alarm Conditions page 4-8
– Assessing Receiver Health page 4-9
__________________________
Selecting Satellites
<select> = IGNore or INCLude
:GPS:SATellite:TRACking:EMANgle <degrees>
Sets the GPS elevation mask angle value.
:GPS:SATellite:TRACking:EMANgle?
Returns the GPS elevation mask angle value.
:GPS:SATellite:TRACking:IGNore <PRN>, ... , <PRN>
Sends list of satellites to ignore.
:GPS:SATellite:TRACking:IGNore?
Returns list of satellites to ignore.
:GPS:SATellite:TRACking:INCLude <PRN>, ... , <PRN>
:GPS:SATellite:TRACking:INCLude?
:GPS:SATellite:TRACking:<select>:ALL
:GPS:SATellite:TRACking:<select>:COUNt?
:GPS:SATellite:TRACking:<select>:NONE
:GPS:SATellite:TRACking:<select>:STATe? <PRN>
Monitoring Acquisition
:GPS:REFerence:VALid?
Indicates whether the date and time are valid (1 = valid).
:GPS:SATellite:TRACking?
Returns a list of all satellites being tracked.
:GPS:SATellite:VISible:PREDicted?
Returns the list of satellites (PRN) that the almanac predicts should be visible, given date, time,
and position.
:GPS:SATellite:TRACking:COUNt?
:GPS:SATellite:VISible:PREDicted:COUNt?
__________________________
Operating in Holdover
Initiating Manual Holdover
:SYNChronization:HOLDover:INITiate
Recovering from Holdover
:SYNChronization:HOLDover:WAITing?
Returns prioritized reason why the Receiver is waiting to recover.
:SYNChronization:HOLDover:RECovery:INITiate
:SYNChronization:HOLDover:RECovery:LIMit:IGNore
:SYNChronization:IMMediate
__________________________
Operating Status
The following commands are provided 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.
_________________________
System Time
The following commands are provided to allow you to monitor and control
the system date and time. These commands 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 leap second occurrences.
__________________________
R: Accessible via rear-panel PORT 1.
:PULSe:CONTinuous:PERiod <seconds>
Sets the interval between pulses in seconds.
:PULSe:CONTinuous:PERiod?
Returns the interval between pulses in seconds.
:PULSe:CONTinuous:STATe ON or OFF
Selects whether the Programmable Pulse output will be just one pulse or a sequence of pulses.
:PULSe:CONTinuous:STATe?
Identifies whether the Programmable Pulse output is set to output a single pulse or
sequence of pulses.
:PULSe:REFerence:EDGE RISing or FALLing
Selects the polarity of the Programmable Pulse on-time edge.
:PULSe:REFerence:EDGE?
Returns the polarity of the Programmable Pulse on-time edge.
:PULSe:STARt:DATE <four-digit year>, <month>, <day>
Sets the date when the individual pulse (or first pulse of the pulse sequence) is to be generated at
the Programmable Pulse output.
:PULSe:STARt:DATE?
Returns the date when the individual pulse (or first pulse of the pulse sequence) is generated at
the Programmable Pulse output.
:PULSe:STARt:TIME <hour>, <minute>, <second>
Sets the time when the individual pulse (or first pulse of the pulse sequence) is to be generated at
the Programmable Pulse output.
:PULSe:STARt:TIME?
Returns the time when the individual pulse (or first pulse of the pulse sequence) is generated at
the Programmable Pulse output.
______________________
__________________________
__________________________
R: Accessible via Rear-panel PORT 1.
F: Accessible via Front-panel PORT 2 of the 59551A
Receiver Initialization
The following commands are provided to allow you to initialize or preset
the serial interface port(s) and the Receiver to their factory shipment
values.
R :SYSTem:COMMunicate:SERial1:PRESet
:SYSTem:COMMunicate:SERial2:PRESet (59551A Only)
:SYSTem:PRESet
__________________________
R: Accessible via Rear-panel PORT 1
.
Receiver Identification/Upgrade
The commands provided in this section allow you to query the
identification of the Receiver, and to perform firmware upgrades in the
field after you obtain a new firmware disk.
__________________________
Command Reference
Command Reference
Chapter Contents
This chapter 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.”
This chapter is organized as follows:
• Command Syntax Conventions page 5-3
• Description Format page 5-4
– Commands and Returns page 5-4
– Query-Specific Information page 5-5
• GPS Satellite Acquisition page 5-6
– Facilitating Initial Tracking page 5-7
– Establishing Position page 5-9
– Selecting Satellites page 5-13
– Compensating for Antenna Delay page 5-17
– Monitoring Acquisition page 5-19
• 1 PPS Reference Synchronization page 5-21
– Monitoring 1 PPS Synchronization page 5-22
– Assessing 1 PPS Quality page 5-23
– Operating in Holdover page 5-7
• Operating Status page 5-8
– Receiver Operation at a Glance page 5-30
– Reading the Error Queue page 5-8
– Reading the Diagnostic Log page 5-29
– Monitoring Status/Alarm Conditions page 5-36
– Assessing Receiver Health page 5-9
Description Format
Commands and Returns
Product Compatibility
(if not present, the command is
supported by both products)
Description
This command identifies the date when
the pulse sequence) is generated at the Pr
Query-Specific Information
Response Format
(Refer to the following section titled
"Description of Response Formats
(ASCII-encoded)" for more information.)
59551A
:PULSe:STARt:DATE?
c
a b RESPONSE FORMAT
The following commands are provided to facilitate initiate 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.
Establishing Position
:GPS:POSition ...
:GPS:POSition?
:GPS:POSition:ACTual?
:GPS:POSition:HOLD:LAST?
:GPS:POSition:HOLD:STATe?
:GPS:POSition:SURVey:PROGress?
:GPS:POSition:SURVey:STATe ...
:GPS:POSition:SURVey:STATe?
:GPS:POSition:SURVey:STATe:POWerup ...
:GPS:POSition:SURVey:STATe:POWerup?
Selecting Satellites
:GPS:SATellite:TRACking:EMANgle ...
:GPS:SATellite:TRACking:EMANgle?
:GPS:SATellite:TRACking:IGNore ...
:GPS:SATellite:TRACking:IGNore?
:GPS:SATellite:TRACking:INCLude ...
:GPS:SATellite:TRACking:INCLude?
:GPS:SATellite:TRACking:<select>:COUNt?
:GPS:SATellite:TRACking:<select>:STATe? ...
Monitoring Acquisition
:GPS:REFerence:VALid?
:GPS:SATellite:TRACking?
:GPS:SATellite:VISible:PREDicted?
:GPS:SATellite:TRACking:COUNt?
:GPS:SATellite:VISible:PREDicted:COUNt?
:GPS:INITial:DATE . . . :SYSTem:PRESet
Not affected
Sets an approximate date for faster initial GPS acquisition.
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
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.
:GPS:INITial:POSition . . . :SYSTem:PRESet
:Not affected
Sets an approximate position for faster initial GPS acquisition.
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, <latitude degree>,
<latitude minute>,
<latitude second>,
E or W, <longitude degree>,
<longitude minute>,
<longitude second>,
<height above mean sea level, in meters>
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.
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.
:GPS:INITial:TIME . . . :SYSTem:PRESet
Not affected
Sets an approximate time for faster initial GPS acquisition.
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 <hour>,<minute>,<second>
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.
:GPS:POSition . . . :SYSTem:PRESet
latitude: N 0:00:00.000
Defines the position of the Receiver. longitude: E 0:00:00.000
height: 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, <latitude degree>,
<latitude minute>,
<latitude second>,
E or W, <longitude degree>,
<longitude minute>,
<longitude second>,
<height above mean sea level, in meters>
: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:
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.
Command Reference 5-9
Command Reference
Side Effects
This command stops position surveying. The computed position is retained and applied only
when SURVey is specified.
Response
Returns a list of values defining the Receiver position:
N or S, <latitude degree>, <latitude minute>, <latitude second>,
E or W, <longitude degree>,<longitude minute>, <longitude second>,
<height above mean sea level, meters>
Context Dependencies
Error -230 is generated if in survey and first calculation has not occurred.
This query returns the current instantaneous position of the GPS antenna.
Response
Returns a list of values defining the Receiver position:
N or S, <latitude degree>, <latitude minute>, <latitude second>,
E or W, <longitude degree>,<longitude minute>, <longitude second>,
<height above mean sea level, in meters>
Context Dependencies
Error -230 is generated if in survey and first calculation has not occurred.
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-10 for
details.
Response
Returns a list of values defining the Receiver position:
N or S, <latitude degree>, <latitude minute>, <latitude second>,
E or W, <longitude degree>,<longitude minute>, <longitude second>,
<height above mean sea level, meters>
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.
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.
This query returns percent completed while in survey mode. Automatic transition to
position-hold mode occurs following completion of survey mode (indictated 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 . . . :SYSTem:PRESet
Initiates survey mode during which the Receiver determines its ONCE
position from satellite data.
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
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
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.
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.
:GPS:SATellite:TRACking:EMANgle . . . :SYSTem:PRESet
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 <degrees>
Parameter
<degrees> 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.
Response
The range is 0 degrees to 89 degrees.
:GPS:SATellite:TRACking:IGNore . . . :SYSTem:PRESet
No satellites ignored
Adds the specified satellites to the list that the Receiver ignores
for tracking.
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).
Context Dependencies
This command is always valid. On send, if any item in the <PRN> list is invalid, the entire list
will be rejected. Error -222 will be generated.
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.
:GPS:SATellite:TRACking:INCLude . . . :SYSTem:PRESet
All satellites included
Adds the specified satellites to the list that the Receiver
considers for tracking..
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
Context Dependencies
This command is always valid. On send, if any item in the <PRN> list is invalid, the entire list
will be rejected. Error -222 will be generated.
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.
Returns the number of satellites that are on the list to ignore for ± dd
tracking.
:GPS:SATellite:TRACking:INClude:COUNt? ± dd
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.
:GPS:SATellite:TRACking:INClude:STATe? . . . 0 or 1
Returns the include status of the specified satellite.
Expanded Syntax
:GPS:SATellite:TRACking:IGNore:STATe? <PRN>
:GPS:SATellite:TRACking:INClude:STATe? <PRN>
Parameter
<PRN> 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.
Context Dependencies
After a :SYSTem:PRESet, all satellites are removed from the list to ignore.
:GPS:REFerence:ADELay . . . :SYSTem:PRESet
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 <numeric_value>
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 table below lists the delay values that you need to use with the GPS:REFerence:ADELay
command for the available cable assemblies.
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.
This query identifies whether date and time are valid. Returns 0 or 1; 1 indicates date and time
are valid. This is the same as bit 2 in the Powerup Status Register. This command makes it
convenient to check whether the date and time are valid without checking the Powerup Status
Register.
Response
A value of 1 indicates date and time are valid.
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 ( <PRN>).
Returns the list of satellites (PRN) that the almanac predicts ± dd, ...
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 ( <PRN>).
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.
Response
If there are no satellites being tracked, this query returns a 0.
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.
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.
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
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.
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%.
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.
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.
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 Definition
Value
1 PLL stabilizing
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.
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.
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.
*1 1 – 10 6 105 – 106
* The TFOM values 0, 1, and 2 are not presently used in the 58503A and
59551A products. The 58503A and 59551A products will display TFOM
values ranging from 9 to 3, which is consistent with the specified accuracies of each product.
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.
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.
Set to 0,0 after a :SYSTem:PRESet. If there was a prior holdover, the duration will be lost.
:SYNChronization:HOLDover:DURation:THReshold . . . :SYSTem:PRESet
Sets the duration (in seconds) to be used as a limit each time 86400
holdover begins. (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 <seconds>
Parameter
Resolution of the <seconds> parameter is 1 second.
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.
:EXCeeded?
Identifies if the Receiver has been in holdover longer than the 0 or 1
amount of time specified by the THReshold command.
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.
: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
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.
Command Reference 5-27
Command Reference
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
:SYNChronization:HOLDover:RECovery:LIMit:IGNore
Initiates recovery from holdover if recovery was inhibited by EVENT
time intervals exceeding limit.
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 EVENT
Receiver output 1 PPS if the command is issued during
recovery from holdover.
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.
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 the status registers is included.
:STATus:<register>:CONDition?
:STATus:<register>:EVENt?
:STATus:<register>:ENABle ...
:STATus:<register>:ENABle?
:STATus:<register>:NTRansition ...
:STATus:<register>:NTRansition?
:STATus:<register>:PTRansition ...
:STATus:<register>:PTRansition?
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.
Returns the number of lines of formatted text that are in the ±dd
Receiver Status screen.
This query returns the number of lines of formatted text that are in the Receiver Status screen.
Returns the oldest error in the Error Queue and removes that ±dd,“XYZ”
error from the queue (first in, first out).
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: <error_number>,"<error_description>", where
• An error number value of zero indicates that the Error Queue is empty.
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.
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.
The DIAGnostic commands for the log are described in the following text.
:DIAGnostic:LOG:CLEar :SYSTem:PRESet
Log is cleared
Clears the diagnostic log.
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.
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
Log is cleared
Clears only the current diagnostic log.
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
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.
Response
Range is 1 to 222, maximum is subject to change.
Response
The diagnostic log entry format is: "Log NNN: YYYYMMDD.HH:MM:SS: <log_message>",
where:
Log indicates a diagnostic log entry, and NNN is the log entry number
Expanded Syntax
Parameter
Range is 1 to current log count.
Response
The diagnostic log entry format is: "Log NNN: YYYYMMDD.HH:MM:SS: <log_message>",
where:
Log indicates a diagnostic log entry, and NNN is the log entry number
Context Dependencies
This query is always valid. If no log message is associated with the requested log number, error -
222 is generated.
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.
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/Status Reporting System at a Glance
foldout — pages 4-17 and 4-18, respectively.)
Powerup
"OR" Operation
0 First Satellite Tracked
0
1 Oscillator Oven Warm Powerup Summary
2 Date & Time Valid 1 Locked
2 "OR"
Holdover Summary
3 Position Hold
Holdover 4 1 PPS Reference Valid
5
0 Holding "OR" Hardware Summary
1 Waiting to Recover 6 Log Almost Full
2 Recovering
3 Exceeding Threshold
Hardware
0 Selftest Failure
1 +15V Supply Exceeds Tolerance
2 -15V Supply Exceeds Tolerance
3 +5V Supply Exceeds Tolerance
4 Oven Supply Exceeds Tolerance
not used "OR"
6 EFC Voltage Near Full-Scale Shading identifies
summary bit. Powerup Summary
7 EFC Voltage Full-Scale
8 GPS 1 PPS Failure
Default Transition Filter Default Event Enable
9 GPS Failure
10 TI Measurement Failed False-to-true (positive) Event enabled to report to
transition latches event. summary bit.
11 EEPROM Write Failed
Not applicable Event disabled
12 Internal Reference Failure
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.
Alarm Status
The Alarm Status summarizes condition changes from the three major
functional status groups (Questionable, Command Error, and Operation).
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 1 PPS Reference Valid condition (bit 4) indicates that the GPS
1 PPS signal is suitable to use as a locking reference.
• 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.
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.
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.
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 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 Query Error status event (bit 2). Errors -400 through -499 are
query 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.
*CLS
Clears the current alarm and prepares the Receiver for the EVENT
next alarm activation.
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 prompt of the serial I/O port (which transmits *CLS) reflects error
queue clearing.
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.)
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.
:STATus:PRESet:ALARm
Presets the status/alarm reporting system to generate an alarm EVENT
when a factory default set of operating conditions occurs.
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.
Alarm
Condition
Register
not used
not used
not used
3 Questionable Summary
*STB? not used
5 Command Error Summary
6 Master Summary
7 Operation Summary "AND"
&
Alarm "OR"
Enable :LED:ALARm?
Register &
Alarm
not used
not used
not used &
3 Questionable Summary
*SRE <bit mask> not used
*SRE? 5 Command Error Summary
not used
7 Operation Summary
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 theAlarm
Condition Register.
*SRE . . . :SYSTem:PRESet
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
Semantics
The <bit mask> has a range of 0 to 255.
The <bit mask> 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.
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.
Theory
Reading/Querying the Alarm Enable Register does not change its contents.
Response
The range is 0 to 255.
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.
&
n n
* & "OR"
<register> = OPERation or
QUEStionable or Enables events to
OPERation:HARDware or report to summary bit
OPERation:HOLDover or :STATus:<register>:ENABle <bit mask>
OPERation:POWerup :STATus:<register>:ENABle?
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.
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.
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.
Expaned 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.
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:<register>:NTRansition and
:STATus:<register>: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.
See Also
:STATus:<register>:NTRansition . . .
:STATus:<register>:PTRansition . . .
:STATus:<register>:ENABle . . . :SYSTem:PRESet
See Figure 5-1 for Default
Sets the specified enable register. 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
The <bit mask> 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.
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.
Theory
Reading/Querying an enable register does not change its contents.
:STATus:<register>:NTRansition . . . :SYSTem:PRESet
See Figure 5-1 for Default
:STATus:<register>:PTRansition . . . Transition Filter identification
NON-VOLATILE
Sets the specified transition filter registers.
Expanded Syntax
The <bit mask> 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.
Note that some bits, those which are “event-only”, have no transition filter
setting. Attempts to set these bits are ignored.
:STATus:<register>:PTRansition? ±dd
Reads the specified transition filter registers.
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.
Command Error
Event
Register
not used
not used
2 Query Error "AND"
3 Hardware/Firmware Error
ESR?
* 4 Semantic Error &
5 Syntactic Error
not used
7 Power Cycled &
*ESE . . . :SYSTem:PRESet
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
Parameter
The <bit mask> has a range of 0 to 255.
The <bit mask> 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.
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.
Theory
Reading/Querying the Command Error Enable Register does not change
its contents.
Response
The range is 0 to 255.
:STATus:QUEStionable:CONDition:USER . . . SYSTem:PRESet
Expanded Syntax
Parameter
SET will cause the User-reported bit of Questionable Condition Register to
be set to 1.
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 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.
:STATus:QUEStionable:EVENt:USER . . .
Generates a transition of the User-reported bit of the EVENT
Questionable Condition Register.
NON-VOLATILE
Expanded Syntax
Parameter
PTRansition will cause the User-reported bit of Questionable Condition
Register to transition from a setting of 0 to a setting of 1.
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.
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.
This query causes an internal selftest and the response indicates whether
any errors were detected. This test takes about 40 seconds to complete.
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.
Returns the lifetime count, indicating the total powered-on time. ±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.
Expanded Syntax
Response
A value of 0 (zero) indicates test passed.
Parameter
ALL returns test information for all of the tests
Returns the result of the last test and the type of test ±dd, XYZ
performed.
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.
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.
_____________________________________________________________________
_
Response
The query response provides the following type of information:
• service request.
Reading Current
Time___________________________________
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: <year>,<month>,<day>.
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.
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: <hour>,<minute>,<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. Sending this query
before the first lock will generate error -230.
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.
:PTIMe:TZONe . . . :SYSTem:PRESet
Sets the time zone local time offset to provide an offset from 0,0
UTC to serve as the basis for all reported time.
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 <hour>, <minutes>
Parameter
• The <hour> range is -12 to +12, and is rounded to the nearest
integer.
Context Dependencies
:SYSTem:PRESet sets the time zone to zero (0,0).
Response
The first returned value is offset hours. The second returned value is offset
minutes.
59551A
:PTIMe:PPS:EDGE . . . :SYSTem:PRESet
NON-VOLATILE
Expanded Syntax
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
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.
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 accumlated 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.
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: <year>,<month>,<day>.
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.
Returns the duration of the minute corrected by the next leap ±dd
second.
Response
Returns a value of 59, 60 or 61:
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.
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.
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.
The following commands are provided to allow you to operate and control
the programmable output of the 59551A GPS Receiver.
: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?
59551A
:PULSe:CONTinuous:PERiod . . . :SYSTem:PRESet
NON-VOLATILE
Expanded Syntax
:PULSe:CONTinuous:PERiod <seconds>
Parameter
The <seconds> 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
59551A
:PULSe:CONTinuous:STATe . . . :SYSTem:PRESet
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? RESPONSE FORMAT
Response
• A value of 0 indicates the Receiver is set to output one pulse.
59551A
:PULSe:REFerence:EDGE . . . :SYSTem:PRESet
NON-VOLATILE
Expanded Syntax
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
This query returns the 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.
59551A
:PULSe:STARt:DATE . . . :SYSTem:PRESet
Identifies the date when the individual pulse (or first pulse of 1994, 1, 1
the pulse sequence) is generated at the Programmable Pulse
output.
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
Parameter
• The <four-digit year> range is 1994 to 3000.
• The <month> range is 1 to 12.
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? RESPONSE FORMAT
Returns the date when the individual pulse (or first pulse of the ±dd, ±dd, ±dd
pulse sequence) is generated at the Programmable Pulse
output.
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: <four-digit year>,<month>,<day>.
59551A
:PULSe:STARt:TIME . . . :SYSTem:PRESet
Identifies the time when the individual pulse (or first pulse of 0,0,0
the pulse sequence) is generated at the Programmable Pulse
output.
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 <hour>,<minute>,<second>
Parameter
Three fields are separated by commas: <hour>,<minute>, <second>.
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 ±dd, ±dd, ±dd
pulse sequence) is generated at the Programmable Pulse
output.
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: <hour>, <minute>, <second>.
The following commands are provided to allow you to tag and record
events such as power surges and power outages.
59551A
:SENSe:TSTamp<channel>: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
Parameter
• The RISing parameter sets the time-stamped edge as the rising
edge.
59551A
:SENSe:TSTamp<channel>: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.
59551A
:SENSe:DATA:CLEar
Clears the data in the measurement buffer for all Time Tag EVENT
inputs.
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.
59551A
:SENSe:DATA:CLEar . . . :
Clears the data in the time stamp measurement buffer for the EVENT
user-specified Time Tag input.
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
Parameter
"TSTamp 1" clears the data in Time Tag 1 input buffer.
Context Dependencies
:SYSTem:PRESet clears the time stamp measurement buffers.
59551A
:SENSe:DATA? . . . RESPONSE FORMAT
FORMAT = ASCii
Outputs data from the one specified time stamp measurement
±dd, ...
buffer.
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
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, “SCPI Syntax and Style,” in this guide for details).
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.
59551A
:FORMat:DATA . . . :SYSTem:PRESet
NON-VOLATILE
This command selects the output format for the time stamps.
Expanded Syntax
Parameter
If the format is ASCii (the default format), the response is a sequence of
comma-separated integers.
59551A
:FORMat:DATA? RESPONSE FORMAT
This query returns the output format for time stamp data.
Response
ASC or INT is returned.
59551A
:SENSe:DATA:POINts? RESPONSE FORMAT
Returns the number of time stamps in each of the three Time ±dd, ...
Tag inputs.
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.
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 ±dd
specified Time Tag input.
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
Response
Returns an integer corresponding to the number of time stamps recorded
for the specified input.
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
This query returns a single time stamp. Use "TSTamp 1" or "TSTamp 2" or
"TSTamp 3" to select an input channel. Use <time stamp entry> to select a
single time stamp recorded on that input.
Expanded Syntax
Response
The query response represents the single time stamp requested.
For example,
Parameter
<time tag input> parameter:
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:MEMory:OVERflow:COUNt? RESPONSE FORMAT
Returns an overflow count for each of the three Time Tag ±d.dEe, ...
inputs.
This query returns an overflow count for each of the three Time Tag
inputs. An “overflow count” occurs after 256 time stamps have been
recorded. When any additional events are detected at the input, the
overflow count increments.
If memory management protocol has been set to “FIRST,” the first 256
time stamps are recorded. The overflow count indicates the number of time
stamps which followed the last recorded stamp, and which were discarded.
If memory management protocol has been set to “LAST,” the most recent
256 time stamps are recorded. The overflow count indicates the number of
stamps which were collected prior to the first recorded stamp, and which
were overwritten.
Response
Returns three comma-separated floating-point numbers corresponding to
the overflow count of each of the three inputs: 1, 2, 3.
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
Returns an overflow count for the selected Time Tag input. ±d.dEe
This query returns an overflow count for the selected Time Tag input. Use
"TSTamp 1", "TSTamp 2", or "TSTamp 3" to select or query one input at a
time.
Expanded Syntax
Response
Returns one floating-point number corresponding to the overflow count of
the selected Time Tag input.
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:MEMory:SAVE . . . :SYSTem:PRESet
NON-VOLATILE
Expanded Syntax
Parameter
FIRSt retains time stamps for the first 256 events detected.
LAST retains time stamps of the last (most recent) 256 events detected.
Context Dependencies
:SYSTem:PRESet sets memory management protocol to retain time
stamps for FIRSt 256 events.
59551A
:SENSe:DATA:MEMory:SAVE? RESPONSE FORMAT
Response
FIRS indicates that the memory retains time stamps for the first 256
events detected.
LAST indicates that the memory retains time stamps for the last (most
recent) 256 events detected.
The following commands are provided to allow you to configure the ports
This query identifies which serial port is being used. Use this query when
the Receiver is installed out of sight or at a remote location. The
distinction between SERIAL1 and SERIAL2 is required in communication
commands for setting parameters such as baud and parity.
Response
SER1 or SER2 is returned.
:SYSTem:COMMunicate:<port>:BAUD . . . R, F✝
:SYSTem:PRESet
Not affected
Sets the baud rate of specified port.
NON-VOLATILE
Expanded Syntax
Parameter
The possible baud rate values that can be entered are 1200, 2400, 9600, or
19200.
Context Dependencies
The baud rate value is stored in non-volatile memory. It is unaffected by
powerup and :SYSTem:PRESet.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:BAUD?
:SYSTem:COMMunicate:SERial2:BAUD?
:SYSTem:COMMunicate:SERial1:BITS . . . :SYSTem:PRESet R
Not affected.
Sets the data bits value of PORT 1.
NON-VOLATILE
Expanded Syntax
:SYSTem:COMMunicate:SERial1:BITS 7 or 8
Parameter
The possible data bits values that can be entered are 7 or 8.
Context Dependencies
The data bits value is stored in non-volatile memory. It is unaffected by
powerup and :SYSTem:PRESet.
This query returns the data bits value of the specified port.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:BITS?
:SYSTem:COMMunicate:SERial2:BITS?
:SYSTem:COMMunicate:<port>:FDUPlex . . . R, F✝
:SYSTem:PRESet
Not affected
Sets the duplex state of specified port.
NON-VOLATILE
This command sets the duplex state of the specified port. Use this
command when you cannot see on the computer screen the characters you
are typing for your command.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:FDUPlex ON or OFF
:SYSTem:COMMunicate:SERial2:FDUPlex ON or OFF
Parameter
ON enables echoing of the characters you type (i.e., when typing a
command, the ON state allows you to see on the computer screen the
characters you type).
Context Dependencies
The duplex state is stored in non-volatile memory. It is unaffected by
powerup and :SYSTem:PRESet.
________________________
✝ Must be received via the specified I/O port.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:FDUPlex?
:SYSTem:COMMunicate:SERial2:FDUPlex?
Response
A value of 0 indicates echo is OFF.
:SYSTem:COMMunicate:<port>:PACE . . . R, F✝
:SYSTem:PRESet
Not affected
Sets flow control of the specified port.
NON-VOLATILE
Expanded Syntax
Parameter
The choices are XON or NONE.
Context Dependencies
The software pacing or flow control state is stored in non-volatile memory.
It is unaffected by powerup and :SYSTem:PRESet.
_________________________
✝ Must be received via the specified I/O port.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:PACE?
:SYSTem:COMMunicate:SERial2:PACE?
Response
XON or NONE is returned.
:SYSTem:COMMunicate:<port>:PARity . . . R, F✝
:SYSTem:PRESet
Not affected
Sets parity of the specified port.
NON-VOLATILE
Expanded Syntax
Parameter
The choices for SERial1 are EVEN, ODD, or NONE.
Context Dependencies
The parity state is stored in non-volatile memory. It is unaffected by
powerup and :SYSTem:PRESet.
_________________________
✝ Must be received via the specified I/O port.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:PARity?
:SYSTem:COMMunicate:SERial2:PARity?
Response
EVEN, ODD, NONE, or ONE is returned.
:SYSTem:COMMunicate:SERial1:SBITs . . . :SYSTem:PRESet R
Not affected
Sets the stop bits value of PORT 1.
NON-VOLATILE
Expanded Syntax
:SYSTem:COMMunicate:SERial1:SBITs 1 or 2
Parameter
The possible stop bits values that can be entered are 1 or 2.
Context Dependencies
The stop bits value is stored in non-volatile memory. It is unaffected by
powerup and :SYSTem:PRESet.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:SBITs?
:SYSTem:COMMunicate:SERial2:SBITs?
This query returns the last response item issued through the Receiver's
serial interface for use in an error recovery process.
In the case of a serial interface data transmission error, this query can be
used to get the last response item which may otherwise be unavailable
because of the side effects of the original command. For example, the
:SYST:ERRor? query removes the oldest entry from the error queue, so to
see the entry again following a data transmission error, use
:DIAG:QUER:RESP? instead of repeating the original command.
Response
The format depends on the last issued query.
Receiver Initialization
The following commands are provided to allow you to initialize or preset
the serial interface port(s) and the Receiver to their factory shipment
values.
:SYSTem:COMMunicate:SERial1:PRESet
:SYSTem:COMMunicate:SERial2:PRESet (59551A Only)
:SYSTem:PRESet
:SYSTem:COMMunicate:<port>:PRESet
Sets the specified port configuration to its factory-default EVENT
values.
Expanded Syntax
:SYSTem:COMMunicate:SERial1:PRESet
:SYSTem:COMMunicate:SERial2:PRESet
Context Dependencies
The SERial1 preset command only is valid if transmitted on the rear-panel
(PORT 1).
:SYSTem:PRESet
Restores the Receiver parameters settings to their EVENT
factory-default values.
NOTE Issuing this command will result in disruption of all of the following: GPS
satellite tracking, reference oscillator frequency, 1 PPS output timing, and
Receiver status information.
___________________________
* NV stands for non-volatile memory.
**V stands for volatile memory.
:SYNChronization:STATe? POWerup
___________________________
* NV stands for non-volatile memory.
**V stands for volatile memory.
Receiver Identification/Upgrade
The commands provided in this section allow you to query the
identification of the Receiver, and to perform firmware upgrades in the
field after you obtain a new firmware disk.
Response
• A sequence of ASCII-encoded bytes:
• For example,
HEWLETT-PACKARD, 59551A,3426A00123,3422 – A
Context Dependencies
Preparatory to installation of new product firmware, the instrument is
switched to the “INSTALL” language, available only on PORT 1. The
“INSTALL” language includes an *IDN? query which returns the revision
identification for the installation firmware. The response format is the
same as described above for the instrument’s “PRIMARY” language, but
the identification code may be different.
NOTE The SatStat program provides a Service menu which automates firmware
installation.
*CLS R
Clears errors. EVENT
:DIAGnostic:DOWNload . . . R
Sends down a MotorolaS-record. EVENT
Expanded Syntax
:DIAGnostic:ERASe R
Erases the flash EEPROM. EVENT
This command erases the flash EEPROM. It should ONLY be sent to the
Receiver as a preparatory step during firmware upgrade. Erasing flash
EEPROM will disable the instrument until flash EEPROM is reloaded
with factory-supplied instrument firmware.
Response
A value of 1 indicates that flash EEPROM has been erased.
This query returns the oldest error in the Error Queue and removes that
error from the queue (first in, first out).
Response
The error response format is: <error_number>,"<error_description>",
where
Context Dependencies
:SYSTem:PRESet clears the Error 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.
:SYSTem:LANGuage . . . :SYSTem:PRESet R
Switches the operation mode (primary or install) of the “PRIMARY”
Receiver.
NON-VOLATILE
Expanded Syntax
:SYSTem:LANGuage "INSTALL" or "PRIMARY".
Parameter
The “INSTALL” language is part of a highly-specialized set of features
used to erase the Receiver’s firmware, and to install a new firmware
revision. It should be selected only when firmware installation is required.
NOTE The SatStat program provides a Service menu which automates firmware
installation.
Response
“INSTALL” or “PRIMARY” is returned.
Error Messages
Error Messages
Introduction
This appendix explains how to read any errors from the Receiver,
discusses the error queue, types of errors and general error behavior,
and provides a table of all of the Receiver’s errors and their probable
causes.
Reading an Error
Executing the :SYSTEM:ERROR? command reads the oldest error from
the error queue and erases that error from the queue. The :SYST:ERR?
response has the form:
<error number>, <error string>
An example response is:
-113,"Undefined header"
scpi>
Positive error numbers are specific to the Receiver. Negative error
numbers are command language related and are discussed later in this
appendix.
All errors set a corresponding bit in the Standard Event Status Register
(see Figure 5-1).
Error Queue
As errors are detected, they are placed in an error queue. This queue is
first in, first out. That is, if there has been more than one error, the first
one in the queue is read out with :SYST:ERR?. Subsequent responses
continue until the queue is empty.
If the error queue overflows, the last error in the queue is replaced with
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 length of the Receiver’s error queue is 30 (29 positions for the error
messages, and 1 position for the “Queue overflow” error). Reading an
error from the head of the queue removes that error from the queue, and
opens a position at the tail of the queue for a new error, if one is
subsequently detected.
When all errors have been read from the queue, further error queries
return +0, "No error".
The error queue is cleared when any of the following occur:
• Upon power-on.
• Upon receipt of a *CLS command.
• Upon reading the last item from the queue.
Error Types
Error numbers are categorized by type as shown in Table A-1. Each
error is listed in Table A-2.
Table A-1. Error Types
The first error described in each class (for example, -100, -200, -300,
-400) is a “generic” error.
No Error
The :SYST:ERR? response +0, "No error" indicates that the Receiver
has no errors. The error queue is empty when every error in the queue
has been read (:SYST:ERR? query) or the queue was cleared by power-
on or *CLS.
Syntactic Error
An <error number> in the range [−100 to −199] indicates that an IEEE
488.2 syntax error has been detected by the Receiver’s parser. The
occurrence of any error in this class causes the syntactic error bit (bit 5)
in the Event Status Register to be set. One of the following events has
occurred:
• An IEEE 488.2 syntax error has been detected by the parser.
That is, a controller-to-Receiver message was received that is in
violation of the IEEE 488.2 Standard. Possible violations
include a data element that violates the Receiver listening
formats or whose type is unacceptable to the Receiver.
• An unrecognized header was received. Unrecognized headers
include incorrect Receiver-specific headers and incorrect or
unimplemented IEEE 488.2 Common Commands.
Events that generate syntactic errors do not generate semantic errors,
hardware/firmware errors, or query errors.
Semantic Error
An <error number> in the range [−200 to −299] indicates that an error
Error Messages A-4
Error Messages
Query Error
An <error number> in the range [−400 to −499] indicates that the output
queue control of the Receiver has detected a problem with the message
exchange protocol. The occurrence of any error in this class should
cause the query error bit (bit 2) in the Event Status Register to be set.
One of the following is true:
• An attempt is being made to read data from the output queue
when no output is either present or pending.
• Data in the output queue has been lost.
List of Errors
Table A-2 lists and describes the error messages.
+0 No error The error queue is empty. Every error in the queue has been read (SYSTem:ERRor? query) or the
queue was cleared by power-on or *CLS.
-100 Command error This is the generic syntax error used if the Receiver cannot detect more specific errors.
-101 Invalid character A syntactic element contains a character that is invalid for that type.
-103 Invalid separator The parser was expecting a separator and encountered an illegal character.
-104 Data type error The parser recognized a data element different than one allowed. For example, numeric or string
data was expected, but block data was received.
-108 Parameter not allowed More parameters were received than expected for the header.
-109 Missing parameter Fewer parameters were received than required for the header.
-112 Program mnemonic too long The header or character data element contains more than twelve characters.
-113 Undefined header The header is undefined. For example, the command ":HELLO".
-120 Numeric data error This error, as well as errors -121 through -129, is generated when parsing a data element which
appears to be numeric. This particular error message is used when the Receiver cannot detect a
more specific error.
-121 Invalid character in number An invalid character for the data type being parsed was encountered. For example, a "9" in ocatal
data.
-124 Too many digits The mantissa of a decimal numeric data element contained more than 255 digits excluding leading
zeros.
-128 Numeric data not allowed A legal numeric data element was received, but the Receiver does not accept one in this position for
the header.
-131 Invalid suffix The suffix does not follow the syntax described in IEEE 488.2 or the suffix is inappropriate for the
Receiver.
-134 Suffix too long The suffix contained more than 12 characters.
-138 Suffix not allowed A suffix was encounterd after a numeric element that does not allow a suffix.
-141 Invalid character data The character data element contains an invalid character.
-148 Character data not allowed A legal character data element was encountered where prohibited by the Receiver.
-150 String data error This error can be generated when parsing a string data element. This particular error message is
used if the Receiver cannot detect a more specific error.
-151 Invalid string data A string data element was expected but was invalid for some reason.
-158 String data not allowed A string data element was encountered but was not allowed by the Receiver at this point in parsing.
-170 Expression error This error can be generated when parsing an expression data element. It is used if the Receiver
cannot detect a more specific error.
-178 Expression data not allowed Expression data was encountered but was not allowed by the Receiver at this point in parsing.
-200 Execution error This is the generic syntax error if the Receiver cannot detect more specific errors.
-220 Parameter error Indicates that a program data element error occurred. This error is used when the Receiver cannot
detect more specific errors.
-221 Settings conflict Indicates that a legal program data element was parsed but cound not be executed due to the
current Receiver state.
-222 Data out of range Indicates that a legal program data element was parsed but could not be executed because the
interpreted value is outside the legal range defined by the Receiver.
-223 Too much data Indicates that a legal program data element of block, expression, or string type was received that
contained more data than the Receiver could handle due to memory or related receiver-specific
requirements.
-224 Illegal parameter value Used where exact value, from a list of possible values, was expected (but not received).
-230 Data corrupt or stale No valid data available.
-240 Hardware error Indicates that a legal program command or query could not be executed because of a hardware
problem in the Receiver.
-241 Hardware missing Indicates that a legal program command or query could not be executed because of missing
Receiver hardware.
-300 Device-specific error This is the generic device-dependent error.
-310 System error Indicates that a system error occurred.
-311 Memory error Occurs on EEPROM write failure.
-315 Configuration memory lost Could happen on powerup or preset if a nonvolatile memory problem is detected.
-321 Out of memory Indicates that the Receiver has detected that insufficient memory is available.
-330 Self-test failed Indicates at least one failure occurred when *TST? or :DIAG:TEST? was executed.
-350 Queue overflow An error occurred but was not recorded because the error queue is full.
-360 Communication error This is the generic communication error for devices that cannot detect the more specific errors
described for errors -361 through -363.
-361 Parity error in program Parity bit not correct when data received for example, on a serial port.
message
-362 Framing error in program A stop bit was not detected when data was received. For example, on a serial port (for example, a
message baud rate mismatch).
-363 Input buffer overrun Software or hardware input buffer on serial port overflows with data caused by improper or
nonexistent pacing.
-440 Query UNTERMINATED Indicates that a query was received in the same program message after a query requesting an
after indefinite response indefinite response (e.g., *IDN? or :PTIM:TCOD? or :SYST:STAT?).
Appendix Contents
This appendix provides an overview of the Standard Commands for
Programming Instrument (SCPI) syntax and style to help you program
the Receiver. A section that lists SCPI reference documentation is also
provided.
This appendix is organized as follows:
• Command Types, Formats, and Elements page B-3
– Command Types page B-3
– Command Formats page B-3
– Elements of SCPI Commands page B-4
– Using Multiple Commands page B-8
– Elements of Response Messages page B-9
• Reference Documentation page B-2
: mnemonic sp parameter
? suffix
Abbreviated Commands
The command syntax shows most keywords as a mixture of upper and
lower case letters. Upper case letters indicate the abbreviated spelling
for the command. For better program readability, you may send the
entire keyword. The Receiver accepts either command form and is not
case sensitive.
For example, if the command syntax shows SYNChronization, then
SYNC and SYNCHRONIZATION are both acceptable forms. Other
forms of SYNChronization, such as SYNCHR or SYNCHRONIZ will
generate an error. You may use upper and/or lower case letters.
Therefore, SYNCHRONIZATION, synchronization,
SyNchROnizatioN, and SYnC are all acceptable.
Keyword Separator
A colon (:) always separates one keyword from the next lower-level
keyword as shown below:
:SYST:ERR?
<numeric value> Accepts all commonly used decimal representation of numbers including optional signs,
decimal points, and scientific notation:
123, 123e2, -123, −1.23e2, .123, 1.23e−2, 1.23000E−01.
Special cases include MINimum and MAXimum as follows:
MINimum selects minimum value available.
MAXimum selects maximum value available.
Queries using MINimum or MAXimum return the associated numeric value.
<Boolean> Represents a single binary condition that is either true or false:
1 or ON, 0 or OFF (Query response returns only 1 or 0.)
An <NRf> is rounded to an integer. A non-zero value is interpreted as 1.
<literal> Selects from a finite number of choices. These parameters use mnemonics to represent each
valid setting. An example of a <literal> parameter is: GPS
<NRf> Flexible numeric representation. Only positive integers are used for NRf parameters in the
instrument.
<string> A string parameter is delimited by either single quotes or double quotes. Within the quotes,
any characters in the ASCII B-bit code may be specified.
<non-decimal Format for specifying hexadecimal (#H1F), octal (#Q1077), and binary (#B10101011) numbers
numeric> using ASCII characters. May be used in :STATus subsystem commands.
Parameter Separator
If you send more than one parameter with a single command, you must
separate adjacent parameters with a comma.
Query Parameters
All selectable <numeric value> parameters can be queried to return the
minimum or maximum values they are capable of being set to by
sending a MINimum or MAXimum parameter after the “?.” For
example, consider the :GPS:REF:ADEL? query.
If you send the query without specifying a parameter
(:GPS:REF:ADEL?), the present antenna delay value is returned. If you
send the MIN parameter (using :GPS:REF:ADEL? MIN), the
command returns the minimum value currently available. If you send
the MAX parameter, the command returns the maximum value
currently available. Be sure to place a space between the question mark
and the parameter.
Suffixes
Command Syntax and Style B-6
Command Syntax and Style
Command Types, Format and Elements
Command Terminator
A command may be terminated with a line feed (ASCII LF character 10
decimal), a carriage return (ASCII CR character 13 decimal), or one
followed immediately by the other in any order.
Using Multiple Commands
Program Messages
Program Messages are a combination of one or more properly formatted
SCPI Commands. Program messages always go from the DTE to the
Receiver. They are sent to the Receiver over the Receiver’s serial
interface as a sequence of ASCII characters.
Program Message Syntax
Figure B-3 shows the simplified syntax of a program message. You can
see Common Commands and Subsystem Commands in the same
program message. If you send more than one command in one message,
you must separate adjacent commands with a semicolon.
;
<carriage return>
Subsystem Command
<carriage return> <new line>
Common Command
<new line> <carriage return>
<new line>
NOTE:
<new line> = ASCII character decimal 10
<carriage return> = ASCII character decimal 13
Figure B-3. Simplified Program Message Syntax Diagram
When using IEEE 488.2 Common commands with SCPI Subsystem
commands on the same line, use a semicolon between adjacent
commands. For example:
*CLS;:SYST:ERR?
The “:” must be present to distinguish another root level command. For
example:
:SYNC:HOLD:DUR?;:GPS:SAT:VIS:PRED?
is equivalent to sending:
:SYNC:HOLD:DUR?
:GPS:SAT:VIS:PRED?
If the “:”(which is following the “;” and is in front of GPS) is omitted,
the Receiver assumes that the second command is
:SYNC:HOLD:GPS:SAT:VIS:PRED?
and generates a syntax error.
Elements of Response Messages
Response Messages
Response messages are data sent from the Receiver to the DTE in
response to a query. (A query is a command followed by a question
mark. Queries are used to find out how the Receiver is currently
configured and to transfer data from the Receiver to the DTE.)
After receiving a query, the Receiver interrogates the requested
configuration and issues its response message as soon as possible. The
message is transmitted across the serial interface to the DTE.
Response Formats
Table B-3 contains explanations of response formats.
Table B-3. Response Formats
*Format Description
+
<digit>
−
Format Description
XYZ ASCII-encoded bytes corresponding to the literal used as the command
parameter.
alpha
alpha
digit
The “2” indicates the number of digits that follow and the two digits “08”
indicate the number of data bytes to be transmitted.
<carriage return> is defined as a single ASCII-encoded byte
corresponding to 13 decimal.
<new line> is defined as a single ASCII-encoded byte corresponding to
10 decimal.
Reference Documentation
This section contains a list of documentation related to the use of the
Receiver’s RS-232C serial port. Additional information that you may
find useful can be found in the following publications:
1. Beginner’s Guide to SCPI (Part Number H2325-90001, July
1990 Edition).
2. Beginner’s Guide to SCPI, Barry Eppler (Hewlett-Packard
Press, Addison-Wesley Publishing Co. 1991).
3. Standard Commands for Programmable Instruments (SCPI),
Version 1992.0.
This standard is a guide for the selection of messages to be
included in programmable instrumentation. It is primarily intended
for instrument firmware engineers. However, you may find it
useful if you are programming more than one instrument that
claims conformance to the SCPI standard. You can verify the use
of standard SCPI commands in different instruments.
To obtain a copy of this standard, contact:
SCPI Consortium
8380 Hercules, Suite P3
La Mesa, CA 91942
Phone: (619) 697-8790
FAX: (619) 697-5955
4. The International Institute of Electrical Engineers and
Electronic Engineers, IEEE Standard 488.2-1987, IEEE
Standard Codes, Formats, Protocols, and Common
Commands for Use with ANSI/IEEE Std 488.1-1987
Programmable Instrumentation.
This standard defines the underlying message formats and data
types used in SCPI. It is intended more for firmware engineers
than for instrument users/programmers. However, it can be useful
if you need to know the precise definition of specific message
formats, data type, or common commands.
To obtain a copy of this standard, write to:
b. If you made any changes on this form, select OK, otherwise you
can just Cancel.
• antenna delay
7 Now you need to select the file that you will download. Select the
control labeled File.
This brings up a form for file selection. Download files for the GPS
Receiver have a .s appended to the file name. This form is set to
only find .s type files. In this case, you want to find and select the
filename, for example s_3503.s. Depending on where you have
placed this file, you may have to use this form to navigate for it. If it
is on a different drive, use the Drives selection in the lower right.
Once you’ve located s_3503.s select it (clicking on the name is
probably the easiest) and then select OK. The file, along with its
path should now appear in the “File to Download” portion of the
“Firmware Download” form.
8 You’re now ready to perform the download. Select the control titled
Download and an erase warning will appear. This is just a
double-check to make sure you really want to do this. Assuming
you do, select Yes, Perform the Download.
Command Index-2
Command Index
Command Index-3
Command Index
Command Index-4
Command Index
Command Index-5
Command Index
57, 5-139 G
error behavior, 5-6 GPS engine, 5-89
error log, 4-29, 5-53, 5-54, 5-57, 5- GPS lock, 4-23, 4-25, 5-7, 5-46, 5-
139 47, 5-48
error messages, 4-29, 5-53 GPS Lock indicator, 1-2, 4-27, 5-40
error queue, 4-29, 5-53, 5-57, 5-139, GPS position, 4-23, 5-7, 5-13, 5-15,
5-3 5-17, 5-19
error recovery, serial port, 4-29, 4- GPS satellite acquisition, 4-23, 4-25,
38, 5-53, 5-130 5-7, 5-46, 5-47, 5-48
error types, 5-4 GPS timeline, 5-92
error types, list, 5-4 GUI, 3-3, 3-8, 3-9, 3-10
error, command, 5-65, 5-72 H
error, reading, 5-2 hardware status, 5-70, 5-79, 5-80, 5-
external devices, 1-3 81, 5-82, 5-83, 5-84
F Hardware status, 5-65, 5-70
factory default settings, 2-9, 3-5, 4- hardware/firmware error, 5-5
40, 5-131, 5-132 holdover
factory-default values, 2-9 status, 5-65
failure of merit, 4-27 holdover
failure protection, satellite loss, 4- tutorial, 3-15
27, 5-38, 5-46, 5-47, Holdover indicator, 1-2, 4-27, 5-40
5-48 holdover loss of satellites, 4-27
FDUPlex, 5-125, 5-126 holdover operation, 3-15
FFOM, 4-27, 5-41 holdover process, 5-38
Figure holdover recovery, 4-27, 5-38, 5-50
command list, 4-2 holdover status, 4-30, 5-71
status reporting system, 5-68 How to use the Status Screen, 3-10
figure of merit, 5-41, 5-44, 5-93 HP 24542G cable, 2-8
firmware error, 5-5 HP 24542G interface cable, 2-6
firmware installation, 2-3, 4-42, 5- HP 24542U cable, 2-8
135, 5-137, 5-139, 5- HP 40242M interface cable, 2-6
140, 5-141 58503A indicators
firmware revision code, 2-3, 4-42, Alarm, 1-2
5-136 GPS Lock, 1-2
firmware upgrade, 2-3, 5-137 Holdover, 1-2
FIRS, 5-121 Power, 1-2
flash EEPROM, 5-138 58503A inputs
flow control state, 5-126, 5-127 Power, 1-3
format 58503A interface port
ASCii, 5-115 PORT 1, 1-3
INTeger, 5-115 58503A outputs
FPGA logic, 5-89 10 MHz OUT, 1-3
front panel 1PPS, 1-3
PORT 2, 2-4 Alarm, 1-3
full duplex, 2-9, 5-132 58506A/507A/508A cable, 5-31
59551A indicators
Command Index-6
Command Index
Command Index-7
Command Index
Command Index-8
Command Index
Command Index-9
Command Index
Command Index-10
Command Index
Command Index-11
Command Index
Command Index-12
(PORT 1, 5-122, 5-123, QUERy
5-124, 5-125, 5-126, RESPonse?, 5-130
5-127, 5-128, 5-129 ROSCillator
(PORT 2, 5-122, 5-123, EFControl
5-124, 5-125, 5-126, RELative?, 5-39
5-127, 5-128, 5-129 TEST
* RESult?, 5-91
*CLS, 5-73, 5-137 TEST?, 5-90
*ESE, 5-85 :FORMat
*ESE?, 5-86 DATA, 5-115
*ESR?, 5-86 DATA?, 5-115
*IDN?, 5-136 :GPS
*SRE, 5-76 INITial
*SRE?, 5-76 DATE, 5-9
*STB?, 5-77 POSition, 5-10
*TST?, 5-89 TIME, 5-12
: POSition, 5-13
:CALCulate Subsystem ACTual?, 5-17
CALCulate HOLD
WMARgin LAST?, 5-17
DATA?, 4-25 STATe?, 5-19
:DIAGnostic SURVey
DOWNload, 5-137 PROGress?, 5-19
ERASe, 5-138 STATe, 5-20
ERASe?, 5-139 POWerup, 5-21
LIFetime POWerup?, 5-22
COUNt?, 5-90 STATe?, 5-21
LOG POSition?, 5-15
CLEar, 5-61 REFerence
CLEar <current log size>, ADELay, 5-30
5-62 ADELay?, 5-32
COUNt?, 5-63 VALid?, 5-33
READ SATellite
ALL?, 5-62 TRACking
READ?, 5-63 COUNt?, 5-35
READ? <entry number>, EMANgle, 5-23
5-64 EMANgle?, 5-24
General Index
D result, 5-91
d.dEe, 5-14 diagnostics
d.dEe, ..., 5-14 internal self-test, 5-89
data, 5-114 diagram
data bits, 2-9, 5-124, 5-125, serial interface cable, 2-8
5-132 Diagram:, 5-68
date and time outputs, 4-25, documents
4-32, 5-8 list, 5-18
DB-25 connector, 2-5 related, 5-18
DB-9 connector, 2-5 download, 5-137
dc power, 1-3 downloading
DCE, 2-5 Using SatStat, 5-3
dd, 5-13 downloading new firmware,
dd, ..., 5-13 5-3
decimal point, 5-8, 5-14 DTE, 2-5
default values, 3-5 duplex state, 5-125, 5-126
defaults, factory, 3-5 E
defaults, factory settings, echoing of the characters
2-9, 4-40, 5-131, 5-132 you type, 5-125, 5-126,
DEG, 5-9 5-132
delay values EEPROM, 5-89, 5-138
antenna cables, 5-30 EPROM, 5-89
delay values, antenna erasing
cables, 4-25, 5-8, 5-30 EEPROM, 5-139
description error
response formats (ASCII), hardware/firmware error,
5-6 5-5
serial interface ports, 2-3 query, 5-6
status registers, 5-65 semantic, 5-5
status reporting system, syntactic, 5-4
5-65 error analysis, 4-29, 5-53,
status/alarm reporting 5-54, 5-57, 5-139
system, 5-65 error behavior, 5-6
description format, 5-5 error log, 4-29, 5-53, 5-54,
diagnostic log, 4-29, 5-53, 5-57, 5-139
5-59, 5-60, 5-61, 5-63, error messages, 4-29, 5-53
5-64 error queue, 4-29, 5-53,
diagnostic Log messages, 5-57, 5-139, 5-3
5-59 error recovery, serial port,
diagnostic test, 5-90 4-29, 4-38, 5-53, 5-130
diagnostic tests, 4-30, 5-54, error types, 5-4
5-89, 5-90, 5-91 error types, list, 5-4
General Index-6
General Index