This manual explains the communication commands for the above Power Meter
models only.
Please refer to the instruction manual for your Power Meter for details regarding
command settings.(Chapter 4 “Connection to a PC”)
Although all reasonable care has been taken in the production of this manual, should you
find any points which are unclear or in error, please contact your local distributor or the
HIOKI International Sales & Marketing Division at os-com@hioki.co.jp.
In the interest of product development, the contents of this manual may be
subject to revision without notice.
Unauthorized reproduction or copying of this manual is prohibited.
Be sure to review the Instruction Manual for your Power Meter before using the
instrument.
PW3336A987-01
Contents
1 Introduction
Message Format
Output Queue and Input Buffer
Status Byte Register
Event Registers
Initialization Items
Command Execution Time
Errors During Communications
Event Status Register
Measurement Settings
Voltage Range
Current Range
Frequency Range (Zero-crossing Filter)
Synchronization Source
VT Ratio/CT Ratio
D/A output
Instrument Display Settings
Measurement Value Output
This manual is for Power Meter models PW3336(-01, -02, -03) and PW3337(-01, -02, -03).
Messages are provided in the interface to control the Power Meter.
There are two types of messages: program messages that are sent from the controller (such as a computer) to the
Power Meter and response messages that are sent from the Power Meter to the controller.
There are also execution confirmation messages for synchronization with the controller in the RS-232C interface.
Message types are further categorized as follows.
Program Messages
Messages Response Messages
Execution Confirmation Messages
When issuing commands that contain data, make sure that the data is provided in the specified format.
When connecting via LAN, connect to TCP/IP port 3300.
Command Messages
Query Messages
During communication the Power Meter will enter the Remote state and the REMOTE Indicator on the unit will
turn ON.
When this occurs, all operation keys except for SHIFT(EXIT/LOCAL) will be disabled.
However, if the Power Meter is in the Local Lock Out state via GP-IB (GP-IB command LLO:Local Lock Out ->
P.12), the SHIFT(EXIT/LOCAL) Key will also be disabled. If this occurs, execute the GTL (Go To Local)
interface function or turn the Power Meter OFF and ON again to return to the Local state.
If the Power Meter enters the Remote state when on the settings screen, it will automatically change to the
measurement display.
PW3336A987-01
2
Message Format
Program Messages
Program messages can be either Command Messages or Query Messages.
(1) Command Messages
Instructions to control the instrument, such as to change settings or reset
Example: Instruction to set the voltage range (ch1).
:VOLTAGE1:RANGE 300
Header portion Space Data portion
(2) Query Messages
Requests for responses relating to results of operation or
measurement, or the state of instrument settings
Example: Request for the current measurement range
When a query message is received, its syntax is checked and a response message is generated.The :HEADer command determines whether headers are prefixed to response messages.
Header ON :VOLTAGE1:RANGE 300
Header OFF 300
At power-on, Header ON is selected.
If an error occurs when a query message is received, no response message is generated for that query.
Command Syntax
Command names are chosen to mnemonically represent their function, and can be abbreviated. The full
command name is called the “long form”, and the abbreviated name is called the “short form”. The
command references in this manual indicate the short form in upper-case letters, extended to the long form
in lower case letters, although the commands are not case-sensitive in actual usage.
DISPLAY?
DISP?
DISPL?
DIS?
Response messages generated by the instrument are in long form and in upper case letters.
Headers
Headers must always be prefixed to program messages.
(1) Command Program Headers
There are three types of commands: Simple, Compound, and Standard.
• Headers for Simple Commands
This header type is a sequence of letters and digits.
:ESE0
• Headers for Compound Commands
These headers consist of multiple simple command type headers separated by colons ":".
:VOLTage1:RANGE
Header portion Question mark
(The current voltage range for ch1 is 300 V.)
OK ( long form
OK ( short form
Error
Error
)
)
PW3336A987-01
3
•
LF
•
CR+LF
•
EOI
•
LF
with an EOI
•
CR
•
CR+LF
•
LF
with an EOI
•
CR
+ LF
with an EOI (default)
•
LF
•
CR+LF (default)
• Headers for Standard Commands
This header type begins with an asterisk "*", indicating that it is a standard command defined by IEEE 488.2.
*RST
(2) Query Program Header
These commands are used to query the instrument about the results of operations, measured values, and the
current states of instrument settings.
As shown in the following examples, a query is formed by appending a question mark ? after a program header.
:HOLD?
:VOLTage:RANGe?
Characters within square brackets [ ] may be omitted.
Either form is valid
:MEASure[:NORMAL]:VALue? :MEASure:VALue?
Message Terminators
The instrument recognizes the following message terminators (delimiters):
Depending on the instrument's interface settings, the following can be selected as the terminator for response
messages.
For information on settings, see "Terminator Setting" (p. 107).
Separators
(1) Message Unit Separator
Multiple messages can be written in one line by separating them with semicolons ";".
:VOLTage1:RANGe 300;:AVERaging 10
• When messages are combined in this way and if one command contains an error, all subsequent messages
up to the next terminator will be ignored.
(2) Header Separator
In a message consisting of both a header and data, the header is separated from the data by a space
“ ” (ASCII code 20H).
: VOLTage1: RANGe 300
(3) Data Separator
In a message containing multiple data items, commas are required to separate the data items from one another.
:MEASure? U1, I1
PW3336A987-01
4
The instrument does not completely support IEEE 488.2. Use referenced data whenever possible.
Also be careful not to overflow the input buffer or output queue with a single command.
Data Formats
The instrument uses character data, decimal numeric data and character string data depending on the command.
(1) Character Data
Character data always begins with an alphabetic character, and subsequent characters may be either
alphabetic or numeric. Character data is not case-sensitive, although response messages from the instrument
are only upper case. When the command data portion contains <1/0/ON/OFF>, the operation will be the same
as when 0 is OFF and 1 is ON.
:HEADER OFF
(2) Decimal Numeric Data
Three formats are used for numeric data: NR1, NR2 and NR3. Numeric values may be signed or unsigned.
Unsigned numeric values are handled as positive values. Values exceeding the precision handled by the
instrument are rounded to the nearest valid digit.
NR1 Integer data (e.g.: +12, -23, 34)
•
NR2 Fixed-point data (e.g.: +1.23, -23.45, 3.456)
•
NR3 Floating-point exponential representation data (e.g.: +1.0E-2, -2.3E+4)
•
The term “NRf format” includes all three of the above numeric decimal formats.
The instrument accepts NRf format data. The format of response data is specified for each command, and the
data is sent in that format.
:AVERAGING 10
Compound Command Header Omission
When several commands having a common header are combined to form a compound command (for
example, :VOLTage1:AUTO and :VOLTage1:RANGe), if they are written together in sequence, the common
portion (here, :VOLTage1:) can be omitted after its initial occurrence.
This common portion is called the “current path” (analogous to the path concept in computer file storage), and until
it is cleared, the interpretation of subsequent commands presumes that they share the same common portion.
This usage of the current path is shown in the following example:
Full expression
:VOLTage1:AUTO OFF;:VOLTage1:RANGe 300
Compacted expression
:VOLTage1:AUTO OFF;RANGe 300
The current path allows you to abbreviate the next command.
The current path is cleared when the power is turned on, when reset by key input, by a colon “:” at the start of
a command, and when a message terminator is detected.
Standard command messages can be executed regardless of the current path. They have no effect upon the
current path.
A colon “:” is not required at the start of the header of a Simple or Compound command. However, to avoid
confusion with abbreviated forms and operating mistakes, we recommend always placing a colon at the start of
a header.
PW3336A987-01
5
• Power on
• Device clear
• Query error
Output Queue and Input Buffer
Output Queue
Response messages are stored in the output queue until read by the controller. The output queue is also cleared
in the following circumstances:
The output queue capacity of the instrument is 4,096 bytes. If response messages overflow the buffer, a query
error is generated and the output queue is cleared.
Input Buffer
The input buffer capacity of the instrument is 1,024 bytes.
If 1,024 bytes are allowed to accumulate in this buffer so that it becomes full, the GP-IB interface bus enters the
waiting state until space is cleared in the buffer.
The RS-232C and LAN interfaces will not accept data beyond 1,024 bytes.
Note: Ensure that the length of a single line never exceeds 1,024 bytes.
PW3336A987-01
6
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
unused
SRQ
ESB
MAV
ESB3
ESB2
ESB1
ESB0
Status Byte Register
(STB)
MSS
↑ ↓ ↓ ↓ ↓ ↓
↓
Logical
sum
←&& & & &
&
↑ ↑ ↑ ↑ ↑
↑
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
unused
0
ESB
MAV
ESB3
ESB2
ESB1
ESB0
Service Request
Enable Register
(SRER)
Status Byte Register
The instrument uses the status model defined by the IEEE 488.2 standard for items related to serial polling
via the service request function.
Events are what trigger service requests.
Standard Event Register Description
Service Request Output Queue data information
SRQ occurrence Each of these bits correspond to a specific event register
Overview of Service Request Occurrence
The Status Byte Register contains information about the event registers and the output queue.
Required items are selected from this information by masking with the Service Request Enable
Register.
When any bit selected by the mask is set, bit 6 (MSS; the Master Summary Status) of the Status Byte
Register is also set, which generates an SRQ (Service Request) message and dispatches a service
request.
SRQs (Service Requests) can be used only with the GP-IB interface.
However, SRER setting (*SRE?) and STB read (*STB?) queries can be used even with the RS-232C
and LAN interfaces.
PW3336A987-01
7
Bit 7
unused
Bit 6
SRQ
Set to 1 when a service request is dispatched.
MSS
This is the logical sum of the other bits of the Status Byte Register.
Bit 5
ESB
Standard Event Status (logical sum) bit
This is the logical sum of the Standard Event Status Register.
Bit 4
MAV
Message available
Indicates that a message is present in the output queue.
Bit 3
ESB3
Event Summary (logical sum) bit 3
This is the logical sum of Event Status Register 3.
Bit 2
ESB2
Event Summary (logical sum) bit 2
This is the logical sum of Event Status Register 2.
Bit 1
ESB1
Event Summary (logical sum) bit 1
This is the logical sum of Event Status Register 1.
Bit 0
ESB0
Event Summary (logical sum) bit 0
This is the logical sum of Event Status Register 0.
Status Byte Register (STB)
During serial polling, the contents of the 8-bit Status Byte Register are sent from the instrument to the controller.
When any Status Byte Register bit enabled by the Service Request Enable Register has switched from 0 to 1, the
MSS bit becomes 1. Consequently, the SRQ bit is set to 1, and a service request is dispatched.
The SRQ bit is always synchronous with service requests, and is read and simultaneously cleared during serial
polling. Although the MSS bit is only read by an *STB? query, it is not cleared until a clear event is initiated by the
*CLS command.
Service Request Enable Register (SRER)
Setting a bit of this register to 1 enables the corresponding bit of the
Status Byte Register to be used.
PW3336A987-01
8
Bit 7
PON
Power-On Flag
Set to 1 when the power is turned on, or upon recovery from an outage.
Bit 6
URQ
User Request
unused
Bit 5
CME
Command error (The command to the message terminator is ignored.)
This bit is set to 1 when a received command contains a syntactic or semantic
error:
• Program header error
• Incorrect number of data parameters
• Invalid parameter format
• Received a command not supported by the instrument
Bit 4
EXE
Execution Error
This bit is set to 1 when a received command cannot be executed for some
reason.
• The specified data value is outside of the set range
• The specified data cannot be set (data format discrepancy)
• Execution is prevented by some other operation being performed
Bit 3
DDE
Device-dependent Error
This bit is set to 1 when a command cannot be executed due to some reason
other than a command error, a query error or an execution error.
•An internal error occurred and execution cannot be performed (error
displayed)
•A command was received that cannot be executed during a restricted
operation (integration, hold, etc.)
• When "o.r",”S.Err” or ”-----“ occurs and the error data is read by a *MEASure?
query.
Bit 2
QYE
Query Error (the output queue is cleared)
This bit is set to 1 when a query error is detected by the output queue control.
•When an attempt is made to read the output queue when the output queue is
empty (GP-IB only)
• When the data overflows the output queue
• When the next command is received while there is data in the output queue
• When there is a query after a *IDN? on the same line.
Bit 1
RQC
(unused)
Request Control
Bit 0
OPC
Operation Complete
This bit is set to 1 in response to an *OPC command.
•It indicates the completion of operations of all messages up to the *OPC
command
Event Registers
Standard Event Status Register (SESR)
The Standard Event Status Register is an 8-bit register.
If any bit in the Standard Event Status Register is set to 1(after masking by the Standard Event Status Enable
Register), bit 5 (ESB) of the Status Byte Register is set to 1.
See: “
Standard Event Status Enable Register (SESER)” (p.
The Standard Event Status Register is cleared in the following situations:
• When a *CLS command is executed
• When an event register query
• When the instrument is powered on
(
*ESR?) is executed
9)
PW3336A987-01
9
Status Byte Register (STB)
bit6 bit5
bit4
SRQ
ESB
MAV
MSS
Standard Event Status Register (SESR)
bit7 bit6
bit5
bit4
bit3
bit2 bit1 bit0
PON
URQ
CME
EXE
DDE
QYE
RQC
OPC
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
Logical sum
←& & & & & & & &
↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
bit7 bit6
bit5
bit4
bit3
bit2 bit1 bit0
PON
URQ
CME
EXE
DDE
QYE
RQC
OPC
Standard Event Status Enable Register (SESER)
Event Status Register 0 (ESR0)
Bit 7
DataSet
Data updated.
Bit 6
Change
Setting
Err
Data became invalid due to a hardware-related setting change.
(For example, immediately after the range was changed.)
Bit 5
SyncErr
A synchronization error occurred on ch1, ch2, or ch3.
Bit 4
IntegrateEnd
Integration has completed.
Bit 3
AVeraGe
update
Averaged data updated.
Bit 2
HIGH-Psum
The total (sum) of the active power is o.r. (over range).
Bit 1
OverDataIntegrate
A peak overflow of voltage or current occurred in the active
power integration value for total(sum).
Bit 0
Ext.Sync Error
Failed external synchronization for the data update.
Standard Event Status Enable Register (SESER)
Setting any bit of the Standard Event Status Enable Register to 1 enables access to the corresponding bit of the
Standard Event Status Register.
Standard Event Status Register (SESR) and Standard Event Status Enable Register (SESER)
Device-specific Event Status Registers (ESR0, ESR1, ESR2,
and ESR3)
This instrument provides four Event Status Registers for controlling events.
Each event register is an 8-bit register.
When any bit in one of these Event Status Registers enabled by its corresponding Event Status Enable Register
is set to 1, the following happens:
• For Event Status Register 0, bit 0 (ESB0) of the Status Byte Register (STB) is set to 1.
• For Event Status Register 1, bit 1 (ESB1) of the Status Byte Register (STB) is set to 1.
• For Event Status Register 2, bit 2 (ESB2) of the Status Byte Register (STB) is set to 1.
• For Event Status Register 3, bit 3 (ESB3) of the Status Byte Register (STB) is set to 1.
Event Status Registers 0 through 3 are cleared in the following situations:
• When a *CLS command is executed
• When an Event Status Register query (
• When the instrument is powered on
:ESR0?, :ESR1?, :ESR2?
, or
:ESR3?
) is executed
PW3336A987-01
10
Event Status Register 1 (ESR1)
Bit 7
Frequency
Out of Range1
The frequency of ch1 (voltage or current) is invalid.
Bit 6
Over
DataIntegrate1
A peak overflow of voltage or current occurred in the active power
integration value for ch1.
Bit 5
CurrentOver
DataIntegrate1
A peak overflow of current occurred in the current integration
value for ch1.
Bit 4
Over-I1
A peak overflow occurred in the current input on ch1.
Bit 3
Over-U1
A peak overflow occurred in the voltage input on ch1.
Bit 2
High-P1
The active power of ch1 is over range.
Bit 1
High-I1
The current of ch1 is over range.
Bit 0
High-U1
The voltage of ch1 is over range.
Event Status Register 2 (ESR2)
Bit 7
Frequency
Out of Range2
The frequency of ch2 (voltage or current) is invalid.
Bit 6
Over
DataIntegrate2
A peak overflow of voltage or current occurred in the active power
integration value for ch2.
Bit 5
CurrentOver
DataIntegrate2
A peak overflow of current occurred in the current integration
value for ch2.
Bit 4
Over-I2
A peak overflow occurred in the current input on ch2.
Bit 3
Over-U2
A peak overflow occurred in the voltage input on ch2.
Bit 2
High-P2
The active power of ch2 is over range.
Bit 1
High-I2
The current of ch2 is over range.
Bit 0
High-U2
The voltage of ch2 is over range.
Event Status Register 3 (ESR3)
Bit 7
Frequency
Out of Range3
The frequency of ch3 (voltage or current) is invalid.
Bit 6
Over
DataIntegrate3
A peak overflow of voltage or current occurred in the active power
integration value for ch3.
Bit 5
CurrentOver
DataIntegrate3
A peak overflow of current occurred in the current integration
value for ch3.
Bit 4
Over-I3
A peak overflow occurred in the current input on ch3.
Bit 3
Over-U3
A peak overflow occurred in the current input on ch3.
Bit 2
High-P3
The active power of ch3 is over range.
Bit 1
High-I3
The current of ch3 is over range.
Bit 0
High-U3
The voltage of ch3 is over range.
PW3336A987-01
11
Status Byte Register (STB)
bit3 bit2 bit1
bit0
ESB3
ESB2
ESB1
ESB0
Event Status Register 0 (ESR0)
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
DS
CSE
SE
IE
AVG
HP
ODI
ESE
↓ ↓ ↓ ↓ ↓ ↓ ↓
↓
Logical
sum
& & & & & & &
&
↑ ↑ ↑ ↑ ↑ ↑ ↑
↑
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
DS
CSE
SE
IE
AVG
HP
ODI
ESE
Event Status Enable Register 0 (ESER0)
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR1
ODI1
CODI1
OI1
OU1
HP1
HI1
HU1
↓ ↓ ↓ ↓ ↓ ↓ ↓
↓
Logical
sum
& & & & & & &
&
↑ ↑ ↑ ↑ ↑ ↑ ↑
↑
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR1
ODI1
CODI1
OI1
OU1
HP1
HI1
HU1
Event Status Enable Register 1 (ESER1)
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR2
ODI2
CODI2
OI2
OU2
HP2
HI2
HU2
↓ ↓ ↓ ↓ ↓ ↓ ↓
↓
Logical
sum
& & & & & & &
&
↑ ↑ ↑ ↑ ↑ ↑ ↑
↑
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR2
ODI2
CODI2
OI2
OU2
HP2
HI2
HU2
Event Status Enable Register 2 (ESER2)
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR3
ODI3
CODI3
OI3
OU3
HP3
HI3
HU3
↓ ↓ ↓ ↓ ↓ ↓ ↓
↓
Logical
sum
& & & & & & &
&
↑ ↑ ↑ ↑ ↑ ↑ ↑
↑
bit7 bit6 bit5
bit4
bit3
bit2 bit1 bit0
FOR3
ODI3
CODI3
OI3
OU3
HP3
HI3
HU3
Event Status Enable Register 3 (ESER3)
Event Status Register 0 to 3 (ESR0 to ESR3) and
Event Status Enable Register 0 to 3 (ESER0 to ESER3)
PW3336A987-01
12
Register
Read
Write
Status Byte Register
*STB?
-
Service Request Enable Register
*SRE?
*SRE
Standard Event Status Register
*ESR?
-
Standard Event Status Enable Register
*ESE?
*ESE
Event Status Register 0
:ESR0?
-
Event Status Enable Register 0
:ESE0?
:ESE0
Event Status Register 1
:ESR1?
-
Event Status Enable Register 1
:ESE1?
:ESE1
Event Status Register 2
:ESR2?
-
Event Status Enable Register 2
:ESE2?
:ESE2
Event Status Register 3
:ESR3?
-
Event Status Enable Register 3
:ESE3?
:ESE3
Command
Description
GTL
Go To Local
Changes the instrument from the Remote state to the Local
state.
LLO
Local Lock Out
Locks all keys on the instrument, including the Local Key.
DCL
Device CLear
Clears the input buffer and output queue.
SDC
Selected Device Clear
Clears the input buffer and output queue.
GET
Group Execute Trigger
Updates the displayed value while it is being held.
Register Reading and Writing
GP-IB Commands
The following commands can be used through interface functions.
PW3336A987-01
13
Initialization Method
Item
At
Power-on
System
Reset
*RST
Command
Device
Clear
(GP-IB only)
*CLS
Command
Factory
Default
GP-IB address
- -- - -
1
RS-232C setting (baud rate)
- -- - -
38400
LAN setting
- -- - -
*4
Device-specific functions (range,
etc.)
-
●
●
-
-
*4
Output Queue
●
●
- ● -
●
Input Buffer
●
●
- ● -
●
Status Byte Register
●
●
-
-*1
●*2
●
Event registers
●*3
●
-
-
●
●
Enable register
●
●
- - -
0
Current path
●
●
- ● -
●
Headers on/off
●●●
-
-
ON
Output items
●●●
*5,
Response message terminator
●
●
- - -
CR+LF
Response message separator
● ● ●
-
-
;
*1. Only the MAV bit (bit 4) is cleared.
*2. All bits except the MAV bit are cleared.
*3. Except the PON bit (bit 7).
*4. Refer to the user's manual for the instrument.
*5. See below.
ch
Measurement Item
CH1
CH2
CH3
(PW3337 only)
sum
:MEASure?
Voltage (U)
○ ○ ○ ○ Current (I)
○ ○ ○ ○ Active power (P)
○ ○ ○
○
Apparent power (S)
○ ○ ○
○
Reactive power (Q)
○ ○ ○
○
Power factor (PF)
○ ○ ○
○
Phase angle (DEG)
○ ○ ○
○
Voltage frequency
(FREQU)
○○○
Current frequency
(FREQI)
○○○
:MEASure:HARMonic?
Harmonic wave voltage
effective value (HU)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
Harmonic wave current
effective value (HU)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
Harmonic wave power
effective value (HU)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
○ (first-order
only)
Initialization Items
Output Item Initialization
Output for all items other than those listed above is OFF by default.
PW3336A987-01
14
Command
Execution time (excluding communication time and delays to the start of analysis)
*WAI
200ms or less
The other
commands
10 ms or less
(150 ms)
(Priority given to measurement and
calculation processing)
(50 ms)
(200 ms) Display update rate: 5 times per second
Command Execution Time
Command execution time indicates the time for analyzing and processing long form commands.
However, the command execution time for commands with data is the time described according to the data format
specified in the <data portion>, and for query commands it is the time when the header is ON.
The instrument performs measurements, calculations, and updates the display repeatedly in 200 ms cycles.
Measurements and calculations are given priority over command processing, and require a maximum of 150
ms. Therefore, a maximum delay of 150 ms may be encountered from the time a command is received until
analysis begins.
• Updating the display may be delayed if the analysis processing is not completed in time, even if the internal
processing time is met.
• All commands are sequential.
• When communicating with a controller, the time required to transfer the data must be added.
The amount of time required for the data transfer depends on the controller (communications).
The RS-232C transfer time for a starting bit, data length of 8, no parity bit, and a stop bit (10 bits total) with a baud
rate setting of N bps is calculated as follows:
Transfer Time T [1 character/second] = Baud Rate N [bps] / 10 [bits]
The measurement value is 11 characters so the time required to transfer one piece of data would be 11/T.
(Example) 9600 bps: 11 / (9600 / 10) = 11 ms (approximately)
• Wait a few moments after making any changes via setting commands to allow the measurements to stabilize.
Errors During Communications
An error occurs when messages are executed in the following cases:
• Command Error
When message syntax (spelling) is invalid
When the data format in a command or query is invalid
• Query Error
When the response message exceeds 4,000 bytes
When there is a query after an
• Execution Error
When invalid character or numeric data is present
• Device-dependent Error
When an error occurs during self-testing
When a restricted operation (such as changing the range) is attempted during an integration operation (when the
INTEGRATOR indicator is lit or flashing)
When a restricted operation (such as changing the range) is attempted during the Hold state
When the
Note:
A command error will always occur if a message is spelled incorrectly or if any data is present after a query.
When an error occurs with a query, no response message will be generated for that query.
*TRG command is executed in any state other than the Hold state
*IDN? query
PW3336A987-01
15
Message
Data Formats
(Response data for queries)
Description
Reference
Page
*CLS
Clears the event registers and the Status Byte
Register.
36
*ESE
0 to 255
Sets/Queries the Standard Event
Status Enable Register.
Sets bit 0 of the Standard Event Status Register
to 1 after an operation completes.
35
*OPC?
1
Queries execution completion.
35
*OPT?
Queries the device options.
34
*RST
Initializes the device.
34
*SRE
0 to 127
Sets/Queries the Service Request Enable
Register.
37
*SRE?
*STB?
0 to 127
Queries the Status Byte Register.
37
*TRG
Updates the display once.
37
*TST?
0 to 4
Initiates a self-test and queries the result.
35
*WAI
Waits until the next display update completes.
35
Message
Data Formats
(Response data for queries)
Description
Reference
Page
:ESE0
0 to 255
Sets/Queries Event Status Enable Register 0.
38
:ESE0?
:ESR0?
(0 to 255)
Queries Event Status Register 0.
39
:ESE1
0 to 255
Sets/Queries Event Status Enable Register 1.
38
:ESE1?
:ESR1?
(0 to 255)
Queries Event Status Register 1.
39
:ESE2
0 to 255
Sets/Queries Event Status Enable Register 2.
39
:ESE2?
:ESR2?
(0 to 255)
Queries Event Status Register 2.
39
:ESE3
0 to 255
Sets/Queries Event Status Enable Register 3.
39
:ESE3?
:ESR3?
(0 to 255)
Queries Event Status Register 3.
39
Message
2
The information in angled brackets < > represents the data format.
When the GP-IB interface is used, you can send an SRQ interrupt to the controller by setting the Event Status Register
and *SRE.
List
Standard Commands
Device-specific Commands (Event Registers)
PW3336A987-01
16
Message
Data Formats
(Response data for queries)
Description
Reference
Page
:WIRing
TYPE1 to TYPE7
1/2 (for 3331 interchangeability)
Sets/Queries the wire connection
setting.
40
:Wiring?
:MODE
40
:MODE?
:AVERaging
1/2/5/10/25/50/100
Sets/Queries the number of times to
perform averaging.
41
:AVERaging?
:INTEGrate?
Queries the integration set time and the
integration state.
42
:INTEGrate:STATe
START/STOP/RESET
Sets/Queries the integration state.
42
:INTEGrate:STATe?
:INTEGrate:TIME
<Hour(NR1)>, <Minutes(NR1)>
Sets/Queries the integration time.
43
:INTEGrate:TIME?
:HARMonic:ORDer:UPPer
<Order (2 to 50)>
Sets/Queries the upper limit order for
harmonic wave analysis.
43
:HARMonic:ORDer:UPPer?
:HOLD
OFF/ON/MAX/MIN/RESET
Sets/Queries the holds or releases the
display value.
43
:HOLD?
:DEMAg
Performs a zero adjustment.
44
:DEMAg?
<Zero adjustment execution state>
Queries the zero adjustment execution
state.
:SYNC:CONTrol
<Synchronization control setting>
Sets/Queries the synchronization
control function.
44
:SYNC:CONTrol?
Message
Data Formats
(Response data for queries)
Description
Reference
Page
All Channels (queries are for the representative value [ch1] only)
:VOLTage?
(<AUTO>, <Voltage Range>)
Queries the voltage range setting item (ch1 only).
44
:VOLTage:AUTO
ON/OFF
Sets (all channels) or queries (ch1 only)
the voltage automatic range.
45
:VOLTage:AUTO?
:VOLTage:RANGe
<Voltage Range (NR1)>
Sets (all channels) or queries (ch1 only)
the voltage range.
45
:VOLTage:RANGe?
ch1
:VOLTage1?
(<AUTO>, <Voltage Range>)
Queries the voltage range setting item (ch1).
44
:VOLTage1:AUTO
ON/OFF
Sets (ch1) or queries (ch1) the voltage automatic
range.
45
:VOLTage1:AUTO?
:VOLTage1:RANGe
<Voltage Range (NR1)>
Sets (ch1) or queries (ch1) the voltage range.
45
:VOLTage1:RANGe?
ch2
:VOLTage2?
(<AUTO>, <Voltage Range>)
Queries the voltage range setting item (ch2).
44
:VOLTage2:AUTO
ON/OFF
Sets (ch2) or queries (ch2) the voltage automatic
range.
45
:VOLTage2:AUTO?
:VOLTage2:RANGe
<Voltage Range (NR1)>
Sets (ch2) or queries (ch2) the voltage range.
45
:VOLTage2:RANGe?
ch3
:VOLTage3?
(<AUTO>, <Voltage Range>)
Queries the voltage range setting item (ch3).
44
:VOLTage3:AUTO
ON/OFF
Sets (ch3) or queries (ch3) the voltage automatic
range.
45
:VOLTage3:AUTO?
:VOLTage3:RANGe
<Voltage Range (NR1)>
Sets (ch3) or queries (ch3) the voltage range.
45
:VOLTage3:RANGe?
Device-specific Commands (Measurement Settings)
Device-specific Commands (Voltage Range)
PW3336A987-01
17
Message
Data Formats
(Response data for queries)
Description
Reference
Page
All Channels (queries are for the representative value [ch1] only)
:CURRent?
(<AUTO>, <Current Range>, ...)
Queries the current range setting item
(ch1 only).
46
:CURRent:AUTO
ON/OFF
Sets (all channels) or queries (ch1 only)
the current automatic range.
46
:CURRent:AUTO?
:CURRent:RANGe
<Current Range (NR1)>
Sets (all channels) or queries (ch1 only)
the current range.
47
:CURRent:RANGe?
:CURRent:EXTRange
<Clamp Current Range>
Sets (all channels) or queries (ch1 only)
the current range (current sensor).
48
:CURRent:EXTRange?
:CURRent:TYPe
<Current Sensor Type>
Sets (all channels) or queries (ch1 only)
the current sensor type.
47
:CURRent:TYPe?
ch1
:CURRent1?
(<AUTO>, <Current Range>, ...)
Queries the current range setting item
(ch1).
46
:CURRent1:AUTO
ON/OFF
Sets (ch1) or queries (ch1) the current
automatic range.
46
:CURRent1:AUTO?
:CURRent1:RANGe
<Current Range (NR1)>
Sets (ch1) or queries (ch1) the current
range.
47
:CURRent1:RANGe?
:CURRent1:EXTRange
<Clamp Current Range>
Sets (ch1) or queries (ch1) the current
range (current sensor).
48
:CURRent1:EXTRange?
:CURRent1:TYPe
<Current Sensor Type>
Sets (ch1) or queries (ch1) the current
sensor type.
47
:CURRent1:TYPe?
ch2
:CURRent2?
(<AUTO>, <Current Range>, ...)
Queries the current range setting item
(ch2).
46
:CURRent2:AUTO
ON/OFF
Sets (ch2) or queries (ch2) the current
automatic range.
46
:CURRent2:AUTO?
:CURRent2:RANGe
<Current Range (NR1)>
Sets (ch2) or queries (ch2) the current
range.
47
:CURRent2:RANGe?
:CURRent2:EXTRange
<Clamp Current Range>
Sets (ch2) or queries (ch2) the current
range (current sensor)
48
:CURRent2:EXTRange?
:CURRent2:TYPe
<Current Sensor Type>
Sets (ch2) or queries (ch2) the current
sensor type.
47
:CURRent2:TYPe?
ch3
:CURRent3?
(<AUTO>, <Current Range>, ...)
Queries the current range setting item
(ch3).
46
:CURRent3:AUTO
ON/OFF
Sets (ch3) or queries (ch3) the current
automatic range.
46
:CURRent3:AUTO?
:CURRent3:RANGe
<Current Range (NR1)>
Sets (ch3) or queries (ch3) the current
range.
47
:CURRent3:RANGe?
:CURRent3:EXTRange
<Clamp Current Range>
Sets (ch3) or queries (ch3) the current
range (current sensor).
48
:CURRent3:EXTRange?
:CURRent3:TYPe
<Current Sensor Type>
Sets (ch3) or queries (ch3) the current
sensor type.
47
:CURRent3:TYPe?
Device-specific Commands (Current Range)
PW3336A987-01
18
Message
Data Formats
(Response data for queries)
Description
Reference
Page
All Channels (queries are for the representative value [ch1] only)
:FREQuency?
<Frequency Range (NR1)>
Queries (ch1 only) the frequency range
(zero-crossing filter).
49
:FREQuency:RANGe
<Frequency Range (NR1)>
Sets (all channels) or queries (ch1 only) the
frequency range (zero-crossing filter).
49
:FREQuency:RANGe?
ch1
:FREQuency1?
<Frequency Range (NR1)>
Queries (ch1) the frequency range
(zero-crossing filter).
49
:FREQuency1:RANGe
<Frequency Range (NR1)>
Sets (ch1) or queries (ch1) the frequency range
(zero-crossing filter).
49
:FREQuency1:RANGe?
ch2
:FREQuency2?
<Frequency Range (NR1)>
Queries (ch2) the frequency range
(zero-crossing filter).
49
:FREQuency2:RANGe
<Frequency Range (NR1)>
Sets (ch2) or queries (ch2) the frequency range
(zero-crossing filter).
49
:FREQuency2:RANGe?
ch3
:FREQuency3?
<Frequency Range (NR1)>
Queries (ch3) the frequency range
(zero-crossing filter).
49
:FREQuency3:RANGe
<Frequency Range (NR1)>
Sets (ch3) or queries (ch3) the frequency range
(zero-crossing filter).
49
:FREQuency3:RANGe?
Message
Data Formats
(Response data for queries)
Description
Reference
Page
All Channels (queries are for the representative value [ch1] only)
:SOURce
<Synchronization Source>
Sets (all channels) or queries (ch1 only) the
synchronization source.
50
:SOURce?
:SOURce:TIMEOut
0.1/1/10
Sets (all channels) or queries (ch1 only) the
synchronization timeout.
50
:SOURce:TIMEOut?
ch1
:SOURce1
<Synchronization Source>
Sets (ch1) or queries (ch1) the synchronization
source.
50
:SOURce1?
:SOURce1:TIMEOut
0.1/1/10
Sets (ch1) or queries (ch1) the synchronization
timeout.
50
:SOURce1:TIMEOut?
ch2
:SOURce2
<Synchronization Source>
Sets (ch2) or queries (ch2) the synchronization
source.
50
:SOURce2?
:SOURce2:TIMEOut
0.1/1/10
Sets (ch2) or queries (ch2) the synchronization
timeout.
50
:SOURce2:TIMEOut?
ch3
:SOURce3
<Synchronization Source>
Sets (ch3) or queries (ch3) the synchronization
source.
50
:SOURce3?
:SOURce3:TIMEOut
0.1/1/10
Sets (ch3) or queries (ch3) the synchronization
timeout.
50
:SOURce3:TIMEOut?
Device-specific Commands (Frequency Range [Zero-crossing Filter])
The frequency range and zero-crossing filter settings are linked.
Device-specific Commands (Synchronization Source)
PW3336A987-01
19
Message
Data Formats
(Response data for queries)
Description
Reference
Page
All Channels (queries are for the representative value [ch1] only)
:SCALe?
(<VT Ratio>, <CT Ratio>)
Queries (ch1 only)
the VT and CT ratios.
51
:SCALe:VT
<VT Ratio (NRf)>
Sets (all channels) or queries (ch1 only)
the VT ratio.
51
:SCALe:VT?
:SCALe:CT
<CT Ratio (NRf)>
Sets (all channels) or queries (ch1 only)
the CT ratio.