Ametek CSW Series Scpi Programming Manual
  1. Manuals
  2. Brands
  3. Ametek Manuals
  4. Portable Generator
  5. CSW Series
  6. Scpi programming manual
Ametek CSW Series Scpi Programming Manual

Ametek CSW Series Scpi Programming Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
CSW Series
SCPI Programming Manual
M162084-03 Rev. D
www.programmablepower.com

Advertisement

Table of Contents
loading

Related Manuals for Ametek CSW Series

Summary of Contents for Ametek CSW Series

  • Page 1 CSW Series SCPI Programming Manual M162084-03 Rev. D www.programmablepower.com...
  • Page 2 AMETEK Programmable Power CSW Series SCPI Programming Manual SCPI Programming Reference Manual CSW series AC/DC Power Systems CSW Series...
  • Page 3 AMETEK Programmable Power About AMETEK AMETEK Programmable Power, Inc., a Division of AMETEK, Inc., is a global leader in the design and manufacture of precision, programmable power supplies for R&D, test and measurement, process control, power bus simulation and power conditioning applications across diverse industrial segments.
  • Page 4 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.
  • Page 5 CSW Series SCPI Programming Manual AMETEK Programmable Power CSW Series...
  • Page 6 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: •...

  • Page 7: Table Of Contents

    CSW Series SCPI Programming Manual AMETEK Programmable Power Table of Contents 1. Introduction ..........................10 Documentation Summary ..................... 10 External References ..................... 10 Introduction to Programming ..................11 2. Introduction to SCPI ......................... 13 Conventions Used in This Manual ................. 13 The SCPI Commands and Messages ................
  • Page 8 AMETEK Programmable Power CSW Series SCPI Programming Manual *PSC ........................... 130 *RCL ........................... 130 *RST ........................... 131 5.10 *SAV ........................... 132 5.11 *SRE ........................... 132 5.12 *STB? ......................... 133 5.13 *TRG .......................... 134 5.14 *WAI ........................... 134 6. Programming Examples ......................135 Introduction .........................
  • Page 9 CSW Series SCPI Programming Manual AMETEK Programmable Power Table of Figures Figure 2-1 : Partial Command Tree ........................14 Figure 2-2: Command Message Structure ......................17 Figure 3-1: DB25 to DB9 Adaptor pinout ......................24 Figure 3-2: Windows XP Device Manager - USB Port ..................28 Figure 3-3: Windows XP Device Manager –...

  • Page 10: Introduction

    User Manual. The programming manual covers issue related to operating the CSW Series remotely using an instrument controller. The following documents are related to this Programming Manual and contain additional helpful information for using these products in a remote control environment.

  • Page 11: Introduction To Programming

    The USB interface may be used to install updated firmware for the controller if needed. Firmware updates and a Flash Loader utility program and instructions are available from the AMETEK Programmable Power website for this purpose. ( www.programmablepower.com Multiple USB connections to same PC: The Windows driver used to interface to the power source’s USB port emulates a serial com...
  • Page 12 The RS232C interface may be used to install updated firmware for the controller if needed. Firmware updates and a Flash Loader utility program and instructions are available from the AMETEK Programmable Power website for this purpose. ( www.programmablepower.com CSW Series...

  • Page 13: Introduction To Scpi

    CSW Series SCPI Programming Manual AMETEK Programmable Power 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.1. The same SCPI commands and parameters control the same functions in different classes of instruments.

  • Page 14: Figure 2-1 : Partial Command Tree

    AMETEK Programmable Power CSW Series SCPI Programming Manual Types of SCPI Messages 2.2.2 There are two types of SCPI messages, program and response. • A program message consists of one or more properly formatted SCPI commands sent from the controller to the AC/DC source. The message, which may be sent at any time, requests the AC/DC source to perform some action.
  • Page 15 CSW Series SCPI Programming Manual AMETEK Programmable Power If you now enter :VOLTage, the active path again moves one colon to the right. The interface is now ready to accept either :RANGe or :LEVel as the next header. If you now enter :RANGe you have reached the end of the command string. The active header path remains at :RANGe If you wished, you could have entered :RANGe 135 ;LEVel...

  • Page 16: Using Queries

    AMETEK Programmable Power CSW Series SCPI Programming Manual Including Common Commands You can combine common commands with system commands in the same message. Treat the common command as a message unit by separating it with a semicolon (the message unit separator). Common commands do not affect the active header path; you may insert them anywhere in the message.

  • Page 17: Figure 2-2: Command Message Structure

    CSW Series SCPI Programming Manual AMETEK Programmable Power Combining Message Units 2.4.2 The following command message is briefly described here, with details in subsequent paragraphs. Figure 2-2: Command Message Structure The basic parts of the above message are: Message Component...
  • Page 18 AMETEK Programmable Power CSW Series SCPI Programming Manual Headers 2.4.3 Headers are instructions recognized by the AC/DC 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 OUTPUT.
  • Page 19 CSW Series SCPI Programming Manual AMETEK Programmable Power Root Specifier 2.4.6 When it precedes the first header of a message unit, the colon becomes the root specifier. It tells the command parser that this is the root or the top node of the command tree. Note the difference between root specifiers and header separators in the following examples: CURRent:PROTection:DELay .1...

  • Page 20: Scpi Data Formats

    AMETEK Programmable Power CSW Series SCPI Programming Manual SCPI Data Formats All data programmed to or returned from the AC source is in ASCII. The data type may be numerical or character string. Numerical Data Formats 2.5.1 Symbol Data Form Talking Formats <NR1>...

  • Page 21: System Considerations And Interface Setup

    Agilent 82350 PCI GPIB Controller using the SICL driver library. Assigning the IEEE-488 Address The AC/DC source address can be set remotely or localy. All CSW Series AC/DC source are shipped with the IEEE-488 address set to 1 from the factory. Once the address is set, you can assign it inside programs.
  • Page 22 AMETEK Programmable Power CSW Series SCPI Programming Manual If there is no error-handling code in your program, undetected errors can cause unpredictable results. This includes "hanging up" the controller and forcing you to reset the system. Both of the above libraries have routines for detecting program execution errors.

  • Page 23: Rs232C Interface

    3.3.1 The following sample program written in GW-BASIC can be used to check communication to the CSW Series source over the RS232C serial interface. 'California Instruments CSW Series RS232C Communication Demo Program '(c) 1995-2002 Copyright California Instruments, All Rights Reserved...

  • Page 24: Figure 3-1: Db25 To Db9 Adaptor Pinout

    AMETEK Programmable Power CSW Series SCPI Programming Manual Serial Cable Diagram 3.3.2 All CSW units without LAN have a RS232 interface. The RS232 cable must be of the “Null Modem” type, straight through. Refer to the CSW User Manual, M162084-01, for additional cable information.

  • Page 25: Usb Interface

    CSW Series SCPI Programming Manual AMETEK Programmable Power USB Interface A standard USB Series B device connector is located on the rear panel for remote control. A standard USB cable between the AC Source and a PC or USB Hub may be used. Refer to user manual M162084-01 for connector pin out information.
  • Page 26 AMETEK Programmable Power CSW Series SCPI Programming Manual 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. CSW Series...
  • Page 27 CSW Series SCPI Programming Manual AMETEK Programmable Power The next dialog will ask you to install the software for the CSW AC Source. Select the “Install the software automatically (Recommended)” option and click on Next to continue. If you are prompted for a file path, browse to the CD root drive and then USB_Inf (eg.

  • Page 28: Figure 3-2: Windows Xp Device Manager - Usb Port

    AMETEK Programmable Power CSW Series SCPI Programming Manual 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.
  • Page 29 CSW Series SCPI Programming Manual AMETEK Programmable Power Step 2: USB to Com Virtual Device Driver installation The second step allows installation of the USB to COM virtual port driver. This driver will allow access to the AC source USB interface using a virtual COM port. Many programming environments support RS232 access but not USB.
  • Page 30 AMETEK Programmable Power CSW Series SCPI Programming Manual The next dialog will ask you to install the software for the CSW AC Source. Select the “Install the software automatically (Recommended)” option and click on Next to continue. If you are prompted for a file path, browse to the CD root drive and then USB_Inf (eg.
  • Page 31 CSW Series SCPI Programming Manual AMETEK Programmable Power CSW Series...

  • Page 32: Figure 3-3: Windows Xp Device Manager - Virtual Com Port

    AMETEK Programmable Power CSW Series SCPI Programming Manual 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.

  • Page 33: Figure 3-4: Gui Interface Settings For Use Of Usb Port

    CSW Series SCPI Programming Manual AMETEK Programmable Power USB Interface Use 3.4.2 Note that the power source will be detected automatically when turn on or plugged in once the drivers have been installed. It is recommended however to close any open USB connections to the AC source before turning it off.

  • Page 34: Lan Interface Option

    CSW Series SCPI Programming Manual LAN Interface Option An Ethernet LAN interface option is available as an option for the CSW Series power sources. This option must be specified at the time of order. A –LAN option indicator will appear on the model number tag at the rear-panel of the power source to indicate the presence of this option.
  • Page 35 CSW Series SCPI Programming Manual AMETEK Programmable Power Use the “Locate IP” button on the interface configuration screen to bring up the IP configuration utility screen. To determine what IP address was assigned, select the “Get IP Address from MAC Address in the Configuration selection.

  • Page 36: Figure 3-5: Pinging Ac Source Lan Ip Address

    AMETEK Programmable Power CSW Series SCPI Programming Manual Socket Port Number 3.5.3 Now that a connection has been verified, you can develop your application code. If you are using one of the Microsoft environments, the Winsock protocol which is part of the Windows operating system can be used.

  • Page 37: Scpi Command Reference

    CSW Series SCPI Programming Manual AMETEK Programmable Power SCPI Command Reference Introduction 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.

  • Page 38: Calibration Subsystem

    AMETEK Programmable Power CSW Series SCPI Programming Manual Calibration Subsystem The commands in this subsystem allow you to do the following: • Enable and disable the calibration mode • CALibration the measured current and voltage. • CALibration the current and voltage output levels.
  • Page 39 CSW Series SCPI Programming Manual AMETEK Programmable Power :LRANge [:FSCale] CALibration full-scale output dc voltage at low voltage range. :ZERO Trim output dc voltage offset at low voltage range. :HRANge [:FSCale] CALibration full-scale output dc voltage at high voltage range. (positive DC) :ZERO Trim output dc voltage offset at high voltage range.
  • Page 40 AMETEK Programmable Power CSW Series SCPI Programming Manual Password CALibration:PASSword This command allows the entry of the calibration password. The calibration password is required to use the data entry form of the calibration commands. Without the use of this password, only the query form can be used to query any calibration coefficient but no new calibration can be performed.
  • Page 41 CSW Series SCPI Programming Manual AMETEK Programmable Power Current Measurement 4.2.2 CALibration:MEASure:CURRent[:AC][:FSCale] <NRf> This command initiates the calibration of the AC current measurement at full scale. Command Syntax CALibration:MEASure:CURRent[:AC][:FSCale] Parameters <NRf> (actual load current measured with external device) Examples CAL:MEAS:CURR 11.5...
  • Page 42 AMETEK Programmable Power CSW Series SCPI Programming Manual External Signal Input 4.2.4 CALibration:MEASure:EXTernal[:FSCale] <NRf> This command intitiates the calibration of the converter used to measure the level of the External Signal input. The numberical value to be entered, NRf, is the expected output output voltage of the power source with the respective External Input signal.
  • Page 43 4.2.5 CALibration:PHASe <NRf+> The CSW Series AC/DC power source controller can be operated using its internal timebase reference, an external clock or in external sync mode. (See FREQ:MODE command on page 75. When using in external clock or sync mode, it may be desirable to shift the phase output with respect to the external reference.
  • Page 44 AMETEK Programmable Power CSW Series SCPI Programming Manual Output - AC Voltage 4.2.7 CALibration[:SOURce]:VOLTage[:AC][:HRANge][:FSCale] <NRf+> This command will result in the calibration coefficent being calculated for the AC full scale output voltage at the high voltage range. Command Syntax CALibration:VOLTage:HRANge <NRf>...
  • Page 45 CSW Series SCPI Programming Manual AMETEK Programmable Power CALibration[:SOURce]:VOLTage:HFRrequency This query command retrieves the harmonic calibration coefficients for the IEC413 option. This query returns a comma-separated list of seven calibration coefficients. These coefficients can only be set by performing a voltage measurement calibration.

  • Page 46: Display Subsystem

    The display on the CSW Series has a maximum capacity of 8 x 40 ASCII characters, both lower and upper case. The application program is responsible for formatting each line. No padding or length checking is performed by the power source firmware.
  • Page 47 CSW Series SCPI Programming Manual AMETEK Programmable Power DISPlay:TEXT This command sets the character string that is displayed when the display mode is set to TEXT. The argument is a quoted string limited to upper case alpha characters and numbers.

  • Page 48: Instrument Subsystem

    AMETEK Programmable Power CSW Series SCPI Programming Manual Instrument Subsystem The Instrument subsystem controls the phase mode of the AC/DC power source for configurations capable of operating in three phase mode. Subsystem Syntax INSTrument COUPle ALL | NONE Couples or uncouples commands...
  • Page 49 CSW Series SCPI Programming Manual AMETEK Programmable Power INSTrument:SELect This command may be used select a specific output phase in three-phase mode using a character reference. “A” denotes phase A, “B” denotes phase B and “C” denotes Phase C. As long as the instrument state is coupled however, programming command will affect all phases.

  • Page 50: Array Measurement Subsystem

    AMETEK Programmable Power CSW Series SCPI Programming Manual Array Measurement Subsystem This command subsystem lets you retrieve arrays containing measurement data. Only current and voltage measurements are stored in an array. Two measurement commands are available: MEASure and FETCh. A MEASure command triggers the acquisition of new data before returning the readings from the array.
  • Page 51 CSW Series SCPI Programming Manual AMETEK Programmable Power Current Array Data 4.5.1 MEASure:ARRay:CURRent[:DC]? FETCh:ARRay:CURRent[:DC]? 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>...
  • Page 52 AMETEK Programmable Power CSW Series SCPI Programming Manual Query Syntax MEASure:ARRay:CURRent:HARMonic[:AMPLitude]? [<nrf>] FETCh:ARRay:CURRent:HARMonic[:AMPLitude]? Parameters None Examples MEAS:ARR:CURR:HARM? FETC:ARR:CURR:HARM? 20 Returned Parameters 21 NR2 values Related Commands INST:NSEL MEASure:ARRay:CURRent:HARMonic:PHASe? [<nrf>] FETCh:ARRay:CURRent:HARMonic:PHASe? [<nrf>] 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.
  • Page 53 CSW Series SCPI Programming Manual AMETEK Programmable Power Waveform Array Data Format Mode 4.5.2 MEASure:ARRay:MODe This command selects the waveform array data format to be used. (Available in firmware revision 2.32 or higher only.) 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.
  • Page 54 AMETEK Programmable Power CSW Series SCPI Programming Manual c(i) = 0 For j = 0 To 1 iChar = AscB(Mid$(sData, i * 2 + j + 1, 1)) - 48 If iChar > 9 Then iChar = iChar - 7...
  • Page 55 CSW Series SCPI Programming Manual AMETEK Programmable Power Voltage Array Data 4.5.3 MEASure:ARRay:VOLTage[:DC]? FETCh:ARRay:VOLTage[:DC]? 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>...
  • Page 56 AMETEK Programmable Power CSW Series SCPI Programming Manual These queries return an array of harmonic phases of output voltage in degrees, referenced to the positive zero crossing of the fundamental component. The fundamental component will return a value relative to the fundamental voltage for phase A. Phase A will return a zero value.

  • Page 57: Current Measurement Subsystem

    CSW Series SCPI Programming Manual AMETEK Programmable Power Current Measurement Subsystem This subsystem programs the current measurement capability of the AC/DC source. Two measurement commands are available: MEASure and FETCh. • MEASure triggers the acquisition of new measurement data before returning a reading.
  • Page 58 AMETEK Programmable Power CSW Series SCPI Programming Manual MEASure:CURRent:DC? FETCh:CURRent:DC? Phase Selectable These queries return the dc component of the output current being sourced at the output terminals. This command should be used when the voltage mode of the source is set for DC...
  • Page 59 CSW Series SCPI Programming Manual AMETEK Programmable Power MEASure:CURRent:CREStfactor? FETCh:CURRent:CREStfactor? Phase Selectable These queries return the output current crest factor. This is the ratio of peak output current to rms output current. Query Syntax MEASure[:SCALar]:CURRent:CREStfactor? FETCh[:SCALar]:CURRent:CREStfactor? Parameters None Examples MEAS:CURR:CRES?
  • Page 60 AMETEK Programmable Power CSW Series SCPI Programming Manual MEASure:CURRent:HARMonic:PHASe? [3Pi Controller Only] FETCh:CURRent:HARMonic:PHASe? [3Pi Controller Only] 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.

  • Page 61: Frequency Measurement Subsystem

    CSW Series SCPI Programming Manual AMETEK Programmable Power Frequency Measurement Subsystem This subsystem programs the frequency measurement capability of the CSW Series source. Subsystem Syntax MEASure [:SCALar] :FREQuency? Returns the output frequency MEASure:FREQuency? This query returns the output frequency in Hertz.

  • Page 62: Phase Measurement Subsystem

    AMETEK Programmable Power CSW Series SCPI Programming Manual Phase Measurement Subsystem This subsystem programs the voltage phase measurement capability of the CSW Series source. Subsystem Syntax MEASure | FETCh [:SCALar] :PHASe? Returns the output voltage phase angle for the selected phase.

  • Page 63: Power Measurement Subsystem

    CSW Series SCPI Programming Manual AMETEK Programmable Power Power Measurement Subsystem This subsystem programs the power measurement capability of the CSW Series source. Subsystem Syntax MEASure | FETCh [:SCALar] :POWer [:AC] [:REAL]? Returns real power :APParent? Returns VA PFACtor? Returns power factor...
  • Page 64 AMETEK Programmable Power CSW Series SCPI Programming Manual MEASure:POWer:AC:PFACtor? FETCh:POWer[:AC]:PFACtor? Phase Selectable This query returns the output power factor. The power factor is computed as: power factor = real power / apparent power Query Syntax MEASure[:SCALar]:POWer[:AC]:PFACtor? Parameters None Examples MEAS:POW:PFAC? Returned Parameters <NR2>...

  • Page 65: Voltage Measurement Subsystem

    AMETEK Programmable Power Voltage Measurement Subsystem 4.10 This subsystem programs the voltage measurement capability of the CSW Series. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data.
  • Page 66 AMETEK Programmable Power CSW Series SCPI Programming Manual MEASure:VOLTage:HARMonic? [3Pi Controller Only] FETCh:VOLTage:HARMonic? [3Pi Controller Only] 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.
  • Page 67 CSW Series SCPI Programming Manual AMETEK Programmable Power MEASure:VOLTage:HARMonic:THD? [3Pi Controller Only] FETCh:VOLTage:HARMonic:THD? [3Pi Controller Only] Phase Selectable These queries return the percentage of total harmonic distortion and noise in the output voltage. Query Syntax MEASure[:SCALar]:VOLTage:HARMonic:THD? FETCh[:SCALar]:VOLTage:HARMonic:THD? Parameters None Examples...

  • Page 68: Output Subsystem

    AMETEK Programmable Power CSW Series SCPI Programming Manual Output Subsystem 4.11 This subsystem controls the main outputs, the signal outputs and the output impedance [-3Pi models only] of the AC/DC source. Subsystem Syntax OUTPut [:STATe] <bool> Enable/disable output voltage, current, power, etc.
  • Page 69 CSW Series SCPI Programming Manual AMETEK Programmable Power OUTPut:IMMediate This command opens the output relay without first programming the voltage down if the – SNK option is installed and the CSW is in REGENERATIVE mode (REG:STAT ON). If not, this commands works exactly the same as the OUTP[:STAT] command. This mode may be used to simulate line loss in inverter applications.
  • Page 70 AMETEK Programmable Power CSW Series SCPI Programming Manual 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.
  • Page 71 CSW Series SCPI Programming Manual AMETEK Programmable Power External Trigger Output 4.11.5 OUTPut:TTLTrg:MODE This command sets the operation of the Trigger Out signal to either Function Strobe or Trigger mode. The factory default is Trigger state which means the OUTP:TTLT:STAT command is required to generate outputs.
  • Page 72 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax OUTPut:TTLTrg:SOURce<source> Parameters BOT|EOT|LIST *RST Value Examples OUTP:TTLT:SOUR LIST Query Syntax OUTPut:TTLTrg:SOURce? Returned Parameters <CRD> Related Commands OUTP:TTLT CSW Series...

  • Page 73: Source Subsystem - Current

    CSW Series SCPI Programming Manual AMETEK Programmable Power Source Subsystem - Current 4.12 This subsystem programs the output current of the CSW Series source. Subsystem Syntax [SOURce:] CURRent [:LEVel] [:IMMediate] [:AMPLitude] <n> Sets the rms current limit :PROTection :STATe <bool>...
  • Page 74 AMETEK Programmable Power CSW Series SCPI Programming Manual CURRent:PROTection:STATe This command selects overcurrent (OC) protection mode. If the overcurrent protection function is enabled and the load current exceeds the programmed level, then the output is disabled after a time delay specified by the CURRent:PROTection:DELay and the Questionable Condition status register OC bit is set (see chapter 7).

  • Page 75: Source Subsystem - Frequency

    CSW Series SCPI Programming Manual AMETEK Programmable Power Source Subsystem - Frequency 4.13 This subsystem programs the output frequency of the AC/DC source. Subsystem Syntax [SOURce:] FREQuency :IMMediate] <n> Sets the frequency :MODE <mode> Sets frequency mode (FIX|STEP|PULS|LIST|SENS|EXT) :SLEW [:IMMediate] <n> | MAXimum Sets the frequency slew rate :MODE <mode>...
  • Page 76 AMETEK Programmable Power CSW Series SCPI Programming Manual 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. Command Syntax [SOURce:]FREQuency:SLEW[:IMMediate] <NRf+> Parameters 0.01 to 1E9MAXimum...
  • Page 77 CSW Series SCPI Programming Manual AMETEK Programmable Power FREQuency: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. Command Syntax [SOURce:]FREQuency:SLEW:TRIGgered <NRf+> Parameters 0.01 to 1E9MAXimum...

  • Page 78: Source Subsystem - Function

    AMETEK Programmable Power CSW Series SCPI Programming Manual Source Subsystem - Function 4.14 This subsystem programs the output function of the AC/DC source. Subsystem Syntax [SOURce:] FUNCtion [:SHAPe] [:IMMediate] <shape> Sets the periodic waveform shape (SIN|SQU|CSIN|<user-defined>) :MODE <mode> Sets the waveform shape mode (FIX|LIST) :CSINe <n>...
  • Page 79 CSW Series SCPI Programming Manual AMETEK Programmable Power FUNCtion:MODE Phase selectable 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. LIST The waveform shape is controlled by the waveform shape list when a triggered transient occurs.

  • Page 80: Source Subsystem - Limit

    AC voltage ranges of the CSW Series. The first paremeter represents the 156 V range value, the second the 312 V range. Note that the equivalent DC range values are not returned, even in the CSW unit is in DC mode.
  • Page 81 CSW Series SCPI Programming Manual AMETEK Programmable Power LIMit:PHASe This command will configure the power source controller for the number of output phases. A value of zero will configure the source as a single-phase unit. A value of 120° will configure the power source controller as a three phase unit with a 120°...

  • Page 82: Sense Subsystem - Sweep

    AMETEK Programmable Power CSW Series SCPI Programming Manual Sense Subsystem - Sweep 4.16 This subsystem controls the measurement current range, the data acquire sequence, and the harmonic measurement window of the AC source. Subsystem Syntax SENSe :SWEep :OFFSet <n> Define trigger points relative to the start of...
  • Page 83 CSW Series SCPI Programming Manual AMETEK Programmable Power SENSe:SWEep:TINTerval This command and its query format allow setting the time period between samples when voltage and current digitization is controlled by the acquire trigger sequence. The query response of the sample period query will be: 10.4 to 104 µsec for single phase and 31.2 to 312 µsec for three phase AC/DC source...

  • Page 84: Source Subsystem - List

    AMETEK Programmable Power CSW Series SCPI Programming Manual Source Subsystem - List 4.17 This subsystem controls the generation of complex sequences of output changes with rapid, precise timing and synchronized with internal or external signals. Each subsystem command for which lists can be generated has an associated list of values that specify the output at each list step.
  • Page 85 CSW Series SCPI Programming Manual AMETEK Programmable Power List - Count 4.17.1 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. Command Syntax [SOURce:]LIST:COUNt<NRf+>...
  • Page 86 AMETEK Programmable Power CSW Series SCPI Programming Manual List - Frequency 4.17.3 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.
  • Page 87 CSW Series SCPI Programming Manual AMETEK Programmable Power List:Waveform Function 4.17.4 LIST:FUNCtion[:SHAPe] Phase Selectable 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.
  • Page 88 AMETEK Programmable Power CSW Series SCPI Programming Manual List - Repeat 4.17.5 LIST:REPeat[:COUNt] This command sets the sequence of repeat values for each data list point. The repeat values 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 repeated when a list is triggered.
  • Page 89 CSW Series SCPI Programming Manual AMETEK Programmable Power List:TTL Trigger Out 4.17.7 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 (Function strobe signal on the system interface) when that list step is reached.
  • Page 90 AMETEK Programmable Power CSW Series SCPI Programming Manual List:Voltage 4.17.8 LIST:VOLTage Phase Selectable This command specifies the output voltage points in a list. The voltage 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.
  • Page 91 CSW Series SCPI Programming Manual AMETEK Programmable Power LIST:VOLTage:SLEW:POINts? Phase Selectable This query returns the number of points specified in LIST:VOLTage:SLEW. Note that it returns only the total number of points, not the point values. Query Syntax [SOURce:]LIST:VOLTage:SLEW:POINts? Returned Parameters <NR1>...

  • Page 92: Source Subsystem - Mode

    The MODE command allows switching between the different output modes available on the AC/DC power source. The CSW Series with a –1 or –3 provides either AC or DC mode while the CSW Series with a –1Pi or –3Pi adds AC+DC mode as well. When switching modes, the output is automatically set to zero to prevent hot switching of the output.

  • Page 93: Source Subsystem - Phase

    CSW Series SCPI Programming Manual AMETEK Programmable Power Source Subsystem - Phase 4.19 This subsystem programs the output phase angle of the AC/DC source. When the phase command is used to program a single-phase unit, the only discernible effect is to cause an instantaneous shift in the output waveform phase relative to an external reference signal.

  • Page 94: Source Subsystem - Ponsetup

    AMETEK Programmable Power CSW Series SCPI Programming Manual Source Subsystem - PONSetup 4.20 This subsystem will control the initial condition of the power source at the power on state. Subsystem syntax [SOURce:] PONSetup: ALControl 0|1|OFF|ON Set initial ALC state. CLOCk INT|EXT Set the the clock source to internal or external CURRent <n>...
  • Page 95 CSW Series SCPI Programming Manual AMETEK Programmable Power PONSetup:CURRent This command sets the initial current limit at the power on. The maximum allowable current is controlled by the voltage range and voltage mode. Command Syntax [SOURce:]PONSetup:CURRent <NRf+> Parameters range set by the LIMit:CURRent, voltage mode and voltage range...
  • Page 96 AMETEK Programmable Power CSW Series SCPI Programming Manual PONSetup:OUTPut[:RELay] This command sets the initial state of the output relay at the power on. Command Syntax [SOURce:]PONSetup:OUTPut[:RELay <boolean> Parameters 0|1|OFF|ON Examples OUTP ON OUTP 0 Query Syntax PONS:OUTP? Returned Parameters 0 | 1 PONSetup:PHASe[:ANGLe] This command sets the initial phase angle of the power source relative to external reference.
  • Page 97 CSW Series SCPI Programming Manual AMETEK Programmable Power PONSetup:VOLTage:MODE This command sets the initial voltage mode at the power on. This mode is DC or AC Command Syntax [SOURce:]PONSetup: VOLTage:MODE Parameters AC | DC | ACDC [ACDC on 3Pi Controller Only]...

  • Page 98: Source Subsystem - Pulse

    AMETEK Programmable Power CSW Series SCPI Programming Manual Source Subsystem - Pulse 4.21 This subsystem controls the generation of output pulses. The PULSe:DCYCle, PULSe:PERiod, and PULSe:WIDTh commands are coupled, which means that the values programmed by any one of these commands can be affected by the settings of the others.

  • Page 99: Table 4-1 : Pulse:hold = Width Parameters

    CSW Series SCPI Programming Manual AMETEK Programmable Power Parameter Set Action DCYCle PERiod WIDTh √ Sets WIDTh. If WIDTh < PERiod, recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle. √ Sets PERiod. If WIDTh < PERiod, recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle.
  • Page 100 AMETEK Programmable Power CSW Series SCPI Programming Manual PULSe:WIDTh This command sets the width of a transient output pulse.The command parameters are model-dependent. Command Syntax [SOURce:]PULSe:WIDTh<NRf+> Parameters 1 msecs to 90,000 secs |MINimum|MAXimum Unit S (seconds) *RST Value 0.5 secs Examples PULS:WIDT 0.001PULS:WIDT MIN...

  • Page 101: Source Subsystem - Voltage

    CSW Series SCPI Programming Manual AMETEK Programmable Power Source Subsystem - Voltage 4.22 This subsystem programs the output voltage of the AC/DC power source. Subsystem Syntax [SOURce:] VOLTage :ALC ON | OFF | REG Sets Automatic Level Control mode [:LEVel] [:IMMediate] [:AMPLitude] <n>...
  • Page 102 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax [SOURce:]VOLTage:ALC <bool> Parameters 0 | OFF | 1 | ON | 2 | REG Unit V/S (volts per second) *RST Value Examples VOLT:ALC 1 Query Syntax [SOURce:]VOLTage:ALC? Returned Parameters 0 | 1 | 2...
  • Page 103 CSW Series SCPI Programming Manual AMETEK Programmable Power VOLTage Phase Selectable This command programs the AC rms, DC or offset output voltage level of the power source. The voltage mode must be set for AC to accept an AC voltage. The Voltage mode must also be set to AC+DC to accept a DC offset value.
  • Page 104 <CRD> Related Commands VOLT:TRG VOLT VOLTage:RANGe[:LEVel] This command sets the voltage range of the power source. On the CSW Series, there are two voltage ranges available: • 156 V AC or DC range • 312 V AC or DC range The LIM:VOLT? Query may be used to determine which AC or DC voltage ranges are available to select.
  • Page 105 CSW Series SCPI Programming Manual AMETEK Programmable Power Command Syntax [SOURce:]VOLTage:RANGe[:LEVel] <NRf+> Parameters 156 | 312| *RST Value Defined by the PONSetup:RANGe Examples VOLT:RANG 156 Query Syntax [SOURce:]VOLTage:RANGe? Returned Parameters <NR2> Related Commands LIM:VOLT? VOLTage:REFerence This command sets the initial voltage reference source at the power on.
  • Page 106 AMETEK Programmable Power CSW Series SCPI Programming Manual VOLTage:SLEW:MODE Phase Selectable This command determines how the output voltage slew rate is controlled during a triggered output transient. The choices are: FIXed The slew rate is unaffected by a triggered output transient.

  • Page 107: Status Subsystem Commands

    CSW Series SCPI Programming Manual AMETEK Programmable Power Status Subsystem Commands 4.23 This subsystem programs the AC/DC power source status registers. There are four groups of status registers; • Operation Status Group • Questionable Status Group • Questionable Instrument Isummary Group •...
  • Page 108 AMETEK Programmable Power CSW Series SCPI Programming Manual STATus:OPERation:EVENt? This query returns the value of the Operation Event register. The Event register is a read- only register, which holds (latches) all events. Reading the Operation Event register clears it. Query Syntax...
  • Page 109 CSW Series SCPI Programming Manual AMETEK Programmable Power Bit Configuration of Questionable Registers Bit Position 13-15 10-11 Bit Name not used not used not used used used Bit Weight 4096 over or under voltage protection has tripped over-current protection has tripped...
  • Page 110 AMETEK Programmable Power CSW Series SCPI Programming Manual 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.

  • Page 111: System Commands

    CSW Series SCPI Programming Manual AMETEK Programmable Power System Commands 4.24 The system commands control the system-level functions of the AC/DC Source. Subsystem Syntax SYSTem :ERRor? Returns the error number and error string :VERSion? Returns the SCPI version number :LOCal...
  • Page 112 AMETEK Programmable Power CSW Series SCPI Programming Manual Query Syntax SYSTem:VERSion? Parameters None Returned Paramters <NR2> Example SYST:VERS? 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.
  • Page 113 CSW Series SCPI Programming Manual AMETEK Programmable Power SYSTem:CONFigure:NOUTput Sets the mode configuration of the power source to single-phase or a three-phase mode. The MODE option must be enabled for this command to work. If MODE option is not available, the query response will be FIX.
  • Page 114 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax SYSTem:COMMunicate:LAN:ADDRess <NRF> Parameters ddd.ddd.ddd.ddd <IP address> Example SYST:COMM:LAN:ADDR 255.255.167.2 Query Syntax SYST:COMM:LAN:ADDR? SYST:COMM:LAN:ADDR? NCON Returned Parameters <CRD> 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.
  • Page 115 CSW Series SCPI Programming Manual AMETEK Programmable Power 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.
  • Page 116 AMETEK Programmable Power CSW Series SCPI Programming Manual SYSTem:COMMunicate:SERial:BAUD This command will set the SERial communication baud rate. Command Syntax SYSTem:COMMunicate:SERial:BAUD <NRF> Parameters 1200 | 2400 | 4800 | 9600 | 38400 | 57600 | 115200 Example SYST:COMM:SER:BAUD 9600 Returned Parameters <NR1>...

  • Page 117: Trace Subsystem Commands

    CSW Series SCPI Programming Manual AMETEK Programmable Power Trace Subsystem Commands 4.25 This subsystem programs the output waveform of the AC/DC power source. Subsystem Syntax TRACe :CATalog? Return list of defined waveforms [:DATA] <waveform_name>, <n> , <n> Assign values to a waveform :DEFine <waveform_name>[, <waveform_name>|1024]...
  • Page 118 AMETEK Programmable Power CSW Series SCPI Programming Manual TRACe: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? Returned Parameters <SRD>...

  • Page 119: Trigger Subsystem

    CSW Series SCPI Programming Manual AMETEK Programmable Power Trigger Subsystem 4.26 This subsystem controls the triggering of the AC/DC power source. See chapter 6 under "Triggering Output Changes" for an explanation of the Trigger Subsystem. The INITiate commands control the initialization of the transient system. The trigger subsystem must first be enabled using the INITiate commands or no triggering action will occur.
  • Page 120 AMETEK Programmable Power CSW Series SCPI Programming Manual INITiate[:IMMediate][:TRANsient] The INITiate command controls the initiation of the transient generation or measurement acquisition trigger system. 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.
  • Page 121 CSW Series SCPI Programming Manual AMETEK Programmable Power TRIGger[:TRANSient]:SOURce This command will determine the source of the trigger event for the transient. The following sources are available: • IMMediate Triggering occurs as soon as the INIT command is received. •...
  • Page 122 AMETEK Programmable Power CSW Series SCPI Programming Manual TRIGger:ACQuire:SOURce [3Pi Controller Only] These commands select the trigger source for a triggered measurement sequence as follows: IMMediate Acquire the measurements immediate. The FETCh commands return the requested calculation from the set of acquired data as soon as the measurement calculations are completed by the controller.
  • Page 123 CSW Series SCPI Programming Manual AMETEK Programmable Power TRIG:STATe? This is a query only command. The response will define the state of the transient trigger system as follows: • IDLE The trigger is in the idle state. • The trigger is waiting for internal syncronization or external trigger •...

  • Page 124: Common Commands

    AMETEK Programmable Power CSW Series SCPI Programming Manual 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.

  • Page 125: Cls

    CSW Series SCPI Programming Manual AMETEK Programmable Power *CLS This command clears the following registers (see chapter 7 for descriptions of all status registers): • Standard Event Status • Operation Status Event • Questionable Status Event • Status Byte •...

  • Page 126: Ese

    AMETEK Programmable Power CSW Series SCPI Programming Manual *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.

  • Page 127: Idn

    CSW Series SCPI Programming Manual AMETEK Programmable Power *IDN? This query requests the 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 xxxxxx Model number and letter...

  • Page 128: Opt

    The parameter list returned and their order in the sequence is shown in the table below. Syntax Description Comment SCPI SCPI language This feature is always enabled on CSW Series models. NOUT MODE option Phase mode selection. Available only on CSW30/CSW45-3Pi systems.
  • Page 129 CSW Series SCPI Programming Manual AMETEK Programmable Power CSW Series...

  • Page 130: Psc

    AMETEK Programmable Power CSW Series SCPI Programming Manual *PSC 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 7.6.2 for register details): *PSC ON | 1 Prevents the register contents from being saved causing them to be cleared at power-on.

  • Page 131: Rst

    CSW Series SCPI Programming Manual AMETEK Programmable Power *RST The reset (*RST) command has the same effect as an IEEE-488 Device Clear bus command but can be used over the RS232C interface as well. This command resets the AC source to the following factory-defined states:...

  • Page 132: Sav

    AMETEK Programmable Power CSW Series SCPI Programming Manual *SAV 5.10 This command stores the present state of the AC/DC power source to a specified location in memory. Up to 8 states (including the transient list) can be stored in nonvolatile memory.

  • Page 133: Stb

    CSW Series SCPI Programming Manual AMETEK Programmable Power *STB? 5.12 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 for more information).

  • Page 134: Trg

    AMETEK Programmable Power CSW Series SCPI Programming Manual *TRG 5.13 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 effect as the Group Execute Trigger (<GET>) command.

  • Page 135: Programming Examples

    CSW Series SCPI Programming Manual AMETEK Programmable Power Programming Examples Introduction This chapter contains examples on how to program the AC/DC source. Simple examples show you how to program: • Output functions such as voltage, frequency, and phase • The transient waveform generator •...

  • Page 136: Programming The Output

    AMETEK Programmable Power CSW Series SCPI Programming Manual Programming the Output Power-on Initialization 6.2.1 When the AC source is first turned on, it wakes up with the output state defined by the PONSetup. In this state the output voltage is set to a value defined by the INIT:VOLT. The...
  • Page 137 CSW Series SCPI Programming Manual AMETEK Programmable Power Voltage Ranges The power source has two voltage ranges that are controlled by relays. The command that controls the range is: VOLTage:RANGe MIN | MAX | 156 | 312 When the range is set to MIN (156), the maximum rms voltage that can be programmed for a sine wave is 156 volts rms, but it is only on this range that the maximum output current rating is available.
  • Page 138 AMETEK Programmable Power CSW Series SCPI Programming Manual Programming the Output Phase 6.2.5 You can control the phase of the AC voltage waveform relative to an external reference with: PHASe <n> which sets the phase in degrees. If <n> is positive, the voltage waveform leads the internal reference or phase A value in three phase configuration.
  • Page 139 CSW Series SCPI Programming Manual AMETEK Programmable Power Waveform Shapes 6.2.7 At *RST, the AC/DC power source generates a sine waveform when in AC or AC+DC mode, but other shapes can be selected. There are built-in tables for sine, square and clipped sine waveforms.
  • Page 140 AMETEK Programmable Power CSW Series SCPI Programming Manual Individual Phases 6.2.8 On three phase models or configurations, the following functions can be controlled separately on each phase: • VOLTage • CURRent • PHASe • FUNCtion • MEASure • FETCh •...

  • Page 141: Coupled Commands

    CSW Series SCPI Programming Manual AMETEK Programmable Power Coupled Commands This section describes how to avoid programming errors that may be caused by the error checking done for coupled commands such as VOLTage:LEVel. Commands that are coupled to the VOLTage command are the output transient commands that control step, pulse and list generation.

  • Page 142: Programming Output Transients

    AMETEK Programmable Power CSW Series SCPI Programming Manual Programming Output Transients Output transients are used to: • Synchronize output changes with a particular phase of the voltage waveform. • Synchronize output changes with internal or external trigger signals. • Simulate surge, sag, and dropout conditions with precise control of duration and phase.

  • Page 143: Figure 6-1: Output Transient System

    CSW Series SCPI Programming Manual AMETEK Programmable Power Transient System Model 6.4.1 Figure 6-1 shows a model of the transient system. The figure shows the transient modes and the output waveform that is generated in each mode. When a trigger is received in step or pulse modes, the triggered functions are set from their IMMediate to their TRIGgered value.
  • Page 144 AMETEK Programmable Power CSW Series SCPI Programming Manual Step and Pulse Transients 6.4.2 Step 1 : Set the functions that you do not want to generate transients to FIXed mode. A convenient way to do this is with the *RST command. Then set the mode of the function that will generate the transient to STEP or PULSe as required.
  • Page 145 CSW Series SCPI Programming Manual AMETEK Programmable Power List Transients 6.4.3 List mode lets you generate complex sequences of output changes with rapid, precise timing, which may be synchronized with internal or external signals. Each function that can participate in output transients can also have an associated list of values that specify its output at each list point.
  • Page 146 AMETEK Programmable Power CSW Series SCPI Programming Manual LIST:VOLTage 120, 100, 110 LIST:FREQuency 60, 60, 60 Step 3 : Determine the time interval that the output remains at each level or point in the list before it advances to the next point. The time is specified in seconds. For example, to specify five dwell intervals, use: LIST:DWELl 1, 3.5, 1.5, 0.5, 3.8, 1.2...

  • Page 147: Triggering Output Changes

    CSW Series SCPI Programming Manual AMETEK Programmable Power Triggering Output Changes The following transient trigger sources can be selected: IMMediate Generates a trigger when the trigger system is initiated. Selects IEEE-488 bus triggers. Trigger System Model 6.5.1 Figure 6-2 is a model of the trigger system. The rectangular boxes represent states. The arrows show the transitions between states.
  • Page 148 AMETEK Programmable Power CSW Series SCPI Programming Manual Initiating the Output Trigger System 6.5.2 When the source is turned on, the trigger subsystem is in the idle state. In this state, the trigger subsystem ignores all triggers. Sending the following commands at any time returns...
  • Page 149 CSW Series SCPI Programming Manual AMETEK Programmable Power Generating Triggers 6.5.4 Providing that you have specified the appropriate trigger source, you can generate triggers as follows: Single Triggers By sending one of the following over the IEEE-488: • INIT •...

  • Page 150: Acquiring Measurement Data

    AMETEK Programmable Power CSW Series SCPI Programming Manual Acquiring Measurement Data The source has the capability to return a number of current, voltage, and power measurements. When the AC source is turned on, it is continuously sampling the instantaneous output voltage and current for several output cycles and writing the results into a buffer.
  • Page 151 CSW Series SCPI Programming Manual AMETEK Programmable Power Voltage and Current Measurements 6.6.1 To the rms voltage or current, use: MEASure:VOLTage?or MEASure:CURRent? To measure the dc voltage or current, use: MEASure:VOLTage:DC?or MEASure:CURRent:DC? To measure the maximum current amplitude and the current crest factor, use:...
  • Page 152 AMETEK Programmable Power CSW Series SCPI Programming Manual Harmonic Measurements 6.6.4 The MEASure and FETCh queries can return the amplitude and phase of up to the 50th harmonic of voltage and current. They can also return the total harmonic distortion in the output voltage or current.
  • Page 153 CSW Series SCPI Programming Manual AMETEK Programmable Power Simultaneous Output Phase Measurements 6.6.5 You can return simultaneous measurements from all output phases of the source in the three phase mode using the FETCh query. Unlike MEASure queries, FETCh queries do not trigger the acquisition of new data when they are executed.

  • Page 154: Figure 6-3: Measurement Acquisition Trigger Model

    AMETEK Programmable Power CSW Series SCPI Programming Manual Measurement Trigger System Model 6.6.8 Figure 6-3 is a model of the measurement trigger system. The rectangular boxes represent states. The arrows show the transitions between states. These are labeled with the input or event that causes the transition to occur.
  • Page 155 CSW Series SCPI Programming Manual AMETEK Programmable Power Selecting the Measurement Trigger Source 6.6.10 The trigger system is waiting for a trigger signal in the Initiated state. Before you generate a trigger, you must select a trigger source. To select the SYNC Trigger to start the...

  • Page 156: Controlling The Instantaneous Voltage And Current Data Buffers

    AMETEK Programmable Power CSW Series SCPI Programming Manual Controlling the Instantaneous Voltage and Current Data Buffers Measurements taken by the AC/DC power source are based on a digital representation of the voltage and current waveforms. Both waveforms are digitized with 18 bits of amplitude resolution and 25.6 µsec of time resolution.

  • Page 157: Figure 6-4: Pre-Event And Post-Event Triggering

    CSW Series SCPI Programming Manual AMETEK Programmable Power Pre-event and Post-event Triggering 6.7.2 The range for this offset is: -42.6 msec to 1000 msec in single-phase mode or –128 msec to 1000 msec in three-phase mode (at the highest available sample rates).

  • Page 158: Trigger System Summary

    AMETEK Programmable Power CSW Series SCPI Programming Manual Trigger System Summary Figure 6-5 shows a functional block diagram of the AC/DC source’s trigger system. If both trigger systems are initiated at the same time, the Acquisition trigger system will respond to the first trigger generated while the transient trigger system will respond to the second trigger.

  • Page 159: Status Registers

    CSW Series SCPI Programming Manual AMETEK Programmable Power Status Registers You can use status register programming to determine the operating condition of the AC source at any time. For example, you may program the AC source to generate an interrupt (assert SRQ) when an event such as a current limit occurs.

  • Page 160: Figure 7-1: Status System Model

    AMETEK Programmable Power CSW Series SCPI Programming Manual QUESTIONABLE STATUS CONDITION EVENT ENABLE ø3 ø2 ø1 u.n. TEMP n.u. n.u. 1024 1024 n.u. 1024 2048 2048 n.u. 2048 4096 4096 CL rms 4096 8192 8192 8192 n.u. 14,15 Isum QUESTIONABLE INSTRUMENT ISUMMARY...

  • Page 161: Table 7-2: Configuration Of Status Register

    CSW Series SCPI Programming Manual AMETEK Programmable Power Signal Meaning Operation Status Group Interface complete its calibration cycle TRANS Transient is completed MEAS Measurement is completed Questionable and Questionable Instrument Isummary Status Groups Output voltage faulted, output voltage differ from program...

  • Page 162: Questionable Status Group

    AMETEK Programmable Power CSW Series SCPI Programming Manual Questionable Status Group The Questionable Status registers record signals that indicate abnormal operation of the AC source. As shown in Figure 7-1, the group consists of the same type of registers as the Status Operation group.

  • Page 163: Standard Event Status Group

    CSW Series SCPI Programming Manual AMETEK Programmable Power Standard Event Status Group This group consists of an Event register and an Enable register that are programmed by Common commands. The Standard Event register latches events relating to the interface communication status (see Figure 7-1). It is a read-only register that is cleared when read.

  • Page 164: Examples

    AMETEK Programmable Power CSW Series SCPI Programming Manual Examples The following section contains examples of commonly used operations involving the status registers. Determining the Cause of a Service Interrupt 7.6.1 You can determine the reason for an SRQ by the following actions: Step 1 : Determine which summary bits are active.Use...

  • Page 165: Scpi Command Completion

    CSW Series SCPI Programming Manual AMETEK Programmable Power SCPI Command Completion SCPI commands sent to the AC source are processed either sequentially or in parallel. Sequential commands finish execution before a subsequent command begins. Parallel commands allow other commands to begin executing while the parallel command is still executing.

  • Page 166: Option Commands

    Option Commands Introduction The CSW Series offers a number of options that are implemented in the power source controller. If one or more of these options are installed, they may be used from both the front panel and the interface. For front panel operation of any of these firmware options, consult the User Manual supplied with the unit.

  • Page 167: Iec 1000-4-11 (-411)

    CSW Series SCPI Programming Manual AMETEK Programmable Power IEC 1000-4-11 (-411) The following are the remote commands set for IEC1000-4-11. The ABORt command will terminate a test in progress at any time. Test completion can be checked using the *OPC? query if the *OPC 1 command is issued immediately after an IEC1000-4-11 command.
  • Page 168 AMETEK Programmable Power CSW Series SCPI Programming Manual IEC411:DIPS:RUN[:ALL] This command will cause the automated test sequence by the standard to run. Refer to Table 13 in the User Manual. Command Syntax IEC411:DIPS:RUN[:ALL] Parameters <none> Examples IEC411:DIPS:RUN Query Syntax none Returned Parameters <none>...
  • Page 169 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC411:DIPS:ANGLe This command sets the start phase angle for the dips. Command Syntax IEC411:DIPS:ANGLe Parameters <numeric> Examples IEC411:DIPS:ANGL 90 Query Syntax IEC411:DIPS:ANGL? Returned Parameters <NR2> IEC411:STATe This command will enable the IEC411 option and initialize the associated data.
  • Page 170 AMETEK Programmable Power CSW Series SCPI Programming Manual IEC411:VARiants:HOLD:TIME This command will set the variant hold time in seconds. Refer to Figure 9-13 in the User Manual. Command Syntax IEC411:VARiants: HOLD:TIME <NRf> Parameters <seconds> Examples IEC411:VAR: HOLD:TIME 0.5 Query Syntax...

  • Page 171: Iec 1000-4-13 (-413)

    CSW Series SCPI Programming Manual AMETEK Programmable Power IEC 1000-4-13 (-413) IEC 1000-4-13 Subsystem 8.3.1 The following are the remote commands set for IEC1000-4-13. The ABORt command will terminate the test in progress at any time. Test completion can be checked using the *OPC? query if the *OPC 1 command is issued immediately after an IEC1000-4-13 RUN command.
  • Page 172 AMETEK Programmable Power CSW Series SCPI Programming Manual :PAUSe Set harmonics pause. :TABle Select Individual harmonic table 1,2,3 or ALL. :IHARmonics :LEVel Set interharmonics level. :DWELl Set interharmonics dwell. :PAUSe Set interharmonics pause. IEC413:STATe This command will enable the IEC413 and initialize the associated data. Note that user defined test levels for the USER group can only be programmed when the IEC413 state is OFF.
  • Page 173 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC413:INDVidual:HARMonics[:NUMBer] This command is used to set the desired harmonic number when the IEC413:RUN POINt is used. Command Syntax IEC413:INDVidual:HARMonics[:NUMBer] ] <NRf> Parameters 2 to 40 Examples IEC413:INDV:HARM 3 Query Syntax IEC413:INDV:HARM? Returned Parameters <NR1>...
  • Page 174 AMETEK Programmable Power CSW Series SCPI Programming Manual IEC413:GROup This command is used to select the group. If RUN:GROUp is used, the test will run for only the selected group. Command Syntax IEC413:GROup <group> Parameters FCURve|OSWing|SWEep|HARMonics|IHARmonics | MCURve Examples IEC413:GRO:SWE...
  • Page 175 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC413:MCURve:LEVel This command will set the levels for the meister curve test. The class must be set prior to this command. The IEC413:STATe must be in the off position and the user class must be selected to accept the command.
  • Page 176 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax IEC413:FCURve:PAUSe <NRf+> Parameters Examples IEC413:FCURve:PAUS 2 Query Syntax IEC413:FCURve:PAUS? Returned Parameters <NR1> IEC413:OSWing:LEVel This command will set the level for the ‘over swing’ harmonics combination test. The command has two parameters, one for the third and one for the fifth order harmonic. The IEC413:STATe must be in the off position and the user class must be selected to accept the command.
  • Page 177 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC413:SWEep:LEVel This command will set the level for the harmonics sweep test. The command will accept either one parameter or five parameters. In case of one parameter, the level will be set for the selected range only.
  • Page 178 AMETEK Programmable Power CSW Series SCPI Programming Manual IEC413:SWEep:CURRent:RESonant? This command will return the measured harmonic resonant current. This data is available after the sweep is completed. If no resonant current is found, the command will return a null char.
  • Page 179 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC413:HARMonics:TABle This command allows selection of only one of the Individual harmonics tables of the IEC 61000-4-13 standard. Default is to run all tables but some EUT’s for class 3 may require only Table 1 to be run.
  • Page 180 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax IEC413: IHARmonics:DWELl <NRf+> Parameters <seconds> Examples IEC413:IHAR:DWEL 15 Query Syntax IEC413:IHAR:DWEL? Returned Parameters <NR1> CSW Series...
  • Page 181 CSW Series SCPI Programming Manual AMETEK Programmable Power IEC413:IHARmonics:PAUSe This command will set the pause time in seconds between each interharmonics frequency. The class must be selected prior to this command. Query with min and max to find the range of the pause time.
  • Page 182 AMETEK Programmable Power CSW Series SCPI Programming Manual Interharmonics Subsystem 8.3.2 The following commands are used to enable and generate an interharmonic waveform up to 20% of the programmed voltage value. [:SOURce] :IHARmonics [:STATe] Enable or disable the interharmonics generator.
  • Page 183 CSW Series SCPI Programming Manual AMETEK Programmable Power [:SOURce]:IHARmonics:REFerence This command will program the inter harmonic reference voltage. The coupling must be set to on to accept any program value. The reference will take a value of 0 to 250V.

  • Page 184: Rtca/Do-160D (-160)

    AMETEK Programmable Power CSW Series SCPI Programming Manual RTCA/DO-160D (-160) The -160 option is implemented through the CSWGui Windows software provided with each AC power source. As such, there are no SCPI commands that apply to the -160 option and they cannot be executed from the front panel or using any SCPI bus commands.

  • Page 185: Mil-Std 704E (-704)

    CSW Series SCPI Programming Manual AMETEK Programmable Power MIL-STD 704E (-704) The -704 option is implemented through the CSWGui Windows software provided with each AC power source. As such, there are no SCPI commands that apply to the -704 option and they cannot be executed from the front panel or using any SCPI bus commands.
  • Page 186 AMETEK Programmable Power CSW Series SCPI Programming Manual Command Syntax WHMeter[:STATe]<bool> Parameters 0 | OFF | 1 | ON Examples WHM ON Query Syntax WHM[:STATe]? Returned Parameters 0 | 1 WHMeter:ETIMe? This command will return the total amount of time the watt-hour meter has accumulated.

  • Page 187: Appendix A: Scpi Command Tree

    The following command three contains all the supported standard commands for the CSW Series AC/DC source. Some command listed may not apply to a specific CSW Series model or controller version. Check the relevant reference section for specific details on using each of these commands.
  • Page 188 AMETEK Programmable Power CSW Series SCPI Programming Manual ..........ZERO ........HRANGe ..........[FSCale] ..........[POSitive] ..........NEGative ..........ZERO INITiate ..[IMMediate] ....[TRANsient] ....ACQuire ..CONTinuous ON | OFF INSTrument ..COUPle ALL | NONE ..NSELect 1 | 2 | 3 ..SELect A | B | C MEASure | FETCh ..ARRAY...
  • Page 189 CSW Series SCPI Programming Manual AMETEK Programmable Power ........THD? OUTPut ..[STATe] <bool> ..IMMediate <bool> ..PROT:PROT:CLE ..RI ....[:LEVel] HIGH | LOW ....:MODE LATC | LIVE | OFF ..TTLTrg ..
  • Page 190 AMETEK Programmable Power CSW Series SCPI Programming Manual ......POINts? ....REPeat ......[COUNt] <n>,<n> ......POINts? ....STEP ONCE|AUTO ....TTLTrg <bool>,<bool> ......POINts? ....VOLTage ......[LEVel] <n>,<n> ........POINts? ......SLEW <n>,<n> ........POINts ..MODE ..PHASe ....[IMMediate] <n> ..PONSetup ....ALControl 0|1|OFF|ON ....CLOCk INT | EXT ....CURRent <n> ....FREQuency <n>...
  • Page 191 CSW Series SCPI Programming Manual AMETEK Programmable Power ......[IMMediate] <n> | MAXimum ......MODE <mode> ......TRIGgered ........[AMPLitude] <n> | MAXimum STATus ..OPERation ....EVENt ....CONDition ..
  • Page 192 AMETEK Programmable Power CSW Series SCPI Programming Manual Note: Available option SCPI commands are not listed in this table. See option section for details on specific installed options and their relevant SCPI commands. CSW Series...

  • Page 193: Appendix B: Scpi Conformance Information

    CSW Series SCPI Programming Manual AMETEK Programmable Power Appendix B: SCPI Conformance Information SCPI Version The CSW Series AC/DC power sources conform to SCPI version 1995.0. CSW Series...

  • Page 194: Appendix C: Error Messages

    AMETEK Programmable Power CSW Series SCPI Programming Manual Appendix C: Error Messages Any errors that occur during operation from either the front panel or the remote control interface will result in error messages. Error messages are displayed in the upper left hand corner of the LCD display.
  • Page 195 CSW Series SCPI Programming Manual AMETEK Programmable Power Number Message String Cause Remedy -168 "Block data not Block data was sent. Check programming manual for allowed" correct command syntax -200 "Execution error" Command could not Command may be inconsistent with...
  • Page 196 AMETEK Programmable Power CSW Series SCPI Programming Manual Number Message String Cause Remedy -300 "Device specific error" Possible causes are: Check for proper mode or command sequence operation. 1. Attempt to program a frequency while source is in DC mode.
  • Page 197 CSW Series SCPI Programming Manual AMETEK Programmable Power Number Message String Cause Remedy empty. -400 "Query error" Unable to complete Check programming manual for query. correct query format and parameters -410 "Query Query issued but Check application program for correct INTERRUPTED"...
  • Page 198 AMETEK Programmable Power CSW Series SCPI Programming Manual Number Message String Cause Remedy "Missing list One or more transient Check programmed lists. parameter" list parameters missing. "Voltage peak error " Peak voltage exceeds This error may occur when selecting internal bus voltage user defined wave shapes with higher crest factors.

  • Page 199: Table 8-4 : Error Messages

    CSW Series SCPI Programming Manual AMETEK Programmable Power Number Message String Cause Remedy allowable range. programmable controller. “Phase error” Incorrect phase “DC component The waveform Select AC+DC mode. exceeds limit” selected contains a DC offset that exceeds the AC mode capability.

  • Page 200: Index

    AMETEK Programmable Power CSW Series SCPI Programming Manual Index *CLS ............................125 *ESE ............................126 *ESR? ............................126 *IDN? ............................127 *OPC ............................127 *OPT? ............................128 *PSC ............................130 *RCL ............................130 *RST ............................131 *SAV ............................132 *SRE ............................132 *STB? ............................
  • Page 201 CSW Series SCPI Programming Manual AMETEK Programmable Power CALibrate[:SOURce]:VOLTage[:AC]:HRANge[:FSCale] <NRf+> ............ 44 CALibrate[:SOURce]:VOLTage[:AC]:LRANge[:FSCale] <NRf+> ............. 43 command subsystem ..........................37 commands common ............................. 16 Conventions ........................... 13 CURRent ............................73 CURRent:PROTection:STATe......................74 DISPlay:LOCation .......................... 47 DISPlay:MODE ..........................46 DISPlay:STATe ..........................46 DISPlay:TEXT ..........................
  • Page 202 AMETEK Programmable Power CSW Series SCPI Programming Manual Function Strobe ..........................71 FUNCtion:CSINe ........................... 79 FUNCtion:MODE ........................... 79 GPIB controllers ..........................21 header optional ............................. 18 separator ........................... 18 Header ............................14 optional ............................. 15 IEC411:STATe ..........................169 IEC413: IHARmonics:DWELl ......................180 IEC413: IHARmonics:PAUSe .......................
  • Page 203 CSW Series SCPI Programming Manual AMETEK Programmable Power connector ........................... 34 MAC Address ..........................34 LAN Option IP address ..........................34 Port number ..........................36 LIMit:CURRent ..........................80 LIMit:FREQuency ........................... 80 LIMit:PHASe ..........................81 LIMit:VOLTage ..........................80 LIST:COUNt........................... 85 LIST:DWELl ........................... 85 LIST:DWELl:POINts? ........................
  • Page 204 AMETEK Programmable Power CSW Series SCPI Programming Manual MEASure:VOLTage:HARMonic:THD? ................... 67 MEASure:VOLTage:HARMonic? ....................66 MEASure:VOLTage? ........................65 MODE ............................92 National Instruments PCI-GPIB ........................... 21 Option -411 ............................167 -413 ............................171 -A350 ............................185 -ABD ............................185 -AMD ............................185 -B787 ............................
  • Page 205 CSW Series SCPI Programming Manual AMETEK Programmable Power SCPI .............................. 13 message ............................ 14 program message ........................14 response message ........................14 SENSe:SWEep:OFFSet:POINts ..................... 82 SENSe:SWEep:TINTerval ......................83 Separator ............................18 STATus:OPERation:CONDition? ....................108 STATus:OPERation:ENABle ......................108 STATus:OPERation:EVENt? ......................108 STATus:QUEStionable:CONDition? .....................
  • Page 206 AMETEK Programmable Power CSW Series SCPI Programming Manual connector ........................... 25 User Manual ..........................10 VB sample waveform conversion ......................... 53 VOLTage ............................103 VOLTage:ALC ..........................101 VOLTage:MODE .......................... 104 VOLTage:RANGe ......................... 104 VOLTage:SENSe[:SOURce] ......................105 VOLTage:SLEW ........................... 105 VOLTage:SLEW:MODE ....................... 106 VOLTage:SLEW:TRIGgered ......................

Table of Contents