YOKOGAWA WT1800 User manual

IM WT1801-17EN
4th Edition
Precision Power Analyzer
WT1800
Communication Interface

i
IM WT1801-17EN
Thank you for purchasing the WT1800 Precision Power Analyzer.
This Communication Interface User’s Manual explains the following interface features and commands.
• Ethernet interface
• USB interface
• GP-IB interface
To ensure correct use, please read this manual thoroughly before operation.
Keep this manual in a safe place for quick reference in the event a question arises.
List of Manuals
The following manuals, including this one, are provided as manuals for the WT1800. Please read all
the manuals.
Manual Title Manual No. Description
WT1800 Precision Power Analyzer
Features Guide
IM WT1801-01EN
The supplied CD contains the PDF file of this manual.
This manual explains all the WT1800 features other
than the communication interface features.
WT1800 Precision Power Analyzer
User’s Manual
IM WT1801-02EN The supplied CD contains the PDF file of this manual.
The manual explains how to operate the WT1800.
WT1800 Precision Power Analyzer
Getting Started Guide
IM WT1801-03EN The manual explains the handling precautions and
basic operations of the WT1800 and provides an
overview of its features.
WT1800 Precision Power Analyzer
Communication Interface
User’s Manual
IM WT1801-17EN
This manual. The supplied CD contains the PDF file
of this manual. This manual explains the WT1800
communication interface features and how to use them.
Model WT1800
Precision Power Analyzer
IM WT1801-92Z1 Document for China
The “EN” and “Z1” in the manual numbers are the language codes.
Contact information of Yokogawa offices worldwide is provided on the following sheet.
Document No. Description
PIM 113-01Z2
List of worldwide contacts
Notes
• The contents of this manual are subject to change without prior notice as a result of continuing
improvements to the instrument’s performance and functionality. The figures given in this manual
may differ from those that actually appear on your screen.
• Every effort has been made in the preparation of this manual to ensure the accuracy of its
contents. However, should you have any questions or find any errors, please contact your
nearest YOKOGAWA dealer.
• Copying or reproducing all or any part of the contents of this manual without the permission of
YOKOGAWA is strictly prohibited.
• The TCP/IP software of this product and the documents concerning it have been developed/
created by YOKOGAWA based on the BSD Networking Software, Release 1 that has been
licensed from the Regents of the University of California.
Trademarks
• Microsoft, Internet Explorer, MS-DOS, Windows, Windows NT, and Windows XP are either registered
trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
• Adobe and Acrobat are either registered trademarks or trademarks of Adobe Systems Incorporated.
• In this manual, the ® and TM symbols do not accompany their respective registered trademark
or trademark names.
• Other company and product names are registered trademarks or trademarks of their respective holders.
Revisions
• 1st Edition: February 2011 • 4th Edition: October 2017
• 2nd Edition: August 2011
• 3rd Edition: December 2015
4th Edition: October 2017 (YMI)
All Rights Reserved, Copyright © 2011 Yokogawa Test & Measurement Corporation

ii IM WT1801-17EN
About the USB Interface and Ethernet Interface
• To use the USB communication features, your PC must have the following:
• WT1800 library (TMCTL)
• USB device driver for connecting the WT1800 to the PC
• To use the Ethernet communication features, your PC must have the following:
• WT1800 library (TMCTL)
To download the library and driver listed above, go to the following website, and then browse to
the download page.
http://tmi.yokogawa.com/

iii
IM WT1801-17EN
How to Use This Manual
Structure of the Manual
This manual contains six chapters and an appendix.
Chapter 1 Ethernet Interface
Describes the features and specifications of the Ethernet interface.
Chapter 2 USB Interface
Describes the features and specifications of the USB interface.
Chapter 3 GP-IB Interface
Describes the GP-IB interface features and specifications.
Chapter 4 Programming Overview
Describes command syntax and other programming information.
Chapter 5 Commands
Describes every command individually.
Chapter 6 Status Reports
Describes the status byte, various registers, and queues.
Appendix
Describes error messages and provides other information.
Index

iv IM WT1801-17EN
Symbols and Notation Used in This Manual
Notes and Cautions
The notes and cautions in this manual are categorized using the following symbols.
WARNING Calls attention to actions or conditions that could cause serious or fatal injury to
the user, and precautions that can be taken to prevent such occurrences.
CAUTION Calls attention to actions or conditions that could cause light injury to the user or
damage to the instrument or user’s data, and precautions that can be taken to
prevent such occurrences.
Note Calls attention to information that is important for proper operation of the
instrument.
Character Notations
Panel Key Names and Soft Key Names in Bold Characters
Indicate panel keys that are used in the procedure and soft keys and menu items that appear on the screen.
SHIFT+Panel Key
When SHIFT+panel key appears in a procedural explanation, it means to press the shift key so that it
illuminates, and then to press the indicated panel key. A setup menu for the item written in purple below the
key that you pressed appears on the screen.
Unit
k Denotes 1000. Example: 100 kHz
K Denotes 1024. Example: 720 KB (file size)
Metasyntax
The following table contains the symbols that are used in the syntax discussed mainly in chapters 4
and 5. These symbols are referred to as BNF (Backus-Naur Form) symbols. For details on how to
write data using these symbols, see pages 4-6 and 4-7.
Symbol Description Example Example of Input
<> A defined value ELEMent<x> <x> = 1 to 6 ELEMENT2
{}
|
Select an option in { }
Exclusive OR
SQFormula {TYPE1|TYPE2|TYPE3} SQFORMULA TYPE1
[] Can be omitted NUMeric[:NORMal]:VALue? NUMERIC:VALUE?
How to Use This Manual

v
IM WT1801-17EN
1
2
3
4
5
6
App
Index
Contents
How to Use This Manual.................................................................................................................. iii
Chapter 1 Ethernet Interface
1.1 Component Names and Functions................................................................................... 1-1
1.2 EthernetInterfaceFeaturesandSpecications ............................................................... 1-2
1.3 Connecting to the Ethernet Interface................................................................................ 1-3
1.4 ConguringtheWT1800EthernetSettings...................................................................... 1-4
Chapter 2 USB Interface
2.1 Component Names and Functions................................................................................... 2-1
2.2 USBInterfaceFeaturesandSpecications...................................................................... 2-2
2.3 Connecting to the USB Interface...................................................................................... 2-3
2.4 ConguringtheWT1800USBSettings ............................................................................ 2-4
Chapter 3 GP-IB Interface
3.1 Component Names and Functions................................................................................... 3-1
3.2 GP-IBInterfaceFeaturesandSpecications ................................................................... 3-2
3.3 Connecting to the GP-IB Interface ................................................................................... 3-4
3.4 ConguringtheWT1800GP-IBSettings.......................................................................... 3-6
3.5 Responses to Interface Messages ................................................................................... 3-7
Chapter 4 Programming Overview
4.1 Messages ......................................................................................................................... 4-1
4.2 Commands ....................................................................................................................... 4-3
4.3 Responses ....................................................................................................................... 4-5
4.4 Data.................................................................................................................................. 4-6
4.5 Synchronization with the Controller.................................................................................. 4-8
Chapter 5 Commands
5.1 List of Commands ............................................................................................................ 5-1
5.2 AOUTput Group ............................................................................................................. 5-16
5.3 AUX Group ..................................................................................................................... 5-17
5.4 COMMunicate Group ..................................................................................................... 5-19
5.5 CURSor Group ............................................................................................................... 5-21
5.6 DISPlay Group ............................................................................................................... 5-23
5.7 FILE Group..................................................................................................................... 5-42
5.8 HARMonics Group ......................................................................................................... 5-45
5.9 HCOPy Group ................................................................................................................ 5-46
5.10 HOLD Group .................................................................................................................. 5-48
5.11 HSPeed Group ............................................................................................................... 5-49
5.12 IMAGe Group ................................................................................................................. 5-55
5.13 INPut Group ................................................................................................................... 5-57
5.14 INTEGrate Group ........................................................................................................... 5-67
5.15 MEASure Group ............................................................................................................. 5-70
5.16 MOTor Group.................................................................................................................. 5-75
5.17 NUMeric Group .............................................................................................................. 5-80
5.18 RATE Group ................................................................................................................... 5-92
5.19 STATus Group ................................................................................................................ 5-93
5.20 STORe Group................................................................................................................. 5-94

vi IM WT1801-17EN
Contents
5.21 SYSTem Group .............................................................................................................. 5-97
5.22 WAVeform Group.......................................................................................................... 5-100
5.23 Common Command Group .......................................................................................... 5-102
Chapter 6 Status Reports
6.1 About Status Reports ....................................................................................................... 6-1
6.2 Status Byte ....................................................................................................................... 6-3
6.3 Standard Event Register .................................................................................................. 6-4
6.4 Extended Event Register.................................................................................................. 6-5
6.5 Output and Error Queues ................................................................................................. 6-6
Appendix
Appendix 1 Error Messages..................................................................................................App-1
Appendix 2 About the IEEE 488.2-1992 Standard................................................................App-4
Index

1-1
IM WT1801-17EN
Ethernet Interface
Chapter 1 Ethernet Interface
1
2
3
4
5
6
App
Index
1.1 Component Names and Functions
Front Panel
UTILITY key (page 1-5)
Press this key to set the network connection
timeout setting.
LOCAL key
Press this key to switch from remote mode,
in which settings and operations are
performed through remote commands,
to local mode, in which operations can be
performed using the WT1800 keys. This key
is disabled when local lockout (see page 1-2)
has been activated by a controller.
Rear Panel
Ethernet port
This port is for connecting the WT1800
to a controller (such as a PC) using an
Ethernet cable. For details on how to
connect the WT1800 to a controller,
see page 1-4.

1-2 IM WT1801-17EN
1.2 Ethernet Interface Features and Specifications
Ethernet Interface Features
Reception Feature
You can use the reception feature to specify the same settings that you can specify by using the
front panel keys.
The WT1800 can receive output requests for measured and computed data, panel setup
parameters, and error codes.
Transmission Feature
The WT1800 can transmit measured and computed data.
The WT1800 can transmit panel setup parameters and the status byte.
The WT1800 can transmit error codes when errors occur.
Ethernet Interface Specifications
Electrical and mechanical specifications: complies with IEEE802.3
Simultaneous connections: 1
Communication protocol: TCP/IP (VXI-11)
Connector: RJ-45
Switching between Remote and Local Modes
Switching from Local to Remote Mode
The WT1800 switches to remote mode when it is in local mode and it receives a :COMMunicate:
REMote ON command from the PC.
• The REMOTE indicator illuminates.
• All keys except the LOCAL key are disabled.
• The local mode settings are retained even when the WT1800 switches to remote mode.
Switching from Remote to Local Mode
When the WT1800 is in remote mode and you press LOCAL, the WT1800 switches to local
mode. However, this does not work if the WT1800 has received a :COMMunicate:LOCKout ON
command from the PC. The WT1800 switches to local mode when it receives a :COMMunicate:
REMote OFF command from the PC, regardless of the local lockout state.
• The REMOTE indicator turns off.
• Key operations are enabled.
• Settings entered in remote mode are retained even when the WT1800 switches to local mode.
Note
You cannot use the Ethernet interface simultaneously with other interfaces (GP-IB and USB interfaces).
Setting the Timeout Value
If the WT1800 is not accessed within a given period of time (specified by the timeout
value), it will disconnect from the network. The timeout value can be set from 0 to 3600 s.
The default value is 0 s.
For instructions on how to set the timeout value, see section 1.4, “Configuring the
WT1800 Ethernet Settings.”

1-3
IM WT1801-17EN
Ethernet Interface
1
2
3
4
5
6
App
Index
1.3 Connecting to the Ethernet Interface
Connection Procedure
Connect a UTP (Unshielded Twisted-Pair) or STP (Shielded Twisted-Pair) cable that is connected to
a hub or other network device to the Ethernet port on the WT1800 rear panel.
Hub or router that supports 1000BASE-T/100BASE-TX
Controller
(PC or work station)
UTP or STP cable
(straight cable)
Network card
WT1800
Ethernet port
RJ-45 modular jack
Notes about Connections
• To connect the WT1800 to a PC, be sure to use straight cables and to connect through a hub or
router. Proper operation is not guaranteed for a one-to-one connection using a crossover cable.
• Use a network cable that supports the data rate of your network.
Note
For details on how to connect the WT1800 to a network, see section 19.1, “Connecting the WT1800 to a
Network” in the WT1800 User’s Manual, IM WT1801-02EN.

1-4 IM WT1801-17EN
1.4 Configuring the WT1800 Ethernet Settings
This section explains the following setting for remotely controlling the WT1800 via the Ethernet
interface:
• Network connection timeout setting
UTILITY Remote Control Menu
Press UTILITY, the Remote Control soft key, and then the Network soft key to display the
following screen.
Set the timeout
with the cursor keys.
Note
Only use one communication interface: GP-IB, USB, or Network. If you send commands simultaneously from
more than one communication interface, the WT1800 will not execute the commands properly.
TCP/IP Settings
To use the Ethernet interface, you must specify the following TCP/IP settings.
• IP address
• Subnet mask
• Default gateway
For instructions on how to specify these settings, see section 20.2, “Configuring TCP/IP Settings” in
the WT1800 User’s Manual, IM WT1801-02EN.

2-1
IM WT1801-17EN
USB Interface
1
2
3
4
5
6
App
Index
2.1 Component Names and Functions
Front Panel
LOCAL key
Press this key to switch from remote mode,
in which settings and operations are
performed through remote commands, to
local mode, in which operations can be
performed using the WT1800 keys. This key
is disabled when local lockout (see page 2-2)
has been activated by a controller.
UTILITY key (page 2-4)
Press this key to view the serial number
that is used in USB TMC communication.
Rear Panel
USB port
This port is for connecting the WT1800
to a controller (such as a PC) using a
USB cable. For details on how to
connect the WT1800 to a controller,
see page 2-3.
Chapter 2 USB Interface

2-2 IM WT1801-17EN
2.2 USB Interface Features and Specifications
USB Interface Features
Reception Feature
You can use the reception feature to specify the same settings that you specify by using the front
panel keys.
The WT1800 can receive output requests for measured and computed data, panel setup
parameters, and error codes.
Transmission Feature
The WT1800 can transmit measured and computed data.
The WT1800 can transmit panel setup parameters and the status byte.
The WT1800 can transmit error codes when errors occur.
USB Interface Specifications
Electrical and mechanical specifications: complies with USB Rev. 2.0
Connector: type B connector (receptacle)
Number of ports: 1
Power supply: self-powered
System requirements: a PC with a USB port, running Windows 7 (32 bit), Windows Vista (32 bit),
or Windows XP (32 bit, SP2 or later). A separate device driver is required
to enable the connection with the PC.
Switching between Remote and Local Modes
Switching from Local to Remote Mode
The WT1800 switches to remote mode when it is in local mode and it receives a :COMMunicate:
REMote ON command from the PC.
• The REMOTE indicator illuminates.
• All keys except the LOCAL key are disabled.
• The local mode settings are retained even when the WT1800 switches to remote mode.
Switching from Remote to Local Mode
When the WT1800 is in remote mode and you press LOCAL, the WT1800 switches to local
mode. However, this does not work if the WT1800 has received a :COMMunicate:LOCKout ON
command from the PC. The WT1800 switches to local mode when it receives a :COMMunicate:
REMote OFF command from the PC, regardless of the local lockout state.
• The REMOTE indicator turns off.
• Key operations are enabled.
• Settings entered in remote mode are retained even when the WT1800 switches to local mode.
Note
You cannot use the USB interface simultaneously with other interfaces (GP-IB and Ethernet interfaces).

2-3
IM WT1801-17EN
USB Interface
1
2
3
4
5
6
App
Index
2.3 Connecting to the USB Interface
Notes about Connections
• Be sure to insert the USB cable connector firmly into the USB port.
• If you are connecting multiple devices by using a USB hub, connect the WT1800 to the USB hub
port that is closest to the port that the controller is connected to.
• Do not connect or remove USB cables from the time when the WT1800 is turned on until
operation becomes available (approximately 20 to 30 seconds). Doing so may damage the
WT1800.

2-4 IM WT1801-17EN
2.4 Configuring the WT1800 USB Settings
This section explains the following setting for controlling the WT1800 remotely through a USB
interface:
• Viewing the serial number that is used in USB TMC communications
UTILITY Remote Control Menu
Press UTILITY, the Remote Control soft key, and then the USB soft key to display the following
screen.
Check the serial number.
Note
• Only use one communication interface: GP-IB, USB, or Network. If you send commands simultaneously
from more than one communication interface, the WT1800 will not execute the commands properly.
• Install the YOKOGAWA USB TMC (Test and Measurement Class) driver on your PC. For information
about how to obtain the YOKOGAWA USB TMC driver, contact your nearest YOKOGAWA dealer. You can
also access the YOKOGAWA USB driver download web page and download the driver.
http://tmi.yokogawa.com/
• Do not use USB TMC drivers (or software) supplied by other companies.

3-1
IM WT1801-17EN
GP-IB Interface
1
2
3
4
5
6
App
Index
3.1 Component Names and Functions
Front Panel
LOCAL key
Press this key to switch from remote mode,
in which settings and operations are
performed through remote commands, to
local mode, in which operations can be
performed using the WT1800 keys. This key
is disabled when local lockout (see page 3-7)
has been activated by a controller.
UTILITY key (page 3-6)
Press this key to set the GP-IB address.
Rear Panel
GP-IB port
This port is for connecting the WT1800
to a controller (such as a PC) using a
GP-IB cable. For details on how to
connect the WT1800 to a controller,
see page 3-4.
Chapter 3 GP-IB Interface

3-2 IM WT1801-17EN
3.2 GP-IB Interface Features and Specifications
GP-IB Interface Features
Listener Capability
• Allows you to specify the same settings that you can specify by using the front panel keys. This
does not allow you to turn the power on and off or change communication settings.
• Output requests for measured and computed data, panel setup parameters, and error codes can
be received.
• Commands such as status report commands can be received.
Talker Capability
The WT1800 can transmit measured and computed data.
The WT1800 can transmit panel setup parameters and the status byte.
The WT1800 can transmit error codes when errors occur.
Note
Talk-only, listen-only, and controller capabilities are not available on the WT1800.
GP-IB Interface Specifications
Supported Devices: National Instruments Corporation
• PCI-GPIB or PCI-GPIB+
• PCIe-GPIB or PCIe-GPIB+
• PCMCIA-GPIB or PCMCIA-GPIB+
• GPIB-USB-HS
Driver NI-488.2M Version 1.60 or later
Electrical and mechanical specifications: complies with IEEE St’d 488-1978
Functional specifications: See the following table.
Protocol: complies with IEEE St’d 488.2-1992
Code: ISO (ASCII) code
Mode: addressable mode
Address settings: Press UTILITY, and then on the Remote Control menu, set the
communication interface (Device) to GP-IB and the address to a
number from 0 to 30.
Clearing remote mode: Clear remote mode by pressing LOCAL.
This key is disabled when local lockout has been activated by a
controller.
Functional Specifications
Function Subset Name Description
Source handshaking SH1 Full source handshaking capability
Acceptor handshaking AH1 Full acceptor handshaking capability
Talker T6 Basic talker capability, serial polling, and untalk on MLA (My
Listen Address). No talk-only capability.
Listener L4 Basic listener capability, unlisten on MTA (My Talk Address),
and no listen-only capability
Service request SR1 Full service request capability
Remote local RL1 Full remote/local capability
Parallel polling PP0 No parallel poll capability
Device clear DC1 Full device clear capability
Device trigger DT1 Device trigger capability
Controller C0 No controller capability
Electric characteristics E1 Open collector

3-3
IM WT1801-17EN
GP-IB Interface
1
2
3
4
5
6
App
Index
Switching between Remote and Local Modes
Switching from Local to Remote Mode
The WT1800 switches to remote mode when it is in local mode and it receives a REN (Remote
Enable) message from the PC.
• The REMOTE indicator illuminates.
• All keys except the LOCAL key are disabled.
• The local mode settings are retained even when the WT1800 switches to remote mode.
Switching from Remote to Local Mode
When the WT1800 is in remote mode and you press LOCAL, the WT1800 switches to local mode.
This key combination is disabled if the local lockout state (see page 3-7 for details) has been
activated by a controller.
• The REMOTE indicator turns off.
• Key operations are enabled.
• Settings entered in remote mode are retained even when the WT1800 switches to local mode.
Note
You cannot use the GP-IB interface simultaneously with other interfaces (USB and Ethernet interfaces).
3.2 GP-IB Interface Features and Specifications

3-4 IM WT1801-17EN
3.3 Connecting to the GP-IB Interface
GP-IB Cable
The WT1800 is equipped with an IEEE St’d 488-1978 24-pin GP-IB connector. Use GP-IB cables
that comply with IEEE St’d 488-1978.
Connection Procedure
Connect the cable as shown below.
Notes about Connections
• Firmly tighten the screws on the GP-IB cable connector.
• On the PC end, use a GP-IB board (or card) made by National Instruments. For details, see
section 3.2.
• The WT1800 may not operate properly if the WT1800 is connected to the PC through converters
(such as a GP-IB to USB converter). For more details, contact your nearest YOKOGAWA dealer.
• Several cables can be used to connect multiple devices. However, no more than 15 devices,
including the controller, can be connected on a single bus.
• When connecting multiple devices, you must assign a unique address to each device.
• Use cables that are 2 m or shorter in length to connect devices.
• Make sure the total length of all cables does not exceed 20 m.
• When devices are communicating, have at least two-thirds of the devices on the bus turned on.
• To connect multiple devices, wire them in a daisy-chain or star configuration as shown below.
You can also mix these configurations. Loop configuration is not allowed.

3-5
IM WT1801-17EN
GP-IB Interface
1
2
3
4
5
6
App
Index
CAUTION
Be sure to turn off the PC and the WT1800 when connecting or removing communication
cables. Otherwise, erroneous operation may result, or the internal circuitry may break.
3.3 Connecting to the GP-IB Interface