Professional Documents
Culture Documents
Cs Series Ac Current Source Programming Manual Rev F
Cs Series Ac Current Source Programming Manual Rev F
AC Current Source
Programming Manual
Contact Information
Telephone: 800 733 5427 (toll free in North America)
858 450 0085 (direct)
Fax: 858 458 0267
Email:
Domestic Sales: domorders.sd@ametek.com
International Sales: intlorders.sd@ametek.com
Customer Service: service.ppd@ametek.com
Web: www.programmablepower.com
Refers to:
Models:
Single chassis: 3000CS, 4500CS
Multiple chassis: 6000CS/2, 9000CS/2, 13500CS/3, 18000CS/4
i
This page intentionally left blank.
ii
Important Safety Instructions
Before applying power to the system, verify that your product is configured properly for your
particular application.
Only qualified personnel who deal with attendant hazards in power supplies, are allowed to perform
installation and servicing.
Ensure that the AC power line ground is connected properly to the Power Rack input connector or
chassis. Similarly, other power ground lines including those to application and maintenance
equipment must be grounded properly for both personnel and equipment safety.
Always ensure that facility AC input power is de-energized prior to connecting or disconnecting any
cable.
In normal operation, the operator does not have access to hazardous voltages within the chassis.
However, depending on the user’s application configuration, HIGH VOLTAGES HAZARDOUS TO
HUMAN SAFETY may be normally generated on the output terminals. The customer/user must
ensure that the output power lines are labeled properly as to the safety hazards and that any
inadvertent contact with hazardous voltages is eliminated.
Guard against risks of electrical shock during open cover checks by not touching any portion of the
electrical circuits. Even when power is off, capacitors may retain an electrical charge. Use safety
glasses during open cover checks to avoid personal injury by any sudden component failure.
Neither AMETEK Programmable Power Inc., San Diego, California, USA, nor any of the subsidiary
sales organizations can accept any responsibility for personnel, material or inconsequential injury,
loss or damage that results from improper use of the equipment and accessories.
SAFETY SYMBOLS
iii
Product Family: CS Series
WARRANTY TERMS
AMETEK Programmable Power, Inc. (“AMETEK”), provides this written warranty covering the
Product stated above, and if the Buyer discovers and notifies AMETEK in writing of any defect in
material or workmanship within the applicable warranty period stated above, then AMETEK may,
at its option: repair or replace the Product; or issue a credit note for the defective Product; or
provide the Buyer with replacement parts for the Product.
The Buyer will, at its expense, return the defective Product or parts thereof to AMETEK in
accordance with the return procedure specified below. AMETEK will, at its expense, deliver the
repaired or replaced Product or parts to the Buyer. Any warranty of AMETEK will not apply if the
Buyer is in default under the Purchase Order Agreement or where the Product or any part
thereof:
is damaged by misuse, accident, negligence or failure to maintain the same as
specified or required by AMETEK;
is damaged by modifications, alterations or attachments thereto which are not
authorized by AMETEK;
is installed or operated contrary to the instructions of AMETEK;
is opened, modified or disassembled in any way without AMETEK’s consent; or
is used in combination with items, articles or materials not authorized by AMETEK.
The Buyer may not assert any claim that the Products are not in conformity with any warranty
until the Buyer has made all payments to AMETEK provided for in the Purchase Order Agreement.
PRODUCT RETURN PROCEDURE
1. Request a Return Material Authorization (RMA) number from the repair facility (must be
done in the country in which it was purchased):
In the USA, contact the AMETEK Repair Department prior to the return of the
product to AMETEK for repair:
Telephone: 800-733-5427, ext. 2295 or ext. 2463 (toll free North America)
858-450-0085, ext. 2295 or ext. 2463 (direct)
Outside the United States, contact the nearest Authorized Service Center
(ASC). A full listing can be found either through your local distributor or our
website, www.programmablepower.com, by clicking Support and going to the
Service Centers tab.
2. When requesting an RMA, have the following information ready:
Model number
Serial number
Description of the problem
NOTE: Unauthorized returns will not be accepted and will be returned at the shipper’s expense.
NOTE: A returned product found upon inspection by AMETEK, to be in specification is subject to
an evaluation fee and applicable freight charges.
iv
Programming Manual CS Series AC Current Source
Table of Contents
1. Introduction .......................................................................................................................................... 8
1.1 Documentation Summary ............................................................................................................... 8
1.2 Manual organization and format ..................................................................................................... 9
1.3 Introduction to Programming .......................................................................................................... 9
2. Introduction to SCPI .......................................................................................................................... 12
2.1 Conventions Used in This Manual ................................................................................................ 12
2.2 The SCPI Commands and Messages .......................................................................................... 12
2.3 Using Queries ............................................................................................................................... 15
2.4 Coupled Commands ..................................................................................................................... 15
2.5 Structure of a SCPI Message ....................................................................................................... 15
2.6 SCPI Data Formats....................................................................................................................... 18
3. System Considerations ..................................................................................................................... 20
3.1 IEEE-488 / GPIB Interface ............................................................................................................ 20
3.2 USB Interface ............................................................................................................................... 21
3.3 -LAN Option .................................................................................................................................. 27
3.4 RS232C Serial Interface ............................................................................................................... 29
3.5 Instrument Drivers and Application Software ................................................................................ 29
4. SCPI Command Reference ................................................................................................................ 30
4.1 Introduction ................................................................................................................................... 30
4.2 Subsystem Commands................................................................................................................. 31
4.3 Calibration Subsystem .................................................................................................................. 32
4.4 Diagnostic Subsystem .................................................................................................................. 34
4.5 Instrument Subsystem .................................................................................................................. 35
4.6 Limit Subsystem ........................................................................................................................... 36
4.7 Array Measurement Subsystem ................................................................................................... 38
4.8 Current Measurement Subsystem ................................................................................................ 44
4.9 Frequency Measurement Subsystem ........................................................................................... 49
4.10 Power Measurement Subsystem .................................................................................................. 50
4.11 Voltage Measurement Subsystem ................................................................................................ 52
4.12 Output Subsystem ........................................................................................................................ 56
4.13 Power On Subsystem ................................................................................................................... 60
4.14 Sense Subsystem - Sweep ........................................................................................................... 62
4.15 Source Subsystem - Voltage ........................................................................................................ 64
4.16 Source Subsystem - Frequency.................................................................................................... 67
4.17 Source Subsystem - Function ....................................................................................................... 70
4.18 Source Subsystem - List ............................................................................................................... 72
4.19 Source Subsystem - Phase .......................................................................................................... 78
4.20 Source Subsystem - Pulse ........................................................................................................... 80
4.21 Source Subsystem - Current ........................................................................................................ 83
4.22 Status Subsystem Commands ..................................................................................................... 87
4.23 System Commands ...................................................................................................................... 94
4.24 Trace Subsystem Commands .................................................................................................... 100
4.25 Trigger Subsystem ...................................................................................................................... 102
5
Programming Manual CS Series AC Current Source
6
Programming Manual CS Series AC Current Source
Table of Figures
Table of Tables
7
Programming Manual CS Series AC Current Source
1. Introduction
This instruction manual (P/N 7004-988) contains programming information for the CS Series AC
current source.
You will find the following information in this manual:
Chapter 2 Introduction to SCPI
Chapter 3 System Considerations
Chapter 4 SCPI Command Reference
Chapter 5 Common Commands
Chapter 6 Programming Examples
Chapter 7 Programming the Status and Event Registers
Chapter 8 Options
Appendix A SCPI command tree
Appendix B SCPI conformance information
Appendix C Error messages
8
Programming Manual CS Series AC Current Source
9
Programming Manual CS Series AC Current Source
To set up the LAN interface on a Windows XP PC, refer to section 0, Note: Use of the USB
port to control more than one power source from a single PC is not recommended,
as communication may not be reliable. Use GPIB interface for multiple power
source control.
10
Programming Manual CS Series AC Current Source
-LAN Option.
11
Programming Manual CS Series AC Current Source
2. Introduction to SCPI
SCPI (Standard Commands for Programmable Instruments) is a programming language for
controlling instrument functions over the IEEE-488. SCPI is layered on top of the hardware-portion
of IEEE 488.2. The same SCPI commands and parameters control the same functions in different
classes of instruments.
12
Programming Manual CS Series AC Current Source
Root
:OUTPut [:STATe]
:COUPling
:DFI [:STATe]
:SOURce
:PROTection :CLEar
:DELay
13
Programming Manual CS Series AC Current Source
2. OUTPut:PROTection:DELay 20.
The entire message would be:
OUTPut:PROTection:CLEar;DELay 20
The message terminator after DELay 20 returns the path to the root.
The Effect of Optional Headers
If a command includes optional headers, the interface assumes they are there. For example, if
you enter OUTPut OFF, the interface recognizes it as OUTPut:STATe OFF. This returns the
active path to the root (:OUTPut). But if you enter OUTPut:STATe OFF, then the active path
remains at :STATe. This allows you to send
OUTPut:STATe OFF;PROTection:CLEar
in one message. If you tried to send
OUTPut OFF;PROTection:CLEar
the header path would return to :OUTPut instead of :PROTection.
The optional header [SOURce] precedes the current, frequency, function, phase, pulse, list, and
voltage subsystems. This effectively makes :CURRent,:FREQuency, :FUNCtion, :PHASe,
:PULse, :LIST, and :VOLTage root-level commands.
Moving Among Subsystems
In order to combine commands from different subsystems, you need to be able to restore the
active path to the root. You do this with the root specifier (:). For example, you could clear the
output protection and check the status of the Operation Condition register as follows:
OUTPut:PROTection:CLEAr
STATus:OPERation:CONDition?
Because the root specifier resets the command parser to the root, you can use the root specifier
and do the same thing in one message:
OUTPut:PROTection:CLEAr;:STATus:OPERation:CONDition?
The following message shows how to combine commands from different subsystems as well as
within the same subsystem:
VOLTage:LEVel 70;PROTection 80;:CURRent:LEVel 3;PROTection:STATe ON
Note the use of the optional header LEVel to maintain the correct path within the voltage and
current subsystems and the use of the root specifier to move between subsystems.
Note: The "Enhanced Tree Walking Implementation" given in appendix A of the IEEE 488.2
standard is not implemented in the AC source.
14
Programming Manual CS Series AC Current Source
15
Programming Manual CS Series AC Current Source
Data
Message Unit
Query Indicator
Headers
Header
Separator Message
Terminator
Message
Unit Root Specifier
Separator
2.5.3 Headers
Headers are instructions recognized by the AC source. Headers (which are sometimes known as
"keywords") may be either in the long form or the short form.
Long Form The header is completely spelled out, such as VOLTAGE, STATUS, and
DELAY.
Short Form The header has only the first three or four letters, such as VOLT, STAT,
and DEL.
The SCPI interface is not sensitive to case. It will recognize any case mixture, such as TRIGGER,
Trigger, TRIGger. Short form headers result in faster program execution.
Header Convention
In the command descriptions in chapter 3 of this manual, headers are emphasized with boldface
type. The proper short form is shown in upper-case letters, such as DELay.
Header Separator
16
Programming Manual CS Series AC Current Source
If a command has more than one header, you must separate them with a colon (VOLT:PROT
OUTPut:RELay:POLarity).
Optional Headers
The use of some headers is optional. Optional headers are shown in brackets, such as
OUTPut[:STATe] ON. As previously explained under "The Effect of Optional Headers", if you
combine two or more message units into a compound message, you may need to enter the
optional header.
Note: You do not have to precede root-level commands with a colon; there is an implied colon in
front of every root-level command.
17
Programming Manual CS Series AC Current Source
Talking Formats
<NR1> Digits with an implied decimal point assumed at the right of the least-
significant digit. Examples: 273
<NR2> Digits with an explicit decimal point. Example: .0273
<NR3> Digits with an explicit decimal point and an exponent. Example: 2.73E+2
<Bool> Boolean Data. Example: 0 | 1or ON | OFF
Listening Formats
<Nrf> Extended format that includes <NR1>, <NR2> and <NR3>. Examples:
273 273. 2.73E2
<Nrf+> Expanded decimal format that includes <Nrf> and MIN MAX. Examples:
273 273. 2.73E2 MAX. MIN and MAX are the minimum and maximum
limit values that are implicit in the range specification for the parameter.
<Bool> Boolean Data. Example: 0 | 1
18
Programming Manual CS Series AC Current Source
<SRD> String Response Data. Returns string parameters enclosed in double quotes.
19
Programming Manual CS Series AC Current Source
3. System Considerations
This chapter addresses some system issues concerning setting up interfaces such as GPIB, USB
or Ethernet.
A GPIB controller such as a Windows PC with suitable GPIB controller card is required to use the
GPIB interface.
3.1.2 CSGui
The provided Windows CSGui program supports the GPIB interface on CS Series models but
only in combination with a National Instruments GPIB controller. The default controller ID is zero
but controller ID’s from 0 thorugh 3 can be selected in the CSGui Interface screen if multiple GPIB
controllers are present in the same PC. Note that the CSGui program only supports one CS power
source at a time.
20
Programming Manual CS Series AC Current Source
Note: Use of the USB port to control more than one power source from a single PC is not
recommended, as communication may not be reliable. Use GPIB interface for
multiple power source control.
When the “Found New Hardware Wizard” dialog appears, select the “No, not this time.”option.
The drivers are not available on line. Click on Next button to continue.
21
Programming Manual CS Series AC Current Source
The next dialog will ask you to install the software for the CS AC Source. Select the “Install the
software automatically (Recommended)” option and click on Next to continue.
The USB device drivers have not been WindowsXP Logo certified. Due to the limited distribution
of these drivers, this is unlikely to be done. This Logo certification has no bearing on the
functionality or legitimacy of this device driver so you can ignore this message. Click the “Continue
Anyway” button to continue.
The installation will now proceed. This process may take several minutes to complete.
22
Programming Manual CS Series AC Current Source
Once completed, the dialog box shown above will appear signaling the device drivers have been
installed. The USB interface is now available to the PC’s operating system. To complete the install
process, click on the “Finish” button.
To verify the USB port is available, you can access the Windows System Properties screen, select
the Hardware tab and open the Windows Device Manager screen. The CS Source should be
listed under “Multi-port serial adapters” as shown in the image below.
23
Programming Manual CS Series AC Current Source
Next, select the “Install from a list or specific location (Advanced)” option and click on the Next
button to continue.
24
Programming Manual CS Series AC Current Source
When prompted for the location of the driver software, select the “Search removable media
(floppy, CD)” option. Click on the Next button to continue.
The installation wizard should be able to locate virtual com driver at in sub directory “\USB_Inf” on
the CIC496 CD Rom. If not, you will have to browse to this directory on the CD ROM when
prompted for a specific location.
If the INF file is found, the installation will proceed automatically.
The USB to Com virtual device drivers have not been WindowsXP Logo certified. Due to the
limited distribution of these drivers, this is unlikely to be done. This Logo certification has no
bearing on the functionality or legitimacy of this device driver so you can ignore this message.
Click the “Continue Anyway” button to continue.
The installation will now proceed. This process may take several minutes to complete. Once
completed, the final dialog will appear as shown.
25
Programming Manual CS Series AC Current Source
The USB to Com virtual port is now available to the PC’s operating system. To complete the
install process, click on the “Finish” button. To verify the virtual com port is available, you can
access the Windows System Properties screen, select the Hardware tab and open the Windows
Device Manager screen. The CS Source should be listed under “Ports (COM & LPT)” as shown
in the image below. The com port number is automatically assigned. Note the com port number
for subsequent reference in your application software or when selected the COM port in the
CSGui Interface screen.
Once completed, you can remove the CIC496 CD Rom. The USB interface to the AC source is
now available for use.
Note: Use of the USB port to control more than one power source from a single PC is not
recommended, as communication may not be reliable. Use GPIB interface for
multiple power source control.
26
Programming Manual CS Series AC Current Source
Note: If a USB cable is plugged into the USB interface connector of the power source, the LAN
interface will be disabled. Remove any USB connection to use the LAN / Ethernet port.
27
Programming Manual CS Series AC Current Source
28
Programming Manual CS Series AC Current Source
Note: If a USB cable is plugged into the USB interface connector of the power source, the RS232
interface will be disabled. Remove any USB connection to use the serial port.
The RS232C interface is factory enabled for the CS Series. The RS232C cable required to
connect the CS Series AC Current Source to a PC serial port is a standard 9 pin Male to 9 pin
Female straight-thorugh serial cable. A suitable 6 feet long RS232C cable is supplied with each
power soruce. (CI P/N 250709). Replacement cables are available through customer service
(support@calinst.com)
29
Programming Manual CS Series AC Current Source
4.1 Introduction
This chapter provides a complete listing of all SCPI commands supported by the CS Series Series
of AC sources. Commands are grouped by function according the root level commands. Some
general command related issues are:
Phases
If a command can apply to individual phases of an AC source, the entry “Phase Selectable” will
appear in the command description.
Related Commands
Where appropriate, related commands or queries are included. These are listed because they are
either directly related by function, or because reading about them will clarify or enhance your
understanding of the original command or query.
This chapter is organized as follows:
Subsystem commands, arranged by subsystem
IEEE 488.2 common commands
30
Programming Manual CS Series AC Current Source
31
Programming Manual CS Series AC Current Source
CALibrate:MEASure:CURRent
Phase Selectable
This command can only be used in calibration mode. It initiates the calibration of the AC current
metering circuits. The query format returns the actual calibration coefficient. Use the INST:SEL or
INST:NSEL to select the desired phase.
Command Syntax CALibrate:MEASure:CURRent
Parameters None
Query Syntax CALibrate:MEASure:CURRent?
Returned Parameters <NR3>
Examples CAL:MEAS:CURR
Related Commands CAL:SAVE CAL:MEAS:VOLT
CALibrate:MEASure:CURRent:SPHase
This command can only be used in calibration mode and in query form. It applies only to phase A.
It returns the single-phase mode current measurement calibration coefficient. If the CS is in
single phase mode, this command is equivalent to the the CAL:MEAS:CURR? query for phase
1/A except it can not be used to perform a calibration. It does not initiate a calibration. Use the
CAL:MEAS:CURR? command to do this instead.
Query Syntax CALibrate:MEASure:CURRent?
Returned Parameters <NR3>
Examples CAL:MEAS:CURR:SPH?
Related Commands CAL:SAVE CAL:MEAS:VOLT
CALibrate:MEASure:VOLTage
Phase Selectable
This command can only be used in calibration mode. It initiates the calibration of the AC voltage
metering circuits. The query format returns the actual calibration coefficient. Use the INST:SEL or
INST:NSEL to select the desired phase.
32
Programming Manual CS Series AC Current Source
CALibrate:PASSword
This command can only be used to unlock the calibration mode. Once unlocked, non-query
calibration commands will be accepted. Query commands are always accepted.
Command Syntax CALibrate:PASSword<NRf>
Parameters <high voltage range> (default)
Examples CAL:PASS 135
Related Commands none
CALibrate:SAVE
This command can only be used in calibration mode. It saves any new calibration constants (after
a current or voltage calibration procedure has been completed) in nonvolatile memory.
Command Syntax: CALibrate:SAVE
Parameters None
Examples CAL:SAVE
Related Commands CAL:CURR CAL:VOLT
CALibrate[:SOURce]:PHASe
Phase Selectable
This command can be used to set the phase calibration coefficient. Use the INST:SEL or
INST:NSEL to select the desired phase. This allows the phase for voltage 2 and 3 (B and C) to
be adjusted with respect to phase A. The query format returns the actual calibration coefficient
Command Syntax CALibrate[:SOURce]:PHASe
Parameters <NRf+>
Query Syntax CALibrate[:SOURce]:PHASe?
Returned Parameters <NR3>
Examples CAL:PHAS 1.3
Related Commands none
CALibrate[:SOURce]:CURRent
Phase Selectable
This command can be used to query the output current calibration coefficient. Only the query
format is available. Use the INST:SEL or INST:NSEL to select the desired phase.
Command Syntax CALibrate[:SOURce]:CURRent
Parameters None
Query Syntax CALibrate[:SOURce]:CURRent?
Returned Parameters <NR3>
Examples CAL:CURR?
Related Commands none
33
Programming Manual CS Series AC Current Source
DIAGnostic:TEMPerature:AMBient?
This query returns the temperature measured at the ambient sense thermistor in degrees C.
Query Syntax DIAGnostic:TEMPerature:AMBient?
Parameters None
Examples DIAG:TEMP:AMB?
Returned Parameters <NR3>
34
Programming Manual CS Series AC Current Source
INSTrument:COUPle
In a three-phase power source it is convenient to set parameters of all three output phases
simultaneously with one programming command. When INST:COUP ALL is programmed,
sending a command to any phase will result in that command being sent to all three phases.
INSTrument:COUPle only affects the operation of subsequent commands. It does not by itself
immediately affect the AC source's output. The commands that are affected by
INSTrument:COUPle are those with the designation: Phase Selectable.
INSTrument:COUPle has no affect on queries. There is no way to query more than one phase
with a single command. Directing queries to individual phases is done with INSTrument:NSELect.
Command Syntax INSTrument:COUPle<coupling>
Parameters ALL|NONE
*RST Value ALL
Examples INST:COUP ALL
Query Syntax INSTrument:COUPle?
Returned Parameters <CRD>
Related Commands INST:NSEL
INSTrument:NSELect
INSTrument:SELect
These commands allow the selection of individual outputs in a three-phase model for subsequent
commands or queries. Their operation is dependent on the setting of INSTrument:COUPle. If
INST:COUP NONE is programmed, then the phase selectable commands are sent only to the
particular output phase set by INSTrument:NSELect. If INST:COUP ALL is programmed, then all
commands are sent to all three output phases.
INSTrument:NSELect selects the phase by its number, while INSTrument:SELect references it by
name. These commands also select which output phase returns data when a query is sent.
Command Syntax INSTrument:NSELect <NR1>
INSTrument:SELect <output>
Parameters For INST:NSEL: 1 | 2 | 3
For INST:SEL: OUTPut1 | OUTPut2 | OUTPut3
*RST Value 1 or OUTPut1
Examples INST:NSEL 3
Query Syntax INSTrument:NSELect?
Returned Parameters <NR1>
Related Commands INST:COUP
35
Programming Manual CS Series AC Current Source
LIMit:FREQuency:HIGH
Query form returns the maximum available output frequency. This value determines the maximum
frequency available using a sinusoidal waveform. Note that this is not the same as the available
maximum frequency, which is a function of the frequency harmonic content of the waveform. To
query the maximum available frequency, use the FREQ? MAX command.
Query Syntax LIMit:FREQuency:HIGH?
Returned Parameters <NR3>
Examples LIM:FREQ:HIGH?
Related Commands LIM:FREQ:LOW?
LIMit:FREQuency:LOW
Query form returns the maximum available output frequency. This value determines the minimum
frequency available.
Query Syntax LIMit:FREQuency:LOW?
Returned Parameters <NR3>
Examples LIM:FREQ:LOW?
Related Commands LIM:FREQ:HIGH?
LIMit:PHASe
Query form returns the phase configuration setting. This value determines the phase mode of
operation according to the table below:
Setting Operation
0 Single-phase mode.
120 Three phase mode. Determines relative phase angle between phases A,
36
Programming Manual CS Series AC Current Source
B and C (ø1, ø2 and ø3). If the MODE field is set (standard on CS Series)
the AC source can operate in both 1 and 3 phase modes.
Other Any value other than 0 or 120 indicates 2 phase configuration with phase
angle between A and B set to value shown.
LIMit:VOLTage:HIGH
Query form returns the maximum available output voltage. This value determines the maximum
AC RMS compliance voltage available using a sinusoidal waveform. Note that this is not the same
as the available maximum voltage, which is a function crest factor of the voltage waveform. To
query the maximum available voltage, use the VOLT? MAX command. On the CS Series, the
HIGH and LOW voltage limits are set to the same value.
Query Syntax LIMit:VOLTage:HIGH?
Returned Parameters <NR3>
Examples LIM:VOLT:HIGH?
Related Commands LIM:VOLT:LOW?
LIMit:VOLTage:LOW
Query form returns the maximum available output voltage. This value determines the maximum
AC RMS compliance voltage available using a sinusoidal waveform. Note that this is not the same
as the available maximum voltage, which is a function crest factor of the voltage waveform. To
query the maximum available voltage, use the VOLT? MAX command. On the CS Series, the
HIGH and LOW voltage limits are set to the same value.
Query Syntax LIMit:VOLTage:LOW?
Returned Parameters <NR3>
Examples LIM:VOLT:LOW?
Related Commands LIM:VOLT:HIGH?
37
Programming Manual CS Series AC Current Source
Subsystem Syntax
MEASure | FETCh
:ARRay
:CURRent
[:DC]? Returns the digitized instantaneous current
:HARMonic
[:AMPLitude]? Returns amplitudes of the first 50 harmonics
:PHASe? Returns phase angles of the first 50 harmonics
:MODE Selects waveform data transfer format
:NEUTral
[:DC]? Returns the neutral digitized instantaneous current (3-
phase only)
:HARMonic
[:AMPLitude]? Returns neutral current harmonic amplitude
:PHASe? Returns neutral current harmonic phase
:VOLTage
[:DC]? Returns the digitized instantaneous voltage
:HARMonic
[:AMPLitude]? Returns amplitudes of the first 50 harmonics
:PHASe? Returns phase angles of the first 50 harmonics
MEASure:ARRay:CURRent?
FETCh:ARRay:CURRent?
Phase Selectable
These queries return an array containing the instantaneous output current in amperes. The data
returned in arbitrary block data format as follows:
#5<block length n><b0><b1><b2><b3>.....<bn-3><bn -2><bn-1><bn>
where b0,b1,b2,b3 are four hex bytes represent IEEE single precision floating number, where b0
is the most significant byte and b3 is the least significant byte. The number of bytes returned is
contained in the data block header which always starts with the “#” pound character followed by a
single decimal character indicating the number of digits that make up the block length of the data.
Thus, “#516384…” indicates that there are 5 digits that follow containing the number of bytes in
the data block (excluding the header and length information). The actual number of bytes in this
case is 16384 or 16Kbytes.
The output voltage and current are digitized whenever a measure command is given or whenever
an acquisition trigger occurs. The acquisition sampling time interval is set by
SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the data
buffer is determined by SENSe:SWEep:OFFSet:POINts.
This command has two optional parameters. The first one may be used to specify the number of
256 data sample blocks to transfer. Valid parameter values are from 1 through 16. The second
parameter may be used to specify the offset in number of 256 data sample blocks from which to
38
Programming Manual CS Series AC Current Source
start the data transfer. Valid offset values are from 0 thorugh 15. If both parameters are omitted,
all 16 blocks are transferred starting from offset 0 (first block).
Query Syntax MEASure:ARRay:CURRent[:DC]? [<n>,<n>]
FETCh:ARRay:CURRent[:DC]? [<n>,<n>]
Parameters Optional block and offset parameters <n>,<n>. Where the first value <n>
is the number of 256 sample blocks to transfer and the second value <n>
is the first block (offset) to start with. Number of blocks is from 1 to 16,
offset is from 0 to 15.
Examples MEAS:ARR:CURR? FETC:ARR:CURR? 4,0
Returned Parameters 4096 NR3 values
Related Commands INST:NSEL SENS:SWE
MEASure:ARRay:CURRent:HARMonic?
FETCh:ARRay:CURRent:HARMonic?
Phase Selectable
These queries return an array of harmonic amplitudes of output current in rms amperes. The first
value returned is the dc component, the second value is the fundamental frequency, and so on up
to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement
bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can
be measured is dependent on the output frequency. Any harmonics that represent frequencies
greater than 16 kHz are returned as 0.
Query Syntax MEASure:ARRay:CURRent:HARMonic[:AMPLitude]?
FETCh:ARRay:CURRent:HARMonic[:AMPLitude]?
Parameters None
Examples MEAS:ARR:CURR:HARM? FETC:ARR:CURR:HARM?
Returned Parameters 51 NR3 values
Related Commands INST:NSEL
MEASure:ARRay:CURRent:HARMonic:PHASe?
FETCh:ARRay:CURRent:HARMonic:PHASe?
Phase Selectable
These queries return an array of harmonic phases of output current in degrees, referenced to the
positive zero crossing of the fundamental component. The first value returned is the dc
component (always returned as 0 degrees phase), the second value is the fundamental
frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the
fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the
maximum harmonic that can be measured is dependent on the output frequency. Any harmonics
that represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure:ARRay:CURRent:HARMonic:PHASe?<NRf>
FETCh:ARRay:CURRent:HARMonic:PHASe?<NRf>
Parameters None
Examples MEAS:ARR:CURR:HARM:PHAS?
FETC:ARR:CURR:HARM:PHAS?
Returned Parameters 51 NR3 values
Related Commands INST:NSEL
MEASure:ARRay:CURRent:NEUTral?
FETCh:ARRay:CURRent:NEUTral?
These queries return an array containing the instantaneous output current of the neutral output
terminal in amperes. The output voltage and current are digitized whenever a measure command
is given or whenever an acquisition trigger occurs. The acquisition sampling time interval is set by
39
Programming Manual CS Series AC Current Source
SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the data
buffer is determined by SENSe:SWEep:OFFSet:POINts.
Query Syntax MEASure:ARRay:CURRent:NEUTral[:DC]?
FETCh:ARRay:CURRent:NEUTral[:DC]?
Parameters None
Examples MEAS:ARR:CURR:NEUT? FETC:ARR:CURR:NEUT?
Returned Parameters 4096 NR3 values
Related Commands INST:NSEL SENS:SWE
MEASure:ARRay:CURRent:NEUTral:HARMonic?
FETCh:ARRay:CURRent:NEUTral:HARMonic?
These queries return an array of harmonic amplitudes of output current of the neutral output
terminal in rms amperes.
The first value returned is the dc component, the second value is the fundamental frequency, and
so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental
measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum
harmonic that can be measured is dependent on the output frequency. Any harmonics that
represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure:ARRay:CURRent:NEUTral:HARMonic[:AMPLitude]?
FETCh:ARRay:CURRent:NEUTral:HARMonic[:AMPLitude]?
Parameters None
Examples MEAS:ARR:CURR:NEUT:HARM?
FETC:ARR:CURR:NEUT:HARM?
Returned Parameters 51 NR3 values
Related Commands INST:NSEL
MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe?
FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe?
These queries return an array of harmonic phases of output current of the neutral output terminal
in degrees, referenced to the positive zero crossing of the fundamental component. The first value
returned is the dc component (always returned as 0 degrees phase); the second value is the
fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up
to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus,
the maximum harmonic that can be measured is dependent on the output frequency. Any
harmonics that represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe?
FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe?
Parameters None
Example MEAS:ARR:CURR:NEUT:HARM:PHAS?
FETC:ARR:CURR:NEUT:HARM:PHAS?
Returned Parameters 51 NR3 values
Related Commands INST:NSEL
MEASure:ARRay:MODe
This command selects the waveform array data format to be used. The default mode is binary
(BIN) which uses an IEEE floating point data format in which each data sample is transferred as a
4 byte floating point binary data word. Alternatively, an ASCII format may be selected (ASCii) in
which each data sample is sent as 8 ASCII Hex values representing the 4 byte IEEE floating point
data. Note that the transfer mode only applies to MEAS:ARR:VOLT and MEAS:ARR:CURR
queries. All other measurement queries always return ASCII data. Note that at power on, the
default mode is always set to binary (BIN).
40
Programming Manual CS Series AC Current Source
Syntax MEASure:ARRay:MODe
Parameters BIN | ASCii
Examples MEAS:ARR:MOD ASC
Related Commands MEAS:ARR:VOLT MEAS:ARR:CURR
Note: The MEAS:ARR:MOD command is provided to allow waveform data transfers in ASCII on
DBCS versions of MS Windows. Examples of DBCS versions are Chinese, Korean, Japanese
etc. On most Windows versions, the binary mode can be used as it reduces the amount of data
transferred and thus provides better throughput.
The ASCII mode will double the number of characters transferred so provisions for a larger
receive buffer on the PC may have to be made. On the Lx/Ls, the full acquisition data size that
can be sent with one command in BIN mode is 16KB, in ASC mode 32KB.
The binary data must be converted to a single precision floating point notation. Sample VB6 code
is shown on the next page.
Conversion function sample VB6. Converting waveform data from either transfer mode to a single
precision value can be accomplished using the following sample routine:
Public Function StringToIEEEFloat(ByVal sData As String, ByVal bAsciiMode As Boolean) As
Single
'=============================================================
'bAsciiMode flag is used if data is received as 8 ascii chars
'representing Hex 0-9,A-F. If bAsciiMode flag is false, then
'data is process as 4 char representing a byte each. Ascii
'mode is needed for DCBS windows
'=============================================================
Dim i As Integer
Dim j As Integer
Dim iChar As Integer
Dim expo As Long
Dim mantisse As Long
Dim expo_val As Variant
Dim mant_f As Single
Dim c(3) As Long 'Must use 32 bit integers to allow for
'intermediate result of 24 bit shift
Dim sign As Boolean
'=============================================================
Const MANT_MAX = &H7FFFFF
Const EXPO_MAX = 2 ^ 126
'=============================================================
41
Programming Manual CS Series AC Current Source
FloatConvError:
'Conversion errors are truncated to zero
StringToIEEEFloat = 0
Exit Function
End Function
MEASure:ARRay:VOLTage?
FETCh:ARRay:VOLTage?
Phase Selectable
These queries return an array containing the instantaneous output voltage in volts. The data
returned in arbitrary block data format as follows:
#5<block length n><b0><b1><b2><b3>.....<bn-3><bn -2><bn-1><bn>
where b0,b1,b2,b3 are four hex bytes represent IEEE single precision floating number, where b0
is the most significant byte and b3 is the least significant byte. The number of bytes returned is
contained in the data block header which always starts with the “#” pound character followed by a
single decimal character indicating the number of digits that make up the block length of the data.
Thus, “#516384…” indicates that there are 5 digits that follow containing the number of bytes in
the data block (excluding the header and length information). The actual number of bytes in this
case is 16384 or 16Kbytes.
The output voltage and current are digitized whenever a measure command is given or whenever
an acquire trigger occurs. If digitization is caused by a measure command, the time interval
between samples is determined by the output frequency. For frequencies greater than 45 Hz, the
time interval is 10.4 microseconds. If digitization is caused by an acquire trigger, the time interval
is set by SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the
data buffer is determined by SENSe:SWEep:OFFSet:POINts.
This command has two optional parameters. The first one may be used to specify the number of
256 data sample blocks to transfer. Valid parameter values are from 1 through 16. The second
parameter may be used to specify the offset in number of 256 data sample blocks from which to
start the data transfer. Valid offset values are from 0 thorugh 15. If both parameters are omitted,
all 16 blocks are transferred starting from offset 0 (first block).
42
Programming Manual CS Series AC Current Source
MEASure:ARRay:VOLTage:HARMonic?
FETCh:ARRay:VOLTage:HARMonic?
Phase Selectable
These queries return an array of harmonic amplitudes of output voltage in rms volts. The first
value returned is the dc component, the second value is the fundamental frequency, and so on up
to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement
bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can
be measured is dependent on the output frequency. Any harmonics that represent frequencies
greater than 16 kHz are returned as 0.
Query Syntax MEASure:ARRay:VOLTage:HARMonic[:AMPLitude]?
FETCh:ARRay:VOLTage:HARMonic[:AMPLitude]?
Parameters None
Examples MEAS:ARR:VOLT:HARM? FETC:ARR:VOLT:HARM?
Returned Parameters 51 NR3 values
Related Commands INST:NSEL
43
Programming Manual CS Series AC Current Source
MEASure:CURRent:AC?
FETCh:CURRent:AC?
Phase Selectable
These queries return the AC component rms current being sourced at the output terminals.
44
Programming Manual CS Series AC Current Source
MEASure:CURRent:ACDC?
FETCh:CURRent:ACDC?
Phase Selectable
These queries return the AC and DC components of the rms current being sourced at the output
terminals.
Query Syntax MEASure[:SCALar]:CURRent:ACDC?
FETCh[:SCALar]:CURRent:ACDC?
Parameters None
Examples MEAS:CURR:ACDC? FETC:CURR:ACDC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:HARMonic?
FETCh:CURRent:HARMonic?
Phase Selectable
These queries return the rms amplitude of the Nth harmonic of output current. The parameter is
the desired harmonic number. Queries sent with a value of 0 return the DC component. A value of
1 returns the fundamental output frequency. Harmonic orders can be measured up to the
fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the
maximum harmonic that can be measured is dependent on the output frequency. Any harmonics
that represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure[:SCALar]:CURRent:HARMonic[:AMPLitude]?<NRf>
FETCh[:SCALar]:CURRent:HARMonic[:AMPLitude]?<NRf>
Parameters 0 to 50
Examples MEAS:CURR:HARM? 3
FETC:CURR:HARM? 1
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:HARMonic:PHASe?
FETCh:CURRent:HARMonic:PHASe?
Phase Selectable
These queries return the phase angle of the Nth harmonic of output current, referenced to the
positive zero crossing of the fundamental component. The parameter is the desired harmonic
number. Queries sent with a value of 0 return the DC component. A value of 1 returns the
fundamental output frequency. Harmonic orders can be measured up to the fundamental
measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum
harmonic that can be measured is dependent on the output frequency. Any harmonics that
represent frequencies greater than 16 kHz are returned as 0.
45
Programming Manual CS Series AC Current Source
MEASure:CURRent:HARMonic:THD?
FETCh:CURRent:HARMonic:THD?
Phase Selectable
These queries return the percentage of total harmonic distortion and noise in the output current.
Query Syntax MEASure[:SCALar]:CURRent:HARMonic:THD?
FETCh[:SCALar]:CURRent:HARMonic:THD?
Parameters None
Examples MEAS:CURR:HARM:THD? FETC:CURR:HARM:THD?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:NEUTral?
FETCh:CURRent:NEUTral?
These queries return the DC current in the neutral output terminal of a three-phase AC source.
Query Syntax MEASure[:SCALar]:CURRent:NEUTral[:DC]?
FETCh[:SCALar]:CURRent:NEUTral[:DC]?
Parameters None
Examples MEAS:CURR:NEUT? FETC:CURR:NEUT?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:NEUTral:AC?
FETCh:CURRent:NEUTral:AC?
These queries return the AC rms current in the neutral output terminal of a three-phase AC
source.
Query Syntax MEASure[:SCALar]:CURRent:NEUTral:AC?
FETCh[:SCALar]:CURRent:NEUTral:AC?
Parameters None
Examples MEAS:CURR:NEUT:AC? FETC:CURR:NEUT:AC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:NEUTral:ACDC?
FETCh:CURRent:NEUTral:ACDC?
These queries return the AC+DC rms current in the neutral output terminal of a three-phase AC
source.
46
Programming Manual CS Series AC Current Source
MEASure:CURRent:NEUTral:HARMonic?
FETCh:CURRent:NEUTral:HARMonic?
These queries return the rms amplitude of the Nth harmonic of current in the neutral output
terminal of a three-phase AC source. The parameter is the desired harmonic number. Queries
sent with a value of 0 return the DC component. A value of 1 returns the fundamental output
frequency. Harmonic orders can be measured up to the fundamental measurement bandwidth of
the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured
is dependent on the output frequency. Any harmonics that represent frequencies greater than 16
kHz are returned as 0.
Query Syntax MEASure[:SCALar]:CURRent:NEUTral:HARMonic
[:AMPLitude]?<NRf>
FETCh[:SCALar]:CURRent:NEUTral:HARMonic
[:AMPLitude]?<NRf>
Parameters 0 to 50
Examples MEAS:CURR:NEUT:HARM? 3 FETC:CURR:NEUT:HARM? 1
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:CURRent:NEUTral:HARMonic:PHASe?
FETCh:CURRent:NEUTral:HARMonic:PHASe?
These queries return the phase angle of the Nth harmonic of current in the neutral output terminal
of a three-phase, referenced to the positive zero crossing of the fundamental component.
The parameter is the desired harmonic number. Queries sent with a value of 0 return the DC
component. A value of 1 returns the fundamental output frequency. Harmonic orders can be
measured up to the fundamental measurement bandwidth of the measurement system, which is
16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output
frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure[:SCALar]:CURRent:NEUTral:HARMonic
:PHASe?<NRf>
FETCh[:SCALar]:CURRent:NEUTral:HARMonic
:PHASe?<NRf>
Parameters 0 to 50
Examples MEAS:CURR:NEUT:HARM:PHAS? 3
FETC:CURR:NEUT:HARM:PHAS? 1
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:THDistortion:MODE
This command sets the calculation method for THD measurements. The distortion calculation is
based on the H2 through H50 with the RMS voltage or current in the denominator. Note that some
definitions of THD use the fundamental component (H1) of the voltage as the denominator.
CS units can be programmed to use the fundamental component as the denominator instead of
the RMS value. This mode can only be programmed over the bus by sending the
“MEAS:THD:MODE FUND” command. At power up or after a reset command, the mode will
revert back to the RMS mode. This mode setting is not saved in any of the set up registers.
47
Programming Manual CS Series AC Current Source
Syntax MEASure:THDistortion:MODE
Parameters RMSQuare | FUNDamental
Examples MEAS:THD:MODE FUND
Query Syntax MEAS:THD:MODE?
Returned Parameters <CRD>
Related Commands MEAS:VOLT:HARM:THD? MEAS:CURR:HARM:THD?
48
Programming Manual CS Series AC Current Source
49
Programming Manual CS Series AC Current Source
MEASure:POWer:AC?
FETCh:POWer:AC?
Phase Selectable
These queries return the in-phase component of power being sourced at the output terminals in
watts.
Query Syntax MEASure[:SCALar]:POWer:AC[:REAL]?
FETCh[:SCALar]:POWer:AC[:REAL]?
Parameters None
Examples MEAS:POW:AC? FETC:POW:AC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:POWer:AC:APParent?
FETCh:POWer:AC:APParent?
Phase Selectable
These queries return the apparent power being sourced at the output terminals in volt-amperes.
50
Programming Manual CS Series AC Current Source
MEASure:POWer:AC:REACtive?
FETCh:POWer:AC:REACtive?
Phase Selectable
These queries return the reactive power being sourced at the output terminals in volt-amperes
reactive. Reactive power is computed as:
VAR = sqrt(square(apparent power) - square(real power))
Query Syntax MEASure[:SCALar]:POWer:AC:REACtive?
FETCh[:SCALar]:POWer:AC:REACtive?
Parameters None
Examples MEAS:POW:AC:REAC? FETC:POW:AC:REAC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:POWer:AC:PFACtor?
FETCh:POWer:AC:PFACtor?
Phase Selectable
These queries return the output power factor. The power factor is computed as:
pfactor = real power/apparent power
Query Syntax MEASure[:SCALar]:POWer:AC:PFACtor?
FETCh[:SCALar]:POWer:AC:PFACtor?
Parameters None
Examples MEAS:POW:AC:PFAC? FETC:POW:AC:PFAC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:POWer:AC:TOTal?
FETCh:POWer:AC:TOTal?
These queries return the total power being sourced at the output terminals of a three-phase AC
source.
Query Syntax MEASure[:SCALar]:POWer:AC:TOTal?
FETCh[:SCALar]:POWer:AC:TOTal?
Parameters None
Examples MEAS:POW:AC:TOT? FETC:POW:AC:TOT?
Returned Parameters <NR3>
51
Programming Manual CS Series AC Current Source
MEASure:VOLTage:AC?
FETCh:VOLTage:AC?
Phase Selectable
These queries return the AC rms voltage being sourced at the output terminals.
Query Syntax MEASure[:SCALar]:VOLTage:AC?
FETCh[:SCALar]:VOLTage:AC?
Parameters None
Examples MEAS:VOLT:AC? FETC:VOLT:AC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:VOLTage:ACDC?
FETCh:VOLTage:ACDC?
52
Programming Manual CS Series AC Current Source
Phase Selectable
These queries return the AC or DC rms voltage being sourced at the output terminals.
Query Syntax MEASure[:SCALar]:VOLTage:ACDC?
FETCh[:SCALar]:VOLTage:ACDC?
Parameters None
Examples MEAS:VOLT:ACDC? FETC:VOLT:ACDC?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:VOLTage:AMPLitude:MAXimum?
FETCh:VOLTage:AMPLitude:MAXimum?
Phase Selectable
These queries return the absolute value of the peak voltage as sampled over one measurement
acquisition of 4096 data points. Note that the MEAS format returns the non-recurring peak current
(as in a peak hold reading). This value can be cleared with the MEAS:CURR:AMP:RES
command. The FETC format can be used to obtain the recurring or repetitive peak current this
requires the acquisition to be triggered first by either an INIT:ACQ or a MEAS command for
another paramter e.g. current, followed by the FETC:CURR:AMPL:MAX?
Query Syntax MEASure[:SCALar]:VOLTage:AMPLitude:MAXimum?
FETCh[:SCALar]:VOLTage:AMPLitude:MAXimum?
Parameters None
Examples MEAS:VOLT:AMPL:MAX? FETC:VOLT:AMPL:MAX?
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:VOLTage:AMPLitude:RESet
FETCh:VOLTage:AMPLitude:RESet
Phase Selectable
These command resets the peak voltage hold value returned with the MEAS:CURR:AMPL:MAX?
query.
Syntax MEASure[:SCALar]:VOLTage:AMPLitude:RESet
FETCh[:SCALar]:VOLTage:AMPLitude:RESet
Parameters None
Examples MEAS:VOLT:AMPL:RES
Returned Parameters None
Related Commands MEAS:VOLT:AMPL:MAX? FETC:VOLT:AMPL:MAX?
MEASure:VOLTage:CREStfactor?
FETCh:VOLTage:CREStfactor?
Phase Selectable
These queries return the output voltage crest factor. This is the ratio of peak output voltage to rms
output voltage.
53
Programming Manual CS Series AC Current Source
MEASure:VOLTage:HARMonic?
FETCh:VOLTage:HARMonic?
Phase Selectable
These queries return the rms amplitude of the Nth harmonic of output voltage. The parameter is
the desired harmonic number. Queries sent with a value of 0 return the DC component. A value of
1 returns the fundamental output frequency. Harmonic orders can be measured up to the
fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the
maximum harmonic that can be measured is dependent on the output frequency. Any harmonics
that represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure[:SCALar]:VOLTage:HARMonic[:AMPLitude]?<NRf>
FETCh[:SCALar]:VOLTage:HARMonic[:AMPLitude]?<NRf>
Parameters 0 to 50
Examples MEAS:VOLT:HARM? 3
FETC:VOLT:HARM? 1
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:VOLTage:HARMonic:PHASe?
FETCh:VOLTage:HARMonic:PHASe?
Phase Selectable
These queries return the phase angle of the Nth harmonic of output voltage, referenced to the
positive zero crossing of the fundamental component. The parameter is the desired harmonic
number. Queries sent with a value of 0 return the DC component. A value of 1 returns the
fundamental output frequency. Harmonic orders can be measured up to the fundamental
measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum
harmonic that can be measured is dependent on the output frequency. Any harmonics that
represent frequencies greater than 16 kHz are returned as 0.
Query Syntax MEASure[:SCALar]:VOLTage:HARMonic:PHASe?<NRf>
FETCh[:SCALar]:VOLTage:HARMonic:PHASe?<NRf>
Parameters 0 to 50
Examples MEAS:VOLT:HARM:PHAS? 3
FETC:VOLT:HARM:PHAS? 1
Returned Parameters <NR3>
Related Commands INST:NSEL
MEASure:VOLTage:HARMonic:THD?
FETCh:VOLTage:HARMonic:THD?
Phase Selectable
These queries return the percentage of total harmonic distortion and noise in the output voltage.
54
Programming Manual CS Series AC Current Source
MEASure:THDistortion:MODE
This command sets the calculation method for THD measurements. The distortion calculation is
based on the H2 through H50 with the RMS voltage or current in the denominator. Note that some
definitions of THD use the fundamental component (H1) of the voltage or as the denominator.
CS units can be programmed to use the fundamental component as the denominator instead of
the RMS value. This mode can only be programmed over the bus by sending the
“MEAS:THD:MODE FUND” command. At power up or after a reset command, the mode will
revert back to the RMS mode. This mode setting is not saved in any of the set up registers.
Syntax MEASure:THDistortion:MODE
Parameters RMSQuare | FUNDamental
Examples MEAS:THD:MODE FUND
Query Syntax MEAS:THD:MODE?
Returned Parameters <CRD>
Related Commands MEAS:VOLT:HARM:THD? MEAS:CURR:HARM:THD?
55
Programming Manual CS Series AC Current Source
OUTPut:DFI
This command enables or disables the discrete fault indicator (DFI) signal to the CS Series AC
Current source.
Command Syntax OUTPut:DFI[:STATe]<bool>
Parameters 0|1|OFF|ON
*RST Value OFF
Examples OUTP:DFI 1 OUTP:DFI OFF
Query Syntax OUTPut:DFI[:STATe]?
Returned Parameters 0|1
Related Commands OUTP:DFI:SOUR
56
Programming Manual CS Series AC Current Source
OUTPut:DFI:SOURce
This command selects the source for DFI events. The choices are:
QUEStionable Questionable summary bit
OPERation Operation summary bit
ESB Standard Event summary bit
RQS Request Service summary bit
OFF Never true
Command Syntax OUTP:DFI:SOUR<source>
Parameters QUES | OPER | ESP | RQS | OFF
*RST Value OFF
Examples OUTP:DFI:SOUR OPER
Query Syntax OUTPut:DFI:SOUR?
Returned Parameters <CRD>
Related Commands OUTP:DFI
OUTPut:PON:STATe
This command selects the power-on state of the AC source. The following states can be selected:
RST Sets the power-on state to *RST. Refer to the *RST command as
described later in this chapter for more information.
RCL0 Sets the power-on state to *RCL 0. Refer to the *RCL command as
described later in this chapter for more information.
Command Syntax OUTPut:PON:STATE <state>
Parameters RST | RCL0
Examples OUTP:PON:STAT RST
Query Syntax OUTPut:PON:STATe?
Returned Parameters <CRD>
Related Commands *RST *RCL
OUTPut:PROTection:CLEar
This command clears the latch that disables the output when an overvoltage (OV), overcurrent
(OC), overtemperature (OT), or remote inhibit (RI) fault condition is detected. All conditions that
generated the fault must be removed before the latch can be cleared. The output is then restored
to the state it was in before the fault condition occurred.
Command Syntax OUTPut:PROTection:CLEar
Parameters None
Examples OUTP:PROT:CLE
Related Commands OUTP:PROT:DEL *RCL *SAV
57
Programming Manual CS Series AC Current Source
OUTPut:PROTection:DELay
This command sets the delay time between the programming of an output change that produces
a CL or UNREG status condition and the recording of that condition by the Status Operation
Condition register. The delay prevents momentary changes in status that can occur during
programming from being registered as events by the status subsystem. In most cases these
temporary conditions are not considered an event, and to record them as such would be a
nuisance.
Command Syntax OUTPut:PROTection:DELay<NRf>
Parameters 0 to 32 | MINimum | MAXimum
Unit S (seconds)
*RST Value 100 milliseconds
Examples OUTP:PROT:DEL 75E-1
Query Syntax OUTPut:PROTection:DELay?
Returned Parameters <NR3>
Related Commands OUTP:PROT:CLE *RCL *SAV
OUTPut:RI:MODE
This command selects the mode of operation of the Remote Inhibit protection. The following
modes can be selected:
LATChing A TTL low at the RI input latches the output in the protection shutdown
state, which can only be cleared by OUTPut:PROTection:CLEar.
LIVE The output state follows the state of the RI input. A TTL low at the RI
input turns the output off; a TTL high turns the output on.
OFF The instrument ignores the RI input.
The RI output state is saved as part of an instrument setup using the *SAV command. It can be
made part of the power on setting if needed. The default state is LIVE.
Command Syntax OUTPut:RI:MODE <mode>
Parameters LATChing | LIVE | OFF
*RST Value OFF
Examples OUTP:RI:MODE LIVE
Query Syntax OUTPut:RI:MODE?
Returned Parameters <CRD>
Related Commands OUTP:PROT:CLE
OUTPut:TTLTrg:MODE
This command sets the operation of the Trigger Out signal to either Function Strobe or Trigger
mode. Factory default is Trigger state which means the OUTP:TTLT:STAT command is required
to generate outputs. In Function Strobe mode, an output pulse is generated automatically any
time an output parameter such as current, frequency or phase is programmed. The AC source
Trigger Out signal is available at a SMA connector on the rear of the CS Series AC Current
source units.
Command Syntax OUTPut:TTLTrg:MODE TRIG | FSTR
Parameters TRIG | FSTR
*RST Value TRIG
Examples OUTP:TTLT:MODE FSTR
Query Syntax OUTPut:TTLTrg:MODE?
Returned Parameters <CRD>
Related Commands OUTP:TTLT:STAT
58
Programming Manual CS Series AC Current Source
OUTPut:TTLTrg[:STATe]
This command enables or disables the AC source Trigger Out1 signal, which is available at a
SMA connector on the rear of the CS Series AC Current source units.
Command Syntax OUTPut:TTLTrg[:STATe]<bool>
Parameters 0|1|OFF|ON
*RST Value OFF
Examples OUTP:TTLT 1 OUTP:TTLT OFF
Query Syntax OUTPut:TTLTrg[:STATe]?
Returned Parameters 0|1
Related Commands OUTP:TTLT:SOUR
OUTPut:TTLTrg:SOURce
This command selects the signal source for the Trig Out signal as follows:
BOT Beginning of transient output
EOT End of transient output
LIST Specified by the TTLTrg list
When an event becomes true at the selected TTLTrg source, a pulse is sent to the SMA
connector on the rear of the AC source.
Command Syntax OUTPut:TTLTrg:SOURce<source>
Parameters BOT | EOT | LIST
*RST Value BOT
Examples OUTP:TTLT:SOUR LIST
Query Syntax OUTPut:TTLTrg:SOURce?
Returned Parameters <CRD>
Related Commands OUTP:TTLT
59
Programming Manual CS Series AC Current Source
PONSetup:PEAK:CURRent[:PROTection]
This command can be used to disable the peak current shutdown mode. It is factory disabled and
should be left disabled for most situations.
Command Syntax PONSetup:PEAK:CURRent[:PROTection]
Parameters 0 | 1 | OFF | ON
Examples PONS:PEAK:CURR 1
Query Syntax PONS:PEAK:CURR?
Returned Parameters 0|1
Related Commands OUTP:PROT:DEL
60
Programming Manual CS Series AC Current Source
PONSetup:RELay[:HOLD]
This command is used to set a delay time between programming down the output current to 0
amps and opening the output relay. This provides some time for any inductive loads connected at
the output of the power source to discharge into the amplifiers before opening the output relays
(OUTP 0 command or front panel On/Off).. Without this delay, inductive EUT’s may kick up a high
flyback voltage. The same delay time is also used to program down and hold the current at zero
before switching the voltage range relays when performing a voltage range change. (VOLT:RANG
command or front panel RANGE change).
The default delay is set to 0.1 or 100 msec. This delay can be set to a value from 0.000 to 1.000
seconds. Once set, it is recalled at power up. Note that this delay affects the time it takes to
execute the OUTP 0 and the VOLT:RANG commands. If a delay is set, the bus will be held by
this amount of time while the power source executes either of these commands.
Note that this delay time is approximate only and may vary somewhat from unit to unit.
Command Syntax PONSetup:RELay[:HOLD]
Parameters 0.000 through 1.000
Examples PONS:REL 0.2
Query Syntax PONS:REL?
Returned Parameters <NR3>
Related Commands OUTP 1 VOLT:RANG
61
Programming Manual CS Series AC Current Source
SENSe:SWEep:OFFSet
This command defines the trigger point expressed in seconds relative to the start of the returned
data record when an acquire trigger is used. The values can range from MIN to MAX depending
on the phase mode and the selected sample interval. When the values are negative, the values in
the beginning of the data record represent samples taken prior to the trigger.
Command Syntax SENSe:SWEep:OFFSet <NRf+>
Parameters <NRf> | MINimum | MAXimum
*RST Value 0
Examples SENS:SWE:OFFS -12E-3
Query Syntax SENSe:SWEep:OFFSet?
Returned Parameters <NR3>
Related Commands SENS:SWE:TINT MEAS:ARR
SENSe:SWEep:OFFSet:POINts
This command defines the trigger point expressed in sample points relative to the start of the
returned data record when an acquire trigger is used. The values can range from -4095 to 2E9.
When the values are negative, the values in the beginning of the data record represent samples
taken prior to the trigger.
62
Programming Manual CS Series AC Current Source
SENSe:SWEep:TINTerval
This command defines the time period between samples. The sample period can be programmed
from 10.42 to 104.2 microseconds in 10 microsecond increments in single-phase mode and from
31.25 to 312.5 microseconds in three-phase mode.
All the MEASure commands use the ACQuire trigger sequence implicitly. These commands
always set the sample period to 21 microseconds.
Command Syntax SENSe:SWEep:TINTerval<NRf+>
Parameters 10.42 through 104.2 (microseconds)
*RST Value 10.42 us
Examples SENS:SWE:TINT 100
Query Syntax SENSe:SWEep:TINTerval?
Returned Parameters <NR3>
Related Commands SENS:SWE:OFFS:POIN MEAS:ARR
63
Programming Manual CS Series AC Current Source
VOLTage:PROTection:DELay
This command holds off the over voltage trip of the output current for the time specificied. Default
value at *RST is 0.1 sec. The range is from 0.1 to 5.000 secs and can be queries with the
VOLT:PROT:DEL? MIN and VOLT:PROT:DEL? MAX commands.
Command Syntax [SOURce:]VOLTage:PROTection:DELay <NRf+>
Parameters 0.100 to 5.000 | MINimum | MAXimum
Unit: S (seconds)
*RST Value 0.100
Examples VOLT:PROT:DEL 1.5
Query Syntax [SOURce:]VOLTage:PROTection:DELay?
VOLTage:PROTection:DELay? Min
VOLTage:PROTection:DELay? Max
Returned Parameters <NR3>
Related Commands VOLT:PROT:STAT
64
Programming Manual CS Series AC Current Source
VOLTage:PROTection:STATe
This command enables or disables the AC source over voltage(OV) protection function. If the over
voltage protection function is enabled and the AC source exceeds the programmed level, then the
output is disabled and the Questionable Condition status register OV bit is set (see Chapter 7).
An over voltage condition can be cleared with OUTPut:PROTection:CLEar after the cause of the
condition is removed.
Use OUTP:PROT:DEL to prevent momentary votlage limit conditions caused by programmed
output changes from tripping the over votlage protection. Use VOLT:PROT:DEL to hold off
tripping the output due to temporary overload conditions.
Command Syntax [SOURce:]VOLTage:PROTection:STATe<bool>
Parameters 0 | 1 | OFF | ON
*RST Value OFF
Examples VOLT:PROT:STAT 0 VOLT:PROT:STAT OFF
Query Syntax [SOURce:]VOLTage:PROTection:STATe?
Returned Parameters 0|1
Related Commands OUTP:PROT:CLE VOLT:PROT:DEL
VOLTage:RANGe
Phase Selectable
This command sets the compliance voltage range of the AC source. Two compliance ranges are
available: a 135 volt range and a 270 volt range. Sending a parameter greater than 135 selects
the 270 volt range, otherwise the 135 volt range is selected. Alternative range models may be
available in which case the compliance voltage range values may be different. In that case, check
the LIMIT subsystem to query the available range values. On older model CS units, only a single
range may be available in which case this command is not supported.
The VOLTage:RANGe command is coupled with the CURRent command. This means that the
maximum current that can be programmed at a given time depends on the compliance voltage
range setting in which the unit is presently operating. Refer to chapter 4 under "Coupled
Commands" for more information.
Command Syntax [SOURce:]VOLTage:RANGe<NRf+>
Parameters 135 | 270
*RST Value MIN
Examples VOLT:RANG 135 VOLT:RANG MIN
Query Syntax [SOURce:]VOLTage:RANGe?
Returned Parameters <NR3>
Related Commands CURR
65
Programming Manual CS Series AC Current Source
VOLTage:SENSe:SOURce
These commands select the source from which the output voltage is sensed. The following
voltage sense sources can be selected:
INTernal This senses the voltage at the output of the power amplifier on the
inboard side of the output disconnect relay.
EXTernal This senses the output voltage at the user's sense terminals, which
allows remote voltage sensing at the load.
Command Syntax [SOURce:]VOLTage:SENSe:SOURce<source>
[SOURce:]VOLTage:ALC:SOURce<source>
Parameters INTernal | EXTernal
*RST Value INTernal
Examples VOLT:SENS:SOUR INT
Query Syntax [SOURce:]VOLTage:SENSe:SOURce?
Returned Parameters <CRD>
Related Commands VOLT:ALC:SOUR EXT
Note: The VOLT:ALC:SOUR command is an alias for the VOLT:SENS:SOUR command. Both
perform the same function.
66
Programming Manual CS Series AC Current Source
FREQuency:MODE
This command determines how the output frequency is controlled. Available modes are:
FIXed The output frequency is unaffected by a triggered output transient. The
clock source is the internal controller timebase.
STEP The output frequency is programmed to the value set by
FREQuency:TRIGgered when a triggered transient occurs.
PULSe The output frequency is changed to the value set by
FREQuency:TRIGgered for a duration determined by the pulse
commands.
LIST The output frequency is controlled by the frequency list when a triggered
transient occurs.
SENSe External sync or line sync clock mode. The frequency is synchronized to
the external sync or line sync frequency.
EXTernal External clock mode. This mode is used on a CS unit with the –LKS
option to sync to a master CS unit.
Command Syntax [SOURce:]FREQuency:MODE<mode>
Parameters FIXed | STEP | PULSe | LIST | SENSe | EXTernal
*RST Value FIXed
Examples FREQ:MODE FIX
Query Syntax [SOURce:]FREQuency:MODE?
Returned Parameters <CRD>
Related Commands FREQ FREQ:TRIG
67
Programming Manual CS Series AC Current Source
FREQuency:SLEW
This command sets the rate at which frequency changes for all programmed changes in output
frequency. Instantaneous frequency changes can be obtained by sending MAXimum or INFinity.
The SCPI keyword INFinity is represented by the number 9.9E37.
Command Syntax [SOURce:]FREQuency:SLEW[:IMMediate]<NRf+>
|INFinity
Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum
Unit HZ (Hertz per second)
*RST Value MAXimum
Examples FREQ:SLEW:IMM 75 FREQ:SLEW MAX
Query Syntax [SOURce:]FREQuency:SLEW?
Returned Parameters <NR3>
Related Commands FREQ:SLEW:MODE FREQ
FREQuency:SLEW:MODE
This command determines how the frequency slew rate is controlled during a triggered output
transient. The choices are:
FIXed The frequency slew rate is unaffected by a triggered output transient.
STEP The frequency slew rate is programmed to the value set by
FREQuency:TRIGgered when a triggered transient occurs.
PULSe The frequency slew rate is changed to the value set by
FREQuency:TRIGgered for a duration determined by the pulse
commands.
LIST The frequency slew rate is controlled by the frequency list when a
triggered transient occurs.
Command Syntax [SOURce:]FREQuency:SLEW:MODE<mode>
Parameters FIXed | STEP | PULSe | LIST
*RST Value FIXed
Examples FREQ:SLEW:MODE FIX
Query Syntax [SOURce:]FREQuency:SLEW:MODE?
Returned Parameters <CRD>
Related Commands FREQ FREQ:SLEW:TRIG
FREQency:SLEW:TRIGgered
This command sets the rate at which frequency changes during a triggered output transient.
Instantaneous frequency changes can be obtained by sending MAXimum or INFinity. The SCPI
keyword INFinity is represented by the number 9.9E37.
Command Syntax [SOURce:]FREQuency:SLEW:TRIGgered<NRf+>
|INFinity
Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum
Unit HZ (Hertz per second)
*RST Value MAXimum
Examples FREQ:SLEW:TRIG 75 FREQ:SLEW:TRIG MAX
Query Syntax [SOURce:]FREQuency:SLEW:TRIG?
Returned Parameters <NR3>
Related Commands FREQ:SLEW:MODE FREQ
68
Programming Manual CS Series AC Current Source
FREQuency:TRIGgered
This command programs the frequency that the output will be set to during a triggered step or
pulse transient.
Command Syntax [SOURce:]FREQuency:TRIGgered<NRf+>
Parameters Refer to specifications table in User Manual
Unit HZ (Hertz)
*RST Value 60 Hz
Example FREQ:TRIG 50
Query Syntax [SOURce:]FREQuency:TRIGgered?
Returned Parameters <NR3>
Related Commands FREQ FREQ:MODE
69
Programming Manual CS Series AC Current Source
FUNCtion:MODE
This command determines how the waveform shape is controlled during a triggered output
transient. The choices are:
FIXed The waveform shape is unaffected by a triggered output transient.
STEP The waveform shape is programmed to the value set by
FUNCtion:TRIGgered when a triggered transient occurs.
PULSe The waveform shape is changed to the value set by
FUNCtion:TRIGgered for a duration determined by the pulse commands.
LIST The waveform shape is controlled by the waveform shape list when a
triggered transient occurs.
70
Programming Manual CS Series AC Current Source
FUNCtion:TRIGgered
This command selects the shape of the output current waveform when a triggered step or pulse
transient occurs. The parameters are:
SINusoid A sinewave is output
SQUare A squarewave is output
CSINusoid The output is a clipped sine waveform. Both positive and negative peak
amplitudes are clipped at a value determined by
SOURce:FUNCtion:SHAPe:CSINusoid.
<waveform_name> The output shape is described by one of the user-defined waveform
tables.
The maximum peak current that the AC source can output in 3 phase mode is 20.95 A peak. This
includes any combination of voltage and function shape values. Therefore, the maximum value
that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a
sinewave, the maximum current that can be programmed is 14.81 A rms.
Command Syntax [SOURce:]FUNCtion[:SHAPe]:TRIGgered<shape>
Parameters SINusoid|SQUare|CSINusoid|<waveform_name>
*RST Value SINusoid
Examples FUNC:TRIG SIN FUNC:TRIG TABLE1
Query Syntax [SOURce:]FUNCtion[:SHAPe]:TRIGgered?
Returned Parameters <CRD>
Related Commands FUNC FUNC:MODEVOLT
FUNCtion:CSINusoid
This command sets the clipping level when a clipped sine output waveform is selected. The
clipping characteristics can be specified in two ways:
The clipping level is expressed as a percentage of the peak amplitude at which clipping
occurs. The range is 0 to 100 percent. These are the default units when the optional THD
suffix is not sent.
The clipping level is expressed at the percentage of total harmonic distortion in the output
voltage. The range is 0 to 43 percent. The optional THD suffix is sent to program in these
units.
Command Syntax [SOURce:]FUNCtion[:SHAPe]:CSINusoid<NRf>[THD]
Parameters 0 to 100% | 0 to 43% THD
*RST Value 100% | 0% THD (no clipping)
Examples FUNC:CSIN 80 FUNC:CSIN 10 THD
Query Syntax [SOURce:]FUNCtion[:SHAPe]:CSINusoid?
Returned Parameters <NR3>
Related Commands FUNC:MODE
71
Programming Manual CS Series AC Current Source
72
Programming Manual CS Series AC Current Source
LIST:COUNt
This command sets the number of times that the list is executed before it is completed. The
command accepts parameters in the range 1 through 2E8. Use MAX to set the list to maximum.
Command Syntax [SOURce:]LIST:COUNt<NRf+> | MAX
Parameters 1 to 2E8 | MINimum | MAXimum
*RST Value 1
Examples LIST:COUN 3 LIST:COUN INF
Query Syntax [SOURce:]LIST:COUNt?
Returned Parameters <NR3>
Related Commands LIST:CURRLIST:FREQ
LIST:TTLTLIST:VOLT
LIST:CURRent
This command specifies the output current points in a list. The current points are given in the
command parameters, which are separated by commas. The order in which the points are
entered determines the sequence in which the list will be output when a list transient is triggered.
Changing list data while a subsystem is in list mode generates an implied ABORt.
Command Syntax [SOURce:]LIST:CURRent[:LEVel] <NRf+>{,<NRf+>}
Parameters 0.000 to 14.8
Unit A (rms current)
Examples LIST:CURR 0.1,0.5,0.3
LIST:CURR MAX,0.5,MIN
Query Syntax [SOURce:]LIST:CURRent[:LEVel]?
Returned Parameters <NR3>
Related Commands LIST:CURR:POIN? LIST:COUN LIST:DWEL LIST:STEP
LIST:CURRent:POINts?
This query returns the number of points specified in LIST:CURR. Note that it returns only the total
number of points, not the point values.
Query Syntax [SOURce:]LIST:CURRent:POINts?
Returned Parameters <NR1>
Example LIST:CURR:POIN?
Related Commands LIST:CURR
LIST: CURRent:SLEW
This command specifies the output offset slew points in a list. The slew points are given in the
command parameters, which are separated by commas. The order in which the points are
entered determines the sequence in which the list will be output when a list transient is triggered.
Changing list data while a subsystem is in list mode generates an implied ABORt.
Command Syntax [SOURce:]LIST:CURRent:SLEW <NRf+>{,<NRf+>}
Parameters 1E-4 to 9.9E37 | INFinity | MINimum | MAXimum
Unit A/S (volts per second)
Example LIST:CURR:SLEW 10, 1E2, INF
Query Syntax [SOURce:]LIST:CURRent:SLEW?
Returned Parameters <NR3>
Related Commands LIST:CURR:SLEW:POIN? LIST:COUN LIST:DWEL
LIST:STEP
LIST: CURRent:SLEW:POINts?
This query returns the number of points specified in LIST:CURRent:SLEW. Note that it returns
only the total number of points, not the point values.
73
Programming Manual CS Series AC Current Source
LIST:DWELl
This command sets the sequence of list dwell times. Each value represents the time in seconds
that the output will remain at the particular list step point before completing the step. At the end of
the dwell time, the output of the AC source depends upon the following conditions:
If LIST:STEP AUTO has been programmed, the output automatically changes to the next
point in the list.
If LIST:STEP ONCE has been programmed, the output remains at the present level until a
trigger sequences the next point in the list.
The order in which the points are entered determines the sequence in which they are output when
a list is triggered. Changing list data while a subsystem is in list mode generates an implied
ABORt.
Command Syntax [SOURce:]LIST:DWELl<NRf+>{,<NRf+>}
Parameters 3-phase mode: 0 to 1.07533E6|MINimum|MAXimum
1-phase mode: 0 to 4.30133E5|MINimum|MAXimum
Unit S (seconds)
Examples LIST:DWEL .5,.5,1.5
Query Syntax [SOURce:]LIST:DWEL?
Returned Parameters <NR3>
Related Commands LIST:FREQ LIST:TTLT LIST:VOLT
LIST:DWELl:POINts?
This query returns the number of points specified in LIST:DWELl. Note that it returns only the total
number of points, not the point values.
Query Syntax [SOURce:]LIST:DWELl:POINts?
Returned Parameters <NR1>
Example LIST:DWEL:POIN?
Related Commands LIST:DWEL
LIST:FREQuency
This command sets the sequence of frequency list points. The frequency points are given in the
command parameters, which are separated by commas.
The order in which the points are entered determines the sequence in which they are output when
a list is triggered. Changing list data while a subsystem is in list mode generates an implied
ABORt.
Command Syntax [SOURce:]LIST:FREQuency[:LEVel]<NRf+>{,<NRf+>}
Parameters 45 to 5000
Unit HZ (Hertz)
Examples LIST:FREQ 60,65,70
Query Syntax [SOURce:]LIST:FREQ?
Returned Parameters <NR3>
Related Commands LIST:FREQ:POIN? LIST:COUN LIST:DWEL LIST:STEP
LIST:FREQ:SLEW
LIST:FREQuency:POINts?
74
Programming Manual CS Series AC Current Source
This query returns the number of points specified in LIST:FREQuency. Note that it returns only the
total number of points, not the point values.
Query Syntax [SOURce:]LIST:FREQ[:LEVel]:POINts?
Returned Parameters <NR1>
Example LIST:FREQ:POIN?
Related Commands LIST:FREQ
LIST:FREQuency:SLEW
This command sets the sequence of frequency slew list points. The frequency points are given in
the command parameters, which are separated by commas. The order in which the points are
entered determines the sequence in which they are output when a list is triggered. Changing list
data while a subsystem is in list mode generates an implied ABORt.
Command Syntax [SOURce:]LIST:FREQuency:SLEW<NRf+>{,<NRf+>}
Parameters 0 to 9.9E31 | INFinity
Unit HZ (Hertz) per second
Examples LIST:FREQ:SLEW 10, 1E2, INF
Query Syntax [SOURce:]LIST:FREQ:SLEW?
Returned Parameters <NR3>
Related Commands LIST:FREQ:SLEW:POIN? LIST:COUN LIST:DWEL LIST:STEP
LIST:FREQ
LIST:FREQuency:SLEW:POINts?
This query returns the number of points specified in LIST:FREQuency:SLEW. Note that it returns
only the total number of points, not the point values.
Query Syntax [SOURce:]LIST:FREQ:SLEW:POINts?
Returned Parameters <NR1>
Example LIST:FREQ:SLEW:POIN?
Related Commands LIST:FREQ:SLEW
LIST:MODE
This command sets the mode of operation for the transient list system. The default mode after
*RST is always BOT. In BOT mode, the output of the power source will return to the steady state
program values when the transient list execution completes. In EOT mode, the output of the
power source will remain at the final value reached at the end of the transient list execution. This
mode is compatible with other CI power source models.
This mode is not stored in any setup register so the unit will always revert to BOT mode at power
up or after a *RST command.
Note that sending the ABORT command will always cause the output to revert to the last steady
state program values.
Command Syntax [SOURce:]LIST:MODE
Parameters BOT | EOT
Examples LIST:MODE EOT
Query Syntax [SOURce:]LIST:MODE?
Returned Parameters <CRD>
Related Commands LIST:COUN LIST:DWEL LIST:STEP
LIST:PHASe
Phase Selectable
This phase selectable command sets the sequence of phase list points. The phase points are
given in the command parameters, which are separated by commas. The order in which the
75
Programming Manual CS Series AC Current Source
points are entered determines the sequence in which they are output when a list is triggered.
Changing list data while a subsystem is in list mode generates an implied ABORt.
Command Syntax [SOURce:]LIST:PHASe<NRf+>{,<NRf+>}
Parameters 360 through +360
Examples LIST:PHAS 90,120,135
Query Syntax [SOURce:]LIST:PHAS?
Returned Parameters <NR3>
Related Commands LIST:PHAS:POIN? LIST:COUN LIST:DWEL LIST:STEP
LIST:PHASe:POINts?
This query returns the number of points specified in LIST:PHASe. Note that it returns only the total
number of points, not the point values.
Query Syntax SOURce:]LIST:PHASe:POINts?
Returned Parameters NR3>
Example IST:PHAS:POIN?
Related Commands IST:FREQ LIST:DWEL
LIST:SHAPe
This command sets the sequence of the waveform shape entries. The order in which the shapes
are given determines the sequence in which the list of shape will be output when a list transient is
triggered. Changing list data while a subsystem is in list mode generates an implied ABORt. The
following shapes may be specified:
SINusoid A sinewave is output
SQUare A squarewave is output
CSINusoid The output is a clipped sine waveform. Both positive and negative peak
amplitudes are clipped at a value determined by the
SOURce:FUNCtion:SHAPe:CSINusoid setting.
<waveform_name> The output shape is described by one of the user-defined waveform
tables.
The maximum peak current that the AC source can output is specified in the user manual. This
includes any combination of current and function shape values. Therefore, the maximum value
that can be programmed depends on the peak-to-rms ratio of the selected waveform.
Command Syntax [SOURce:]LIST:SHAPe<shape>{,<shape>}
Parameters SINusoid|SQUare|CSINusoid|<waveform_name>
Examples LIST:SHAP
Query Syntax [SOURce:]LIST:SHAP?
Returned Parameters <CRD>
Related Commands LIST:SHAP:POIN? LIST:COUN LIST:DWEL LIST:STEP LIST:VOLT
LIST:SHAPe:POINts?
This query returns the number of points specified in LIST:SHAP. Note that it returns only the total
number of points, not the point values.
Query Syntax [SOURce:]LIST:SHAPe:POINts?
Returned Parameters <NR1>
Example LIST:SHAP:POIN?
Related Commands LIST:SHAP
LIST:STEP
This command specifies how the list sequencing responds to triggers.
76
Programming Manual CS Series AC Current Source
ONCE causes the list to advance only one point after each trigger. Triggers that arrive during a
dwell delay are ignored.
AUTO causes the entire list to be output sequentially after the starting trigger, paced by its dwell
delays. As each dwell delay elapses, the next point is immediately output.
Command Syntax [SOURce:]LIST:STEP<step>
Parameters ONCE | AUTO
*RST Value AUTO
Examples LIST:STEP ONCE
Query Syntax [SOURce:]LIST:STEP?
Returned Parameters <CRD>
Related Commands LIST:COUN LIST:DWEL
LIST:TTLTrg
This command sets the sequence of Trigger Out list points. Each point which is set ON will cause
a pulse to be output at Trigger Out when that list step is reached. Those entries which are set
OFF will not generate Trigger Out pulses. The order in which the list points are given determines
the sequence in which Trigger Out pulses will be output when a list transient is triggered.
Changing list data while a subsystem is in list mode generates an implied ABORt.
Command Syntax [SOURce:]LIST:TTLTrg<bool>{,<bool>}
Parameters 0 | 1 | OFF | ON
Examples LIST:TTLT 1,0,1 LIST:TTLT ON,OFF,ON
Query Syntax LIST:TTLT?
Returned Parameters 0|1
Related Commands LIST:TTLT:POIN? LIST:COUN LIST:DWEL LIST:STEP
OUTP:TTLT:STAT OUTP:TTLT:SOUR
LIST:TTLTrg:POINts?
This query returns the number of points specified in LIST:TTLT. Note that it returns only the total
number of points, not the point values.
Query Syntax [SOURce:]LIST:TTLTrg:POINts?
Returned Parameters <NR1>
Example LIST:TTLT:POIN?
Related Commands LIST:TTLT
77
Programming Manual CS Series AC Current Source
PHASe:MODE
Phase Selectable
This command determines how the output phase is controlled during a triggered output transient.
The choices are:
FIXed The output phase is unaffected by a triggered output transient.
STEP The output phase is programmed to the value set by PHASe:TRIGgered
when a triggered transient occurs.
PULSe The output phase is changed to the value set by PHASe:TRIGgered for a
duration determined by the pulse commands.
LIST The waveform shape is controlled by the phase list when a triggered
transient occurs.
Command Syntax [SOURce:]PHASe:MODE<mode>
Parameters FIXed | STEP | PULSe | LIST
*RST Value FIX
Examples PHAS:MODE LIST PHAS:MODE FIX
Query Syntax [SOURce:]PHASe:MODE?
Returned Parameters <CRD>
Related Commands PHAS:TRIG PHAS
PHASe:TRIGgered
78
Programming Manual CS Series AC Current Source
Phase Selectable
This command sets the output phase when a triggered step or pulse transient occurs. The phase
of the output current waveform is expressed relative to an internal reference. The phase angle is
programmed in degrees. Positive phase angles are used to program the leading phase, and
negative phase angles are used to program the lagging phase.
The PHASe command is not influenced by INSTrument:COUPle ALL. It applies only to the current
output phase selected by INSTrument:NSELect.
Command Syntax [SOURce:]PHASe:TRIGgered<NRf+>
Parameters -360° through +360°
*RST Value triggered phase ø1 = 0°, triggered
phase ø2 = 120°, triggered phase ø3 = 240°
Examples PHAS:TRIG 120 PHASE MAX
Query Syntax [SOURce:]PHASe:TRIGgered?
Returned Parameters <NR3>
Related Commands PHAS:MODE PHAS
79
Programming Manual CS Series AC Current Source
PULSe:DCYCle
This command sets the duty cycle of the triggered output pulse. The duty cycle units are specified
in percent.
Command Syntax [SOURce:]PULSe:DCYCle<NRf+>
Parameters 0 to 100%|MINimum|MAXimum
*RST Value 50%
Examples PULS:DCYC 75 PULS:DCYC MAX
Query Syntax [SOURce:]PULSe:DCYCle?
Returned Parameters <NR3>
Related Commands PULS:COUN PULS:HOLD PULS:PER PULS:WIDT
PULSe:HOLD
This command specifies whether the pulse width or the duty cycle is to be held constant when the
pulse period changes. The following tables describe how the duty cycle, period, and width are
affected when one, two, or all three parameters are set in a single program message.
Command Syntax [SOURce:]PULSe:HOLD<parameter>
Parameters WIDTh|DCYCle
*RST Value WIDTh
Examples PULS:HOLD DCYC
Query Syntax [SOURce:]PULSe:HOLD?
Returned Parameters <CRD>
Related Commands PULS:COUN PULS:DCYC PULS:PER PULS:WIDT
80
Programming Manual CS Series AC Current Source
PULSe:PERiod
This command sets the period of a triggered output transient. The command parameters are
mode-dependent.
Command Syntax [SOURce:]PULSe:PERiod<NRf+>
Parameters 3-phase mode: 0 to 1.07533E6 | MINimum | MAXimum
1-phase mode: 0 to 4.30133E5 | MINimum | MAXimum
Unit s (seconds)
*RST Value 0.03333
Examples PER 0.001 PER MIN
Query Syntax [SOURce:]PERiod?
Returned Parameters <NR3>
Related Commands PULS:COUN PULS:DCYC PULS:HOLD PULS:WIDT
PULSe:WIDTh
81
Programming Manual CS Series AC Current Source
This command sets the width of a transient output pulse. The command parameters are mode-
dependent.
Command Syntax [SOURce:]PULSe:WIDTh<NRf+>
Parameters 3-phase mode: 0 to 1.07533E6 | MINimum | MAXimum
1-phase mode: 0 to 4.30133E5 | MINimum | MAXimum
Unit s (seconds)
*RST Value 0.01667 (equals the period of a single 60 Hz cycle)
Examples PULS:WIDT 0.001 PULS:WIDT MIN
Query Syntax [SOURce:]PULSe:WIDTh?
Returned Parameters <NR3>
Related Commands PULS:COUN PULS:DCYC PULS:HOLD PULS:PER
82
Programming Manual CS Series AC Current Source
83
Programming Manual CS Series AC Current Source
CURRent
Phase Selectable
This command programs the AC rms output current level of the AC source.
Command Syntax [SOURce:]CURRent[:LEVel][:IMMediate][:AMPLitude]<NRf+>
Parameters 0.00 to 14.80
Unit A (rms voltage)
*RST Value 0.00 A
Examples CURR 0.1 CURR:LEV 0.1
Query Syntax [SOURce:]CURRent[:LEVel]
[:IMMediate][:AMPLitude]?
Returned Parameters <NR3>
Related Commands CURR:MODE CURR:TRIG
CURRent:TRIGgered
Phase Selectable
This command selects the AC rms current amplitude that the output waveform will be set to
during a triggered step or pulse transient.
Command Syntax [SOURce:]CURRent[:LEVel]:TRIGgered :AMPLitude]<NRf+>
Parameters 0.00 to 14.80
Unit A (rms voltage)
*RST Value 0.00 A
Examples CURR:TRIG 0.1 CURR:LEV:TRIG 0.1
Query Syntax SOURce:]CURRent[:LEVel]:TRIGgered:AMPLitude]?
Returned Parameters <NR3> If the TRIG level is not programmed, the IMM level is
returned.
Related Commands CURR CURR:MODE
CURRent:MODE
Phase Selectable
This command determines how the AC rms output current is controlled during a triggered output
transient. The choices are:
FIXed The current is unaffected by a triggered output transient.
STEP The current is programmed to the value set by CURRent:TRIGgered
when a triggered transient occurs.
PULSe The current is changed to the value set by CURRent:TRIGgered for a
duration determined by the pulse commands.
LIST The current is controlled by the current list when a triggered transient
occurs.
Command Syntax [SOURce:]CURRent:MODE<mode>
Parameters FIXed | STEP | PULSe | LIST
*RST Value FIX
Examples CURR:MODE LIST CURR:MODE FIX
Query Syntax [SOURce:]CURRent:MODE?
Returned Parameters <CRD>
Related Commands CURR:TRG CURR
84
Programming Manual CS Series AC Current Source
CURRent:REFerance
This command select the referance Voltage. The following voltage refernace can be selected:
INTernal This is the internal voltage referance for programmable voltage
EXTernal This is the external DC voltage referance input to program the output
current. 0 to +10 voltage represents 0 to full scale output current. This is
the RPV option.
Command Syntax [SOURce:]CURRent:Refernace <source>
Parameters INTernal | EXTernal
*RST Value INTernal
Examples CURR:REF EXT
Query Syntax [SOURce:]CURRent:REFerance?
Returned Parameters <CRD>
Related Commands CURR:ALC:SOUR OFF
Note: The VOLT:ALC:SOUR command must be set to off prior to selection of the referance to
external.
85
Programming Manual CS Series AC Current Source
CURRent:SLEW
This command sets the slew rate for all programmed changes in the AC rms output current level
of the AC source. A parameter of MAXimum or INFinity will set the slew to its maximum possible
rate. The SCPI representation for INFinity is 9.9E37.
Command Syntax [SOURce:]CURRent:SLEW[:IMMediate]<NRf+>|INFinity
Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum
Unit A/S (amps per second)
*RST Value INFinity
Examples CURR:SLEW 1 CURR:SLEW MAX CURR:SLEW INF
Query Syntax [SOURce:]CURRent:SLEW[:IMMediate]?
Returned Parameters <NR3>
Related Commands CURR:SLEW:MODE CURR:SLEW:TRIG
CURRent:SLEW:MODE
Phase Selectable
This command determines how the output current slew rate is controlled during a triggered output
transient. The choices are:
FIXed The slew rate is unaffected by a triggered output transient.
STEP The slew rate is programmed to the value set by
VOLTage:SLEW:TRIGgered when a triggered transient occurs.
PULSe The slew rate is changed to the value set by CURRent:SLEW:TRIGgered
for a duration determined by the pulse commands.
LIST The slew rate is controlled by the current slew list when a triggered
transient occurs.
Command Syntax [SOURce:]CURRent:SLEW:MODE<mode>
Parameters FIXed | STEP | PULSe | LIST
*RST Value FIX
Examples CURR:SLEW:MODE LIST CURR:SLEW:MODE FIX
Query Syntax [SOURce:]CURRent:SLEW:MODE?
Returned Parameters <CRD>
Related Commands CURR:SLEW:TRG CURR:SLEW
CURRent:SLEW:TRIGgered
Phase Selectable
This command selects the slew rate that will be set during a triggered step or pulse transient. A
parameter of MAXimum or INFinity will set the slew to its maximum possible rate. The SCPI
representation for infinity is 9.9E37.
Command Syntax [SOURce:]CURRent:SLEW:TRIGgered<NRf+>|INFinity
Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum
Unit A/S (amps per second)
*RST Value INFinity
Examples CURR:SLEW:TRIG 1 CURR:SLEW:TRIG MAX
CURR:SLEW:TRIG INF
Query Syntax [SOURce:]CURRent:SLEW:TRIGgered?
Returned Parameters <NR3>
Related Commands CURR:SLEW:MODE CURR:SLEW
86
Programming Manual CS Series AC Current Source
87
Programming Manual CS Series AC Current Source
STATus:OPERation?
This query returns the value of the Operation Event register. The Event register is a read-only
register which holds (latches) all events that are passed by the Operation NTR and/or PTR filter.
Reading the Operation Event register clears it.
Query Syntax STATus:OPERation[:EVENt]?
Parameters None
Returned Parameters <NR1>(Register Value)
Examples STAT:OPER:EVEN?
Related Commands *CLS STAT:OPER:NTR STAT:OPER:PTR
STATus:OPERation:CONDition?
This query returns the value of the Operation Condition register. This is a read-only register which
holds the real-time (unlatched) operational status of the CS Series AC Current source.
Query Syntax STATus:OPERation:CONDition?
Parameters None
Examples STAT:OPER:COND?
Returned Parameters <NR1>(Register value)
STATus:OPERation:ENABle
This command and its query set and read the value of the Operation Enable register. This register
is a mask for enabling specific bits from the Operation Event register to set the operation
summary bit (OPER) of the Status Byte register. The operation summary bit is the logical OR of all
enabled Operation Event register bits.
Command Syntax STATus:OPERation:ENABle <NRf+>
Parameters 0 to 32727
Default Value 0
Examples STAT:OPER:ENAB 32
STAT:OPER:ENAB 1
Query Syntax STATus:OPERation:ENABle?
Returned Parameters <NR1>(Register value)
Related Commands STAT:OPER:EVEN
STATus:OPERation:NTR STATus:OPERation:PTR
These commands set or read the value of the Operation NTR (Negative-Transition) and PTR
(Positive-Transition) registers. These registers serve as polarity filters between the Operation
Enable and Operation Event registers to cause the following actions:
When a bit in the Operation NTR register is set to 1, then a 1-to-0 transition of the
corresponding bit in the Operation Condition register causes that bit in the Operation Event
register to be set.
When a bit of the Operation PTR register is set to 1, then a 0-to-1 transition of the
corresponding bit in the Operation Condition register causes that bit in the Operation Event
register to be set.
88
Programming Manual CS Series AC Current Source
If the same bits in both NTR and PTR registers are set to 1, then any transition of that bit at
the Operation Condition register sets the corresponding bit in the Operation Event register.
If the same bits in both NTR and PTR registers are set to 0, then no transition of that bit at the
Operation Condition register can set the corresponding bit in the Operation Event register.
Note: Setting a bit in the PTR or NTR filter can of itself generate positive or negative events in
the corresponding Operation Event register.
Bit 15 14 13 12 11 10 9 8-5 4 3 2 1 0
Position
Bit Name not not Isum VL Rail not RI not TO UNR not OCP OV
used used rms used used use
d
Bit Weight 8192 4096 2048 512 16 8 2 1
STATus:QUEStionable?
This query returns the value of the Questionable Event register. The Event register is a read-only
register which holds (latches) all events that are passed by the Questionable NTR and/or PTR
filter. Reading the Questionable Event register clears it.
On the CS Series AC Current source, each signal that is fed into the Questionable Status
Condition register is logically-ORed from three corresponding status signals that originate from
each phase.
89
Programming Manual CS Series AC Current Source
STATus:QUEStionable:CONDition?
This query returns the value of the Questionable Condition register. That is a read-only register,
which holds the real-time (unlatched) questionable status of the AC source.
Query Syntax STATus:QUEStionable:CONDition?
Example STAT:QUES:COND?
Returned Parameters <NR1>(Register value)
STATus:QUEStionable:ENABle
This command sets or reads the value of the Questionable Enable register. This register is a
mask for enabling specific bits from the Questionable Event register to set the questionable
summary (QUES) bit of the Status Byte register. This bit (bit 3) is the logical OR of all the
Questionable Event register bits that are enabled by the Questionable Status Enable register.
Command Syntax STATus:QUEStionable:ENABle <NRf+>
Parameters 0 to 32727
Default Value 0
Examples STAT:QUES:ENAB 18
Query Syntax STATus:QUEStionable:ENABle?
Returned Parameters <NR1>(Register value)
Related Commands STAT:QUES:EVEN?
STATus:QUEStionable:NTR
STATus:QUEStionable:PTR
These commands allow the values of the Questionable NTR (Negative-Transition) and PTR
(Positive-Transition) registers to be set or read. These registers serve as polarity filters between
the Questionable Enable and Questionable Event registers to cause the following actions:
When a bit of the Questionable NTR register is set to 1, then a 1-to-0 transition of the
corresponding bit of the Questionable Condition register causes that bit in the Questionable
Event register to be set.
When a bit of the Questionable PTR register is set to 1, then a 0-to-1 transition of the
corresponding bit in the Questionable Condition register causes that bit in the Questionable
Event register to be set.
If the same bits in both NTR and PTR registers are set to 1, then any transition of that bit at
the Questionable Condition register sets the corresponding bit in the Questionable Event
register.
If the same bits in both NTR and PTR registers are set to 0, then no transition of that bit at the
Questionable Condition register can set the corresponding bit in the Questionable Event
register.
Note: Setting a bit in the PTR or NTR filter can of itself generate positive or negative events in
the corresponding Questionable Event register.
90
Programming Manual CS Series AC Current Source
Bit 15 13 12 11 10 9 8-5 4 3 2 1 0
Position
Bit Name not VL Rail not RI not TO UNR not OCP OV
used rms used used used
Bit Weight 4096 2048 512 16 8 2 1
STATus:QUEStionable:INSTrument:ISUMmary?
Phase Selectable
This command returns the value of the Questionable Event register for a specific output of a
three-phase AC source. The particular output phase must first be selected by INST:NSEL.
The Event register is a read-only register which holds (latches) all events that are passed by the
Questionable NTR and/or PTR filter. Reading the Questionable Event register clears it.
Query Syntax STATus:QUEStionable:INSTrument:ISUMmary[:EVENt]?
Parameters None
Returned Parameters <NR1> (Register Value)
Examples STAT:QUES:INST:ISUM:EVEN?
Related Commands *CLS STAT:QUES:INST:ISUM:NTR STAT:QUES:INST:ISUM:PTR
91
Programming Manual CS Series AC Current Source
STATus:QUEStionable:INSTrument:ISUMmary:CONDition?
Phase Selectable
This query returns the value of the Questionable Condition register for a specific output of a three-
phase AC source. The particular output phase must first be selected by INST:NSEL.
The Condition register is a read-only register which holds the real-time (unlatched) questionable
status of the CS Series AC Current source.
Query Syntax STATus:QUEStionable:INSTrument:ISUMmary:CONDition?
Example STAT:QUES:INST:ISUM:COND?
Returned Parameters <NR1> (Register value)
STATus:QUEStionable:INSTrument:ISUMmary:ENABle
Phase Selectable
This command sets or reads the value of the Questionable Enable register for a specific output of
a three-phase AC source. The particular output phase must first be selected by INST:NSEL.
The Enable register is a mask for enabling specific bits from the Questionable Event register to
set the questionable summary (QUES) bit of the Status Byte register. This bit (bit 3) is the logical
OR of all the Questionable Event register bits that are enabled by the Questionable Status Enable
register.
Command Syntax STATus:QUEStionable:INSTrument:ISUMmary:ENABle <NRf+>
Parameters 0 to 32767
Default Value 0
Examples STAT:QUES:INST:ISUM:ENAB 18
Query Syntax STATus:QUEStionable:INSTrument:ISUMmary:ENABle?
Returned Parameters <NR1> (Register value)
Related Commands STAT:QUES:INST:ISUM:EVEN?
STATus:QUEStionable:INSTrument:ISUMmary:NTR
STATus:QUEStionable:INSTrument:ISUMmary:PTR
These commands allow the values of the Questionable NTR (Negative-Transition) and PTR
(Positive-Transition) registers to be set or read for a specific output of a three-phase AC source.
The particular output phase must first be selected by INST:NSEL.
The NTR and PTR registers serve as polarity filters between the Questionable Enable and
Questionable Event registers to cause the following actions:
When a bit of the Questionable NTR register is set to 1, then a 1-to-0 transition of the
corresponding bit of the Questionable Condition register causes that bit in the Questionable
Event register to be set.
When a bit of the Questionable PTR register is set to 1, then a 0-to-1 transition of the
corresponding bit in the Questionable Condition register causes that bit in the Questionable
Event register to be set.
If the same bits in both NTR and PTR registers are set to 1, then any transition of that bit at
the Questionable Condition register sets the corresponding bit in the Questionable Event
register.
If the same bits in both NTR and PTR registers are set to 0, then no transition of that bit at the
Questionable Condition register can set the corresponding bit in the Questionable Event
register.
92
Programming Manual CS Series AC Current Source
Note: Setting a bit in the PTR or NTR filter can of itself generate positive or negative events in
the corresponding Questionable Event register.
93
Programming Manual CS Series AC Current Source
SYSTem:COMMunicate:GPIB:ADDRess
This command will set the GPIB address.
Command Syntax SYSTem:COMMunicate:GPIB:ADDRess <NRF>
Parameters 0 to 31 <listen address>
Example SYST:COMM:GPIB:ADDR 2
Returned Parameters <NR1>
SYSTem:COMMunicate:LAN:ADDRess
This command will set the LAN IP address. The query format returns the IP address set. To query
the actual IP address used by the LAN interface (in case the IP address is not static but assigned
by a DHCP server), the NCON parameter (Network Connection Setting) must be added to the
query. The default value is 0.0.0.0.
94
Programming Manual CS Series AC Current Source
SYSTem:COMMunicate:LAN:APPLy
This command will apply the changes in LAN setting. The controller will go to reset condition and
the new LAN setting will take effect.
Command Syntax SYSTem:COMMunicate:LAN:APPLy
Parameters none
Example SYST:COMM:LAN:APPL
Query Syntax no query for this command
Returned Parameters none
SYSTem:COMMunicate:LAN:DEFault
This command will apply the changes in LAN setting to the default setting. The controller will go to
reset condition and the default LAN setting will take effect. Both IP address and Gate way address
are set to zero. The Host name is cleared. The password is reset to “admin”The unit is set to
DHCP or Auto IP.
Command Syntax SYSTem:COMMunicate:LAN:DEFault
Parameters none
Example SYST:COMM:LAN:DEF
Query Syntax no query for this command
Returned Parameters none
SYSTem:COMMunicate:LAN:DESCription
This command will set the user description. The description is limited to 24 characters
Command Syntax SYSTem:COMMunicate:LAN:DESCription <SRD>
Parameters <SRD>
Example SYST:COMM:LAN:DESC “EVAL UNIT”
Query Syntax SYST:COMM:LAN:DESC?
Returned Parameters <SRD>
SYSTem:COMMunicate:LAN:GWADdress
This command will set the LAN Gateway address. The query format returns the Gateway address
set. To query the actual gateway address used by the LAN interface (in case the IP address is not
static but assigned by a DHCP server), the NCON parameter (Network Connection Setting) must
be added to the query. The default value is 0.0.0.0.
Command Syntax SYSTem:COMMunicate:LAN:GWADddress <NRF>
Parameters ddd.ddd.ddd.ddd <Gateway address>
Example SYST:COMM:LAN:GWAD 255.255.255.0
Query Syntax SYST:COMM:LAN:GWAD?
SYST:COMM:LAN:GWAD? NCON
Returned Parameters <CRD>
95
Programming Manual CS Series AC Current Source
SYSTem:COMMunicate:LAN:HBITs
This command will set the number of host address bits. The query format returns the number of
bits set. To query the actual number of bits used by the LAN interface (in case the IP address is
not static but assigned by a DHCP server), the NCON parameter (Network Connection Setting)
must be added to the query. The default value is 8.
Command Syntax SYSTem:COMMunicate:LAN:HBITs <NRF>
Parameters 8 to 32
Example SYST:COMM:LAN:HBIT 8
Query Syntax SYST:COMM:LAN: HBIT?
SYST:COMM:LAN: HBIT? NCON
Returned Parameters <NR1>
SYSTem:COMMunicate:LAN:PASSword
This command will set the user password. The password is used to access to LAN configuration
screen from the Web page. The default password is “admin”. The description is limited to 8
characters.
Command Syntax SYSTem:COMMunicate:LAN:PASSword <SRD>
Parameters <SRD>
Example SYST:COMM:LAN:PASS “admin”
Query Syntax SYST:COMM:LAN:PASS?
Returned Parameters <SRD>
SYSTem:COMMunicate:LAN:PORT
This command will set the socket port number. The query format returns the port number set. The
default value is 5025.
Command Syntax SYSTem:COMMunicate:LAN:PORT<NRF>
Parameters 0- 65535
Example SYST:COMM:LAN:PORT 5025
Query Syntax SYST:COMM:LAN: PORT?
Returned Parameters <NR1>
SYSTem:COMMunicate:SERial:BAUD
This command will set the SERial communication baud rate.
Command Syntax SYSTem:COMMunicate:SERial:BAUD <NRF>
Parameters 9600 | 19200 | 38400 | 57600 | 115200 | 230400 | 460800
Example SYST:COMM:SER:BAUD 38400
Returned Parameters <NR1>
SYSTem:COMMunicate:SERial:PARity
This command will set the SERial communication parity.
Command Syntax SYSTem:COMMunicate:SERial:PARity <parity>
Parameters NONE|EVEN|ODD
Example SYST:COMM:SER:PAR NONE
Returned Parameters <CRD>
96
Programming Manual CS Series AC Current Source
SYSTem:COMMunicate:SERial:BITS
This command will set the SERial communication number of data bits.
Command Syntax SYSTem:COMMunicate:SERial:BITS <NRF>
Parameters 7|8
Example SYST:COMM:SER:BITS 8
Returned Parameters <NR1>
SYSTem:COMMunicate:SERial:SBITs
This command will set the SERial communication number of stop bits.
Command Syntax SYSTem:COMMunicate:SERial:SBITs <NRF>
Parameters 1|2
Example SYST:COMM:SER:SBITs 1
Returned Parameters <NR1>
SYSTem:CONFiguration
This query format of this command returns the installed options and configuration settings of the
power source. It is not possible to change the configuration as only the query form is supported.
Command Syntax SYSTem:CONFigure?
Query Syntax SYSTem:CONFigure?
Returned Parameters <AARD>
Related Commands *OPT?
SYSTem:CONFiguration:NOUTputs
This command selects the number of outputs phases for the AC source. This requires that the AC
source is capable of switching between single and three-phase mode.
Note: Execution of this command disables all outputs, clears lists and *RCL states to the
initialization default values, reconfigures current readback and programming calibration
constants.
SYSTem:ETIMe?
This command will return the total number of accumulated hours, minutes and seconds.
Command Syntax SYSTem:ETIMe?
Parameters none
Example SYST:ETIM?
Returned Parameters <NR1>,<NR1>,<NR1>
97
Programming Manual CS Series AC Current Source
SYSTem:ERRor?
This query returns the next error number followed by its corresponding error message string from
the remote programming error queue. The queue is a FIFO (first-in, first-out) buffer that stores
errors as they occur. As it is read, each error is removed from the queue. When all errors have
been read, the query returns 0, No Error. If more errors are accumulated than the queue can hold,
the last error in the queue is -350, Too Many Errors.
Query Syntax SYSTem:ERRor?
Parameters None
Returned Parameters <NR1>,<SRD>
Example SYST:ERR?
SYSTem:LANGuage
Sets the command language of the AC Power Source to either SCPI or an available alternate
programming language such as APE (Abbreviated Plain English). The language selection is
stored in non-volatile memory and is retained after power-off. Both the command and query form
can be given regardless of the current language.
Command Syntax SYSTem:LANGuage:<language>
Parameters SCPI | APEN
Example SYST:LANG:SCPI
Query Syntax SYSTem LANGuage?
Returned Parameters <CRD>
SYSTem:LOCal
This command can only be used with the RS-232 interface. It sets the interface in Local state,
which enables the front panel controls. For GPIB, use the Local bus message, which controls the
ATN control line.
Command Syntax SYSTem:LOCal
Parameters None
Example SYST:LOC
Related Commands SYST:REM SYST:RWL
SYSTem:REMote
This command can only be used with the RS-232, USB, and LAN interfaces. It sets the interface
in the Remote state, which disables all front panel controls except the Local key. Pressing the
Local key while in the Remote state returns the front panel to the Local state. For GPIB, use the
Local bus message, which controls the ATN control line.
Command Syntax SYSTem:REMote
Parameters None
Example SYST:REM
Related Commands SYST:LOC SYST:RWL
SYSTem:RWLock
This command can only be used with the RS-232, USB, and LAN interfaces. It locks out the Local
key on the front panel. The SYST:LOC command must be used to unlock the front panel. For
GPIB, use the Local Lockout bus message.
Command Syntax SYSTem:RWLock
Parameters None
Example SYST:RWL
Related Commands SYST:LOC
98
Programming Manual CS Series AC Current Source
SYSTem:TEMPerature?
This command will return the internal ambient temperature of the power source in degrees
Celsius.
Command Syntax SYSTem:TEMPerature?
Parameters none
Example SYST:TEMP?
SYSTem:VERSion?
This query returns the SCPI version number to which the AC source complies. The returned value
is of the form YYYY.V, where YYYY represents the year and V is the revision number for that
year.
Query Syntax SYSTem:VERSion?
Parameters None
Returned Parameters <NR2>
Example SYST:VERS?
99
Programming Manual CS Series AC Current Source
100
Programming Manual CS Series AC Current Source
TRACe:CATalog
DATA:CATalog
These commands return a list of defined waveform names. The list includes both pre-defined
waveforms such as SINusoid, SQUare, and CSINusoid, as well as any user-defined waveforms.
Query Syntax: TRACe:CATalog?
DATA:CATalog?
Returned Parameters <SRD>
Example TRAC:CAT?
Related Commands TRAC:DATA TRAC:DEL FUNC:SHAP
TRACe:DEFine
DATA:DEFine
These commands define a new waveform with the name <waveform_name> and allocates
storage for its data. The waveform name can then be referenced by the TRACe:DATA command
to define its data values. See section 6.9 for additional information on using the TRAC:DEF and
TRAC:DATA commands.
An optional second argument is accepted for SCPI compatibility although it serves no useful
purpose in the AC source. The second argument can be the name of an existing waveform, or the
number of points in the trace. When a second name is sent, the data from the first waveform
name is copied to the second. When the number of points in the trace is sent, only the number
1024 is accepted.
Command Syntax: TRACe:DEFine <waveform_name> [, <waveform_name>|1024]
DATA:DEFine <waveform_name> [, <waveform_name>|1024]
Parameters <waveform_name>
Example TRAC:DEF flattop
Related Commands TRAC:DATA TRAC:DEL FUNC:SHAP
TRACe:DELete
DATA:DELete
These commands delete the user-defined waveform table with the name <waveform_name> and
makes its memory available for other waveforms.
Command Syntax: TRACe:DELete[:NAME] <waveform_name>
DATA:DELete[:NAME] <waveform_name>
Parameters <waveform name>
Example TRAC:DEL flattop
Related Commands TRAC:DATA TRAC:DEL FUNC:SHAP
TRACe:DELete:ALL
DATA:DELete:ALL
These commands delete all user-defined waveforms in the data table and makes the entire
waveform memory available.
Command Syntax: TRACe:DELete:ALL
DATA:DELete:ALL
Parameters none
Example TRAC:DEL:ALL
Related Commands TRAC:DATA TRAC:DEL FUNC:SHAP
101
Programming Manual CS Series AC Current Source
Note: If INITiate:CONTinuous ON has been programmed, the trigger subsystem initiates itself
immediately after ABORt, thereby setting the WTG bit.
INITiate:SEQuence
INITiate:NAME
102
Programming Manual CS Series AC Current Source
The INITiate commands control the initiation of both the transient generator and the measurement
trigger systems. They cause the trigger system to make a transition from the Idle state to the
Waiting-for-Trigger state. If the trigger system is not in the Idle state, the initiate commands are
ignored.
INITiate:SEQuence and INITiate:NAME initiate the trigger systems to reference trigger
sequences. INITiate:SEQuence references a trigger sequence by its number, while
INITiate:NAME references a sequence by its name. The correspondence between sequence
names and numbers is:
Sequence Number Sequence Name Description
(default)
1 TRANsient Step, pulse, or list transient trigger sequence
3 ACQuire Measurement acquire trigger sequence
INITiate:CONTinuous:SEQuence
INITiate:CONTinuous:NAME
These commands control the transient generator trigger system.
1 or ON continuously initiates the transient trigger system.
0 or OFF turns off continuous triggering. In this state, the trigger system must be initiated for
each triggered event using INITiate:SEQuence.
INITiate:CONTinuous:SEQuence references the transient trigger sequence by its number, while
INITiate:CONTinuous:NAME references it by its name.
Command Syntax INITiate:CONTinuous:SEQuence[1]<bool>
INITiate:CONTinuous:NAME TRANsient,<bool>
Parameters 0|1|OFF|ON
*RST Value OFF
Examples INIT:CONT:SEQ ON INIT:CONT:NAME TRAN, 1
Related Commands ABOR INIT:CONT TRIG *TRG
103
Programming Manual CS Series AC Current Source
TRIGger
When the trigger subsystem has been initiated, the TRIGger command generates a trigger signal
regardless of the selected trigger source.
Command Syntax TRIGger[:SEQuence1][:IMMediate]
TRIGger[:TRANsient][:IMMediate]
Parameters None
Examples TRIG TRIG:TRAN TRIG:SEQ1:IMM
Related Commands ABOR TRIG:SOUR TRIG:DEL TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
TRIGger:DELay
This command sets the time delay between the detection of a trigger signal and the start of any
corresponding trigger action. After the time delay has elapsed, the trigger is implemented unless
the trigger system is also waiting for a sync signal that has been specified by
TRIGger:SYNChronous:PHASe.
Command Syntax TRIGger[:SEQuence1]:DELay<NRf+>
TRIGger[:TRANsient]:DELay<NRf+>
Parameters 3-phase models: 0 to 1.07533E6|MINimum|MAXimum
1-phase models: 0 to 4.30133E5|MINimum|MAXimum
Unit s (seconds)
*RST Value 0
Examples TRIG:DEL .25 TRIG:DEL MAX TRIG:TRAN:DEL 1
Query Syntax TRIGger[:SEQuence1]:DELay?
TRIGger[:TRANsient]:DELay?
Returned Parameters <NR3>
Related Commands ABOR TRIG TRIG:SOUR TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
TRIGger:SOURce
This command selects the trigger source for the first sequence in generating a step, pulse, or list
output as follows:
BUS IEEE-488 device, *TRG, or <GET> (Group Execute Trigger)
EXTernal AC source's backpanel Trigger In1 SMA connector
IMMediate trigger is generated as soon as the trigger system is initiated.
Command Syntax TRIGger[:SEQuence1]:SOURce<CRD>
TRIGger[:TRANsient]:SOURce<CRD>
Parameters BUS | EXTernal | IMMediate
*RST Value BUS
Examples TRIG:SOUR BUS
TRIG:TRAN:SOUR EXT
Query Syntax TRIGger[:SEQuence1]:SOURce?
TRIGger[:TRANsient]:SOURce?
Returned Parameters <CRD>
Related Commands ABOR TRIG TRIG:DEL TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
104
Programming Manual CS Series AC Current Source
TRIGger:SEQuence2:SOURce
TRIGger:SYNChronize:SOURce
These commands select the synchronizing trigger source in generating a step, pulse, or list output
as follows:
IMMediate starts the transient output immediately, unless a delay time other than 0
has been specified by TRIGger:DELay. In this case the transient output
starts after the expiration of the delay time.
PHASe starts the transient output at the reference phase set by
TRIG:SYNC:PHAS.
Command Syntax TRIGger:SEQuence2:SOURce<CRD>
TRIGger:SYNChronize:SOURce<CRD>
Parameters IMMediate | PHASe
*RST Value IMM
Examples TRIG:SYNC:SOUR IMM TRIG:SEQ2:SOUR PHAS
Query Syntax TRIGger:SEQuence2:SOURce?
TRIGger:SYNChronize:SOURce?
Returned Parameters <CRD>
Related Commands ABOR TRIG:DEL TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
TRIGger:SEQuence2:PHASe
TRIGger:SYNCHronize:PHASe
These commands set the phase angle with respect to an internal phase reference at which
PHASe:SYNChronous:SOURce becomes true. The range is from -360 to +360 degrees.
Command Syntax TRIGger:SEQuence2:PHASe<NRf+>
TRIGger:SYNChronize:PHASe<NRf+>
Parameters -360° to +360°
*RST Value 0
Examples TRIG:SYNC:PHAS 90 TRIG:SEQ2:PHAS 180
Query Syntax TRIGger:SEQuence2:PHASe?
TRIGger:SYNChronize:PHASe?
Returned Parameters <NR3>
Related Commands ABOR TRIG:DEL TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
TRIGger:SEQuence3
TRIGger:ACQuire
When the trigger subsystem has been initiated, these commands generate a measurement
trigger regardless of the selected trigger source. The measurement trigger causes the AC source
to digitize the instantaneous output current and voltage for several output cycles and store the
results in a buffer.
The FETCh commands return the requested calculation from this acquired data. When the
measurement completes, the WTG bit in the Status Operation Condition register is cleared.
105
Programming Manual CS Series AC Current Source
TRIGger:SEQuence3:SOURce
TRIGger:ACQuire:SOURce
These commands select the trigger source for a triggered measurement sequence as follows:
BUS IEEE-488 device, *TRG, or <GET> (Group Execute Trigger)
EXTernal backpanel Trigger In1 SMA connector
TTLTrg the signal driving the Trigger Out1 SMA
Command Syntax TRIGger:SEQuence3:SOURce<CRD>
Command Syntax TRIGger:ACQuire:SOURce<CRD>
Parameters BUS | EXT | TTLT
*RST Value BUS
Examples TRIG:ACQ:SOUR BUS
TRIG:SEQ3:SOUR EXT
Query Syntax TRIGger:SEQuence3:SOURce?
TRIGger:ACQuire:SOURce?
Returned Parameters <CRD>
Related Commands ABOR TRIG:SOUR TRIG:DEL TRIG:SYNC
TRIG:SYNC:PHAS INIT INIT:CONT *TRG *WAI
TRIGger:SEQuence1:DEFine
TRIGger:SEQuence2:DEFine
TRIGger:SEQuence3:DEFine
These commands define the names that are aliased to trigger sequences 1, 2 and 3. The
command accepts only TRANsient for sequence 1, SYNChronous for sequence 2, and ACQuire
for sequence 3 as predefined names. The query allows the user to query the instrument names
aliased to sequences 1, 2, and 3.
Command Syntax TRIGger:SEQuence1:DEFine TRANsient
TRIGger:SEQuence2:DEFine SYNChronous
TRIGger:SEQuence3:DEFine ACQuire
Parameters TRANsient, SYNChronous, ACQuire
Examples SEQ1:DEF TRAN SEQ3:DEF ACQ
Query Syntax TRIGger:SEQuence1:DEFine?
TRIGger:SEQuence2:DEFine?
TRIGger:SEQuence3:DEFine?
Returned Parameters <CRD>
106
Programming Manual CS Series AC Current Source
5. Common Commands
Common commands begin with an * and consist of three letters (command) or three letters and a
? (query). Common commands are defined by the IEEE 488.2 standard to perform some common
interface functions. The CS Series responds to the required common commands that control
status reporting, synchronization, and internal operations. The CS also responds to optional
common commands that control triggers, power-on conditions, and stored operating parameters.
Common commands and queries are listed alphabetically. If a command has a corresponding
query that simply returns the data or status specified by the command, then both command and
query are included under the explanation for the command. If a query does not have a
corresponding command or is functionally different from the command, then the query is listed
separately. The description for each common command or query specifies any status registers
affected. Refer to chapter 7 under Programming the Status and Event Registers which explains
how to read specific register bits and use the information that they return.
Common Commands Syntax
*CLS Clear status
*ESE <n> Standard event status enable
*ESE? Return standard event status enable
*ESR? Return event status register
*IDN? Return instrument identification
*OPC Enable "operation complete" bit in ESR
*OPC? Return a "1" when operation complete
*OPT? Return option number
*PSC <bool> Power-on status clear state set/reset
*PSC? Return power-on status clear state
*RCL <n> Recall instrument state
*RST Reset
*SAV <n> Save instrument state
*SRE <n> Set service request enable register
*SRE? Return service request enable register
*STB? Return status byte
*TRG Trigger
*TST? Perform selftest, then return result
*WAI Hold off bus until all device commands done
107
Programming Manual CS Series AC Current Source
5.1 *CLS
This command clears the following registers (see chapter 7 under Programming the Status and
Event Registers for descriptions of all registers):
Standard Event Status
Operation Status Event
Questionable Status Event
Status Byte
Error Queue
Command Syntax *CLS
Parameters None
*ESE
This command programs the Standard Event Status Enable register bits. The programming
determines which events of the Standard Event Status Event register (see *ESR?) are allowed to
set the ESB (Event Summary Bit) of the Status Byte register. A "1" in the bit position enables the
corresponding event. All of the enabled events of the Standard Event Status Event Register are
logically ORed to cause the Event Summary Bit (ESB) of the Status Byte Register to be set. See
section 7.5 for descriptions of the Standard Event Status registers.
The query reads the Standard Event Status Enable register.
Bit Position 7 6 5 4 3 2 1 0
Bit Name PON not used CME EXE DDE QYE not used OPC
Bit Weight 128 32 16 8 4 1
5.2 *ESR?
This query reads the Standard Event Status Event register. Reading the register clears it. The bit
configuration of this register is the same as the Standard Event Status Enable register (see
*ESE). See section 7.5 for a detailed explanation of this register.
108
Programming Manual CS Series AC Current Source
5.3 *IDN?
This query requests the AC source to identify itself. It returns the data in four fields separated by
commas.
Query Syntax *IDN?
Returned Parameters <AARD>
Field Information
California Instruments Manufacturer
4500CS 10-digit model number
12345 5-character serial number or 0
<R>1.20 Revision levels of firmware
Example CALIFORNIA INSTRUMENTS,4500CS,12345,1.20
5.4 *OPC
This command causes the interface to set the OPC bit (bit 0) of the Standard Event Status
register when the AC source has completed all pending operations. (See *ESE for the bit
configuration of the Standard Event Status registers.) Pending operations are complete when:
All commands sent before *OPC have been executed. This includes overlapped commands.
Most commands are sequential and are completed before the next command is executed.
Overlapped commands are executed in parallel with other commands. Commands that affect
output voltage or state, relays, and trigger actions are overlapped with subsequent commands
sent to the CS Series AC Current source. The *OPC command provides notification that all
overlapped commands have been completed.
All triggered actions are completed and the trigger system returns to the Idle state.
*OPC does not prevent processing of subsequent commands but Bit 0 will not be set until all
pending operations are completed.
The query causes the interface to place an ASCII "1" in the Output Queue when all pending
operations are completed.
Command Syntax *OPC
Parameters None
Query Syntax *OPC?
Returned Parameters <NR1>
Related Commands *TRIG *WAI
5.5 *OPT?
This query requests the AC Source to identify any options that are installed. Options are identified
by number. A 0 indicates no options are installed.
Query Syntax *OPT?
Returned Parameters <AARD>
5.6 *PSC
109
Programming Manual CS Series AC Current Source
This command controls the automatic clearing at power-on of the Service Request Enable and the
Standard Event Status Enable registers (see chapter 7 under Programming the Status and Event
Registers for register details):
*PSC ON | 1 prevents the register contents from being saved causing them to be cleared
at power-on. This prevents a PON event from generating SRQ at power-
on.
PSC OFF | 0 saves the contents of the Standard Event Enable and Service Request
Enable registers in nonvolatile memory and recalls them at power-on. This
allows a PON event to generate SRQ at power-on.
Command Syntax *PSC<bool>
Parameters 0 | 1 | OFF | ON
Example *PSC 0 *PSC 1
Query Syntax *PSC?
Returned Parameters 0|1
Related Commands *ESE *SRE
5.7 *RCL
Warning Recalling a previously stored state may place hazardous voltages at the AC
source output.
This command restores the AC source to a state that was previously stored in memory with a
*SAV command to the specified location. All states are recalled with the following exceptions:
CAL:STATe is set to OFF
the trigger system is set to the Idle state by an implied ABORt command (this cancels any
uncompleted trigger actions)
The device state stored in location 0 is automatically recalled at power turn-on when the
OUTPut:PON:STATE is set to RCL0. This register only saves steady state setting, not the
transient list data. All other registers (1-15) saved both the steady state settings and the transient
list data record.
Command Syntax *RCL <NRf>
Parameters 0 through 15
Example *RCL 3
Related Commands *PSC *RST *SAV
Note that recalling settings and transient list information from non-volatile memory takes some
amount of time as shown in the table below. If you develop a test program that uses the *RCL or
*SAV commands, insert the amount of delay shown in the table before sending the next command
in your program.
Command: *RCL 0 *RCL n (n = 1 to 15) *SAV 0 *SAV n (n = 1 to 15)
Execution time: 20 msec 40 msec 100 msec 100 msec
110
Programming Manual CS Series AC Current Source
5.8 *RST
This command resets the AC source to the factory-defined states shown in Table 5-2. This state
applies if the PONS is set to use the RST state. If the PONS state is set to use REG0, the settings
stored in setup register 0 take effect instead.
Item Value Item Value
CAL:STAT OFF [SOUR:]FUNC:MODE FIX
[SOUR:]FUNC:TRIG SIN
[SOUR:]FUNC:CSIN 100%
[SOUR:]LIST:COUN 1
[SOUR:]LIST:STEP AUTO
INIT:CONT OFF [SOUR:]PHAS øA = 0°,
øB = 240°,
øC = 120°
INST:COUP ALL [SOUR:]PHAS:TRIG øA = 0°,
øB = 240°,
øC = 120°
INST:NSEL 1 [SOUR:]PHAS:MODE FIX
OUTP OFF [SOUR:]PULS:COUN 1
OUTP:DFI OFF [SOUR:]PULS:DCYC 50%
OUTP:DFI:SOUR OFF [SOUR:]PULS:HOLD WIDT
OUTP:PROT:DEL 100ms [SOUR:]PULS:PER 1
OUTP:RI:MODE OFF [SOUR:]PULS:WIDT 0.01667s
OUTP:TTLT OFF [SOUR:]CURR 0.000
OUTP:TTLT:SOUR BOT [SOUR:]CURR:TRIG 0.000
SENS:SWE:OFFS:POIN 0 [SOUR:]CURR:MODE FIX
SENS:SWE:TINT 21µs
SENS:WIND Rectangular [SOUR:]VOLT:SENS:SOUR INT
[SOUR:]VOLT 135 [SOUR:]CURR:SLEW INF
[SOUR:]VOLT:PROT:STAT OFF [SOUR:]CURR:SLEW:MODE FIX
[SOUR:]FREQ 60Hz [SOUR:]CURR:SLEW:TRIG INF
[SOUR:]FREQ:MODE FIX SYST:CONF:NOUT LAST
[SOUR:]FREQ:SLEW INF TRIG:DEL 0
[SOUR:]FREQ:SLEW:MODE FIX TRIG:SOUR BUS
[SOUR:]FREQ:SLEW:TRIG INF TRIG:SEQ2:SOUR IMM
[SOUR:]FREQ:TRIG 60Hz TRIG:SEQ2:PHAS 0
[SOUR:]FUNC SIN TRIG:SEQ3:SOUR BUS
Note *RST does not clear any of the status registers or the error queue, and does not affect any
interface error conditions. *RST does not affect the data in any of the lists.
*RST sets the trigger system to the Idle state.
111
Programming Manual CS Series AC Current Source
5.9 *SAV
This command stores the present state of the AC source to a specified location in memory. Up to
16 setup states can be stored in nonvolatile memory. If a particular state is desired at power-on, it
should be stored in location 0. It then will be recalled at power-on if the OUTPut:PON:STATe
command is set to RCL0. Use *RCL to retrieve instrument states.
Command Syntax *SAV
Parameters 0 to 15
Related Commands *PSC *RCL *RST
Note that saving settings and transient list information from non-volatile memory takes some
amount of time as shown in the table below. If you develop a test program that uses the *RCL or
*SAV commands, insert the amount of delay shown in the table before sending the next command
in your program.
Command: *RCL 0 *RCL n (n = 1 to 15) *SAV 0 *SAV n (n = 1 to 15)
Execution time: 20 msec 40 msec 100 msec 100 msec
5.10 *SRE
This command sets the condition of the Service Request Enable Register. This register
determines which bits from the Status Byte Register (see *STB for its bit configuration) are
allowed to set the Master Status Summary (MSS) bit and the Request for Service (RQS)
summary bit. A 1 in any Service Request Enable Register bit position enables the corresponding
Status Byte Register bit and all such enabled bits then are logically ORed to cause Bit 6 of the
Status Byte Register to be set. See chapter 7 under Programming the Status and Event Registers
for more details concerning this process.
When the controller conducts a serial poll in response to SRQ, the RQS bit is cleared, but the
MSS bit is not. When *SRE is cleared (by programming it with 0), the AC source cannot generate
an SRQ to the controller.
Command Syntax *SRE <NRf>
Parameters 0 to 255
Default Value (See *PSC)
Example *SRE 128
Query Syntax *SRE?
Returned Parameters <NR1>(Register binary value)
Related Commands *ESE *ESR *PSC
5.11 *STB?
This query reads the Status Byte register, which contains the status summary bits and the Output
Queue MAV bit. Reading the Status Byte register does not clear it. The input summary bits are
cleared when the appropriate event registers are read (see chapter 7 under Programming the
Status and Event Registers for more information). A serial poll also returns the value of the Status
Byte register, except that bit 6 returns Request for Service (RQS) instead of Master Status
Summary (MSS). A serial poll clears RQS, but not MSS. When MSS is set, it indicates that the AC
source has one or more reasons for requesting service.
Bit Position 7 6 5 4 3 2-0
Bit Name OPER MSS RQS ESB MAV QUES not used
112
Programming Manual CS Series AC Current Source
5.12 *TRG
This command generates a trigger to any subsystem that has BUS selected as its source (for
example, TRIG:SOUR BUS).The command has the same affect as the Group Execute Trigger
(<GET>) command.
Command Syntax *TRG
Parameters None
Related Commands ABOR INIT TRIG[:IMM]
5.13 *TST?
This query causes the AC Source to do a self-test and report any errors. The selftest will run until
the first error is encountered and terminate. The response to the query will either be the first error
encountered or 0 is no error was found. (Selftest passed). For a list of error messages, refer to
Appendix C.
Note: The selftest should always be run in 3 phase mode on all CS models. If the selftest is run
in single phase mode, not all aspects of the Phase B and C hardware will be tested as a result.
Note: The selftest is always performed at 1000 Hz, 11.1 Arms. This is required to obtain the
correct internal test voltage based on the buit-in selftest loads. However, the output relay is open
during the selftest and no output is present on the output terminals during the selftest. At the end
of the selftest, the output relay remains open and the current is set to 0A. The programmed
frequency will return to the value set before execution of the selftest command.
113
Programming Manual CS Series AC Current Source
5.14 *WAI
This command instructs the AC source not to process any further commands until all pending
operations are completed. Pending operations are complete when:
All commands sent before *WAI have been executed. This includes overlapped commands.
Most commands are sequential and are completed before the next command is executed.
Overlapped commands are executed in parallel with other commands. Commands that affect
output voltage or state, relays, and trigger actions are overlapped with subsequent commands
sent to the AC source. The *WAI command prevents subsequent commands from being
executed before any overlapped commands have been completed.
All triggered actions are completed and the trigger system returns to the Idle state.
*WAI can be aborted only by sending the an IEEE-488 DCL (Device Clear) command.
Command Syntax *WAI
Parameters None
Related Commands *OPC
114
Programming Manual CS Series AC Current Source
6. Programming Examples
6.1 Introduction
This chapter contains examples on how to program your AC source. Simple examples show you
how to program:
output functions such as current, frequency, and phase
the transient waveform generator
internal and external triggers
measurement functions
user-defined waveforms
the status and protection functions
These examples in this chapter are generic SCPI commands. See chapter 2 for information about
encoding the commands as language strings. Where appropriate, optional commands are shown
for clarity in the examples.
OUTPut ON
AC Current and Frequency
The AC rms output current is controlled with the CURRent command. For example, to set the AC
output voltage to 0.125 amps rms, use:
CURR 0.125
All phases are programmed to 0.125 amps rms because the INSTrument:COUPle at *RST is set
to ALL.
115
Programming Manual CS Series AC Current Source
The AC source can be programmed to turn off its output if the AC output current exceeds a preset
peak current limit. This protection feature is implemented with the CURRent:PROTection
command as explained in chapter 4.
Maximum Current
The maximum rms output current that can be programmed can be queried with:
CURR? MAX
Frequency
The output frequency is controlled with the FREQuency command. To set the output frequency to
400 Hz, use:
FREQuency 400
Current and Frequency Slew Rates
Current Slew
The AC source has the ability to control the slew rate of AC amplitude and frequency changes.
This can be used to generate ramps or to protect sensitive loads. To set the current slew rate to
20 amps per second, use:
CURRent:SLEW 20
At *RST the slew rate is set to INFinity, which means that AC current changes occur at the fastest
possible slew rate. The slew rate applies to programmed changes in AC output amplitude while
the unit is operating in fixed mode. Amplitude changes made by the step, pulse, and list transients
are controlled by the same rules that apply to all other functions that are subject to transient
control. See "Programming Transient Outputs".
Output current changes caused by the OUTPut:STATe command, by a protection feature
disabling the output, or as a result of load changes are not subject to this slew rate control.
Frequency Slew
The AC source also has the ability to control the slew rate of frequency changes. To set the
frequency slew rate to 30 Hz per second, use:
FREQuency:SLEW 30
At *RST the slew rate is set to INFinity, which means that frequency changes occur
instantaneously. The frequency slew rate applies to programmed changes in frequency while the
unit is operating in fixed mode. Frequency changes made by the step, pulse, and list transients
are controlled by the same rules that apply to all other functions that are subject to transient
control. See "Programming Transient Outputs".
116
Programming Manual CS Series AC Current Source
Two commands determine which output phase or phases receive commands in the three-phase
mode. These are:
INSTrument:COUPle NONE
INSTrument:NSELect 2
are sent, all subsequent voltage commands will go to output phase 2, and all measurement
queries will return readings from output phase 2.
The INSTrument:COUPle command has no effect on queries. In the three-phase mode, queries
are always directed to the output selected by INSTrument:NSELect.
Programming the Output Phase
You can control the phase of the AC current waveform relative to an internal reference with:
PHASe <n>
which sets the phase in degrees. If <n> is positive, the current waveform leads the internal
reference.
The PHASe command sets the relative phase of each of the outputs. The INSTrument:COUPle
setting is ignored by the PHASe command - it always controls the output selected by
INSTrument:NSELect.
VOLTage<n>
where <n> is the rms voltage limit in volts.
If the load connected results in a voltage higher than the programmed limit, the output current is
reduced to keep the rms voltage within the limit. Since the rms detection involves a filter time
constant that is long compared to a single output cycle, the response time of the rms voltage limit
is not instantaneous. When the output current is reduced, its waveform is preserved (the output
waveform is attenuated, not clipped).
The AC source can be programmed to turn off its output if the rms voltage limit is reached. This
protection feature is implemented with the VOLTage:PROTection:STATe command as explained
in chapter 3.
117
Programming Manual CS Series AC Current Source
Note: In Step mode, the triggered value becomes the immediate value. In Pulse mode, the
functions return to their immediate value during the low portion of the pulse.
If there are no further pulses, the immediate value remains in effect. In List mode, the functions
return to their immediate value at the completion of the list.
You can mix FIXed, STEP, PULSe, and LIST modes among most functions. When a trigger is
received, each function will react in a manner defined by its mode. However, this is subject to the
following limitation to ensure the proper output voltage in all cases:
The AC current and current slew functions cannot be set to Step or Pulse mode if one of them is
set to List mode.
118
Programming Manual CS Series AC Current Source
IMMediate level
Triggers ignored,
output always set to
FIXED mode immediate command
levels.
TRIGered level
IMMediate level At trigger, the triggered
level becomes the new
STEP mode immediate level.
TRIGered level
IMMediate level At trigger, the triggered
PULSE mode level is active during the
pulse width portion of
the pulse waveform.
IMMediate level
At trigger, the list starts.
When list completes,
LIST mode output returns to
immediate level.
step 2
step0
step 1
Trigger List
Applied Complete
*RST
CURRent:MODE STEP
2. Set the triggered level of the function that will generate the transient. For example, if the
previously programmed current function is going to step the output current amplitude to 0.135
amps upon receipt of a trigger, use:
CURRent:TRIGger 0.135
3. Select the trigger source that will generate the trigger. For example, to select the external
Trigger In1 SMA connector as the trigger source, use:
TRIGger:TRANsient:SOURce EXTernal
119
Programming Manual CS Series AC Current Source
INITiate:IMMediate:SEQuence1
6. To enable the transient system indefinitely use:
INITiate:CONTinuous:SEQuence1 ON
Trigger the transient. This is described in detail under "Triggering Output Changes".
Example
The following example programs a current dropout for 2 cycles of a 0.5 amps, 400 Hz output. The
dropout begins at the positive peak of the output current waveform (90 degrees phase) and is
triggered by IEEE-488 bus trigger.
*RST Begin at power-on state
CURR 0.5 Set initial output current (immediate-level)
FREQ 400 Set initial output frequency
OUTP ON Enable the output
CURR:MODE PULS Enable output to generate pulses when triggered
CURR:TRIG 0 Set the current dropout (triggered level)
PULS:WIDT .03333 Set pulse width for 2 periods
TRIG:SOUR BUS Respond to IEEE-488 bus triggers
TRIG:SYNC:SOUR PHAS Synchronize triggers to internal phase reference
TRIG:SYNC:PHAS 90 Sets internal phase reference point to 90 degrees
INIT:SEQ1 Set to Wait-for-trigger state
<device trigger> Send the IEEE-488 bus trigger
120
Programming Manual CS Series AC Current Source
CURRent:MODE LIST
FREQuency:MODE LIST
2. Program the list of output values for each function. The list commands take a comma-
separated list of arguments. The order in which the arguments are given determines the
sequence in which the values will be output. For example, to cycle the voltage through a
sequence, a list may include the following values:
LIST:CURR 0.120, 0.132, 0.108, 0.120, 0.132, 0.108, 0.120, 0.132, 0.108
You can specify lists for more than one function. For example, to synchronize the previous
current list with another list that varies the output frequency from nominal, to high, to low, the
lists may include the following values:
LIST:CURR 0.120, 0.132, 0.108, 0.120, 0.132, 0.108, 0.120, 0.132, 0.108
LIST:FREQ 400, 400, 400, 440, 440, 440, 360, 360, 360
All lists must have the same number of data values or points, or an error will occur when the
transient system that starts the sequence is later initiated. The exception is when a list has
only one item or point. In this case the single-item list is treated as if it had the same number
of points as the other lists, with all values being equal to the one item. For example:
121
Programming Manual CS Series AC Current Source
4. Determine the number of times the list is repeated before it completes. For example, to repeat
a list 10 times use:
LIST:COUNt 10
Entering INFinity makes the list repeat indefinitely. At *RST, the count is set to 1.
5. Determines how the list sequencing responds to triggers. For a closely controlled sequence of
output levels, you can use a dwell-paced list. To cause the list to be paced by dwell time use:
LIST:STEP AUTO
As each dwell time elapses, the next point is immediately output. This is the *RST setting.
If you need the output to closely follow asynchronous events, then a trigger-paced list is more
appropriate. In a trigger-paced list, the list advances one point for each trigger received. To
enable trigger-paced lists use:
LIST:STEP ONCE
The dwell time associated with each point determines the minimum time that the output
remains at that point. If a trigger is received before the previous dwell time completes, the
trigger is ignored. Therefore, to ensure that no triggers are lost, program the dwell time to
zero.
6. Use the transient trigger system to trigger the list. This is described in detail under "Triggering
Output Changes" (Section 6.6).
122
Programming Manual CS Series AC Current Source
ABOR
IDLE STATE *RST
INIT:CONT OFF *RCL
INIT[:IMM]
INITIATED STATE
INIT:CONT ON
OR
LIST NOT COMPLETE & TRIGGER RECEIVED
LIST:STEP ONCE
DELAYING STATE
DELAY COMPLETED
SYNC COMPLETED
YES PULSE NO
COUNT
DONE?
LIST
YES COMPLETE NO
OR
LIST:STEP ONCE
?
123
Programming Manual CS Series AC Current Source
The INITiate commands move the trigger system from the Idle state to the Initiated state. This
enables the AC source to receive triggers. To initiate for a single triggered action, use:
INITiate:IMMediate:SEQuence1 or
INITiate:IMMediate:NAME TRANsient
After a trigger is received and the action completes, the trigger system will return to the Idle state.
Thus it will be necessary to initiate the system each time a triggered action is desired. To keep a
trigger system initiated for multiple actions without having to send an initiate command for each
trigger, use:
INITiate:CONTinuous:SEQuence1 ON or
INITiate:CONTinuous:NAME TRANsient, ON
The SEQuence2 (or SYNChronize) trigger sequence does not have an INITiate command. It is
always initiated.
TRIGger:SEQuence1:SOURce EXTernal or
TRIGger:TRANsient:SOURce EXTernal
To select IEEE-488 bus triggers (group execute trigger, device trigger, or *TRG command), use:
TRIGger:SEQuence1:SOURce BUS or
TRIGger:TRANsient:SOURce BUS
To select a trigger source that is always true, use:
TRIGger:SEQuence1:SOURce IMMediate or
TRIGger:TRANsient:SOURce IMMediate
The immediate source can be combined with INITiate:CONTinuous:SEQuence1 ON to generate
repetitive output transients. A transition from the Initiated state to the Delay state is made when
the trigger signal is received.
TRIGger:SEQuence1:DELay .01 or
TRIGger:TRANsient:DELay .01
which sets a delay time of 10 milliseconds. A trigger delay can only be programmed for
SEQuence1 (or TRANsient) triggers. When the programmed trigger delay has elapsed, the trigger
system transitions from the Delay state to the Wait-for-sync state.
124
Programming Manual CS Series AC Current Source
TRIGger:SEQuence2:SOURce PHASe or
TRIGger:SYNChronize:SOURce PHASe
To select the desired phase, use:
TRIGger:SEQuence2:PHASe 90 or
TRIGger:SYNChronize:PHASe 90
which specifies the 90 degree phase angle of the internal phase reference as the point where the
transient begins.
To turn off transient phase synchronization, use:
TRIGger:SYNChronous:SOURce IMMediate
When IMMediate is selected, the trigger system transitions through the Delaying and Wait-for-
sync states and goes directly to the Output state. This is the parameter selected at *RST.
TRIGger:SEQuence1:SOURce IMMediate
INITiate:CONTinuous:SEQuence1 ON
When the trigger system enters the Output Change state upon receipt of a trigger (see Figure
6-2), the triggered functions are set to their programmed trigger levels. When the triggered actions
are completed, the trigger system returns to the Idle state.
125
Programming Manual CS Series AC Current Source
where <n> specifies the dwell time in seconds. The number of dwell points must equal the
number of output points. If a dwell list has only one value, that value will be applied to all points in
the output list. After each new output level or point is programmed, the output remains at that
point in the list for the programmed dwell interval before the list advances to the next point. Only
an ABORt command can transfer the system out of the Dwelling state.
At the end of the dwell interval, the transition to the next state depends on whether or not the list
has completed its sequencing and the state of the LIST:STEP command (see Figure 6-2).
If the list is completed, the trigger system returns to the Idle state.
If the list is not completed, then the system reacts as follows:
LIST:STEP ONCE programs the trigger system to return to the Initiated state to wait for the
next trigger.
LIST:STEP AUTO programs the trigger system to immediately execute the next list point.
Note For each MEASure form of the query, there is a corresponding query that begins with the
header FETCh. FETCh queries perform the same calculation as their MEASure
counterparts, but do not cause new data to be acquired. Data acquired by an explicit
trigger or a previously programmed MEASure command are used.
MEASure:VOLTage:ACDC? or
MEASure:CURRent:ACDC?
To measure the DC voltage or current components, use:
MEASure:VOLTage:DC? or
126
Programming Manual CS Series AC Current Source
MEASure:CURRent:DC?
To measure the maximum current amplitude, use:
MEASure:CURRent:AMPLitude:MAXimum?
MEASure:CURRent:HARMonic:THD?
MEASure:VOLTage:HARMonic:THD?
INSTrument:NSELect 1
FETCh:VOLTage:AC?
INSTrument:NSELect 2
FETCh:VOLTage:AC?
INSTrument:NSELect 3
FETCh:VOLTage:AC?
127
Programming Manual CS Series AC Current Source
ABOR
IDLE STATE *RST
*RCL
INIT[:IMM]
INITIATED STATE
TRIGGER RECEIVED
DATA ACQUISITION
INITiate:IMMediate:SEQuence3 or
INITiate:IMMediate:NAME ACQuire
After a trigger is received and the data acquisition completes, the trigger system will return to the
Idle state. Thus it will be necessary to initiate the system each time a triggered acquisition is
desired.
Note: You cannot initiate measurement triggers continuously. Otherwise, the measurement data
in the data buffer would continuously be overwritten by each triggered measurement.
TRIGger:SEQuence3:SOURce EXTernal or
128
Programming Manual CS Series AC Current Source
TRIGger:ACQuire:SOURce EXTernal
To select IEEE-488 bus triggers (group execute trigger, device trigger, or *TRG command), use:
TRIGger:SEQuence3:SOURce BUS or
TRIGger:ACQuire:SOURce BUS
To select the signal driving the Trigger Out1 SMA connector, use:
TRIGger:SEQuence3:SOURce TTLTrg or
TRIGger:ACQuire:SOURce TTLTrg
VOLT:PROT:STATE ON
OUTP:DFI:SOURCE QUES
OUTP:DFI:STATE ON
STAT:QUES:PTR 2
STAT:QUES:ENAB 2
After sending these commands, the DFI output will indicate when the RMS OVP goes active.
Note that when an OVP fault happens, the PROT lamp comes on indicating that one has to send
OUTP:PROT:CLEAR to re-enable the source once the over voltage condition is removed. Note
also that the DFI output will stay low until the questionable status register (STAT:QUES?) is read.
129
Programming Manual CS Series AC Current Source
The required data format conversion from IEEE floating point to single precision floating points is shown in
the next section.
6.8.2 VB6 Sample: Converting IEEE format trace data to floating point
Converting the received IEEE floating point format waveform data to a single precision floating
point value can be accomplished using the following sample routine:
130
Programming Manual CS Series AC Current Source
131
Programming Manual CS Series AC Current Source
FloatConvError:
'Conversion errors are truncated to zero
StringToIEEEFloat = 0
Exit Function
End Function
132
Programming Manual CS Series AC Current Source
Offset = - 4096
Offset = - 2048
Offset = 0
Offset =
4096 DATA POINTS
0 to 2^9
Acquisition Time
Trigger
Moment
133
Programming Manual CS Series AC Current Source
Note: Avoid using names that conflict with standard waveforms such as SIN, SINE, CLIPPED,
SQUARE.
Once downloaded, user waveforms can be recalled from either the front panel using the MENU
key or over the bus using the FUNCtion command. See section 4.17.
Note: User defined waveforms are retained in non-volatile memory. The process of writing to this
memory takes a certain amount of time. Allow a 500 msec delay between sending the last
data value and sending the next bus command.
Sample code:
Global sWaveformPoints(1023) As Single 'Waveform datapoints, base 0
134
Programming Manual CS Series AC Current Source
XFRArbError:
MsgBox Error(Err), vbOKOnly + vbInformation, PROGNAME
End Sub
135
Programming Manual CS Series AC Current Source
The outputs of the Operation Status register group are logically-ORed into the OPER(ation)
summary bit (7) of the Status Byte register.
136
Programming Manual CS Series AC Current Source
QUESTIONABLE STATUS
ø3 CONDITION PTR/NTR EVENT ENABLE
OV 0
ø2 1 1 1 1
1
ø1 OCP 2 2 2 2
2
SOA 4 4 4 4
3 8 8 8
UNR 8
LOGICAL OR
OT 4 16 16 16 16
n.u. 5-8
RI 9 512 512 512 512
CL peak 10 1024 1024 1024 1024
Rail 11 2048 2048 2048 2048
CL rm s 12
4096 4096 4096 4096
8192 8192 8192 8192
13
n.u.
14,15
Isum
QUESTIONABLE INSTRUMENT ISUMMARY
(1 identical register set for each phase)
CONDITION PTR/NTR EVENT ENABLE
OV 0
1 1 1 1
1
OCP 2 2 2 2
2
SOA 4 4 4 4
3
UNR 8 8 8 8
LOGICAL OR
4 16 16 16
OT 16
n.u. 5-8
RI 9 512 512 512 512
ø1 ø2 ø3
CL peak 10 1024 1024 1024 1024
Rail 11 2048 2048 2048 2048
VL rms 12 4096 4096 4096 4096
n.u. 13-15 8192 8192 8192 8192
SERVICE
STANDARD EVENT STATUS
STATUS REQUEST
EVENT ENABLE
OUTPUT BYTE ENABLE
OPC 0 n.u. 0
1 1 QUEUE
n.u. 1 DATA n.u. 1
2 DATA 2
LOGICAL OR
LOGICAL OR
OYE 4 4 DATA n.u.
DDE 3 QUES 3
8 8 8 8
EXE 4 MAV 4
16 16 16 16
CME 5 ESB 5
32 32 32 32
n.u. 6 MSS 6
64
PON 7 OPER 7
128 128 128 128
OPERATION STATUS
SERVICE
CONDITION PTR/NTR EVENT ENABLE
REQUEST
0 RQS
GENERATION
LOGICAL OR
LOGICAL OR
CAL 1 1 1
n.u. 1-4
WTG 5
32 32 32
n.u. 6-15
137
Programming Manual CS Series AC Current Source
138
Programming Manual CS Series AC Current Source
The outputs of the Questionable Status group are logically-ORed into the QUEStionable summary
bit (3) of the Status Byte register.
Note: If the AC source is in the three-phase mode, each signal that is fed into the Questionable
Status Condition register is logically-ORed from three corresponding status signals that
originate from each phase. Figure 7-1 illustrates this for the OV bit; the same illustration
also applies to the other bits in the Condition register.
139
Programming Manual CS Series AC Current Source
INSTrument:NSELect?
To set or read the status registers of another phase, first use:
INSTrument:NSELect <n>
where <n> is the phase number. Then send the appropriate register commands.
The outputs of the Questionable Instrument Isummary Status group are logically-ORed into the
Isum bit (13) of the Questionable Condition register.
140
Programming Manual CS Series AC Current Source
*PSC OFF
*ESE 128
*SRE 32
141
Programming Manual CS Series AC Current Source
142
Programming Manual CS Series AC Current Source
7.7 Examples
*STB? or
serial poll
2. Read the corresponding Event register for each summary bit to determine which events
caused the summary bit to be set. Use:
STATus:QUEStionable:EVENt?
STATus:OPERation:EVENt?
ESR?
Note: When an Event register is read, it is cleared. This also clears the corresponding summary
bit.
3. Remove the specific condition that caused the event. If this is not possible, the event may be
disabled by programming the corresponding bit of the status group Enable register or
NTR|PTR filter. A faster way to prevent the interrupt is to disable the service request by
programming the appropriate bit of the Service Request Enable register.
STATus:QUEStionable:PTR 19 (1 + 2 + 16 = 19)
2. Program the Questionable Status Enable register to allow the latched events to be summed
into the QUES summary bit. Use:
STATus:QUEStionable:ENABle 19
3. Program the Service Request Enable register to allow the QUES summary bit from the Status
Byte register to generate RQS. Use:
*SRE 8
4. When you service the request, read the event register to determine which Questionable
Status Event register bits are set and clear the register for the next event. Use:
STATus:QUEStionable:EVENt?
143
Programming Manual CS Series AC Current Source
TRIGger:SEQuence3:SOURce EXTernal or
TRIGger:ACQuire:SOURce EXTernal
Trigger Out SMA (Function Strobe)
This chassis-referenced digital output can be programmed to supply a pulse output at the leading
or trailing edge of a step or pulse, or at the leading edge of any point in a list sequence. The
output signal is nominally a 10 microsecond low-true pulse. To enable the Trigger Out connector,
use:
OUTPut:TTLTrg:STATe ON
At *RST, the Trigger Out connector is off.
To select a trigger source for the Trigger Out connector, use:
BOT - specifies that the pulse is output at the beginning of a transient. This is
the *RST setting.
EOT - specifies that the pulse is output at the end of a transient.
LIST - specifies that the pulse position is defined by the LIST:TTLTrg command.
You can also specify the Trigger Out connector as a trigger source for measurement trigger
sequences. Use:
TRIGger:SEQuence3:SOURce TTLT or
TRIGger:ACQuire:SOURce TTLT
144
Programming Manual CS Series AC Current Source
145
Programming Manual CS Series AC Current Source
LATChing causes a low-true signal on the INH input to disable the output. The only
way to clear the latch is by sending an OUTPut:PROTection:CLEAR
command while the INH input is false.
LIVE allows the RI input to disable the output in a non-latching manner. When
INH is low true, the output is disabled. When INH is high, it has no effect
on the output.
OFF disables the INH input.
QUEStionable selects the Questionable event summary bit (bit 3 of the Status Byte
Register)
OPERation selects the Operation Event summary bit (bit 7 of the Status Byte
Register)
ESB selects the Standard Event summary bit (bit 5 of the Status Byte
Register)
RQS selects the Request Service bit (bit 6 of the Status Byte Register)
OFF selects no DFI source
To enable or disable the DFI output, use:
OUTPut:DFI:STATe ON | OFF
146
Programming Manual CS Series AC Current Source
147
Programming Manual CS Series AC Current Source
8. Option Commands
8.1 Introduction
The 4500CS is a specific configuration AC Current Source. As such, there are no options required
or available.
The CS Series AC Current source will report any installed options, including any firmware options,
when queried using the SYST:CONF:BYTE? or *OPT? command..
148
Programming Manual CS Series AC Current Source
149
Programming Manual - Rev F CS Series AC Current Source
[:LEVel] :CONDition?
[:IMMediate] :ENABle <n>
[:AMPLitude] <n> :INSTrument
:TRIGgered :ISUMmary
[:AMPLitude] <n> [:EVENt]?
:MODE FIXed | STEP | PULSe | LIST :CONDition?
:SLEW :ENABle <n>
[:IMMediate] <n> | INFinity :NTRansition <n>
:MODE FIXed | STEP | PULSe | LIST :PTRansition <n>
:TRIGgered <n> | INFinity :NTRansition <n>
FREQuency :PTRansition <n>
[:CW | :IMMediate] <n>
:MODE FIXed|STEP|PULSe|LIST|SENS|EXT SYSTem
:SLEW :COMMunicate
[:IMMediate] <n> | INFinity :GPIB
:MODE FISed | STEP | PULSe | LIST :ADDRess
:TRIGgered <n> | INFinity :LAN
:TRIGgered <n> :ADDRess
LIST :GWADdress
:COUNt <n> | INFinity :HBITs
:CURRent :PORT
[:LEVel] <n>{,<n>} :SERial
:POINts? :BAUD
:SLEW <n>{,<n>} :PARity
:POINts? :BITS
:DWELl <n>{,<n>} SBITs
:POINts? :CONFiguration
:FREQuency :NOUTputs <n>
[:LEVel] <n>{,<n>} :ETIMe?
:POINts? :ERRor?
:SLEW <n>{,<n>} :LANGuage SCPI | APEN
:POINts? :REMote
:MODE BOT | EOT :RWLOCK
:PHASe <n>{,<n>} :TEMPerature?
:POINts? :VERSion?
:SHAPe <shape>{,<shape>}
:POINts? TRIGger
:STEP ONCE | AUTO [:TRANsient | SEQuence1]
:TTLTrg <bool>{,<bool>} [:IMMediate]
PHASe :SOURce BUS | EXTernal | IMMediate
[:IMMediate] <n> DELay <n>
:MODE FIXed | STEP | PULSe | LIST :SYNChronize | :SEQuence2
:TRIGgered <n> :SOURce PHASe | IMMediate
PULSe :PHASe <n>
:COUNt <n> | INFinity :ACQuire | :SEQuence3
:DCYCle <n> [:IMMediate]
:HOLD WIDTh | DCYCle :SOURce BUS | EXTernal | IMMediate
:PERiod <n> :SEQuence1
:WIDTh <n> :DEFine TRANsient
VOLTage :SEQuence2
[:LEVel] :DEFine SYNChronize
[:IMMediate] :SEQuence3
[:AMPLitude] <n> :DEFine ACQuire
:PROTection
DELay <n>
:STATe <bool>
:RANGe
:SENSe
:SOURce INT | EXT
STATus
:OPERation
[:EVENt]?
:CONDition?
:ENABle <n>
:NTRansition <n>
:PTRansition <n>
:PRESet
:QUEStionable
[:EVENt]?
150
Programming Manual - Rev F CS Series AC Current Source
Non-SCPI commands.
CAL:MEAS:CURR OUTP:DFI:SOUR
CAL:MEAS:CURR:SPH OUTP:IMP:REAL
CAL:MEAS:VOLT OUTP:IMP:REAC
CAL:PASS OUTP:RI:MODE
CAL:PHAS OUTP:TTLT:SOUR
CAL:SAVE PONS:CLOC
CAL:VOLT PONS:PEAK:CURR[:PROT]
DIAG:RES PONS:RELAY:HOLD
DIAG:TEMP:AMB [SOUR:]CURR:ALC[:STAT]
LIM:CURR [SOUR:]CURR:SLEW:MODE
LIM:FREQ:HIGH [SOUR:]CURR:SLEW:TRIG
LIM:FREQ:LOW [SOUR:]FREQ:SLEW[:IMM}
LIM:PHAS [SOUR:]FREQ:SLEW:MODE
LIM:VOLT:HIGH [SOUR:]FREQ:SLEW:TRIG
LIM:VOLT:LOW [SOUR:]FREQ:TRIG
MEAS or FETC[:SCAL]:CURR:ACDC? [SOUR:]FUNC[:SHAP]:CSIN
MEAS or FETC[:SCAL]:CURR:HARM[:AMPL]? [SOUR:]FUNC[:SHAP]:MODE
MEAS or FETC[:SCAL]:CURR:HARM:PHAS? [SOUR:]FUNC[:SHAP]:TRIG
MEAS or FETC[:SCAL]:CURR:HARM:THD? [SOUR:]LIST:FREQ:SLEW
MEAS or FETC[:SCAL]:CURR:NEUT[:DC]? [SOUR:]LIST:FREQ:SLEW:POIN?
MEAS or FETC[:SCAL]:CURR:NEUT:AC? [SOUR:]LIST:PHAS
MEAS or FETC[:SCAL]:CURR:NEUT:DC? [SOUR:]LIST:PHAS:POIN?
MEAS or FETC[:SCAL]:CURR:NEUT:ACDC? [SOUR:]LIST:SHAP
MEAS or FETC[:SCAL]:CURR:NEUT:HARM[:AMPL]? [SOUR:]LIST:SHAP:POIN?
MEAS or FETC[:SCAL]:CURR:NEUR:HARM:PHAS? [SOUR:]LIST:STEP
MEAS or FETC[:SCAL]:POW:AC:APP? [SOUR:]LIST:TTLT
MEAS or FETC[:SCAL]:POW:AC:REAC? [SOUR:]LIST:TTLT:POIN?
MEAS or FETC[:SCAL]:POW:AC:PFAC? [SOUR:]LIST:CURR:SLEW
MEAS or FETC[:SCAL]:POW:AC:TOT [SOUR:]LIST:CURR:SLEW:POIN?
MEAS or FETC[:SCAL]:VOLT:ACDC? [SOUR:]PHAS:MODE
MEAS or FETC[:SCAL]:VOLT:AMPL:MAX? [SOUR:]PHAS:TRIG
MEAS or FETC[:SCAL]:VOLT:AMPL:RES [SOUR:]VOLT:PEAK[:IMM]
MEAS or FETC[:SCAL]:VOLT:CRES? [SOUR:]VOLT:PEAK:MODE
MEAS or FETC[:SCAL]:VOLT:HARM[:AMPL]? [SOUR:]VOLT:PEAK:TRIG
MEAS or FETC[:SCAL]:VOLT:HARM:PHAS? [SOUR:]VOLT:SENS[:SOUR]
MEAS or FETC[:SCAL]:VOLT:HARM:THD? SYST:CONF?
MEAS or FETC:ARR:CURR:HARM[:AMPL]? SYST:CONF:NOUT?
MEAS or FETC:ARR:CURR:HARM:PHAS? SYST:ETIM?
MEAS or FETC:ARR:CURR:NEUT[:DC]? SYST:LOC
MEAS or FETC:ARR:CURR:NEUT:HARM[:AMPL]? SYST:REM
MEAS or FETC:ARR:CURR:NEUT:HARM:PHAS? SYST:RWL
MEAS:ARR:MOD SYST:TEMP?
MEAS or FETC:ARR:VOLT:HARM[:AMPL]? TRIG:SEQ2 or SYNC:PHAS
MEAS or FETC:ARR:VOLT:HARM:PHAS? TRIG:SEQ:DEF
MEAS:THD:MODE
OUTP:DFI[:STAT]
152
Programming Manual - Rev F CS Series AC Current Source
The following table lists the errors that are associated with SCPI syntax errors and interface
problems. It also lists the device dependent errors. Information inside the brackets is not part of
the standard error message, but is included for clarification.
Some error messages are maintained for back ward compatibility with Agilent/HP 6834B models.
153
Programming Manual - Rev F CS Series AC Current Source
154
Programming Manual - Rev F CS Series AC Current Source
155
Programming Manual - Rev F CS Series AC Current Source
156
Programming Manual - Rev F CS Series AC Current Source
157
Programming Manual - Rev F CS Series AC Current Source
158
Programming Manual - Rev F CS Series AC Current Source
Index
* D
*CLS ............................................................... 107 DATA ............................................................... 99
*ESE ............................................................... 107 DATA:CATalog .............................................. 100
*ESR? ............................................................. 107 DATA:DEFine ................................................ 100
*IDN? .............................................................. 108 DATA:DELete ................................................ 100
*OPC .............................................................. 108 DATA:DELete:ALL ......................................... 100
*OPT?............................................................. 108
E
*PSC ............................................................... 108
*RCL ............................................................... 109 Ext. Trigger ...................................................... 58
*RST ............................................................... 110
*SAV ............................................................... 111 F
*SRE ............................................................... 111 FETCh:ARRay:CURRent:HARMonic:PHASe? 39
*STB? ............................................................. 111 FETCh:ARRay:CURRent:HARMonic? ............. 39
*TRG .............................................................. 112 FETCh:ARRay:CURRent:NEUTral:HARMonic:P
*TST? ............................................................. 112 HASe? .......................................................... 40
*WAI ............................................................... 113 FETCh:ARRay:CURRent:NEUTral:HARMonic?
A ...................................................................... 40
FETCh:ARRay:CURRent:NEUTral? ................ 39
ABORt ............................................................ 101 FETCh:ARRay:CURRent? ............................... 38
address FETCh:ARRay:VOLTage:HARMonic? ............. 43
IEEE ................................................................ 9 FETCh:ARRay:VOLTage? ............................... 42
FETCh:CURRent:AC? ..................................... 44
B
FETCh:CURRent:ACDC? ................................ 45
block header ............................................... 38, 42 FETCh:CURRent:HARMonic:PHASe? ............ 45
Bus speed FETCh:CURRent:HARMonic:THD?................. 46
delays.......................................................... 134 FETCh:CURRent:HARMonic? ......................... 45
FETCh:CURRent:NEUTral:AC? ...................... 46
C
FETCh:CURRent:NEUTral:ACDC? ................. 46
CALibrate:MEASure:CURRent......................... 32 FETCh:CURRent:NEUTral:HARMonic:PHASe?
CALibrate:MEASure:CURRent:SPHase .......... 32 ...................................................................... 47
CALibrate:MEASure:VOLTage......................... 32 FETCh:CURRent:NEUTral:HARMonic? .......... 47
CALibrate:PASSword ....................................... 33 FETCh:CURRent:NEUTral? ............................ 46
CALibrate:SAVE ............................................... 33 FETCh:CURRent? ........................................... 44
CALibrate[:SOURce]:CURRent ........................ 33 FETCh:FREQuency? ....................................... 49
CALibrate[:SOURce]:PHASe ........................... 33 FETCh:POWer:AC:APParent? ........................ 50
command FETCh:POWer:AC:PFACtor? .......................... 51
subsystem ..................................................... 31 FETCh:POWer:AC:REACtive? ........................ 51
Command FETCh:POWer:AC:TOTal? ............................. 51
delays.......................................................... 134 FETCh:POWer:AC?......................................... 50
commands FETCh:POWer? ............................................... 50
common ........................................................ 14 FETCh:VOLTage :AMPLitude:RESet .............. 53
coupled ......................................................... 15 FETCh:VOLTage :CREStfactor? ..................... 53
Conventions ..................................................... 12 FETCh:VOLTage:AC? ..................................... 52
Copyright ............................................................ 2 FETCh:VOLTage:ACDC? ................................ 52
coupling ............................................................ 15 FETCh:VOLTage:AMPLitude:MAXimum? ....... 53
CURRent .......................................................... 84 FETCh:VOLTage:HARMonic:PHASe? ............ 54
CURRent:ALC[:STATe] .................................... 83 FETCh:VOLTage:HARMonic:THD? ................ 54
CURRent:MODE .............................................. 84 FETCh:VOLTage:HARMonic? ......................... 54
CURRent:SLEW ............................................... 86 FETCh:VOLTage? ........................................... 52
CURRent:SLEW:MODE ................................... 86 firmware
CURRent:SLEW:TRIGgered ............................ 86 updates ................................................... 10, 11
CURRent:TRIGgered ....................................... 84 format
waveform data .............................................. 40
159
Programming Manual - Rev F CS Series AC Current Source
160
Programming Manual - Rev F CS Series AC Current Source
161
Programming Manual - Rev F CS Series AC Current Source
162