Imwt310 17en
Imwt310 17en
Imwt310 17en
IM WT310-17EN
3rd Edition
Thank you for purchasing the WT310, WT310HC, WT332, or WT333 Digital Power Meter. This
Communication Interface User’s Manual explains the following interface features and commands.
• USB interface
• GP-IB interface
• RS-232 interface
• Ethernet interface
To ensure correct use, please read this manual thoroughly before beginning operation.
After reading this manual, keep it in a safe place.
List of Manuals
The following manuals, including this one, are provided as manuals for this instrument. Please read
all manuals.
Manual Title Manual No. Description
WT310/WT310HC/WT332/WT333 IM WT310-01EN The manual explains all features of this instrument,
Digital Power Meter User’s Manual except for the communication interface features, and
how to use them.
WT310/WT310HC/WT332/WT333 IM WT310-02EN Provided as a printed manual. The manual explains
Digital Power Meter the handling precautions and basic operations of this
Getting Started Guide instrument and provides an overview of its features.
WT310/WT310HC/WT332/WT333 IM WT310-17EN This guide. This manual explains the
Digital Power Meter communication interface features of this
Communication Interface User’s Manual instrument and how to use them.
WT310/WT310HC/WT332/WT333 IM WT310-92Z1 Document for China
Digital Power Meter
PDF files of all the manuals above are included in the accompanying CD.
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.
• Safety precautions are provided in the Getting Started Guide, IM WT310-02EN. Be sure to
observe the safety precautions.
• 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 Vista, Windows 7, Windows 8, and
Windows 8.1 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: January 2013
• 2nd Edition: June 2013
• 3rd Edition: January 2016
IM WT310-17EN i
About the USB Interface and Ethernet Interface
• To use the USB communication features, your PC must have the following:
• Library of this instrument (TMCTL)
• USB device driver for connecting this instrument to the PC
• To use the Ethernet communication features, your PC must have the following:
• Library of this instrument (TMCTL)
You can download the library and driver from the following web page.
http://tmi.yokogawa.com/
If you install WTViewerFreePlus in your PC, the above library and driver will be installed
automatically.
Sample Programs
You can download sample programs for this instrument from the following web page:
http://tmi.yokogawa.com/
WTViewerFreePlus
WTViewerFreePlus is a dedicated software application for this instrument. It is included in the
accompanying CD.
By using WTViewerFreePlus, you can display measured data on a dedicated window, save
measured data to the PC, and change the settings of this instrument from the PC.
For information on how to install and use WTViewerFreePlus, see the WTViewerFreePlus User’s
Manual, IM 760121-02E.
Example of a Window for Configuring the WT Example of a Window Showing the Measured Data
ii IM WT310-17EN
Conventions Used in This Manual
Notes
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 cause 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.
Units
k Denotes 1000. Example: 100 kHz (frequency)
K Denotes 1024. Example: 720 KB (file size)
IM WT310-17EN iii
How to Use This Manual
Procedure Operations are explained using flowcharts. See the example below for an
explanation of how various operations are indicated. All procedures are written
under the assumption that you are starting operation at the beginning of the
procedure, so you may not need to carry out all the steps in a procedure when
you are changing the settings.
2.
Set, close menu.
4. Press and to set the number.
• When you are making a number positive (no sign) or negative (–) or setting a number, when the
digit in the display that the input will be added to is blank, an underscore flashes at the position
of the digit.
• While you are performing menu operations, to leave the menu display, press HOLD (ESC). All
setting changes that you have confirmed by pressing the SET key will be reflected in the settings.
Explanation This section describes the setup items and the limitations regarding the
procedures.
iv IM WT310-17EN
Contents 1
Chapter 6 Commands
6.1 List of Commands............................................................................................................. 6-1
6.2 AOUTput Group................................................................................................................ 6-5
6.3 COMMunicate group......................................................................................................... 6-7
6.4 DISPlay group................................................................................................................... 6-8
6.5 HARMonics Group.......................................................................................................... 6-10
6.6 HOLD Group....................................................................................................................6-11
6.7 INPut Group.................................................................................................................... 6-12
6.8 INTEGrate Group............................................................................................................ 6-16
6.9 MATH Group................................................................................................................... 6-17
6.10 MEASure Group.............................................................................................................. 6-18
6.11 NUMeric Group............................................................................................................... 6-19
IM WT310-17EN v
Contents
6.12 RATE Group.................................................................................................................... 6-29
6.13 RECall Group.................................................................................................................. 6-30
6.14 STATus group.................................................................................................................. 6-31
6.15 STORe Group................................................................................................................. 6-32
6.16 SYSTem Group............................................................................................................... 6-33
6.17 Common Command Group............................................................................................. 6-34
Appendix
Appendix 1 Error Messages................................................................................................... App-1
Appendix 2 About the IEEE 488.2-1992 Standard................................................................. App-5
Index
vi IM WT310-17EN
Chapter 1 USB Interface
USB Interface
Front Panel 2
INTERFACE key (page 1-4)
Press this key to view the serial number that is used in
USB TMC communication.
6
LOCAL key
Press this key to switch to local mode. In local mode, remote mode
(remote control using communication commands) is cleared, and
key operation becomes possible.
This key is disabled when local lockout (see page 1-2) has been 7
activated by a controller.
Rear Panel 8
App
Index
USB port
This port is for connecting this instrument to a controller (such as
a PC) using a USB cable. For details on how to connect, see
page 1-3.
IM WT310-17EN 1-1
1.2 USB Interface Features and Specifications
Transmission Feature
• This instrument can transmit measured and computed data.
• This instrument can transmit panel setup parameters and the status byte.
• This instrument can transmit error codes when errors occur.
Note
You cannot use the USB interface simultaneously with other interfaces (GP-IB, RS-232, and Ethernet
interfaces).
1-2 IM WT310-17EN
1.3 Connecting to the USB Interface 1
USB Interface
Connection Procedure 2
Connect the cable as shown below.
WT310/WT310HC WT332/WT333
Notes on Connection 6
• Be sure to insert the USB cable connectors firmly into the USB ports.
• If you are connecting multiple devices by using a USB hub, connect this instrument 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 this instrument is turned on until 7
operation becomes available (approximately 20 to 30 seconds). Doing so may damage this
instrument.
• On the WT310 and WT310HC, it is physically impossible to connect a GP-IB cable and a USB
cable at the same time.
8
App
Index
IM WT310-17EN 1-3
1.4 Configuring the USB Settings of This
Instrument
This section explains the following setting for controlling this instrument remotely through a USB
interface:
Procedure
Follow the procedure indicated by the thick lines in the following menu.
Note
• Only use one communication interface: USB, GP-IB, RS-232, or Ethernet. If you send commands
simultaneously from more than one communication interface, this instrument 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.
1-4 IM WT310-17EN
Chapter 2 GP-IB Interface
Front Panel 2
INTERFACE key (page 2-6)
Press this key to set the GP-IB address.
GP-IB Interface
3
LOCAL key 6
Press this key to switch to local mode. In local mode, remote mode
(remote control using communication commands) is cleared, and
key operation becomes possible.
This key is disabled when local lockout (see page 2-3) has been
activated by a controller. 7
Rear Panel
8
App
Index
GP-IB port
This port is for connecting this instrument to a controller (such as a PC)
using a GP-IB cable. For details on how to connect, see page 2-4.
IM WT310-17EN 2-1
2.2 GP-IB Interface Features and Specifications
Transmission Feature
• This instrument can transmit measured and computed data.
• This instrument can transmit panel setup parameters and the status byte.
• This instrument can transmit error codes when errors occur.
Note
Talk-only, listen-only, and controller capabilities are not available.
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 and unlisten on MTA (My Talk Address).
No listen-only capability
Service request SR1 Full service request capability
Remote local RL1 Full remote/local capability
Parallel polling PP0 No parallel polling capability
Device clear DC1 Full device clear capability
Device trigger DT1 Device trigger capability
Controller C0 No controller capability
Electric characteristics E1 Open collector
2-2 IM WT310-17EN
2.2 GP-IB Interface Features and Specifications
GP-IB Interface
• Settings entered in local mode are retained even when this instrument switches to remote mode.
3
When Switching from Remote to Local Mode
When this instrument is in remote mode and you press SHIFT (LOCAL), this instrument switches
to local mode. This key is disabled when local lockout (see page 2-7) has been activated by a
controller. 4
• The REMOTE indicator turns off.
• Key operations are enabled.
• Settings entered in remote mode are retained even when this instrument switches to local mode.
5
Note
You cannot use the GP-IB interface simultaneously with other interfaces (USB and Ethernet interfaces).
App
Index
IM WT310-17EN 2-3
2.3 Connecting to the GP-IB Interface
GP-IB Cable
This instrument is equipped with an IEEE St’d 488-1978 24-pin GP-IB connector. Use a GP-IB
cable that conforms to this standard.
Connection Procedure
Connect the cable as shown below.
WT310/WT310HC WT332/WT333
Notes on Connection
• 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 2.2.
• This instrument may not operate properly if this instrument 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.
• On the WT310 and WT310HC, it is physically impossible to connect a GP-IB cable and a USB
cable at the same time.
2-4 IM WT310-17EN
2.3 Connecting to the GP-IB Interface
1
CAUTION
Be sure to turn off the PC and this instrument before you connect or remove communication
cables. Otherwise, erroneous operation may result, or the internal circuitry may break. 2
GP-IB Interface
3
App
Index
IM WT310-17EN 2-5
2.4 Configuring the GP-IB Settings of This
Instrument
This section explains the following setting for controlling this instrument remotely through a GP-IB
interface:
Procedure
Follow the procedure indicated by the thick lines in the following menu.
2.
Set, close menu.
4. Press and to set the number.
Note
• Only use one communication interface: USB, GP-IB, or Ethernet. If you send commands simultaneously
from more than one communication interface, this instrument will not execute the commands properly.
• When the controller is communicating with this instrument or with other devices through GP-IB, do not
change the address.
• Each device that is connected by GP-IB has its own unique address in the GP-IB system. This address
is used to distinguish between different devices. Therefore, you must assign a unique address to this
instrument when connecting it to a PC or other device.
2-6 IM WT310-17EN
2.5 Responses to Interface Messages 1
GP-IB Interface
• IFC (Interface Clear)
Clears the talker and listener functions. Stops data transmission if it is in progress. 3
• REN (Remote Enable)
Switches between the remote and local modes.
PPC (Parallel Poll Configure) and TCT (Take Control) are not supported. 8
Uni-line Messages
A single control line is used to transmit uni-line messages. The following three types are available.
• IFC (Interface Clear)
• REN (Remote Enable)
• IDY (Identify)
IM WT310-17EN 2-7
2.5 Responses to Interface Messages
Multi-line Messages
Eight data lines are used to transmit multi-line messages. The messages are classified as follows:
• Address Commands
Some address commands are valid when a device is designated as a listener, and some are
valid when it is designated as a talker. The following five commands are available.
• Universal Commands
Universal commands are available to all devices regardless of their listener or talker designation.
The following five commands are available.
• LLO (Local Lockout)
• DCL (Device Clear)
• PPU (Parallel Poll Unconfigure)
• SPE (Serial Poll Enable)
• SPD (Serial Poll Disable)
There are other interface messages: listener-address, talk-address, and secondary commands.
Interface messages
Multi-line Messages
Uni-line
messages Address Universal
commands commands
IFC*
REN* GTL* LLO*
IDY SDC* DCL*
PPC PPU
GET* SPE*
TCT SPD*
Listener Talker 2
Address Address Command
Note
Difference between SDC and DCL
In multi-line messages, SDC messages are those that require talker or listener designation and DCL
messages are those that do not require a designation. Therefore, SDC messages are directed at a particular
instrument while DCL messages are directed at all instruments on the bus.
2-8 IM WT310-17EN
Chapter 3 RS-232 Interface
Front Panel 2
INTERFACE key (page 3-5)
Press this key to set the handshaking, data format,
baud rate, or terminator.
RS-232 Interface
4
6
LOCAL key
Press this key to switch to local mode. In local mode, remote mode
(remote control using communication commands) is cleared, and
key operation becomes possible.
This key is disabled when local lockout (see page 3-2) has been 7
activated by a controller.
Rear Panel 8
App
Index
RS-232 connector
This port is for connecting this instrument to a controller (such as a PC)
using an RS-232 cable. For details on how to connect, see page 3-4.
IM WT310-17EN 3-1
3.2 RS-232 Interface Features and Specifications
Transmission Feature
• This instrument can transmit measured and computed data.
• This instrument can transmit panel setup parameters and the status byte.
• This instrument can transmit error codes when errors occur.
Note
You cannot use the RS-232 interface simultaneously with other communication interfaces (USB and Ethernet
interfaces).
3-2 IM WT310-17EN
3.3 Connecting to the RS-232 Interface 1
To connect this instrument to a PC, use an interface cable that is compatible with this instrument 2
specifications. Be sure to align the handshaking, data transfer rate, data format, and so on with the
PC. For the settings, see section 3.4.
RS-232 Interface
WT310/WT310HC WT332/WT333
1 2 3 4 5
1 4
6
2
7
3
8 4
6 7 8 9 9
5 5
DELC-J9PAF-13L6 or equivalent
App
3 2 7 8 5
(2) (3) (4) (5) (7)
Signal Direction
The following figure shows the directions of the signals of this instrument RS-232 interface.
RS [Request to send] 7
CS [Clear to send] 8 This
PC
SD [Send data] 3 instrument
RD [Receive data] 2
IM WT310-17EN 3-3
3.3 Connecting to the RS-232 Interface
Connection Procedure
Connect the cable as shown below.
WT310/WT310HC WT332/WT333
3-4 IM WT310-17EN
3.4 Configuring the RS-232 Settings of This 1
Instrument
This section explains the following setting for controlling this instrument remotely through a RS-232
2
interface:
Procedure
Follow the procedure indicated by the thick lines in the following menu.
3
RS-232 Interface
Select the
communication function. Set the handshaking. Set the data format.
1. (Display B) 3. 5. 7.
(Display A) (Display B)
4
2. 4. 6.
8
Note
Only use one communication interface: USB, RS-232, or Ethernet. If you send commands simultaneously
from more than one communication interface, this instrument will not execute the commands properly.
App
Index
IM WT310-17EN 3-5
3.4 Configuring the RS-232 Settings of This Instrument
Explanation
Handshaking
To use the RS-232 interface to communicate with a PC, the devices on both sides must negotiate a
set of rules to ensure the proper transfer of data. This negotiation is called handshaking. Because
there are many handshaking methods that can be used between this instrument and the PC, you
must make sure that the same method is chosen by both this instrument and the PC.
OFF-OFF
Data Transmission Control
There is no handshaking between this instrument and the PC. The “X-OFF” and “X-ON” signals are
treated as data, and the CS signal is ignored.
XON-XON
Data Transmission Control
Software handshaking is performed between this instrument and the PC. When this instrument
receives an “X-OFF” code from the PC while it is sending data, it stops the data transmission. It
resumes the operation when it receives a “X-ON” code. The CS signal received from the PC is
ignored.
3-6 IM WT310-17EN
3.4 Configuring the RS-232 Settings of This Instrument
CS-RS 1
Data Transmission Control
Hardware handshaking is performed between this instrument and the PC. If CS is set to false while
this instrument is sending data, it stops the data transmission. Then, if CS is set to true, it resumes 2
the operation. The “X-OFF” and “X-ON” signals are treated as data.
RS-232 Interface
192 bytes, this instrument sets RS to true.
Note Index
You must design PC programs so that the receive buffers of both this instrument and PC do not become full.
IM WT310-17EN 3-7
3.4 Configuring the RS-232 Settings of This Instrument
Data Format
The RS-232 interface of this instrument performs communication using start-stop synchronization.
In start-stop synchronization, characters are transmitted one at a time. Each character consists of a
start bit, data bits, a parity bit, and a stop bit (see the following figure).
Select the data length and parity stop bit from the following options.
8-NO-1, 7-EVEN-1, 7-ODD-1, 7-NO-2
Baud rate
Select from the following baud rates.
1200, 2400, 4800, 9600, 19200, 38400, 57600
Terminator
Select the terminator to use when sending data from this instrument.
Cr, Lf, Cr+Lf
Use “LF” or “Cr+Lf” for the terminator when sending data to this instrument.
3-8 IM WT310-17EN
Chapter 4 Ethernet Interface
Front Panel 2
UTILITY key (page 4-4)
Press this key to configure TCP/IP settings.
Ethernet Interface
5
LOCAL key 6
Press this key to switch to local mode. In local mode, remote mode
(remote control using communication commands) is cleared, and
key operation becomes possible.
This key is disabled when local lockout (see page 4-2) has been
activated by a controller. 7
Rear Panel
8
App
Index
Ethernet port
This port is for connecting this instrument to a controller (such as a PC)
using an Ethernet cable. For details on how to connect, see page 4-3.
IM WT310-17EN 4-1
4.2 Ethernet Interface Features and Specifications
Transmission Feature
• This instrument can transmit measured and computed data.
• This instrument can transmit panel setup parameters and the status byte.
• This instrument can transmit error codes when errors occur.
Note
You cannot use the Ethernet interface simultaneously with other interfaces (GP-IB, RS-232, and USB).
4-2 IM WT310-17EN
4.3 Connecting to the Ethernet Interface 1
Connection Procedure 2
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 rear panel of this instrument.
WT310/WT310HC
PC 4
Ethernet Interface
5
WT332/WT333
Network card
6
UTP or STP cable
(straight cable)
WT310/WT310HC WT332/WT333 7
8
Ethernet port
App
Notes on Connection
• To connect this instrument 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.
IM WT310-17EN 4-3
4.4 Configuring the Ethernet Settings of This
Instrument
This section explains the following setting for remotely controlling this instrument via the Ethernet
interface:
Procedure
Follow the procedure indicated by the thick lines in the following menu.
Select Ethernet.
1. (Display B)
2.
Select DHCP.
3. (Display B) 5. (Display C) 7. 8.
4. 6.
Confirm the setting. Close menu.
7.
(User settings)
Select IP address.
(Display B)
Set the IP address. Set the IP address.
8. 9. (Display C) 12. (Display D) 15.
18. 21.
Same as step 10 and 11 Same as step 10 and 11
19. 22.
24.
26. 29.
Same as step 10 and 11 Same as step 10 and 11
27. 30.
Select to apply the settings.
(Display B)
32.
Close menu.
4-4 IM WT310-17EN
4.4 Configuring the Ethernet Settings of This Instrument
Note 1
Only use one communication interface: USB, GP-IB, RS-232, or Ethernet. If you send commands
simultaneously from more than one communication interface, this instrument will not execute the commands
properly.
2
You can view the IP address that has been assigned by the DHCP server or the IP address that you
specified by following the procedure below.
Select the
communication function.
3
1. (Display B)
or
2.
Displays C and D
3.
4
show the IP address. Close menu.
Ethernet Interface
Explanation
5
Configuring the TCP/IP Settings
To use the Ethernet interface, you must specify TCP/IP settings.
6
DHCP
DHCP is a protocol that temporarily allocates necessary information to a device so that it can
connect to the Internet. 7
ON
If you are connecting this instrument to a network with a DHCP server, you can turn on the DHCP
setting. If you do, the IP address will be automatically assigned to this instrument when it is
connected to the network, so you do not have to set the address. 8
OFF
If you set DHCP to OFF, set the appropriate IP address, subnet mask, and default gateway for your
network. App
IM WT310-17EN 4-5
Chapter 5 Programming Overview
5.1 Messages 1
Messages ,
Programming Overview
The program message format is shown below. For details, see page 5-6.
;
Example :INPut:CFACtor 3<PMT> 6
<Program message unit> <PMT>
Header Data
IM WT310-17EN 5-1
5.1 Messages
5-2 IM WT310-17EN
5.2 Commands 1
Commands
There are three types of commands (program headers) Example A portion of the commands from the 2
that a controller may send to this instrument. The integration command group
:INTEGrate?
commands differ in their program header formats.
:INTEGrate:MODE
:INTEGrate:TIMer 3
Common Command Header
:INTEGrate:STARt
Commands that are defined in IEEE 488.2-1992 are
:INTEGrate:STOP
called common commands. The common command
:INTEGrate:RESet
header syntax is shown below. Be sure to include an 4
asterisk (*) at the beginning of a common command. • When Concatenating Commands of the Same
* <Mnemonic> ? Group
This instrument stores the hierarchical level of the
Common command example: *CLS command that is currently being executed and 5
processes the next command on the assumption
Programming Overview
Compound Header that it belongs to the same level. Therefore,
Commands, other than common commands, that are
specific to this instrument are classified and arranged
the common header section can be omitted for
6
commands that belong to the same group.
in a hierarchy according to their functions. The Example :INTEGrate:MODE NORMal;
compound header syntax is shown below. Be sure to TIMer 1,0,0<PMT>
use a colon to specify a lower hierarchical level.
• When Concatenating Commands of Different
7
:
Groups
: <Mnemonic> ? If the subsequent command does not belong to the
same group, place a colon in front of the header (this 8
Compound header example: :INPut:MODE colon cannot be omitted).
Example :INTEGrate:MODE NORMal;:INPut:
Simple Header MODE RMS<PMT>
These commands are functionally independent and are
• When Concatenating Simple Headers
App
not contained within a hierarchy. The format of a simple
If a simple header follows another command, place
header is shown below.
a colon in front of the simple header (this colon
: <Mnemonic> ?
cannot be omitted). Index
Example :INTEGrate:MODE NORMal;:HOLD
Simple header example: :HOLD
ON<PMT>
IM WT310-17EN 5-3
5.2 Commands
Upper-level Query
An upper-level query is a query that is made by
appending a question mark to a command higher in the
group. The controller can receive all of the settings in
a group collectively by executing a highest-level query.
Some query groups which are comprised of more than
three hierarchical levels can output all the lower level
settings.
Example :INTEGrate?<PMT> -> :INTEGRATE
:MODE NORMAL;TIMER 0,0,0<RMT>
5-4 IM WT310-17EN
5.3 Responses 1
Response
When the controller sends a message unit that has 2
a question mark in its program header (a query), this
instrument returns a response message to the query.
This instrument returns response messages in one of
3
the following two forms.
Programming Overview
Responses that cannot be used as program
messages unless changes are made (query-only
commands) are returned without headers. However,
6
there are query-only commands whose responses
this instrument will attach headers to.
Example INTEGrate:STATe?<PMT> -> 7
RESET<RMT>
Abbreviated Form
This instrument normally returns response headers with
Index
the lower-case section removed. You can configure this
instrument so that full headers are returned. Use the
COMMunicate:VERBose command for this purpose.
The sections enclosed in square brackets ([ ]) are also
omitted in the abbreviated form.
IM WT310-17EN 5-5
5.4 Data
Data
Data contains conditions and values that are written • If a value has more significant digits than are
after the header. A space separates the data from the available, the value will be rounded.
header. Data is classified as follows:
<Voltage>, <Current>, and <Time>
Data Description
<Voltage>, <Current>, and <Time> indicate decimal
<Decimal> A value expressed in decimal notation
(Example: VT ratio setting values that have physical significance. A <Multiplier> or
->[:INPut]:SCALing:VT 100) <Unit> can be attached to the form that was described
<Voltage><Current> A physical value earlier. The following types of expressions are possible.
<Time> (Example: Voltage range setting
->[:INPut]:VOLTage:RANge 150V) Form Example
<Register> A register value expressed as binary, octal, <NRf><Multiplier><Unit> 5MV
decimal, or hexadecimal <NRf><Unit> 5E-3V
(Example: Extended event register value <NRf><Multiplier> 5M
->:STATUS:EESE #HFE) <NRf> 5E-3
<Character data> Predefined character string (mnemonic).
Select from the available strings in braces. <Multiplier>
(Example: Measurement mode selection
->[:INPut]:MODE {RMS|VMEan|DC})
Multipliers that you can use are indicated in the
<Boolean> Indicates on and off. Specify ON, OFF, or a following table.
value.
(Example: Turning data hold on Symbol Word Multiplier
->:HOLD ON) EX Exa 1018
<String data> An arbitrary character string PE Peta 1015
(Example: Model code response T Tera 1012
->:SYSTEM:MODEL "WT310") G Giga 109
<Block data> Data that contains 8-bit values MA Mega 106
(Example: Measured data (binary format) K Kilo 103
response M Milli 10–3
-> #40012ABCDEFGHIJKL) U Micro 10–6
N Nano 10–9
P Pico 10–12
<Decimal>
F Femto 10–15
<Decimal> indicates a value expressed as a decimal
number, as shown in the table below. Decimal values <Unit>
are written in the NR form as specified in ANSI Units that you can use are indicated in the following
X3.42-1975. table.
Symbol Meaning Example Symbol Word Meaning
<NR1> Integer 125 -1 +1000 V Volt Voltage
<NR2> Fixed-point number 125.0 -.90 +001. A Ampere Current
<NR3> Floating-point number 125.0E+0 -9E-1 +.1E4 S Second Time
<NRf> Any of the forms <NR1> to <NR3>
• <Multiplier> and <Unit> are not case sensitive.
• This instrument can receive decimal values that are • “U” is used to indicate micro (”μ”).
sent from the controller in any of the forms <NR1> • “MA” is used for Mega to distinguish it from Milli.
to <NR3>. This is expressed as <NRf>. However, “MA” is interpreted as milliampere for
• This instrument returns a response to the controller current.
in one of the forms from <NR1> to <NR3> • If both <Multiplier> and <Unit> are omitted, the basic
depending on the query. The same form is used unit (V, A, or S) is used.
regardless of the size of the value. • Response messages are always expressed in the
• For the <NR3> form, the plus sign after the “E” can <NR3> form. Additionally, they are returned in the
be omitted. You cannot omit the minus sign. basic form, without a multiplier or unit attached.
• If a value outside the range is entered, the value is
adjusted to the closest value within the range.
5-6 IM WT310-17EN
5.4 Data
Programming Overview
data (a mnemonic). It is mainly used to indicate options Form Example
and is chosen from the character strings given in { }. #N<N-digit decimal number> #800000010ABCDEFGHIJ
The data interpretation rules are the same as those <Data byte sequence> 6
described in “Header Interpretation Rules” on page
• #N
5-4.
Indicates that the data is <Block data>. N indicates
Form Example the number of succeeding data bytes (digits) in 7
{RMS|VMEan|DC} RMS
ASCII code.
• <N-digit decimal number>
• As with the header, the COMMunicate:VERBose
Indicates the number of bytes of data (example:
command can be used to select whether to return
00000010 = 10 bytes).
8
the response in the full form or in the abbreviated
• <Data byte sequence>
form.
Expresses the actual data (example: ABCDEFGHIJ).
• The COMMunicate:HEADer setting does not affect
• Data is comprised of 8-bit values (0 to 255). This App
<Character data>.
means that the ASCII code “0AH,” which stands for
“NL,” can also be included in the data. Hence, care
<Boolean>
must be taken when programming the controller.
<Boolean> is data that indicates ON or OFF. The
following types of expressions are possible. Index
Form Example
{ON|OFF|<NRf>} ON OFF 1 0
<String Data>
<String data> is not a specified character string like
<Character data>. It is an arbitrary character string.
The character string must be enclosed in single
quotation marks (') or double quotation marks (").
Form Example
<String data> 'ABC' "IEEE488.2-1992"
IM WT310-17EN 5-7
5.5 Synchronization with the Controller
5-8 IM WT310-17EN
Chapter 6 Commands
COMMunicate group
:COMMunicate? Queries all communication settings. 6-7 5
:COMMunicate:HEADer Sets or queries whether headers are attached to query responses. 6-7
:COMMunicate:LOCKout Sets/clears local lockout. 6-7
:COMMunicate:REMote Sets this instrument to remote or local mode. ON is remote mode. 6-7
:COMMunicate:STATus?
:COMMunicate:VERBose
Queries the line-specific status. 6-7 6
Sets or queries whether the response to a query is returned fully spelled out 6-7
or in its abbreviated form.
Commands
:COMMunicate:WAIT Waits for a specified extended event to occur. 6-7
:COMMunicate:WAIT? Creates the response that is returned when a specified extended event 6-7
occurs. 7
DISPlay group
:DISPlay? Queries all display settings. 6-8
:DISPlay:NORMal? Queries all normal measurement data display settings. 6-8 8
:DISPlay[:NORMal]:ITEM<x> Sets or queries a normal measurement data display item. 6-8
:DISPlay:HARMonics? Queries all harmonic measurement data display settings. 6-8
:DISPlay:HARMonics:ITEM<x> Sets or queries a harmonic measurement data display item. 6-8
App
HARMonics Group
:HARMonics? Queries all harmonic measurement settings. 6-10
:HARMonics:PLLSource Sets or queries the PLL source. 6-10
:HARMonics:ORDer Sets or queries the maximum and minimum harmonic orders that are 6-10
analyzed.
Index
:HARMonics:THD Sets or queries the equation used to compute the THD (total harmonic 6-10
distortion).
:HARMonics:DISPlay? Queries all harmonic measurement display settings. 6-10
:HARMonics:DISPlay[:STATe] Sets or queries the on/off state of harmonic measurement data display. 6-10
:HARMonics:DISPlay:ORDer Sets or queries the harmonic order of the harmonic component that is shown 6-10
in display B for the harmonic measurement data display.
HOLD Group
:HOLD Sets or queries the on/off state of the output hold feature for display, 6-11
communication, and other types of data.
INPut Group
:INPut? Queries all input settings. 6-12
[:INPut]:CFACtor Sets or queries the crest factor. 6-12
[:INPut]:WIRing Sets or queries the wiring system. 6-12
[:INPut]:MODE Sets or queries the voltage and current measurement mode. 6-12
[:INPut]:VOLTage? Queries all voltage measurement settings. 6-12
[:INPut]:VOLTage:RANGe Sets or queries the voltage range. 6-12
[:INPut]:VOLTage:AUTO Sets or queries the voltage auto range on/off state. 6-12
[:INPut]:VOLTage:CONFig Sets or queries the valid voltage range. 6-12
IM WT310-17EN 6-1
6.1 List of Commands
Command Function Page
[:INPut]:VOLTage:POJump Sets or queries the jump destination range that is used when a voltage peak 6-13
over-range occurs.
[:INPut]:CURRent? Queries all electric current measurement settings. 6-13
[:INPut]:CURRent:RANGe Sets or queries the current range. 6-13
[:INPut]:CURRent:AUTO Sets or queries the current auto range on/off state. 6-13
[:INPut]:CURRent:CONFig Sets or queries the valid current range. 6-13
[:INPut]:CURRent:POJump Sets or queries the jump destination range that is used when a current peak 6-13
over-range occurs.
[:INPut]:CURRent:EXTSensor: Sets or queries the valid external current sensor range. 6-13
CONFig
[:INPut]:CURRent:EXTSensor: Sets or queries the jump destination range that is used when a current peak 6-14
POJump over-range occurs.
[:INPut]:CURRent:SRATio? Queries the external current sensor conversion ratios of all elements. 6-14
[:INPut]:CURRent:SRATio[:ALL] Collectively sets the external current sensor conversion ratios of all elements. 6-14
[:INPut]:CURRent:SRATio: Sets or queries the external current sensor conversion ratio of the specified 6-14
ELEMent<x> element.
[:INPut]:RCONfig Sets or queries the on/off state of the range configuration (valid range 6-14
selection) feature.
[:INPut]:SCALing? Queries all scaling settings. 6-14
[:INPut]:SCALing[:STATe] Sets or queries the scaling on/off state. 6-14
[:INPut]: Queries the VT ratios, CT ratios, or power coefficients of all elements. 6-14
SCALing:{VT|CT|SFACtor}?
[:INPut]: Collectively sets the VT ratio, CT ratio, or power coefficient of all elements. 6-14
SCALing:{VT|CT|SFACtor}[:ALL]
[:INPut]: Sets or queries the VT ratio, CT ratio, or power coefficient of the specified 6-14
SCALing:{VT|CT|SFACtor}: element.
ELEMent<x>
[:INPut]:SYNChronize Sets or queries the synchronization source. 6-14
[:INPut]:FILTer? Queries all input filter settings. 6-15
[:INPut]:FILTer:LINE Sets or queries the line filter. 6-15
[:INPut]:FILTer:FREQuency Sets or queries the frequency filter. 6-15
[:INPut]:POVer? Queries the peak over-range information. 6-15
[:INPut]:CRANge? Sets or queries the check range status. 6-15
INTEGrate Group
:INTEGrate? Queries all integration settings. 6-16
:INTEGrate:MODE Sets or queries the integration mode. 6-16
:INTEGrate:TIMer Sets or queries the integration timer value. 6-16
:INTEGrate:STARt Starts integration. 6-16
:INTEGrate:STOP Stops integration. 6-16
:INTEGrate:RESet Resets the integrated value. 6-16
:INTEGrate:STATe? Queries the integration status. 6-16
MATH Group
:MATH Sets or queries the MATH equation. 6-17
MEASure Group
:MEASure? Queries all measured and computed data output settings. 6-18
:MEASure:AVERaging? Queries all averaging settings. 6-18
:MEASure:AVERaging[:STATe] Sets or queries the on/off state of averaging. 6-18
:MEASure:AVERaging:TYPE Sets or queries the averaging type. 6-18
:MEASure:AVERaging:COUNt Sets or queries the averaging coefficient. 6-18
:MEASure:MHOLd Sets the MAX hold on/off state. 6-18
6-2 IM WT310-17EN
6.1 List of Commands
Command Function Page
1
NUMeric Group
:NUMeric? Queries all numeric data output settings. 6-19
:NUMeric:FORMat Sets or queries the numeric data format. 6-19
:NUMeric:NORMal? Queries all numeric data output settings. 6-19 2
:NUMeric[:NORMal]:VALue? Queries the numeric data. 6-19
:NUMeric[:NORMal]:NUMber Sets or queries the number of numeric data items that are transmitted by the 6-19
:NUMeric[:NORMal]:VALue? command.
:NUMeric[:NORMal]:ITEM<x> Sets or queries the specified numeric data output item (function, element, 6-20
and harmonic order). 3
:NUMeric[:NORMal]:PRESet Presets the numeric data output item pattern. 6-20
:NUMeric[:NORMal]:CLEar Clears numeric data output items (sets the items to NONE). 6-20
:NUMeric[:NORMal]:DELete Deletes numeric data output items. 6-20
:NUMeric[:NORMal]:HEADer? Queries the numeric data header. 6-20 4
:NUMeric:LIST? Queries all harmonic measurement numeric list data output settings. 6-21
:NUMeric:LIST:VALue? Queries the harmonic measurement numeric list data. 6-21
:NUMeric:LIST:NUMber Sets or queries the number of numeric list data items that are transmitted by 6-21
:NUMeric:LIST:VALue?.
:NUMeric:LIST:ORDer Sets or queries the maximum output harmonic order of the harmonic 6-21 5
measurement numeric list data.
:NUMeric:LIST:SELect Sets or queries the output components of the harmonic measurement 6-21
numeric list data.
:NUMeric:LIST:ITEM<x> Sets or queries the output item (function and element) of the specified 6-22 6
harmonic measurement numeric list data item.
:NUMeric:LIST:PRESet Presets the harmonic measurement numeric list data output item pattern. 6-22
Commands
:NUMeric:LIST:CLEar Clears harmonic measurement numeric list data output items (sets the items 6-22
to NONE).
:NUMeric:LIST:DELete Deletes harmonic measurement numeric list data output items. 6-22 7
:NUMeric:HOLD Sets or queries the on/off (hold/release) status of the numeric data hold 6-23
feature.
RATE Group 8
:RATE Sets or queries the data update interval. 6-29
RECall Group
:RECall:NUMber? Queries the number of blocks of measured data that is stored. 6-30 App
:RECall[:NORMal]:VALue? Queries the numeric data at the specified block number. 6-30
:RECall:LIST:VALue? Queries the numeric list data of harmonic measurement at the specified 6-30
block number.
:RECall:PANel Loads a setup parameter file. 6-30
Index
STATus group
:STATus? Queries all the settings for the communication status feature. 6-31
:STATus:CONDition? Queries the contents of the condition register. 6-31
:STATus:EESE Sets or queries the extended event enable register. 6-31
:STATus:EESR? Queries the contents of the extended event register and clears the register. 6-31
:STATus:ERRor? Queries the error code and message of the last error that has occurred (top 6-31
of the error queue).
:STATus:FILTer<x> Sets or queries the transition filter. 6-31
:STATus:QENable Sets or queries whether messages other than errors will be stored to the 6-31
error queue (ON) or not (OFF).
:STATus:QMESsage Sets or queries whether message information will be attached to the 6-31
response to the STATus:ERRor? query (ON/OFF).
:STATus:SPOLl? Executes serial polling. 6-31
IM WT310-17EN 6-3
6.1 List of Commands
Command Function Page
STORe Group
:STORe? Queries all storage settings. 6-32
:STORe[:STATe] Sets or queries the storage on/off state. 6-32
:STORe:INTerval Sets or queries the storage interval. 6-32
:STORe:PANel Saves setup parameters to a file. 6-32
SYSTem Group
:SYSTem? Queries all system settings. 6-33
:SYSTem:MODel? Queries the model code. 6-33
:SYSTem:SUFFix? Queries the suffix code. 6-33
:SYSTem:SERial? Queries the serial number. 6-33
:SYSTem:VERsion[:FIRMware]? Queries the firmware version. 6-33
:SYSTem:KLOCk Sets or queries the on/off state of the key protection. 6-33
:SYSTem:RESolution Sets or queries the numeric data display resolution. 6-33
:SYSTem:COMMunicate:COMMand Sets or queries the command type. 6-33
:SYSTem:COMMunicate:ETHernet: Sets or queries the Ethernet MAC address. 6-33
MACaddress?
6-4 IM WT310-17EN
Chapter 6 Commands
:AOUTput? :AOUTput[:NORMal]:IRTime 3
Function Queries all D/A output settings. Function
Sets or queries the rated integration time that is
Syntax :AOUTput? used in the D/A output of the integrated value.
Syntax :AOUTput[:NORMal]:IRTime
:AOUTput[:NORMal]:PRESet {<NRf>,<NRf>,<NRf>} 4
Function Sets the D/A output items to their default values. :AOUTput[:NORMal]:IRTime?
Syntax :AOUTput[:NORMal]:PRESet {<NRf>,<NRf>,<NRf>} = 0,0,0 to
{NORMal|INTEGrate} 10000,0,0
Example :AOUTPUT:NORMAL:PRESET NORMAL First <NRf> = 0 to 10000 (hour) 5
Second <NRf> = 0 to 59 (minute)
:AOUTput[:NORMal]:CHANnel<x> Third <NRf> = 0 to 59 (second)
Function Sets or queries a D/A output item (function or Example :AOUTPUT:NORMAL:IRTIME 1,0,0
element). :AOUTPUT:NORMAL:IRTIME? 6
Syntax :AOUTput[:NORMal]:CHANnel<x> {NONE| -> :AOUTPUT:IRTIME 1,0,0
Commands
<Function>[,<Element>]}
:AOUTput[:NORMal]:CHANnel<x>? :AOUTput[:NORMal]:MODE<x>
<x> = 1 to 12 (output channel) Function Sets or queries a D/A range mode. 7
NONE = no output item Syntax :AOUTput[:NORMal]:MODE<x> {FIXed|
<Function> = {U|I|P|S|Q|LAMBda| MANual|COMPare}
PHI|FU|FI|WH|WHP|WHM|AH|AHP| :AOUTput[:NORMal]:MODE<x>?
AHM|MATH|UPeak|IPeak} <x> = 1 to 12 (output channel) 8
<Element> = {<NRf>|SIGMa} Example :AOUTPUT:NORMAL:MODE1 FIXED
(<NRf> = 1 to 3) :AOUTPUT:NORMAL:MODE1?
Example :AOUTPUT:NORMAL:CHANNEL1 U,1 -> :AOUTPUT:NORMAL:MODE1 FIXED
:AOUTPUT:NORMAL:CHANNEL1? Description • This command is supported by firmware App
-> :AOUTPUT:NORMAL:CHANNEL1 U,1 version 1.04 or later.
Description • For details on <Function>, see “Function • FIXed = Fixed range mode (default value)
Option List (1)” on page 6-24. Outputs +5 V when the rated value of each
• If <Element> is omitted, the element is set to 1. measurement function is received. Index
• For {MATH}, <Element> does not need to be • MANual = Manual range mode
specified. In responses, <Element> is omitted. The displayed values of the measurement
function when +5 V and –5 V are output as D/A
output can be set to any values of your choice.
This enables the D/A output to be expanded or
reduced for each channel (D/A zoom).
• COMPare = Comparator mode
By comparing with the comparator limits, this
instrument outputs +5 V, 0 V, or –5 V. Relay
contact output, like that of the WT210/WT230,
can be emulated by driving a relay with the
output voltage.
IM WT310-17EN 6-5
6.2 AOUTput Group
:AOUTput[:NORMal]:RATE<x>
Function Sets or queries the maximum and minimum
values for when the D/A output is in manual
range mode. Sets or queries the comparison
upper and lower limits for when the D/A output is
in comparator mode.
Syntax :AOUTput[:NORMal]:RATE<x>
{<NRf>,<NRf>}
:AOUTput[:NORMal]:RATE<x>?
<x> = 1 to 12 (output channel)
<Element> = {<NRf>|SIGMA}
<NRf> = -9.999E+12 to 9.999E+12
Example :AOUTPUT:NORMAL:RATE1 100,-100
:AOUTPUT:NORMAL:RATE1?
-> :AOUTPUT:NORMAL:RATE1 100.0E+00,
-100.0E+00
Description • This command is supported by firmware
version 1.04 or later.
• When the D/A output is in manual range mode
(:AOUTput[:NORMal]:MODE<x> MANual)
Set the rated value for +5 V output and then
that for –5 V output.
• When the D/A output is in comparator mode
(:AOUTput[:NORMal]:MODE<x> COMPare)
Set the upper limit and then the lower limit.
• When the D/A output is in fixed range mode
(:AOUTput[:NORMal]:MODE<x> FIXed)
There is no need to set these values. (The
values do not affect the output operation.)
6-6 IM WT310-17EN
6.3 COMMunicate group 1
Commands
Syntax :COMMunicate:WAIT <Register>
:COMMunicate:LOCKout <Register> = 0 to 65535 (extended event register,
Function Sets/clears local lockout. see page 7-5) 7
Syntax :COMMunicate:LOCKout {<Boolean>} Example :COMMUNICATE:WAIT 1
:COMMunicate:LOCKout? Description For information about how to synchronize a
Example :COMMUNICATE:LOCKOUT ON program using COMMunicate:WAIT, see page
:COMMUNICATE:LOCKOUT? 5-8. 8
-> :COMMUNICATE:LOCKOUT 1
:COMMunicate:WAIT?
:COMMunicate:REMote Function Creates the response that is returned when a
Function Sets this instrument to remote or local mode. ON specified extended event occurs. App
is remote mode. Syntax :COMMunicate:WAIT? <Register>
Syntax :COMMunicate:REMote {<Boolean>} <Register> = 0 to 65535 (extended event
:COMMunicate:REMote? register; see page 7-5.)
Example :COMMUNICATE:REMOTE ON Example :COMMUNICATE:WAIT? 65535 -> 1 Index
:COMMUNICATE:REMOTE?
-> :COMMUNICATE:REMOTE 1
:COMMunicate:STATus?
Function Queries the line-specific status.
Syntax :COMMunicate:STATus?
Example :COMMUNICATE:STATUS?
-> 0
Description The meaning of each status bit is as follows:
Bit RS-232
0 Parity error
1 Framing error
2 Break character detection
3 and higher Always zero
When an event occurs, the corresponding bit
is set in the status. When the bit is read, it is
cleared.
Zero is returned for interfaces other than RS-232.
IM WT310-17EN 6-7
6.4 DISPlay group
The commands in this group deal with the display.
You can make the same settings and queries that you can by using keys such as the FUNCTION and ELEMENT
keys on the front panel.
:DISPlay? :DISPlay:HARMonics?
Function Queries all display settings. Function
Queries all harmonic measurement data display
Syntax :DISPlay? settings.
Syntax :DISPlay:HARMonics?
:DISPlay:NORMal?
Function
Queries all normal measurement data display :DISPlay:HARMonics:ITEM<x>
settings. Function Sets or queries a harmonic measurement data
Syntax :DISPlay:NORMal? display item.
Syntax :DISPlay:HARMonics:ITEM<x>
:DISPlay[:NORMal]:ITEM<x> {<Function>[,<Element>]}
Function Sets or queries a normal measurement data :DISPlay:HARMonics:ITEM<x>?
display item. <x> = 1 to 4 (display)
Syntax :DISPlay[:NORMal]:ITEM<x> <Function> Function of display A (<x>=1)
[,<Element>]} <Function> = {U|I|P|ORDer}
:DISPlay[:NORMal]:ITEM<x>? Function of display B (<x>=2)
<x> = 1 to 4 (display) <Function> = {U|I|P|UHDF|IHDF|PHDF|
Function of display A (<x>=1) PHIU|PHII}
<Function> = {U|I|P|S|Q|TIME} Function of display C (<x>=3)
Function of display B (<x>=2) <Function> = {U|I|P}
<Function> = {U|I|P|LAMBda|PHI} Function of display D (<x>=4)
Function of display C (<x>=3) <Function> = {U|I|P|LAMBda|FU|FI|
<Function> = {U|I|P|UPPeak|UMPeak| UTHD|ITHD}
IPPeak|IMPeak|PPPeak|PMPeak|WH| <Element> = {<NRf>} (<NRf> = 1 to 3)
WHP|WHM|AH|AHP|AHM|MATH} Example :DISPLAY:HARMONICS:ITEM2 I,1
Function of display D (<x>=4) :DISPLAY:HARMONICS:ITEM2?
<Function> = {U|I|P|LAMBda|FU|FI| -> :DISPLAY:HARMONICS:ITEM2 I,1
UTHD|ITHD} Description • For details on <Function>, see “Numeric Data
<Element> = {<NRf>|SIGMa} Display Functions” on the next page.
(<NRf> = 1 to 3) • If <Element> is omitted, the element is set to 1.
Example :DISPLAY:NORMAL:ITEM1 U,1 • For {ORDer}, <Element> does not need to be
:DISPLAY:NORMAL:ITEM1? specified. In responses, <Element> is omitted.
-> :DISPLAY:NORMAL:ITEM1 U,1
Description • For details on <Function>, see “Numeric Data
Display Functions” on the next page.
• If <Element> is omitted, the element is set to 1.
• For {TIME|MATH}, <Element> does not need
to be specified. In responses, <Element> is
omitted.
• {UTHD|ITHD} can be selected only on models
with the harmonic measurement (/G5) option.
6-8 IM WT310-17EN
6.4 DISPlay group
Commands
WHP Positive watt hour WP+ [W h±] Yes Yes
WHM Negative watt hour WP- [W h±] Yes Yes
AH Ampere hour q [A h] Yes Yes 7
AHP Positive ampere hour q+ [A h±] Yes Yes
AHM Negative ampere hour q- [A h±] Yes Yes
MATH Computed value, such as efficiency [MATH] No Yes
UTHD Total harmonic distortion of voltage Uthd [THD V %] Yes Yes
ITHD Total harmonic distortion of current Ithd [THD A %] Yes Yes
8
Yes: Required. No: Not required.
IM WT310-17EN 6-9
6.5 HARMonics Group
The commands in this group deal with harmonic measurement.
You can make the same settings and queries that you can make by pressing HARMONICS on the front panel.
The commands in this group are valid only on models with the harmonic measurement (/G5) option.
:HARMonics? :HARMonics:DISPlay[:STATe]
Function Queries all harmonic measurement settings. Function Sets or queries the on/off state of harmonic
Syntax :HARMonics? measurement data display.
Syntax :HARMonics:DISPlay[:STATe]
:HARMonics:PLLSource {<Boolean>}
Function Sets or queries the PLL source. :HARMonics:DISPlay:STATe?
Syntax :HARMonics:PLLSource {U<x>|I<x>} Example :HARMONICS:DISPLAY:STATE ON
:HARMonics:PLLSource? :HARMONICS:DISPLAY:STATE?
<x> = 1 to 3 (element) -> :HARMONICS:DISPLAY:STATE 1
Example :HARMONICS:PLLSOURCE U1
:HARMONICS:PLLSOURCE? :HARMonics:DISPlay:ORDer
-> :HARMONICS:PLLSOURCE U1 Function Sets or queries the harmonic order of the
harmonic component that is shown in display B
:HARMonics:ORDer for the harmonic measurement data display.
Function Sets or queries the maximum and minimum Syntax :HARMonics:DISPlay:ORDer {<NRf>}
harmonic orders that are analyzed. :HARMonics:DISPlay:ORDer?
Syntax :HARMonics:ORDer {<NRf>,<NRf>} <NRf> = 1 to 50 (harmonic order)
:HARMonics:ORDer? Example :HARMONICS:DISPLAY:ORDER 1
First <NRf> = 1 (minimum harmonic order that is :HARMONICS:DISPLAY:ORDER?
analyzed, fixed at 1) -> :HARMONICS:DISPLAY:ORDER 1
Second <NRf> = 1 to 50 (maximum harmonic
order that is analyzed)
Example :HARMONICS:ORDER 1,50
:HARMONICS:ORDER?
-> :HARMONICS1:ORDER 1,50
:HARMonics:THD
Function Sets or queries the equation used to compute the
THD (total harmonic distortion).
Syntax :HARMonics:THD {TOTal|FUNDamental}
:HARMonics:THD?
Example :HARMONICS:THD FUNDAMENTAL
:HARMONICS:THD?
-> :HARMONICS:THD FUNDAMENTAL
:HARMonics:DISPlay?
Function
Queries all harmonic measurement display
settings.
Syntax :HARMonics:DISPlay?
6-10 IM WT310-17EN
6.6 HOLD Group 1
The command in this group deals with the output data hold feature.
You can make the same settings and queries that you can make by pressing HOLD on the front panel. 2
:HOLD
Function Sets or queries the on/off state of the output hold
feature for display, communication, and other 3
types of data.
Syntax :HOLD {<Boolean>}
:HOLD?
Example :HOLD OFF 4
:HOLD? -> :HOLD 0
Commands
7
App
Index
IM WT310-17EN 6-11
6.7 INPut Group
The commands in this group deal with the measurement conditions of the input elements.
You can make the same settings and queries that you can by pressing the WIRING, MODE, VOLTAGE, CURRENT,
or UTILITY key on the front panel and then using the CF or rAnGE menu or by pressing the SETUP key and then
using the SCALE, rAtio, SYnC, L.FiLt, or F.FiLt menu.
:INPut? [:INPut]:VOLTage:RANGe
Function Queries all input settings. Function Sets or queries the voltage range.
Syntax :INPut? Syntax [:INPut]:VOLTage:RANGe {<Voltage>}
[:INPut]:VOLTage:RANGe?
[:INPut]:CFACtor • When the crest factor is set to 3
Function Sets or queries the crest factor.
<Voltage> = 15, 30, 60, 150, 300, 600(V)
Syntax [:INPut]:CFACtor {<NRf>}
• When the crest factor is set to 6
[:INPut]:CFACtor?
<Voltage> = 7.5, 15, 30, 75, 150, 300(V)
<NRf> = 3, 6
Example :INPUT:VOLTAGE:RANGE 600V
Example :INPUT:CFACTOR 3
:INPUT:VOLTAGE:RANGE?
:INPUT:CFACTOR?
-> :INPUT:VOLTAGE:RANGE 600.0E+00
-> :INPUT:CFACTOR 3
[:INPut]:WIRing [:INPut]:VOLTage:AUTO
Function Sets or queries the wiring system. Function Sets or queries the voltage auto range on/off
Syntax [:INPut]:WIRing {(P1W2|P1W3|P3W3| state.
P3W4|V3A3)} Syntax [:INPut]:VOLTage:AUTO {<Boolean>}
[:INPut]:WIRing? [:INPut]:VOLTage:AUTO?
P1W2 = Single-phase, two-wire system [1P2W] Example :INPUT:VOLTAGE:AUTO ON
P1W3 = Single-phase, three-wire system :INPUT:VOLTAGE:AUTO?
[1P3W] -> :INPUT:VOLTAGE:AUTO 1
P3W3 = Three-phase, three-wire system [3P3W]
P3W4 = Three-phase, four-wire system [3P4W] [:INPut]:VOLTage:CONFig
V3A3 = Three-phase, three-wire system with a Function Sets or queries the valid voltage range.
three-voltage, three-current method [3V3A] Syntax [:INPut]:VOLTage:CONFig
Example :INPUT:WIRING P1W3 {ALL|<Voltage>[,<Voltage>]
:INPUT:WIRING? [,<Voltage>]...}
-> :INPUT:WIRING P1W3 [:INPut]:VOLTage:CONFig?
Description • For the WT310 and WT310HC, the wiring ALL = All ranges are valid.
system is fixed to P1W2. No other setting is <Voltage> = See (:INPut:VOLTage:
allowed. RANGe).
• For the WT332 and WT333, the wiring system Example :INPUT:VOLTAGE:CONFIG ALL
cannot be set to P1W2. :INPUT:VOLTAGE:CONFIG?
-> :INPUT:VOLTAGE:CONFIG ALL
[:INPut]:MODE :INPUT:VOLTAGE:CONFIG 600,150,15
Function Sets or queries the voltage and current
:INPUT:VOLTAGE:CONFIG?
measurement mode.
-> :INPUT:VOLTAGE:CONFIG 600.0E+00,
Syntax [:INPut]:MODE {RMS|VMEan|DC}
150.0E+00,15.0E+00
[:INPut]:MODE?
Description In the parameters, list the voltage ranges that you
Example :INPUT:MODE RMS
want to enable. To enable all the ranges, specify
:INPUT:MODE? -> :INPUT:MODE RMS
the parameter “ALL.”
[:INPut]:VOLTage?
Function Queries all voltage measurement settings.
Syntax [:INPut]:VOLTage?
6-12 IM WT310-17EN
6.7 INPut Group
[:INPut]:VOLTage:POJump [:INPut]:CURRent:AUTO 1
Function Sets or queries the jump destination range that is Function Sets or queries the current auto range on/off
used when a voltage peak over-range occurs. state.
Syntax [:INPut]:VOLTage:POJump Syntax [:INPut]:CURRent:AUTO {<Boolean>}
{OFF|<Voltage>} [:INPut]:CURRent:AUTO?
2
[:INPut]:VOLTage:POJump? Example :INPUT:CURRENT:AUTO ON
OFF = No jump destination voltage range :INPUT:CURRENT:AUTO?
<Voltage> = See (:INPut:VOLTage:RANGe). -> :INPUT:CURRENT:AUTO 1
Example :INPUT:VOLTAGE:POJUMP 600V
[:INPut]:CURRent:CONFig 3
:INPUT:VOLTAGE:POJUMP?
Function Sets or queries the valid current range.
-> :INPUT:VOLTAGE:POJUMP 600.0E+00
Syntax [:INPut]:CURRent:CONFig {ALL|<Current>
[,<Current>][,<Current>]...}
[:INPut]:CURRent? [:INPut]:CURRent:CONFig? 4
Function Queries all electric current measurement settings.
ALL = All ranges are valid.
Syntax [:INPut]:CURRent?
<Current> = See (:INPut:CURRent:
RANGe).
[:INPut]:CURRent:RANGe Example :INPUT:CURRENT:CONFIG ALL 5
Function Sets or queries the current range.
:INPUT:CURRENT:CONFIG?
Syntax [:INPut]:CURRent:RANGe
-> :INPUT:CURRENT:CONFIG ALL
{<Current>|(EXTernal,<Voltage>)}
:INPUT:CURRENT:CONFIG 20,5,1
[:INPut]:CURRent:RANGe?
:INPUT:CURRENT:CONFIG? 6
• For direct current input
-> :INPUT:CURRENT:CONFIG
• When the crest factor is set to 3
Commands
20.0E+00,5.0E+00,1.0E+00
<Current> = 5, 10, 20, 50, 100, 200, 500(mA),
Description In the parameters, list the current ranges that you
1, 2, 5, 10, 20(A) (WT310)
<Current> = 1, 2, 5, 10, 20, 40(A) (WT310HC)
want to enable. To enable all the ranges, specify 7
the parameter “ALL.”
<Current> = 0.5, 1, 2, 5, 10, 20(A) (WT332,
WT333) [:INPut]:CURRent:POJump
• When the crest factor is set to 6
<Current> = 2.5, 5, 10, 25, 50, 100, 250(mA),
Function Sets or queries the jump destination range that is
used when a current peak over-range occurs.
8
0.5, 1, 2.5, 5, 10(A) (WT310) Syntax [:INPut]:CURRent:POJump
<Current> = 0.5, 1, 2.5, 5, 10, 20(A) {OFF|<Current>}
(WT310HC) [:INPut]:CURRent:POJump?
App
<Current> = 0.25, 0.5, 1, 2.5, 5, 10(A) (WT332, OFF = No jump destination current range
WT333) <Current> = See (:INPut:CURRent:
• For external current sensor input RANGe).
• When the crest factor is set to 3 Example :INPUT:CURRENT:POJUMP 20A
:INPUT:CURRENT:POJUMP?
Index
<Voltage> = 2.5, 5, 10(V) (/EX1)
<Voltage> = 50, 100, 200, 500(mV), 1, 2(V) -> :INPUT:CURRENT:POJUMP 20.0E+00
(/EX2)
• When the crest factor is set to 6
[:INPut]:CURRent:EXTSensor:CONFig
Function Sets or queries the valid external current sensor
<Voltage> = 1.25, 2.5, 5(V) (/EX1)
range.
<Voltage> = 25, 50, 100, 250(mV), 0.5, 1(V)
Syntax [:INPut]:CURRent:EXTSensor:CONFig
(/EX2)
{ALL|<Voltage>[,<Voltage>]
Example :INPUT:CURRENT:RANGE 20A
[,<Voltage>]...}
:INPUT:CURRENT:RANGE?
[:INPut]:CURRent:EXTSensor:CONFig?
-> :INPUT:CURRENT:RANGE 20.0E+00
ALL = All ranges are valid.
:INPUT:CURRENT:RANGE EXTERNAL,10V
<Voltage> = See (:INPut:CURRent:
:INPUT:CURRENT:RANGE?
RANGe).
-> :INPUT:CURRENT:RANGE
Example :INPUT:CURRENT:EXTSENSOR:CONFIG ALL
EXTERNAL,10.0E+00
:INPUT:CURRENT:EXTSENSOR:CONFIG? ->
Description EXTernal and <Voltage> can only be selected
:INPUT:CURRENT:EXTSENSOR:CONFIG ALL
on models with the external current sensor input
:INPUT:CURRENT:EXTSENSOR:CONFIG
(/EX1 or /EX2) option.
2,0.5,0.1
:INPUT:CURRENT:EXTSENSOR:CONFIG?
-> :INPUT:CURRENT:EXTSENSOR:CONFIG
2.00E+00,500.0E-03,100.0E-03
IM WT310-17EN 6-13
6.7 INPut Group
Description In the parameters, list the external current sensor Description The following commands are enabled only when
ranges that you want to enable. To enable all the this command is set to ON. Measurement range
ranges, specify the parameter “ALL.” can be skipped.
:INPut:VOLTage:CONFig
[:INPut]:CURRent:EXTSensor:POJump :INPut:VOLTage:POJump
Function Sets or queries the jump destination range that is
:INPut:CURRent:CONFig
used when a current peak over-range occurs.
:INPut:CURRent:POJump
Syntax [:INPut]:CURRent:EXTSensor:POJump
:INPut:CURRent:EXTSensor:CONFig
{OFF|<Voltage>}
:INPut:CURRent:EXTSensor:POJump
[:INPut]:CURRent:EXTSensor:POJump?
OFF = No jump destination current range [:INPut]:SCALing?
<Voltage> = See (:INPut:CURRent: Function Queries all scaling settings.
RANGe). Syntax [:INPut]:SCALing?
Example :INPUT:CURRENT:EXTSENSOR:POJUMP 2V
:INPUT:CURRENT:EXTSENSOR:POJUMP? [:INPut]:SCALing[:STATe]
-> :INPUT:CURRENT:EXTSENSOR:POJUMP Function Sets or queries the scaling on/off state.
2.00E+00 Syntax [:INPut]:SCALing[:STATe] {<Boolean>}
[:INPut]:SCALing:STATe?
[:INPut]:CURRent:SRATio? Example :INPUT:SCALING:STATE OFF
Function
Queries the external current sensor conversion :INPUT:SCALING:STATE?
ratios of all elements. -> :INPUT:SCALING:STATE 0
Syntax [:INPut]:CURRent:SRATio?
Description This command is only valid on models with the
[:INPut]:SCALing:{VT|CT|SFACtor}?
Function
Queries the VT ratios, CT ratios, or power
external current sensor input (/EX1 or /EX2)
coefficients of all elements.
option.
Syntax [:INPut]:SCALing:{VT|CT|SFACtor}?
[:INPut]:CURRent:SRATio[:ALL]
Function Collectively sets the external current sensor
[:INPut]:SCALing:{VT|CT|SFACtor}[:
conversion ratios of all elements.
ALL]
Function Collectively sets the VT ratio, CT ratio, or power
Syntax [:INPut]:CURRent:SRATio[:ALL]
coefficient of all elements.
{<NRf>}
Syntax [:INPut]:SCALing:{VT|CT|SFACtor}
<NRf> = 0.001 to 9999.
[:ALL] {<NRf>}
Example :INPUT:CURRENT:SRATIO:ALL 10
<NRf> = 0.001 to 9999.
Example :INPUT:SCALING:VT:ALL 1
[:INPut]:CURRent:SRATio:ELEMent<x>
Function Sets or queries the external current sensor
conversion ratio of the specified element.
[:INPut]:SCALing:{VT|CT|SFACtor}:
Syntax [:INPut]:CURRent:SRATio:ELEMent<x>
ELEMent<x>
Function Sets or queries the VT ratio, CT ratio, or power
{<NRf>}
coefficient of the specified element.
[:INPut]:CURRent:SRATio:ELEMent<x>?
Syntax [:INPut]:SCALing:{VT|CT|SFACtor}
<x> = 1 to 3 (element)
:ELEMent<x> {<NRf>}
<NRf> = 0.001 to 9999.
[:INPut]:SCALing:{VT|CT|SFACtor}
Example :INPUT:CURRENT:SRATIO:ELEMENT1 10
:ELEMent<x>?
:INPUT:CURRENT:SRATIO:ELEMENT1?
<x> = 1 to 3 (element)
-> :INPUT:CURRENT:SRATIO:ELEMENT1
<NRf> = 0.001 to 9999.
10.00
Example :INPUT:SCALING:VT:ELEMENT1 1
:INPUT:SCALING:VT:ELEMENT1?
[:INPut]:RCONfig -> :INPUT:SCALING:VT:ELEMENT1 1.000
Function Sets or queries the on/off state of the range
configuration (valid range selection) feature. [:INPut]:SYNChronize
Syntax [:INPut]:RCONfig {<Boolean>} Function Sets or queries the synchronization source.
[:INPut]:RCONfig? Syntax [:INPut]:SYNChronize
Example :INPUT:RCONFIG OFF {VOLTage|CURRent|OFF}
:INPUT:RCONFIG? -> :INPUT:RCONFIG 0 [:INPut]:SYNChronize?
Example :INPUT:SYNCHRONIZE VOLTAGE
:INPUT:SYNCHRONIZE?
-> :INPUT:SYNCHRONIZE VOLTAGE
6-14 IM WT310-17EN
6.7 INPut Group
[:INPut]:FILTer? [:INPut]:CRANge? 1
Function Queries all input filter settings. Function Sets or queries the check range status.
Syntax [:INPut]:FILTer? Syntax [:INPut]:CRANge?
Example :INPUT:CRANGE? -> 0
[:INPut]:FILTer:LINE Description • The CHECK RANGE LED status is mapped
2
Function Sets or queries the line filter. as shown below. For the response, the sum
Syntax [:INPut]:FILTer:LINE {<Boolean>} of the values of each bit is returned in decimal
[:INPut]:FILTer:LINE? format.
Example :INPUT:FILTER:LINE OFF • For example, a response of 0 indicates
3
:INPUT:FILTER:LINE? appropriate range. A response of 64 indicates
-> :INPUT:FILTER:LINE 0 that a current over-range is occurring.
[:INPut]:FILTer:FREQuency 7 6 5 4 3 2 1 0
4
AP AO AH AL VP VO VH VL
Function Sets or queries the frequency filter.
Syntax [:INPut]:FILTer:FREQuency
{<Boolean>} VL : The voltage is at the condition for
[:INPut]:FILTer:FREQuency? reducing the auto range or less.
VH : The voltage exceeds the condition for
5
Example :INPUT:FILTER:FREQUENCY OFF
:INPUT:FILTER:FREQUENCY? raising the auto range.
-> :INPUT:FILTER:FREQUENCY 0 VO : The voltage is over-range.
VP : The voltage is peak over-range.
6
[:INPut]:POVer? AL : The current is at the condition for
Function Queries the peak over-range information. reducing the auto range or less.
Commands
Syntax [:INPut]:POVer? AH : The current exceeds the condition for
raising the auto range.
Example :INPUT:POVER? -> 0
AO : The current is over-range.
7
Description • The peak over-range information of each
element is mapped as shown below. For the AP : The current is peak over-range.
response, the sum of the values of each bit is
• For information on the color of the LED and
returned in decimal format.
the condition to light, see “Auto Range Monitor
8
• For example, a response of 16 indicates that a
peak over-range is occurring at U3. Indications” in section 1.5 in the Getting
Started Guide, IM WT310-02EN.
7 6 5 4 3 2 1 0
App
I3 U3 I2 U2 I1 U1
Index
IM WT310-17EN 6-15
6.8 INTEGrate Group
The commands in this group deal with integration.
You can make the same settings and queries that you can make by pressing INTEG SET, START, STOP, and RESET
on the front panel.
:INTEGrate? :INTEGrate:STATe?
Function Queries all integration settings. Function Queries the integration status.
Syntax :INTEGrate? Syntax :INTEGrate:STATe?
Example :INTEGRATE:STATE? -> RESET
:INTEGrate:MODE Description • The response is as follows:
Function Sets or queries the integration mode. RESet = Integration reset
Syntax :INTEGrate:MODE {NORMal|CONTinuous} STARt = Integration in progress
:INTEGrate:MODE? STOP = Integration stop
NORMal = Standard integration mode ERRor = Abnormal integration termination
CONTinuous = Continuous integration mode (integration overflow, power failure)
Example :INTEGRATE:MODE NORMAL TIMeup = Integration stop due to integration
:INTEGRATE:MODE? timeout
-> :INTEGRATE:MODE NORMAL
:INTEGrate:TIMer
Function Sets or queries the integration timer value.
Syntax :INTEGrate:TIMer {<NRf>,<NRf>,<NRf>}
:INTEGrate:TIMer?
{<NRf>,<NRf>,<NRf>} = 0,0,0 to
10000,0,0
First <NRf> = 0 to 10000 (hours)
Second <NRf> = 0 to 59 (minutes)
Third <NRf> = 0 to 59 (seconds)
Example :INTEGRATE:TIMER 1,0,0
:INTEGRATE:TIMER?
-> :INTEGRATE:TIMER 1,0,0
:INTEGrate:STARt
Function Starts integration.
Syntax :INTEGrate:STARt
Example :INTEGRATE:START
:INTEGrate:STOP
Function Stops integration.
Syntax :INTEGrate:STOP
Example :INTEGRATE:STOP
:INTEGrate:RESet
Function Resets the integrated value.
Syntax :INTEGrate:RESet
Example :INTEGRATE:RESET
6-16 IM WT310-17EN
6.9 MATH Group 1
The commands in this group deal with computations. You can make the same settings and queries that you can by
pressing SETUP on the front panel and using the MAtH menu. 2
:MATH
Function Sets or queries the MATH equation.
Syntax :MATH {EFFiciency|CFU<x>|CFI<x>|ADD| 3
SUB|MUL|DIV|DIVA|DIVB|AVW<x>}
:MATH?
<x> of {CFU|CFI} = 1 to 3 (element)
<x> of {AVW} = 1 to 3 (element), 4 (Σ) 4
Example :MATH CFU1
:MATH? -> :MATH CFU1
Description The equations that correspond to each option are
as follows: 5
EFFiciency : Efficiency (valid only on the WT332/
WT333)
CFU : Voltage crest factor
CFI : Current crest factor 6
ADD : A+B
Commands
SUB : A-B
MUL : A×B
DIV : A/B 7
DIVA: A/B^2
DIVB: A^2/B
AVW : Average active power during integration
8
App
Index
IM WT310-17EN 6-17
6.10 MEASure Group
The commands in this group deal with computation.
You can make the same settings and queries that you can by pressing SETUP on the front panel and using the AVG
menu or by pressing MAX HOLD on the front panel.
:MEASure? :MEASure:MHOLd
Function
Queries all measured and computed data output Function Sets the MAX hold on/off state.
settings. Syntax :MEASure:MHOLd {<Boolean>}
Syntax :MEASure? :MEASure:MHOLd?
Example :MEASURE:MHOLD ON
:MEASure:AVERaging? :MEASURE:MHOLD? -> :MEASURE:MHOLD 1
Function Queries all averaging settings.
Syntax :MEASure:AVERaging?
:MEASure:AVERaging[:STATe]
Function Sets or queries the on/off state of averaging.
Syntax :MEASure:AVERaging[:STATe]
{<Boolean>}
:MEASure:AVERaging:STATe?
Example :MEASURE:AVERAGING:STATE ON
:MEASURE:AVERAGING:STATE?
-> :MEASURE:AVERAGING:STATE 1
:MEASure:AVERaging:TYPE
Function Sets or queries the averaging type.
Syntax :MEASure:AVERaging:TYPE
{LINear|EXPonent}
:MEASure:AVERaging:TYPE?
Example :MEASURE:AVERAGING:TYPE LINEAR
:MEASURE:AVERAGING:TYPE?
-> :MEASURE:AVERAGING:TYPE LINEAR
Description The averaging of harmonic measurement
functions (option) is only valid when the type
is set to EXPonent. For details, see the User’s
Manual, IM WT310-01EN.
:MEASure:AVERaging:COUNt
Function Sets or queries the averaging coefficient.
Syntax :MEASure:AVERaging:COUNt {<NRf>}
:MEASure:AVERaging:COUNt?
<NRf> = 8, 16, 32, 64 (moving average count or
attenuation constant)
Example :MEASURE:AVERAGING:COUNT 8
:MEASURE:AVERAGING:COUNT?
-> :MEASURE:AVERAGING:COUNT 8
Description The averaging of harmonic measurement
functions (option) is only valid when TYPE is set
to EXPonent (attenuation constant). For details,
see the User’s Manual, IM WT310-01EN.
6-18 IM WT310-17EN
6.11 NUMeric Group 1
:NUMeric? :NUMeric[:NORMal]:VALue? 3
Function Queries all numeric data output settings. Function Queries the numeric data.
Syntax :NUMeric? Syntax :NUMeric[:NORMal]:VALue? {<NRf>}
<NRf> = 1 to 255 (item number)
:NUMeric:FORMat Example • When <NRf> is specified 4
Function Sets or queries the numeric data format. :NUMERIC:NORMAL:VALUE? 1
Syntax :NUMeric:FORMat {ASCii|FLOat} -> 103.79E+00
:NUMeric:FORMat? • When <NRf> is omitted
Example :NUMERIC:FORMAT ASCII :NUMERIC:NORMAL:VALUE? 5
:NUMERIC:FORMAT? -> 103.79E+00,1.0143E+00,105.27E+0
-> :NUMERIC:FORMAT ASCII 0,..(omitted)..,50.001E+00
Description • The format of the numeric data that is output • When :NUMeric:FORMat is set to {FLOat}
varies depending on how this command is set. :NUMERIC:NORMAL:VALUE? 6
The different formats are explained below. -> #N (N-digit byte number)(data byte
Commands
(1) ASCii sequence)
Physical values are output in the <NR3> Description • If <NRf> is specified, only the numeric data for
format.(Only the elapsed integration time— the specified item is output. 7
TIME—is output in <NR1> format.) • If <NRf> is omitted, the numeric data items
The data items are separated by commas. from 1 to the number specified by the :
(2) FLOat NUMeric[:NORMal]:NUMber command are
A header (for example, “#240” or “#3208”) is output in order. 8
added in front of each numeric data block. • For the formats of each individual numeric data
A physical value in IEEE single-precision output item, see “Numeric Data Formats” at the
floating point (4-byte) format follows the end of this group of commands (page 6-25).
header. App
The byte order of the data of each item is MSB :NUMeric[:NORMal]:NUMber
First. Function Sets or queries the number of numeric data items
• For the formats of each individual numeric data that are transmitted by the :NUMeric[:NORMal]:
item, see “Numeric Data Formats” at the end of VALue? command. Index
this group of commands (page 6-25). Syntax :NUMeric[:NORMal]:NUMber {<NRf>|ALL}
:NUMeric[:NORMal]:NUMber?
:NUMeric:NORMal? <NRf> = 1 to 255(ALL)
Function Queries all numeric data output settings. Example :NUMERIC:NORMAL:NUMBER 10
Syntax :NUMeric:NORMal? :NUMERIC:NORMAL:NUMBER
Description The number of numeric data items output by : -> :NUMERIC:NORMAL:NUMBER 10
NUMeric[:NORMal]:ITEM<x> is determined by : Description • If the parameter is omitted from the :NUMeric[:
NUMeric[:NORMal]NUMber. NORMal]:VALue? command, the numeric data
items from 1 to the specified value are output
in order.
• By default, the number of numeric data items is
set to 10.
IM WT310-17EN 6-19
6.11 NUMeric Group
:NUMeric[:NORMal]:ITEM<x> :NUMeric[:NORMal]:CLEar
Function Sets or queries the specified numeric data output Function
Clears numeric data output items (sets the items
item (function, element, and harmonic order). to NONE).
Syntax :NUMeric[:NORMal]:ITEM<x> {NONE| Syntax :NUMeric[:NORMal]:CLEar
<Function>[,<Element>][,<Order>]} {ALL|<NRf>[,<NRf>]}
:NUMeric[:NORMal]:ITEM<x>? ALL = Clear all items
<x> = 1 to 255 (item number) First <NRf> = 1 to 255 (the number of the first
NONE = No output item item to clear)
<Function> = {U|I|P|S|Q|...} Second <NRf> = 1 to 255 (the number of the last
<Element> = {<NRf>|SIGMa} item to clear)
(<NRf> = 1 to 3) Example :NUMERIC:NORMAL:CLEAR ALL
<Order> = {TOTal|DC|<NRf>} Description If the 2nd <NRf> is omitted, the output item
(<NRf> = 1 to 50) specified by the first and all following output items
Example :NUMERIC:NORMAL:ITEM1 U,1 (up to number 255) are cleared.
:NUMERIC:NORMAL:ITEM1?
-> :NUMERIC:NORMAL:ITEM1 U,1 :NUMeric[:NORMal]:DELete
:NUMERIC:NORMAL:ITEM1 UK,1,1 Function Deletes numeric data output items.
:NUMERIC:NORMAL:ITEM1? Syntax :NUMeric[:NORMal]:DELete
-> :NUMERIC:NORMAL:ITEM1 UK,1,1 {<NRf>[,<NRf>]}
Description • For details on <Function> options, see 1st <NRf> = 1 to 255 (the number of the first item
“Function Option List (1)” at the end of this to delete)
group of commands (page 6-24). Second <NRf> = 1 to 255 (the number of the last
• If <Element> is omitted, the element is set to 1. item to delete)
• If <Order> is omitted, the order is set to TOTal. Example :NUMERIC:NORMAL:DELETE 1 (Deletes ITEM1
• <Element> and <Order> are omitted from and shifts ITEM2 and subsequent items forward)
responses to functions that do not need them. :NUMERIC:NORMAL:DELETE 1,3 (Deletes
• This instrument does not measure data for ITEM1 to ITEM3 and shifts ITEM4 and
<Order> = DC. subsequent items forward)
Description • When output items are deleted, subsequent
:NUMeric[:NORMal]:PRESet items shift forward to fill the empty positions.
Function Presets the numeric data output item pattern. Empty positions at the end are set to NONE.
Syntax :NUMeric[:NORMal]:PRESet {<NRf>} • If the second <NRf> is omitted, only the output
<NRf> = 1 to 4 item specified by the first number is deleted.
Example :NUMERIC:NORMAL:PRESET 1
Description • For information about the output items that are :NUMeric[:NORMal]:HEADer?
preset, see “(1) Preset Patterns for Numeric Function Queries the numeric data header.
Data Items” on page 6-26 at the end of the Syntax :NUMeric[:NORMal]:HEADer? {<NRf>}
commands for this group. <NRf> = 1 to 255 (item number)
• By default, the output items of Pattern 2 are Example • When <NRf> is specified
selected. :NUMERIC:NORMAL:HEADER? 1
-> U-E1
• When <NRf> is omitted (when :NUMeric[:
NORMal]:NUMber is set to 3)
:NUMERIC:NORMAL:HEADER?
-> U-E1,I-E1,P-E1
Description • The data name (header) of the output item is
generated.
• If <NRf> is specified, only the data name for
the specified item number is output.
• If <NRf> is omitted, the data names of the
items from 1 to the number specified by the :
NUMeric[:NORMal]:NUMber command are
output in order.
6-20 IM WT310-17EN
6.11 NUMeric Group
:NUMeric:LIST? :NUMeric:LIST:NUMber 1
Function
Queries all harmonic measurement numeric list Function Sets or queries the number of numeric list data
data output settings. items that are transmitted by :NUMeric:LIST:
Syntax :NUMeric:LIST? VALue?.
Description • This is only valid on models with the harmonic Syntax :NUMeric:LIST:NUMber {<NRf>|ALL}
2
measurement (/G5) option. :NUMeric:LIST:NUMber?
• The number of numeric list data items output <NRf> = 1 to 32(ALL)
by :NUMeric:LIST:ITEM<x> is determined by Example :NUMERIC:LIST:NUMBER 5
:NUMeric:LIST:NUMber. :NUMERIC:LIST:NUMBER
3
-> :NUMERIC:LIST:NUMBER 5
:NUMeric:LIST:VALue? Description • This is only valid on models with the harmonic
Function Queries the harmonic measurement numeric list measurement (/G5) option.
data. • If the parameter is omitted from the :NUMeric:
4
Syntax :NUMeric:LIST:VALue? {<NRf>} LIST:VALue? command, the numeric list data
<NRf> = 1 to 32 (item number) items from 1 to the specified value are output
Example • When <NRf> is specified in order.
:NUMERIC:LIST:VALUE? 1
-> 103.58E+00,NAN,103.53E+00
• By default, the number of numeric list data
5
items is set to 1.
,0.09E+00,2.07E+00,0.04E+00,..
(omitted)..,0.01E+00,0.01E+00 :NUMeric:LIST:ORDer
(up to 52 data values) Function Sets or queries the maximum output harmonic
6
• When <NRf> is omitted (when :NUMeric order of the harmonic measurement numeric list
:LIST:NUMber is set to 5) data.
Commands
:NUMERIC:LIST:VALUE? Syntax :NUMeric:LIST:ORDer {<NRf>|ALL}
-> 103.58E+00,NAN,103.53E+00
,0.09E+00,2.07E+00,0.04E+00,..
:NUMeric:LIST:ORDer?
<NRf> = 1 to 50(ALL)
7
(omitted)..,0.00E+00,0.00E+00 Example :NUMERIC:LIST:ORDER 50
(up to 52*5 = 260 data values) :NUMERIC:LIST:ORDER?
• When :NUMeric:FORMat is set to {FLOat}
:NUMERIC:LIST:VALUE?
-> :NUMERIC:LIST:ORDER 50
Description This is only valid on models with the harmonic
8
-> #N (N-digit byte number)(data byte measurement (/G5) option.
sequence)
Description • This is only valid on models with the harmonic :NUMeric:LIST:SELect App
measurement (/G5) option. Function Sets or queries the output components of the
• A single numeric list data item consists of up to harmonic measurement numeric list data.
52 items of numeric data in the following order: Syntax :NUMeric:LIST:SELect {EVEN|ODD|ALL}
TOTal, DC, 1st harmonic, ..., :NUMeric:LIST: :NUMeric:LIST:SELect?
Index
ORDer. Example :NUMERIC:LIST:SELECT ALL
• If <NRf> is specified, only the numeric list data :NUMERIC:LIST:SELECT?
of the specified item number is output (up to 52 -> :NUMERIC:LIST:SELECT ALL
items of data). Description • This is only valid on models with the harmonic
• If <NRf> is omitted, the numeric list data measurement (/G5) option.
of item numbers from 1 to :NUMeric:LIST: • The available options are explained below.
NUMber is output in order (up to 52 times the EVEN = Outputs the components of TOTal,
number specified by :NUMeric:LIST:NUMber). DC, and even-order harmonics
• For the formats of each individual numeric data ODD = Outputs the components of TOTal, DC,
output item, see “Numeric Data Formats” at the and odd-order harmonics
end of this group of commands (page 6-25). ALL = Outputs all components
• This instrument does not measure data for the
DC component. It is always “NAN.”
IM WT310-17EN 6-21
6.11 NUMeric Group
:NUMeric:LIST:ITEM<x> :NUMeric:LIST:DELete
Function Sets or queries the output item (function and Function Deletes harmonic measurement numeric list data
element) of the specified harmonic measurement output items.
numeric list data item. Syntax :NUMeric:LIST:DELete {<NRf>[,<NRf>]}
Syntax :NUMeric:LIST:ITEM<x> {NONE| 1st <NRf> = 1 to 32 (the number of the first item
<Function>,<Element>} to delete)
:NUMeric:LIST:ITEM<x>? Second <NRf> = 1 to 32 (the number of the last
<x> = 1 to 32 (item number) item to delete)
NONE = No output item Example :NUMERIC:LIST:DELETE 1 (Deletes ITEM1
<Function> = {U|I|P|PHIU|PHII|UHDF| and shifts ITEM2 and subsequent items forward)
IHDF|PHDF} :NUMERIC:LIST:DELETE 1,3 (Deletes ITEM1
<Element> = {<NRf>}(<NRf> = 1 to 3) to ITEM3 and shifts ITEM4 and subsequent items
Example :NUMERIC:LIST:ITEM1 U,1 forward)
:NUMERIC:LIST:ITEM1? Description • This is only valid on models with the harmonic
-> :NUMERIC:LIST:ITEM1 U,1 measurement (/G5) option.
Description • This is only valid on models with the harmonic • When output items are deleted, subsequent
measurement (/G5) option. items shift forward to fill the empty positions.
• For details on <Function> options, see Empty positions at the end are set to NONE.
“Function Option List (2)” at the end of this • If the second <NRf> is omitted, only the output
group of commands (page 6-24). item specified by the first number is deleted.
:NUMeric:LIST:PRESet
Function Presets the harmonic measurement numeric list
data output item pattern.
Syntax :NUMeric:LIST:PRESet {<NRf>}
<NRf> = 1 to 4
Example :NUMERIC:LIST:PRESET 1
Description • This is only valid on models with the harmonic
measurement (/G5) option.
• For information about the output items that are
preset, see “(2) Preset Patterns for Harmonic
Measurement Numeric List Data Output Items”
on page 6-28 at the end of the commands for
this group.
• By default, the output items of Pattern 2 are
selected.
:NUMeric:LIST:CLEar
Function
Clears harmonic measurement numeric list data
output items (sets the items to NONE).
Syntax :NUMeric:LIST:CLEar
{ALL|<NRf>[,<NRf>]}
ALL = Clear all items
First <NRf> = 1 to 32 (the number of the first item
to clear)
Second <NRf> = 1 to 32 (the number of the last
item to clear)
Example :NUMERIC:LIST:CLEAR ALL
Description • This is only valid on models with the harmonic
measurement (/G5) option.
• If the 2nd <NRf> is omitted, the output item
specified by the first number and all following
output items (up to number 32) are cleared.
6-22 IM WT310-17EN
6.11 NUMeric Group
:NUMeric:HOLD 1
Function Sets or queries the on/off (hold/release) status of
the numeric data hold feature.
Syntax :NUMeric:HOLD {<Boolean>}
:NUMeric:HOLD?
2
Example :NUMERIC:HOLD ON
:NUMERIC:HOLD? -> :NUMERIC:HOLD 1
Description • If :NUMeric:HOLD is set to ON before
:NUMeric[:NORMal]:VALue? or
3
:NUMeric:LIST:VALue? is executed, all the
numeric data at that point in time can be held
internally.
• As long as :NUMeric:HOLD is set to ON,
4
numeric data is held even when the numeric
data on the screen is updated.
• For example, if you wish to retrieve various
types of numeric data from each element
5
at the same point in time, use the following
commands:
:NUMeric:HOLD ON
:NUMeric[:NORMal]:ITEM1 U,1;ITEM2 I,1;...
6
(Set the numeric data items of element 1.)
:NUMeric[:NORMal]:VALue?
Commands
(Receive the numeric data of element 1.)
:NUMeric[:NORMal]:ITEM1 U,2;ITEM2 I,2;...
(Set the numeric data items of element 2.)
7
:NUMeric[:NORMal]:VALue?
(Receive the numeric data of element 2.)
:NUMeric[:NORMal]:ITEM1 U,3;ITEM2 I,3;...
(Set the numeric data items of element 3.)
8
:NUMeric[:NORMal]:VALue?
(Receive the numeric data of element 3.)
:NUMeric:HOLD OFF
App
• If :NUMeric:HOLD is set to ON after having
already been set to ON before, the numeric
data is cleared, and the most recent numeric
data is held internally. When retrieving numeric
Index
data continuously, this method can be used to
circumvent the need to repeatedly set
:NUMeric:HOLD to OFF.
IM WT310-17EN 6-23
6.11 NUMeric Group
6-24 IM WT310-17EN
6.11 NUMeric Group
<Function> Function
U Voltage U( )
4
I Current I( )
P Active power P( )
PHIU Phase difference between harmonic voltage U(k) and the fundamental wave U(1) φU( )
PHII Phase difference between harmonic current I(k) and the fundamental wave I(1) φI(k) 5
UHDF Harmonic distortion factor of voltage Uhdf( )
IHDF Harmonic distortion factor of current Ihdf( )
PHDF Harmonic distortion factor of active power Phdf( )
6
Numeric Data Format
Commands
(1) Normal Data
• Integrated values WH, WHP, WHM, AH, AHP, and AHM
ASCII: <NR3> format (mantissa: up to 6 digits, exponent: 2 digits. Example: [-]123.456E+00)
7
FLOAT: IEEE single-precision floating point (4-byte) format
• Elapsed integration time (TIME)
ASCII: <NR1> format in units of seconds. Example: 3600 for 1 hour (1:00:00). 8
FLOAT: IEEE single-precision floating point (4-byte) format in units of seconds. Example:
0x45610000 for 1 hour (1:00:00).
• No items (NONE)
ASCII: NAN (Not A Number) App
FLOAT: 0x7E951BEE (9.91E+37)
• Other
ASCII: <NR3> format (mantissa: up to 5 digits, exponent: 2 digits. Example: [-]123.45.456E+00) Index
FLOAT: IEEE single-precision floating point (4-byte) format
Note
In 180° (Lead/Lag) display, the phase differences Φ (PHI) of elements 1 to 3 are output in the range between
–180.0 to 180.0 with lead (D) and lag (G) set to negative and positive values, respectively.
IM WT310-17EN 6-25
6.11 NUMeric Group
Note
This list indicates the measurement function and element that are assigned to each item number (ITEM <x>).
Items that are not set to be measured are displayed or output in the same fashion as when the data does
not exist. For example, if frequency FI of the current of element 2 is not set to be measured, the output of
ITEM19 in pattern 2 is the same as the output when the data does not exist (NAN if the data format is ASCII).
Pattern 2
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3 P 1
4 S 1
5 Q 1
6 LAMBda 1
7 PHI 1
8 FU 1
9 FI 1
10 NONE
11 to 19 U to FI 2
20 NONE
21 to 29 U to FI 3
30 NONE
31 to 39 U to FI SIGMA
40 NONE
41 to 255 NONE
6-26 IM WT310-17EN
6.11 NUMeric Group
Pattern 3 1
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3
4
P
S
1
1
2
5 Q 1
6 LAMBda 1
7 PHI 1
8 FU 1 3
9 FI 1
10 UPPeak 1
11 UMPeak 1
12
13
IPPeak
IMPeak
1
1
4
14 PPPeak 1
15 PMPeak 1
16 to 30 U to PMPeak 2
31 to 45 U to PMPeak 3 5
46 to 60 U to PMPeak SIGMA
61 to 255 NONE
Pattern 4 6
ITEM<x> <Function> <Element>
Commands
1 U 1
2 I 1
3 P 1 7
4 S 1
5 Q 1
6 LAMBda 1
7 PHI 1
8 FU 1
8
9 FI 1
10 UPPeak 1
11 UMPeak 1
12 IPPeak 1 App
13 IMPeak 1
14 TIME 1
15 WH 1
16 WHP 1
17 WHM 1
Index
18 AH 1
19 AHP 1
20 AHM 1
21 to 40 U to AHM 2
41 to 60 U to AHM 3
61 to 80 U to AHM SIGMA
81 to 255 NONE
IM WT310-17EN 6-27
6.11 NUMeric Group
(2) Preset Patterns for Harmonic Measurement Numeric List Data Output Items
These patterns apply to the :NUMeric:LIST:PRESet command.
Pattern 1
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3 P 1
4 to 6 U to P 2
7 to 9 U to P 3
10 to 32 NONE
Pattern 2
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3 P 1
4 PHIU 1
5 PHII 1
6 to 10 U to PHII 2
11 to 15 U to PHII 3
16 to 32 NONE
Pattern 3
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3 P 1
4 UHDF 1
5 IHDF 1
6 PHDF 1
7 to 12 U to PHDF 2
13 to 18 U to PHDF 3
19 to 32 NONE
Pattern 4
ITEM<x> <Function> <Element>
1 U 1
2 I 1
3 P 1
4 PHIU 1
5 PHII 1
6 UHDF 1
7 IHDF 1
8 PHDF 1
9 to 16 U to PHDF 2
17 to 24 U to PHDF 3
25 to 32 NONE
6-28 IM WT310-17EN
6.12 RATE Group 1
The command in this group deals with the data update interval. You can make the same settings and queries that you
can by pressing SETUP on the front panel and using the u.rAtE menu. 2
:RATE
Function Sets or queries the data update interval.
Syntax :RATE {<Time>} 3
:RATE?
<Time> = 100, 250, 500(ms), 1, 2, 5(s)
Example :RATE 250MS
:RATE? -> :RATE 250.0E-03 4
Commands
7
App
Index
IM WT310-17EN 6-29
6.13 RECall Group
The commands in this group deal with outputting stored measured data and loading setup parameters. You can make
the same settings that you can by pressing SAVE/LOAD on the front panel and using the LoAd menu. There are no
front panel keys that output measured data that is stored.
:RECall:NUMber?
Function Queries the number of blocks of measured data
that is stored.
Syntax :RECall:NUMber?
Example :RECALL:NUMBER? -> 600
:RECall[:NORMal]:VALue?
Function Queries the numeric data at the specified block
number.
Syntax :RECall[:NORMal]:VALue? {<NRf>}
<NRf> = 1 to 9000 (block number)
Description • Always specify <NRf>. The numeric data at the
specified block number will be returned.
• If you omit <NRf> or specify a number greater
than the number of blocks that contain stored
measured data (the number returned by :
RECall:NUMber?), the entire returned numeric
data will be “NAN” (no data).
• The output items and format are the same as
those of “:NUMeric[:NORMal]:VALue? (when
the item number is not specified).” To set the
output items and format, use the NUMeric
group commands.
:RECall:LIST:VALue?
Function Queries the numeric list data of harmonic
measurement at the specified block number.
Syntax :RECall:LIST:VALue? {<NRf>}
<NRf> = 1 to 600 (block number)
Description • This is only valid on models with the harmonic
measurement (/G5) option.
• Always specify <NRf>. The numeric list data at
the specified block number will be returned.
• If you omit <NRf> or specify a number greater
than the number of blocks that contain stored
measured data (the number returned by :
RECall:NUMber?), the entire returned numeric
list data will be “NAN” (no data).
• The output items and format are the same
as those of “:NUMeric:LIST:VALue? (when
the item number is not specified).” To set the
output items and format, use the NUMeric
group commands.
:RECall:PANel
Function Loads a setup parameter file.
Syntax :RECall:PANel {<NRf>}
<NRf> = 1 to 4 (file number)
6-30 IM WT310-17EN
6.14 STATus group 1
The commands in this group are used to make settings and queries related to the status report. There are no front
panel keys that correspond to the commands in this group. For information about status reports, see chapter 7. 2
:STATus? :STATus:FILTer<x>
Function
Queries all the settings for the communication Function Sets or queries the transition filter.
status feature. Syntax :STATus:FILTer<x> {RISE|FALL|BOTH| 3
Syntax :STATus? NEVer}
:STATus:FILTer<x>?
:STATus:CONDition? <x> = 1 to 16
Function Queries the contents of the condition register. Example :STATUS:FILTER2 RISE 4
Syntax :STATus:CONDition? :STATus:FILTER2?
Example :STATUS:CONDITION? -> 16 -> :STATUS:FILTER2 RISE
Description For information about the condition register, see Description • Set how each bit in the condition register must
chapter 7, “Status Reports.” change to trigger the setting of an event. If a 5
bit is set to RISE, an event is set when the bit
:STATus:EESE changes from 0 to 1.
Function Sets or queries the extended event enable • For information about the transition filter, see
register. chapter 7, “Status Reports.” 6
Syntax :STATus:EESE <Register>
:STATus:QENable
Commands
:STATus:EESE?
<Register> = 0 to 65535 Function Sets or queries whether messages other than
Example :STATUS:EESE #B0000000000000000 errors will be stored to the error queue (ON) or 7
:STATus:EESE? not (OFF).
-> :STATUS:EESE 0 Syntax :STATus:QENable {<Boolean>}
Description For information about the extended event enable :STATus:QENable?
register, see chapter 7, “Status Reports.” Example :STATUS:QENABLE ON 8
:STATus:QENABLE?
:STATus:EESR? -> :STATus:QENABLE 1
Function Queries the contents of the extended event
register and clears the register. :STATus:QMESsage App
Syntax :STATus:EESR? Function Sets or queries whether message information
Example :STATUS:EESR? -> 0 will be attached to the response to the STATus:
Description For information about the extended event register, ERRor? query (ON/OFF).
see chapter 7, “Status Reports.” Syntax :STATus:QMESsage {<Boolean>} Index
:STATus:QMESsage?
:STATus:ERRor? Example :STATUS:QMESSAGE ON
Function
Queries the error code and message of the last :STATus:QMESSAGE?
error that has occurred (top of the error queue). -> :STATus:QMESSAGE 1
Syntax :STATus:ERRor?
Example :STATUS:ERROR? :STATus:SPOLl?
-> 113,"Underfined Header" Function Executes serial polling.
Description • If no errors have occurred, 0,”No error” is Syntax :STATus:SPOLl?
returned. Example :STATUS:SPOLL? -> :STATUS:SPOLL 0
• You can use the :STATus:QMESsage
command to specify whether the message is
included.
IM WT310-17EN 6-31
6.15 STORe Group
The commands in this group deal with storing measured data and saving setup parameters. You can make the same
settings and queries that you can by pressing the UTILITY key on the front panel and then using the StorE menu or
by pressing the SAVE/LOAD key and then using the SAVE menu.
:STORe?
Function Queries all storage settings.
Syntax :STORe?
:STORe[:STATe]
Function Sets or queries the storage on/off state.
Syntax :STORe[:STATe] {<Boolean>}
:STORe:STATe?
Example :STORE:STATE ON
:STORE:STATE? -> :STORE:STATE 1
:STORe:INTerval
Function Sets or queries the storage interval.
Syntax :STORe:INTerval {<NRf>,<NRf>,<NRf>}
:STORe:INTerval?
{<NRf>,<NRf>,<NRf>} = 0,0,0 to 99,59,59
First <NRf> = 0 to 99 (hours)
Second <NRf> = 0 to 59 (minutes)
Third <NRf> = 0 to 59 (seconds)
Example :STORE:INTERVAL 0,0,0
:STORE:INTERVAL?
-> :STORE:INTERVAL 0,0,0
:STORe:PANel
Function Saves setup parameters to a file.
Syntax :STORe:PANel {<NRf>}
<NRf> = 1 to 4 (file number)
Example :STORE:PANEL 1
6-32 IM WT310-17EN
6.16 SYSTem Group 1
The commands in this group deal with the system. You can make the same settings and queries that you can by
pressing the UTILITY key on the front panel and then using the inFo or rESo menu or by pressing the KEY PROTECT 2
or INTERFACE key.
:SYSTem? :SYSTem:RESolution
Function Queries all system settings. Function Sets or queries the numeric data display 3
Syntax :SYSTem? resolution.
Syntax :SYSTem:RESolution {<NRf>}
:SYSTem:MODel? :SYSTem:RESolution?
Function Queries the model code. <NRf> = 4, 5 (digit) 4
Syntax :SYSTem:MODel? Example :SYSTEM:RESOLUTION 5
Example :SYSTEM:MODEL? :SYSTEM:RESOLUTION?
-> :SYSTEM:MODEL "WT310" -> :SYSTEM:RESOLUTION 5
Description Returns the Model item of the Utility -> Info menu. 5
:SYSTem:COMMunicate:COMMand
:SYSTem:SUFFix? Function Sets or queries the command type.
Function Queries the suffix code. Syntax :SYSTem:COMMunicate:COMMand
Syntax :SYSTem:SUFFix? {WT300|WT200} 6
Example :SYSTEM:SUFFIX? :SYSTem:COMMunicate:COMMand?
-> :SYSTEM:SUFFIX "-D-C1/C7/EX1/G5/ Example :SYSTEM:COMMUNICATE:COMMAND WT300
Commands
DA4" :SYSTEM:COMMUNICATE:COMMAND?
Description Returns the Suffix item string of the Utility -> Info -> :SYSTEM:COMMUNICATE:COMMAND WT300 7
menu.
:SYSTem:COMMunicate:ETHernet:
:SYSTem:SERial? MACaddress?
Function Queries the serial number. Function Sets or queries the Ethernet MAC address. 8
Syntax :SYSTem:SERial? Syntax :SYSTem:COMMunicate:ETHernet
Example :SYSTEM:SERIAL? :MACaddress?
-> :SYSTEM:SERIAL "123456789A" Example :SYSTEM:COMMUNICATE:ETHERNET
Description Returns the No. item string of the Utility -> Info :MACADDRESS? App
menu. -> :SYSTEM:COMMUNICATE:ETHERNET:
MACADDRESS "000064_809_413"
:SYSTem:VERsion[:FIRMware]? Description This command is only valid on models with the
Function Queries the firmware version. Ethernet interface (/C7) option. Index
Syntax :SYSTem:VERsion[:FIRMware]?
Example :SYSTEM:VERSION:FIRMWARE? -> "1.01"
Description Returns the Ver. item string of the Utility -> Info
menu.
:SYSTem:KLOCk
Function Sets or queries the on/off state of the key
protection.
Syntax :SYSTem:KLOCk {<Boolean>}
:SYSTem:KLOCk?
Example :SYSTEM:KLOCK OFF
:SYSTEM:KLOCK? -> :SYSTEM:KLOCK 0
IM WT310-17EN 6-33
6.17 Common Command Group
The commands in this group are defined in IEEE 488.2-1992 and are independent from the instrument’s individual
functions. There are no front panel keys that correspond to the commands in this group.
*CAL? *ESR?
Function Executes zero calibration (zero-level Function Queries and clears the standard event register.
compensation, the same operation as pressing Syntax *ESR?
CAL (SHIFT+SET)) and queries the result. Example *ESR? -> 32
Syntax *CAL? Description • A sum of the values of each bit is returned in
Example *CAL? -> 0 decimal format.
Description If the zero-level compensation ends normally, 0 is • When an SRQ is sent, you can check what
returned. If an error is detected, 1 is returned. types of events have occurred.
• For example, if a value of 32 is returned, this
*CLS indicates that the standard event register is
Function
Clears the standard event register, extended set to 00100000. This means that the SRQ
event register, and error queue. occurred due to a command syntax error.
Syntax *CLS • A query using *ESR? will clear the contents of
Example *CLS the Standard Event Register.
Description • If the *CLS command is located immediately • For information about the standard event
after the program message terminator, the register, see page 7-4.
output queue is also cleared.
• For information about each register and queue, *IDN?
see chapter 7. Function Queries the instrument model.
Syntax *IDN?
*ESE Example *IDN? ->
Function
Sets or queries the standard event enable YOKOGAWA,WT310,123456789A,F1.01
register. Description • The information is returned in this form:
Syntax *ESE {<NRf>} <manufacture>, <model>, <serial number>,
*ESE? <firmware version>.
<NRf> = 0 to 255 • For details on the model, see “Checking the
Example *ESE 251 Package Contents” in the Getting Started
*ESE? -> 251 Guide, IM WT310-02EN.
Description • Specify the value as a sum of the values of
each bit in decimal format. *OPC
• For example, specifying *ESE 251 will cause Function
Sets bit 0 (the OPC bit) of the standard event
the standard enable register to be set to register to 1 upon the completion of the specified
11111011. In this case, bit 2 of the standard overlap command.
event register is disabled. This means that bit 5 Syntax *OPC
(ESB) of the status byte register is not set to 1, Example *OPC
even if a query error occurs. Description • This instrument does not have overlap
• The default value is *ESE 0 (all bits disabled). commands. The OPC bit is always set to 1.
• A query using *ESE? will not clear the contents
of the standard event enable register.
• For information about the standard event
enable register, see page 7-4.
6-34 IM WT310-17EN
6.17 Common Command Group
*OPC? *SRE 1
Function Returns ASCII code 1 if the specified overlap Function
Sets or queries the service request enable
command has finished. register value.
Syntax *OPC? Syntax *SRE {<NRf>}
Example *OPC? -> 1 *SRE?
2
Description This instrument does not have overlap <NRf> = 0 to 255
commands. 1 is always returned. Example *SRE 239
*SRE?
*OPT? -> 175 (because the bit 6, MSS, setting is
3
Function Queries the installed options. ignored)
Syntax *OPT? Description • Specify the value as a sum of the values of
Example *OPT? -> C1,C7,EX1,G5,DA4 each bit in decimal format.
Description • This command returns whether the GP-IB • For example, specifying *SRE 239 will cause
4
(C1), RS-232 (C2), Ethernet communication the standard enable register to be set to
(C7), external current sensor input (EX1, 2.5 11101111. In this case, bit 4 of the service
V/5 V/10 V), external current sensor input request enable register is disabled. This means
(EX2, 50 mV/100 mV/200 mV/500 mV/1 V/2 that bit 4 (MAV) of the status byte register is
5
V), harmonic measurement (G5), 4-channel D/ not set to 1, even if the output queue is not
A output (DA4, for the WT310 and WT310HC), empty.
and 12-channel D/A output (DA12, for the • Bit 6 (MSS) of the status byte register is the
WT332 and WT333) are available. MSS bit itself and is therefore ignored.
6
• The *OPT? query must be the last query of a • The default value is *SRE 0 (all bits disabled).
program message. • A query using *SRE? will not clear the contents
Commands
An error occurs if there is a query after the of the service request enable register.
*OPT query. • For information about the service request
enable register, see page 7-3.
7
*RST
Function Initializes the settings. *STB?
Syntax *RST
Example *RST
Function Queries the Status Byte Register value.
Syntax *STB?
8
Description All settings except communication settings are Example *STB? -> 4
reset to their factory default values. For details Description • A sum of the values of each bit is returned as a
on initialization, see section 8.2 in the User’s decimal value.
App
Manual, IM WT310-01EN. • Because the register is read without executing
serial polling, bit 6 is an MSS bit, not an RQS
bit.
• For example, if a value of 4 is returned, this
Index
indicates that the status byte register is set to
00000100. This means that the error queue is
not empty (in other words, an error occurred).
• A query using *STB? will not clear the contents
of the status byte register.
• For information about the status byte register,
see page 7-3.
*TRG
Function Executes single measurement (the same
operation as when SINGLE (SHIFT+HOLD) is
pressed).
Syntax *TRG
Example *TRG
Description A multi-line message GET (Group Execute
Trigger) will perform the same operation as this
command.
IM WT310-17EN 6-35
6.17 Common Command Group
*TST?
Function Executes a self-test and queries the result.
Syntax *TST?
Example *TST? -> 0
Description • The self-test consists of tests of each kind of
internal memory.
• This command returns 0 if the self-test is
successful and 1 if it is not.
• It takes approximately 6 seconds for the test to
complete. When receiving a response from this
instrument, set the timeout to a relatively large
value.
*WAI
Function
Holds the execution of the subsequent command
until the completion of the specified overlap
command.
Syntax *WAI
Example *WAI
Description This instrument does not have overlap
commands. This command will be ignored.
6-36 IM WT310-17EN
Chapter 7 Status Reports
Status Reports 2
The figure below shows the format of status reports that are read by serial polling. This status report
format is an extended version of the status report format defined in IEEE 488.2-1992.
7 6 5 4 3 2 1 0 Service request
&
enable register 3
&
&
OR
& 4
&
&
&
5
MSS
7 6 ESB MAV EES EAV 1 0 Status byte
RQS
6
Service
request
occurrence Output Error
queue queue
7
7 6 5 4 3 2 1 0 Standard event
enable register
Status Reports
&
&
& 8
&
OR
&
&
& App
&
7 6 5 4 3 2 1 0 Standard event register
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Transition filter
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Condition register
IM WT310-17EN 7-1
7.1 About Status Reports
Enable Registers
The following registers are used to mask a bit so that the bit will not affect the status byte even
when it is set to 1.
Masked Register Mask Register
Status byte Service request enable register
Standard event register Standard event enable register
Extended event register Extended event enable register
7-2 IM WT310-17EN
7.2 Status Byte 1
Status Reports
byte is read, only the RQS bit is cleared. You cannot
This bit is set to 1 when the logical AND of the
read the MSS bit when serial polling is used.
standard event register and the standard event 8
enable register is 1. In other words, this bit is set Clearing the Status Byte
to 1 when a certain event takes place inside the There is no way to clear all the bits in the status byte.
instrument. For details, see page 7-4. The bits that are cleared for each operation are shown
• Bit 6 RQS (Request Service)/MSS (Master Status below. App
Summary) • *STB? query
This bit is 1 when the logical AND of the status None of the bits are cleared.
byte excluding bit 6 and the service request enable • Serial polling
register is 1. In other words, this bit is set to 1 when
Index
Only the RQS bit is cleared.
the instrument requests service from the controller. • When a *CLS command is received
RQS is set to 1 when the MSS bit changes from 0 to When a *CLS command is received, the status byte
1 and is cleared when serial polling is carried out or itself is not cleared, but the contents of the standard
when the MSS bit changes to 0. event register, which affects the bits in the status
byte, are cleared. As a result, the corresponding
Bit Masking
status byte bits are cleared. Because the output
To mask a bit in the status byte so that it does not
queue is not cleared with a *CLS command, bit 4
cause an SRQ, set the corresponding bit of the service
(MAV) in the status byte is not affected. However,
request enable register to 0.
the output queue will be cleared if the *CLS
For example, to mask bit 2 (EAV) so that service is not
command is received just after a program message
requested when an error occurs, set bit 2 of the service
terminator.
request enable register to 0. Do this using the *SRE
command. To query whether each bit of the service
request enable register is 1 or 0, use *SRE?. For
details on the *SRE command, see chapter 6.
Bit Masking
To mask a certain bit of the standard event register so
that it does not cause bit 5 (ESB) in the status byte to
change, set the corresponding bit of the standard event
enable register to 0.
For example, to mask bit 2 (QYE) so that ESB will not
be set to 1 even if a query error occurs, set bit 2 of
the standard event enable register to 0. Do this using
the *ESE command. To query whether each bit of the
standard event enable register is 1 or 0, use *ESE?.
For details on the *ESE command, see chapter 6.
7-4 IM WT310-17EN
7.4 Extended Event Register 1
The extended event register receives information about changes in the condition register, which 2
indicates the instrument’s internal condition. The information is the result of edge detection
performed by the transition filter.
FILTer<x> 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
Condition register 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 3
:STATus:CONDition? 0 POA3 POV3 OVR3 POA2 POV2 OVR2 POA1 POV1 OVR1 STR FOV OVRS ITM ITG UPD
Transition filter 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
:STATus:FILTer<x>
{RISE|FALL|BOTH|NEVer} 4
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Extended event register
:STATus:EESR?
5
The condition register bits are described below.
Bit 0 UPD Set to 1 when the measured data is being updated.
(Updating) UPD changing from 1 to 0 indicates that updating has been
completed. 6
Bit 1 ITG Set to 1 during integration.
(Integrate Busy)
Bit 2 ITM Set to 1 when the integration timer is operating.
(Integrate Timer Busy)
Bit 3 OVRS Set to 1 when the computed result of Σ overflows. 7
(Σ results overflow)
Bit 4 FOV Set to 1 when the frequency is outside the measurement range.
Status Reports
(Frequency Over)
Bit 5 STR
(Store busy)
Set to 1 during storage.
8
Bit 6 OVR1 Set to 1 when the voltage or current of element 1 exceeds its
(Element1 mesured data over) range.
Bit 7 POV1 Set to 1 when a peak over-range is detected in the element 1
(Element1 voltage peak over) voltage. App
Bit 8 POA1 Set to 1 when a peak over-range is detected in the element 1
(Element1 current peak over) current.
Bit 9 OVR2 Set to 1 when the voltage or current of element 2 exceeds its
(Element2 mesured data over) range.
Bit 10 POV2 Set to 1 when a peak over-range is detected in the element 2 Index
(Element2 voltage peak over) voltage.
Bit 11 POA2 Set to 1 when a peak over-range is detected in the element 2
(Element2 current peak over) current.
Bit 12 OVR3 Set to 1 when the voltage or current of element 3 exceeds its
(Element3 mesured data over) range.
Bit 13 POV3 Set to 1 when a peak over-range is detected in the element 3
(Element3 voltage peak over) voltage.
Bit 14 POA3 Set to 1 when a peak over-range is detected in the element 3
(Element3 current peak over) current.
The transition filter parameters detect changes in the specified condition register bits (numeric
suffixes 1 to 16) and overwrite the extended event register in the following ways.
RISE The specified extended event register bit is set to 0 when the corresponding condition register
bit changes from 1 to 1.
FALL The specified extended event register bit is set to 1 when the corresponding condition register
bit changes from 0 to 1.
BOTH The specified extended event register bit is set to 1 when the corresponding condition register
bit changes from 0 to 1 or from 1 to 0.
NEVer Always zero.
IM WT310-17EN 7-5
7.5 Output and Error Queues
Output Queue
The output queue stores query response messages. For example, if you send a :NUMeric[:
NORMal]:VALue? command, which requests for the transmission of measured data, the data is
stored in the output queue until it is read.
As shown below, data is stored in order and read from the oldest message first. The output queue is
cleared in the following cases.
• When a new message is received from the controller.
• When a deadlock occurs (see page 5-2).
• When a device clear command (DCL or SDC) is received.
• When this instrument is restarted.
The *CLS command does not clear the output queue. You can determine whether or not the output
queue is empty by checking bit 4 (MAV) in the status byte.
D2
D1 D1 D2
D1
Error Queue
When an error occurs, the error queue stores the error number and message. For example, if the
instrument receives an incorrect program message from the controller, the error number (113) and
the error message (“Undefined header”) are stored in the error queue when the instrument displays
the error message.
You can use the :STATus:ERRor? query to read the contents of the error queue. Like the output
queue, the messages in the error queue are read from the oldest one first.
If the error queue overflows, the last message is replaced with the following message: 350, “Queue
overflow.”
The error queue is cleared in the following cases.
• When a *CLS command is received.
• When this instrument is restarted.
You can determine whether or not the error queue is empty by checking bit 2 (EAV) in the status
byte.
7-6 IM WT310-17EN
Chapter 8 WT210/WT230 Compatible Commands
Procedure 2
Follow the procedure indicated by the thick lines in the following menu.
Select the command mode.
1. (Display B)
3
2.
3. (Display D) 5.
4. 4
Set, close menu.
5
Explanation
Many of the functions of this instrument can be controlled with the legacy model WT210/WT230
communication commands. For these functions, WT210/WT230 communication programs can be
6
used on this instrument.
Command Mode 7
• WT300: Command mode in which communication commands of this instrument are used These
commands are not compatible with WT210/WT230 communication commands.
• WT200: Command mode in which the commands are compatible with WT210/WT230
communication commands. 8
AOUTput Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
D/A output item (during normal AOUTput:CHANnel<x> A B NONE = No output item
measurement) <x> = <Function> = {U|I|P|S|Q|LA
1 to 12 (for /DA12) MBda|PHI|FU|FI|WH|WHP|WH
1 to 4 (for /DA4, /CMP) M|AH|AHP|AHM|MATH|UPeak|
IPeak}
<Element> = {<NRf>|SIGMa}
(<NRf> = 1 to 3)
Sets or queries the rated :AOUTput:IRTime B Cannot be set with a string. B Cannot be set with a string.
integration time.
Resets settings to their :AOUTput:PRESet A A
defaults.
IM WT310-17EN 8-1
8.1 WT210/WT230 Compatible Mode
COMMunicate group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries whether :COMMunicate:HEADer A A
headers are attached to
response data.
Sets/clears local lockout. :COMMunicate:LOCKout A A
Sets remote or local mode. :COMMunicate:REMote A A
Queries the line-specific status. :COMMunicate:STATus? A A
Sets or queries whether query :COMMunicate:VERBose A A
responses are returned in full
or abbreviated form.
Waits for the specified :COMMunicate:WAIT A A
extended event to occur.
Creates a response for the :COMMunicate:WAIT? A A
specified extended event.
CONFigure Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Queries all averaging settings. [:CONFigure]:AVERaging? A D :MEASure:AVERaging?
Sets or queries the on/off state [:CONFigure]:AVERaging[: A D :MEASure:AVERaging[:STATe]
of averaging. STATe]
Sets or queries the averaging [:CONFigure]:AVERaging: A D :MEASure:AVERaging:TYPE
type. TYPE :MEASure:AVERaging:COUNt
Sets or queries the crest factor. [:CONFigure]:CFACtor A D [:INPut]:CFACtor
Queries all current range [:CONFigure]:CURRent? A D [:INPut]:CURRent?
settings.
Sets or queries the current [:CONFigure]:CURRent:AUTO A D [:INPut]:CURRent:AUTO
auto range on/off state.
Queries all external current [:CONFigure]:CURRent: A D [:INPut]:CURRent:SRATio?
sensor scaling constant settings. ESCaling?
Sets the external current [:CONFigure]:CURRent: A You can set the external D [:INPut]:CURRent:SRATio[:
sensor scaling constant on all ESCaling[:ALL] current sensor scaling ALL]
elements at once. constant using the “A/
Sets or queries the external [:CONFigure]:CURRent: A FS(mV)” form, just like D [:INPut]:CURRent:SRATio:
current sensor scaling constant ESCaling:ELEMent<x> the WT210/WT230 ELEMent<x>
of an element. computation method.
FS = External current
sensor range rating
Sets or queries the current [:CONFigure]:CURRent: A D [:INPut]:CURRent:RANGe
range. RANGe
Sets or queries the frequency [:CONFigure]:FILTer A D [:INPut]:FILTer:FREQuency
filter on/off state.
Sets or queries the line filter [:CONFigure]:LFILter A D [:INPut]:FILTer:LINE
on/off state.
Sets or queries the MAX hold [:CONFigure]:MHOLd[:STATe] A D :MEASure:MHOLd
on/off state.
Sets or queries the [:CONFigure]:MODE A D [:INPut]:MODE
measurement mode.
Queries all scaling settings. [:CONFigure]:SCALing? A D [:INPut]:SCALing?
Queries the [:CONFigure]: A D [:INPut]:
{voltage|current|power} scaling SCALing:{PT|CT|SFACtor}? SCALing:{VT|CT|SFACtor}?
constant.
Sets the {voltage|current|power} [:CONFigure]: A D [:INPut]:
scaling constant on all elements SCALing:{PT|CT|SFACtor} SCALing:{VT|CT|SFACtor}[:
at once. [:ALL] ALL]
Sets or queries the [:CONFigure]: A D [:INPut]:
{voltage|current|power} scaling SCALing:{PT|CT|SFACtor}: SCALing:{VT|CT|SFACtor}:
constant of an element. ELEMent<x> ELEMent<x>
Sets or queries the scaling [:CONFigure]:SCALing[: A D [:INPut]:SCALing[:STATe]
on/off state. STATe]
8-2 IM WT310-17EN
8.1 WT210/WT230 Compatible Mode
4
DISPlay Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the element to :DISPlay<x>:ELEMent A D Normal measurement data: 5
be displayed. <x> = 1 to 3 :DISPlay[:NORMal]:ITEM<x>
1: Display A {<Function>[,<Element>]}
2: Display B
3: Display C Harmonic measurement data:
Sets or queries the function to :DISPlay<x>:FUNCtion A When you set the following D :DISPlay:HARMonics:ITEM<x> 6
be displayed. <x> = 1 to 3 functions, the content of {<Function>[,<Element>]}
1: Display A display D changes.
2: Display B • During normal
3: Display C measurement
•VHZ 7
•AHZ
• During harmonic
measurement
•VTHD
•ATHD
8
•PF
HARMonics Group
Index
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the harmonic :HARMonics:DISPlay:ORDer A A
order of the harmonic
component that is shown in
display B for the harmonic
measurement data display.
Sets or queries the harmonic :HARMonics:ELEMent A D All elements are subject to
measurement source element. harmonic measurement, so
setting this is not necessary.
Sets or queries the on/off state :HARMonics[:STATe] A D :HARMonics:DISPlay[:STATe]
of harmonic measurement
mode.
Sets or queries the PLL source. :HARMonics:SYNChronize A D :HARMonics:PLLSource
Sets or queries the equation :HARMonics:THD A D :HARMonics:THD
used to compute the THD (total {FUNDamental|TOTal}
harmonic distortion).
IM WT310-17EN 8-3
8.1 WT210/WT230 Compatible Mode
INTEGrate Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the integration :INTEGrate:MODE A A
mode.
Resets the integrated value. :INTEGrate:RESet A A
Starts integration. :INTEGrate:STARt A A
Stops integration. :INTEGrate:STOP A A
Sets or queries the integration :INTEGrate:TIMer B Cannot be set with a string. B Cannot be set with a string.
timer value.
MATH Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the equation of :MATH:ARIThmetic A D :MATH
four arithmetic operations. {EFFiciency|CFU<x>|CFI
Sets or queries the average :MATH:AVERage A D <x>|ADD|SUB|MUL|DIV|DIVA|
active power computation DIVB|AVW<x>}
while integration is in progress. EFFiciency: Efficiency
Sets or queries the crest factor :MATH:CFACtor A D CFU<x>,CFI<x> :
equation. Voltage and current crest
Sets or queries the :MATH:TYPE A D factor<x> = 1 to 3 (element)
computation type. AVW<x> :
Average active power during
integration
<x> = 1 to 3 (element), 4 (Σ)
MEASure Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Queries all harmonic :MEASure:HARMonics? A D :NUMeric:LIST?
measurement data settings.
Queries all settings related :MEASure:HARMonics:ITEM? A D :NUMeric:LIST:ITEM<x>
to the communication
output items of harmonic
measurement data.
Sets the communication output :MEASure:HARMonics:ITEM: A D :NUMeric:LIST:PRESet
on/off states of all harmonic PRESet
measurement functions to a
preset pattern at once.
Sets or queries the :MEASure:HARMonics: A D :NUMeric:LIST:ITEM<x>
communication output ITEM:{<harmonic measurement
on/off state of a harmonic function>|SYNChronize}
measurement function.
Queries the harmonic :MEASure:HARMonics:VALue? A D (1) :NUMeric:FORMat
measurement data that has :MEASure:HARMonics:BINary? {ASCii|FLOat}
been set with commands (2) :NUMeric:LIST:VALue?
that start with “MEASure:
HARMonics:ITEM.”
Sets or queries the additional :MEASure:HEADer C Setting and querying D
information output on/off state are possible, but setting
for when outputting measured/ this command to ON
computed data in binary will not cause additional
format. information to be output.
Queries all normal :MEASure:NORMal? A D :NUMeric:NORMal?
measurement data settings.
Queries all settings related :MEASure[:NORMal]:ITEM? A D :NUMeric:NORMal?
to the communication output
items of normal measurement
data.
Sets the communication output :MEASure[:NORMal]:ITEM: A D :NUMeric[:NORMal]:PRESet
on/off states of all normal PRESet
measurement functions to a
preset pattern at once.
8-4 IM WT310-17EN
8.1 WT210/WT230 Compatible Mode
RECall Group 7
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the recall :RECall:INTerval D The function for recalling D
interval. to the screen of this
instrument is not available. 8
Loads a setup parameter file. :RECall:PANel A A
SAMPle Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the output data :SAMPle:HOLD A A :HOLD
(display, communication, etc.)
hold state.
Sets or queries the data :SAMPle:RATE A A :RATE
update interval.
IM WT310-17EN 8-5
8.1 WT210/WT230 Compatible Mode
STATus Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Queries the contents of the :STATus:CONDition? A A
condition register.
Sets or queries the extended :STATus:EESE A A
event enable register.
Queries the contents of the :STATus:EESR? A A
extended event register and
clears the register.
Queries the error code and :STATus:ERRor? A A
message of the last error that
has occurred (top of the error
queue).
Sets or queries the transition :STATus:FILTer<x> A A
filter. <x> = 1 to 16
Sets or queries whether :STATus:QMESsage A A
message information will be
attached to the response to the
STATus:ERRor? query.
Executes serial polling. :STATus:SPOLl? A A
STORe Group
Function WT210/WT230 Command Command of This Instrument
Command Mode: WT200 Command Mode: WT300
Sets or queries the storage :STORe:INTerval B Cannot be set with a string. B Cannot be set with a string.
interval.
Save setup parameters to a :STORe:PANel A A
file.
Sets or queries the storage :STORe[:STATe] A A
on/off state.
8-6 IM WT310-17EN
8.1 WT210/WT230 Compatible Mode
1
Correspondence Table of WT210/WT230 Functions and Functions of This
Instrument
Function expressions are shown below. For the WT210/WT230 compatible command mode, see
the WT210/WT230 column.
2
IM WT310-17EN 8-7
Appendix
Appendix
111 Header separator error. Use a comma to separate each header from its data. 5-1
112 Program mnemonic too long. Check the command length. Chapter 6
113 Undefined header. Check the header. Chapter 6 Index
114 Header suffix out of range. Check the header. Chapter 6
120 Numeric data error. A value must be specified where the syntax contains 5-6
<NRf>.
123 Exponent too large. Where the syntax contains <NR3>, make the exponent 5-6 and
that follows E smaller. Chapter 6
124 Too many digits. Limit numeric values to 255 digits or less. 5-6 and
Chapter 6
128 Numeric data not allowed. Use a data type other than <NRf>. 5-6 and
Chapter 6
131 Invalid suffix. Check the unit of <Voltage>, <Current>, <Time>, or 5-6
<Frequency>.
134 Suffix too long. Check the unit of <Voltage>, <Current>, <Time>, or 5-6
<Frequency>.
138 Suffix not allowed. Only the following units can be used: <Voltage>, 5-6
<Current>, <Time>, <Frequency>.
141 Invalid character data. Be sure to select one of the listed choices when the Chapters 5
syntax contains {...|...|...}. and 6
144 Character data too long. Check the spelling of the strings when the syntax Chapter 6
contains {...|...|...}.
148 Character data not allowed. Use a data type other than {...|...|...}. Chapter 6
150 String data error. Enclose parameters with single or double quotation 5-7
marks where the syntax contains <String>.
IM WT310-17EN App-1
Appendix 1 Error Messages
App-2 IM WT310-17EN
Appendix 1 Error Messages
1
Communication Query Errors (400 to 499)
Error in communication Query
Code Message Corrective Action Page
410 Query INTERRUPTED. Check the transmission and reception order. 5-2 2
420 Query UNTERMINATED. Check the transmission and reception order. 5-2
430 Query DEADLOCKED. Keep program messages to 1024 bytes or less in length, 5-2
including <PMT>.
440 Query UNTERMINATED after indefinite response. Do not write a query after *IDN? or *OPT?. — 3
Appendix
Index
IM WT310-17EN App-3
Appendix 1 Error Messages
Information (1 to 99)
Code Message Corrective Action Page
3,80,87 The system has been initialized For descriptions of errors and their corrective actions, —
see section 6.2 in the Getting Started Guide, IM WT310-
02EN.
App-4 IM WT310-17EN
Appendix 2 About the IEEE 488.2-1992 Standard 1
The GP-IB interface of this instrument conforms to the IEEE 488.2-1992 standard. This standard specifies that the 2
following 23 items be stated in the document. This section describes these items.
(1) Of the IEEE 488.1 interface functions, the (8) A list of program data elements that can be
subsets that are supported used in equations and their nesting limitations
See section 2.2, “GP-IB Interface Features and Equations cannot be used. 3
Specifications.” (9) Syntax of the responses to queries
(2) The operation of the device when it is See the example of the commands given in
assigned an address outside the 0 to 30 chapter 6.
range. (10) Communication between devices that do not 4
The address of this instrument cannot be set to follow the response syntax
an address outside the 0 to 30 range. Not supported.
(3) Reaction of the device when the user changes (11) Size of the response data block
the address 0 to 24576 bytes 5
The address change is detected when the user (12) A list of supported common commands
presses INTERFACE and changes the address See section 6.17, “Common Command Group.”
on the GPib menu. The new address is valid until (13) Device condition after a successful calibration
the next time it is changed. The device will be performing measurements. 6
(4) Device settings at power-up. The commands (14) The maximum length of block data that can be
that can be used at power-up. used for the *DDT trigger macro definition
As a basic rule, the previous settings (the settings Not supported.
that were in use when this instrument was turned (15) The maximum length of the macro label for 7
off) are used. defining macros, the maximum length of block
There are no limitations on the commands that data that can be used for the macro definition,
can be used at power-up. and the process when recursion is used in
(5) Message exchange options macro definitions 8
(a) Input buffer size Macro functions are not supported.
1024 bytes. (16) Reply to the *IDN? query
(b) Queries that return multiple response See section 6.17, “Common Command Group.”
messages (17) Size of storage area for protected user data App
See the example of the commands given in for PUD and *PUD?
Appendix
chapter 6. *PUD and *PUD? are not supported.
(c) Queries that create response data when (18) The length of the *RDT and *RDT? resource
the command syntax is being analyzed names Index
All queries create response data when the *RDT and *RDT? are not supported.
command syntax is analyzed. (19) The change in the status due to *RST, *LRN?,
(d) Queries that create response data during *RCL, *SAV, and *RST
reception See section 6.17, “Common Command Group.”
There are no queries of which the response data *LRN?, *RCL, and *SAV
are created upon receiving a send request from These common commands are not supported.
the controller. (20) The extent of the self-test using the *TST?
(e) Commands that have parameters that command
restrict one another See section 6.17, “Common Command Group.”
See the example of the commands given in (21) The structure of the extended return status
chapter 6. See chapter 7.
(6) Items that are included in the functional or (22) Whether each command is processed in an
composite header elements constituting a overlapped manner or sequentially
command See section 5.5, “Synchronization with the
See chapters 5 and 6. Controller” and chapter 6.
(7) Buffer sizes that affect block data (23) The description of the execution of each
transmission command
When block data is being transmitted, the output See the explanations of each command’s function
queue is expanded to match the size of the data in chapter 6 and the User’s Manual, IM WT310-
that is being transmitted. 01EN.
IM WT310-17EN App-5
Index 1
A Page G Page 2
abbreviated form................................................................... 5-5 GET (Group Execute Trigger)................................................ 2-7
address.................................................................................. 2-2 GP-IB address....................................................................... 2-6
addressable mode................................................................. 2-2 GP-IB board.......................................................................... 2-4
auto range.................................................................. 6-12, 6-13
averaging............................................................................. 6-18
GP-IB Interface......................................................................
Group....................................................................................
2-2
5-3 3
GTL (Go To Local)................................................................. 2-7
B Page
baud rate............................................................................... 3-8 H Page
block data.............................................................................. 5-7 handshaking.......................................................................... 3-6 4
boolean.................................................................................. 5-7 harmonic measurement....................................................... 6-10
harmonic order.................................................................... 6-10
C Page hold....................................................................................... 6-11
CAL...................................................................................... 6-34
I Page 5
character data....................................................................... 5-7
check range status.............................................................. 6-15 IFC (Interface Clear).............................................................. 2-7
command............................................................................. 6-33 initialization.......................................................................... 6-35
command mode..................................................................... 8-1 input filter............................................................................. 6-15
commands............................................................................. 5-3 integration............................................................................ 6-16 6
common command header.................................................... 5-3 integration mode.................................................................. 6-16
computation function........................................................... 6-17 integration, reset.................................................................. 6-16
condition register................................................................. 6-31 integration, start................................................................... 6-16
crest factor........................................................................... 6-12 integration, stop................................................................... 6-16
CS-RS................................................................................... 3-7 integration timer................................................................... 6-16 7
CT ratio................................................................................ 6-14 IP address............................................................................. 4-5
current................................................................................... 5-6
current range....................................................................... 6-13 K Page
D Page
key lock............................................................................... 6-33 8
D/A output.............................................................................. 6-5 L Page
D/A output items.................................................................... 6-5
library......................................................................................... ii
Data....................................................................................... 5-6
line filter............................................................................... 6-15
data format............................................................................ 3-8
LLO (Local Lockout).............................................................. 2-7
App
data update interval............................................................. 6-29
load...................................................................................... 6-30
DCL (Device Clear)............................................................... 2-7
LOAD................................................................................... 6-30
deadlock................................................................................ 5-2
local lockout........................................................................... 6-7
default gateway..................................................................... 4-5
DHCP.................................................................................... 4-5 Index
display................................................................................... 6-8 M Page
display resolution................................................................. 6-33 MAC address....................................................................... 6-33
Index
driver......................................................................................... ii MAX hold............................................................................. 6-18
measurement mode............................................................ 6-12
E Page messages.............................................................................. 5-1
model.......................................................................... 6-33, 6-34
Error Messages................................................................. App-1
model code.......................................................................... 6-33
error queue............................................................................ 7-6
Ethernet interface.................................................................. 4-2
extended event register................................................ 6-31, 7-5 N Page
external event enable register............................................. 6-31 NRf........................................................................................ 5-7
external sensor conversion ratio......................................... 6-14 numeric data........................................................................ 6-19
external sensor range.......................................................... 6-13 numeric data format............................................................ 6-25
F Page O Page
firmware............................................................................... 6-33 OFF-OFF............................................................................... 3-6
frequency filter..................................................................... 6-15 option................................................................................... 6-35
front panel........................................................ 1-1, 2-1, 3-1, 4-1 output queue......................................................................... 7-6
function selection................................................................. 6-24 overlap command.................................................................. 5-8
IM WT310-17EN Index-1
Index
P Page V Page
peak over-range.................................................................. 6-15 version................................................................................. 6-33
PLL source.......................................................................... 6-10 voltage................................................................................... 5-6
power factor......................................................................... 6-14 voltage range....................................................................... 6-12
preset.................................................................................. 6-26 VT ratio................................................................................ 6-14
program messages................................................................ 5-1
W Page
Q Page wiring system....................................................................... 6-12
Query..................................................................................... 5-1 WT210/W230........................................................................ 8-1
WTViewerFreePlus.................................................................... ii
R Page
range configuration.............................................................. 6-14 X Page
range skip............................................................................ 6-14 XON-XON.............................................................................. 3-6
rear panel......................................................... 1-1, 2-1, 3-1, 4-1
Register................................................................................. 5-7 Z Page
remote................................................................................... 6-7
zero-level compensation..................................................... 6-34
remote and local modes, switching.................. 1-2, 2-3, 3-2, 4-2
REN (Remote Enable)........................................................... 2-7
response................................................................................ 5-5
response messages.............................................................. 5-1
responses without headers................................................... 5-5
RS-232 interface................................................................... 3-2
S Page
Sample Programs...................................................................... ii
SAVE................................................................................... 6-30
scaling................................................................................. 6-14
SDC (Selected Device Clear)................................................ 2-7
self-test................................................................................ 6-36
serial number....................................................................... 6-33
serial polling........................................................................ 6-31
service request enable register........................................... 6-35
setup parameters................................................................ 6-32
single measurement............................................................ 6-35
SPD (Serial Poll Disable)...................................................... 2-7
SPE (Serial Poll Enable)....................................................... 2-7
standard event enable register............................................ 6-34
standard event register................................................. 6-34, 7-4
status byte............................................................................. 7-3
status byte register.............................................................. 6-35
status report........................................................................ 6-31
status reports......................................................................... 7-1
storage................................................................................ 6-32
storage interval.................................................................... 6-32
string data.............................................................................. 5-7
subnet mask.......................................................................... 4-5
suffix.................................................................................... 6-33
suffix code........................................................................... 6-33
synchronization source........................................................ 6-14
T Page
TCP/IP................................................................................... 4-5
terminator.............................................................................. 3-8
time........................................................................................ 5-6
TMCTL....................................................................................... ii
transition filter............................................................... 6-31, 7-5
U Page
upper-level query................................................................... 5-4
USB cable............................................................................. 1-3
USB hub................................................................................ 1-3
USB interface........................................................................ 1-2
USB TMC.............................................................................. 1-4
Index-2 IM WT310-17EN