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 Notes...
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...
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 Command Syntax 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 constitute the long form.
Page 12
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 queries with :CARD:PICKout? :MEMory:PICKout? other commands or queries.
Page 13
However, in order to prevent confusion with abbreviated forms and mistakes in operation, it is rec- ommended practice always to prefix " " to headers. On the 3169-20/21, the current paths are as follows: :AOUT :CARD...
• 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...
:STOP:TIME :VOLTage:RANGe :WIRing Answer Message Upon receiving a command, the 3169-20/21 returns to the PC an answer message indicating whether the command has been success- fully 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.
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.
Page 17
Before executing these queries, set flow control between the 3169-20/21 and PC to XON/XOFF, then perform mea- surement. For binary data files, set flow control to RTS/CTS.
Command Reference 3.1.1 Command 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.
Page 25
Command Reference Setting and Inquiry of D/A Output Integration Rate Syntax Command :AOUT:RATE <characters> :AOUT:RATE? Query :AOUT:RATE <characters> Response (Headers: ON) <characters> (Headers: OFF) = 1K/5K/10K/50K/100K/500K/1000K <characters> Function Sets the output rate to be used when D/A output is set to the Command integration results.
Page 26
Command Reference Setting and Inquiry of Backlight Syntax :BACKlight Command <characters> Query :BACKlight? :BACKLIGHT <characters> Response (Headers: ON) <characters> (Headers: OFF) <characters> = ON/OFF/AUTO Function Command Sets the LCD backlight. Query Returns the LCD backlight setting. Example Command :BACK ON Response ALL RIGHT Query...
Page 27
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...
Page 28
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. Note Do not press any key while this command is being executed.
Page 29
This indicates that the measurement file "69MEAS00.CSV" (size: 45342 bytes) is on the PC card. Error An execution error will occur in the following cases: • The PC card is not installed in the 3169-20/21. Note Returns if the specified file does not exist.
Page 30
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. • The start position exceeds the file size. Note •...
Page 31
• You have attempted to save more than 10 setting files. (Up to 10 files can be stored on the PC card.) • The PC card is not installed in the 3169-20/21. Note The extension (.SET) is automatically added to the file.
Page 32
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. Setting and Inquiry of Number of Circuits to be Measured Syntax...
Page 33
Command Reference Setting and Inquiry of Actual Time Syntax Command :CLOCk <year>,<month>,<day>,<hour>,<min>,<sec> :CLOCk? Query CLOCK <year>,<month>,<day>,<hour>,<min>,<sec> Response (Headers: ON) <year>,<month>,<day>,<hour>,<min>,<sec> (Headers: OFF) Function Command Sets the actual time. Returns the current actual time. Query Example Command :CLOC 2002,4,1,15,30,0 Response ALL RIGHT Query :CLOC? Response...
Page 35
Command Reference Setting and Inquiry of Current Range Syntax Command :CURRent:RANGe <numeric 1>,<numeric 2> :CURRent:RANGe? Query :CURRENT:RANGE <numeric 3>,<numeric 4>, Response <numeric 5>,<numeric 6> (Headers: ON) <numeric 3>,<numeric 4>,<numeric 5>,<numeric 6> (Headers: OFF) = 1/2/3/4 (Circuit No.) <numeric 1> = 0.5 to 5000.0 (Current range) <numeric 2>...
Page 36
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.)
Page 37
Command Reference Setting and inquiry of Harmonics Data Output Syntax Command :DATAout:HARMonics <characters> Query :DATAout:HARMonics? :DATAOUT:HARMONICS <characters> Response (Headers: ON) <characters> (Headers: OFF) = OFF/ON <characters> Function Command Sets whether to output a harmonics data (ON/OFF). Query Returns the ON/OFF setting of harmonics data output. Example Command :DATA:HARM ON...
Page 39
Command Reference : Normal measurement/THD/total value/phase angle/con- <numeric 1> tent/level selection data bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0 Normal mea- Total Phase Content Level surement value angle : All ordinals/odd ordinals/even ordinals/integrated value/ <numeric 2> minimum value/maximum value/average value/ instantaneous value selection data bit7 bit6...
Page 40
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...
Page 41
Command Reference Setting and Inquiry of Waveform Data File Storage Syntax Command :DATAout:WAVE <characters> :DATAout:WAVE? Query :DATAOUT:WAVE <characters> Response (Headers: ON) <characters> (Headers: OFF) = OFF/ON <characters> Function Command Sets whether to save a waveform data file (ON/OFF). Query Returns the ON/OFF setting of waveform data file storage. Example Command :DATA:WAVE ON...
Page 42
Command Reference Setting and Inquiry of Measurement Item to be Displayed Syntax Command :DISPlay:MEAS <numeric 1>,<numeric 2>,<numeric 3> :DISPlay:MEAS? Query :DISPLAY:MEAS <numeric 1>,<numeric 2>,<numeric 3> Response (Headers: ON) <numeric 1>,<numeric 2>,<numeric 3> (Headers: OFF) = 0/1/2/3/4/5/6/7/8/9 (Screen) <numeric 1> 0: Main 1: Power 2: Integrate 3: Demand...
Page 43
Command Reference Setting and Inquiry of Display Mode Syntax Command :DISPlay:MODE <characters> :DISPlay:MODE? Query :DISPLAY:MODE <characters> Response (Headers: ON) <characters> (Headers: OFF) = MEAS/SET/FILE <characters> MEAS: Measurement screen SET: Setting screen FILE: File screen Function Switches over to another screen. Command Query Returns the currently displayed screen.
Page 44
Command Reference Setting and Inquiry of Measurement File Name Syntax Command :FILEname:MEAS <characters> :FILEname:MEAS? Query :FILENAME:MEAS <characters> Response (Headers: ON) <characters> (Headers: OFF) = Character-string data with up to 8 characters size <characters> Function Sets the name of a measurement file. Command Clears the set file name if the command does not have <characters>...
Page 45
Command Reference Setting and Inquiry of Setting File Name Syntax Command :FILEname:SET <characters> :FILEname:SET? Query :FILENAME:SET <characters> Response (Headers: ON) <characters> (Headers: OFF) = Character-string data with up to 8 characters size <characters> Function Command Sets the name of a setting file. Clears the set file name if the command does not have <characters>...
Page 46
Command Reference Setting and Inquiry of Measured Line Frequency Syntax Command :FREQuency <numeric> :FREQuency? Query :FREQUENCY <numeric> Response (Headers: ON) <numeric> (Headers: OFF) = 50/60 <numeric> 50: 50 Hz 60: 60Hz Function Command Sets the frequency of the line to be measured. Query Returns the set frequency of the line to be measured.
Page 47
Command Reference Setting and Inquiry of Hold State Syntax Command :HOLD <characters> :HOLD? Query :HOLD <characters> Response (Headers: ON) <characters> (Headers: OFF) = ON/OFF <characters> Function Command Sets whether to hold display (ON/OFF). Query Returns the ON/OFF setting of the Hold function. Example Command :HOLD OFF...
Page 48
Command Reference Setting and Inquiry of Interval Syntax Command :INTErval <characters> :INTErval? Query :INTERVAL <characters> Response (Headers: ON) <characters> (Headers: OFF) = ALL/0.1S/0.2S/0.5S/1S/2S/5S/10S/1M/2M/5M/ <characters> 10M/15M/30M/60M ALL: All waves 0.1S: 100 ms 0.2S: 200 ms 0.5S: 500 ms 1S: 1 second 2S: 2 seconds 5S: 5 seconds 10S: 10 seconds...
Page 49
Command Reference Setting and Inquiry of Language Syntax Command :LANGuage <characters> :LANGuage? Query :LANGUAGE <characters> Response (Headers: ON) <characters> (Headers: OFF) = JAPANESE/ENGLISH/GERMAN/ITALIAN <characters> /CHINESE1/CHINESE2/FRENCH/SPANISH/ KOREAN JAPANESE: Japanese ENGLISH : English GERMAN : German ITALIAN : Italian CHINESE1: Chinese (simple) CHINESE2: Chinese (trad) FRENCH : French SPANISH : Spanish...
Page 50
Query Outputs in text form the items specified with :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.)
Page 51
Command Reference Inquiry of File Name in Internal Memory Syntax Query :MEMory:FILEname? <characters> :MEMORY:FILE <characters> Response (Headers: ON) <characters> (Headers: OFF) = MEAS/INST/BMP/WAVE/SET <characters> MEAS: Measurement file INST: Short-term interval file BMP: Screen file WAVE: Waveform file SET: Setting file Function Query Searches for the specified type of file among the files saved in...
Page 52
Example Query :MEM:PICK? 69MEAS00.CSV,1,1000 Response STX(02)HIOKI 3169..ETX(03) Returns the data from the first byte to the 1000th byte of the file "69MEAS00.CSV". Error 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.
Page 53
Command Reference Formatting of Setting Files in Internal Memory Syntax Command :MEMory:SETting:FORMat Function Formats the setting files in internal memory. Command Example Command :MEM:SET:FORM Response ALL RIGHT Formats the setting files in internal memory. Error A device-dependent error will occur in the following cases: •...
Page 54
:MEM:SET:LOAD 69SET00 Response ALL RIGHT Reads out the file "69SET00.SET" from internal memory, and uses it as the settings for the 3169-20/21. Error A device-dependent error will occur in the following cases: • Execution of this command is attempted during Hold.
Page 55
Command Reference Setting and Inquiry of PT (VT) Ratio Syntax Command <numeric> :PT? Query :PT <numeric> Response (Headers: ON) <numeric> (Headers: OFF) = 0.01 to 9999.99 (PT ratio) <numeric> Function Command Sets the PT ratio. Query Returns the set PT ratio. Example Command :PT 2.0...
Page 56
Command Reference Setting and Inquiry of Baud Rate Syntax Command :RS232c:BAUD <numeric> :RS232c:BAUD? Query :RS232C:BAUD <numeric> Response (Headers: ON) <numeric> (Headers: OFF) = 2400/9600/19200/38400 <numeric> Function Command Sets the baud rate of the RS-232C. Query Returns the set baud rate of the RS-232C. Example Command :RS232:BAUD 38400...
Page 57
Command Reference Setting and Inquiry of Device to Which RS-232C is Connected Syntax Command :RS232c:CONNect <characters> :RS232c:CONNect? Query :RS232C:CONNECT <characters> Response (Headers: ON) <characters> (Headers: OFF) = PC/PRINTER <characters> Function Command Sets the device to which the RS-232C is connected. Returns the set device to which the RS-232C is connected.
Page 58
Command Reference Setting and Inquiry of Flow Control Syntax Command :RS232c:FLOW <characters> :RS232c:FLOW? Query :RS232C:FLOW <characters> Response (Headers: ON) <characters> (Headers: OFF) = OFF/XONXOFF/RTSCTS/BOTH <characters> OFF: Flow control is not used. XONXOFF: XON/XOFF control RTSCTS: RTS/CTS control BOTH: Both XON/XOFF and RTS/CTS are used. Function Command Sets flow control.
Page 59
• 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.
Page 61
Takes the following action in accordance with the time-series Command measurement startup procedure: • Sets the 3169-20/21 starting time-series measurement when the start method is set to manual. • Sets the 3169-20/21 standing by for time-series measure- ment when the start time is set. Example Command :STAR...
Page 62
Command Reference Setting and Inquiry of Time-Series Measurement Start Time Syntax :STARt:TIME Command <year>,<month>,<day>,<hour>,<min> Query :STARt:TIME? :STARt:TIME <year>,<month>,<day>,<hour>,<min> Response (Headers: ON) <year>,<month>,<day>,<hour>,<min> (Headers: OFF) Function Command Sets the time-series measurement start time. Query Returns the set time-series measurement start time. Example Command :STAR:TIME 2002,4,2,8,0...
Page 63
Command Reference Forced stop of Time-Series Measurement Syntax Command :STOP Function Stops time-series measurement immediately. Command Example Command :STOP Response ALL RIGHT Stops time-series measurement immediately. Error A device-dependent error will occur in the following cases: • Execution of this command is attempted while the instrument is stopped time-series measurement.
Page 64
Command Reference Setting and Inquiry of Time-Series Measurement Stop Time Syntax Command :STOP:TIME <year>,<month>,<day>,<hour>,<min> :STOP:TIME? Query :STOP:TIME <year>,<month>,<day>,<hour>,<min> Response (Headers: ON) <year>,<month>,<day>,<hour>,<min> (Headers: OFF) Function Command Sets the time-series measurement stop time. Returns the set time-series measurement stop time. Query Example Command :STOP:TIME 2002,4,2,17,0...
Page 66
Command Reference Inquiry of Actual Time-Series Measurement Stop Time Syntax Query :TIME:STOP? :TIME:STOP <year>,<month>,<day>,<hour>,<min>,<sec> Response (Headers: ON) <year>,<month>,<day>,<hour>,<min>,<sec> (Headers: OFF) Function Returns the actual time-series measurement stop time. Query Example Query :TIME:STOP? Response 2002,4,2,17,0,0 This indicates that the time-series measurement ended at 17:00:00, April 2, 2002.
Page 67
Command Reference Setting and Inquiry of Message Terminator Syntax Command :TRANsmit:TERMinator <numeric> :TRANsmit:TERMinator? Query :TRANSMIT:TERMINATOR <numeric> Response (Headers: ON) <numeric> (Headers: OFF) = 1/2 <characters> 1: CR+LF 2: CR Function Command Sets the message terminator. Query Returns the set message terminator. Example Command :TRAN:TERM 1...
Page 68
Command Reference Setting and Inquiry of VT (PT) Ratio Syntax Command <numeric> :VT? Query :VT <numeric> Response (Headers: ON) <numeric> (Headers: OFF) = 0.01 to 9999.99 (PT ratio) <numeric> Function Command Sets the VT ratio. Query Returns the set VT ratio. Example Command :VT 2.0...
Command List 3.2 Command List The following commands can be used with the 3169-20/21: 3.2.1 Command List Data format Command Explanation (number of the data) page :AOUT:CH1 <numeric>,<numeric>,<chara Setting of Output Items of D/A Output cters>,<numeric>,<numeric> Channel 1 :AOUT:CH1? Inquiry of Output Items of D/A Output...
Page 70
Command List Command Data format Explanation (number of the data) page :CARD:FORMat Formatting of PC Card :CARD:PICKout? <file name>,<numeric>, File Transfer from PC Card <numeric> :CARD:SETting:SAVE <characters> Storage of Setting File on PC Card :CARD:SETting:LOAD <characters> Reading of Setting File from PC Card :CIRCuitnum 1/2/3/4 Setting of Number of Circuits to be Mea-...
Page 71
Command List Command Data format Explanation (number of the data) page :FILEname:MEAS? Inquiry of Measurement File Name :FILEname:SET <characters> Setting of Setting File Name :FILEname:SET? Inquiry of Setting File Name :FREQuency 50/60 Setting of Measured Line Frequency :FREQuency? Inquiry of Measured Line Frequency :HEADer ON/OFF Setting of Communications Output Head-...
Page 72
Command List Command Data format Explanation (number of the data) page :RS232c:CONNect PC/PRINTER Setting of Device to Which RS-232C is Connected :RS232c:CONNect? Inquiry of Device to Which RS-232C is Connected :RS232c:FLOW OFF/XONXOFF/RTSCTS/ Setting of Flow Control BOTH :RS232c:FLOW? Inquiry of Flow Control :SAMPling PLL/FIX Setting of Sampling Method...
Page 73
Command List Command Data format Explanation (number of the data) page :TRANsmit:SEParator? Inquiry of Message Unit Separator :TRANsmit:TERMinator <numeric> Setting of Message Terminator :TRANsmit:TERMinator? Inquiry of Message Terminator :VOLTage:RANGe 150/300/600 Setting of Voltage Range :VOLTage:RANGe? Inquiry of Voltage Range <numeric> Setting of VT (PT) Ratio :VT? Inquiry of VT (PT) Ratio...
Command List 3.2.3 Enabled Commands by Status Time-Series Measure- Status Time-Series Measure- Time-Series Measure- ment Stopped Command ment on Standby ment in Progress Continuou Continuou Continuou Hold Hold Hold :AOUT:CH1 :AOUT:CH1? :AOUT:CH2 :AOUT:CH2? :AOUT:CH3 :AOUT:CH3? :AOUT:CH4 :AOUT:CH4? :RATE :AOUT :RATE? :AOUT :AVEraging :AVEraging?
Page 77
Command List Time-Series Measure- Status Time-Series Measure- Time-Series Measure- ment Stopped Command ment on Standby ment in Progress Continuou Continuou Continuou Hold Hold Hold :DATAout:ITEM :DATAout:ITEM? :DATAout:MEDIa :DATAout:MEDIa? :DATAout:SAVE :DATAout:WAVE :DATAout:WAVE? :DISPlay:MEAS :DISPlay:MEAS? :DISPlay:MODE :DISPlay:MODE? :FILEname:CHANge :FILEname:SET :FILEname:SET? :FILEname:MEAS :FILEname:MEAS? :FREQuency :FREQuency? :HEADer...
Page 78
Command List Time-Series Measure- Status Time-Series Measure- Time-Series Measure- ment Stopped Command ment on Standby ment in Progress Continuou Continuou Continuou Hold Hold Hold :RS232c:BAUD :RS232c:BAUD? :RS232c:CONNect :RS232c:CONNect? :RS232c:FLOW :RS232c:FLOW? :SAMPling :SAMPling? :STARt :SENSor :SENSor? :STARt:METHod :STARt:METHod? :STARt:TIME :STARt:TIME? :STATe? :STOP :STOP:METHod :STOP:METHod?
Command List 3.2.4 Initialization Item List System Defaul Initialization Method, Item Power ON Reset Setting RS-232C baud-rate setting 9600 bps Delimiter CR+LF Varies depending on the Setting items (actual time) setting items Intrinsic functions (e.g., current Varies depending on the range) Varies depending on the setting items setting items...
• Is the PC card properly installed? • Does the specified file exist? function properly. Data is garbled when a file is trans- • Is flow control set between the 3169-20/21 and the PC? ferred using a ":CARD:PICKout?" or ":MEMory:PICKout?" query. Setting commands are rejected.
Page 81
HIOKI 3169-20/21 RS-232C Instruction Manual Publication date: October 2003 Revised edition 2 Edited and published by HIOKI E.E. CORPORATION Technical Support Section All inquiries to International Sales and Marketing Department 81 Koizumi, Ueda, Nagano, 386-1192, Japan TEL: +81-268-28-0562 / FAX: +81-268-28-0568 E-mail: os-com@hioki.co.jp...
Page 82
HEAD OFFICE 81 Koizumi, Ueda, Nagano 386-1192, Japan TEL +81-268-28-0562 / FAX +81-268-28-0568 E-mail: os-com@hioki.co.jp / URL http://www.hioki.co.jp/ HIOKI USA CORPORATION 6 Corporate Drive, Cranbury, NJ 08512, USA TEL +1-609-409-9109 / FAX +1-609-409-9108 3169A985-02 03-10H Printed on recycled paper...
Need help?
Do you have a question about the 3169-20 and is the answer not in the manual?
Questions and answers