This instruction manual handles only parts related to commands.
For communication settings, please refer to the instruction manual for the main unit
Care has been taken to ensure the accuracy of the contents in this instruction
May.2018 Revised edition 1
PW3390A975-01 18-05H
manual, however, please approach HIOKI’s Sales Planning Division or your
nearest HIOKI dealer should you have any queries or found any mistakes.
Improvements may be made to this instruction manual without prior notice.
Unauthorized reproduction or copying of this instruction manual is prohibited.
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Message
Program
Message
Response
Message
Command
Program
Message
Query
Program
Message
Program Message
Message sent from the controller to the instrument.
Response Message
Message sent from the instrument to the controller. This message is created at
the time when a query program message is received and syntax checked.
Command Program
Message
Command to control settings and resetting of the instrument.
Query Program
Message
Order to interrogate instrument on operation results, measurement results,
and setting status.
1. Communication Command Overview
The PW3390 Power Analyzer can communicate with PC via LAN(TCP/IP) or RS-232C, so that users
can control the functions, and acquire measurement data and recorded data through text commands and
queries.
The port number of TCP/IP is fixed to 3390.
Commands/Messages
Data sent and received from the communication device are called messages and are classified as
follows.
Command/Program message, and Query Program Message are collectively known as commands.
6/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Description as shown in this manual
(Command Name)
Short Form
Long Form
DISPlay
DISP
DISPLAY
Types of Commands
Description
Explanation
Simple Command Type
A sequence of letters
[Example] :HEADer ON
Compound Command
Type
Multiple simple command type headers separated by colons ":"
[Example] :VOLTage1:RANGe 600
Standard Command
Type
Begins with an asterisk "*", indicating that it is a standard command defined
by IEEE 488.2.
[Example] *RST
Data
Simple Command Type
Data
Compound Command Type
Command Syntax
Commands are accepted in uppercase, lowercase or a mixture of both types of letters. 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 uppercase letters, extended to the long form in lower
case letters.
The response message from the main device is returned as long form in uppercase letters.
Example
A mixture of uppercase and lowercase letters such as DiSpLay is accepted, but DISPLA, DISPL and DIS
are considered as errors.
Command Program Header
A header shows what kind of function that command has.
A command always requires a header and comes in three types, “Simple Command Type”, “Compound
Command Type”, and “Standard Command Type”.
7/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Types of Commands
Description
Simple Command Type
A sequence of letters
[Example] :HEADer?
Compound Command
Type
Multiple simple command type headers separated by colons ":"
[Example] :VOLTage1:RANGe?
Standard Command
Type
Begins with an asterisk "*", indicating that it is a standard command defined
by IEEE 488.2.
[Example] *IDN?
Query Program Message
:VOLTage1:RANGe?
Response Message
:VOLTAGE1:RANGE 300
300
(When header is ON)
(When header is OFF)
Simple Command Type
Compound Command Type
Query Program Header
These commands are used to interrogate the instrument about the results of operations and settings. A
query is formed by appending a question mark "?" after a program header
Response Message
The response message to a query, like the program message, consists of the header and data and is in
principle outputted in the same format as the program message in response to the query. The header
can be omitted.
[Example]
8/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Main instrument/Communication
Software Setting
ANSI Word
code
(hexadecimal)
Meaning
English Name
CR+LF
0Dh 0Ah
Recovery +
Change line
Carriage Return + Line Feed
Message Unit Separator
Header Separator
Data Separator
Terminator and Separator
(1) Message Terminator
The message terminator means the division of one message forwarding.
However, there is no message in the terminator.
(2) Message Unit Separator
The semicolon ";" is a message unit separator and is used to write multiple messages in one line.
[Example] :VOLTage1:RANGe 600;:CURRent:RANGe 50
(3) Header Separator
In a message containing header and data, a space (header separator) is used to separate the header
from the data.
[Example] :VOLTage1:RANGe 600
(4) Data Separator
In a message containing multiple data items, commas are used to separate the data items from one
another.
[Example] :AOUT:ITEM Urms1,Irms1,P1,Q1,S1,PF1
9/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Multiple-Command Header Omission
When several commands having a common header are combined to form a compound command
if they are written together in sequence, the common portion can be omitted. This common portion is
called the "current path", 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:RANGe 600;:VOLTage1:MEAN OFF
Compacted Expression :VOLTage1:RANGe 600;MEAN OFF
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.
Note
Beeps when a communication error occurs if beep is enabled for this instrument.
Avoid inserting or removing storage media while using commands that refer to files and media.
10/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
128
64
32
16 8 4 2 1
bit 7
bit 6
bit 5
bit 4
bit 3
bit 2
bit 1
bit 0
PON
URQ
CME
EXE
DDE
QYE
RQC
OPC
2. Command Reference (Standard Command)
Clear Standard Event Status Register (SESR) (except Output Queue)
Syntax Command *CLS
Example Clear Event Register. (SESR)
Note ・No effect on Output Cue.
Read Standard Event Status Register (SESR)
Syntax Query *ESR?
Example Return SESR Contents as NR1 numerical values 0-255.
PON: Power-On Flag. Set to 1 when the power is turned on, or upon recovery from an outage.
URQ:User Request. Unused.
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
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 setting data cannot be set (Invalid data format)
• Cannot be executed when another function is in operation (during hold, integration,
etc.)
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.
• Execution is impossible due to an internal instrument fault
QYE:Query Error (the output queue is cleared)
This bit is set to "1" when an abnormality occurs in processing an output queue.
• When the data overflows the output queue
RQC: Controller privilege request. Unused
OPC: Operation Complete. Unused
ExampleResponse *ESR 32 (when HEADER is ON) 32 (when HEADER is OFF)
11/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Note "*OPT?" is the last query message inside the program message.
Therefore, any subsequent query (in the same line) that is detected will lead to a query
error and no response message will be outputted.
Initialize Instrument
Syntax Command *RST
Description Initializes all instrument settings besides language and communication setting and returns
them to factory default.
Example*RST
Request a Sampling
Syntax Command *TRG
Description Performs one measurement when the display values or peak values are held.
Example :HOLD ON;*TRG;:MEAS?
13/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Execute Next Command after Command Has Finished Processing
Syntax Command *WAI
Description Commands after *WAI will not be executed until the next update has finished.
The time required for updating is usually 50 ms.
Example:MEAS?;*WAI;:MEAS? Data will be retrieved each time the display is updated.
Note Display data will not change even when a command is executed when peak values are
held.
14/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
3. Command Reference (Device-Specific Commands)
Set and Query Frequency Full Scale
SyntaxCommand :AOUT:FREQuency (Frequency Data) Query :AOUT:FREQuency?
Response Frequency Data :100Hz/500Hz/1kHz/5kHz
Description Command Sets the maximum frequency of D/A output’s Frequency Full Scale and the
motor.
Query Sets the maximum frequency of D/A output’s Frequency Full Scale and
returns it as words.
ExampleCommand :AOUT:FREQ 100Hz Set the Frequency Full Scale of D/A output as 100Hz.
Query :AOUT:FREQ?
Response :AOUT:FREQUENCY 100Hz (when HEADER is ON)
100Hz (when HEADER is OFF)
NoteThe settings for the D/A output’s Frequency Full Scale and the motor measured maximum
frequency are the same.
Set and Query Coefficient of Integrated Full Scale
SyntaxCommand :AOUT:INTEGrate <Magnification data> Query :AOUT:INTEGrate?
Response Magnification Data :1/10,1/2,1,5,10,50,100,500,1000,5000,10000
Description Command Sets the integration full scale coefficient of D/A Output.
Query Sets the integration full scale coefficient of D/A output and returns it as
words.
ExampleCommand :AOUT:INTEG 1 Set the coefficient of the D/A integration full scale as 1.
Query :AOUT:INTEG?
Response :AOUT:INTEGRATE 1 (when HEADER is ON)
1 (when HEADER is OFF)
15/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
“Item 1 –16” = Basic measured item parameters (Refer to 4. Fundamental
Measurement Item Parameters)
Description Command Sets the D/A output item. Output items can be specified from 1 to 16.
Output items in the unspecified D/A channels will not be changed.
Query Sets the D/A output items and return them as words.
ExampleCommand :AOUT:ITEM Urms1,Irms1,P1,Q1,S1,PF1
Set the D/A outputs from Channel 1 in sequence as Voltage CH1 RMs,
Current CH1 RMS, Effective Current CH1, Ineffective Current CH1, Apparent
Power CH1, and Power Factor Ch1.
Query :AOUT:ITEM?
Response :AOUT:MONITOR:SCALE 1 (when HEADER is ON)
1 (when HEADER is OFF)
Select and Query Auto Range Limit
SyntaxCommand :AUTOrange <WIDE/NARROW> Query :AUTOrange?
Response <WIDE/NARROW>
WIDE : Widen the auto range limit.
NARROW : Narrow the auto range limit.
Description Command Selects to widen or narrow the auto range limit. Query Returns the auto range limit as words.
ExampleCommand :AUTO WIDE Widen the auto range limit.
Query :AUTO?
Response :AUTORANGE WIDE (when HEADER is ON)
WIDE (when HEADER is OFF)
17/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Description Command Sets Efficiency, Pin of Loss Calculation Formula.
Query Returns the settings of efficiency, Pin of Loss Calculation Formula as words.
ExampleCommand :CALC1:PIN P1 Set the Pin of the Calculation formula 1 as P1.
Query :CALC1:PIN?
Response :CALCULATE1:PIN P1 (when HEADER is ON)
P1 (when HEADER is OFF)
NoteWhen P12/P34/P123 cannot be selected because of wiring settings, they cannot be specified.
Pm cannot be specified except when it can be selected during the implementation of the motor
analysis function.
19/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Set and Query Efficiency, Pout of Loss Calculation Formula
3390001.BMP,44682,M3390000.CSV,578 (when HEADER is OFF)
NoteUp to 90 files displayed from the start of the screen can be acquired.
When more than 90 files exist in the same folder, subsequent file names cannot be acquired.
21/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Acquire Folder Name in CF Card
SyntaxQuery :CARD:FOLDername? Response “Folder name”, “Folder name”, “Folder name”… Folder names will continue for as long as there are folders.
When there are no more folders, the words “NO_FOLDER” will be
returned.
Description Query Acquires the folder name under the root of the CF card.
Example Query :CARD:FOLD?
Response :CARD:FOLDERNAME PW3390 (when HEADER is ON)
PW3390 (when HEADER is OFF))
Note Up to 215 folders displayed from the start of the screen can be acquired.
When more than 215 folders exist in the root, subsequent folder names cannot be acquired.
22/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Acquire File Data in CF Card
SyntaxQuery :CARD:PICKout? “File name”, “Start position”, “Stop position”, “Specified folder name” SyntaxResponse “File name”, “Start position”, “Stop position”, “Specified folder name” File name:File name to be forwarded
Start position:Specify the acquired start position in the file with byte count
Stop position:Specify the acquired stop position in the file with byte count
Specified Folder Name:Search for file name under the specified folder
When omitted, search for the file name under the root.
Description Query Reads the specified file name under the folder from the CF card from the
start position to the stop position, attach STX (02) to the start and ETX (03) to
the end of the data to be forwarded, and forward data.
Return the 1-100 byte data of the 02030100.CSV file under the PW3390
folder from the CF card.
Response STX(02)HIOKI PW3390・・・・・ETX(03)
NoteEven when the header is set as ON, headers will not attach to Response data. Specify “1” if the beginning of the file is made the start position. STX/ETX is not a ASCII Code but (02)/(03) of the Binary Data.
It automatically shifts to the measurement screen.
23/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Description Query Returns the size of the specified file.
Example Query :CARD:SIZE? H3390000.BMP,PW3390
Response :CARD:SIZE 35124 (when HEADER is ON)
35124 (when HEADER is OFF))
NoteFile name can be specified with a maximum of 40 characters.
If folder name is omitted, a file name will be used from under the root folder.
During execution of file operation, it can take some time to get a response.
24/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Data”Year Data: 2000 - 2079 (can be set 00 – 79)
Month Data: 01- 12
Day Data: 01 - 31
Hour Data: 00 - 23
Minute Data: 00 - 59
Second Data: 0
Description Command Sets the time of the clock in the main instrument.
Query Returns the time setting of the main instrument as NRI numerical values.
ExampleCommand :CLOC 17,12,25,12,30,0 Set as 2017 December 25th 12:30:0
Query :CLOC?
Response :CLOCK 2017,12,25,12,30,45 (when HEADER is ON)
2017,12,25,12,30,45 (when HEADER is OFF)
NoteThe instrument can interpret days of the month as well as leap years, so specifying an
improbable date will lead to an error.
Always set 0 for the second data.
25/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Set and Query Current Auto Range
SyntaxCommand :CURRent[CH]:AUTO <ON/OFF> Query :CURRent[CH]:AUTO?
[CH] ・・・・ 1,2,3,4
Response ON: Measure current with auto range.
OFF: Measure current with manual range.
Description Command Set the current auto range ON/OFF. Query Returns the current auto range setting with ON or OFF.
Example Command :CURR1:AUTO ON Set the auto range of the Current Channel 1 to ON.
Query :CURR1:AUTO?
Response :CURRENT1:AUTO ON (when HEADER is ON)
ON (when HEADER is OFF)
NoteWhen the range is set with the :CURRent[CH]:RANGeCommand, the auto range of the
specified channel will be OFF.
By combining measurement lines (for above IP3W), the auto ranges of other channels which
are combined are also set.
Setting and Querying Phase Correction Formulas for Current Sensors
SyntaxCommand :CURRent[CH]:CORRect <ON/OFF> Query :CURRent[CH]:CORRect?
[CH] ・・・・ 1,2,3,4
Response ON:Turns ON phase correction formulas for current sensors
OFF:Turns OFF phase correction formulas for current sensors
Description Command Sets phase correction formulas for current sensors. [CH]: 1 to 4. Query Returns setting for phase correction formulas for current sensors in a string.
Example Command :CURR1:CORR ON Query :CURR1:CORR?
Response :CURRENT1:CORRECT ON (when HEADER is ON)
ON (when HEADER is OFF)
26/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Set and Query Phase Correction Angle for Current Sensors
Description Command Sets phase correction angle for current sensors. [CH]: 1 to 4. Query Returns setting for phase correction angle for current sensors in a string.
Example Command :CURR1:DEGR 90.00 Query :CURR1:DEGR?
Response :CURRENT1:DEGREE +90.00 (when HEADER is ON)
+90.00 (when HEADER is OFF)
Set and Query Phase Correction Frequency for Current Sensors
SyntaxCommand :CURRent[CH]:FREQuency <Correction frequency (kHz)> Query :CURRent[CH]:FREQuency?
[CH] ・・・・ 1,2,3,4
Response Correction frequency (kHz)
000.001 to 999.999
Description Command Sets phase correction frequency for current sensors. [CH]: 1 to 4. Query Returns setting for phase correction frequency for current sensors in a string.
Example Command :CURR1:FREQ 200.000 Query :CURR1:FREQ?
Response :CURRENT1:FREQUENCY 200.000 (when HEADER is ON)
200.000 (when HEADER is OFF)
27/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition
Select and Query Current Rectifier Type
SyntaxCommand :CURRent[CH]:MEAN <ON/OFF> Query :CURRent[CH]:MEAN?
[CH] ・・・・ 1,2,3,4
Response ON: Set the current rectifier type to MEAN.
OFF: Set the current rectifier type to RMS.
Description Command Select the RMS/MEAN of the current rectifier type.
Query Returns the selection of the RMS/MEAN of the rectifier type as ON (MEAN)
or OFF (RMS).
ExampleCommand :CURR1:MEAN OFF Select the current rectifier type of Current Channel 1 as RMS.
Query :CURR1:MEAN?
Response :CURRENT1:MEAN OFF (when HEADER is ON)
OFF (WHEN HEADER IS OFF)
NoteBy combining measurement lines (for above IP3W), the current rectifier types of other channels
which are combined are also set.
28/107
PW3390 Power Analyzer Communication Command Instruction Manual Second Edition