The programming commands are identical, regardless of the type of remote control interface
that is used.
The ANT-20 must be switched to remote control mode manually. In remote control mode,
manual control of the ANT-20 is not possible.
To set the ANT-20 to remote control mode, follow these steps:
ANT-20, ANT-20E with
Windows 3.11:⇒ Double-click on the “Remote” icon in the “ANT-20” group in the
“Program Manager” window.
Windows95:1. Enable remote control mode using the taskbar:
“Start/ANT-20/Remote On”.
2. Double-click on the “ANT-20” icon on the desktop
– or –
use the taskbar: “Start/ANT-20/ANT-20”.
To switch back to normal manual control, follow these steps:
ANT-20, ANT-20E with
Windows 3.11:⇒ Double-click on the “Remote Disable” icon in the “ANT-20”
group in the “Program Manager” window.
Windows95:1. Disable remote control mode using the taskbar:
“Start/ANT-20/Remote Off”.
2. Double-click on the “ANT-20” icon on the desktop
– or –
use the taskbar: “Start/ANT-20/ANT-20”.
IntroductionI-1
Page 10
1 ANT-20, ANT-20E, ANT-20SEJitter STM-16 Module
From the viewpoint of remote control, each measuring module in the ANT-20 is a fully remotecontrollable instrument with its own SCPI command tree, status reporting system and common
command set.
The measuring module to be controlled is selected using the command
MODule:SELect <module_name> (see Sec. 1.1.2).
The instrument’s display shows which measuring modules exist and which one is selected for
remote control.
A built-in monitor function can be switched on for debugging purposes (see Sec. 1.1.3).
To change the type of the remote control interface and/or its accompanying configuration
parameters, the batch file remote.bat must be edited.
ANT-20, ANT-20E with
Windows 3.11:1. Double-click on the “Remote Configuration” icon in the
“ANT-20” group in the “Program Manager” window to edit the
remote.bat file.
2. Follow the on-screen instructions.
Windows95:1. Click on the “Remote Configuration” icon via taskbar: “Start/
ANT-20/Remote Configuration” to edit the remote.bat file.
2. Follow the on-screen instructions.
1.1.2Module selection
The remote control interface of the ANT-20 supports multiple internal mea suring modules. The
module selection provides a mechanism to select one of these measuring modules for remote
control.
This command selects the measuring module specified by <module_na me> for remote contro l
and deselects all others. All subsequent commands (including commands in subsequent
program messages) are passed to the selected measuring module. All other measuring
modules are unavailable for programming until selected.
<module_name>:
BASIC:Selects BASIC Module
JITTER:Selects JITTER Module for bit rates up to STM4/OC12 (extension slot)
JITT16:Selects JITTER Module for bit rates of STM16/OC48 (extension slot)
1
[no query]
Note: • This command has no query form.
• After power-on, the BASIC measuring module is selected.
• If the MODule:SELect <module_name> command is required in a program
message, it must be the first (or the only) command in that program message.
I-2Introduction
Page 11
Jitter STM-16 Module1 ANT-20, ANT-20E, ANT-20SE
1.1.3Monitor mode
A monitor function can be switched on or off in remote control mode. If it is switched on, the
instrument displays all messages sent to and from the instrument, corresponding to each
operating step performed.
1.1.4LabWindows/CVI driver
A LabWindows/CVI instrument driver is available for each measuring module.
Instrument drivers reduce application program development time and simplify instrument
control by eliminating the need to learn the complex programming commands fo r each
measuring module.
1.2GPIB Remote Control interface
This section describes the GPIB Remote Control interface for applications using the ANT- 20 as
a remote controlled instrument.
Other applications using the ANT-20 as a GPIB controller for controlling external instruments
are also possible (e.g. running the WG CA TS Test Executive BN 3045 on the ANT-20 to control
the ANT-20 measurement hardware plus external instruments).
To allow both these mutually exclusive operating modes to b e used, the GPIB Remote Cont rol
interface and installation comprises all the software required for both operating modes.
1.2.1Items included
The Remote Control GPIB (PCMCIA) Option BN 3035/92.10 comprises:
ANT-20, ANT-20E with
Windows 3.11:• PCMCIA GPIB card including PCMCIA to GPIB cable
Windows95:• PCMCIA GPIB card including PCMCIA to GPIB cable
(2 meters)
• CardWare User’s Manual (Award Software Inc.)
• Distribution disk: CardWare Version 2.0 (Award Software Inc.)
• Installation disks: ANT-20 PCMCIA System (configured
CardWare 2.0),
ANT-20 GPIB Remote Control (includes NI-488.2)
• ANT-20 GPIB (NI-488.2) for Windows 3.x
• Operating Manual: Remote Control
• Brochure “SCPI and IEEE 488, Programmer‘s Introduction”
(2 meters)
• Installation disks: ANT-20 GPIB Remote Control for Windows95
(includes NI-488.2M)
• Operating Manual: Remote Control
• Brochure “SCPI and IEEE 488, Programmer‘s Introduction”
IntroductionI-3
Page 12
1 ANT-20, ANT-20E, ANT-20SEJitter STM-16 Module
1.2.2Installation
1.2.2.1Overview
The PCMCIA GPIB interface from National Instruments Corp. (NI) is used with the NI-488.2/
NI-488.2M software for GPIB Remote Control.
For ANT-20 with Windows 3.11 only:
• The NI-488.2 software requires standardized PCMCIA system software with Socket and
Card Services (version 2.0 or higher) to be installed.
• A software called CardWare (written by Award Software Inc.) is used as PCMCIA system
software. It can also be used with a wide variety of other PCMCIA cards.
• The CardWare software contained on the installation disk is already configured for use with
the ANT-20.
1.2.2.2Software installation
Software installation under Windows 3.11
If you ordered the Remote Control GPIB Option BN 3035/92.10 together with your ANT-20, the
required software packages are already installed on the ANT-20 and the icons “Remote”,
“Remote Disable” and “Remote Configuration” are shown in the “ANT-20” group in th e “Program
Manager” window.
Note: A release code is required to enable the Remote Control GPIB Option.
For detailed information contact your nearest Wavetek Wandel Goltermann Service
Center. The addresses are listed at the end of this manual.
When contacting the Service Center, always quote:
• The serial number of the ANT-20
• The version number of the ANT-20 software package
If you ordered the Remote Control GPIB Option BN 3035/92.10 separately, install the software
packages as follows:
Installing the PCMCIA System software
1. Start or return to Windows.
2. Insert the ANT-20 PCMCIA System installation disk into drive A:.
3. Choose “Run ...” from the “File” menu in the “Program Manager” wind ow and
type the following command into the dialog box:
A:\setup
Confirm with “OK”.
4. After complete installation exit Windows, remove the installation disk from drive A:, and
reboot the ANT-20.
Installing the GPIB Remote Control software
1. Start or return to Windows.
2. Insert the ANT-20 GPIB Remote Control installation disk into drive A:.
I-4Introduction
Page 13
Jitter STM-16 Module1 ANT-20, ANT-20E, ANT-20SE
3. Choose “Run ...” from the “File” menu in the “Program Manager” window and
type the following command into the dialog box:
A:\setup
Confirm with “OK”.
4. After complete installation exit Windows, remove the installation disk from drive A:, and
reboot the ANT-20.
Installing the ANT-20 Remote Control software
1. Start or return to Windows
2. Choose “Run...” from the “File” menu in the “Program Manager” window and
type the following command into the dialog box:
C:\ANT20.SUP\DISK1\setup.exe
Confirm with “OK”.
3. Follow the on-screen instructions to install the ANT-20 Remote Control.
4. After complete installation exit Windows, and reboot the ANT-20.
After this installation procedure, the ANT-20 can be set to remote control mode by doubleclicking on the “Remote” icon in the “ANT-20” group in the “Program Manager” window.
Installing the GPIB (NI-488.2) for Windows 3.x
This software is required for applications that use the ANT-20 as a GPIB controller for
controlling external instruments (e.g. for running the WG CATS Test Executive BN 3045 on the
ANT-20 to control the ANT-20 measurement hardware plus external instruments).
1. Start or return to Windows.
2. Insert the installation disk ANT-20 GPIB (NI-488.2) for Windows 3.x into drive A:.
3. Choose “Run...” from the “File” menu in the “Program Manager” window and type the
following command into the dialog box:
A:\setup
Confirm with “OK”.
4. Follow the on-screen instructions to complete the installation.
5. After complete installation exit Windows, remove the installation disk from drive A:, and
reboot the ANT-20.
After this installation procedure, you can access the “NI-488.2 PCMCIA GPIB So ftware” g ro up
in the “Program Manager” window.
To view or modify the NI-488.2 software configuration, double-click the “GPIB” icon from the
“Control Panel” in the “Main” group of the “Program Manager” window.
Software installation under Windows95
If you ordered the Remote Control GPIB Option BN 3035/92.10 together with your ANT-20, the
required software packages are already installed on the ANT-20 and the icons “Remote On”,
“Remote Off” and “Remote Configuration” ar e shown in the Windows95 file folder “ANT-20”.
Note: A release code is required to enable the Remote Control GPIB Option.
For detailed information contact your nearest Wavetek Wandel Goltermann Service
Center. The addresses are listed at the end of this manual.
When contacting the Service Center, always qu o te :
• The serial number of the ANT-20
• The version number of the ANT-20 software package
Verify the PCMCIA GPIB card installation as described in the section “Verify the PCMCIA GPIB
card installation” below.
IntroductionI-5
Page 14
1 ANT-20, ANT-20E, ANT-20SEJitter STM-16 Module
If you ordered the Remote Control GPIB Option BN 3035/92.10 separately, install the software
packages as follows:
Installing the GPIB Remote Control software
1. Start or return to Windows95.
2. Insert the ANT-20 GPIB Remote Control for Windows95 installation disk 1 into drive A:.
3. Click the Windows95 “Start” button, choose “Run ...” and
type the following command into the dialog box:
A:\setup
Confirm with “OK”.
4. Follow the on-screen instructions during the installation procedure and enter
C:\Tmp\Gpib
as GPIB distribution directory.
5. After completion, click the Windows95 “Start” button, choose “Run...” and
type the following command into the dialog box:
C:\Tmp\Gpib\gpib9513.exe
Confirm with “OK”.
6. Follow the on-screen instructions during the setup procedure and use the default selection
for components to install (all components selected).
7. After complete installation:
– Shut down the ANT-20.
– Remove the installation disk from drive A:.
– Insert the PCMCIA GPIB card into a free PCMCIA slot.
– Reboot the ANT-20.
Enable support for DOS applications as described below (by default, DOS sup port is disabled):
1. Return to Windows95, click the Windows95
“Start” button, choose “Settings” and then
choose “Control Panel” from the submenu.
In the “Control Panel” window, double-click the “System” icon.
2. In the “Device Manager” tab of the “System Properties” window,
choose “View devices by type”,
click on the “National Instruments GPIB Interfaces” icon in the list and then
click on the “Properties” button.
3. In the “General” tab in the “National Instruments GPIB Interfaces Pr opertie s” window se lect
the checkbox “Enable Support for DOS GPIB Applications” and confirm with “OK”.
4. Reboot the ANT-20.
Verify the PCMCIA GPIB card installation
1. The PCMCIA GPIB card must be in the slot!
2. Click the Windows95 “Start” button, choose “Settings” and then
choose “Control Panel” from the submenu.
In the “Control Panel” window, double-click the “System” icon.
3. In the “Device Manager” tab of the “System Properties” window,
choose “View devices by type”,
double-click the “National Instruments GPIB Interfaces” icon in the list and then
double-click “PCMCIA GPIB” in the sublist.
4. In the “GPIB Settings” tab of the “PCMCIA GPIB Properties” window, the entry for
“Interface Name” must be “GPIB0”. If it is not, change it to “GPIB0”.
5. Deactivate the “System Controller” checkbox.
(All other parameters are properly set by starting the ANT-20 remote control mode after
completion of the installation procedure.)
6. Confirm with “OK”.
I-6Introduction
Page 15
Jitter STM-16 Module1 ANT-20, ANT-20E, ANT-20SE
Installing the ANT-20 Remote Control software
1. Start or return to Windows95.
2. Click the Windows95 “Start” button,
choose “Run...” and type the following command into the dialog box:
C:\ANT20.SUP\DISK1\setup.exe
Confirm with “OK”.
3. Follow the on-screen instructions to install the ANT-20 Remote Control and select only the
“Remote Control Software” as component to install.
The following patch installation described in steps 4, 5 and 6 is only required for ANT-20
software versions less or equal 7.0. It has no effect on versions greater than 7.0.
4. Insert the ANT-20 GPIB Remote Control for Windows95 installation disk 3 into drive A:.
5. Click on the Windows95 “Start” button, choose “Run...” and
type the following command into the dialog box:
A:\setup
Confirm with “OK”.
6. Follow the on-screen instructions.
After completion, remove the installation disk from drive A:.
Note: Only for ANT-20 software versions less or equal 7.0:
If there is any need to execute C:\ANT20.SUP\DISK1\setup.exe (with the component
“Remote Control Software” selected) at a later time again, the above described patch
installation (steps 4, 5 and 6) must also be executed again.
7. Exit Windows95 and reboot the AN T- 20 .
After this installation procedure, you can enable the remote control mode by using the taskbar:
1. “Start/ANT-20/Remote On”.
2. Then double-click on the “ANT-20” icon on the desktop or
use the taskbar: “Start/ANT-20/ANT-20”.
1.2.2.3Hardware installation
1. Insert the PCMCIA GPIB card into a free PCMCIA socket the same way you insert a disk into
a floppy drive.
The PCMCIA GPIB has no jumpers or switches to set, and you do not need to power down
the ANT-20 when you insert or remove the card.
2. Connect the PCMCIA GPIB cable to the PCMCIA GPIB card.
IntroductionI-7
Page 16
1 ANT-20, ANT-20E, ANT-20SEJitter STM-16 Module
1.2.3Connecting to GPIB
The GPIB Remote Control interface is equipped with a standar d 24-way con nector con forming
to IEEE 488.1.
GPIB cables of various lengths are available for connecting the ANT-20 to other instr uments
and to the bus controller:
• 1.2 m long: Part number K 420
• 2.0 m long: Part number K 421
Note: • The total length of GPIB cable must not exceed 2 meters x the number of
instruments in the interface system.
• Up to 15 instruments can be connected to the interface system. The maximum cable
run used to connect a group of instruments is 20 meters. For more info rmation re fer
to the IEEE 488.1 standard.
• Longer distances can be bridged using interface couplers (2-wire or 4-wire
connections, if necessary with suitable modems).
1.2.4Device address
Each instrument in the interface system must have a unique address to allow the controller to
access each one individually.
The ANT-20 address can be changed by editing the remote.bat batch file.
Any address in the range 0 to 30 can be selected.
ANT-20, ANT-20E with
Windows 3.11:1. Double-click on the “Remote Configuration” icon in the
“ANT-20” group in the “Program Manager” window to edit the
remote.bat file.
2. Follow the on-screen instructions.
Windows95:1. Click on the “Remote Configuration” icon via taskbar: “Start/
ANT-20/Remote Configuration” to edit the remote.bat file.
2. Follow the on-screen instructions.
Note: Make sure that a given address is used only once within the interface system. The
controller address is reserved for the controller.
AH1Acceptor HandshakeComplete capability
T8TalkerNo Talk Only capability
No Serial Poll capability
L4ListenerNo Listen Only capability
SR0Service RequestNo capability
RL0Remote/LocalNo capability
PP0Parallel PollNo capability
DC1Device ClearComplete capability
DT0Device TriggerNo capability
C0ControllerNo capability
Table I-2Interface functions conforming to the IEEE 488.1 standard
1.2.5.2Device Clear
When the IEEE 488 interface message Device Clear ( DCL) o r Selected Device Clea r (SDC) is
sent to the ANT-20, a device clear message is routed to all internal measuring modules,
regardless of whether they are selected or deselected.
The device clear message initializes remote control of the instrument and ensures that a
subsequently sent program message will be accepted and processed.
No instrument initialization is performed by DCL or SDC. To initialize the instrument, select
every measuring module and send the reset command
*RST (MODule:SELect <module_name>; *RST).
1.3V.24/V.28 (RS 232) Remote Control interface
1.3.1Items included
The Remote Control V.24/RS 232 Option BN 3035/91.01 consists of
• Remote Control Operating Manual
• Brochure “SCPI and IEEE 488, Programmer’s Introduction”
1.3.2Installation
The built-in serial port (COM1) of the embedded PC-AT is used for remote control via RS 232.
IntroductionI-9
Page 18
1 ANT-20, ANT-20E, ANT-20SEJitter STM-16 Module
1.3.2.1Software installation
Software installation under Windows 3.11
If you ordered the Remote Control V.24/V.28 ( RS 232) Option BN 3035/91.01 together with your
ANT-20, the required software package is already installed on the ANT-20 and the icons
“Remote”, “Remote Disable” and “Remote Configuration” are shown in the “ANT-20” group in
the “Program Manager” window.
Note: A release code is required to enable the Rem ote Control V.24/V.28 (RS 23 2) Option.
For detailed information contact your nearest Wavetek Wandel Goltermann Se rvice
Center. The addresses are listed at the end of this manual.
When contacting the Service Center, always quote:
• The serial number of the ANT-20
• The version number of the ANT-20 software package
If you ordered the Remote Control V.24/V.28 ( RS 232) Option BN 3035/91.01 separately, install
the software package as follows:
Installing the ANT-20 Remote Control software
1. Start or return to Windows
2. Choose “Run...” from the “File” menu in the “Program Manager” window and
type the following command into the dialog box:
C:\ANT20.SUP\DISK1\setup.exe
Confirm with “OK”.
3. Follow the on-screen instructions to install the ANT-20 Remote Control.
4. After complete installation exit Windows, and reboot the ANT-20.
After this installation procedure, the ANT-20 can be set to remote control mode by doubleclicking on the “Remote” icon in the “ANT-20” group in the “Program Manager” window.
Software installation under Windows95
If you ordered the Remote Control V.24/V.28 ( RS 232) Option BN 3035/91.01 together with your
ANT-20, the required software package is already installed on the ANT-20 and the icons
“Remote On”, “Remote Off” and “Remote Configuration” ar e shown in the Windows95 file folder
“ANT-20”.
Note: A release code is required to enable the Rem ote Control V.24/V.28 (RS 23 2) Option.
For detailed information contact your nearest Wavetek Wandel Goltermann Se rvice
Center. The addresses are listed at the end of this manual.
When contacting the Service Center, always quote:
• The serial number of the ANT-20
• The version number of the ANT-20 software package
I-10Introduction
Page 19
Jitter STM-16 Module1 ANT-20, ANT-20E, ANT-20SE
If you ordered the Remote Control V.24/V.28 (RS 232) Option BN 3035/91.01 separately, install
the software package as follows:
Installing the ANT-20 Remote Control software
1. Start or return to Windows95.
2. Click the Windows95 “Start” button,
choose “Run...” and type the following command into the dialog box:
C:\ANT20.SUP\DISK1\setup.exe
Confirm with “OK”.
3. Follow the on-screen instructions to install the ANT-20 Remote Control.
4. After complete installation exit Windows95, and reboot the ANT-20.
After this installation procedure, you can enable the remote control mode by using the taskbar:
1. “Start/ANT-20/Remote On”.
2. Then double-click on the “ANT-20” icon on the desktop or
use the taskbar: “Start/ANT-20/ANT-20”.
1.3.3Connecting to V.24/V.28 (RS 232)
The interface connector (serial port COM1) is a 9-way SUB-D male connector.
PinITU-T
V.24
3103D1BATXDTransmitted dataO
2104D2BBRXDReceived dataI
7105S2CARTSRequest to sendO
8106M2CBCTSReady for sending/Clear to sendI
6107M1CCDSRData set readyI
5102E2ABSGNDSignal ground or common return1109M5CFDCDData channel received line signal
The connection of an ANT-20 to a PC is shown below. Both the ANT-20 and the PC function as
Data Terminal Equipment (DTE):
Fig. I-19-way connection
Fig. I-225-way connection
An appropriate cable with both 9-way and 25-way SUB-D female connectors on each end is
available:
Part number K 764 (3.0 m long)
I-12Introduction
Page 21
Jitter STM-16 Module1 ANT-20, ANT-20E, ANT-20SE
1.3.4Transmission parameters
The baud rate can be changed by editing the remote.bat batch file.
ANT-20, ANT-20E with
Windows 3.11:1. Double-click on the “Remote Configuration” icon in the
“ANT-20” group in the “Program Manager” window to edit the
remote.bat file.
2. Follow the on-screen instructions.
Windows95:1. Click on the “Remote Configuration” icon via taskbar: “Start/
ANT-20/Remote Configuration” to edit the remote.bat file.
2. Follow the on-screen instructions.
The following baud rates can be selected:
• 1200 bit/s
• 2400 bit/s
• 4800 bit/s
• 9600 bit/s
• 19200 bit/s
• 38400 bit/s
• 57600 bit/s
The interface operates in full-duplex (FDX) mode.
The other transmission parameters are fixed and cannot be changed:
ParameterSetting
ParityNone
Number of stop bits per character1
Number of data bits per character8
Flow controlHardware handshake by control lines RTS/CTS
There is no functional equivalence to the GPIB interface functions Service Request and Serial
Poll.
However, the GPIB interface function Device Clear is simulated by a BREAK signal
(see Sec. 1.3.5.2,Page I-14).
1.3.5.2Device Clear
When the BREAK signal is sent to the ANT-20, a device clear message is routed to all internal
measuring modules, regardless of whether they are selected or desel ected.
BREAK is detected when the RXD input is at positive voltage (i.e. logical 0 or SPACE) for the
entire character frame including the stop bit.
The device clear message initializes remote control of the instrument and ensures that a
subsequently sent program message will be accepted and processed.
No instrument initialization is performed by the device clear message.
To initialize the instrument, select every measuring module and send the reset command *RST
(MODule:SELect <module_name>; *RST).
I-14Introduction
Page 23
Jitter STM-16 Module2 DominoCOM ANT-20
2DominoCOM ANT-20
2.1General information
2.1.1Items included
The delivery includes the following items relating to remote control:
• PCMCIA GPIB card including PCMCIA to GPIB cable (2 meters)
• Configuration disk: DominoCOM ANT-20 Remote Control
• Remote Control Operating Manual
• Brochure “SCPI and IEEE 488, Programmer‘s Introduction”
For DominoCOM ANT-20 with Windows 3.11 only:
• CardWare User´s Manual (Award Software Inc.)
• Distribution disk: CardWare Version 2.0 (Award Software Inc.)
2.1.2Overview
The DominoCOM ANT-20 can be remotely controlled using the
• IEEE 488 (IEC 625) interface, often referred to as GPIB
– or –
• V.24/V.28 (RS 232) interface
The programming commands are identical, regardless of the type of remote control interface
that is used.
From the viewpoint of remote control, each measuring module in the DominoCOM ANT-20 is a
fully remote-controllable instrument with its own SCPI command tree, status reporting system
and common command set.
The measuring module to be controlled is selected using the command
MODule:SELect <module_name> (see Sec. 2.1.5,Page I-17).
Refer to Sec. 2.1.3,Page I-15, for changing the type of remote control interface and/or its
accompanying configuration parameters.
DominoCOM ANT-20 can operate in the ANT-20 mode with the use of an external monitor,
keyboard and mouse. Refer to Sec. 2.1.4,Page I-16, for detailed information.
2.1.3Changing the configuration
To change the type of remote control interface and/or its accompanying configuration
parameters, follow these steps
1. Edit the remote.bat batch file (on the configuration disk) by using an external PC.
Refer to the readme.txt file (on the configuration disk) for detailed editing information.
2. Insert the configuration disk into drive A: of the DominoCOM ANT-20 and reboot the
DominoCOM ANT-20 (switch power off, then power on ).
IntroductionI-15
Page 24
2 DominoCOM ANT-20Jitter STM-16 Module
2.1.4ANT-20 mode
By connecting an external monitor, keyboard and mouse to the embedded PC-AT, the
DominoCOM ANT-20 can be operated in the same way as an ANT-20.
The display shows which measuring modules exist and which one is selected for remote
control.
A monitor function can be switched on for debugging purposes during remote control mode that
displays all messages sent to and from the DominoCOM ANT-20, corresponding to each
operating step performed.
Edit the remote.bat batch file (for changing the type of the remote control interface and/or its
accompanying configuration parameters) as follows:
DominoCOM ANT-20 with
Windows 3.11:1. Double-click on the “Remote Configuration” icon in the “ANT-20”
group in the “Program Manager” window.
2. Follow the on-screen instructions.
Windows95:1. Click on the “Remote Configuration” icon via taskbar: “Start/
ANT-20/Remote Configuration”.
2. Follow the on-screen instructions.
To leave remote control mode and enter normal manual control, follow these steps
DominoCOM ANT-20 with
Windows 3.11:⇒ Double-click on the “Remote Disable” icon in the “ANT-20”
group in the “Program Manager” window.
Windows95:1. Disable remote mode using the taskbar: “Start/ANT-20/Remote
Off”.
2. Then double-click on the “ANT-20” icon on the desktop or
use the taskbar: “Start/ANT-20/ANT-20”.
To switch back to remote control mode, follow these steps
DominoCOM ANT-20 with
Windows 3.11:⇒ Double-click on the “Remote” icon in the “ANT-20” group in the
“Program Manager” window.
Windows95:1. Enable remote mode using the taskbar: “Start/ANT-20/Remote
On”.
2. Then double-click on the “ANT-20” icon on the desktop or
use the taskbar: “Start/ANT-20/ANT-20”.
I-16Introduction
Page 25
Jitter STM-16 Module2 DominoCOM ANT-20
2.1.5Module selection
The remote control interface of the DominoCOM ANT-20 supports multiple internal measuring
modules. The module selection provides a mechanism to select one of these measuring
modules for remote control.
This command selects the measuring module specified by <module_name> for remo te co ntrol
and deselects all others. All subsequent commands (including commands in subsequent
program messages) are passed to the selected measuring module. All other measuring
modules are unavailable for programming until selected.
<module_name>:
BASIC:Selects BASIC Module
JITTER:Selects JITTER Module for bit rates up to STM4/OC12 (extension slot)
JITT16:Selects JITTER Module for bit rates of STM16/OC48 (extension slot)
Note: • This command has no query form.
• After power-on, the BASIC measuring module is selected.
• If MODule:SELect <module_name> command is required in a progra m messag e, it
must be the first (or the only) command in that program message.
2.1.6LabWindows/CVI driver
1
[no query]
A LabWindows/CVI instrument driver is available for each measuring module.
Instrument drivers reduce application program development time and simplify instrument
control by eliminating the need to learn the complex programming commands fo r each
measuring module.
2.2GPIB Remote Control interface
This section describes the GPIB Remote Control interface for applications using the
DominoCOM ANT-20 as a remote controlled instrument.
Applications using the DominoCOM ANT-20 as a GPIB Controller for controlling external
instruments are also possible (e.g. running the WG CATS Test Executive BN 3045 on the
DominoCOM ANT-20 to control the DominoCOM ANT-20 measurement hardware plus external
instruments).
To allow both these mutually exclusive operating modes to b e used, the GPIB Remote Cont rol
interface and installation comprises all the software required for both operating modes.
IntroductionI-17
Page 26
2 DominoCOM ANT-20Jitter STM-16 Module
2.2.1Installation
2.2.1.1Overview
The PCMCIA GPIB interface from National Instruments Corp. (NI) is used with the NI-488.2/
NI-488.2M software for GPIB Remote Control. This software is already installed on the
DominoCOM ANT-20.
For DominoCOM ANT-20 with Windows 3.11 only:
• The NI-488.2 software requires standardized PCMCIA system software with Socket and
Card Services (version 2.0 or higher) to be installed.
• A software called CardWare (written by Award Software Inc.) is used as PCMCIA system
software. It can also be used with a wide variety of other PCMCIA cards.
• The CardWare software is already installed on the DominoCOM ANT-20 and suitably
configured.
2.2.1.2Configuration for GPIB
Set the configuration parameters:
• Interface type GPIB
• Device address
by editing the remote.bat batch file.
Refer to Sec. 2.1.3,Page I-15, for detailed information.
Each instrument in the interface system must have an unique addre ss to allow the controller to
access each one individually.
Any address in the range 0 to 30 can be selected.
Note: Make sure that a given address is used only once within the interface system. The
controller address is reserved for the controller.
2.2.1.3Hardware installation
1. Insert the PCMCIA GPIB card into a free PCMCIA socket the same way you insert a disk into
a floppy drive.
The PCMCIA GPIB has no jumpers or switches to set, and you do not need to power do wn
the DominoCOM ANT-20 when you insert or remove the card.
2. Connect the PCMCIA GPIB cable to the PCMCIA GPIB card.
I-18Introduction
Page 27
Jitter STM-16 Module2 DominoCOM ANT-20
2.2.2Connecting to GPIB
The GPIB Remote Control interface is equipped with a stand ard 24- way connector conforming
to IEEE 488.1.
GPIB cables of various lengths are available for connecting the DominoCOM ANT-20 to other
instruments and to the bus controller:
• 1.2 m long: Part number K 420
• 2.0 m long: Part number K 421
Note: • The total length of GPIB cable must not exceed 2 meters x the number of
instruments in the interface system.
• Up to 15 instruments can be connected to the interface system. The m aximum cable
run used to connect a group of instruments is 20 meters. For more informatio n re fer
to the IEEE 488.1 standard.
• Longer distances can be bridged using interface couplers (2-wire or 4-wire
connections, if necessary with suitable modems).
Table I-6Interface functions conforming to the IEEE 488.1 standard
No Serial Poll capability
IntroductionI-19
Page 28
2 DominoCOM ANT-20Jitter STM-16 Module
2.2.3.2Device Clear
When the IEEE 488 interface message Device Clear ( DCL ) or Sele cted Device Clear (SDC) is
sent to the DominoCOM ANT-20, a device clear message is routed to all internal measuring
modules, regardless of whether they are selected or deselected.
The device clear message initializes remote control of the instrument and ensures that a
subsequently sent program message will be accepted and processed.
No instrument initialization is performed by DCL or SDC.
To initialize the instrument, select every measuring module and send the reset command
*RST (MODule:SELect <module_name>; *RST).
I-20Introduction
Page 29
Jitter STM-16 Module2 DominoCOM ANT-20
2.3V.24/V.28 (RS 232) Remote Control interface
2.3.1Installation
2.3.1.1Overview
The built-in serial port (COM1) of the embedded PC-AT is used for remote control via RS 232.
2.3.1.2Configuration for V.24/V.28 (RS 232)
Set the configuration parameters:
• Interface type V.24/V.28 (RS 232)
• Baud rate
by editing the remote.bat batch file.
Refer to Sec. 2.1.3,Page I-15.
The following baud rates can be selected:
• 1200 bit/s
• 2400 bit/s
• 4800 bit/s
• 9600 bit/s
• 19200 bit/s
• 38400 bit/s
• 57600 bit/s
The interface operates in full-duplex (FDX) mode.
The other transmission parameters are fixed and cannot be changed:
ParameterSetting
ParityNone
Number of stop bits per character1
Number of data bits per character8
Flow controlHardware handshake by control lines RTS/CTS
The interface connector (serial port COM1) is a 9-way SUB-D male connector.
PinITU-T
V.24
3103D1BATXDTransmitted dataO
2104D2BBRXDReceived dataI
7105S2CARTSRequest to sendO
8106M2CBCTSReady for sending/Clear to sendI
6107M1CCDSRData set readyI
5102E2ABSGNDSignal ground or common return1109M5CFDCDData channel received line signal
The connection of a DominoCOM ANT-20 to a PC is shown below.
Both the DominoCOM ANT-20 and the PC function as Data Terminal Equipment (DTE):
Fig. I-39-way connection
Fig. I-425-way connection
An appropriate cable with both 9-way and 25-way SUB-D female connectors on each end is
available:
Part number K 764 (3.0 m long)
IntroductionI-23
Page 32
2 DominoCOM ANT-20Jitter STM-16 Module
2.3.3Interface functions
2.3.3.1Overview
There is no functional equivalence to the GPIB interface functions Service Request and Serial
Poll.
However, the GPIB interface function Device Clear is simulated by a BREAK signal
(see Sec. 2.3.3.2).
2.3.3.2Device Clear
When the BREAK signal is sent to the DominoCOM ANT-20, a device clear message is routed
to all internal measuring modules, regardless of whether they are selected or deselected.
BREAK is detected when the RXD input is at positive voltage (i.e. logical 0 or SPACE) for the
entire character frame including the stop bit.
The device clear message initializes remote control of the instrument and ensures that a
subsequently sent program message will be accepted and processed.
No instrument initialization is performed by the device clear message.
To initialize the instrument, select every measuring module and send the reset command
*RST (MODule:SELect <module_name>; *RST).
I-24Introduction
Page 33
Jitter STM-16 Module3 TX/RX SCPI block diagram
3TX/RX SCPI block diagram
Jitter STM16 Module
External modulation
[50]
[51]
Demodulator
output
Wander
[54]
clock reference
Basic Module,
TX
:SOURce
:SENSe:INPut
Jitter clock output
Receiver[52][42]
input
[53]
STM16 hardware
[45]
:SOURce
RX
Fig. I-5TX/RX SCPI block diagram
IntroductionI-25
Page 34
4 Operating informationJitter STM-16 Module
4Operating information
This chapter gives the programmer some basic information which should make it easier to
program this device.
• Program messages are executed in the order they are received from the controller.
However, the execution of any command does not start b efore the PMT (Progra m Message
Terminator <NL>) or any other sequential command is received. This gives full flexibility in
controlling the device without the need to worry about the dependencies between individual
commands, because the settings of coupled commands received within a single message
are checked after the whole message is received.
• Commands are treated as “overlapped commands” except where otherwise noted.
Overlapped commands allow the next command to be executed before the preceding
command has finished execution. This gives better performance and makes it possible to
change some settings while a measurement is running, for example. You can use the
common command *WAI to force sequential operation whenever you need to.
• Any error detected within a program message is written into the error queue. You can read
entries out of the error queue using the SYST:ERR? command. Any program message is
read from the input buffer and parsed as far as possible to detect potential errors.
Nevertheless, the device setting may be undefined after any error.
• Queries are not allowed to have side effects. Thus, queries of commands set in the same
program message will return the old command setting.
• Note that using the SCPI short form of the commands (capital letters) will reduce operational
overhead and can increase your system performance.
• The input buffer size is 4096 bytes (4 kB).
• The output buffer size is 8192 bytes (8 kB). Requesting a response with more than
8192 bytes would cause a query error.
I-26Introduction
Page 35
Jitter STM-16 Module5 Command hierarchy
5Command hierarchy
5.1Introduction
This section is intended to give programmers an overview of the hierarchical relationships
between the commands.
Each command is independent. However, since the parameters are related, each par ameter
has a priority between 1 and 4, with 1 being the highest and 4 the lowest.
If a higher-priority parameter is modified, lower-priority param eters may be automatically
modified as well. This automatic mechanism assures logically consistent instrument settings
that comply with standards, thereby avoiding error messages. It also simplifies programming
since many settings are made automatically and do not need to be programmed.
The priorities come into play when individual commands are sent to the instrument. However , if
multiple commands are grouped in a command sequence, the priorities are inactive within the
command sequence.
Note:Send individual commands in order of decreasing priority so that settings are not
overwritten by subsequent commands.
If you transmit command sequences, be careful to pro vid e consistent data since the
instrument does not make automatic corrections in this case.
5.2Command hierarchy table
Remote CommandPriority
*RST on page R-51
:SOUR:JITT:FREQ on page R-242
[:SENS]:JITT:FREQ on page R-422
all other commands3
Table I-9Command hierarchy table
IntroductionI-27
Page 36
6 Programming examplesJitter STM-16 Module
6Programming examples
This chapter contains some short sample programs to help you get familiar with the remote
control operation of this device.
6.1Notation
The sample programs are written in C programming language style using the fun ctions “clear” ,
“write”, “wait” and “read” as placeholders for the different functions used by programmers
depending on their programing language.
Note: A “NOEND” as the second parameter of the function “write” indicates that the same
program message is continued in the next line without sending a program message
terminator (PMT). An “END” indicates that a program message terminat or (PMT) should
be sent.
Multiple commands can be appended into one “big” program message using NOEND.
Checking of coupled parameters and the ex ecution of all commands starts after the PMT
or any sequential command is received.
6.2Example 1 (Peak to peak jitter measurement)
This sample program performs a sim ple 2488 Mbit/s (STM16 / OC48) jitter measurement. Note
that the default device setting after a *RST command is a 2 Mbit/s framed PDH signal.
This sample program sets the device receiver and transmitter in the same way.
// Select Basic Module to talk to (only required for ANT-20 and
// not for the ANX VXI modules)
write (“MOD:SEL BASIC”,END);
// Clear status register and error queue.
write (“*CLS”, END);
// Reset device to standard setting.
// TX and RX set to 2 Mbit/s framed signal.
write (“*RST”, END);
// Set transmitter to 2488 Mbit/s optical SDH signal.
write (“:SOUR:MODE SDH;” ,NOEND);
write (“:SOUR:DATA:SDH:RATE STM16;”,END);
// Set receiver to 2488 Mbit/s optical SDH signal.
write (“:SENS:MODE SDH;” ,NOEND);
write (“:SENS:DATA:SDH:RATE STM16;”,END);
// Select Jitter STM-16 Module to talk to (only required for
// ANT-20 and not for the ANX VXI modules).
write (“MOD:SEL JITT16”,END);
// Clear status register and error queue.
write (“*CLS”, END);
// Reset device to standard setting.
write (“*RST”, END);
I-28Introduction
Page 37
Jitter STM-16 Module6 Programming examples
// Set Jitter STM-16 generator.
write (“:SOUR:JITT:AMPL 1;”,NOEND);
// Jitter frequency 1000Hz
write (“:SOUR:JITT:FREQ 1000;”,NOEND);
// Switch Jitter STM-16 generator on
write (“:SOUR:JITT ON;”,END);
// AGAIN select Basic Module to talk to (only required for
// ANT-20 and not for the ANX VXI modules).
write (“MOD:SEL BASIC”,END);
// route signal clock connection of Basic Module to the Jitter
// STM-16 Module. Enables transmitter jitter capabilities.
write (“:INP:CLOC:JITT ON”,END;
// AGAIN select Jitter STM-16 Module to talk to (only required
// for ANT-20 and not for the ANX VXI modules).
write (“MOD:SEL JITT16”,END);
// Set Jitter STM-16 receiver.
// Select jitter peak to peak value as requested result.
write (“SENS:FUNC:ON ’JITT:PPE’”,END);
// Wait until the device settling time has finished.
wait(10);
// place results into the output queue.
write (“SENS:DATA:ACT?”,END);
// Read response from the Jitter STM-16 Module.
read();
// The response can look like this: 54,0.98
// indicating a valid result id (54)
// and a current jitter peak to peak value of 0.98UI
IntroductionI-29
Page 38
6 Programming examplesJitter STM-16 Module
6.3Example 2 (wander measurement)
This sample program sets the receiver for a 2488 Mbit/s (STM16 / OC48) wander
measurement. Note that the default device setting after a *RST command is a 2 Mbit/s framed
PDH signal.
// Select Basic Module to talk to (only required for ANT-20 and
// not for the ANX VXI modules).
write (“MOD:SEL BASIC”,END);
// Clear status register and error queue.
write (“*CLS”, END);
// Reset device to standard setting.
// TX and RX set to 2 Mbit/s framed signal.
write (“*RST”, END);
// Set receiver to 2488 Mbit/s optical SDH signal.
write (“:SENS:MODE SDH;” ,NOEND);
write (“:SENS:DATA:SDH:RATE STM16;”,END);
// Select Jitter STM-16 Module to talk to (only required for
ANT-20 and
// not for the ANX VXI modules).
write (“MOD:SEL JITT16”,END);
// Clear status register and error queue.
write (“*CLS”, END);
// Reset device to standard setting.
write (“*RST”, END);
// Set measurement duration to 10 seconds.
write (“SENS:SWE:TIME 10”, END);
// start measurement.
write (“INIT”, END);
// Wait until measurement has finished and
// place results into the output queue.
write (“*WAI;SENS:DATA:FIN?”,END);
// Read response from device.
read();
// The response can look like this: 101,1.5E-9
// indicating a valid result id (101)
// and a current wander value of 1.5E-9 seconds.
I-30Introduction
Page 39
Jitter STM-16 Module7 Release notes
7Release notes
This section contains a summary of all additions included from software r ele ase V7.0 onwards.
7.1New commands
:SOUR:MODE on page R-26
[:SENS]:JITT:FREQ on page R-42
[:SENS]:JITT:MODE on page R-43
[:SENS]:JITT:RMS:INT:PER on page R-44
[:SENS]:WAND:SAMP:RATE on page R-49
7.2Changed commands
[:SENS]:WAND:RCL[:CLOC]on page R-48: last optional node [:CLOCk] added.
• Codes for the event memory on page R-34 ff.: “SVALue:WANDer:TIE” added.
• Result IDs for :SENS:DATA and :SENS:FUNC commands on page R-40 ff.: “JITT:RMS”
added.
IntroductionI-31
Page 40
7 Release notesJitter STM-16 Module
Notes:
I-32Introduction
Page 41
Jitter STM-16 Module*CAL?
Command reference
1Common commands
Instrument behavior is based on:
IEEE Standard Codes, Formats, ANSI/IEEE Std 488.2-1992.
The common commands that are implemented are given below in alphabe tical
order.
*CAL?
Instrument calibration query.
ParameterNone
CommentsRequests the instrument to perform an internal self calibration and to return the
result. The response indicates whether or not the instrument completed the
calibration without error. A value of 0 indicates that the calibration has been
completed successfully.
The instrument signals the need for calibration using bit 8 of the “questionable
status register” (see Status register structure on page R-11).
See also “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Note: The instrument is set to the reset state (as set by a *RST command) after a
*CAL? command.
Response0:Calibration has been completed successfully
-1:Calibration failed
-2:Calibration failed (warm-up time not reached
-3:Calibration failed (EEPROM write error)
-10:Calibration failed (calibration currently not possible)
Example*CAL?
Response: 0
Related commandsNone
Common commandsR-1
Page 42
*CLSJitter STM-16 Module
*CLS
Clear Status Command.
ParameterNone
CommentsClears the data accumulated in the registers. Causes a partial initialization of
remote control. The masks contained in the registers (ENABLE Register) are not
altered (see also SCPI Syntax and Style Section 4.1.3.2).
The following actions take place:
• Clearing of all EVENT registers in the status register structure.
• Clearing of the error queue and all other que ues which affect the status register
structure.
• Interruption of an *OPC synchronization possibly underway, without a 1 being
entered into bit 0 of the standard event status register.
• Interruption of an *OPC? synchronization possibly underway, without a 1 be ing
entered into the output queue.
See also “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example*CLS
Related commands*RST on page R-5
*ESE
*ESE <mask> Standard Event Status Enable Command.
ParameterNameTypeRangeDefault
masknumeric
CommentsSets the mask for the ESR register.
See also “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example*ESE 32
Related commands*ESR? on page R-3
*ESE?onpageR-3
#H00 - #HFF or
#B00000000 - #B11111111 or
0 - 255
0
R-2Common commands
Page 43
Jitter STM-16 Module*ESE?
*ESE?
Standard Event Status Enable Query.
ParameterNone
CommentsReads the mask for the ESR register.
See also “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example*ESE?
Response: 64
Related commands*ESR? on page R-3
*ESE on page R-2
*ESR?
Standard Event Status Register Query.
ParameterNone
CommentsReads out the status register ESR. Range from 0 - 255.
See also “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example*ESR?
Response: 64
Related commands*ESE on page R-2
Common commandsR-3
Page 44
*IDN?Jitter STM-16 Module
*IDN?
Identification Query.
ParameterNone
CommentsReads out the instrument identification consisting of 4 fields, separated by “,”:
Note: The setting is synchronized to the next, device-internal complete second. As
a result, erroneous values can be read if you do a read-out immediately after
a previous setting.
The setting is not changed by a *RST command.
Dependenciesnone
ExampleSYST:TIME 12,10,0sets the time of day to 12:10:0.
Related commands:SYST:DATE on page R-9
:SYST:TIME?
:SYSTem:TIME? provides the current time of day of the instrument.
.
Example:SYST:TIME?
Response: 23,50,59
:SYST:VERS?
:SYSTem:VERSion? provides the SCPI version number on which this instrument is
based.
.
Example:SYST:VERS?
Response: 1996.0for version 1996 release 0.
R-10SYSTEM subsystem
Page 51
Jitter STM-16 Module
3STATUS subsystem
3.1Status register structure
The status register structure is oriented towards the one issued by the SCPI. The following figure shows the
status register structure:
STATus:QUEStionable?
Calibration
Jitter
Wander
not used
STATus:OPERation?
Calibrating
Measuring
Wait for Trigger
not used
Operation Complete
(not supported)
Device Dependent Error
Query Error
Execution Error
Command Error
(not supported)
Power On
Standard Event Status Register
8
9
10
0
4
5
8Wander Generator
*ESR?
0
1
2
3
4
5
6
7
Event FIFO
Error Queue
MAV
RQS
Status Register
*STB?
0
1
2
3
4
5
6
7
Fig. R-1Status register structure
STATUS subsystemR-11
Page 52
:STATus:OPERation registerJitter STM-16 Module
3.2STATUS commands
:STATus:OPERation register
The OPERation status register contains conditions which are part of the
instruments’s normal operation.
:STAT:OPER:COND?
:STATus:OPERation:CONDition? provides the current value of the condition
register.
CommentsBit positionMeaning
0If this bit is set the instrument is currently performing a calibration.
4If this bit is set the instrument is currently measuring.
5If this bit is set the instrument is in a “wait for trigger” state of the
trigger model (e.g. waiting for the start time during a timer
controlled measurement).
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:OPER:COND?
Response: 0
:STAT:OPER:ENAB
:STATus:OPERation:ENABle <value> specifies the value of the enable register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
#B0000000000000000 #B0111111111111111 or
0 - 32767
#H0
Note: Bit 15 cannot be set.
Example:STAT:OPER:ENAB 16
R-12STATUS subsystem
Page 53
Jitter STM-16 Module:ST AT:OPER:ENAB?
:STAT:OPER:ENAB?
:STATus:OPERation:ENABle? provides the current setting of the enable register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:OPER:ENAB?
Response: 0
:STAT:OPER[:EVEN]?
:STATus:OPERation[:EVENt]? reads the event register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Note: Reading the event register clears its content.
ExampleSTAT:OPER?
Response: 16if a measuring event was detected.
:STAT:OPER:NTR
:STATus:OPERation:NTRansition <value> specifies the value of the negative
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
#B0000000000000000 #B0111111111111111 or
0 - 32767
Note: Bit 15 cannot be set.
Example:STAT:OPER:NTR 16
#H0
:STAT:OPER:NTR?
:STATus:OPERation:NTRansition? provides the current setting of the negative
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:OPER:NTR?
Response: 0
STATUS subsystemR-13
Page 54
:STAT:OPER:PTRJitter STM-16 Module
:STAT:OPER:PTR
:STATus:OPERation:PTRansition <value> specifies the value of the positive
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
Note: Bit 15 cannot be set.
Example:STAT:OPER:PTR 16
:STAT:OPER:PTR?
:STATus:OPERation:PTRansition? provides the current setting of the positive
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:OPER:PTR?
Response: 0
:STAT:PRES
#H0
#B0000000000000000 #B0111111111111111 or
0 - 32767
:STATus:PRESet presets the status register structure.
See SCPI handbook “Command Reference” for more de tails.
Parameternone
CommentsThe following actions are taken:
• :STAT:OPER:ENAB is set to all zeros.
• :STAT:QUES:ENAB is set to all zeros.
• all positive transition registers (...:PTR) are set to all ones.
Example:STAT:PRES
R-14STATUS subsystem
Page 55
Jitter STM-16 Module:STATus:QUEStionable register
:STATus:QUEStionable register
The QUEStionable status register set contains bits which give an indication of the
quality of various aspects of the signal.
:STAT:QUES:COND?
:ST ATus:QUEStionable:CONDition? provides the current value of the questionable
status register.
CommentsBit positionMeaning
8If this bit is set results can be questionable because the module
needs a calibration (use the *CAL? query to initiate a calibration).
9If this bit is set jitter results cannot be taken and are set to invalid
(PLL not locked).
10If this bit is set wander results cannot be taken and are set to
invalid (PLL not locked).
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:QUES:COND?
Response: 0
:STAT:QUES:ENAB
:ST ATus:QUEStionable:ENABle <value> specifies the value of the enable register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
#B0000000000000000 #B0111111111111111 or
0 - 32767
Note: Bit 15 cannot be set.
#H0
Example:STAT:QUES:ENAB 16
STATUS subsystemR-15
Page 56
:STAT:QUES:ENAB?Jitter STM-16 Module
:STAT:QUES:ENAB?
:ST A Tus:QUEStionable:ENABle? pr ovides the current setting of the enable register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:QUES:ENAB?
Response: 0
:STAT:QUES[:EVEN]?
:STATus:QUEStionable[:EVENt]? reads the event register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Note: Reading the event register clears its content.
Example:STAT:QUES?
Response: 16if a measuring event was detected.
:STAT:QUES:NTR
:STATus:QUEStionable:NTRansition <value> specifies the value of the negative
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
#B0000000000000000 #B0111111111111111 or
0 - 32767
Note: Bit 15 cannot be set.
Example:STAT:QUES:NTR 16
#H0
:STAT:QUES:NTR?
:STATus:QUEStionable:NTRansition? provides the current setting of the negative
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:QUES:NTR?
Response: 0
R-16STATUS subsystem
Page 57
Jitter STM-16 Module:STAT:QUES:PTR
:STAT:QUES:PTR
:STATus:QUEStionable:PTRansition <value> specifies the value of the positive
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
ParameterNameTypeRangeDefault
valuenumeric#H0000 - #H7FFF or
Note: Bit 15 cannot be set.
Example:STAT:QUES:PTR 16
:STAT:QUES:PTR?
:STATus:QUEStionable:PTRansition? provides the current setting of the positive
transition register.
See SCPI handbook “Command Reference”
or “WG SCPI and IEEE488 Programmer’s Introduction” for more details.
Example:STAT:QUES:PTR?
Response: 0
#H0
#B0000000000000000 #B0111111111111111 or
0 - 32767
STATUS subsystemR-17
Page 58
:STAT:QUES:PTR?Jitter STM-16 Module
Notes:
R-18STATUS subsystem
Page 59
Jitter STM-16 Module:ABOR
4TRIGGER subsystem
The Trigger subsystem is used for Start/Stop control of measurements (see also
[:SENS]:SWE on page R-47)
:ABOR
:ABORt halts a measurement in progress or a timer sequence.
ParameterNone
DependenciesThis command works only if a measurement has been pr eviously activated using
:INIT[:IMM][:ALL]
Example:ABOR
Related commands:INIT[:IMM][:ALL] on page R-19
:TRIG[:SEQ]:SOUR on page R-20
:TRIG[:SEQ]:STIM on page R-21
:INIT[:IMM][:ALL]
:INITiate[:IMMediate][:ALL] starts the measurement on the next trigger.
.
ParameterNone
DependenciesNone
CommentsThe measurement is started on the next trigger. This can be when the next full
second is reached or, under timer control, by reaching the time preset with
:TRIG[:SEQ]:STIM on page R-21. The trigger condition to be fulfilled is specified
using :TRIG[:SEQ]:SOUR on page R-20.
Example:INIT
Related commands:ABOR on page R-19
:TRIG[:SEQ]:SOUR on page R-20
:TRIG[:SEQ]:STIM on page R-21
TRIGGER subsystemR-19
Page 60
:TRIG[:SEQ]:SOURJitter STM-16 Module
:TRIG[:SEQ]:SOUR
:TRIGger[:SEQuence]:SOURce <source> specifies the trigger source for the
TRIGGER subsystem.
ParameterNameTypeRangeDefault
sourcediscreteAINTernal | STIMe |
IMMediate
DependenciesNone
CommentsAINTernal:
STIMe:
IMMediate:
ExampleTRIG:SOUR TIfor the timer as a trigger source.
Related commands:INIT[:IMM][:ALL] on page R-19
:ABOR on page R-19
:TRIG[:SEQ]:STIM on page R-21
The trigger condition is satisfied when
the next complete second is reached.
The trigger condition is satisfied when
the start time set with
:TRIG[:SEQ]:STIM on page R-21 is reached.
The trigger condition is satisfied in an asynchronous manner,
i.e. at the next possible point in time.
:TRIG[:SEQ]:SOUR?
This query provides the current trigger source setting.
AINT
Example:TRIG[:SEQuence]:SOUR?
Response: AINT
if internal triggering on the next complete second is
activated.
DependenciesEffective only if :TRIG[:SEQ]:SOUR = STIM.
CommentsThis command is used to set the point in time at which a timer-based measurement
is to start.
Example:TRIG:STIM 1996,6,3,18,30,00 sets the measurement start to June 3, 1996 at
18:30:00.
Related commands:INIT[:IMM][:ALL] on page R-19
:ABORonpageR-19
:TRIG[:SEQ]:SOUR on page R-20
:TRIG[:SEQ]:STIM?
provides the current setting of the measurement start time.
Example:TRIG:STIM?
Response: 1995,12,31,23,30,20
for measurement start on December, 31, 1995 at 23:30:20.
TRIGGER subsystemR-21
Page 62
:TRIG[:SEQ]:STIM?Jitter STM-16 Module
Notes:
R-22TRIGGER subsystem
Page 63
Jitter STM-16 Module:SOUR:JITT:AMPL
5SOURCE subsystem
Note: For clarity, options have been shown in abbreviated form in this chapter, e.g.
“90.xx” instead of “BN 3035/90.xx”.
This subsystem is used to set the jitter generator.
Note: The status, amplitude and frequency of the Wander Generator for STM-16
are set on the Jitter Module (see :SOUR:WAND:AFAC).
The command :SOUR:MODE on page R-26 is also required.
The Jitter Generator and Receiver option 90.68 is required if no option is
spezified (firmware release earlier than 7.0).
:SOUR:JITT:AMPL
:SOURce:JITTer:AMPLitude <value> sets the jitter amplitude of the generator.
ParameterNameTypeRangeDefault
valuenumeric0.002 - 8000.1
DependenciesThe maximum jitter amplitude depends on the jitter frequency set by
:SOUR:JITT:FREQ on page R-24 and by :SOUR:JITT:SOUR on page R-24.
See Jitter STM16 Module specifications for more details.
The jitter amplitude will be limited to a non-conflicting value
when the jitter frequency is set (if source is INTernal) and
when the jitter source is switched to INTernal.
CommentsAll values in UI (Unit Interval).
The step size is0.001 UI up to 2 UI
0.005 UI up to 20 UI
0.025 UI up to 100 UI
0.25 UI up to 800 UI
Example:SOUR:JITT:AMPL 1sets the jitter amplitude to 1 UI.
Related commands:SOUR:JITT:FREQ on page R-24
:SOUR:JITT[:STAT] on page R-25
:SOUR:MODE on page R-26
:SOUR:JITT:AMPL?
provides the current setting of the jitter amplitude
Example:SOUR:JITT:AMPL?
Response: 3E-3for 0.003 UI
SOURCE subsystemR-23
Page 64
:SOUR:JITT:FREQJitter STM-16 Module
:SOUR:JITT:FREQ
:SOURce:JITTer:FREQuency <value> sets the jitter frequency of the generator.
ParameterNameTypeRangeDefault
valuenumeric0.1 - 200000001000
DependenciesThe maximum jitter frequency depends on the jitter amplitude set by
:SOUR:JITT:AMPL on page R-23. See the jitter module specifications for more
details.
CommentsAll values in Hz.
IEEE 488.2 suffix units (HZ | KHZ | MHZ) are supported.
Example:SOUR:JITT:FREQ 2 KHZsets the jitter frequency to 2000 Hz.
Related commands:SOUR:JITT:AMPL on page R-23
:SOUR:JITT[:STAT] on page R-25
:SOUR:MODE on page R-26
:SOUR:JITT:FREQ?
provides the current setting of the jitter frequency.
Example:SOUR:JITT:FREQ?
Response: 1000for 1000 Hz
:SOUR:JITT:SOUR
:SOURce:JITTer:SOURce <source> determines the signal source for the jitter
modulator.
ParameterNameTypeRangeDefault
sourcediscreteINTernal | EXTernalINT
DependenciesNone
Comments INTernal:Internal jitter modulation as set by
:SOUR:JITT:AMPL on page R-23 and
:SOUR:JITT:FREQ on page R-24.
EXTernal:External jitter modulation using the signal from port [50].
Example:SOUR:JITT:SOUR INTselects internal modulation.
Related commands:SOUR:JITT[:ST AT] on page R-25
R-24SOURCE subsystem
Page 65
Jitter STM-16 Module:SOUR:JITT:SOUR?
:SOUR:JITT:SOUR?
provides the current setting for the signal source of the jitter modulator.
DependenciesOption 90.50 or 90.51 or 90.52 (STM16 hardware) is required.
To enable the jitter capabilities of the Basic Module (Mainframe),
INP:CLOC:JITT ON; and :INP:CLOC: W AND OFF; ( default) must be transmitted
to the Basic Module.
CommentsON | 1:
OFF | 0:
Example:SOUR:JITT ONswitches the jitter generator on.
Related commands:SOUR:JITT:AMPL on page R-23
:SOUR:JITT:FREQ on page R-24
:SOUR:MODE on page R-26
Jitter generator switched on
Jitter generator switched off
:SOUR:JITT[:STAT]?
provides the jitter generator status.
ExampleSOUR:JITT?
Response: 1if jitter generation is activated.
SOURCE subsystemR-25
Page 66
:SOUR:MODEJitter STM-16 Module
:SOUR:MODE
:SOURce:MODE <mode> sets the mode of the generator (SOURce).
ParameterNameTypeRangeDefault
modediscreteJITTer | WANDerJITT
DependenciesThis command requires fir mware release 7.0 or later and rel ated options see below.
For wander generation by the Jitter STM-16 Module, the command
:SOUR:DATA:SDH:RATE STM16; is transmitted to the Basic Module
(Mainframe).
First the commands :SOUR:MODE WAND; :SOUR:WAND:AFAC 16; AMPL
<value>; FREQ <value>; STAT ON; and :SOUR:DATA:RATE STM1; are sent to
the Jitter Module.
Then the commands :INP:CLOC:W AND ON; and :INP:CLOC:JITT ON; must be
transmitted to the Basic Module.
CommentsJITT:Option90.88 is required.
WAND:Options90.81, 90.85 and 90.87 are re qu ire d .
Example:SOUR:MODE WANDallows wander signal generation.
Related commands:SOUR:JITT[:ST AT] on page R-25
On Basic Module:
:SOUR:DATA:SDH:RATE
:INP:CLOC:JITT
:INP:CLOC:WAND
On Jitter Module:
:SOUR:DATA:RATE
:SOUR:MODE
:SOUR:WAND:AF AC
:SOUR:WAND:AMPL
:SOUR:WAND:FREQ
:SOUR:WAND[:STAT]
:SOUR:MODE?
:SOURce:MODE? provides the current mode of the generator (SOURce).
Example:SOUR:MODE?
Response: WANDif wander generation is activated.
R-26SOURCE subsystem
Page 67
Jitter STM-16 Module[:SENS]:AVER[:STAT]
6SENSE subsystem
Note: For clarity, options have been shown in abbreviated form in this chapter, e.g.
“90.xx” instead of “BN 3035/90.xx”.
This subsystem is used to set the Jitter and Wander Receiver, configure
measurements and query results.
Note: The Jitter Generator and Receiver option 90.68 and the Wander Receiver
option 90.69 are required if no option is specified (firmware release earlierthan 7.0).
[:SENS]:AVER[:STAT]
[:SENSe]:A VERage[:ST A Te] <state> switches the averaging mechanism of the jitter
receiver on or off.
ParameterNameTypeRangeDefault
statebooleanON | OFF | 0 | 1OFF
DependenciesNone
CommentsON | 1:
OFF | 0:
Example:AVER ONswitches averaging on.
Related commands[:SENS]:AVER:TIME on page R-28
Averaging switched on
Averaging switched off
[:SENS]:AVER[:STAT]?
This query provides the status of the averaging mechanism of the jitter receiver.
Example:AVER?
Response: 1if the averaging mechanism is switched on.
SENSE subsystemR-27
Page 68
[:SENS]:AVER:TIMEJitter STM-16 Module
[:SENS]:AVER:TIME
[:SENSe]:AVERage:TIME <duration> determines the averaging period of a jitter
measurement.
ParameterNameTypeRangeDefault
durationnumeric1 - 51
DependenciesOnly valid if [:SENS]:AVER[:STAT] = ON.
CommentsThe current measurement results are averaged over the time period (in seconds)
set by this command.
Example:AVER:TIME 1sets period to 1 second.
Related commands[:SENS]:AVER[:STAT] on page R-27
[:SENS]:AVER:TIME?
provides the current setting of the averaging period of a measurement.
Example:AVER:TIME?
Response: 55 seconds averaging period.
R-28SENSE subsystem
Page 69
Jitter STM-16 Module[:SENS]:DATA:ACT?
[:SENS]:DATA:ACT?
[:SENSe]:DATA:ACTual? [<id>{[, <id>]}*] reads current results.
ParameterNameTypeRangeDefault
idstringe.g. “JITT:POS:PEAK” for
maximum positive jitter value
DependenciesCoupled with: [:SENS]:FUNC[:ON].
Valid results are only available if a measurement was previously initiated (except
status results (“CST”) or other results which are continuously taken).
CommentsThe result(s) designated with <id>s are read out, or (if there is no <id> parameter)
all results which were previously selected with [:SENS]:FUNC[:ON] on page R-39.
The list of available results is found under Result IDs for :SENS:DATA and
:SENS:FUNC commands on page R-40.
Note: Current and final results are identical once the measurement has finished.
If a result is invalid for any reason, the corresponding response code is
negative and the result value is set to NAN (not a number = 9.91E37).
Examplesee [:SENS]:DATA:FIN? on page R-30.
DATA:ACT? “CST”
Response: 40,2
Meaning:
40:
2:
response code “CST”
value of the Alarm bit field “CSTatus”/“HSTatus” indicating
LTI (loss of timing information) jitter, PLL unlocked.
none
Related commandsResult IDs for :SENS:DATA and :SENS:FUNC commands on page R-40
[:SENS]:FUNC[:ON] on page R-39
[:SENS]:DATA:FIN? on page R-30
:INIT[:IMM][:ALL] on page R-19
SENSE subsystemR-29
Page 70
[:SENS]:DATA:FIN?Jitter STM-16 Module
[:SENS]:DATA:FIN?
[:SENSe]:DATA:FINal? [<id>{[, <id>]}*] reads final measurement results.
ParameterNameTypeRangeDefault
idstringe.g. “JITT:PPE:MAX” for
maximum peak-peak jitter value
CommentsThe result(s) designated with <id>s are read out, or (if there is no <id> parameter)
all results which were previously selected with [:SENS]:FUNC[:ON] on page R-39.
The list of available results is found under Result IDs for :SENS:DATA and
:SENS:FUNC commands on page R-40.
DependenciesCoupled with: [:SENS]:FUNC[:ON]
Valid final results are only available if a measurement was previously initiated and
has finished.
Valid final results are not available for results taken continuously.
ResponseThe table below shows the response, if multiple results are selected.
NameType
response code
(1st result)
result value
(1st result)
response code
(2nd result)
numeric response code ID
response type as described in Result IDs for
:SENS:DATA and :SENS:FUNC
commands on page R-40
numeric response code ID
none
result value
(2nd result)
……
response code
(last result)
result value
(last result)
Note: If a result is invalid for any reason, the corresponding response code is
negative and the result value is set to NAN (not a number = 9.91E37).
response type 2nd result
numeric response code ID
response type last result
R-30SENSE subsystem
Page 71
Jitter STM-16 Module[:SENS]:DATA:EVEN?
ExampleIf positive and negative peak jitter value measurement was previously sele cted
using [:SENS]:FUNC[:ON] “JITT:POS:PEAK:MAX”,“JITT:NEG:PEAK:MAX”, a
result given by
:DATA:FIN? can look like this:
51,0.12,53,0.023
Meaning:
51response code “JITT:POS:PEAK:MAX”
0.12positive peak jitter result = 0.12 UI
53response code “JITT:NEG:PEAK:MAX”
0.023negative peak jitter result = 0.023 UI
or:
-51,9.91E37,-53,9.91E37
meaning:
-51response code “JITT:POS:PEAK:MAX” invalid
9.91E37positive peak jitter result is not valid,
NAN (not a number) is returned
-53response code “JITT:NEG:PEAK:MAX” invalid
9.91E37negative peak jitter result is not valid
NAN (not a number) is returned
Related commandsResult IDs for :SENS:DATA and :SENS:FUNC commands on page R-40
[:SENS]:FUNC[:ON] on page R-39
[:SENS]:SWE:TIME on page R-47
[:SENS]:DATA:ACT? on page R-29
:INIT[:IMM][:ALL] on page R-19
:ABORonpageR-19
[:SENS]:DATA:EVEN?
[:SENSe]:DA T A:EVENt? <number> reads the “number” of accumulated events from
the event FIFO. The event FIFO is only used currently for “wander TIE values” or
“positive/negative/peak-peak jitter values” or “RMS values” that are continuously
taken every second during a jitter/wander measurement (as set by
[:SENS]:MODE on page R-46). Within this sequence, changes of the alarm status
(Alarm bit field “CSTatus”/“HSTatus” on page R-35) will also force an entry in the
event FIFO with a corresponding time stamp. This FIFO thus allows the device
programmer to obtain equidistant samples in an asynchronous manner.
ParameterNameTypeRangeDefault
numbernumeric1 - 2001
DependenciesFIFO entries are only available if a wander measure ment was previously initiated.
SENSE subsystemR-31
Page 72
[:SENS]:DATA:EVEN?Jitter STM-16 Module
CommentsJitter/Wander samples and events are stored in an event FIFO (First In First Out),
where they can be extracted with this command.
The data are extracted as in a normal FIFO structure, i.e. the oldest entry first, then
the second oldest, etc.
You can determine whether an event has occu rred by monitoring the status register
(Status register structure on page R-11).
The FIFO content is cleared by initiating a new measurement or by a *RST
command.
Each event (error, alarm or sample) causes at least 2 entries in the FIFO:
1st entry:Time stamp (response code = 10)
2nd entry:Jitter PPEak sample (response code = 1052) or an alarm
entry (response code = 1000) or another jitter sample.
For wander TIE see Example 2 below.
If more than one event occurs between 2 time stamps, the first entry contains the
time stamp and following entries contain the events pertaining to the same time
stamp.
If at least one event entry is available, bit 0 of the status byte is set (see also
STATUS subsystem on page R-11 ff.).
Note: The FIFO can contain up to 2000 entries. If the FIFO is not read in time, an
overflow entry (response code = 1) is appended to the FIFO.
ResponseEach entry in the FIFO has the following structure:
NameType
response codenumeric (the response code)
valuenumerical value
Example 1:DATA:EVEN? 2supplies 2 events out of the FIFO.
Response: 10,0.1930400E7,1052,1.478
Meaning:
10ID 1st event (the time stamp)
0.1930400E7ms since 1970/1/1
1052ID 2nd event (jitter PPEak value).
1.478The jitter PPEak value measured at the above time stamp
was 1.478 UI.
For wander TIE p.e. with 30 samples per second 10 times the following “
length arbitrary block response data
” (IEEE Std 488-2) with corrensponding time
stamps and IDs are emitted:
#216 [=following 16 bytes with 2 * int16 and 3 * reals]
with the “Swapped IEEE Std 754” formats (least significant byte first):
#216 [SINT16=2 bytes] [SINT16=2 bytes] [S FP 32 =4 byte s] [SFP3 2=4 bytes]
[SFP32=4 bytes]
definite
So the 1st 100 ms of the second:
#216 [number of samples=3] [offset=0] [sample 1] [sample 2] [sample 3]
R-32SENSE subsystem
Page 73
Jitter STM-16 Module[:SENS]:DATA:EVEN?
The 2nd 100 ms of the second:
#216 [number of samples=3] [offset=0] [sample 4] [sample 5] [sample 6]
and 7 times so on to:
The 10th (last) 100 ms of the second:
#216 [number of samples=3] [offset=0] [sample 28] [sample 29] [sample 30]
Example 2:DATA:EVEN? 21supplies 21 events out of the FIFO
Response: 10,0.2598600E7,1100,0.345E-9,1101,#216[16 bytes],10,0.2598700E7,
#216[16 bytes], { and 7 times so on to } 10,0.2599500E7,#216[16 bytes]
Meaning:
10ID 1st event (the time stamp)
0.2598600E7ms since 1970/1/1
1100ID 2nd event (wander TIE value)
0.345E-9The wander TIE value measured at the above time stamp
was 0.345E-9 seconds
For wander TIE p.e. with 300 samples per second 10 times the following “
length arbitrary block response data
emitted:
#3124 [=following 124 bytes with 2 * int16 and 30 * reals] with the same formats.
Related commands[:SENS]:DATA:EVEN:NUMB? on page R-34
definite length arbitrary block response data
” with corrensponding time stamps and IDs are
”
definite
SENSE subsystemR-33
Page 74
[:SENS]:DATA:EVEN:NUMB?Jitter STM-16 Module
[:SENS]:DATA:EVEN:NUMB?
[:SENSe]:DATA:EVENt:NUMBer? supplies the number of entries available in the
event FIFO.
ParameterNone
Related commands[:SENS]:DATA:EVEN? on page R-31
Codes for the event memory
Note: The alarm alternation events are collected into bit fields (32 bi ts) where each individual alarm ca n be
found at a specified bit position. A logical “1” at the resp ective bit position indica tes an active alarm,
and a logical “0” an inactive alarm. For a description of these bit fields, see: Alarm bit field “CSTatus”/
“HSTatus” on page R-35.
NameResponse
code
NOEVent0count = 0No event available
OVERflow1count = 0Overflow of internal event memory
Time stamp10real (NR3)Time stamp of events in milliseconds since
AEVent:CST1000boolean (NR1)
CVALue:JITter:POSiti
ve:PEAK
CVALue:JITter:NEGat
ive:PEAK
CVALue:JITter:PPEak 1052real (NR3)Current peak to peak jitter value (UI).
CVALue:WANDer:TIE1100real (NR3)Current wander TIE value in seconds
SVALue:WANDer:TIE1101“
1050real (NR3)Current positive peak jitter value (UI).
1051real (NR3)Current negative peak jitter value (UI).
Response typeEvent description
1970/1/1
Event in the signal alarm bit field (see also
(compressed)
definite length
arbitrary block
response data
beginning with #
and followed by
the number of
digits of the byte
count, plus the
number of data
bytes that follow.
See
[:SENS]:DATA:E
VEN? on page R31, Example 2
Alarm bit field “CSTatus”/
“HSTatus” on page R-35)
Only valid if [:SENS]:MODE = WAND.
Current wander TIE sample values in seconds;
[:SENS]:WAND:SAMP:RATE on page R-49
determines the number of samples per second.
”,
The 1 to 300 samples must be polled from the
event queue every second using
[:SENS]:DATA:EVEN? <number>; otherwise
overflow will occur.
This requires firmware release 7.0 or later andJitteroptions90.88andWander 90.89.
Only valid if [:SENS]:MODE = WAND.
Table R-1General event IDs for the event memory
R-34SENSE subsystem
Page 75
Jitter STM-16 ModuleAlarm bit field “CSTatus”/“HSTatus”
The result IDs listed below are used to identify results requested for the following commands:
[:SENS]:FUNC[:ON] on page R-39
[:SENS]:FUNC:OFF on page R-38
[:SENS]:DATA:FIN? on page R-30
[:SENS]:DATA:ACT? on page R-29
Note: The ID strings listed below show the ID names in a long form. This simplifies understanding of the
command syntax.
The device only accepts SCPI short form upper case (capital letter) commands to speed up the
response time of the device (e.g. “CSTATUS” is not accepted, use “CST” instead).
The SCPI short form is indicated by the capital letters in the commands below.
ID stringResponse
code
ATIMe20count
Response
type
1
Response descriptionUnit
Actual time of day in milliseconds since
1/1/1970
ETIMe21countMilliseconds since measurement startms
STIMe22countStarting time of measurement in
milliseconds since 1/1/1970
CSTatus40bit field
1
Current status of the signal as a bit field
(Alarm bit field “CSTatus”/
“HSTatus” on page R-35)
HSTatus45bit fieldHistory status of the signal as a bit field
(Alarm bit field “CSTatus”/
“HSTatus” on page R-35).
This result provides all the alarms which
were detected since the start of the last
measurement.
1 These results are taken continuously and are not available using the [:SENS]:DATA:FIN? command.
Table R-3Result IDs for general results
ms
ms
none
none
R-40SENSE subsystem
Page 81
Jitter STM-16 Module[:SENS]:FUNC[:ON]?
ID stringResponse
code
JITTer:POSitive:PEAK
50count
Response
type
(NR3)
JITTer:POSitive:PEAK
:MAXimum
JITTer:NEGative:PEAK
51count
(NR3)
52count
(NR3)
JITTer:NEGative:PEAK
:MAXimum
JITTer:PPEak
53count
(NR3)
54count
(NR3)
JITTer:PPEak:MAXimum
55count
(NR3)
JITTer:POSitive:PHIT
56count
(NR3)
JITTer:NEGative:PHIT
57count
(NR3)
JITTer:RMS58count
(NR3)
1
2
1
2
1
2
2, 3
2, 3
1
Response descriptionUnit
Current positive peak jitter value.
The value is set to a negative value if
there is a range overflow.
Maximum positive jitter value during the
current measurement.
The value is set to a negative value if
UI
(unit
interval)
UI
(unit
interval)
there is a range overflow.
Current negative peak jitter value
The value is set to a negative value if
there is a range overflow.
Maximum negative jitter value during the
current measurement
The value is set to a negative value if
UI
(unit
interval)
UI
(unit
interval)
there is a range overflow.
Current peak to peak jitter value
The value is set to a negative value if
there is a range overflow.
Maximum peak to peak jitter value during
the current measurement
The value is set to a negative value if
UI
(unit
interval)
UI
(unit
interval)
there is a range overflow.
Number of transgressions (phase hits) of
the lower limit set by
[:SENS]:JITT:THR[:UPP] on page R-45.
Number of transgressions (phase hits) of
the lower limit set by
[:SENS]:JITT:THR:LOW on page R-45.
Current jitter RMS value
The value is set to a negative value if
there is a range overflow.
UI
(unit
interval)
UI
(unit
interval)
UI
(unit
interval)
[:SENS]:JITT:THR[:UPP] on page R-45
= Integration time
The alarms “Jitter measurement positive/
negative overflow”, “LTI jitter” and “LOS”
of Alarm bit field “CSTatus”/
“HSTatus” on page R-35 are only
enabled if also the result ID “JITT:PPE”,
or “JIT:POS/NEG:PEAK” is activated.
1 These results are taken continuously and are not available using the [:SENS]:DATA:FIN? command.
2 A measurement must be initiated for valid results.
3 Note that the max. counter frequency for phase hit counting is limited. See jitter STM16 module specification for more details.
Table R-4Result IDs for jitter results
SENSE subsystemR-41
Page 82
[:SENS]:JITT:FREQJitter STM-16 Module
ID stringResponse
code
WANDer:TIE100count
Response
type
2
Response descriptionUnit
Current wander time interval error
1
s
(NR3)
2
WANDer:MTIE101count
(NR3)
1 For wander results, option 90.69 or firmware release 7.0 or later and O.172 options 90.88 and 90.89 are required.
2 A measurement must be initiated for valid results.
Table R-5Result IDs for wander results
Maximum wander time interval error
during the current measurement
1
s
[:SENS]:JITT:FREQ
[:SENSe]:JITTer:FREQuency <value> sets the jitter measuremen t frequency of the
receiver.
ParameterNameTypeRangeDefault
valuenumeric10 - 200000001000
DependenciesCommand requires firmware release 7.0 or later and
Jitter RxTx O.172 STM-16option 90.88.
:SOUR:JITT:FREQ on page R-24 must have the same frequency (this is set
automatically) but < 10 Hz is not possible.
Only valid if [:SENS]:JITT:MODE = SEL.
CommentsAll values in Hz.
IEEE 488.2 suffix units (HZ | KHZ | MHZ) are supported.
Example:JITT:FREQ 2 KHZsets the jitter measurement frequency to 2000 Hz.
Related commands:SOUR:JITT:FREQ on page R-24;
[:SENS]:JITT:MODE on page R-43
[:SENS]:JITT:FREQ?
provides the current setting of the jitter measurement frequency.
Example:JITT:FREQ?
Response: 1000 for 1000 Hz
R-42SENSE subsystem
Page 83
Jitter STM-16 Module[:SENS]:JITT:MODE
[:SENS]:JITT:MODE
[:SENSe]:JITTer:MODE <mode> sets the jitter measurement mode of the receiver.
ParameterNameTypeRangeDefault
modediscreteBROadband | SELectiveBRO
DependenciesCommand requires firmware release 7.0 or later and
SEL requires Jitter TxRx O.172 STM-16option 90.88.
CommentsBROadband:
SELective:
Example:JITT:MODE SELsets selective jitter measurement mode.
Related commands[:SENS]:JITT:FREQ on page R-42
:SOUR:JITT:FREQ on page R-27
Broadband measurement
Selective measurement used for JTF (jitter transfer function)
[:SENS]:JITT:MODE?
provides the current setting of the jitter measurement mode.
Example:JITT:MODE?Response: SEL
[:SENS]:JITT:RANG[:UPP]
[:SENSe]:JITTer:RANGe[:UPPer] <range> determines the peak to peak jitter
measurement range.
ParameterNameTypeRangeDefault
rangenumeric2 | 322
DependenciesNone
CommentsAll values in UI (Unit Interval).
A range overflow is indicated in the Alarm bit field “CSTatus”/
“HSTatus” on page R-35.
Example:JITT:RANG 32sets range to 32UI.
Related commandsNone
[:SENS]:JITT:RANG[:UPP]?
provides the current setting of the jitter measurement range.
Example:JITT:RANG?
Response: 32
SENSE subsystemR-43
Page 84
[:SENS]:JITT:RMS:INT:PERJitter STM-16 Module
[:SENS]:JITT:RMS:INT:PER
[:SENSe]:JITTer:RMS:INTegration:PERiod <time> determines the RMS jitter
measurement integration time.
ParameterNameTypeRangeDefault
timenumeric1 | 2 | 5 | 10 | 20 | 40 | 801
DependenciesCommand requires firmware release 7.0 or later and STM-16 O.172 90.88.
In Start/Stop measurement mode, the measurement time [:SENS]:SWE:TIME must
be set to a value greater than the RMS integration time.
CommentsAll values in seconds.
RMS jitter values are measured only if the corresponding result has been selected
(:SENS:FUNC:ON “JITT:RMS”).
Example:JITT:RMS:INT:PER 5sets range to 5 s.
Related commands[:SENS]:DATA:ACT? on page R-29
[:SENS]:FUNC[:ON] on page R-39 with ID-string “JITT:RMS“
[:SENS]:SWE:TIME on page R-47
[:SENS]:JITT:RMS:INT:PER?
provides the current setting of the RMS jitter measurement integration time.
Example:JITT:RMS:INT:PER?
Response: 5
R-44SENSE subsystem
Page 85
Jitter STM-16 Module[:SENS]:JITT:THR[:UPP]
[:SENS]:JITT:THR[:UPP]
[:SENSe]:JITTer:THReshold[:UPPer] <range> determines the upper phase hit
threshold.
ParameterNameTypeRangeDefault
rangenumeric0.1 - 16.0 [1.0]0.5
DependenciesIf [:SENS]:JITT:FREQ = 2 the maximum value is limited to 1.0.
CommentsAll values in UI (Unit Interval).
This command sets the positive limit for phase hits.
Phase hits are measured only if the corresponding result has been selected
(:SENS:FUNC:ON “JITT:POS:PHIT”).
A phase hit is counted whenever the positive jitter actually measured exceeds the
limit set by this command.
Example:JITT:THR:UPP 1.5sets threshold to 1.5 UI.
Related commands[:SENS]:JITT:THR:LOW on page R-45
[:SENS]:JITT:FREQ on page R-42
[:SENS]:JITT:THR[:UPP]?
provides the current setting of the upper phase hit threshold.
Example:JITT:THR:UPP?
Response: 0.25
[:SENS]:JITT:THR:LOW
[:SENSe]:JITTer:THReshold:LOWer <range> determines the lower phase hit
threshold.
ParameterNameTypeRangeDefault
rangenumeric0.1 - 16.0 [1.0]0.5
DependenciesIf [:SENS]:JITT:FREQ = 2 the maximum value is limited to 1.0.
CommentsAll values in UI (Unit Interval).
This command sets the negative limit for phase hits.
Phase hits are measured only if the corresponding result has been selected
(:SENS:FUNC:ON “JITT:NEG:PHIT”).
A phase hit is counted whenever the negative jitter actually measured exce ed s the
limit set by this command.
Example:JITT:THR:LOW 1.5sets threshold to 1.5 UI.
Related commands[:SENS]:JITT:THR[:UPP] on page R-45
[:SENS]:JITT:FREQ on page R-42
SENSE subsystemR-45
Page 86
[:SENS]:JITT:THR:LOW?Jitter STM-16 Module
[:SENS]:JITT:THR:LOW?
provides the current setting of the lower phase hit threshold.
Example:JITT:THR:LOW?
Response: 0.25
[:SENS]:MODE
[:SENSe]:MODE <mode> determines the receiver measurement mode.
ParameterNameTypeRangeDefault
rangediscreteJITTer | WANDerJITT
DependenciesFor wander measur ements, a refere nce clock on input por t [54] and option 90 .69 or
(for O.172) 90.88 and 90.89 are required.
CommentsThe corresponding results (jitter or wander) can only be valid if this parameter is
properly set.
The reference frequency of wander measurements is set by
[:SENS]:WAND:RCL[:CLOC] on page R-48.
Example:MODE JITTactivates jitter mode.
Related commands[:SENS]:WAND:RCL[:CLOC] on page R-48
[:SENS]:DATA:EVEN? on page R-31
[:SENS]:DATA:EVEN:NUMB? on page R-34
[:SENS]:JITT:FREQ on page R-42
[:SENS]:MODE?
provides the current setting of the receiver measurement mode.
Example:MODE?
Response: JITT
R-46SENSE subsystem
Page 87
Jitter STM-16 Module[:SENS]:SWE
[:SENS]:SWE
[:SENSe]:SWEep commands determine the type and duration of the mea surement
to be performed. Measurements are started using the TRIGGER
subsystem on page R-19 ff.
[:SENS]:SWE:TIME
[:SENSe]:SWEep:TIME <duration><suffix> determines the duration of a
measurement.
ParameterNameTypeRangeDefault
durationnumeric1 - 991
suffixdiscrete[s] | min | hr | dhr
Measurement intervals can range from 1 second to 99 days.
Example:SWE:TIME 1 dmeasurement interval of 1 day
Related commandsTRIGGER subsystem on page R-19 ff.
[:SENS]:SWE:TIME?
[:SENSe]:SWEep:TIME? provides the current setting of the measurement duration