background image

Commands Listed in Alphabetical Order

Group

Trigger

Syntax

*TRG

Related Commands

TRIGger[:IMMediate]

Examples

*TRG

TRIGger[:IMMediate] (No Query Form)

This command forces an immediate trigger event.

Group

Trigger

Syntax

TRIGger[:IMMediate]

Related Commands

*TRG

Arguments

None.

Examples

TRIGGER

TRIGger:SOURce

This command sets the source of trigger events.

Group

Trigger

Syntax

TRIGger:SOURce {MANual|IMMediate|EXTernal|BUS}
TRIGger:SOURce?

Related Commands

[SOURce:]DIGital:FUNCtion

,

*TRG

,

TRIGger[:IMMediate]

Arguments

MANual

: When this value is sent, the power supply will wait for a trigger from the

front-panel. Press Shift + 3 (Trigger) to trigger the power supply.

2-46

PWS4205, PWS4305, PWS4323, PWS4602, and PWS4721 Power Supply Programmer Manual

Summary of Contents for PWS4205

Page 1: ...xx PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Linear DC Power Supplies ZZZ Programmer Manual P077048102 077 0481 02...

Page 2: ......

Page 3: ...PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Linear DC Power Supplies ZZZ Programmer Manual xx www tektronix com 077 0481 02...

Page 4: ...ifications and price change privileges reserved Tektronix Inc P O Box 500 Beaverton OR 97077 TEKTRONIX and TEK are registered trademarks of Tektronix Inc Contacting Tektronix Tektronix Inc 14150 SW Ka...

Page 5: ...stic Commands 2 9 Synchronization Commands 2 9 Trigger Commands 2 9 Measurement Commands 2 10 Source Commands 2 10 Bus Command Group 2 11 Commands Listed in Alphabetical Order 2 13 Status and Events S...

Page 6: ...Table of Contents ii PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 7: ...323 PWS4602 and the PWS4721 Linear DC Power Supplies With this information you can write computer programs to perform functions such as setting the controls taking measurements performing statistical...

Page 8: ...Preface iv PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 9: ...Getting Started...

Page 10: ......

Page 11: ...d your PC will establish communication with the power supply upon USB cable connection For further remote control and or programming use other software applications may be needed in addition to a VISA...

Page 12: ...B Address 1 If there is more than one GPIB instrument on the bus you will need to change the default setting on the power supply To change the GPIB address settings do the following 1 On the instrumen...

Page 13: ...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 queries Commands change power...

Page 14: ...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 15: ...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 16: ...r type is listed after the parameter Some parameter types are defined specifically for the arbitrary function generator command set and some are defined by SCPI See Table 2 4 Table 2 4 Types of parame...

Page 17: ...hained message consisting of several commands and queries The chained message should end in a command or query not a semicolon Responses to any queries in your message are separated by semicolons Figu...

Page 18: ...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 19: ...Status commands let you determine the status of the power supply and control events Several commands and queries are common to all devices on the GPIB or USB bus These commands and queries are defined...

Page 20: ...to 1 STATus OPERation ENABle Set query operation enable register The parameter determines which bit value of quest event register is set to 1 If a OPER condition changes the OPER bit of the status byt...

Page 21: ...are given in the Messages and Codes section See page 3 8 Table 2 8 Diagnostic commands Header Description TST Perform self test and return result status Synchronization Commands Table 2 9 Synchroniza...

Page 22: ...ut power FETCh VOLTage DC Query the measured output voltage Source Commands These commands allow you to set various output parameters Some of the commands are used to configure protection functions li...

Page 23: ...Set the number of steps for the list operation SOURce LIST WIDth Set the step time SOURce LIST VOLTage LEVel Set the voltage for a list step SOURce FUNCtion MODE Configure for command fixed mode or l...

Page 24: ...ription GPIBUsb ADDress Allows TEK USB 488 to query the GPIB Primary Address set for this instrument GPIBUsb ID Query the ID string of the TEK USB 488 bus adapter module 2 12 PWS4205 PWS4305 PWS4323 P...

Page 25: ...commands with a question mark appended to the header and includes the words Query Only in the command name This document spells out headers mnemonics and arguments with the minimal spelling shown in...

Page 26: ...vent Status Enable Register ESER The ESER is an eight bit 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 p...

Page 27: ...mands CLS OPC SRE Returns NR1 which is a decimal representation of the contents of the Standard Event Status Register SESR Examples ESR might return the value 149 showing that the SESR contains binary...

Page 28: ...hich would be the measured voltage across the power supply outputs in volts FETCh SCALar POWer Query Only This command returns the last measured output current stored in the communications buffer of t...

Page 29: ...of the power supply as specified on the front panel of the instrument The range is from 1 to 30 Examples GPIBU ADD might respond with 5 which is the GPIB address of the instrument GPIBUsb ID Query On...

Page 30: ...ment and returns the measured output current of the power supply Group Measurement Syntax MEASure CURRent DC Related Commands FETCh VOLTage DC Returns NR2 is the measured output current in amperes Exa...

Page 31: ...hat all pending OPC operations are finished PSC Sets and queries the power on status flag that controls the automatic power on execution of SRER and ESER When PSC is true the SRER and ESER are set to...

Page 32: ...ror Group Save and Recall Syntax RCL NR1 Related Commands SAV Arguments NR1 is an integer value in the range from 0 to 40 and specifies the location of setup memory Examples RCL 3 sets the power suppl...

Page 33: ...x 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 at the location are overwritten You can later use...

Page 34: ...RR 3A CURR 30mA CURR MIN CURR might return 2 0000 which would be the current setting in amperes SOURce DIGital DATA This command sets the output state of the rear panel TTL control output and queries...

Page 35: ...nds TRIGger SOURce SOURce OUTPut DFI SOURce SOURce DIGital DATA Arguments Port mode In Out Decription TRIGger Trigger In N A Configures the TTL control input as an external trigger source RIDFi RI DFI...

Page 36: ...and prepare the instrument to respond to discrete settings changes Group Source Syntax SOURce FUNCtion MODE FIXed LIST SOURce FUNCtion MODE Arguments FIXed configures the power supply to respond to di...

Page 37: ...x SOURce LIST CURRent LEVel NR1 current SOURce LIST CURRent LEVel NR1 Related Commands SOURce LIST VOLTage LEVel SOURce LIST WIDth Arguments NR1 is an integer in the range from 1 to 80 which is a step...

Page 38: ...MODE CONT LIST MODE might respond with STEP to indicate that the active list is configured to wait for one trigger for each step SOURce LIST RCL No Query Form This command recalls a previously saved...

Page 39: ...e number of steps in the active list The number of steps must be configured before loading the voltage levels current levels and or durations of the steps Group Source List Syntax SOURce LIST STEP NR1...

Page 40: ...s V mV Returns NR2 Examples LIST VOLT 1 3V LIST VOLT 1 might return 3 0000 which would be the voltage level for step number 1 SOURce LIST WIDth This command sets the duration of a specified step in a...

Page 41: ...al FUNCtion Arguments OFF the output level of the DFI output pin remains high QUES the output level of the DFI output pin reflects the complement of the state of the QUES bit For example when the QUES...

Page 42: ...cled SOURce OUTPut PROTection CLEar No Query Form This command clears a trip condition caused by over voltage OV over temperature OT or remote inhibit RI Group Source Syntax SOURce OUTPut PROTection C...

Page 43: ...l is TTL high the output will be on While the level is TTL low the output of the power supply will be off Returns OFF LATC LIVE Examples OUTP RI MODE LATC OUTP RI MODE might return OFF which would ind...

Page 44: ...ated Commands SOURce OUTPut TIMer STATe SOURce OUTPut STATe Arguments duration NRf units where NRf is a flexible decimal specifying time in the range 0 01s or 10ms to 60000s units S ms MIN The minimum...

Page 45: ...he output timer off 1 or ON turns the output timer on Returns 0 1 Examples To start timer first send OUTPUT TIMER STATE ON then send OUTPUT STATE ON To end timer turn timer off send OUTPUT TIMER STATE...

Page 46: ...ge PROTection LEVel voltage MIN MAX DEF SOURce VOLTage PROTection LEVel Related Commands SOURce VOLTage PROTection STATe SOURce VOLTage RANGe Arguments voltage NRf units where NRf is a flexible decima...

Page 47: ...off 1 or ON sets the over voltage protection to on Returns 0 1 means the over voltage protection is off Examples VOLT PROT STAT 1 VOLT PROT STAT might return 1 which would indicate that overvoltage pr...

Page 48: ...the voltage limit in volts Examples VOLT RANG 3 2V VOLT RANG might return 3 2 which would be the maximum programmable voltage in volts SRE Service Request Enable sets and queries the bits in the Servi...

Page 49: ...dition Register OCR ranging from 0 to 255 Examples STATUS OPERATION CONDITION might return 4 which would indicate that the power supply is in constant voltage mode STATus OPERation ENABle This command...

Page 50: ...gisters are available in this manual See page 3 1 Status and Events Group Status Syntax STATus OPERation EVENt Related Commands STATus OPERation CONDition STATus OPERation ENABle Returns NR1 is a deci...

Page 51: ...ster QEVR will affect the state of the QUES bit in the Status Byte Register SBR Group Status Syntax STATus QUEStionable ENABle mask STATus QUEStionable ENABle Related Commands STATus QUEStionable EVEN...

Page 52: ...UESTIONABLE EVENT might return 1 which would indicate an overvoltage condition STATus QUEStionable NTRansition This command sets the negative transition filter of the questionable event register The f...

Page 53: ...STATus QUEStionable PTRansition Related Commands STATus QUEStionable ENABle STATus QUEStionable EVENt STATus QUEStionable CONDition STATus QUEStionable NTRansition Arguments mask NR1 where NR1 is a nu...

Page 54: ...3 9 Group System Syntax SYSTem ERRor Returns NR1 error_text error_text string where string is a description of the error Examples SYSTEM ERROR might return 110 which means No Input Command to parse SY...

Page 55: ...WN 8 KEY_0 9 KEY_1 10 KEY_2 11 KEY_3 12 KEY_4 13 KEY_5 14 KEY_6 15 KEY_7 16 KEY_8 17 KEY_9 18 KEY_DECIMAL 19 KEY_ESC 20 KEY_ENTER 21 KEY_ON 22 KEY_SHIFT 64 Examples SYSTEM KEY 64 would simulate a pres...

Page 56: ...default settings after a power cycle RCL0 saves the most recent settings and restores these after a power cycle Returns RST default settings are applied after a power cycle RCL0 most recent settings...

Page 57: ...YSTem 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 System Syntax SYSTem...

Page 58: ...None Examples TRIGGER TRIGger SOURce This command sets the source of trigger events Group Trigger Syntax TRIGger SOURce MANual IMMediate EXTernal BUS TRIGger SOURce Related Commands SOURce DIGital FUN...

Page 59: ...and to the power supply Examples TRIGGER SOURCE BUS 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 complet...

Page 60: ...Commands Listed in Alphabetical Order 2 48 PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 61: ...Status and Events...

Page 62: ......

Page 63: ...power supply error and event reporting function See Figure 3 1 The error and event reporting system consists of the following three blocks Standard Event Status Operation Status Questionable Status Th...

Page 64: ...Status and Events Figure 3 1 Error and event handling process 3 2 PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 65: ...ster OCR See page 3 5 Operation Event Register OEVR See page 3 5 Questionable Condition Register QCR See page 3 5 Questionable Event Register QEVR See page 3 6 NOTE The Questionable Event Register may...

Page 66: ...The Standard Event Status Register SESR Table 3 2 SESR bit functions Bit Function 7 MSB PON Power On Shows that the power supply was powered on 6 User Request This bit is not used 5 CME Command Error...

Page 67: ...d is regulating its output voltage 1 WTG Waiting for Trigger Indicates that the power supply is waiting for a trigger 0 LSB CAL Calibrating Indicates that the power supply is calculating a new calibra...

Page 68: ...the QEVR will be set to 1 when the same bit in the QCR makes a positive transition from 0 to 1 The Questionable Event Register QEVR The Questionable Event Register is made up of eight bits which have...

Page 69: ...NR consists of bits defined exactly the same as bits 0 through 7 in the OEVR You can use this register to control whether or not the Operation Status Bit OSB in the SBR is set when an event occurs and...

Page 70: ...s only the event number with the EVMSG query which returns the event number and a text description of the event or with the ALLEV query which returns all the event numbers with a description of the ev...

Page 71: ...er 140 Wrong type of parameter s 150 Wrong number of parameters 160 Unmatched quotation mark in parameters single double 165 Unmatched bracket 170 Command keywords were not recognized 180 No entry in...

Page 72: ...ister 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 c...

Page 73: ...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 74: ...Status and Events 3 12 PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 75: ...Appendices...

Page 76: ......

Page 77: ...Appendix A ASCII Code Chart PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual A 1...

Page 78: ...Appendix A ASCII Code Chart A 2 PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 79: ...nclude string h include time h include conio h include stdlib h ViSession defaultRM Resource manager id ViSession PWS4000 Identifies the power supply long ErrorStatus char commandString 256 char ReadB...

Page 80: ...voltage ErrorStatus viPrintf PWS4000 MEASURE CURRENT n measure the output current CheckError Unable to write the device ErrorStatus viScanf PWS4000 f current retrieve reading CheckError Unable to read...

Page 81: ...dest NULL ErrorStatus viBufRead PWS4000 ViBuf ReadBuffer sizeof ReadBuffer VI_NULL CheckError Can t read from driver strcpy pString ReadBuffer void ClosePort viClose PWS4000 viClose defaultRM void Che...

Page 82: ...CURRENT 1 1 0A LIST WIDTH 1 5s LIST VOLT 2 4V LIST CURRENT 2 1 0A LIST WIDTH 2 10s LIST VOLT 3 0V LIST CURRENT 3 0 1A LIST WIDTH 3 2s LIST SAVE 1 FUNCTION MODE LIST OUTPUT ON TRIGGER IMMEDIATE Example...

Page 83: ...ermine when the list has finished executing pws_visa c undef MICROSOFT Change this to define if Microsoft ifdef MICROSOFT include stdafx h include conio h else typedef char_TCHAR endif include visa h...

Page 84: ...rintf Instrument identification string s n Buffer SendSCPI RST reset the power supply delay 100 SendSCPI CURRENT 0 1A set the current to 0 1A SendSCPI VOLTAGE 0V set the voltage to 0V SendSCPI OUTPUT...

Page 85: ...endSCPI TRIGGER trigger the list printf List is running n Check the state of bit 5 of the Operation Condition Register to determine if list is still running do delay 500 ErrorStatus viPrintf PWS4000 S...

Page 86: ...command if pdest NULL ErrorStatus viBufRead PWS4000 ViBuf ReadBuffer sizeof ReadBuffer VI_NULL CheckError Can t read from driver strcpy pString ReadBuffer void ClosePort viClose PWS4000 viClose defau...

Page 87: ...u return the power supply to default settings Table C 1 Default settings Menu or system Default setting VOLT PROT MAX VOLT PROT STAT OFF OUTP OFF VOLT 1 V VOLT RANG MAX CURR 0 1 A OUTP TIM 60 OUTP TIM...

Page 88: ...Appendix C Default Setup C 2 PWS4205 PWS4305 PWS4323 PWS4602 and PWS4721 Power Supply Programmer Manual...

Page 89: ...OURce DIGital DATA 2 22 SOURce DIGital FUNCtion 2 23 SOURce FUNCtion MODE 2 24 SOURce LIST COUNt 2 24 SOURce LIST CURRent LEVel 2 25 SOURce LIST MODE 2 26 SOURce LIST RCL 2 26 SOURce LIST SAVe 2 27 SO...

Page 90: ...PTRansition 2 41 STATus QUEStionable EVENt 2 40 STB 2 41 Syntax BNF Backus Naur form 2 1 command 2 1 SYSTem ERRor 2 42 SYSTem KEY 2 42 SYSTem LOCal 2 43 SYSTem POSetup 2 44 SYSTem REMote 2 44 SYSTem R...

Reviews: