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.
Loading...
+ 56 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.