Tektronix KEITHLEY 2200 Series Programming Reference Manual Download Page 85 | Manualshive

Page: 85 / 104

background image

Appendix B: Programming Examples

Example 1

This example is written in the C programming language; NIVISA can be used.
It demonstrates basic communication with the power supply and error checking.
The program establishes communication with the power supply and puts it into
remote mode. It then initializes the voltage and current and turns the output on.
It sends new values for the voltage and current, and reads back the actual meter
values before turning off the power supply output and closing communications.

Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual

B-1

«
...
83
84
85
86
87
...
»

Summary of Contents for KEITHLEY 2200 Series

Page 1: ...www keithley com E C N E D I F N O C F O E R U S A E M R E T A E R G A Series 2200 Multichannel Programmable DC Power Supplies Programming Technical Reference 2220S 907 01 Rev B Dec 2013...

Page 2: ......

Page 3: ...or use the information herein in whole or in part without the prior written approval of Keithley Instruments Inc is strictly prohibited All Keithley Instruments product names are trademarks or regist...

Page 4: ...be connected to mains These instruments will be marked as category II or higher Unless explicitly allowed in the specifications operating manual and instrument labels do not connect any instrument to...

Page 5: ...amp must be properly disposed of according to federal state and local laws The WARNING heading in the user documentation explains dangers that might result in personal injury or death Always read the...

Page 6: ......

Page 7: ...ps 2 7 Status Commands 2 7 Save and Recall Commands 2 8 System Commands 2 9 Diagnostic Commands 2 9 Synchronization Commands 2 9 Trigger Commands 2 10 Measurement Commands 2 11 Source Commands 2 11 Ch...

Page 8: ...able of Contents Appendices Appendix A ASCII Code Chart A 1 Appendix B Programming Examples B 1 Appendix C Default Setup C 1 ii Series 2200 Programmable Multichannel DC Power Supplies Programmer Manua...

Page 9: ...PC based systems without converters or special cables The G versions of each model include a GPIB interface in combination with the USB interface These compact power supplies cover a wide range of ap...

Page 10: ...ive for details Contact Information If you have any questions after reviewing this information please use the following sources 1 Keithley Instruments website http www keithley com 2 Keithley web foru...

Page 11: ...Getting Started...

Page 12: ......

Page 13: ...software applications may be needed in addition to a VISA and the USBTMC driver Using the GPIB interface Start by connecting an appropriate GPIB cable between the power supply and either a PC or anoth...

Page 14: ...your controller Command Timing The average time it takes to both send and receive every command is approximately 20 ms In the case of more complex commands more time may be required to complete transm...

Page 15: ...is required Optional can be omitted Previous element s may be repeated Comment Command and Query Structure Commands consist of set commands and query commands usually simply called commands and queri...

Page 16: ...s It may optionally have white space characters before and after the comma Space A white space character between command header and argument It may optionally consist of multiple white space character...

Page 17: ...through 9 and 11 through 32 decimal The power supply ignores commands that consists of just a combination of white space characters and line feeds SCPI Commands and Queries The power supply uses a com...

Page 18: ...expects a line feed LF as the message terminator Parameter types Many power supply commands require parameters Parameters are indicated by angle brackets such as file_name There are several different...

Page 19: ...y then add a semicolon and finally add more commands or queries and semicolons until you are done If the command following a semicolon is a root node precede it with a colon The following figure illus...

Page 20: ...uses quotation marks correctly incorrect This string does not use quotation marks correctly You can use upper case lower case or a mixture of both cases for all commands queries and parameters SOURCE...

Page 21: ...isk character Table 2 5 Status commands Command Description CLS Clear all event registers and queues ESE Set query standard event status enable register ESR Return standard event status register IDN R...

Page 22: ...t event register OIEVR STATus OPERation INSTrument ENABle Queries the contents of the operation instrument enable register OIENR STATus OPERation INSTrument ISUmmary x EVENt Return operation event reg...

Page 23: ...nel SYSTem LOCal Set to front panel control mode Diagnostic Commands The power supply includes a self test function that may be used to confirm that it is functioning as expected A table of error code...

Page 24: ...Forces an immediate trigger event TRG Generates a trigger event SOURce VOLTage TRIGgered IMMediate Set or query the trigger voltage SOURce CURRent TRIGgered IMMediate Set or query the trigger current...

Page 25: ...Commands These commands allow you to set various output parameters Some of the commands are used to configure protection functions like output timers and Max Voltage Table 2 12 Source commands Comman...

Page 26: ...pends on the number of channels your instrument has Table 2 13 Channel combination commands Command Description INSTrument SELect Switch or query the current channel INSTrument COMbine SERies Set CH1...

Page 27: ...emonics and arguments with the minimal spelling shown in uppercase For example to use the abbreviated form of the MEASure SCALar VOLTage DC command type MEAS SCAL VOLT DC CLS No Query Form The CLS com...

Page 28: ...mask register that determines which bits in the Standard Event Status Register SESR will set the ESB bit in the Status Byte Register SBR See page 3 1 Status and Events Group Status Syntax ESE mask ESE...

Page 29: ...owing that the SESR contains binary 10010101 FETCh SCALar CURRent DC Query Only This command returns the last measured output current stored in the communications buffer of the power supply A new meas...

Page 30: ...volts Examples FETC VOLT might return 5 0011 which would be the measured voltage across the power supply outputs in volts FETCh SCALar POWer DC Query Only This command returns the calculated power ba...

Page 31: ...ng response for a 2220 30 1 KEITHLEY 2220 30 1 000004 1 01 1 20 INSTrument COMbine Query Only This command queries the instrument to determine the combination state of channels 1 and 2 Group Channel S...

Page 32: ...the combined current Group Channel Syntax INSTrument COMbine PARAllel Related Commands INSTrument COMbine OFF INSTrument COMbine SERies INSTrument COMbine TRACk Examples INSTRUMENT COMBINE PARALLEL I...

Page 33: ...e OFF INSTrument COMbine PARAllel INSTrument COMbine SERies Examples INSTRUMENT COMBINE TRACK INSTrument COUPle TRIGger This command is used to determine which channels will respond to the trigger com...

Page 34: ...no channel is specified the currently selected channel is measured and returned Group Measurement Syntax MEASure SCALar CURRent DC CH1 CH2 CH3 ALL Related Commands FETCh SCALar VOLTage DC INSTrument S...

Page 35: ...surement and returns the measured output voltage of the power supply If a channel is specified the query returns the measurement for the specified channel If no channel is specified the currently sele...

Page 36: ...power on states of SRER and ESER When PSC is true the Service Request Enable Register SRER and Event Status Enable Register ESER are set to 0 at power on When PSC is false the current values in the SR...

Page 37: ...oup Save and Recall Syntax RCL NR1 Related Commands SAV Arguments NR1 is an integer value in the range from 1 to 30 and specifies the location of setup memory Examples RCL 3 sets the power supply to s...

Page 38: ...setting front panel LOCK state Group Status Syntax RST SAV No Query Form Saves the state of the power supply into a specified nonvolatile memory location Any settings that had been stored previously a...

Page 39: ...ge from 0 to the maximum nameplate voltage of the power supply MAX sets the voltage to the maximum level note that the maximum level may be somewhat higher than the nameplate MIN sets the voltage to t...

Page 40: ...e No Query Form This command is used to decrease the current level by a step The stepping current can be set by the following command SOURce CURRent LEVel IMMediate STEP INCRement Group Source Syntax...

Page 41: ...mand is used to set the current step value Group Source Syntax SOURce CURRent LEVel IMMediate STEP INCRement current level SOURce CURRent LEVel IMMediate STEP INCRement Related Commands SOURce CURRent...

Page 42: ...ENT TRIGGERED 1 1A SOURce CURRent LEVel UP IMMediate AMPLitude No Query Form This command is used to increase the current level by a step The stepping current can be set by the SOURce CURRent LEVel IM...

Page 43: ...he parallel state to on Examples SOURCE OUTPUT PARALLEL STATE SOURce OUTPut PON STATe This command configures the power supply to power up with its output turned off or to return the output to the sta...

Page 44: ...rallel state to off 1 or ON sets the parallel state to on Examples SOURCE OUTPUT SERIES SOURce OUTPut STATe ALL This command turns all of the enabled output channels on or off Group Source Syntax SOUR...

Page 45: ...specifying time in the range 0 01s or 10ms to 60000s units S ms MIN The minimum time of the output timer 0 01 s MAX The maximum time of the output timer 60 000 s DEF The default time of the output tim...

Page 46: ...itude No Query Form This command is used to decrease the voltage level of the currently selected channel by a step The voltage step value can be set by the following command SOURce VOLTage LEVel IMMed...

Page 47: ...um level 0 V MAX sets the voltage to the maximum level note that the maximum level may be somewhat higher than the nameplate UP sets the voltage level to increase a step DOWN sets the voltage level to...

Page 48: ...CRement SOURce VOLTage LEVel IMMediate AMPLitude SOURce VOLTage LEVel TRIGgered IMMediate INCRement This command is used to set the voltage level for the trigger function Group Trigger Syntax SOURce V...

Page 49: ...voltage is a flexible decimal number that may be type NR1 NR2 or NR3 It specifies the voltage limit setting which can range from 0 to the maximum nameplate voltage of the power supply MIN sets the max...

Page 50: ...en the instrument receives its next trigger the currently selected channel will be set to the specified value So 8000000 V will set the voltage to 8 V on the front panel Group Source Syntax SOURce VOL...

Page 51: ...ight return a value of 32 showing that the bits in the SRER have the binary value 00100000 STATus OPERation ENABle This command sets and queries the contents of the operation enable register OENR The...

Page 52: ...s of the Operation Event Register OEVR ranging from 0 to 255 Examples STATUS OPERATION EVENT might return 2 which indicates that the summary bit is set STATus OPERation INSTrument ENABle Query Only Th...

Page 53: ...on INSTrument ENABle Returns NR1 is a decimal integer representation of the contents of the Operation Event Register OEVR ranging from 0 to 255 Examples STATUS OPERATION INSTrument EVENT might return...

Page 54: ...he binary bits of the OENR are set according to this value register Examples STAT OPER INST ISUM2 ENABle 2 STAT OPER INST ISUM2 ENABle might return 2 which would indicate that only the Constant Curren...

Page 55: ...Arguments NR1 is a decimal integer ranging from 0 through 255 The bits of the mask register of the QENR are set according to this value Returns mask Examples STATUS QUESTIONABLE ENABLE 8 STATUS QUEST...

Page 56: ...f the Questionable Enable Register for the specified channel are set according to this value Examples STATus QUEStionable INSTrument EVENt 8 STATus QUEStionable INSTrument EVENt might return 8 which w...

Page 57: ...QUES INST ISUMM1 COND might return 1 which would indicate an over voltage condition on channel 1 STATus QUEStionable INSTrument ISUMmary x ENABle7 This command is used to modify or query the operation...

Page 58: ...from 0 to 255 Examples STATUS QUESTIONABLE INSTRUMENT ISUMMARY3 EVENT might return 2 indicating that channel 3 transitioned to constant current mode STB Query Only The byte query returns the contents...

Page 59: ...sing one of the front panel buttons The instrument must be in local mode in order for this command to simulate a front panel button press Group System Syntax SYSTem KEY NR1 SYSTem KEY Arguments NR1 is...

Page 60: ...mples SYSTEM KEY 64 would simulate a press of the Shift key SYSTem LOCal No Query Form This command sets the power supply for control from the front panel Group System Syntax SYSTem LOCal Related Comm...

Page 61: ...Setup Arguments RST initializes the power supply to default settings after a power cycle RCL0 saves the most recent settings and restores these after a power cycle Returns RST default settings are app...

Page 62: ...System Syntax SYSTem RWLock Related Commands SYSTem REMote SYSTem LOCal Arguments None Examples SYSTEM RWLOCK SYSTem VERSion Query Only This command returns SCPI version of the instrument Group Syste...

Page 63: ...lated Commands TRG Arguments None Examples TRIGGER TST Query Only Initiates a self test and reports any errors Group Diagnostic Syntax TST Returns NR1 where NR1 0 indicates that the self test complete...

Page 64: ...Form This command prevents the instrument from executing further commands or queries until all pending commands are complete Group Synchronization Syntax WAI Examples WAI 2 50 Series 2200 Programmabl...

Page 65: ...Status and Events...

Page 66: ......

Page 67: ...upply error and event reporting function See Figure 3 1 The error and event reporting system consists of the following four register groups Status Byte Standard Event Operation Status Questionable Sta...

Page 68: ...Status and Events Figure 3 1 Error and event handling process 3 2 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 69: ...n Instrument Status Register OISR See page 3 4 Operation Status Register OSR See page 3 5 Questionable Instrument Status Register QISR See page 3 5 Questionable Status Register QSR See page 3 6 The St...

Page 70: ...egister SER Table 3 2 SER bit functions Bit Function 7 PON Power On Shows that the power supply was powered on 6 This bit is not used 5 CME Command Error Shows that an error occurred while the power s...

Page 71: ...tion Status Register is made up of 8 bits which note the occurrence of four types of events as shown here Figure 3 5 OSR bit functions Table 3 4 OSR bit functions Bit Function 7 This bit is not used 6...

Page 72: ...Mmary3 is reported to INST3 2 INST2 STATus QUEStionable INSTrument ISUMmary2 is reported to INST2 1 INST1 STATus QUEStionable INSTrument ISUMmary1 is reported to INST1 0 This bit is not used The Quest...

Page 73: ...tant voltage Summary Registers There are two types of summary registers Operation Instrument Summary Register OISUR See page 3 8 Questionable Instrument Summary Register QISUR See page 3 8 The QISUR a...

Page 74: ...ent Summary Register QISUR The Questionable Instrument Summary Register is made up of 16 bits which note the occurrence of two types of conditions as shown here Figure 3 8 QISUR bit functions Table 3...

Page 75: ...t Queue stores detailed information on up to 32 events When 32 events stack up in the Event Queue the 32nd event is replaced by event code 350 Queue Overflow Read the Event Queue with the EVENT query...

Page 76: ...ec 110 No Input Command to parse 114 Numeric suffix is invalid value 116 Invalid value in numeric or channel list e g out of range 117 Invalid number of dimensions in a channel list 120 Parameter of t...

Page 77: ...ata out of range 223 Too much data 224 Illegal parameter value 225 Out of memory 270 Macro error 272 Macro execution error 273 Illegal macro label 276 Macro recursion error 277 Macro redefinition not...

Page 78: ...gister bit 2 Code Message 400 Query error 410 Query INTERRUPTED 420 Query UNTERMINATED 430 Query DEADLOCKED 440 Query UNTERMINATED Self Test Errors The following table lists the self test errors that...

Page 79: ...arity 223 Front panel buffer overrun 224 Front panel timeout 225 Front Crc Check error 226 Front Cmd Error 401 CAL switch prevents calibration 402 CAL password is incorrect 403 CAL not enabled 404 Com...

Page 80: ...Status and Events 3 14 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 81: ...Appendices...

Page 82: ......

Page 83: ...Appendix A ASCII Code Chart Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual A 1...

Page 84: ...Appendix A ASCII Code Chart A 2 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 85: ...The program establishes communication with the power supply and puts it into remote mode It then initializes the voltage and current and turns the output on It sends new values for the voltage and cur...

Page 86: ...he power supply ID read the response and print it sprintf Buffer IDN SendSCPI Buffer printf Instrument identification string s n Buffer SendSCPI RST Reset the power supply SendSCPI OUTPut 1 Turn the o...

Page 87: ...r supply ErrorStatus viOpenDefaultRM defaultRM ErrorStatus viOpen defaultRM USB0 0X0699 0X0397 083001106673201002 INSTR 0 0 KI200 When using the GPIB interface replace the above command line with GPIB...

Page 88: ...CheckError char pMessage if ErrorStatus VI_SUCCESS printf n s pMessage ClosePort exit 0 void delay clock_t wait clock_t goal goal wait clock while goal clock B 4 Series 2200 Programmable Multichannel...

Page 89: ...A or NIVISA can be used It demonstrates establishing a connection with the power supply putting it into remote mode initializing the current and voltage for channel 1 and channel 2 and initializing th...

Page 90: ...the response and print it sprintf Buffer IDN SendSCPI Buffer printf Instrument identification string s n Buffer SendSCPI RST Reset the power supply SendSCPI OUTPut 1 Turn output on SendSCPI OUTPut TR...

Page 91: ...ute the appropriate GPIB address in the command line CheckError Unable to open the port SendSCPI SYSTem REMote void SendSCPI char pString char pdest strcpy commandString pString strcat commandString n...

Page 92: ...void delay clock_t wait clock_t goal goal wait clock while goal clock B 8 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 93: ...ples Example 3 This example is written in the C programming language TekVISA or NIVISA can be used The program demonstrates setting trigger settings Series 2200 Programmable Multichannel DC Power Supp...

Page 94: ...tf Buffer IDN SendSCPI Buffer printf Instrument identification string s n Buffer SendSCPI RST Reset the power supply SendSCPI OUTPut 1 Turn the output on for i 0 i 3 i printf setting Channel d voltage...

Page 95: ...port SendSCPI SYSTem REMote void SendSCPI char pString char pdest strcpy commandString pString strcat commandString n ErrorStatus viPrintf KI200 commandString CheckError Can t Write to Power Supply p...

Page 96: ...clock_t goal goal wait clock while goal clock B 12 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 97: ...1 VOLTage 35 CURRent 0 3 OUTPut SERies OPC MEASure VOLTage MEASure CURRent Example 5 This example shows a command sequence that uses the APPLy command to configure voltage and current values Talker L...

Page 98: ...and to couple all output with voltage and current triggered levels SYSTem REMote IDN RST OUTPut 1 INSTrument NSELect 1 VOLTage TRIGgered 6 CURRent TRIGgered 0 2 INSTrument NSELect 2 VOLTage TRIGgered...

Page 99: ...d when you return the power supply to default settings Table C 1 Default settings Menu or system Default setting VOLT LIM MAX VOLT LIM STAT OFF OUTP OFF VOLT 1 V CURR 0 1 A OUTP TIM DEL 60 OUTP TIM OF...

Page 100: ...Appendix C Default Setup C 2 Series 2200 Programmable Multichannel DC Power Supplies Programmer Manual...

Page 101: ...2 19 INSTrument COUPle TRIGger 2 19 INSTrument SELect 2 20 M MEASure SCALar VOLTage DC 2 21 MEASure SCALar CURRent DC 2 20 MEASure SCALar POWer DC 2 20 Message handling 3 1 O OPC 2 22 P PSC 2 22 R RC...

Page 102: ...ISUmmary x EVENt 2 40 STATus OPERation INSTrument ISUMmary x CONDition 2 39 STATus OPERation INSTrument ISUmmary x ENABle 2 40 STATus QUEStionable EVENt 2 41 STATus QUEStionable ENABle 2 41 STATus QUE...

Page 103: ......

Page 104: ...perty of Keithley Instruments Inc All other trademarks and trade names are the property of their respective companies Keithley Instruments Inc Corporate Headquarters 28775 Aurora Road Cleveland Ohio 4...

Reviews:

No comments

Related manuals for KEITHLEY 2200 Series

Brand: ABS Pages: 8

Brand: Fein Pages: 70

Brand: XPOtool Pages: 10

Brand: ?HC Pages: 2

Brand: REDSTONE Pages: 70

Brand: Total Pages: 11

Brand: Xantrex Pages: 90

Brand: Cembre Pages: 12

Muyang SZLH Series

Brand: Famsun Pages: 46

Brand: Gearmore Pages: 14

Brand: Baileigh Industrial Pages: 44

Brand: MGC Pages: 2

Brand: YATO Pages: 88

Brand: DIS Pages: 14

Brand: Parkside Pages: 40

Brand: unicraft Pages: 20

Brand: Evolution Pages: 44

HEAVY DUTY M12 FTB

Brand: Milwaukee Pages: 77

Brands by name

0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Popular brands

Load more brands