This document contains proprietary information protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated into another language without the prior consent of Keysight Technologies. The information contained in this document is subject to change without notice.
Table of Contents Safety Summary Printing History Table of Contents 1 - GENERAL INFORMATION About this Guide Documentation Summary External References SCPI References GPIB References VXIplug&play Power Products Instrument Drivers Supported Applications System Requirements Downloading and Installing the Driver Accessing Online Help 2 - INTRODUCTION TO PROGRAMMING GPIB Capabilities of the Electronic Load GPIB Address...
Page 6
Suffixes and Multipliers Response Data Types SCPI Command Completion Using Device Clear RS-232 Troubleshooting SCPI Conformance Information SCPI Conformed Commands Non-SCPI Commands 3 - PROGRAMMING EXAMPLES Introduction Programming the Input Power-on Initialization Enabling the Input Input Voltage Input Current Setting the Triggered Voltage or Current Levels Programming Transients Continuous Transients Pulse Transients...
Page 7
Measuring Triggered Transients or Lists Measuring Dwell-Paced Lists Programming the Status Registers Power-On Conditions Channel Status Group Channel Summary Group Questionable Status Group Standard Event Status Group Operation Status Group Status Byte Register Determining the Cause of a Service Interrupt Servicing Standard Event Status and Questionable Status Events Programming Examples CC Mode Example...
N3303A, N3304A, N3305A, N3306A, and N3307A Electronic Load modules when installed in a Keysight Technologies N3300A and N3301A Electronic Load mainframes. These units will be referred to as "electronic load" throughout this manual. You will find the following information in the rest of this guide: Chapter 1 Introduction to this guide.
VXIplug&play instrument drivers for Microsoft Windows 95 and Windows NT are now available on the Web at http://www.keysight.com/find/drivers. These instrument drivers provide a high-level programming interface to your Keysight Technologies electronic load. VXIplug&play instrument drivers are an alternative to programming your instrument with SCPI command strings. Because the instrument driver's function calls work together on top of the VISA I/O library, a single instrument driver can be used with multiple application environments.
General Information - 1 1. Access Keysight Technologies Web site at http://www.keysight.com/find/drivers. 2. Select the instrument for which you need the driver. 3. Click on the driver, either Windows 95 or Windows NT, and download the executable file to your 4.
Introduction to Programming GPIB Capabilities of the Electronic Load All electronic load functions except for setting the GPIB address are programmable over the GPIB. The IEEE 488.2 capabilities of the electronic load are described in Table 2-1. Refer to Appendix A of your User's Guide for its exact capabilities.
2 - Introduction to Programming RS-232 Capabilities of the Electronic Load The electronic load provides an RS-232 programming interface, which is activated by commands located under the front panel Address key. All SCPI commands are available through RS-232 programming. When the RS-232 interface is selected, the GPIB interface is disabled. The EIA RS-232 Standard defines the interconnections between Data Terminal Equipment (DTE) and Data Communications Equipment (DCE).
Introduction to Programming - 2 Introduction to SCPI SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling instrument functions over the GPIB and RS-232 interface. SCPI is layered on top of the hardware-portion of IEEE 488.2. The same SCPI commands and parameters control the same functions in different classes of instruments.
2 - Introduction to Programming Multiple Commands in a Message Multiple SCPI commands can be combined and sent as a single message with one message terminator. There are two important considerations when sending several commands within a single message: ♦ Use a semicolon to separate commands within a message. ♦...
Introduction to Programming - 2 Using Queries Observe the following precautions with queries: ♦ Set up the proper number of variables for the returned data. For example, if you are reading back a measurement array, you must dimension the array according to the number of measurements that you have placed in the measurement buffer.
2 - Introduction to Programming Query Indicator Following a header with a question mark turns it into a query (VOLTage?, VOLTage:PROTection?). If a query contains a parameter, place the query indicator at the end of the last header (VOLTage:PROTection? MAX). Message Unit Separator When two or more message units are combined into a compound message, separate the units with a semicolon (STATus:OPERation?;QUEStionable?).
Introduction to Programming - 2 Suffixes and Multipliers Class Suffix Unit Unit with Multiplier Amplitude volt MV (millivolt) Current ampere MA (milliampere) Power watt MW (milliwatt) Resistance MOHM (megohm) Slew Rate amps/second ohms/second volts/second Time second MS (millisecond) Common Multipliers kilo 1E-3 milli...
2 - Introduction to Programming Using Device Clear You can send a device clear at any time to abort a SCPI command that may be hanging up the GPIB interface. The status registers, the error queue, and all configuration states are left unchanged when a device clear message is received.
Programming Examples Introduction This chapter contains examples on how to program your electronic load. Simple examples show you how to program: Input functions such as voltage, current, and resistance Transient functions, including lists Measurement functions The status and protection functions These examples in this chapter show which commands are used to perform a particular NOTE: function, but do not show the commands being used in any particular programming...
3 - Programming Examples Maximum Voltage The maximum input voltage that can be programmed can be queried with: VOLTage? MAXimum Input Current All models have a programmable current function. The command to program the current is: CURRent <n> where <n> is the input current in amperes. Maximum Current The maximum input current that can be programmed can be queried with: CURRent? MAXimum...
Programming Examples - 3 Programming Transients Transient operation is used to synchronize input changes with internal or external trigger signals, and simulate loading conditions with precise control of timing, duration, and slew. The following transient modes can be generated: Generates a repetitive pulse stream that toggles between two load levels. Continuous Generates an load change that returns to its original state after some time period.
3 - Programming Examples TRIGger:SOURce EXTernal TRANsient:MODE PULSe CURRent 5 CURRent:TLEVel 10 TRANsient:TWIDth .01 TRANsient ON This example assumes that the CC mode is active, the slew rate is at the factory default setting (maximum rate), and a trigger signal is connected to the mainframe's external trigger input. The load module starts conduction at the main current level setting (5 amps).
Page 29
Programming Examples - 3 Set the mode of each function that will participate in the sequence to LIST. For example: Step 1 CURRent:MODE LIST Program the list of input values for each function. The list commands take a comma-separated Step 2 list of arguments.
3 - Programming Examples Programming Lists for Multiple Channels You can program separate lists for individual channels on a load mainframe. Once lists have been programmed for each channel, they can all be triggered at the same time using the list trigger system. All lists must have the same number of data values or points, or an error will occur when NOTE: the list system that starts the sequence is initiated.
Programming Examples - 3 Triggering Transients and Lists Continuous, pulse, and toggled transient modes respond to triggers as soon as the trigger is received. This is not the case for lists. Lists have an independent trigger system that is similar to the measurement trigger system.
3 - Programming Examples Initiating List Triggers When the electronic load is turned on, the list trigger system is in the idle state. In this state, the list system ignores all triggers. Sending the following commands at any time returns the list system to the Idle state: ABORt *RST...
Programming Examples - 3 Making Measurements The electronic load has the ability to make several types of voltage or current measurements. The measurement capabilities of the electronic load are particularly useful with applications that draw current in pulses. All measurements are performed by digitizing the instantaneous input voltage or current for a defined number of samples and sample interval, storing the results in a buffer, and then calculating the measured result.
Page 34
3 - Programming Examples Ripple rejection is a function of the number of cycles of the ripple frequency contained in the acquisition window. More cycles in the acquisition window results in better ripple rejection. If you increase the time interval for each measurement to 45 microseconds for example, this results in 5.53 cycles in the acquisition window at 60 Hz, for a ripple rejection of about 70 dB.
Programming Examples - 3 Triggering Measurements You can use the data acquisition trigger system to synchronize the timing of the voltage and current data acquisition with a trigger source. Then use the FETCh commands to return different calculations from the data acquired by the measurement trigger.
3 - Programming Examples Initiating the Measurement Trigger System When the electronic load is turned on, the trigger system is in the idle state. In this state, the trigger system ignores all triggers. Sending the following commands at any time returns the trigger system to the Idle state: ABORt *RST...
Programming Examples - 3 Controlling Measurement Samples Varying the Sampling Rate You can vary both the number of data points in a measurement sample, as well as the time between samples. You can also specify a delay from the trigger to the start of the measurement. This is illustrated in the following figure.
3 - Programming Examples With this setup, the instrument performs each acquisition sequentially, storing the digitized readings in the internal measurement buffer. A trigger signal is required to make each measurement. It is only necessary to initialize the measurement once at the start; after each completed acquisition the instrument will wait for the next valid trigger condition to start another.
Programming Examples - 3 Initiate both the transient (list) and the measurement trigger systems. Step 6 INITiate:SEQuence1 INITiate:SEQuence2 Specify the trigger source and the timing that will control the list steps and the measurements. Step 7 TRIGger:TIMer 2 TRIGger:SOURce TIMer In this example the trigger source is the internal trigger.
3 - Programming Examples Programming the Status Registers You can use status register programming to determine the operating condition of the electronic load at any time. For example, you may program the electronic load to generate an interrupt (assert SRQ) when an event such as a current protection occurs.
Page 41
Programming Examples - 3 Table 3-1. Bit Configurations of Status Registers (continued) Questionable Status Group Same as Channel Status Group Standard Event Status Group Operation Complete. The load has completed all pending operations. *OPC must be programmed for this bit to be set when pending operations are complete. Query Error.
Programming Examples - 3 Power-On Conditions Refer to the *RST command description in chapter 4 for the power-on conditions of the status registers. Channel Status Group The Channel Status registers record signals that indicate abnormal operation of a specific channel of the electronic load.
3 - Programming Examples Command Action programs specific bits in the Standard Event enable register. *ESE clears the Standard Event enable register at power-on. *PSC ON reads and clears the Standard Event event register. *ESR? The PON (Power On) Bit The PON bit in the Standard Event event register is set whenever the electronic load is turned on.
Programming Examples - 3 The MAV Bit and Output Queue The Output Queue is a first-in, first-out (FIFO) data register that stores electronic load-to-controller messages until the controller reads them. Whenever the queue holds one or more bytes, it sets the MAV bit (4) of the Status Byte register.
3 - Programming Examples Programming Examples Because of the wide variety of input ratings between load modules, not all of the values NOTE: used in the following programming examples will work with every module. CC Mode Example This example selects channel 1, sets the current level to 1.25 A and reads back the actual current value. 10 OUTPUT 705;...
Programming Examples - 3 CR Mode Example This example selects channel 1, sets the current protection limit to 2 amps, programs the resistance level to 100 ohms, and reads back the computed power. 10 OUTPUT 705;"CHAN 1;:INPUT OFF" 20 OUTPUT 705;"FUNC RES" 30 OUTPUT 705;"CURR:PROT:LEV 2;DEL 0.5"...
3 - Programming Examples Pulsed Transient Operation Example This example selects channel 1, sets the CR levels, selects the bus as the trigger source, sets the fastest slew rate, programs a pulse width of 1 millisecond, and turns on transient operation. When the *TRG command is received, a 1 millisecond pulse is generated at the channel 1 input.
Programming Examples - 3 Line 10: Selects channel 1 and turns the input off. Line 20: Selects the CC mode. Line 30: Sets the main current level to 25 A. Line 40: Sets the transient current level to 50 A and the slew rate to maximum. Line 50: Selects toggled transient operation.
Page 50
3 - Programming Examples Figure 3-6. Batteries in Series Battery Test Example Program ! Battery Test Example Program Eodv=l.0 ! End of discharge voltage for single cell Number_of_cells=3 ! Number of cells to be discharged in series Discharge_at=.05 ! Constant current discharge rate in amperes "CHAN 1;: OUTPUT 705;...
Programming Examples - 3 Power Supply Testing Example A typical use for electronic loads when testing power supplies involves power supply burn-in. One of the problems associated with burn-in is what to do if the power supply fails before the test is over. One solution involves continuously monitoring the supply and removing the load if the supply fails during the test (see figure 3-7).
3 - Programming Examples OUTPUT 705;"INPUT OFF" ! Disables the input at end of test PRINT "Burn-in test complete at ";TIME$(TIMEDATE) STOP Srq_service ! Service request subroutine Load_status=SPOLL(705) ! Conduct serial poll IF BIT(Load_status, 6) THEN ! Check if SRQ bit is set GOSUB Check_unr ELSE PRINT "A condition other than UNR generated SRQ at ";TIME$(TIMEDATE)
Page 53
Programming Examples - 3 double Average(double *pData, int nPoints, int nIndex) int nStart, nEnd, i; double dSum = 0.0; nStart = nIndex * nPoints; nEnd = nStart + nPoints; for (i = nStart; i < nEnd; ++i) dSum += pData[i]; return dSum / nPoints;...
Page 54
3 - Programming Examples /* We are using trigger-paced lists, so set the list of dwell times to * minimum so no triggers are lost. iprintf(Load, "list:dwell min\n"); /* Set trigger-paced lists. */ iprintf(Load, "list:step once\n"); /* Set up the parameters for each triggered measurement. */ iprintf(Load, "sense:sweep:points %d\n", nMeasPoints);...
Language Dictionary Introduction This section gives the syntax and parameters for all the IEEE 488.2 SCPI subsystem and common commands used by the electronic loads. It is assumed that you are familiar with the material in chapter 2 "Introduction to Programming". Because the SCPI syntax remains the same for all programming languages, the examples given for each command are generic.
4 - Language Dictionary Common Commands Common commands begin with an * and consist of three letters (command) or three letters and a ? (query). They are defined by the IEEE 488.2 standard to perform common interface functions. Common commands and queries are categorized under System, Status, or Trigger functions and are listed at the end of this chapter.
Language Dictionary - 4 Calibration Commands Calibration commands let you: Enable and disable the calibration mode Change the calibration password Calibrate the input functions, current monitor offset and gain, and store new calibration constants in nonvolatile memory. CALibrate:DATA This command is only used in calibration mode.
Whenever the calibration state is changed from enabled to disabled, any new calibration constants are lost unless they have been stored with CALibrate:SAVE. CALibrate:STATe <bool> [,<NRf>] Command Syntax 0 | 1 | OFF | ON [,<password>] Parameters *RST Value CAL:STAT 1, N3301A CAL:STAT OFF Examples CALibrate:STATe? Query Syntax <NR1> Returned Parameters...
Language Dictionary - 4 Channel Commands These commands program the channel selection capability of the electronic load. The CHANnel and INSTrument commands are equivalent. CHANnel INSTrument These commands select the multiple electronic load channel to which all subsequent channel-specific commands will be directed. If the specified channel number does not exist or is outside the MIN/MAX range, an error code is generated (see appendix C).
4 - Language Dictionary Input Commands These commands control the input of the electronic load. The INPut and OUTput commands are equivalent. The CURRent, RESistance and VOLTage commands program the actual input current, resistance, and voltage. [SOURce:]INPut [SOURce:]OUTPut Channel Specific These commands enable or disable the electronic load inputs.
Language Dictionary - 4 [SOURce:]CURRent Channel Specific This command sets the current that the load will regulate when operating in constant current mode. Refer to Table 4-1 for model-specific programming ranges. [SOURce:]CURRent[:LEVel][:IMMediate][:AMPLitude] <NRf+> Command Syntax 0 through MAX | MINimum | MAXimum Parameters A (amperes) Unit...
4 - Language Dictionary [SOURce:]CURRent:PROTection:DELay Channel Specific This command specifies the time that the input current can exceed the protection level before the input is turned off. [SOURce:]CURRent:PROTection:DELay <NRf+> Command Syntax 0 to 60 seconds Parameters seconds Unit *RST Value CURR:PROT:DEL .5 Examples [SOURce:]CURRent:PROTection:DELay?
Language Dictionary - 4 [SOURce:]CURRent:SLEW Channel Specific This command sets the slew rate for all programmed changes in the input current level of the electronic load. This command programs both positive and negative going slew rates. Although any slew rate value may be entered, the electronic load selects a slew rate that is closest to the programmed value.
4 - Language Dictionary [SOURce:]CURRent:TLEVel Channel Specific This command specifies the transient level of the input current. The transient function switches between the immediate setting and the transient level. Refer to Table 4-1 for model-specific programming ranges. [SOURce:]CURRent:TLEVel <NRf+> Command Syntax 0 through MAX | MINimum | MAXimum Parameters A (amperes)
Language Dictionary - 4 [SOURce:]FUNCtion:MODE Channel Specific This command determines whether the input regulation mode is controlled by values in a list or by the FUNCtion command setting. The regulation mode is determined by the FUNCtion or MODE command. FIXed The regulation mode is determined by the active list.
4 - Language Dictionary [SOURce:]RESistance:RANGe Channel Specific This command sets the resistance range of the electronic load module. There are four resistance ranges, the values of which are model dependent. Refer to Table 4-1 for the resistance ranges of each electronic load model.
Language Dictionary - 4 [SOURce:]RESistance:SLEW:NEGative <NRf+> Command Syntax 0 to 9.9E37 | MAXimum | MINimum Parameters Ω (ohms/second) Unit MAXimum *RST Value RES:SLEW:NEG 50 RES:SLEW:NEG MAX Examples [SOURce:]RESistance:SLEW:NEGative? Query Syntax <NR3> Returned Parameters RES:SLEW Related Commands [SOURce:]RESistance:SLEW:POSitive Channel Specific This command sets the slew rate of the resistance for positive going transitions. MAXimum sets the slew to the fastest possible rate.
4 - Language Dictionary [SOURce:]VOLTage Channel Specific This command sets the voltage that the load will regulate when operating in constant voltage mode. Refer to Table 4-1 for model-specific programming ranges. [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] <NRf+> Command Syntax 0 through MAX | MINimum | MAXimum Parameters V (volts) Unit...
Language Dictionary - 4 [SOURce:]VOLTage:RANGe <NRf+> Command Syntax 0 through MAX | MINimum | MAXimum Parameters V (volts) Unit MAXimum (high range) *RST Value VOLT:RANG 15 SOUR:VOLT:RANGE MIN Examples [SOURce:]VOLTage:RANGe? Query Syntax <NR3> Returned Parameters VOLT VOLT:SLEW Related Commands [SOURce:]VOLTage:SLEW Channel Specific This command sets the slew rate for all programmed changes in the input voltage level of the electronic load.
4 - Language Dictionary [SOURce:]VOLTage:SLEW:POSitive Channel Specific This command sets the slew rate of the voltage for positive going transitions. MAXimum sets the slew to the fastest possible rate. MINimum sets the slew to the slowest rate. [SOURce:]VOLTage:SLEW:POSitive <NRf+> Command Syntax 0 to 9.9E37 | MAXimum | MINimum Parameters V (volts per second)
Language Dictionary - 4 Measurement Commands Measurement commands consist of measurement and sense commands. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new data before returning the readings from the array. FETCh returns previously acquired data from the array.
4 - Language Dictionary MEASure:ARRay:VOLTage? FETCh:ARRay:VOLTage? Channel Specific These queries return an array containing the instantaneous input voltage. MEASure:ARRay:VOLTage[:DC]? Query Syntax FETCh:ARRay:VOLTage[:DC]? None Parameters MEAS:ARR:VOLT? FETC:ARR:VOLT? Examples 4096 NR3 values Returned Parameters MEAS:ARR:CURR? Related Commands MEASure:CURRent? FETCh:CURRent? Channel Specific These queries return the average value of the input current. MEASure:[SCALar]:CURRent[:DC]? Query Syntax FETCh:[SCALar]:CURRent[:DC]?
Language Dictionary - 4 MEASure:CURRent:MINimum? FETCh:CURRent:MINimum? Channel Specific These queries return the value of the minimum data point in the input current measurement. MEASure:[SCALar]:CURRent:MINimum? Query Syntax FETCh:[SCALar]:CURRent:MINimum? None Parameters MEAS:CURR:MIN? FETC:CURR:MIN? Examples <NR3> Returned Parameters MEAS:CURR:ACDC? Related Commands MEASure:POWer? FETCh:POWer? Channel Specific These queries return the average value of the input power in watts.
4 - Language Dictionary MEASure:VOLTage? FETCh:VOLTage? Channel Specific These queries return the average value of the input voltage. MEASure:[SCALar]:VOLTage[:DC]? Query Syntax FETCh:[SCALar]:VOLTage[:DC]? None Parameters MEAS:VOLT? FETC:VOLT? Examples <NR3> Returned Parameters MEAS:CURR? MEAS:VOLT:ACDC? Related Commands MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC? Channel Specific These queries return the rms value of the input voltage. This returns the total rms measurement, including the dc portion.
Language Dictionary - 4 SENSe:CURRent:RANGe Channel Specific This command sets the current measurement range. There are two current measurement ranges: High Range: model dependent, see Table 4-1 Low Range: model dependent, see Table 4-1 A value of infinity is returned if the measured value is outside the specified current measurement range. SENSe:CURRent:RANGe <NRf+>...
4 - Language Dictionary SENSe:SWEep:TINTerval Channel Specific This command defines the time period between measurement points. The time interval can be programmed from 0.00001 to 0.032 seconds in 10 microsecond increments. SENSe:SWEep:TINTerval <NRf+> Command Syntax 0.00001 - 0.032 | MAXimum | MINimum Parameters Unit seconds...
Language Dictionary - 4 Port Commands These commands control the general purpose digital port on the electronic load modules. PORT0 Channel Specific This command sets the state of the general purpose digital port on the specified electronic load module. A value of 1 sets the state high, a 0 sets the state low. PORT0[:STATe] <bool>...
4 - Language Dictionary List Commands List commands let you program complex sequences of input changes with rapid, precise timing, and synchronized with trigger signals. Each function for which lists can be generated has a list of values that specify the input at each list step. MODE commands such as VOLTage:MODE LIST are used to activate specific functions.
Language Dictionary - 4 [SOURce:]LIST:CURRent:RANGe [SOURce:]LIST:CURRent:RANGe:POINts? Channel Specific This command sets the current range for each list step. There are two current ranges. High Range: model dependent, see Table 4-1 Low Range: model dependent, see Table 4-1 When you program a range value, the load automatically selects the range that corresponds to the value that you program.
4 - Language Dictionary [SOURce:]LIST:CURRent:SLEW:NEGative Channel Specific This command sets the negative current slew rate for each step. MAXimum sets the slew to its fastest possible rate. MINimum sets the slew to its slowest rate. [SOURce:]LIST:CURRent:SLEW:NEGative <NRf+> {,<NRf+>} Command Syntax 0 to 9.9E37 | MAXimum | MINimum Parameters A (amperes per second)
Language Dictionary - 4 [SOURce:]LIST:FUNCtion [SOURce:]LIST:MODE [SOURce:]LIST:FUNCtion:POINTs? Channel Specific These equivalent commands specify the regulation mode for each list step. LIST:FUNCtion:POINts? returns the number of points programmed. constant current mode CURR constant resistance mode constant voltage mode VOLT [SOURce:]LIST:FUNCtion <function> {,<function>} Command Syntax [SOURce:]LIST:MODE <function>...
4 - Language Dictionary [SOURce:]LIST:RESistance [SOURce:]LIST:RESistance:POINts? Channel Specific This command specifies the resistance setting for each list step. Refer to Table 4-1 for model-specific programming ranges. LIST:RESistance:POINts? returns the number of points programmed. [SOURce:]LIST:RESistance[:LEVel] <NRf+> {,<NRf+>} Command Syntax 0 through MAX | MINimum | MAXimum Parameters Ω...
Language Dictionary - 4 [SOURce:]LIST:RESistance:SLEW [SOURce:]LIST:RESistance:SLEW:POINts? Channel Specific This command sets the resistance slew rate for each step. This command programs both positive and negative going slew rates. MAXimum sets the slew to its fastest possible rate. MINimum sets the slew to its slowest rate.
4 - Language Dictionary [SOURce:]LIST:RESistance:TLEVel [SOURce:]LIST:RESistance:TLEVel:POINTs? Channel Specific This command specifies the transient resistance level for each step. The transient function switches between the immediate setting and the transient level. LIST:RESistance:TLEVel:POINts? returns the number of points programmed. [SOURce:]LIST:RESistance:TLEVel <NRf+> {,<NRf+>} Command Syntax refer to Table 4-1 Parameters...
Language Dictionary - 4 [SOURce:]LIST:TRANsient:DCYCle [SOURce:]LIST:TRANsient:DCYCle:POINts? Channel Specific This command sets the transient duty cycle for each step when the generator is in CONTinuous mode. LIST:TRANsient:DCYCle:POINts? returns the number of points programmed. [SOURce:]LIST:TRANsient:DCYCle <NRf+> {,<NRf+>} Command Syntax 1.8% - 98.2% | MAXimum | MINimum Parameters percent Units...
4 - Language Dictionary [SOURce:]LIST:TRANsient:TWIDth [SOURce:]LIST:TRANsient:TWIDth:POINts? Channel Specific This command sets the transient pulse width for each step when the generator is in PULSe mode. LIST:TRANsient:TWIDth:POINts? returns the number of points programmed. [SOURce:] LIST:TRANsient:TWIDth <NRf+> {,<NRf+>} Command Syntax 0.00005s - 4s | MAXimum | MINimum Parameters Unit seconds...
Language Dictionary - 4 [SOURce:]LIST:VOLTage:RANGe <NRf+> {,<NRf+>} Command Syntax 0 through MAX | MINimum | MAXimum Parameters V (volts) Unit MAX (high range) *RST Value LIST:VOLT:RANGE MIN Examples [SOURce:]LIST:VOLTage:RANGe? Query Syntax [SOURce:]LIST:VOLTage:RANGe:POINTs? <NR3> {,<NR3>} Returned Parameters VOLT:RANG Related Commands [SOURce:]LIST:VOLTage:SLEW [SOURce:]LIST:VOLTage:SLEW:POINts? Channel Specific This command sets the voltage slew rate for each step.
4 - Language Dictionary [SOURce:]LIST:VOLTage:SLEW:POSitive Channel Specific This command sets the positive voltage slew rate for each step. MAXimum sets the slew to its fastest possible rate. MINimum sets the slew to its slowest rate. [SOURce:]LIST:VOLTage:SLEW:POSitive <NRf+> {,<NRf+>} Command Syntax 0 to 9.9E37 | MAXimum | MINimum Parameters V (volts per second)
Language Dictionary - 4 Transient Commands These commands program the transient generator of the electronic load. The transient generator programs a second (transient) level at which the electronic load can operate without changing the original programmed settings. See also [SOURce:]CURRent:TLEVel, [SOURce:]RESistance:TLEVel, and [SOURce:]VOLTage:TLEVel in the Input Commands section.
4 - Language Dictionary [SOURce:]TRANsient:MODE Channel Specific This command selects the operating mode of the transient generator as follows. The transient generator puts out a continuous pulse stream. CONTinuous The transient generator puts out a single pulse upon receipt of a trigger. PULSe The transient generator toggles between two levels upon receipt of a trigger.
Language Dictionary - 4 Status Commands These commands program the electronic load status registers. The electronic load has five groups of status registers; Channel Status, Channel Summary, Questionable Status, Standard Event Status, and Operation Status. Refer to chapter 3 under “Programming the Status Registers” for more information. Bit Configuration of Channel Status Registers Bit Position 15-14...
4 - Language Dictionary STATus:CSUM? This query returns the value of the Channel Event summary register. The bits in this register correspond to a summary of the channel register for each input channel. Reading the Channel Event summary register clears it. This command is not channel specific, it applies to the entire mainframe. STATus:CSUMmary[:EVENt]? Query Syntax None...
Language Dictionary - 4 STATus:OPERation:ENABle This command and its query set and read the value of the Operation Enable register. This register is a mask for enabling specific bits from the Operation Event register to set the operation summary bit (OPER) of the Status Byte register.
4 - Language Dictionary Bit Configuration of Questionable Status Registers Bit Position 15-14 7–5 Bit Name N.U. N.U. N.U. Bit Weight 8192 4096 2048 1024 voltage fault has occurred extended power unavailable over-current condition has occurred input is unregulated over-power condition has occurred reverse voltage on the input terminals over-temperature condition has occurred over-voltage condition has occurred...
Language Dictionary - 4 System Commands System commands control the system-level functions of the electronic load that are not directly related to input control or measurement functions. SYSTem:ERRor? This query returns the next error number followed by its corresponding error message string from the remote programming error queue.
4 - Language Dictionary Trigger Commands Trigger commands controls the triggering of the electronic load. Chapter 3 under "Triggering Changes" provides an explanation of the Trigger System. See also [SOURce:]CURRent:TRIGgered, [SOURce:]RESistance:TRIGgered, and [SOURce:]VOLTage:TRIGgered in the Input Commands section. The list and measurement commands must first be enabled using the INITiate commands NOTE: or no action due to triggering will occur.
Language Dictionary - 4 INITiate[:IMMediate]:SEQuence2 Command Syntax INITiate[:IMMediate]:NAME ACQuire For INIT:NAME: ACQuire Parameters INIT:SEQ2 INIT:NAME ACQ Examples ABOR INIT:CONT TRIG *TRG Related Commands INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME These equivalent commands prepare the list to respond to trigger commands. ON or 1 continuously initiates the list.
4 - Language Dictionary TRIGger:SEQuence2:COUNt This command sets up a successive number of triggers for measuring data. With this command, the trigger system needs to be initialized only once at the start of the acquisition period. After each completed measurement, the instrument waits for the next valid trigger condition to start another measurement. This continues until the count has completed.
Language Dictionary - 4 Common Commands Common commands begin with an * and consist of three letters (command) IEEE 488.2 standard to perform some common interface functions. The electronic loads respond to the required common commands that control status reporting, synchronization, and internal operations. The electronic loads also respond to optional common commands that control triggers, power-on conditions, and stored operating parameters.
4 - Language Dictionary Bit Configuration of Standard Event Status Enable Register Bit Position Bit Name not used not used Bit Weight Power-on Device-dependent error Command error Query error Execution error Operation complete *ESR? This query reads the Standard Event Status Event register. Reading the register clears it. The bit configuration of this register is the same as the Standard Event Status Enable register (see *ESE).
Page 101
Language Dictionary - 4 *OPT? This query requests the electronic load to identify any options that are installed. Options are identified by number. A 0 indicates no options are installed. *OPT? Query Syntax <AARD> Returned Parameters *PSC This command controls the automatic clearing at power-on of the Service Request Enable and the Standard Event Status enable registers as follows (see chapter 3 under “Programming the Status Registers”...
Page 102
4 - Language Dictionary *RDT? This query reads the model numbers of the modules installed in the mainframe. It returns the data in comma-separated fields. *RDT? Query Syntax None Parameters model numbers separated by commas Returned Parameters CHAN1:N3302A; CHAN2:N3302A; CHAN3:N3304A Example *RST This command resets ALL channels of the electronic load to the following factory-defined states:...
Page 103
Language Dictionary - 4 *SAV This command stores the present state of the electronic load to a specified location in memory. Up to 10 states can be stored. States in saved in locations 1-6 are volatile, the data will be lost when power is turned off.
4 - Language Dictionary Bit Configuration of Status Byte Register Bit Position Bit Name OPER MSS/RQS QUES CSUM not used Bit Weight OPER operation status summary message available master status summary QUES questionable status summary request for service CSUM channel summary event status byte summary *TRG This command generates a trigger to any system that has BUS selected as its source (for example,...
SCPI Command Tree Command Syntax Resets the trigger system to the Idle state ABORt CALibrate Enters the calibration data :DATA <n> {,<n>,<n>} Set cal points for current monitor offset (P1 | P2) :IMON:LEVel <points> Set cal points for current monitor & programming (P1|P2|P3|P4) :IPRog:LEVel <points>...
A - SCPI Command Tree SENSe :CURRent Selects the current measurement range :RANGe <n> :SWEep Defines the data offset in the measurement :OFFSet Define the number of data points in the measurement :POINts <n> Sets the digitizer sample spacing :TINTerval <n> Sets the measurement window function (HANN | RECT) :WINDow [:TYPE] <type>...
Page 107
SCPI Command Tree - A [SOURce:]LIST (continued) :SLEW Sets the resistance slew rate for each step [:BOTH] <n> {,<n>} Returns the number of resistance slew list points :POINts? Sets the negative resistance slew rate for each step :NEGative <n> {,<n>} Sets the positive resistance slew rate for each step :POSitive <n>...
Page 108
A - SCPI Command Tree [SOURce:](continued) VOLTage [:LEVel] Sets the input voltage [:IMMediate][:AMPLitude] <n> Sets the triggered input voltage :TRIGgered [:AMPLitude] <n> Sets the voltage mode (FIX |LIST) :MODE <mode> Sets the input voltage range :RANGe <n> :SLEW Sets the voltage slew rate [:BOTH] <n>...
Error Messages Error Number List This appendix gives the error numbers and descriptions that are returned by the electronic load. Error numbers are returned in two ways: ♦ Error numbers are displayed on the front panel ♦ Error numbers and messages are read back with the SYSTem:ERRor? query. SYSTem:ERRor? returns the error number into a variable and returns two parameters, an NR1 and a string.
Page 110
B – Error Messages –168 Block data not allowed –170 Expression error –171 Invalid expression –178 Expression data not allowed Execution Errors –200 through –299 (sets Standard Event Status Register bit #4) –200 Execution error [generic] –221 Settings conflict [check current device state] –222 Data out of range [e.g., too large for this device] –223...
Page 111
Error Messages - B RS-232 buffer overrun error RS-232 receiver framing error RS-232 receiver parity error RS-232 receiver overrun error Front panel uart overrun Front panel uart framing Front panel uart parity Front panel buffer overrun Front panel timeout CAL switch prevents calibration CAL password is incorrect CAL not enabled Computed readback cal constants are incorrect...
Comparing N3300A Series Electronic Loads with Earlier Models Introduction The Keysight N3300A Series Electronic Loads covered by this manual are compatible in many ways with the previous HP/Keysight 6050B, 6051B, 60501B, 60502B, 60503B, 60504B, 60507B Electronic Loads. This means that in most cases, programs written for earlier electronic loads will run on the N3300A Series Electronic Loads.
Page 114
C – Comparison With Earlier Models Table C-2. Reasons for Differences Item HP/Keysight Series 6050x Keysight Series N3300A 70 milliseconds (typical) 5 milliseconds (typical) 1. Command If external equipment is connected to the load, the decreased command Execution Time execution time of the N3300A Series loads may not allow sufficient settling time for the equipment under test.
Page 115
Comparison With Earlier Models – C Table C-2. Differences (continued) Item HP/Keysight Series 6050x Keysight Series N3300A Firmware turns the input off Firmware does not turn the input off 7. Mode/Range between mode and range changes. between mode and range changes. Change Performance The input is no longer programmed off when modes and ranges change.
Page 116
C – Comparison With Earlier Models Table C-2. Differences (continued) Item HP/Keysight Series 6050x Keysight Series N3300A Current (60A) = 4.5% +75mA Refer to Appendix A in the N3300A 15. CC and CV Analog Voltage (60V) = 0.8% +200mV Series User's Guide. Programming This feature improves analog programming accuracy in both constant Accuracy...
Index —A— —D— AARD, 19 dc measurements, 31 delaying triggers, 30 determining cause of interrupt, 43 —C— device clear, 20 DTR-DSR, 14 calibration subsystem, 55 CALibrate DATA, 55 CALibrate IMON LEVel, 55 —E— CALibrate IPRog LEVel, 55 CALibrate LEVel, 55 enabling the output, 23 CALibrate PASSword, 56 error numbers, 107...
Page 118
Index newline, 18 —L— message unit language, 111 separator, 18 language dictionary, 53 minimum measurements, 32 moving among subsystems, 16 list transients, 28 MSS bit, 42 list trigger system model, 29 lists, 26 multiple measurements, 35 programming, 26 —N— —M— numerical data formats, 18 making measurements, 31 MAV bit, 43...
Page 119
Index LIST RESistance RANGe POINts?, 80 command syntax, 53 LIST RESistance SLEW, 81 command tree, 15 common commands, 15 LIST RESistance SLEW NEGative, 81 conformance, 21 LIST RESistance SLEW POINts?, 81 data format, 18 LIST RESistance SLEW POSitive, 81 LIST RESistance TLEVel, 82 device clear, 20 header path, 16 LIST RESistance TLEVel POINts?, 82...
Page 120
Index status operation registers ABORt, 69, 94 bit configuration, 90 INITiate ACQuire, 94 status subsystem, 89 INITiate CONTinuous LIST, 95 STATus CHANnel CONDition?, 89 INITiate CONTinuous SEQuence, 95 STATus CHANnel ENABle, 89 INITiate LIST, 94 STATus CHANnel?, 89 INITiate SEQuence, 94 STATus CSUMmary ENABle, 90 INITiate SEQuence2, 94 STATus CSUMmary?, 90...
Need help?
Do you have a question about the N3301A and is the answer not in the manual?
Questions and answers