This instruction manual provides details of the RS-232C communications interface for the 3169-20/21 CLAMP ON POWER HiTESTER.
For the specifications of the RS-232C and connection with a PC, see
Chapter 9 "Using the Instrument with a Computer" (145 page), of the
instruction manual.
To connect the 3169-20/21 to a PC, use the optional 9612 RS-232C
CABLE.
Safety Symbols
This manual contains information and warnings essential for safe
operation of the product and for maintaining it in safe operating condition. Before using the product, be sure to carefully read the following
safety notes.
The following symbols in this manual indicate the relative importance
of cautions and warnings.
Indicates that incorrect operation presents an
extreme hazard that could result in serious injury or
death to the user.
Indicates that incorrect operation presents a significant hazard that could result in serious injury or
death to the user.
Indicates that incorr ect oper ation pr esent s a possi bi lity of injury to the user or damage to the product.
Advisory items related to performance or correct
operation of the product.
2
3
Specification
Transfer Method
Transfer methodFull duplex
Synchronous methodAsynchronous communication method
Baud rate2400/ 9600/ 19200/ 38400 bps
Data length8 bits
Parity checkNone
Stop bit1
Message Terminators
(Delimiter)
Flow controlNone, XON/XOFF, RTS/CTS
Connector Specifications
Chapter 1
CR+LF, CR
PinFunctions
2Receive Data
3Send Data
5Signal Ground
7Request to Send
8Clear to Send
Various messages are supported in order to control the 3169-20/21
through the interface.
Messages are divided into program messages, which are sent to the
3169-20/21 from the PC, and response messages, which are sent to
the PC from the 3169-20/21.
Program messages
Response messages
PC
3169-20/21
The message system has the following hierarchy.
Command messages
Query messages
Messages
Program messages
Response messages
Answer messages
6
Communication Methods
2.1.1Message Format
Program Message
Response
messages
Program messages can be divided into either command messages or
query messages.
• Command Message
Orders for controls of the uni t, such as for making meas urement co ndition
settings or for reset or the like.
(example)
Command message which sets the frequency
:FREQUENCY 60
Header portion Space Data portion
• Query Message
Orders for responses relating to results of operati on, results of measurement, or the state of device settings.
(example)
Queries the current frequency
:FREQUENCY?
Header portion Question mark
After a query message has been received, a response message is
produced the moment that its syntax has been checked.
Whether or not headers are prefixed to response messages is set by
the HEADer command.
The response-message unit parameter can be changed from a semicolon (;) to a comma (,) using the :TRANsmit:SEParator com-
mand. The parameter is set to a semicolon (;) by default.
Header ON
Header OFF +101.25E+0;+50.246E+0
U1_INST[V] +101.25E+0;I1_INST[A]_1 +50.246E+0
Answer Message
An answer message is a character string created after one line of data
(up to the terminator) from a PC has been analyzed and processed.
This string is returned to the PC. Using this data, the 3169-20/21 is
synchronized with the PC.
Communication Methods
7
Command Syntax
Headers
The names of commands for the 3169-20/21 are as far as possible
mnemonic. Furthermore, all commands have a long form, and an
abbreviated short form.
In command references in this manual, the short form is written in
upper case letters, and then this is continued in lower case letters so
as to constitu te th e lo n g for m .
Either of these forms will be accepted during operation, but intermediate forms will not be accepted. Further, during operation both lower
case letters and upper case letters will be accepted without distinction.
Response messages generated by the 3169-20/21 are in long form
and in upper case letters.
It is essential to prefix headers to program messages.
The response messages to the :CARD:PICKout? and :MEM-
ory:PICKout? queries will not have a header, regardless of whether
the queries have a header.
(1) Command program headers
There are two types of command: simple commands and compound
commands.
• Simple command header
This header is a sequence of letters and digits.
:HOLD
• Compound command header
This header is made up from a plurality of simple command type
headers marked off by colons " :".
:CARD:FORMat
(2) Query program headers
These are for commands used for interrogating the unit about the
results of operations, about measured values, or about the current
states of settings for the unit. As shown by the following examples,
they can be recognized as queries by a question mark "?" appearing
after the program header.
:FREQuency?
:VT?
Message
Terminators
The 3169-20/21 supports the CR+LF and CR message terminators.
In addition, the 3169-20/21 sends response messages in conjunction
with the CR+LF or CR message terminator.
(Delimiter)
8
Communication Methods
Separators
(1) Message unit separator
A semicolon ";" is used as a message unit separator when it is
desired to set out several messages on a single line.
:VT 2.0;:VOLTage:RANGe 150;:BEEPer ON
Do not link :CARD:PICKout? and :MEMory:PICKout? queries with
other commands or queries.
(2) Header separator
In a message which has a header and dat a, a spac e " " is used as the
header separator to separate the header from the data.
:VOLTage:RANGe 300
(3) Data separator
If a message has several data items, commas are required as data
separators for separating these data items fro m one anoth er.
Data Formats
(1) Character data
(2) Decimal data
:CARD:PICKout? filename,1,1000
The main unit uses character string data and decimal numeric data,
and the type used varies according to the command in question.
The character data can be either alphabetic characters or numerals.
Although in character data either upper case letters or lower case letters are accepted, response messages output by the main unit are
always in upper case letters.
:INTERVAL 10S
The numeric data values are all represented in decimal, in three formats identified as NR1, NR2 and NR3, and each of these can appear
as either a signed number or an unsigned number. Unsigned numbers
are taken as positive.
Further, if the accuracy of a numerical value exceeds the range with
which the main unit can deal, it is r ounded of f. (5 an d above is rounded
up; 4 and below is rounded down).
• NR1 integer data ..................(examples: +12, -23, 34)
• NR2 fixed point numbers ......(examples: +1.23, -23.45, 3.456)
• NR3 floating point numbers ..(examples: +1.0E-2, -2.3E+4)
The term "NRf format" includes all these thre e formats.
When the main unit is receiving it accepts NRf fo rmat.
For the response data, the format is specified for each commands and
the data in specified format is transmitted. The VT ratio will be set to 5
in all the examples below.
:VT 5
:VT 5.2
:VT 4.998E2
Communication Methods
9
Abbreviation of
Compound
Commands
When several compound commands have a common head portion, for
example :STARt:TIME and :STARt:TIME?, then, when and only
when writing them directly following on from one ano ther, this common
portion (:STARt: in this example) can be omitted from each command.
This common portion is called "the current path", by analogy with the
general concept of the current directory in the directory structure of
UNIX or MS-DOS, and until it is cleared the analysis of following commands is performed by deeming them to be preceded by the current
path which has been curtailed in the interests of brevity. This manner
of using the current path is shown in the following example:
Normal expression
:STARt:TIME 2001,12,10,10,15;:STARt:TIME?
Abbreviated expression
:STARt:TIME 2001,12,10,10,15;TIME?
This becomes the current path, and can be curtailed from the
following messages.
The current path is cleared when the power is turned on, when a colon
“
:
” appears at the start of a command, and when a message termina-
tor is detected.
:
It is not necessary to prefix a colon "
commands and compound commands. However, in order to prevent
confusion with abbreviated forms and mistakes in operation, it is recommended practice always to prefix "
On the 3169-20/21, the current paths are as follows:
Response messages are stored in the output queue. If data is read out
on the PC, the queue will be cleared. The output queue is also clear ed
in the following cases:
• When the power is turned off and turned on again.
• When a query error is generated.
The 3169-20/21 has an output queue of 50 K bytes capacity. If the
response messages overflow this limit of 50 K bytes, a query error is
generated, and the output queue is cleared.
The 3169-20/21 has an input buffer of 2048 bytes capacity.
When data exceeding 2048 bytes is transmitted and the buffer
becomes full, data will be deleted until analysis of the input buffer is
complete. Make sure that each command line is shorter than 2048
bytes.
The length of a single command should be less than 2048 bytes.
2.1.3Setting Command
The following setting commands are enabled only when the timeseries measurement is stopped and Hold is OFF. However, queries
are enabled even when the measurement data is held.
Upon receiving a command, the 3169-20/21 returns to the PC an
answer message indicating whether the command has been successfully received. When creating a program, make sure the PC accepts
this answer message.
An answer message contains one of the following contents (character
strings), according to the status.
ALL RIGHT will not be returned upon receipt of the RS232:BAUD
command or any query. For details, see Command Reference.
DEVICE ERROR
12
Flow Control
2.2Flow Control
If the input buffer of a device has small capacity, the device may not be
able to receive all data. To avoid this problem, a receiving device must
send a signal to a sending device to stop sendi ng data before the input
buffer becomes full. This is referred to as "flow control." There are two
types of flow control: hardware handshaking and software handshaking.
(1) Hardware Handshaking
Data flow is controlled by turning ON and OFF the RTS (RS) or CTS
(CS) signal line.
• Receiving
When the input buffer is more than 3/4 full, RTS is set to Low.
When the input buffer is 1/4 full or less, RTS is set to Hi.
• Sending
When CTS = low, the sending device stops sending data.
When CTS = Hi, the sending device sends data.
(2) Soft w are Handshaking
Data flow is controlled by sending XON and XOFF codes.
• Receiving
When the input buffer is more than 3/4 full, XOFF (13H) is sent.
When the input buffer is 1/4 full or less, XON (11H) is sent.
• Sending
If the sending device receives 13H (XOFF), it stops sending data.
If the sending device receives 11H (XON), it sends data.
• The input buffer of the 3169-20/21 has a capacity of 2048 bytes. The
output queue size is 50 KB.
• Flow control for the 3169-20/21 is normally set t o OFF. The fl ow-control setting is selectable from among four presets: OFF, RTS/CTS,
XON/XOFF, and Both RTS/CTS and XON/XOFF.
Flow Control
13
(3)
Precautions on using
:CARD:PICKout?
and
:MEMory:PICK-
out?
These queries are used for the transmission of data from the PC card
or internal memory. Since a large amount of data may be transmitted,
executing queries without flow control may result in data not being
transmitted correctly. Before executing these queries, set flow control
between the 3169-20/21 and PC to XON/XOFF, then perform measurement. For binary data files, set flow control to RTS/CTS.
(4) Flow-Control Setting Commands
Use these commands when measurement has been performed with
flow control set to OFF and :MEMory:PICKout? is to be executed
with flow control. Flow control setti ng can be c hanged using t he f ollowing commands without affecting the saved data.
:RS232C:FLOW
<Characters>Flow Control
XONXOFFXON/XOFF
RTSCTSRTS/CTS
BOTHBoth XON/XOFF and RTS/CTS
OFFOFF
<characters>
• After the response message has been received, set flow control
back to OFF if necessary.
• This setting can be changed when time-series measurement is not
performed and display not held.
• The current setting can be checked using :RS232C:FLOW?.
14
Flow Control
Command
15
Command Reference
Function
3.1Command Reference
This chapter explains each command.
Chapter 3
16
Command Reference
3.1.1Command Reference Format
Shows the command message that contains numerical or character parameters.
<numeric>: Numeric data values
(NR1)integer data
(NR2)fixed point numbers
(NR3)floating point numbers
(NRf)format that contains NR1, NR2, and NR3
<characters>: Character string data
Shows the command description.
Describes the message syntax.
Explains the command data or
response message.
Explains the message.
Illustrates the actual command
application. (Generally, the
explanation is directed to the “HEADER ON” case, except for the HEADER command.)
Explains command errors.
Provides notes on using the
command.
Setting and Inquiry of Setting File Name
Syntax Command
Query
Response
Function Command Sets the name of a setting file.
QueryReturns the set setting file name.
Example Command
Response
Query
Response
Error
Note
:FILEname:SET
:FILEname:SET?
:FILENAME:SET
<characters>
<characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
=
Character-string data with up
to 8 characters size
Clears the set file name if the command does not
have
<characters>
:FILE:SET 69SET00
ALL RIGHT
:FILE:SET?
69SET00
Sets the setting file name to "69SET00".
A device-dependen t e rror will oc cu r in the following
cases:
• Execution of this command is attempted while
the instrument is standing by for or performing
time-series measuremen t.
.
The extension ( .SET) is added aut omatically.
The file will be saved as "69SET**" (** is a
number) after time-series measurement has
started, and provided that the specified file
name already exists on the medium.
• A query is an inquiry for acquiring various data, such as the current
instrument settings and measurement results. If an error occurs in a
query, a response message to the query will not be created.
• In case of a system error, a query will not be executed and the error
will be detected as a device-dependent error.
Command Reference
Setting and Inquiry of Output Items of D/A Output Channel 1
0: Normal measurement
1: Level
2: Content
3: Phase angle
4: Total value
5: THD
<characters 3>
= U1,U2,U3,UAVE,I1,I2,I3,I4,IAVE,P,Q,S,PF,F,
WP+,WP-,WQ+,WQ-
<numeric 4>
<numeric 5>
= 1 to 40 (Output ordinals)
= 1/10/100 (Output magnification)
CommandSets the data output items of D/A output channel 1.
QueryReturns the data-output i tems setting of D/A output chan-
nel 1.
Example
Error
Note
Command
Response
Query
Response
:AOUT:CH1 1,0,P,1,1
ALL RIGHT
:AOUT:CH1?
1,0,P,1,1
Makes settings so that the active power of circuit 1 is output to
D/A output channel 1.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A setting item not available with the current connection
method has been set.
• Items that cannot be measured (e.g., harmonic of S, THD of
P) have been selected.
<Numeric 4> will be ignored when <numeric 2> is normal measurement, total value, or THD.
<Numeric 5> will be ignored unless <numeric 2 > is l evel or content.
18
Command Reference
Setting and Inquiry of Output Items of D/A Output Channel 2
0: Normal measurement
1: Level
2: Content
3: Phase angle
4: Total value
5: THD
<characters 3>
= U1,U2,U3,UAVE,I1,I2,I3,I4,IAVE,P,Q,S,PF,F,
WP+,WP-,WQ+,WQ-
<numeric 4>
<numeric 5>
= 1 to 40 (Output ordinals)
= 1/10/100 (Output magnification)
CommandSets the data output items of D/A output channel 2.
QueryReturns the data-output items setting of D/A output chan-
nel 2.
Example
Error
Note
Command
Response
Query
Response
:AOUT:CH2 1,0,Q,1,1
ALL RIGHT
:AOUT:CH2?
1,0,Q,1,1
Makes settings so that the reactive power of circuit 1 is output
to D/A output channel 2.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A setting item not available with the current connection
method has been set.
• Items that cannot be measured (e.g., harmonic of S, THD of
P) have been selected.
<Numeric 4> will be ignored when <numeric 2> is normal measurement, total value, or THD.
<Numeric 5> will be ignored unless <numeric 2> is l evel or content.
Command Reference
Setting and Inquiry of Output Items of D/A Output Channel 3
0: Normal measurement
1: Level
2: Content
3: Phase angle
4: Total value
5: THD
<characters 3>
= U1,U2,U3,UAVE,I1,I2,I3,I4,IAVE,P,Q,S,PF,F,
WP+,WP-,WQ+,WQ-
<numeric 4>
<numeric 5>
= 1 to 40 (Output ordinals)
= 1/10/100 (Output magnification)
CommandSets the data output items of D/A output channel 3.
QueryReturns the data-output i tems setting of D/A output chan-
nel 3.
Example
Error
Note
Command
Response
Query
Response
:AOUT:CH3 1,0,S,1,1
ALL RIGHT
:AOUT:CH3?
1,0,S,1,1
Makes settings so that the apparent power of circuit 1 is output
to D/A output channel 3.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A setting item not available with the current connection
method has been set.
• Items that cannot be measured (e.g., harmonic of S, THD of
P) have been selected.
<Numeric 4> will be ignored when <numeric 2> is normal measurement, total value, or THD.
<Numeric 5> will be ignored unless <numeric 2 > is l evel or content.
20
Command Reference
Setting and Inquiry of Output Items of D/A Output Channel 4
0: Normal measurement
1: Level
2: Content
3: Phase angle
4: Total value
5: THD
<characters 3>
= U1,U2,U3,UAVE,I1,I2,I3,I4,IAVE,P,Q,S,PF,F,
WP+,WP-,WQ+,WQ-
<numeric 4>
<numeric 5>
= 1 to 40 (Output ordinals)
= 1/10/100 (Output magnification)
CommandSets the data output items of D/A output channel 4.
Example
Error
Note
Query
Command
Response
Query
Response
QueryReturns the data-output items setting of D/A output channel 4.
:AOUT:CH4 1,0,F,1,1
ALL RIGHT
:AOUT:CH4?
1,0,F,1,1
Makes settings so that the frequency of circui t 1 is output to D/ A
output channel 4.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A setting item not available with the current connection
method has been set.
• Items that cannot be measured (e.g., harmonic of S, THD of
P) have been selected.
<Numeric 4> will be ignored when <numeric 2> is normal measurement, total value, or THD.
<Numeric 5> will be ignored unless <numeric 2> is l evel or content.
Setting and Inquiry of D/A Output Integration Rate
21
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:AOUT:RATE
<characters>
:AOUT:RATE?
:AOUT:RATE <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= 1K/5K/10K/50K/100K/500K/1000K
Sets the output rate to be used when D/A output is set to the
integration results.
Returns the set output rate to be used when D/A out put is set to
the integration results.
:AOUT:RATE 50K
ALL RIGHT
:AOUT:RATE?
50K
Sets the D/A output integration rate to 5 V/50 kWh (5 V/50
kvarh).
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and Inquiry of Number of Measurements to be Averaged
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:AVEraging
<numeric>
:AVEraging?
:AVERAGING <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
= 1/2/5/10/20
Sets the number of measurements to be averaged.
Returns the set number of measurements to be averaged.
:AVE 5
ALL RIGHT
:AVE?
5
Sets the number of measurements to be averaged to 5.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
22
Command Reference
Setting and Inquiry of Backlight
Syntax
Command
Query
Response
:BACKlight
:BACKlight?
:BACKLIGHT <cha racters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters> = ON/OFF/AUTO
Function
Example
Command
Query
Command
Response
Query
Response
Sets the LCD backlight.
Returns the LCD backlight setting.
:BACK ON
ALL RIGHT
:BACK?
ON
Turns the backli ght ON.
Setting and Inquiry of Beeper
Syntax
Command
Query
Response
:BEEPer
:BEEPer?
:BEEPER <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
<characters>
<characters>
= ON/OFF
Function
Example
Command
Query
Command
Response
Query
Response
Turns the beeper ON/OFF.
Returns the ON/OFF setting of the beeper.
:BEEP OFF
ALL RIGHT
:BEEP?
OFF
Turns OFF the beeper.
Deletion of Files on PC Card
23
Command Reference
Syntax
Function
Example
Error
Command
Command
Command
Response
:CARD:DELete
Deletes the file with the specified
<file name>
:CARD:DEL 69MEAS00.CSV
ALL RIGHT
Deletes the file "69MEAS00.CSV" from the PC card.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A file name that does not exist in the PC file has been speci-
fied.
• The PC card is not installed in the 3169-20/21.
Download of File from Internal Memory to PC Card
Syntax
Command
:CARD:DOWNload
<file name1>
<file name2>
= File name used in internal memory
= File name to use when saving onto the PC card
<file name1>,<file name2>
<file name>
from the PC card.
Function
Example
Error
Note
Command
Command
Response
Reads out the file with the specified
memory, and downloads it to the PC card as
<file name1>
from internal
<file name2>
.
:CARD:DOWN 69BACK00.CSV,69MEAS00.CSV
ALL RIGHT
Downloads the file "69BACK00.CSV" from interna l memory to
the PC card as "69MEAS00.CSV".
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A file name that does not exist in the internal memory has
been specified.
• The specified file name already exists on the PC card.
• The PC card is full.
• The PC card is not installed in the 3169-20/21.
Do not press any key while this command is being executed.
24
Command Reference
Download of All Files in Internal Memory to PC Card
Syntax
Function
Example
Error
Note
Command
Command
Command
Response
:CARD:DOWNload:ALL
Reads out all files saved in inter nal memory, and downloads the
files to the PC card using the same file names.
:CARD:DOWN:ALL
ALL RIGHT
Reads out all files saved in int ernal memory, and downloads the
files to the PC card using the same file names.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• Downloads all files in internal memory to the PC card using
the same file names.
• The PC card is not installed in the 3169-20/21.
Do not press any key while this command is being executed.
Inquiry of Installation of PC Card
Syntax
Function
Example
Query
Response
Query
Query
Response
:CARD:EXISt?
:CARD:EXIST <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Returns an answer indicating whether the PC card is installed.
= Y/N
Y: The PC card is installed.
N: The PC card is not installed.
:CARD:EXIS?
Y
This indicates that the PC card is installed.
Inquiry of File Name on PC Card
25
Command Reference
Syntax
Function
Example
Error
Note
Query
Response
Query
Query
Response
:CARD:FILEname?
<characters>
<file name>,<size>,...
Searches for the specified type of file among the files saved on
the PC card, and returns the file name and file size.
This indicates that the measurement file "69MEAS00.CSV"
(size: 45342 bytes) is on the PC card.
An execution error will occur in the following cases:
• The PC card is not installed in the 3169-20/21.
Returns
NO FILES
if the specified file does not exist.
Formatting of PC Card
Syntax
Function
Example
Error
Note
Command
Command
Command
Response
:CARD:FORMat
Formats the PC card installed in the 3169-20/21.
:CARD:FORM
ALL RIGHT
Formats the PC card.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• The PC card is not installed in the 3169-20/21.
Do not press any key while this command is being executed.
26
Command Reference
File Transfer from PC Card
Syntax
Function
Example
Error
Query
Response
Query
Query
Response
:CARD:PICKout?
STX(02)+Data to be transferred+ETX(03)
<file name1>
<numeric 2>
<numeric 3>
Reads out the file with t he specified
from the start position to the stop position, adds "STX(02)" to
the head of the read data and "ETX(03)" to the tail, then transfers the data.
= Name of file to be transferred
= Start position
= Stop position
<file name1>,<numeric 2>,<numeric 3>
<file name1>
on the PC card
:CARD:PICK? 69MEAS00.CSV,1,1000
STX(02)HIOKI 3169.......ETX(03)
Returns the data from the first byt e to the 1000th byt e of the fil e
"69MEAS00.CSV".
A device-dependent error will occur in the following cases:
• Execution of this command is attempted to transfer data
exceeding 1024 bytes, while the instrument is st anding by for
or performing time-series measurement.
An execution error will occur in the following cases:
• A file name that does not exist in the PC file has been specified.
• The PC card is not installed in the 3169-20/21.
• The start position exceeds the file size.
Note
• The response message will not have a header .
• If the stop position exceeds the file size, the data i n the specified file will be transferr ed to the end.
• The response data of a circuit not in use will be treated as
meaningless data.
Storage of Setting File on PC Card
27
Command Reference
Syntax
Function
Example
Error
Note
Command
Command
Command
Response
:CARD:SETting:SAVE
<characters>
Saves the current settings as a setting file on the PC card by
naming the file with the specified character string. If no character string is specified, the file i s sa ved with t he set ting fil e name.
If there is no setting file name, the file is saved with the automatic file name .
= Character-string data with up to 8 characters size
<characters>
:CARD:SET:SAVE 69SET00
ALL RIGHT
Saves the current settings on the PC card as the setting file
"69SET00.SET".
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• Y ou ha ve att empted to save more tha n 10 sett ing fi le s. (Up to
10 files can be stored on the PC card.)
• The PC card is not installed in the 3169-20/21.
The extension (.SET) is automatically added to the file.
28
Command Reference
Reading of Setting File from PC Card
Syntax
Function
Example
Error
Command
Command
Command
Response
:CARD:SETting:LOAD
<characters>
Searches for the setting file with the specified character string
with file extension (.SET) as the file name on the PC card,
reads the setting, then changes the current settings.
= Character-string data wit h up to 8 characters size
<characters>
:CARD:SET:LOAD 69SET00
ALL RIGHT
Reads out the setting information from the fi le "69SET00.SET"
on the PC card to the 3169-20/21.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A file name that does not exist in the PC file has been specified.
• The PC card is not installed in the 3169-20/21.
Setting and Inquiry of Number of Circuits to be Measured
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:CIRCuitnum
:CIRCuitnum?
:CIRCUITNUM <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
Sets the number of circuits to be measured.
Returns the set number of circuits to be measured.
<numeric>
= 1/2/3/4 (Circuit No.)
:CIRC 2
ALL RIGHT
:CIRC?
2
Sets the number of circuits to be measured to 2.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A number of circuits not available with the current connection
method has been specified.
Setting and Inquiry of Actual Time
29
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:CLOCk
:CLOCk?
CLOCK <year>,<month>,<day>,<hour>,<min>,<sec>
(Headers: ON)
<year>,<month>,<day>,<hour>,<min>,<sec>
(Headers: OFF)
Sets the actual time.
Returns the current actual time.
<year>,<month>,<day>,<hour>,<min>,<sec>
:CLOC 2002,4,1,15,30,0
ALL RIGHT
:CLOC?
2002,4,1,15,30,30
Sets the actual time to 15:30:00, April 1, 2002.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
= 1/2/3/4 (Circuit No.)
= 0.5 to 5000.0 (Current range)
= Current range of Circuit 1
= Current range of Circuit 2
= Current range of Circuit 3
= Current range of Circuit 4
Sets the current range of the circuit of the specified number.
The unit is amperes (A).
Returns the set current ranges to all ci rcuits.
:CURR:RANG 1,5.0;RANG 2,5.0;RANG 3,5.0;
RANG 4,5.0
ALL RIGHT
:CURR:RANG?
5.0,5.0,5.0,5.0
Sets the current ranges of Circuits 1, 2, 3, and 4 to the 5-A
range.
Error
Note
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A circuit number not available with the current connection
method has been set.
The response data of a circuit not in use will be treated as
meaningless data.
32
Command Reference
Storage of Screen Data
Syntax
Function
Example
Error
Command
Command
Command
Response
:DATAout:COPY
Performs the same function as the COPY key on the 3169-20/
21.
:DATA:COPY
ALL RIGHT
Saves screen data on the set medium.
A device-dependent error will occur in the following cases:
• The medium for saving/printing out the screen data is set to
PRINTER.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• The PC card is selected as the medium for saving data, but a
PC card is not installed in the 3169-20/21. (Failure to save
screen data will result in data not being saved in internal
memory as backup.)
Setting and Inquiry of Medium to Save/Print Out Screen Data
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:DATAout:COPY:MEDIa
:DATAout:COPY:MEDIa?
:DATAOUT:COPY:MEDIA <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Sets the medium for saving/printing out the screen data.
Returns the set medium for saving/printing out the scr een data.
= PRINTER/CARD/MEMORY
PRINTER: Printer
CARD: PC card
MEMORY: Internal memory
<characters>
:DATA:COPY:MEDI CARD
ALL RIGHT
:DATA:COPY:MEDI?
CARD
Sets the medium for saving/printing out the screen data to the
PC card.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and inquiry of Harmonics Data Output
33
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:DATAout:HARMonics
:DATAout:HARMonics?
:DATA O UT:HARMONICS <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Sets whether to output a harmonics data (ON/OFF).
Returns the ON/OFF setting of harmonics data output.
= OFF/ON
<characters>
:DATA:HARM ON
ALL RIGHT
:DATA:HARM?
ON
Turns ON harmonics data output.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Note
The data to be output using command are the items specified in
DATAout:ITEM, or on the save/print items setting screen.
(Headers: OFF)
Sets the data output items. The setting governs the following
data output:
• :MEASURE?
query (Only the instantaneous values are output
in case of harmonics.)
Measurement files to be saved on the PC card
•
Measurement files to be saved in internal memory
•
Measurement data to be output to the printer
•
Returns the setting of the data output items.
:DATA:ITEM 64,15,0,0,0,0,0,0,0
ALL RIGHT
Error
Note
Query
Response
:DATA:ITEM?
64,15,0,0,0,0,0,0,0
Sets the data output items to the instantaneous, average, maximum, and minimum values of normal measurement.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A circuit number not available with the current number of circuits for measurement has been specified.
• U/I/P selection data not available with the current connection
method has been specified.
• When "all ordinals," "all odd ordinals," and "all even ordinals"
are selected simultaneously, "all ordinals" is enabled.
• Individual ordinal data can also be selected when "all ordinals," "all odd ordinals," or "all even ordinals" is selected.
However, "all ordinals," "all odd ordinals," or "all even ordinals" will override the individ ual ordinal data.
• When “all odd ordinals” and “all even ordinals” are selected,
“all ordinals” is enabled.
Command Reference
35
<numeric 1>
: Normal measurement/THD/total value/phase angle/con-
tent/level selection data
bit7bit6bit5bit4bit3bit2bit1bit0
Normal measurement
THDTotal
value
Phase
angle
Content Level
<numeric 2>
: All ordinals/odd ordinals/even ordinals/integrated value/
minimum value/maximum value/average value/
instantaneous value selection data
bit7bit6bit5bit4bit3bit2bit1bit0
All ordinals
<numeric 3>
bit7bit6bit5bit4bit3bit2bit1bit0
<numeric 4>
bit7bit6bit5bit4bit3bit2bit1bit0
All odd
ordinals
All even
ordinals
Integrated
value
: Circuit No. data
: U/I/P selection data
Min.
value
4321
Max.
value
Ave.
value
Instantaneous value
14
22
30
I3
th
6
th
th
th
PI4
<numeric 5>
bit7bit6bit5bit4bit3bit2bit1bit0
8th
<numeric 6>
bit7bit6bit5bit4bit3bit2bit1bit0
th
16
<numeric 7>
bit7bit6bit5bit4bit3bit2bit1bit0
th
24
<numeric 8>
bit7bit6bit5bit4bit3bit2bit1bit0
th
32
: Ordinal data to be output from 1 to 8
th
7
: Ordinal data to be output from 9 to 16
th
15
: Ordinal data to be output from 17 to 24
th
23
: Ordinal data to be output from 25 to 32
th
31
I2I1U3U2U1
13
21
29
th
5
th
th
th
4
12
20
28
th
th
th
th
3
11
19
27
th
th
th
th
2
10
18
26
th
th
th
th
1
9
17
25
th
th
th
th
<numeric 9>
bit7bit6bit5bit4bit3bit2bit1bit0
th
40
: Ordinal data to be output from 33 to 40
th
39
th
38
37
th
36
th
35
th
34
th
33
th
36
Command Reference
Setting and Inquiry of Medium for Saving Data
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:DATAout:MEDIa
:DATAout:MEDIa?
:DATAOUT:MEDIA <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Sets the medium for saving data.
Returns the set medium for saving data.
= CARD/MEMORY
<characters>
CARD: PC card
MEMORY: Internal memory
:DATA:MEDI CARD
ALL RIGHT
:DATA:MEDI?
CARD
Sets the medium for saving data to the PC card.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Storage of Measurement Data
Syntax
Function
Example
Error
Command
Command
Command
Response
:DATAout:SAVE
Performs the same function as the SAVE key on the 3169-20/
21.
:DATA:SAVE
ALL RIGHT
Saves measurement data on the medium set with
:DATAOUT:MEDIA
A device-dependent error will occur in the following cases:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• The PC card is selected as the medium for saving data, but a
PC card is not installed in the 3169-20/21. (Failure to save
the measurement data will result in data not being saved in
internal memory as backup.)
.
Setting and Inquiry of Waveform Data File Storage
37
Command Reference
Syntax
Function
Example
Error
Note
Command
Query
Response
Command
Query
Command
Response
Query
Response
:DATAout:WAVE
<characters>
:DATAout:WAVE?
:DATAOUT:WAVE <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= OFF/ON
Sets whether to save a waveform data file (ON/OFF).
Returns the ON/OFF setting of waveform data file storage.
:DATA:WAVE ON
ALL RIGHT
:DATA:WAVE?
ON
Turns ON waveform data file storage.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
The waveforms to be saved using this command are the items
specified by <numeric 3> and <numeric 4> (circuit No. and U/I/
P selection data) in
DATAout:ITEM
setting screen. To save waveforms, harmonics storage must be
ON.
, or on the save/print items
38
Command Reference
Setting and Inquiry of Measurement Item to be Displayed
Syntax
Command
Query
Response
:DISPlay:MEAS
<numeric 1>,<numeric 2>,<numeric 3>
:DISPlay:MEAS?
:DISPLAY:MEAS <numeric 1>,<numeric 2>,<numeric 3>
(Headers: ON)
<numeric 1>,<numeric 2>,<numeric 3>
(Headers: OFF)
<numeric 1>
= 0/1/2/3/4/5/6/7/8/9 (Screen)
0: Main
1: Power
2: Integrate
3: Demand
4: Zoom
5: Harmonic list
6: Harmonic graph
7: Waveform
8: Wiring check
9: Wiring diagram
<numeric 2>
<numeric 3>
= 1/2/3/4 (Circuit No.)
= 0/1/2/3 (Page)
0: Instantaneous value
1: Average value
2: Maximum value
3: Minimum value
Function
Example
Error
Note
Command
Query
Command
Response
Query
Response
Sets the measurement item to be displayed.
Returns the set measurement item to be displayed.
:DISP:MEAS 0,1,0
ALL RIGHT
:DISP:MEAS?
0,1,0
Makes settings so that the instantaneous values of Circui t 1 are
displayed on the main screen.
An execution error will occur in the following cases:
An execut
•
<numeric 1>
set to a number other than 0 (instantaneous value).
(Be sure to set <numeric 3> to 0 (instantaneous value).)
• <numeric 2>
is set to a circuit number not available with the
wiring method or the set number of circuits to be measured.
If
<numeric 1>
is 8 or 9,
ignored.
is set to 5, 6, or 7, and
<numeric 2>
and
<numeric 3>
<numeric 3>
will be
is
Setting and Inquiry of Display Mode
39
Command Reference
Syntax
Function
Example
Command
Query
Response
Command
Query
Command
Response
Query
Response
Change of File Name
:DISPlay:MODE
<characters>
:DISPlay:MODE?
:DISPLAY:MODE <charac te rs>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= MEAS/SET/FILE
MEAS: Measurement screen
SET: Setting screen
FILE: File screen
Switches over to another screen.
Returns the currently displayed screen.
:DISP:MODE MEAS
ALL RIGHT
:DISP:MODE?
MEAS
Sets the display mode to the measurement screen.
Syntax
Function
Example
Error
Command
Command
Command
Response
:FILEname:CHANge
<characters 1>
= CARD/MEMORY
<characters 1>,<file name2>,<file name3>
CARD: PC card
MEMORY: Internal memory
<file name2>
<file name3>
= File name before change
= File name after change
Changes the name of a file on the specified medium.
:FILE:CHAN CARD,69MEAS00.CSV,MEASURE.CSV
ALL RIGHT
Changes "69MEAS00.CSV" to "MEASURE.CSV" on the PC
card.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• <file name2> does not exist on the specified medium.
40
Command Reference
Setting and Inquiry of Measurement File Name
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:FILEname:MEAS
<characters>
:FILEname:MEAS?
:FILENAME:MEAS
<characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= Character-string data with up to 8 characters size
Sets the name of a measurement file.
Clears the set file name if the command does not have
<characters>
.
Returns the set measurement file name.
:FILE:MEAS 69MEAS00
ALL RIGHT
:FILE:MEAS?
69MEAS00
Sets the measurement file name to "69MEAS00".
A device-dependent error will occur in the following cases:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
The file will be saved as "69MEAS**" (** is a number) after
time-series measurement has started, and provided that the
specified file name already exists on the medium.
Setting and Inquiry of Setting File Name
41
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:FILEname:SET
<characters>
:FILEname:SET?
:FILENAME:SET <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= Character-string data with up to 8 characters size
Sets the name of a setting file.
Clears the set file name if the command does not have
<characters>
.
Returns the set setting file name.
:FILE:SET 69SET00
ALL RIGHT
:FILE:SET?
69SET00
Sets the setting file name to "69SET00".
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Note
The extension (.SET) is added automatically. The file will be
saved as "69SET**" (** is a n umber) after time-series measurement has started, and provided that the specified file name
already exists on the medium.
42
Command Reference
Setting and Inquiry of Measured Line Frequency
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:FREQuency
<numeric>
:FREQuency?
:FREQUENCY <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
= 50/60
50: 50 Hz
60: 60Hz
Sets the frequency of the line to be measured.
Returns the set frequency of the line to be measured.
:FERQ 50
ALL RIGHT
:FREQ?
50
Sets the frequency of the line to be measured to 50 Hz.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and Inquiry of Communications Output Header
Syntax
Function
Example
Command
Query
Response
Command
Query
Command
Response
Query
Response
:HEADer
<characters>
:HEADer?
:HEADER <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= ON/OFF
Sets whether to add a communications output header (ON/
OFF).
Returns the ON/OFF setting of the communications output
header.
:HEAD OFF
ALL RIGHT
:HEAD?
OFF
Turns OFF the communications output header.
Setting and Inquiry of Hold State
43
Command Reference
Syntax
Command
Query
Response
:HOLD
<characters>
:HOLD?
:HOLD <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Function
Example
Command
Query
Command
Response
Query
Response
Sets whether to hold display (ON/OFF).
Returns the ON/OFF setting of the Hold function.
:HOLD OFF
ALL RIGHT
:HOLD?
OFF
Turns OFF the Hold function.
Setting and Inquiry of ID Number
Syntax
Command
Query
Response
:ID
<numeric>
:ID?
:ID <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
= ON/OFF
= 1 to 999
Function
Example
Error
Command
Query
Command
Response
Query
Response
Sets the ID No.
Returns the set ID No.
:ID 1
ALL RIGHT
:ID?
1
Sets the response ID No. to 1.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Sets the interval to 1 second.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and Inquiry of Language
45
Command Reference
Syntax
Function
Example
Command
Query
Response
Command
Query
Command
Response
:LANGuage
<characters>
:LANGuage?
:LANGUAGE <c har a cte rs >
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= JAPANESE/ENGLISH/GERMAN/ITALIAN
/CHINESE1/CHINESE2/FRENCH/SPANISH/
KOREAN
JAPANESE: Japanese
ENGLISH : English
GERMAN : German
ITALIAN: Italian
CHINESE1: Chinese (simple)
CHINESE2: Chinese (trad)
FRENCH : French
SPANISH : Spanish
KOREAN : Korean
Sets the language.
Returns the set language.
:LANG JAPANESE
ALL RIGHT
Error
Query
Response
:LANG?
JAPANESE
Sets the language to Japanese.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
46
Command Reference
Inquiry of Measurement Data
Syntax
Function
Example
Query
Response
Query
Query
Response
:MEASure?
<headers> <numeric>
<numeric>
(Headers: OFF)
Outputs in text form the items specified with
(Headers: ON)
:DATAout:ITEM
among the data displayed on the 3169-20/21. (The data will be
arranged in the same order as on the PC card.)
• Header
The same header as that used on the PC card is used. (See
the operations manual of the 3169-20/21.)
Data
This indicates that th e measurement file "69MEAS00.CSV" (size:
45342 bytes) is in internal memory.
Returns
NO FILES
if the specified file does not exist.
Formatting of Data File in Internal Memory
<characters>
Syntax
Function
Example
Error
Note
Command
Command
Command
Response
:MEMory:FORMat
Formats the data files in internal memory.
:MEM:FORM
ALL RIGHT
Formats the data files in internal memory.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
• Setting files cannot be format ted us ing this comma nd.
• Setting files are formatted using the MEMory:SETting:FORMat
command.
• Do not press any key while this command is being executed.
48
Command Reference
File Transfer from Internal Memory
Syntax
Function
Example
Error
Query
Response
Query
Query
Response
:MEMory:PICKout?
:STX(02)+Data to be transferred+ETX(03)
<file name1>
<numeric 2>
<numeric 3>
= Name of file to be transferred
= Start position
= Stop position
Reads out the file with the specified
<file name1>,<numeric 2>,<numeric 3>
<file name1>
in internal
memory from the start position to the stop position, adds
"STX(02)" to the head of the read data and " ETX(03)" to the tail ,
then transfers the data.
:MEM:PICK? 69MEAS00.CSV,1,1000
STX(02)HIOKI 3169.......ETX(03)
Returns the data from the first byte to the 1000th byte of the fi le
"69MEAS00.CSV".
A device-dependent error will occur in the following cases:
• The name of a file that does not exist in internal memory has
been specified.
An execution error will occur in the following cases:
• A file name that does not exist in the internal memory has
been specified.
• The start position exceeds the file size.
Note
• The response message will not have a header.
• If the stop posi tion exceeds the file size, the data i n the specified
file will be transferred to the end.
• Setting data cannot be transferred.
• Do not press any key while this command is being executed.
Deletion of Setting Files in Internal Memory
Syntax
Function
Example
Error
Command
Command
Command
Response
:MEMory:SETting:DELete
:<characters>
= Character-string data with up to 8 characters
size (file name)
Deletes the setting file named with the specified
from internal memory.
:MEM:SET:DEL 69SET00
ALL RIGHT
Deletes the setting file "69SET00.SET" fr om internal memory.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
<characters>
<characters>
An execution error will occur in the following cases:
• A file name that does not exist in the internal memory has
been specified.
Formatting of Setting Files in Internal Memory
49
Command Reference
Syntax
Function
Example
Error
Note
Command
Command
Command
Response
:MEMory:SETting:FORMat
Formats the setting files in internal memory.
:MEM:SET:FORM
ALL RIGHT
Formats the setting files in internal memory.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Data files are formatted using the
Storage of Setting File in Internal Memory
Syntax
Function
Command
Command
:MEMory:SETting:SAVE
<characters>
Saves the current settings as a setting file in internal memory
by naming the file with the specified character st ring.
If any character string is not specified, the file is saved with the
setting file name. If there is no setting file name, it is saved with
the automatic file name.
= Character-string data with up to 8 characters
size (file name)
MEMory:FORMat
<characters>
command.
Example
Error
Note
Command
Response
:MEM:SET:SAVE 69SET00
ALL RIGHT
Saves the current settings in internal memory as the setting file
"69SET00.SET".
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• An attempt is made to save more than 5 setting files in internal memory. (Up to 5 files can be stored in internal memory.)
The extension (.SET) is automatically added to the file.
50
Command Reference
Reading of Setting File from Internal Memory
Syntax
Function
Example
Error
Command
Command
Command
Response
:MEMory:SETting:LOAD
<characters>
Searches the setting file with the specified character string with
the setting-file extension (.SET) as the file name in internal
memory, reads the settings, then changes the current settings.
= Character-string data with up to 8 characters
size (file name)
<characters>
:MEM:SET:LOAD 69SET00
ALL RIGHT
Reads out the file "69SET00.SET" from internal memory, and
uses it as the settings for the 3169-20/21.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
An execution error will occur in the following cases:
• A file name that does not exist in the internal memory has
been specified.
Setting and Inquiry of Use of Reactive Power-Meter Method
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:OPERationvar
:OPERationvar?
:OPERATIONVAR <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Sets whether to use the reactive power-meter method.
Returns the setting on whether to use the reactive power-meter
method.
<characters>
= ON/OFF
:OPER ON
ALL RIGHT
:OPER?
ON
Makes settings so that the reactive power-meter method is
used.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and Inquiry of PT (VT) Ratio
51
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:PT
<numeric>
:PT?
:PT <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
Sets the PT ratio.
Returns the set PT ratio.
= 0.01 to 9999.99 (PT ratio)
:PT 2.0
ALL RIGHT
:PT?
2.0
Sets the PT ratio to 2. 0 .
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Execution of System Reset
Syntax
Function
Example
Command
Command
Command
Response
:RESEt
Executes a system reset.
:RESE
ALL RIGHT
Executes a system reset.
52
Command Reference
Setting and Inquiry of Baud Rate
Syntax
Function
Example
Note
Command
Query
Response
Command
Query
Command
Response
Query
Response
:RS232c:BAUD
<numeric>
:RS232c:BAUD?
:RS232C:BAUD <numeric>
(Headers: ON)
<numeric>
(Headers: OFF)
<numeric>
= 2400/9600/19200/38400
Sets the baud rate of the RS-232C.
Returns the set baud rate of the RS-232C.
:RS232:BAUD 38400
None
Changes the baud rate to 38400.
:RS232:BAUD?
38400
Changes the baud rate to 38400.
The response
ALL RIGHT
as the command changes the baud rate. In addition, response
data will not be sent for other commands on the same line. If
the baud rate cannot be changed, an error will be returned.
will not be returned to the command,
Command Reference
Setting and Inquiry of Device to Which RS-232C is Connected
53
Syntax
Function
Example
Error
Note
Command
Query
Response
Command
Query
Command
Response
Query
Response
:RS232c:CONNect
<characters>
:RS232c:CONNect?
:RS232C:CONNECT <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= PC/PRINTER
Sets the device to which the RS-232C is connected.
Returns the set device to which the RS-232C is connected.
:RS232:CONN PC
ALL RIGHT
:RS232:CONN?
PC
Sets the device to a PC.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
The response
ALL RIGHT
when the device is set to PC, to avoid setting it to another
device. If PRINTER is selected for the <character> of the command, the command will not be accepted.
will be returned to the command only
54
Command Reference
Setting and Inquiry of Flow Control
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:RS232c:FLOW
<characters>
:RS232c:FLOW?
:RS232C:FLOW <characters>
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
= OFF/XONXOFF/RTSCTS/BOTH
OFF: Flow control is not used.
XONXOFF: XON/XOFF control
RTSC TS: RTS/CTS c ontrol
BOTH: Both XON/XOFF and RTS/CTS are used.
Sets flow control.
Returns the flow-control setting.
:RS232:FLOW OFF
ALL RIGHT
:RS232:FLOW?
OFF
Turns OFF flow control.
A device-dependent error will occur in the following cases:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Setting and Inquiry of Sampling Method
55
Command Reference
Syntax
Function
Example
Error
Command
Query
Response
Command
Query
Command
Response
Query
Response
:SAMPling
:SAMPling?
:SAMPLING
(Headers: ON)
<characters>
(Headers: OFF)
<characters>
Sets the sampling method.
Returns the set sampling method.
<characters>
<characters>
= PLL/FIX
PLL: PLL
FIX: Fixed clock
:SAMP PLL
ALL RIGHT
:SAMP?
PLL
Sets the sampling method to PLL.
A device-dependent error will occur in the followi ng ca ses:
• Execution of this command is attempted during Hold.
• Execution of this command is attempted while the instrument
is standing by for or performing time-series measurement.
Note
The 3169-20/21 cannot obtain accurate measurements if this
setting is not correct.
SymptomCause / Treatment
The RS-232C has stopped work-
ing completely.
Communication failure with RS232C.
The ":CARD" command does not
function properly.
Data is garbled when a file is transferred using a ":CARD:PICKout?"
or ":MEMory:PICKout?" query.
Setting commands are rejected.
When attempting to read data
using a BASIC INPUT statement,
the RS-232C bus hangs.
The number of read data is too
small.
• Are the cables properly connected?
• Are all the devices powered on?
• Are correct cables used?
• Is the device to be connected to the RS-232C set to a
PRINTER? Change the setting to a PC.
• Set the message termin ator (delimiter) of the PC correctly (see
Message Terminat or) .
• Is the PC set to suit the RS-2 32C connection condition s set on
the 3169-20/21?
• Is the PC card properly installed?
• Does the specified file exist?
• Is flow control set between the 3169-20/21 and the PC?
• The settings cannot be changed wh il e tim e- s eries me asu r eme nt
is on standby or in progress, or t he measurement data is being
held.
• Make sure a query is transmitted before every INPUT#(ENTER).
• Have any of these transmitted queries resulted in as error?
• If the data contains a comma " ," try using a LINE INPUT statement.
Although a command has been
transmitted, nothing has happened.
Sending several queries, produces
only one response.
The response message to a query
differs from the display of the 316920/21.
• Has an error occurred?
• Do you receive an answer mes sage every time y ou send a setting command?
• Has an error occurred?
• Send the queries one at a time, and read the resp onses i ndivi dually. When you want to read t hem in a ll at on ce, try doing so by
putting them all on one line separated by the message separator
character.
• A response message is created after the 3169-20/21 has
received a query. The message, therefore, may differ from th e
display when the PC reads the response message.
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.