Kepco KLR Series Developers Guide Manuel d'utilisateur Page 1

KEPCO® THE POWER SUPPLIER™MODEL DEVELOPER’S GUIDEORDER NO. REV. NO.KEPCO, INC. ! 131-38 SANFORD AVENUE ! FLUSHING, NY. 11355 U.S.A. ! TEL (718)

A-4 KLR-DEV 060713A.9 *OPT? — OPERATION COMPLETE QUERY *OPT?Syntax: *OPT?Return value: option string which is a comma separated list250 LST,.01 TMIN,

KLR-DEV 060713 A-5FIGURE A-1. GPIB COMMANDSA.13 *SRE — SERVICE REQUEST ENABLE COMMAND *SRESyntax: *SRE <integer> where <integer> =

A-6 KLR-DEV 060713A.14 *SRE? — SERVICE REQUEST ENABLE QUERY *SRE?Syntax: *SRE? Response: <integer> = value from 0 - 255 per Table A-3.Descripti

KLR-DEV 060713 B-1APPENDIX B - SCPI COMMAND/QUERY DEFINITIONSB.1 INTRODUCTIONThis appendix defines the SCPI subsystem commands and queries used with

B-2 KLR-DEV 060713B.2 NUMERICAL VALUESThe SCPI data parser on the KLR supports a maximum of 8 digits after the decimal point and a maximum inte-ger of

KLR-DEV 060713 B-3FIGURE B-1. PROGRAMMING THE OUTPUTB.7 INITiate:CONTinuous COMMAND INIT:CONTSyntax: Short Form: INIT:CONT {ON | OFF} or {1 | 0} (

B-4 KLR-DEV 060713B.8 INITiate:CONTinuous QUERY INIT:CONT?Syntax: Short Form: INIT:CONT? Long Form: INITiate:CONTinuous?Return Value: 1 or 0 (1 = on,

KLR-DEV 060713 B-5B.16 [SOURce:]LIST:COUNt:SKIP? QUERY LIST:COUN:SKIP?Syntax: Short Form: LIST:COUN:SKIP? Long Form: LIST:COUNt:SKIP?Return Value: &l

B-6 KLR-DEV 060713B.23 [SOURce:]LIST:DWELl? QUERY LIST:DWEL?Syntax: Short Form: LIST:DWEL? Long Form: LIST:DWELl?Return Value: <value> Descrip

KLR-DEV 060713 B-7B.29 [SOURce:]LIST:VOLTage:POINts? QUERY LIST:VOLT:POIN?Syntax: Short Form: LIST:VOLT:POIN? Long Form: LIST:VOLTage:POINts?Return

KLR-DEV 060713 1-1SECTION 1 - INTRODUCTIONThis manual contains instructions for digital programming of the KLR series of 1200W outputpower, stabilize

B-8 KLR-DEV 060713FIGURE B-2. USING LIST COMMANDS AND QUERIESB.34 OUTPut[:STATe] COMMAND OUTPSyntax: Short Form: OUTP[:STAT] {ON | OFF} or {1 | 0}

KLR-DEV 060713 B-9B.35 OUTPut[:STATe]? QUERY OUTP?Syntax: Short Form: OUTP[:STAT]? Long Form: OUTPut[:STATe]?Return Value: <int_value> (1 or 0)

B-10 KLR-DEV 060713FIGURE B-3. PROGRAMMING LIMIT MODELSB.39 [SOURce:]CURRent:LIMit:HIGH? QUERY CURR:LIM:HIGH?Syntax: Short Form: [SOUR:]CURR:LIM:

KLR-DEV 060713 B-11B.42 [SOURce:]CURRent:PROTection[:LEVel] COMMAND CURR:PROTSyntax: Short Form: [SOUR:]CURR:PROT[:LEV] <exp_value> Long Form:

B-12 KLR-DEV 060713B.43 [SOURce:]CURRent:PROTection[:LEVel]? QUERY CURR:PROT?Syntax: Short Form: [SOUR:]CURR:PROT[:LEV]? {MIN | MAX}Long Form: [SOURc

KLR-DEV 060713 B-13B.49 [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude]? QUERY VOLT?Syntax: Short Form: [SOUR:]VOLT[:LEV][:IMM][:AMPL]? {MIN | MAX}

B-14 KLR-DEV 060713B.52 [SOURce:]VOLTage:MODE COMMAND VOLT:MODESyntax: Short Form: [SOUR:]VOLT:MODE (FIX | LIST | TRAN,<n>,<VLong Form: [SOU

KLR-DEV 060713 B-15B.56 [SOURce:]VOLTage:[LEVel:]TRIGgered[:AMPLitude] COMMAND VOLT:TRIGSyntax: Short Form: [SOUR:]VOLT:[LEV:]TRIG[:AMPL] <exp_va

B-16 KLR-DEV 060713B.58 STATus:OPERation:CONDition? QUERY STAT:OPER:COND?Syntax: Short Form: STAT:OPER:COND? Long Form: STATus:OPERation:CONDition?R

KLR-DEV 060713 B-17FIGURE B-6. USING STATUS COMMANDS AND QUERIESB.63 STATus:QUEStionable[:EVENt]? QUERY STAT:QUES?Syntax: Short Form: STAT:QUES[E

1-2 KLR-DEV 060713LabView G driver also uses VISA calls, allowing it to work on all ports of the KLR. The examplesgiven in Programming, Section 6, PA

B-18 KLR-DEV 060713B.64 STATus:QUEStionable:CONDition? QUERY STAT:QUES:COND?Syntax: Short Form: STAT:QUES:COND? Long Form: STATus:QUEStionable:CONDi

KLR-DEV 060713 B-19B.70 SYSTem:COMMunication:LAN:AUTO? QUERY SYST:COMM:LAN:AUTO?[E-SERIES MODELS ONLY]Syntax: Short Form: SYST:COMM:LAN:AUTO? Long F

B-20 KLR-DEV 060713B.77 SYSTem:COMMunication:LAN:IP COMMAND SYST:COMM:LAN:IP[E-SERIES MODELS ONLY]Syntax: Short Form: SYST:COMM:LAN:IP {w,x,y,z}Long

KLR-DEV 060713 B-21B.84 SYSTem:COMMunication:SERial:ECHO COMMAND SYST:COMM:SER:ECHO[STANDARD MODELS ONLY]Syntax: Short Form: SYST:COMM:SER:ECHO {1 |

B-22 KLR-DEV 060713B.91 SYSTem:COMMunication:SERial:PROMpt? QUERY SYST:COMM:SER:PROM?[STANDARD MODELS ONLY]Syntax: Short Form: SYST:COMM:SER:PROM?Lo

KLR-DEV 060713 B-23B.96 SYSTem:KLOCk? QUERY SYST:KLOC?Syntax: Short Form: SYST:KLOC? Long Form: SYSTem:KLOCk?Return Value: 0 or 1 (1 = on, locked,

B-24 KLR-DEV 060713B.99 SYSTem:PASSword:CENable COMMAND SYST:PASS:CENSyntax: Short Form: SYST:PASS:CEN <val> Long Form: SYSTem:PASSword:CENabl

KLR-DEV 060713 B-25KL0 Enables front panel controls.KL1 Disables front panel controls.L250 Number (250) of locations programmable using LIST commands

B-26 KLR-DEV 060713-123,”Exponent too large” Command Error bit 5 Exponent E+3 or greater is invalid.-141,”Invalid character data” Command Error bit 5

KLR-DEV 060713 1-31.2.1 INITIALIZATIONWhen an instrument is first accessed, it is desirable to have it start at a standard state and toverify that th

1-4 KLR-DEV 060713NOTES: 1. When programming sequential voltage levels, it is important to set the Overvoltageto accommodate the highest voltage of t

KLR-DEV 060713 1-5For example, if an overvoltage error is detected, bit 0 of the Questionable Status Condition reg-ister is set. The 0 to 1 transitio

1-6 KLR-DEV 060713When the service request is executed, the STB register bits are read: bit 3 set indicates Ques-tionable Status; bit 2 set indicates

KLR-DEV 060713 1-7• 4 - Execution Error — 1 indicates execution error has occurred (parameter exceededallowable range) (see Appendix B, Table B-5 for

1-8 KLR-DEV 060713A bit set in the Questionable Condition register indicates that the data currently being acquiredor generated is of questionable qu

KLR-DEV 060713 2-1SECTION 2 - COMMUNICATION2.1 INTRODUCTIONFigure 2-1 shows all paths used to communicate with the KLR. These include local control fr

2-2 KLR-DEV 0607132.3 DIGITAL CONTROL VIA LAN [E-SERIES MODELS ONLY]Figure 2-1 shows all the ports available to the LAN interface. These port are desc

KLR-DEV 060713 2-3• Port 5025 - SCPI Raw. This port supports up to two connections. The SCPI-Raw portprovides faster access than the VXI-11 port (1024

2-4 KLR-DEV 060713NOTE: Kepco strongly recommends the XON XOFF method for data transfer via RS 232 proto-col for all Kepco products. If this method is

KLR-DEV 060713 3-1SECTION 3 - IVI-COM DRIVER3.1 INTRODUCTIONThe IVI-COM (Interchangeable Virtual Instrument) driver provided with the instrument allow

3-2 KLR-DEV 0607133.1.4 CONTEXT-SENSITIVE HELP The driver includes both HTML 1.x and HTML 2.0 help files which document the following driverelements:

KLR-DEV 060713 3-3TABLE 3-1. KLR IVI-COM DRIVER FUNCTIONS Function Name PurposeInitializationKpDCPwr_init Initialize Power supply, create session han

3-4 KLR-DEV 0607133.3 EXAMPLES USING CThe examples illustrated in the following paragraphs are installed in the ivi\drivers\kepco\exam-ples folder dur

KLR-DEV 060713 3-5/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This program demonstrates how to set a voltage and current and measure the outpu

3-6 KLR-DEV 060713The setting of voltage and current is then very simple.// set voltagehr = outputPtr->VoltageLevel(75.0);if (FAILED(hr))exit(1);//

KLR-DEV 060713 3-7FIGURE 3-1. EXAMPLE OF SETTING THE OUTPUT AND TAKING A MEASUREMENT, WRITTEN IN C++ (SHEET 2 OF 2)// open the instrument for commu

KLR DEVGD 020498 iTABLE OF CONTENTSSECTION PAGESECTION 1 - INTRODUCTION1.1 General Description ...

3-8 KLR-DEV 0607133.3.2 USING A LIST TO PERFORM A SERIES OF OPERATIONSThe filename for this example is Clistexample.txt, located in the ivi\drivers\ke

KLR-DEV 060713 3-9currList[4] = 2;currList[5] = 2;dwellTime[0] = 1;dwellTime[1] = 2;dwellTime[2] = 3;dwellTime[3] = 4;dwellTime[4] = 5;dwellTime[5] =

3-10 KLR-DEV 060713FIGURE 3-2. EXAMPLE OF USING A LIST, WRITTEN IN C# (SHEET 2 OF 2)// Initialize driver KLRdriver.Initialize("GPIB0::6::INSTR

KLR-DEV 060713 3-113.3.3 SETTING LIMIT MODELThis example is a series of files found on the CD in the ivi\drivers\kepcodcpwr\example\cviVirtual directo

3-12 KLR-DEV 060713The functions above used a function checkErr which is part of the project file KpDCPwrEr-rorHandler.c. This file has calls to two f

KLR-DEV 060713 3-13Using the pointers it becomes very easy to set voltage and current. Each parameter is simplyloaded with the value to be set using i

3-14 KLR-DEV 060713 FIGURE 3-3. SETTING THE OUTPUT AND TAKING A MEASUREMENT EXAMPLE, WRITTEN IN VISUAL BASIC (SHEET 1 OF 2)'/*~~~~~~~~~

KLR-DEV 060713 3-15FIGURE 3-3. SETTING THE OUTPUT AND TAKING A MEASUREMENT EXAMPLE, WRITTEN IN VISUAL BASIC (SHEET 2 OF 2)3.4.2 USING A LIST TO PER

3-16 KLR-DEV 060713FIGURE 3-4. EXAMPLE OF USING A LIST, WRITTEN IN VISUAL BASIC (SHEET 2 OF 2)3.4.3 SETTING LIMIT MODELThe filename for this exampl

KLR-DEV 060713 3-17FIGURE 3-5. SETTING LIMIT MODEL, WRITTEN IN VISUAL BASIC3.5 EXAMPLES USING LABVIEWThese LabView examples show the use of the IVI

ii KLR DEVGD 060713TABLE OF CONTENTSSECTION PAGE4.5 Example of Setting the Output ...

3-18 KLR-DEV 0607133.5.1 SETTING THE OUTPUT TO A VALUEFigure 3-6 illustrates the use of the IVI-COM driver with LabView to set the KLR output to avalu

KLR-DEV 060713 3-19/(3-20 Blank)FIGURE 3-7. MEASURING VOLTAGE AND CURRENT USING LABVIEW WITH IVI-COM DRIVER3.5.3 CHANGING THE LIMIT MODELThe limit

KLR-DEV 060713 4-1SECTION 4 - LABVIEW G DRIVER4.1 INTRODUCTIONThe LabView G driver can be used for remote programming over all ports of the KLR (Seri

4-2 KLR-DEV 060713TABLE 4-1. KLR LABVIEW G DRIVER FUNCTIONS Function Name PurposeKepcoDCPWR initialize with options Makes Visa Connection. Creates Op

KLR-DEV 060713 4-34.4 USING THE DRIVER FUNCTIONS The interactive example uses various driver functions of the LabView G driver. The following twoparag

4-4 KLR-DEV 0607134.4.1.3 BLOCK DIAGRAM DESCRIPTIONFigure 4-2 shows that the level input is converted to a string that is compatible with the powersup

KLR-DEV 060713 4-5FIGURE 4-2. KepcoDCPwr Configure Voltage Level.vi BLOCK DIAGRAMFigure 4-3 shows that when the error is true (not equal to zero),

4-6 KLR-DEV 060713Figure 4-5 is a block diagram which shows the method used by the VI to perform the simulatedcurrent measurement. The query MEAS:CURR

KLR-DEV 060713 4-74.5.1 INITIALIZATION FUNCTIONThe initialization function use three subvi’s:• KepcoDCPWR initialize - Initializes the driver.• KepcoD

KLR DEVGD 020498 iiiTABLE OF CONTENTSSECTION PAGESECTION 7 - IEEE 488.2 (GPIB) INTERFACE7.2 IEEE 488 (GPIB) Bus Protocol ...

4-8 KLR-DEV 060713The third subVi is KepcoDCPWR Configure Voltage Mode. This block sets the mode to Fixed. Itis recommended that the mode be set to Fi

KLR-DEV 060713 4-94.5.2 SET THE OUTPUT ON OR OFFThe following three functions are all that are required to set a voltage, current and change theoutput

4-10 KLR-DEV 0607134.6 INTERACTIVE DEMONSTRATION PROGRAMThe interactive demo program allows the user to operate the power supply and provides sam-ples

KLR-DEV 060713 4-11NOTE: When accessed via TCP/IP the four buttons at the bottom of the panel (SoftwareRamp, Programmed List, Function Generator and A

4-12 KLR-DEV 0607134.6.2 SOFTWARE TIMED RAMP EXAMPLEWhen the Software Ramp button on the front panel is depressed, the panel shown in Figure 4-8is dis

KLR-DEV 060713 4-13The four boxes labeled Start (beginning of ramp), End (end of ramp), Voltage Increment [or Cur-rent Increment] (determines the size

4-14 KLR-DEV 0607134.6.3 SOFTWARE TIMED RAMP EXECUTIONClicking the Start Ramp button on the Software Ramp panel (Figure 4-8) causes the RampFunction P

KLR-DEV 060713 4-154.6.4 FUNCTION GENERATOR (Supported in Standalone Configurations Only)NOTE: Complex, dynamic waveshapes typically require a power s

4-16 KLR-DEV 060713FIGURE 4-10. FUNCTION GENERATOR PANELFIGURE 4-11. CONFIGURE User Sequence.vi BLOCK DIAGRAM

FIGURE 4-12RAM

iv KLR DEVGD 060713TABLE OF CONTENTSSECTION PAGEB.13 [SOURce:]LIST:COUNt Command...

FIGURE 4-13. FUNCTION GEBLOCK DIAGR

KLR-DEV 060713 5-1SECTION 5 - VXI plug&play DRIVER5.1 INTRODUCTIONThe VXI plug&play driver can be used with all KLR models for remote progra

5-2 KLR-DEV 060713Measure Current and Voltage Output ValuesKpklr_MeasVoltCurr Measures the values of output (voltage and current).SETTING AND MONITOR

KLR-DEV 060713 5-35.4 USING THE VXI plug&play DRIVER The example programs are provided to illustrate how to operate the KLR via a remote interfac

5-4 KLR-DEV 060713FIGURE 5-1. EXAMPLE 1: SETTING VOLTAGE AND CURRENT #include <formatio.h>#include <visa.h>#include "kp_KLR.h&quo

KLR-DEV 060713 5-55.4.2 EXAMPLE 2: USING THE POWER SUPPLY TO CREATE A VOLTAGE RAMPA ramp is created by sending a series of points to the power supply

5-6 KLR-DEV 060713FIGURE 5-2. EXAMPLE 2: USING THE POWER SUPPLY TO CREATE A VOLTAGE RAMP (SHEET 2 OF 2)Kpklr_Set_Volt_Curr (KLR_Session, voltage,

KLR-DEV 060713 5-75.4.3 EXAMPLE 3: USING THE POWER SUPPLY TO TAKE MEASUREMENTSFigure 5-3 is an example of using the power supply to take measurements

KLR DEVGD 020498 vTABLE OF CONTENTSSECTION PAGEB.71 SYSTem:COMMunication:LAN:DHCP Command ...

5-8 KLR-DEV 060713FIGURE 5-3. EXAMPLE 2: USING THE POWER SUPPLY TO TAKE MEASUREMENTS (SHEET 2 OF 2)/* function Set_powersupplySets power supply to

KLR-DEV 060713 5-95.5 DEMONSTRATION PROGRAM USING THE VXI PLUG&PLAY DRIVERThe demonstration program is intended to illustrate the use of the VXI

5-10 KLR-DEV 060713FIGURE 5-5. MAIN PANEL WINDOW5.5.2 MAIN PANELThe main panel window allows remote access to many power supply parameters without

KLR-DEV 060713 5-11ual, “Viewing/Changing Overvoltage or Overcurrent Protection Values,” and may affect prioroutput settings.FIGURE 5-6. PROTECTIO

5-12 KLR-DEV 060713The Calibrate button opens the Calibration Window (Figure 5-9), and is used to recalibrate theunit (see Section 4 of the KLR User

KLR-DEV 060713 5-13The Utilities button opens the Utilities window (Figure 5-12). Calibration Data (hex format) may be archived and restored using th

5-14 KLR-DEV 0607135.5.3 POWER SUPPLY EVENTSA Source Power Loss error will cause the Power Supply Event Window (Figure 5-13) to open.This allows the

KLR-DEV 060713 6-1SECTION 6 - PROGRAMMING THE KLR USING SCPI COMMANDS6.1 SCPI PROGRAMMINGSCPI (Standard Commands for Programmable Instruments) is a p

6-2 KLR-DEV 0607136.4.3 ABORT SUBSYSTEMThis subsystem cancels any pending trigger levels previously stored and resets them to theimmediate value. ABO

KLR-DEV 060713 6-36.4.11 CALIBRATE SUBSYSTEMCAL commands and queries are used to perform calibration of the unit via the control interface. Thesecomm

LIST OF FIGURESFIGURE TITLE PAGEvi KLR DEVGD 0607131-1 Status Reporting Structure...

6-4 KLR-DEV 060713To identify the short form and long form in this manual, keywords are written in upper case let-ters to represent the short form, f

KLR-DEV 060713 6-56.5.3 QUERY INDICATORThe question mark (?) following a keyword is a query indicator. This changes the command intoa query. If there

6-6 KLR-DEV 060713FIGURE 6-2. TREE DIAGRAM OF SCPI COMMANDS USED WITH KLR POWER SUPPLYABORt subsystemABORCALibrate subsystemCAL:CEXT:CGA:CURR:LEV[

KLR-DEV 060713 6-76.6 UNDERSTANDING THE COMMAND STRUCTUREUnderstanding the command structure requires an understanding of the subsystem commandtree i

6-8 KLR-DEV 060713• Several commands may be sent as one message; a line feed terminates the message.Commands sent together are separated by a semicol

KLR-DEV 060713 6-9/(6-10 Blank)FIGURE 6-3. TYPICAL EXAMPLE OF KLR POWER SUPPLY PROGRAM USING SCPI COMMANDS/***************************************

KLR-DEV 060713 7-1SECTION 7 - IEEE 488.2 (GPIB) INTERFACE7.1 DIGITAL REMOTE MODE PROGRAMMING USING IEEE 488.2 (GPIB) INTERFACEKLR Power Supplies may

7-2 KLR-DEV 060713TABLE 7-2. IEEE 488 (GPIB) BUS INTERFACE FUNCTIONSFUNCTIONSUBSET SYMBOLCOMMENTSSource Handshake SH1 Complete Capability (Interface

KLR-DEV 060713 7-3/(7-4 Blank)7.2.1 CHANGING THE GPIB ADDRESSUse the SYST:COMM:GPIB:ADDR? query to read the current GPIB address. Use theSYST:COMM:GP

KLR DEVGD 020498 viiLIST OF TABLESTABLE TITLE PAGE1-1 VISA Resource String Corresponding to Interface ...

KLR-DEV 060713 8-1SECTION 8 - RS 232C INTERFACE [STANDARD MODELS ONLY]8.1 DIGITAL REMOTE MODE PROGRAMMING USING RS 232 [STANDARD MODELS ONLY]KLR stan

8-2 KLR-DEV 060713BS removes the last character in the input buffer queue, with the exception of CR or LF/NL char-acters. Either the CR or LF (NL) ac

KLR-DEV 060713 8-3While both echo and prompt modes are very useful when communicating with the instrumentusing manual (keyboard) entry, these functio

8-4 KLR-DEV 0607138.2.2.4 ISOLATING RS 232 COMMUNICATIONS PROBLEMS [STANDARD MODELS ONLY]A Loop Back test can be run from the KLR front panel to aid

KLR-DEV 060713 9-1SECTION 9 - LAN INTERFACE [E-Series MODELS ONLY]9.1 INTRODUCTIONKLR Power Supplies may be programmed via the LAN interface using th

9-2 KLR-DEV 0607139.4 USING PORT 5025 (SCPI-RAW)The SCPI-Raw port provides faster access than the VXI-11 port (1024) as it has little overhead.This p

KLR-DEV 060713 A-1APPENDIX A - IEEE 488.2 COMMAND/QUERY DEFINITIONSA.1 INTRODUCTIONThis appendix defines the IEEE 488.2 commands and queries used wit

A-2 KLR-DEV 060713A.4 *ESE? — STANDARD EVENT STATUS ENABLE QUERY *ESE?Syntax: *ESE? Return value: Integer> value per Table A-2.Description: Re

KLR-DEV 060713 A-3The character string for E-Series models with RODC contains the following fields: <Manufacturer>,<Model> LAN RODC,<La