Clears the event registers and error queues. It clears the Standard Event Status Register, Status Byte Register, and the event registers for Questionable, Operation, and Measurement status, and clears the error queue.
*CLS
SCPI COMMAND REFERENCE
The Keithley 2280S-60-3 is Keithley's power supply in the Series 2280S Precision Measurement DC Power Supplies family. Its SCPI remote-control interface exposes 146 commands across 23 subsystems - 109 settable and 37 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
146
Commands
109
Settable
37
Queries
23
Subsystems
SCPI
1999.0
Verified
2026-07-16
Clears the event registers and error queues. It clears the Standard Event Status Register, Status Byte Register, and the event registers for Questionable, Operation, and Measurement status, and clears the error queue.
*CLS
Sets and queries bits in the Standard Event Status Enable Register. Sending 0 clears all bits; the query returns the register as a decimal value representing the binary-weighted sum of set bits.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 255 | Value of the Standard Event Status Enable Register. |
*ESE 145
Reads the Standard Event Status Register (SESR), returning a decimal value corresponding to the binary-weighted sum of all bits set, and clears the register.
*ESR?
Retrieves the instrument identification string. The returned string includes the manufacturer, model number, serial number, and firmware revision in the format KEITHLEY INSTRUMENTS,MODEL nnnn,xxxxxxx,yyyyy.
Sets the operation complete (OPC) bit after all pending commands, including overlapped commands, have been executed.
Determines which command set is used by the instrument. The only available remote command set is SCPI.
*LANG?
Restores the instrument to the setup that was saved with the *SAV command. The setup is recalled from setup memory location 1 to 5.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 5 | Integer identifying the saved setup memory location to recall. |
*RCL 3
Resets the instrument settings to their default values. It cancels all pending commands and cancels the response to any previously received *OPC and *OPC? commands.
Saves the present instrument settings as a user-saved setup in nonvolatile memory. Stored settings can later be restored with *RCL; any previously stored setup at the same index is overwritten.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 5 | Memory location to save the setup in. |
*SAV 2
Sets or queries the bits of the Status Request Enable Register. To set a bit, send the constant or the value of the bit as the <n> parameter; 0 clears all bits. The query returns the register value as a decimal number corresponding to the binary-weighted sum of the set bits.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 | Constant or bit value to set in the Status Request Enable Register. |
*SRE 0
Reads the contents of the Status Byte Register. It returns a decimal value corresponding to the binary-weighted sum of all bits set in the register, and does not clear the bits.
Generates a trigger event from a remote command interface. It has the same effect as a group execute trigger (GET).
*TRG *TRG
Performs a complete self-test and returns the results. Sending the command returns 0; a self-test is not performed.
*TST?
Postpones execution of subsequent commands until all previously issued overlapped commands have finished. It is not needed for sequential commands.
Stops all trigger model commands on the instrument. With continuous initiation disabled, the specified channel's trigger model goes into the idle state; with continuous initiation enabled, operation continues at the top of the trigger model.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
Configures the instrument to a specific setup for measurements. If sent without parameters, the present setting values for range and the selected measurement function are used.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which the setting applies. |
| rangeopt | real | - | Range value for the selected measurement function. |
| resolutionopt | integer | - | Resolution setting: 4.5, 5.5, or 6.5 digit resolution. |
:CONF:CURR 0.01,5
Reads the latest post-processed reading. It does not trigger a measurement; it returns the last available reading, with the format determined by :FORMat:ELEMents.
:FORM:ELEM "READ,UNIT" Specify the data elements contained in the readings. :FETCh? Return the latest reading.
Specifies or queries which data elements are included in the data string. Up to 9 elements may be listed, in any order, and elements may be repeated; items can be separated by commas and enclosed in single or double quotes.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | READing | SOURce | UNIT | MODE | DATE | TIME | TSTamp | RELative | RSTamp | Data elements to include in the data string. |
:FORMat:ELEMents <item list> :FORMat:ELEMents?
Bypasses the control source of the Arm layer or Trigger layer so you do not need to wait for the programmed event to occur.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
:FORC:TRIG
Makes a measurement using the specified function and returns the reading. If the buffer is set to NEVer mode, it only measures and returns the reading without saving it in the buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to use. |
| rangeopt | real | 0.01 - 32 V | Measurement range value. Current and concurrent ranges are 0.01, 0.1, 1, and 10; voltage range is 32 V or 60 V depending on model. |
| resolutionopt | integer | 4 - 6 | Display resolution in digits: 4.5, 5.5, or 6.5. |
:MEAS:CURR? 10,5
Makes measurements and returns the first reading. When executed, it resets the trigger model and then performs :ABORt, :INITiate, and :FETCh?.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
:READ[n]?
Sets the number of times to repeat the Arm event.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| count | integer | 1 - 2500 | Number of times to repeat the arm event. |
ARM:COUN 4
Selects the control source for the arm layer. For single-channel instruments, [n] is 1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number. For single-channel instruments, the value is 1. |
| source | enum | IMMediate | EXTernal | MANual | BUS | Trigger source for the arm layer. |
ARM:SOUR BUS
Specifies which math operation is performed on measurements for the selected measurement function. The operation is saved in settings and can be set per channel.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which this setting applies. |
| name | enum | MXB | The name of the math operation. |
| channel | enum | CH1 | CH2 | Channel number, defaulting to CH1. |
:CALC:VOLT:FORM MXB
Specifies the offset for the y = mx + b math operation. It can be set for a selected measurement function and, optionally, a channel.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which this setting applies. |
| n | real | -1e6 - +1e6 | The offset for the y = mx + b operation. |
| channel | enum | CH1 | CH2 | The channel number. |
Specifies the scale factor for the y = mx + b math operation for the selected measurement function. The command can be used as a setter or a query, and it is associated with the Concurrent, Current, and Voltage measurement functions.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | -1e6 - +1e6 | The scale factor. |
| channelopt | enum | CH1 | CH2 | Channel number; default value is CH1. |
:CALC:VOLT:KMAT:MMF 0.80 :CALC:VOLT:KMAT:MMF 0.80
Specifies the units suffix name for the y = mx + b math operation. The units suffix must be one letter of the alphabet, enclosed in single or double quotes.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which this setting applies. |
| string | string | - | The units suffix name for the mx + b calculation; must be one character enclosed in single or double quotes. |
| channel | enum | CH1 | CH2 | The channel number (default value is CH1). |
Enables or disables the math operations for the specified measurement function. When set to on, the math operation specified by the math format command is performed before completing a measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the math operation. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which this setting applies. |
| channelopt | enum | CH1 | CH2 | The channel number. |
:CALC:VOLT:FORM MXB Set the math function for voltage measurements to mx + b. :CALC:VOLT:KMAT:MMF 0.80 Set the scale factor for voltage measurements to 0.80. :CALC:VOLT:KMAT:MBF 50 Set the offset factor to 50. :CALC:VOLT:KMAT:MUN 'C' Set unit to 'C' :CALC:VOLT:STATE ON Enable the math function.
Reads the results of specified statistics for the selected channel. The results are returned in the order Minimum, Maximum, Mean, Standard deviation, and Peak to peak.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | Channel number to read; default is CH1. |
:CALCulate2:DATA? :CALCulate2:DATA? <channel>
Selects or queries which math statistics are used on readings stored in the buffer. Multiple statistics may be specified, separated by commas, and the selected statistics are returned in the order MIN, MAX, MEAN, PKPK, SDEV.
| Name | Type | Values | Description |
|---|---|---|---|
| itemList | enum | MINimum | MAXimum | MEAN | SDEViation | PKPK | NONE | Available math statistics to select for the calculation format. |
| channelopt | enum | CH1 | CH2 | Channel number; default is CH1. |
Specifies or queries which data elements are included in the data string. It only affects minimum and maximum query results.
| Name | Type | Values | Description |
|---|---|---|---|
| itemList | enum | READing | UNIT | RNUMber | TSTamp | Available data elements to include in the data string. |
| channelopt | enum | CH1 | CH2 | Channel number; default is CH1. |
:CALCulate2:FORMat:ELEMents <itemList> :CALCulate2:FORMat:ELEMents <itemList>,<channel> :CALCulate2:FORMat:ELEMents? :CALCulate2:FORMat:ELEMents? <channel>
Selects which buffer data type statistic operations use. You can apply statistics to current data only or voltage data only, optionally for a specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | CURRent | VOLTage | Data type to use for statistic operations. |
| channelopt | enum | CH1 | CH2 | Channel number to use; default is CH1. |
:CALCulate2:FUNCtion <function> :CALCulate2:FUNCtion <function>,<channel> :CALCulate2:FUNCtion? :CALCulate2:FUNCtion? <channel>
Performs the selected statistic operation and reads the results. If used as a query, it finishes the selected statistic operation and returns the calculation results.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | integer | 1 - 2 | The channel number; default is CH1. |
:CALCulate2:IMMediate :CALCulate2:IMMediate <channel> :CALCulate2:IMMediate? :CALCulate2:IMMediate? <channel>
Enables or disables the statistic calculations for CALCulate2. It is saved and recalled with instrument settings and defaults to OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enable or disable statistic calculations. |
| channelopt | enum | CH1 | CH2 | Selects the channel number; default is CH1. |
:CALCulate2:STATe <state> :CALCulate2:STATe <state>,<channel> :CALCulate2:STATe? :CALCulate2:STATe? <channel>
Cancels the calibration procedures and drops the new calibration constants. When sent, the instrument cancels the calibration and loses the new constants.
:CAL:PROT:CANC
Changes the calibration password. The password must be enabled by entering calibration mode first.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Calibration password: an 8-character string including letters and numbers. |
:CAL:PROT:CODE '12345678' Change the calibration password to "12345678".
Returns the number of times that the instrument has completed calibration. The calibration count increases after saving the calibration constants.
:CAL:PROT:COUN?
Queries the saved calibration constants.
Specifies the calibration date. The query returns the latest calibration date in year, month, day format.
| Name | Type | Values | Description |
|---|---|---|---|
| year | integer | 1971 | Year of the calibration date; must be more than 1970. |
| month | integer | 1 - 12 | Month of the calibration date. |
| day | integer | 1 - 31 | Day of the calibration date. |
:CAL:PROT:DATE 2014, 5, 12
Performs one step of the protected calibration procedure. The <step> suffix selects calibration step 1 through 8 for the specified channel, if applicable.
| Name | Type | Values | Description |
|---|---|---|---|
| step | integer | 1 - 8 | Calibration step number to start. |
| nopt | integer | 1 | Channel number; for single-channel instruments, the value is 1. |
:CALibration:PROTected[:DC[n]]:STEP1 :CALibration:PROTected[:DC[n]]:STEP2 :CALibration:PROTected[:DC[n]]:STEP3 :CALibration:PROTected[:DC[n]]:STEP4 :CALibration:PROTected[:DC[n]]:STEP5 :CALibration:PROTected[:DC[n]]:STEP6 :CALibration:PROTected[:DC[n]]:STEP7 :CALibration:PROTected[:DC[n]]:STEP8
Enters the voltage or resistance values used for calibration calculations. Steps 6 and 8 do not require external data entry; the instrument can collect the data automatically.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | - | Voltage reading from the external DMM. |
| resistance | real | - | Resistance of the resistor load. |
:CALibration:PROTected[:DC[n]]:STEP1:DATA <voltage> :CALibration:PROTected[:DC[n]]:STEP2:DATA <voltage> :CALibration:PROTected[:DC[n]]:STEP3:DATA <voltage>,<resistance> :CALibration:PROTected[:DC[n]]:STEP4:DATA <voltage>,<resistance> :CALibration:PROTected[:DC[n]]:STEP5:DATA <voltage>,<resistance> :CALibration:PROTected[:DC[n]]:STEP6:DATA :CALibration:PROTected[:DC[n]]:STEP7:DATA <voltage>,<resistance> :CALibration:PROTected[:DC[n]]:STEP8:DATA
Saves the calibration constants to nonvolatile memory after calibration has been completed. If the instrument exits calibration mode without first saving the new constants, the previous constants are restored.
:CAL:PROT:SAVE Save calibration constants to memory.
Enables or disables calibration procedures for remote-interface calibration operations. A calibration password is required when using the command.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enable or disable the calibration mode. |
| password | string | - | Calibration password; maximum length 8 characters and not case sensitive. |
:CAL:PROT:STAT ON, 'KI002280'
Sets the specified digital I/O line to be a digital line and configures its function as input or output. The function can be AUTO for lines 1 to 3, or a fixed output/input mode.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 6 | The digital I/O line. |
| function | enum | AUTO | MOUTH | MOUTL | MINPut | The pin state or function. |
:DIG:LINE1:FUNC MINPut
Queries the data from the manual input to a digital I/O line. If the line is not assigned to manual input, the query returns no data and the instrument generates error 508.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 6 | The digital I/O line. |
:DIG:LINE1:MAN:INP:DATA? Query the data from manual input to the digital I/O pin.
Sets or queries the brightness of the front-panel display. Brightness affects screen life; higher brightness and longer on-time shorten screen life.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | real | 5 - 100 | The brightness of the display. |
:DISP:BRIG 50
Removes the user-defined text message from the OUTPUT view screen and returns the instrument to normal mode.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | - | Channel number to clear; default is CH1. |
:DISP:CLE
Specifies which screen is displayed on the front-panel. You can select the Home, Graph, or Data Sheet screen.
| Name | Type | Values | Description |
|---|---|---|---|
| screenName | enum | HOME | GRAPh | DATasheet | The screen to display. |
:DISP:SCRE DAT DAT
Defines the text displayed on the front-panel OUTPUT view screen. The text must be enclosed in single or double quotes and can be up to 24 characters; too many characters produces error -223.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | String that contains the message; up to 24 characters. |
| channelopt | enum | CH1 | CH2 | The channel number; default value is CH1. |
:DISP:USER:TEXT "Test running"
Enables or disables continuous triggering. With continuous initiation enabled, sending :INITiate causes error -213, "init ignored."
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| state | enum | OFF | 0 | ON | 1 | Disables or enables continuous triggering. |
INIT:CONT OFF
Starts the trigger model. For single-channel instruments, the channel number is 1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number. |
:INITiate[n][:IMMediate]
Recalls the specified setup from the external USB flash drive to the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| fileName | string | - | Name for the imported setup, maximum 8 characters. |
Exports the present setup to the external USB flash drive. The saved setup name is specified as a file name with a maximum of 8 characters.
| Name | Type | Values | Description |
|---|---|---|---|
| fileName | string | - | A string that contains a name for the saved setup (maximum 8 characters). |
:MMEMory:SAVE:SETup "mysetup"
Specifies a delay before the instrument turns off the specified output. It affects on-to-off transitions and can be set per channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 10 | Delay falling time. |
| channelopt | enum | CH1 | CH2 | Channel number; default is CH1. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Optional query qualifier returning the default, minimum, or maximum value. |
:OUTP:DELay:FALLing 1 Set the falling delay time to 1 s.
Specifies the delay time that the instrument waits before turning on the specified output. It sets the rising delay so the output will not turn on until the delay has elapsed, affecting off-to-on transitions including :OUTPut:STATe ON.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | real | 0 - 10 | Delay rising time. |
| channelopt | enum | CH1 | CH2 | The channel number (default value is CH1). |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Query qualifier for returning the present value, the minimum allowed value, or the maximum allowed value. |
:OUTP:DEL:RIS 1
Enables or disables the output delay time used before the instrument turns the output on and off. When set to ON, the instrument waits the specified delay time before enabling or disabling the output.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | Disables or enables output delay. |
:OUTP:DEL:STAT ON Enable the output delay
Clears the overvoltage, overcurrent, overtemperature, or reverse fault status. It also clears the related Questionable Instrument Summary Condition Register bit for those faults.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | The channel number; default value is CH1. |
:OUTP:PROT:CLE Clear the protection status.
Queries whether overvoltage, overcurrent, overtemperature, or reverse fault protection has been tripped.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | channel_list | - | The channel number; default is CH1. |
:OUTP:PROT:TRIP? CH1 If the overvoltage protection circuit in channel 1 is tripped, the query returns OVP. If the protection circuit is not tripped, the query returns NONE.
Enables or disables the source output. The command can also be applied to a specific channel, and measurements cannot be made while the source is off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | DISable | 2 | Turns the source output off, on, or disables the source. |
| channelopt | enum | CH1 | CH2 | The channel number. |
:OUTP ON
Selects which measurement function is active for the specified channel. The active function may be Concurrent, current, or voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| name | string | - | String containing the measurement function to make active: CONCurrent[:DC], CURRent[:DC], or VOLTage[:DC]. |
:SENS:FUNC "VOLT"
Sets the number of measurements that are averaged when filtering is enabled for the specified function. The filter count determines how many readings are acquired and stored in the filter stack for the averaging calculation.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which this setting applies. |
| value | integer | 2 - 100 | Number of readings required for each filtered measurement. |
Enables or disables the averaging filter for measurements of the selected function. When enabled, the instrument returns an averaged reading based on multiple measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which the averaging filter applies. |
| state | enum | OFF | 0 | ON | 1 | Filter status; OFF or 0 disables the averaging filter, ON or 1 enables it. |
Sets the type of averaging filter used for measurements on the selected function when measurement filtering is enabled. The only listed filter type is Moving average (MOVing).
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | MOVing | The filter type to use when filtering is enabled. |
Specifies the filter window used to control filter threshold for the selected measurement function. The value is expressed as a percentage and is rounded up by the instrument to the nearest supported window value.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which this setting applies. |
| value | real | 0.01 - 100 | The filter window percentage. |
| qualifieropt | enum | MINimum | MAXimum | DEFault | Optional query qualifier to return the minimum, maximum, or default window value. |
SENS:CONC:AVER:WIND 0.1
Determines the number of digits displayed for measurements on the front panel. It does not affect remote command readings, measurement accuracy, or speed, and the setting is saved with the function setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 4 - 6 | Sets the display resolution to 4.5, 5.5, or 6.5 digits. |
| qualifieropt | enum | MINimum | MAXimum | DEFault | Optional query qualifier that returns the minimum, maximum, or default digit setting. |
:SENS:CURR:DIG 5
Sets the measurement integration time in power-line cycles for the selected measurement function. The setting applies to concurrent, current, or voltage measurements and is saved in recall/save settings, surviving reset and power cycle.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which the setting applies. |
| value | real | 0.002 - 12 | Number of power-line cycles for each measurement for 50 Hz operation. |
:SENS:CURR:NPLC 0.5
Sets the measurement range for measurements of the selected function. When read, it returns the measurement range the instrument is presently using; setting a value disables autorange for that function.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | - | Channel number; for single-channel instruments, the value is 1. |
| range | real | 0.01 A - 32 V | Specific measurement range or preset value to use. |
:SENS:CURR:RANG 0.01 :SENS:CONC:RANG 1 :SENS:VOLT:RANG 32
Determines whether the measurement range for the selected function is selected manually or automatically. When set to OFF, the range must be set manually; when set to ON, the instrument selects the most sensitive range automatically.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | Sets manual or automatic range selection. |
:SENS:CURR:RANG:AUTO ON
Specifies the relative offset value for the measurement. When relative offset is enabled, subsequent measured readings are offset by the value set for this command.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| ref | real | -6.1 - 6.1 | Relative offset value for concurrent and current measurements on Model 2280S-32-6; range is -3.3 to 3.3 A on Model 2280S-60-3. |
SENS:CONC:REF 1
Acquires a new measurement for the selected function and stores it as the relative offset value. The measurement is taken without applying any filter operations.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which the setting applies. |
:SENS:VOLT:REF:ACQ
Enables or disables a relative offset value for the selected measurement function. When enabled, subsequent measured readings are offset by the stored relative offset value.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | - | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | The measurement function to which the setting applies. |
| state | enum | OFF | 0 | ON | 1 | Disable or enable the relative offset. |
:SENS:FUNC "VOLT" Set the measurement function to voltage with a :SENS:VOLT:REF:ACQ relative offset of 5 V and enable the relative offset :SENS:VOLT:REF:STATe ON function.
Sets the measurement resolution for the selected measurement function. The resolution can be 4.5, 5.5, or 6.5 digits.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 | Channel number; for single-channel instruments, the value is 1. |
| function | enum | CONCurrent[:DC] | CURRent[:DC] | VOLTage[:DC] | Measurement function to which the resolution setting applies. |
| value | integer | 4 - 6 | Measurement resolution in digits: 4 for 4.5 digit, 5 for 5.5 digit, or 6 for 6.5 digit resolution. |
:SENS:CURR:RES 5
Reads and clears the Measurement Event Register of the status model. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
:STATus:MEASurement[:EVENt]?
Sets or reads the contents of the Measurement Event Enable Register of the status model. When a bit is set here and the corresponding Measurement Event Register bit is set, the MSB bit in the Status Byte Register is set.
| Name | Type | Values | Description |
|---|---|---|---|
| n | numeric | - | Status register value to write; may be sent in decimal, binary (#b), or hexadecimal (#h) form. |
:STATus:MEASurement:ENABle <n> :STATus:MEASurement:ENABle?
Reads and clears the Measurement Instrument Event Register of the status model. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
Sets or reads the contents of the Measurement Instrument Event Enable Register of the status model. When one of the enabled bits and the corresponding Event Register bit are set, the ISUM bit in the Measurement Event Register is set.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 65535 | Binary, hexadecimal, or decimal value written to the enable register. |
:STAT:MEAS:INST:ENAB #b0000000000000010
Reads and clears the Measurement Instrument Summary Event Register of the status model. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
:STAT:MEAS:INST:ISUM?
Sets or reads the contents of the Measurement Instrument Summary Enable Register of the status model. The register enables bits in the Measurement Instrument Summary Event Register (MISER).
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Status register value; binary values may be prefaced with #b, hexadecimal with #h, or decimal without a prefix. |
:STAT:MEAS:INST:ISUM:ENAB #b0000100000000001
Reads the contents of the Measurement Instrument Summary Condition Register of the status model.
:STAT:MEAS:INST:ISUM:COND? Returns the contents of the Measurement Instrument Summary Condition Register of the status model.
Reads and clears the Operation Event Register of the status model. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
Sets or reads the contents of the Operation Event Enable Register of the status model. When one of the enabled bits is set and the corresponding bit in the Operation Event Register is set, the OSB bit in the Status Byte Register is set.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Status of the operation status register. |
:STAT:OPER:ENAB #b0010000000000000
Reads and clears the Operation Instrument Event Register of the status model.
Sets or reads the contents of the Operation Instrument Enable Register of the status model. When sending binary values, prefix <n> with #b; hexadecimal values use #h, and decimal values need no prefix.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 65535 | The status of the Operation Instrument Enable Register. |
:STAT:OPER:INST:ENAB #b0000000000000010
Reads the Operation Instrument Summary Event Register of the status model and clears the register. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
:STAT:OPER:INST:ISUM? Returns the contents of the Operation Instrument Summary Event Register of the status model.
Sets or reads the contents of the Operation Instrument Summary Enable Register of the status model. When one of these bits is set and the corresponding bit in the OISER is set, bit 1 in the Operation Instrument Event Register is set.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 0 - MAXimum | The status of the Operation Instrument Summary Enable Register. |
:STAT:OPER:INST:ISUM:ENAB #b0000000100010000
Reads the contents of the Operation Instrument Summary Condition Register of the status model.
:STAT:OPER:INST:ISUM:COND?
Resets all the device-dependent enable registers to 0. The manual lists the specific Operation, Measurement, and Questionable enable registers that may be reset.
Reads the Questionable Event Register of the status model and then clears the register.
:STAT:QUES? Returns the contents of Questionable Event Register
Sets or reads the contents of the Questionable Event Enable Register in the status model. The register controls whether matching bits in the Questionable Event Register set the QSM bit in the Status Byte Register.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 8191 | Value of the Questionable Status Enable Register. |
:STAT:QUES:ENAB #b0010000000000000
Reads and clears the Questionable Instrument Event Register of the status model.
Sets or reads the contents of the Questionable Instrument Event Enable Register of the status model. When a bit is set and the corresponding Questionable Instrument Event Register bit is set, the ISUM bit in the Questionable Event Register is set.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 65535 | Status of the Questionable Instrument Event Enable Register. |
:STAT:QUES:INST:ENAB #b0000000000000010
Reads the Questionable Instrument Summary Event Register of the status model and clears the register. The instrument returns a decimal value corresponding to the binary-weighted sum of all bits set in the register.
:STAT:QUES:INST:ISUM? Returns the contents of the Questionable Instrument Summary Event Register of the status model.
Sets or reads the contents of the Questionable Instrument Summary Event Enable Register of the status model. Binary values may be sent with #b, hexadecimal values with #h, or decimal values with no prefix.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Contents of the Questionable Instrument Summary Event Enable Register. |
:STAT:QUES:INST:ISUM?
Reads the contents of the Questionable Instrument Summary Condition Register of the status model.
:STAT:QUES:INST:ISUM:COND?
Enables or disables the instrument autozero function. When autozero is disabled, reference and internal temperature measurements are not performed, which increases measurement speed but can eventually cause drift and inaccurate readings.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| state | enum | OFF | 0 | ON | 1 | Disables autozero with OFF or 0, and enables autozero with ON or 1. |
:SYST:AZER OFF
Enables or disables the beeper for error messages. When enabled, a beep signals that an error has happened.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | Turns the error beeper off or on. |
:SYSTem:BEEPer:ERRor ON Enable the error beeper.
Causes remote control to transfer to the present interface. When sent from one interface, the currently active interface is blocked and the sending interface becomes active.
:SYSTem:COMMunication:ABORt
Specifies the LAN configuration for the instrument. The query form returns the present settings as AUTO or MANual followed by the IP address, subnet mask, and gateway.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | MANual | Selects automatic or manual LAN configuration. |
| ipaddressopt | string | - | LAN IP address in dotted-decimal notation; required when mode is manual. |
| netmaskopt | string | - | LAN subnet mask in dotted-decimal notation. |
| gatewayopt | string | - | LAN default gateway in dotted-decimal notation. |
:SYST:COMM:LAN:CONF MAN,"192.168.0.1","255.255.240.0","192.168.0.3" :SYST:COMM:LAN:CONF?
Queries the instrument's LAN MAC address. The MAC address is returned as a hexadecimal character string with colons separating the address octets.
:SYSTem:COMMunication:LAN:MACaddress?
Sets or queries the instrument calendar date. The query returns the present date as year, month, and day.
| Name | Type | Values | Description |
|---|---|---|---|
| year | integer | 1971 | Year value; must be more than 1970. |
| month | integer | 1 - 12 | Month value. |
| day | integer | 1 - 31 | Day of month. |
:SYST:DATE 2014, 5, 12
Reads the oldest error message from the event log. It returns the next entry from the error queue and clears errors after they are read; if the queue is empty, it returns `0,"No error"`.
:SYST:ERR?
Clears the error queue. This function removes all messages from the error queue.
Returns and clears the oldest error code in the error queue. The numeric code is removed from the queue after being read.
:SYST:ERR:CODE? Returns the error number of the last error in the error queue. For example, if error -222, "Parameter data out of range error" occurred, the output is: -222
Returns the number of errors currently in the error queue. This query does not clear the errors from the queue.
Saves all event log entries since the last clear command to a file on a USB flash drive. The .csv extension is automatically added to the filename, and the USB flash drive must be inserted before sending the command.
| Name | Type | Values | Description |
|---|---|---|---|
| fileName | string | - | A string that holds the name of the file to be saved. |
:SYST:EVEN:SAVE "error_log" Saves the error events in the event log to a file on the USB flash drive named error_log.csv.
Sets the GPIB address of the instrument. The address can be any value from 1 to 30 and takes effect when the command is processed.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 30 | The GPIB address of the instrument. |
Enables or disables the key click sound for front-panel key presses. The setting is saved and affected by recall settings, instrument reset, and power cycle.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | Disable or enable the key click sound. |
:SYSTem:KCLick ON
Takes the instrument out of remote operation and restores front-panel control. In remote operation, the front-panel keys are locked out except LOCAL and OUTPUT.
:SYST:LOC
Returns the line frequency that was automatically detected when the instrument was turned on. The line frequency can be 50 Hz or 60 Hz.
:SYST:LFR? Return the line frequency.
Sets a remote interface to lock mode. When password protection is enabled, sending this command disables the remote interface for the current connection.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | The password for remote connection. |
:SYST:PASS:LOCK "admin" Disable the current interface
Sets the protection mode for the remote connection. The password protection can be enabled with ALL or disabled with NONE.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ALL | NONE | Enables or disables password protection. |
:SYST:PASS:MODE ALL Enable the password protection.
Sets a new password for the remote connection. The instrument keeps using the old password until the change command has completed.
| Name | Type | Values | Description |
|---|---|---|---|
| string1 | string | 8 characters | The present password. |
| string2 | string | 8 characters | The new password. |
:SYST:PASS:NEW <string1>,<string2>
Enables a remote interface by unlocking a locked remote interface with the correct password. If the password is wrong, the instrument reports error 509, "System password not correct."
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | The password for remote mode. |
:SYST:PASS:UNL "admin" Unlock the present interface used to send this command.
Enables or disables default setup loading. When set to On, the power setup loads setup 1 after power-on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | 0 | ON | 1 | Disable or enable default setup loading. |
:SYST:POS:STAT ON :SYST:POS:STAT?
Returns the instrument to the factory default conditions and erases all user data stored in nonvolatile memory. It does not affect the status structure registers or error queue, and it resets the GPIB and IP addresses to default settings.
Locks out the front-panel controls so the instrument can only be controlled through the remote interface. When sent, all front-panel keys are disabled.
:SYST:RWLock
Sets the absolute time of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| hour | integer | 0 - 23 | Hour in 24-hour time format. |
| minute | integer | 0 - 60 | Minute. |
| second | integer | 0 - 60 | Second. |
:SYST:TIME 5, 51, 30
Queries the present SCPI standard version.
:SYST:VERS? Query the version. Example output: 1999.0
Clears all readings in the buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
:DATA:CLE Clear the data buffer.
Enables or disables the autoclear feature for the reading buffer. When enabled, the buffer is automatically cleared when storage starts; when disabled, new readings append until the buffer fills or storage stops.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| state | enum | ON | 1 | OFF | 0 | Enables or disables autoclear. |
:DATA:CLEar:AUTO ON :DATA:CLEar:AUTO?
Returns all readings from the buffer. You can optionally specify which buffer elements to print, defaulting to READing, SOURce, UNIT, and RELative.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| bufferElementsopt | enum | READing | SOURce | UNIT | MODE | DATE | TIME | TSTamp | RELative | RSTamp | RNUMber | List of buffer elements to print. |
:DATA:DATA? "READ,SOUR,REL" Return the measurement value, source value, and the relative time.
Returns specified data elements in the buffer for a channel. The query takes a start index, an end index, and an optional list of buffer elements to print; if no element list is given, it defaults to READing, SOURce, UNIT, and RELative.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| start | integer | 1 - 2500 | Beginning index of the buffer to return. |
| end | integer | 1 - 2500 | Ending index of the buffer to return. |
| bufferElementsopt | enum | READing | SOURce | UNIT | MODE | DATE | TIME | TSTamp | RELative | RSTamp | RNUMber | List of elements in the buffer to print. |
:TRAC:DATA:SEL? 1, 99, "READ,SOUR,REL"
Selects the source of readings for the trace buffer. The source can be readings before the math calculation or after it.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | SENSe | CALCulate | Selects the source of readings. |
:DATA:FEED SENSe :DATA:FEED?
Determines whether the reading buffer is filled continuously or filled once and then stops. Use it to set and read the fill mode of the reading buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | NEXT | ALWays | NEVer | Buffer control mode: fill once, fill continuous, or no measurements to fill the buffer. |
:DATA:FEED:CONT ALWays :DATA:FEED:CONT?
Sets or queries the number of readings a buffer can store. The channel suffix [n] selects the channel number; for single-channel instruments the value is 1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| newSize | integer | 2 - 2500 | New size for the buffer. |
:DATA:POIN? Query the capacity of the buffer.
Queries the number of readings presently stored in the buffer.
:DATA:POIN:ACT? Query the number of stored reading in the buffer.
Clears all readings in the buffer. For single-channel instruments, the channel number is 1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number. |
:TRAC:CLE Clear the data buffer.
Enables or disables the autoclear feature for the buffer. With autoclear enabled, the buffer automatically clears when the storage process starts; when disabled, readings append until the buffer is full or storage stops.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| state | enum | ON | 1 | OFF | 0 | Enables or disables autoclear. |
:TRAC:CLE:AUTO ON Enable autoclear for the buffer.
Returns all the readings from the buffer. An optional buffer-elements list can be supplied to select which buffer fields are returned, with defaults of READing, SOURce, UNIT, and RELative if omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| bufferElementsopt | enum | READing | SOURce | UNIT | MODE | DATE | TIME | TSTamp | RELative | RSTamp | RNUMber | A list of elements in the buffer to print. |
:TRACe:DATA? "READ,SOUR,REL"
Returns specified data elements from the trace buffer for a range of readings. The query takes a start index, end index, and an optional list of buffer elements to include in the response.
| Name | Type | Values | Description |
|---|---|---|---|
| start | integer | 1 - 2500 | Beginning index of the buffer to return. |
| end | integer | 1 - 2500 | Ending index of the buffer to return. |
| bufferElementsopt | enum | READing | SOURce | UNIT | RELative | MODE | DATE | TIME | TSTamp | RSTamp | RNUMber | List of trace buffer elements to print; if omitted, defaults to READing, SOURce, UNIT, and RELative. |
:TRAC:DATA:SEL? 1, 99, "READ,SOUR,REL"
Selects the source of readings for the trace buffer. You can choose readings before math calculation or after math calculation.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | SENSe | CALCulate | Select the source of readings: before the math calculation or after the math calculation. |
:TRACe:FEED SENS :TRACe:FEED?
Determines whether the reading buffer is filled continuously or filled once and then stops. It can also disable measurements from filling the buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| name | enum | NEXT | ALWays | NEVer | Buffer control mode: fill once, fill continuous, or no measurements to fill the buffer. |
:TRACe:FEED:CONT ALW :TRACe:FEED:CONT?
Sets or queries the number of readings a buffer can store. For queries, it can also return the default, minimum, or maximum allowed value.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
| newSize | integer | 2 - 2500 | The new size for the buffer. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Optional query qualifier requesting the default, minimum, or maximum value. |
:TRAC:POIN? Query the capacity of the buffer.
Queries the number of readings presently stored in the buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
:TRAC:POIN:ACT?
Saves data from the specified reading buffer to a USB flash drive. You can optionally choose the time format and a start/end range within the buffer.
| Name | Type | Values | Description |
|---|---|---|---|
| fileName | string | - | Name of the file on the USB flash drive in which to save the reading buffer. |
| timeFormatopt | enum | TSTamp | RELative | RSTamp | Selects which time information is saved in the file. |
| startopt | integer | - | Starting point in the buffer from which to begin saving data. |
| endopt | integer | - | Ending point in the buffer at which to stop saving data. |
:TRAC:SAVE "myData" Save all readings and default time information to a file :TRAC:SAVE "myDataRel", REL named myData.csv on the USB flash drive. :TRAC:SAVE "myDataRel100",REL,1,100 Save all readings and relative time stamps to a file :TRAC:SAVE "myDataRel100",REL,1,100 named myDataRel.csv on the USB flash drive. :TRAC:SAVE "myDataRel100",REL,1,100 Save the buffer readings from 1 through 100 to a file :TRAC:SAVE "myDataRel100",REL,1,100 named myDataRel100.csv on the USB flash drive.
Specifies whether the current rises above or falls below the trigger threshold when the level trigger is activated.
| Name | Type | Values | Description |
|---|---|---|---|
| direction | enum | RISE | FALL | Selects whether the trigger is activated on a rising or falling current level. |
TRAC:TRIG:CURR:DIR RISE TRAC:TRIG:CURR:DIR?
Configures the current threshold value for the level trigger. The allowed range depends on the trace feed and Relative status.
| Name | Type | Values | Description |
|---|---|---|---|
| current threshold | real | -1.0E7 - 1.0E7 | Threshold value used for the level trigger. |
Enables or disables the current level trigger function. The setting is retained across power cycles and defaults to OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the current level trigger function. |
:TRACe[n]:TRIGger:CURRent:STATe <state> :TRACe[n]:TRIGger:CURRent:STATe?
Queries whether a level trigger has occurred. If a level trigger has occurred, the value of 1 will be returned.
TRAC:TRIG:OCC?
Defines the number of points at which the instrument begins to log data in the buffer. The command is saved across power cycles.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 100 | Number of points before the level trigger activation. |
TRAC:TRIG:OFFS 10 TRAC:TRIG:OFFS?
Specifies whether the voltage rises above or falls below a specified level when the level trigger is activated. The command accepts a direction setting and also supports a query form.
| Name | Type | Values | Description |
|---|---|---|---|
| direction | enum | RISE | FALL | Sets the trigger voltage direction. |
TRAC:TRIG:VOLT:DIR RISE TRAC:TRIG:VOLT:DIR?
Configures the voltage threshold for the level trigger. The allowed range depends on the trace feed and Relative status.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage threshold | real | -1.0E8 - 1.0E8 | Voltage threshold for the level trigger. |
TRAC:TRIG:VOLT 0 TRAC:TRIG:VOLT?
Enables or disables the voltage level trigger function.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the voltage level trigger function. |
TRAC:TRIG:VOLT:STAT 1 TRAC:TRIG:VOLT:STAT?
Sets the number of times to repeat the trigger event. The command also supports query forms to read the current, minimum, or maximum count.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 2500 | The number of times to repeat the trigger. |
:TRIG:COUN 4
Sets the number of measurements per trigger event.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 2500 | The number of measurements per trigger event. |
| nopt | integer | 1 - 1 | Channel number; for single-channel instruments, the value is 1. |
:TRIG:SAMP:COUN 10 Set the sample count to 10.
Selects the control source for trigger layer. For single-channel instruments, [n] is 1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 | Channel number. |
| source | enum | IMMediate | EXTernal | MANual | Trigger source for the trigger layer. |
:TRIG:SOUR EXT Select external triggering as the trigger source.