Enable or disable the display. The state must be ON or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enable/disable display state. |
SCPI COMMAND REFERENCE
The Keithley 2520 is Keithley's source measure unit in the Model 2520 Pulsed Laser Diode Test System family. Its SCPI remote-control interface exposes 245 commands across 44 subsystems - 124 settable and 121 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.
245
Commands
124
Settable
121
Queries
44
Subsystems
SCPI
1996.0
Verified
2026-07-16
Enable or disable the display. The state must be ON or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enable/disable display state. |
Sets detector #1 source voltage. The allowed range is 0 to ±20.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | 0 - ±20 | Source voltage to apply to detector #1. |
Sets the specified source voltage level immediately for source 2. The level is specified in volts and can be queried with the corresponding query form.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | -20 - 20 | Voltage level to set. |
Queries the specified voltage level immediately for Source 2. The level is expressed in volts and can be set in the range -20 to 20 when used as a setter.
Sets the detector #1 source amplitude immediately. If the outputs are off, the programmed value is applied when the outputs are turned on.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | -20 - 20 | Set source amplitude. |
Sets the laser diode source current. The allowed range is 0 to +5.0 A, with note that 5.0 A maximum applies in pulse mode only and 1 A maximum in DC mode.
| Name | Type | Values | Description |
|---|---|---|---|
| current | real | 0 - +5.0 | Laser diode source current to set. |
Sets the low pulse amplitude for pulse mode on source 1. The allowed range depends on the selected source range: 0 to 15e-3 for the 500 mA range, or 0 to 150e-3 for the 5 A range.
| Name | Type | Values | Description |
|---|---|---|---|
| low_current | real | 0 - 15e-3 | Low pulse amplitude for pulse mode. |
Selects the laser diode current source function.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | DC | PULSe | Selects the source function. |
Sets the laser source voltage compliance limit.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | 1 - 10 | Voltage compliance limit for the laser source. |
Path to control laser diode current source.
Queries the current source center point for the selected source. The center point is specified as a value from 0 to 5.0.
Queries the current source mode for the selected source path. The mode can be FIXed, SWEep, or LIST.
Queries the current polarity setting for the current source. The polarity can be positive or negative.
Queries the fixed current range setting for the current source. The range corresponds to the current source fixed range selection.
Queries the current source span setting. The span is specified in amps and applies to the current sweep configuration.
Queries the start level for current sweep.
Queries the current step value for current sweep. The command is part of the source current configuration tree.
Queries the current stop level for current sweep.
Specify low current pulse level. The allowable value depends on the current range: 0 to 0.015 for 500 mA range, or 0 to 0.15 for 5 A range.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 0.015 | Low current pulse level for the 500 mA range; allowable range depends on the selected current range. |
Queries the low current pulse level.
Queries the specified current level for fixed mode. The value is the immediate amplitude under :SOURce[1]:CURRent[:LEVel][:IMMediate].
Queries the current source shape setting for the selected source. The shape can be PULSe or DC.
Queries the delay between pulses for pulse generation in FIXed and SWEep source modes.
Queries whether pulse transition control is enabled or disabled.
Queries the pulse width for the source pulse generation path.
Queries all points in the source current list.
Queries all points in the pulse delay list.
Specifies the direction of the list sweep. The direction can be set to UP or DOWN.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | UP | DOWN | Sweep direction for list sweep mode. |
Queries the direction of the list sweep.
Queries all points in the pulse width list.
Queries the sweep direction for staircase sweep mode. The direction is UP for start-to-stop sweep or DOWN for stop-to-start sweep.
Queries the number of sweep points in staircase sweep mode.
Selects the staircase sweep spacing type for the source sweep mode. The query returns the present sweep spacing.
Queries the voltage compliance limit for source 1. The related setter uses a numeric level from 3 to 10.5.
Turns off all three source outputs. It performs the same function as the :OUTPut OFF command.
Selects the laser diode sourcing mode for the current source. The available modes are fixed, list, and sweep.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | FIXed | LIST | SWEep | Selects the sourcing mode. |
Selects the range for the laser diode current source. The instrument goes to the lowest range that can accommodate the specified current magnitude.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 5.0 | Specifies the source level used to select the current range. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | UP | DOWN | Selects a default, minimum, maximum, next-higher, or next-lower range. |
Selects the laser diode source function for :SOURce[1]. The available functions are DC and PULSe.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | DC | PULSe | Selects the source function. |
:SOURce[1]:FUNCtion[:SHAPe] DC :SOURce[1]:FUNCtion[:SHAPe] PULSe
Sets the current pulse low amplitude for a fixed source. The specified amplitude must be within 0 to 0.150 A, and MINimum/MAXimum/DEFault may be used as qualifiers.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 0.150 | Set pulse low amplitude. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default, minimum, or maximum allowable amplitude. |
Sets the fixed current source amplitude immediately for DC and pulse functions. The specified amplitude cannot exceed the selected source range, and this command is not valid in list or sweep mode.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 5.0 | Set source amplitude. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default, lowest allowable, or highest allowable amplitude. |
Selects the polarity for the laser diode current source. POSitive selects normal polarity, while NEGative selects reversed polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | POSitive | NEGative | Polarity to set for the current source. |
Sets the voltage protection limit, which clamps the current source output voltage at the programmed limit.
| Name | Type | Values | Description |
|---|---|---|---|
| nrf | real | 3 - 10.5 | Voltage compliance limit. |
Selects the scale for the current sweep. Linear scale performs the source and measure points on a linear scale; logarithmic scale performs them on a logarithmic scale.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | LINear | LOGarithmic | Sweep scale to use. |
Sets the direction of the sweep. Normally, a sweep runs from start level to stop level, and this command can reverse that order.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | UP | DOWN | Direction of the sweep. |
Sets the total number of source and measure points in a sweep. For a linear sweep the points are equally spaced between the start and stop levels; for a log sweep they are equally spaced on a logarithmic scale.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 2 - 1000 | Specify number of source-measure points. |
Defines a current list for list sourcing mode. The instrument sequentially sources each current pulse value in the list when operation is started.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf list | real | 0 - 5.0 | List of current pulse values to define, up to 100 points. |
:SOURce[1]:LIST:CURRent 1, 2, 5
Adds one or more current values to an existing source list. The appended values are added to the end of the list, with up to 100 values per list and up to 1000 points total using multiple appended lists.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf list | real | 0 - 5.0 | Source value(s) to append to the current list. |
:SOURce[1]:LIST:CURRent:APPend <NRf list>
Queries the length of the current list. The response message indicates the number of source values in the list.
Defines a list of pulse widths for list sourcing mode. When operation is started, the instrument sequentially sources each current pulse value in the list with the programmed pulse width and delay.
| Name | Type | Values | Description |
|---|---|---|---|
| <NRf list> | real | 500e-9 - 5e-3 | List of pulse width values in seconds. |
:SOURce[1]:LIST:WIDTh 10e-6, 30e-6, 60e-6
Adds one or more pulse width values to an existing pulse width list. Up to 100 values can be appended in one command, and multiple appended lists can build up to 1000 points.
| Name | Type | Values | Description |
|---|---|---|---|
| <NRf list> | real | 500e-9 - 5e-3 | One or more pulse width values to append to the list. |
:SOURce[1]:LIST:WIDTh:APPend <NRf list>
Queries the length of the specified pulse width list. The response message indicates the number of pulse width values in the list.
Defines a list of pulse delays for list sourcing mode. If the delay is not programmed, a default value of 1.5 ms is used, but the query returns 0.
| Name | Type | Values | Description |
|---|---|---|---|
| <NRf list> | real | 20e-6 - 0.5 | One or more pulse delay values for the list. |
:SOURce[1]:LIST:DELay 200e-6, 400e-6, 500e-6
Adds one or more values to an existing pulse delay list. The appended pulse delay values are added to the end of the list.
| Name | Type | Values | Description |
|---|---|---|---|
| <NRf list> | real | 20e-6 - 0.5 | One or more pulse delay values to append to the list. |
:SOURce[1]:LIST:DELay:APPend <NRf list>
Query the length of the specified pulse delay list. The response message indicates the number of pulse delay values in the list.
Sets the center current for the sweep range. Changing this command also changes :SOURce[1]:CURRent:STARt, :SOURce[1]:CURRent:STOP, and :SOURce[1]:CURRent:STEP.
Sets or couples the number of current points. Changing this command also changes :SOURce[1]:CURRent:STEP.
Sets the current span in the coupled current source parameters. Changing this command also changes :SOURce[1]:CURRent:STARt, :SOURce[1]:CURRent:STOP, and :SOURce[1]:CURRent:STEP.
Sets the start current for the current sweep. Changing this command also changes :SOURce[1]:CURRent:STEP, :SOURce[1]:CURRent:CENTer, and :SOURce[1]:CURRent:SPAN.
Sets the current step value. Changing this command also changes :SOURce[1]:CURRent:POINts.
Sets the current stop value for the source sweep. Changing this command also changes the coupled current step, center, and span settings.
Sets the pulse delay. Changing this command also changes :SOURce[1]:PULSe:WIDTh.
Coupled command that also changes the pulse width setting.
Sets the pulse width for source 1. The command is coupled with :SOURce[1]:PULSe:DELay and can also affect :TRACe:POINts.
Controls the rise and fall times of the current source pulse. Increasing the transition time can reduce overshoot and oscillations, especially with long cables or poor connections.
Sets the photodiode 1 current measurement range. The manual lists the allowed ranges as 0.01, 0.02, 0.05, or 0.1.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | 0.01 - 0.1 | Measurement range to select. |
Selects the polarity for the Sense 2 current measurement. Name can be POSitive or NEGative.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | POSitive | NEGative | Polarity name. |
Queries the detector #1 current polarity for the :SENSe2:CURRent[:DC] subsystem. The manual lists the polarity as POSitive or NEGative.
Configures the current measurement range for the Sense 2 subsystem. The range is selected by specifying the expected current reading.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 0.105 | Select range by specifying the expected current reading. |
Queries the configured upper current measurement range for Sense 2 DC current. The range is selected by the expected current reading.
Queries whether detector #1 sweep abort is enabled or disabled.
Queries the detector #1 sweep abort current threshold. The threshold is used for sweep abort under the :SENSe2:SWEep:CABort subsystem.
Selects the detector current measurement range for detector #1. The range can be set by expected reading or by stepping up/down to the next measurement range.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 0.105 | Expected reading in amps. |
| qualifier | enum | UP | DOWN | Selects the next higher or lower measurement range. |
Sets the measurement polarity for detector #1 current measurements. POSitive selects normal polarity and NEGative selects reversed polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | POSitive | NEGative | Measurement polarity to select. |
Enable or disable sweep abort when the programmed current threshold is reached.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables sweep abort. |
Sets the detector #1 sweep abort current threshold for sensor 2. The threshold is used to abort a sweep when the corresponding detector current reaches the programmed level; sweep abort must be enabled with the state command.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 0.105 | Sweep abort current threshold. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Sets the threshold to the default, minimum, or maximum value. |
Sets the laser diode voltage measurement range. The range can be 5 or 10.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | 5 - 10 | Measurement range to select. |
Queries the filter count for the sense 1 averaging subsystem. The manual lists the filter count range as 1 to 100 and shows a default of OFF for the query entry.
Enables or disables the digital filter for Sense 1. The filter commands are global and affect all measurements simultaneously.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | boolean | - | Enables or disables the digital filter. |
Queries the state of the digital filter in Sense 1. The filter is part of the :AVERage subsystem.
Selects the polarity for the Sense 1 voltage measurement path. The manual lists the allowed polarity names as POSitive or NEGative.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | POSitive | NEGative | Polarity name to select. |
Queries the voltage polarity for Sense 1. The polarity can be positive or negative.
Queries whether the voltage compliance limit has been exceeded. Returns 1 if yes and 0 if no.
Configures the measurement range for the Sense 1 voltage measurement path. The range is selected by specifying the expected voltage reading.
| Name | Type | Values | Description |
|---|---|---|---|
| upperopt | real | 0 - 10.5 | Select range by specifying the expected voltage reading. |
Queries the upper voltage measurement range for Sense 1. The range is selected by specifying the expected voltage reading.
Selects the laser diode voltage measurement range by expected reading, or moves to the next higher/lower range with UP or DOWN.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 10.5 | Expected reading in volts used to select the measurement range. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Optional keyword form: DEFault selects the *RST default range, MINimum selects the lowest range, and MAXimum selects the highest range. |
| modeopt | enum | UP | DOWN | Selects the next higher range with UP or the next lower range with DOWN. |
Selects the measurement polarity for laser diode voltage measurements. POSitive selects normal polarity, while NEGative selects reversed polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | POSitive | NEGative | Measurement polarity to set. |
Queries whether the laser diode voltage measurement compliance limit has been reached. A returned value of 1 indicates the voltage limit has been reached; 0 indicates it has not been reached.
Sets the average filter count. The filter count is the number of readings acquired and stored in the filter buffer for the averaging calculation.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 100 | Average filter count. |
Queries the latest laser diode voltage reading for the selected sense channel. These queries request the latest readings only when the unit is in the idle layer of the trigger model.
[:SENSe[1]]:DATA[:LATest]?
Enables or disables the average digital filter. When enabled, voltage and current readings are filtered according to how many readings are averaged; when disabled, the digital filter stage is bypassed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables the average digital filter. |
Sets the trigger count. The allowed range is 1 to 5000.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 5000 | Trigger count to set. |
Selects the trigger link input line. The valid line numbers are 1 through 6.
| Name | Type | Values | Description |
|---|---|---|---|
| line | integer | 1 - 6 | Trigger link input line to select. |
Select trigger link output line.
| Name | Type | Values | Description |
|---|---|---|---|
| line | integer | 1 - 6 | Trigger link output line number to select. |
Selects the trigger input source. The available sources are IMMediate, TIMer, BUS, TLINK, PSTest, NSTtest, and BSTest.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | IMMediate | TIMer | BUS | TLINK | PSTest | NSTtest | BSTest | Trigger input source. |
:TRIGger:SOURce <source> :TRIG:SOUR BUS
Sets the trigger timer. The timer value determines the trigger delay when TIMer is selected as the trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 0 - 99999.99 | Trigger timer value. |
Sets the trigger output name. The example shown assigns the value NONE.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | NONE | Specifies the trigger output name. |
:TRIGger:OUTPut NONE
Specify the trigger count. The count can be set from 1 to 5000 or to INFinite.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | INFinite | Trigger count to use. |
Queries the trigger count for the trigger sequence/layer path. INFinite is returned as +9.9e37.
Specifies the trigger control source for the trigger layer. The allowed sources are IMMediate, TIMer, MANual, BUS, TLINk, NSTest, PSTest, and BSTest.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | IMMediate | TIMer | MANual | BUS | TLINk | NSTest | PSTest | BSTest | Trigger control source. |
Queries the control source for the trigger layer.
Selects the input trigger line for asynchronous trigger configuration. The input trigger line can be one of six lines.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 6 | Input trigger line number. |
Queries the selected input trigger line in the asynchronous trigger configuration.
Selects the output trigger line in the asynchronous trigger configuration.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 6 | Select input trigger line (1 through 6). |
Selects the output trigger line for asynchronous trigger configuration. The output trigger can be set to trigger or none.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | TRIGger | NONE | Output trigger selection. |
Configures the asynchronous output trigger for the trigger layer. It selects the output trigger setting, which can be TRIGger or NONE.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | TRIGger | NONE | Output trigger setting. |
Configures the asynchronous trigger output selection in the Trigger Layer. The output trigger can be set to TRIGger or NONE.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | TRIGger | NONE | Output trigger selection. |
Sets or queries the trigger timer interval in seconds within the trigger sequence layer.
Sets the trigger count. The count specifies how many times the unit cycles through the trigger layer; INFinite runs continuously.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | DEFault | MINimum | MAXimum | INFinite | Specifies the trigger count. |
Specifies the trigger event control source for the trigger model.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | IMMediate | TLINk | TIMer | MANual | BUS | NSTest | PSTest | BSTest | Selects the source used to generate trigger events. |
Sets the interval for the trigger layer timer. The timer is in effect only if it is the selected control source.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 99999.99 | Specifies the timer interval in seconds. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Sets the timer to the default value, lowest allowable interval, or largest allowable interval. |
Selects the Trigger Link input line. For normal operation, the Trigger Link input and output lines should not share the same line.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf | integer | 1 - 6 | Line number to use as the Trigger Link input line. |
Selects the Trigger Link output line. The input and output Trigger Link lines should not share the same line during normal operation.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf | integer | 1 - 6 | Trigger Link output line number. |
Enables or disables trigger pulses on the specified Trigger Link output line. With TRIGger selected, an output trigger occurs when exiting the trigger layer; with NONE selected, the trigger layer output trigger is disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | TRIGger | NONE | Specifies whether trigger pulses occur on the output trigger line. |
:TRIGger[:SEQuence[1]][:TCONfigure]:OUTPut <name>
Controls the digital output line logic levels on digital output port 4. The argument is a decimal value from 0 to 15 that corresponds to the L/H pattern of OUT 4 through OUT 1.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf | integer | 0 - 15 | Decimal value that sets the four digital output line logic levels. |
:SOUR4:TTL 5
Queries the Digital I/O bit size for source 4. The bit size is set by :SOURce4:BSIZe.
Queries the pattern on digital output port for Source 4.
Queries the response format for the SOUR4:TTL query. The format is controlled by the corresponding :FORMat:SOURce4 <name> command.
Sets the Digital I/O bit size to 4 or 16. The 16-bit size is available only with the 2499-DIGIO option connected to the Digital I/O port.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf | integer | 4 - 16 | Sets the Digital I/O port bit size. |
Sets the logic levels of the output lines of the Digital I/O port. A high level is approximately +5 V and a low level is 0 V.
| Name | Type | Values | Description |
|---|---|---|---|
| level | integer | 0 - 15 | Decimal digital output pattern corresponding to the desired OUT 4 through OUT 1 states. |
Clears the status structure event registers and empties the error queue. It resets the Standard Event, Operation Event, Measurement Event, and Questionable Event registers to 0, and clears all messages from the Error Queue.
Sets the individual bits of the Service Request Enable Register. Sending a value of 0 clears the register; the register also clears when power is cycled.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Value used to set or clear the Service Request Enable Register. |
*SRE 0
Reads the Service Request Enable Register. The register is cleared when power is cycled or when *SRE 0 is sent.
Reads the Status Byte Register.
*STB?
Reads the Standard Event Status Register. The register bits report standard event conditions such as query error, execution error, command error, user request, and power-on since the last read.
Sets the Standard Event Status Enable Register. The bits in the register enable the corresponding bits in the Standard Event Status Register to contribute to the Event Status Summary Bit (ESB).
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Bit mask for the Standard Event Status Enable Register. |
Sets or queries the Standard Event Status Enable Register. The register enables selected standard event status bits to be summarized into the event status summary bit.
| Name | Type | Values | Description |
|---|---|---|---|
| enable register | integer | 0 - 255 | Value written to the Standard Event Status Enable Register. |
Sets operation complete status. The command is still functional in the 488.1 protocol, but is not needed there.
Returns the operation complete event status. The query is still functional under the 488.1 protocol, though not needed for it.
Releases bus hold-off immediately and does not wait for all readings to be acquired. It is still functional in the 488.1 protocol, but is not needed for that protocol.
Returns the instrument identification string.
Returns the installed options information.
Recalls a front-panel or remote state from nonvolatile memory. The stored state is restored to the instrument after the command is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 0 - 9 | Memory location number to recall. |
*RCL <n>
Resets the instrument to its default state.
Saves the current instrument state in nonvolatile memory. It is a common command and is documented alongside the other common commands.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 9 | Memory location in which to save the current state. |
*SAV <NR1>
Executes a trigger event at the interface. This is a common command.
Performs the instrument self-test and returns the result.
Read the Measurement Event Register. Reading the event register clears the bits of that register.
Reads the Operation Event Register. Reading the register clears its bits.
Reads the Questionable Event Register. Reading the event register clears its latched bits.
:STATus:QUEStionable:[:EVENt]?
Reads the measurement status enable register. The response format depends on the currently selected register data format.
Reads the operation status enable register. The response format depends on the presently selected data format.
Reads the enable register for the Questionable status subsystem.
Read the disabled messages in the error queue.
Reads the enable register for the questionable status subsystem.
Programs the Measurement Event Enable Register in the status structure. The value sent determines which bits in the register are set.
| Name | Type | Values | Description |
|---|---|---|---|
| NDN | string | - | Binary, hexadecimal, or octal formatted value (#Bxx...x, #Hx, or #Qx). |
| NRf | integer | 0 - 65535 | Decimal value for the enable register. |
Reads the contents of the Measurement Event Register. After the command is sent and the instrument is addressed to talk, it returns a value indicating which bits in the register are set.
Programs the Operation Event Enable register in the status structure. The binary equivalent of the value sent determines which bits in the register are set.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0 - 65535 | Enable-register value to program; may be sent in binary, hexadecimal, octal, or decimal form. |
Reads the contents of the Operation status event register. After the command is sent and the instrument is addressed to talk, a value is returned indicating which bits in the register are set.
Programs the Questionable Event Enable register of the status structure. The value determines which bits in the register are set.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0 - 65535 | Enable-register value, sent as either binary, hexadecimal, octal, or decimal format. |
Reads the contents of the Questionable Event Register. After the command is sent and the instrument is addressed to talk, a value is returned indicating which bits in the appropriate status register are set.
Reads the contents of the Measurement Condition register.
Reads the contents of the operation condition register.
Returns the status registers to their default conditions. When sent, the Operation Event Enable, Event Enable, and Measurement Event Enable registers are cleared to zero; the Standard Event Register is not affected.
Reads the contents of the Questionable condition register.
Clears the Error Queue of messages.
Reads the next message from the Error Queue. As error and status messages occur, they are placed into the Error Queue; this query reads those messages and performs the same function as :SYSTem:ERRor?.
Disables the specified list of messages for the Error Queue. Disabled messages are prevented from entering the Error Queue.
| Name | Type | Values | Description |
|---|---|---|---|
| list | numeric | - | A specified list of messages to disable for the Error Queue. |
Enables messages for the Error Queue. Messages not specified are disabled and prevented from entering the queue.
| Name | Type | Values | Description |
|---|---|---|---|
| list | numeric | - | Specified list of messages to enable for the Error Queue. |
Requests the latest post-processed readings stored in the reading buffer. It does not affect instrument setup or trigger source/measure operations; it simply returns the last available readings, and may return the same readings repeatedly until new ones are available.
Performs essentially the same function as :READ?, except that it also turns the source outputs on if they were off.
Triggers and acquires readings. In fixed mode it acquires one set of readings; in sweep mode it triggers the sweep and acquires all sweep data points. The command executes :INITiate followed by :FETCh? and is illegal when :TRIG:SOUR BUS is in effect.
Path to configure and control laser diode math. CALCulate1 is the CALC1 math subsystem, with children for data, format, KMATh parameters, and state.
Selects the laser diode math function. The current source value (I1) and measured voltage (V1) are used for CONDuctance, POWER, and RESistance calculations, while MX + B parameters are set separately.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | MXB[1] | CONDuctance[1] | POWER[1] | RESistance[1] | Selects the laser diode math function. |
:CALCulate[1]:FORMat <name>
Sets the B (offset) value for the MX + B math function. The command is used with CALC1 for the laser diode, CALC2 for detector #1, and CALC3 for detector #2.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | -9.99999e20 - +9.99999e20 | Specifies the B (offset) value for the MX + B math function. |
| qualifieropt | enum | MINimum | MAXimum | DEFault | Allows setting the value to the minimum, maximum, or default value instead of a numeric entry. |
Sets the M (slope) value for the MX + B math function. Use CALC1 for the laser diode, CALC2 for detector #1, and CALC3 for detector #2.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | -9.99999e20 - +9.99999e20 | Specifies the M (slope) value for the MX + B math function. |
| qualifieropt | enum | MINimum | MAXimum | DEFault | Selects the minimum, maximum, or default M (slope) value. |
Specifies the units suffix name for the MX + B math function for CALC1 through CALC3.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | One ASCII character enclosed in single or double quotes. |
Enables or disables the CALC1 to CALC4 math function for the selected calculation block. When enabled, the math calculation is performed on trigger; when disabled, related data queries return NAN.
| Name | Type | Values | Description |
|---|---|---|---|
| b | enum | 0 | OFF | 1 | ON | Disables or enables the math function. |
Read the latest CALC1 result. This command works exactly like :CALCulate[1]:DATA? except that it returns only the latest CALC1 result.
Reads the CALC1 calculation result. The largest valid result is ±9.9e37; an invalid NAN result of +9.91e37 indicates the calculation is disabled or a division-by-zero error occurred.
Specifies the data elements returned by the CALCn:DATA? and CALCn:DATA:LATest? queries. You can specify from one to all three elements, separated by commas.
Queries the byte order setting.
Specifies the CALCulate data elements used for data format selection. The allowed item list is CALCulate, TIME, and STATus.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | CALCulate | TIME | STATus | Selects which CALCulate data elements are included. |
Queries the CALCulate data elements for the selected data format. The command belongs to the :FORMat subsystem.
Queries the format for reading SOURCE4 data. The format can be ASCII, HEXadecimal, OCTal, or BINary.
Queries the data format used for reading status event registers.
Specify TRACe data elements. The allowed data elements are VOLTage[1], CURRent2, CURRent3, and TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | VOLTage[1] | CURRent2 | CURRent3 | TIME | Data elements to include in TRACe data format. |
Queries the TRACe data elements selected for FETCh? and READ? operations.
Selects the data format for transferring instrument readings over the bus.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ASCii | REAL | SREal | Specifies the data format. |
| lengthopt | integer | - | Length value used with REAL; if omitted, REAL defaults to 32. |
Selects the data format for transferring instrument readings over the bus. For the REAL format, the length is optional and defaults to 32 if omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ASCii | REAL | SREal | Data format to use for transferred readings. |
| lengthopt | integer | - | Data length for the REAL format; not used for ASCii or SREal. |
Specifies the data elements to be included in the data string returned by subsequent :FETCh?, :READ?, and :MEASure? queries. Up to eight comma-separated elements can be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | CURRent[1] | CURRent2 | CURRent3 | VOLTage[1] | VOLTage2 | VOLTage3 | TIME | STATus | List of data elements to include in the returned data string. |
Queries which elements are included in the data string returned by the following :FETCh?, :READ?, and :MEASure? queries. Up to eight elements may be specified, separated by commas.
Specifies the data elements to be included in the data string returned by the :TRACe:DATA? and :TRACe:DATA:VALue? queries. You can select from one to all three elements, separated by commas.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | VOLTage[1] | CURRent2 | CURRent3 | TIME | Selects which TRACe data string elements to include. |
Specifies the TRACe data string elements to be included in responses to :TRACe:DATA? and :TRACe:DATA:VALue? queries. Up to three comma-separated elements may be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | VOLTage[1] | CURRent2 | CURRent3 | TIME | Elements to include in the TRACe data string. |
Specifies the byte order used for IEEE-754 binary formats. Normal order sends bytes 1-4 in sequence; swapped order reverses the byte order.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | NORMal | SWAPped | Sets the binary byte order. |
Sets the response format for the SOUR4:TTL query. The format is controlled similarly to formats set by the FORM:SREG command.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | ASCii | HEXadecimal | OCTal | BINary | Response format for SOUR4:TTL. |
Sets the response message format used when reading status registers. When a status register is queried, the returned value is formatted as ASCII decimal, hexadecimal, octal, or binary.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | ASCii | Hexadecimal | OCTal | BINary | Sets the status register data format. |
:FORMat:SREGister ASCii :FORMat:SREGister Hexadecimal :FORMat:SREGister OCTal :FORMat:SREGister BINary
Path to control all three outputs.
Queries the state of the outputs. This command is documented under the OUTPut command path for controlling all three outputs.
Queries whether the two interlocks have been tripped. A returned value of "1" means the sources can be turned on; "0" means the sources cannot be turned on.
Turns all three source outputs on or off simultaneously and queries the current source state. Turning the sources off places the Model 2520 in the idle state.
:OUTPut[1]?
Turns all three source outputs on or off simultaneously. Turning the sources off places the Model 2520 in the idle state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns the sources off (standby) or on (operate). |
Sense 1 subsystem for controlling laser diode voltage measurement.
Returns the most recent reading stored in the sense subsystem. This is the LATest form of the DATA query for the specified sense channel.
Returns and clears all error codes in the error queue. This command is the :SYSTem:ERRor:CODE path form for reading codes only.
Queries the last pressed key.
Queries the current power-on setup. The setup can be RST, PRESet, or SAV 0-4.
Returns the instrument to states optimized for front panel operation. The preset defaults are listed in the SCPI tables.
Reads all errors in the error queue. When the instrument is addressed to talk, all messages are sent to the computer and removed from the queue.
Reads and removes the oldest error from the error queue. The queue is FIFO and can hold up to 10 messages.
Clears the Error Queue of messages.
Reads the oldest error from the error queue and returns only the error code. The error is cleared from the queue.
Returns the number of messages in the Error Queue as a decimal number.
Simulates a key press by sending an NRf code for a specific front-panel key.
| Name | Type | Values | Description |
|---|---|---|---|
| NRf | integer | 1 - 14 | Key code identifying which front-panel key to simulate. |
Reads the version of the SCPI standard being used by the Model 2520.
1996.0
Takes the Model 2520 out of remote state and enables operation of the front panel keys. It is described as an action command similar to the GPIB GTL command.
Places the Model 2520 in the remote state, similar to the GPIB REN command. In remote, the front panel keys are locked out if local lockout is asserted.
Enables or disables local lockout for front panel keys during remote operation. When enabled, the front panel keys except OUTPUT OFF are locked out; when disabled, the LOCAL key remains operational in remote.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables local lockout. |
Determines the instrument’s power-on setup conditions. See Section 14 for details.
Returns whether the message exchange protocol (MEP) is enabled. A returned value of 1 indicates SCPI protocol selected; 0 indicates 488.1 protocol selected.
Access and control the sample buffer.
Sets the number of samples to return for the :TRACe:DATA? query. The valid range is 1 to 3000, with a default of 100.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 3000 | Number of samples to return for the :TRACe:DATA? query. |
Queries the number of samples to return for the :TRACe:DATA? query.
Returns a specified sample after the start of a pulse.
| Name | Type | Values | Description |
|---|---|---|---|
| NRfopt | integer | 1 - 3000 | Specifies which sample to return. |
Returns raw samples from the sample buffer.
Queries the character blinking attributes for the specified display. The response indicates, for each character position, whether that character is blinking or not.
Reads what is currently being displayed on the top display. After the command is sent and the instrument is addressed to talk, the displayed data is sent to the computer.
:DISPlay[:WINDow[1]]:DATA?
Controls the text message displayed in the specified display window. When enabled, a defined message is displayed; when disabled, the message is removed from the display.
| Name | Type | Values | Description |
|---|---|---|---|
| b | enum | 0 | OFF | 1 | ON | Enables or disables the message for the specified display. |
Controls the text message mode for the specified display. When enabled, a defined message is displayed; when disabled, the message is removed from the display.
| Name | Type | Values | Description |
|---|---|---|---|
| b | enum | 0 | OFF | 1 | ON | Disables or enables the message for the specified display. |
Specifies which data string elements are included in responses to the :TRACe:DATA? and :TRACe:DATA:VALue? queries. You can select from one to all three elements, separated by commas.
| Name | Type | Values | Description |
|---|---|---|---|
| item list | enum | VOLTage[1] | CURRent2 | CURRent3 | TIME | Selects the TRACe data string elements to include. |
Sets the number of samples to return for the TRAC:DATA? query. The value defaults based on pulse width changes, with the default limited to 3000.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 3000 | Specify number of samples |
:TRACe:POINts <n>
Queries the current binary byte order used for IEEE-754 binary formats. Normal byte order sends bytes in the standard order; swapped byte order reverses them.
Queries the response message format used when reading status registers. The returned value indicates which bits in a status register are set, formatted according to the currently selected status register format.
Queries the filter count. The optional qualifiers DEFault, MINimum, and MAXimum request the *RST default, the lowest allowable, or the largest allowable filter count, respectively.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects whether to return the current filter count or a special value such as the *RST default, minimum, or maximum. |
:COUNt? :COUNt? DEFault :COUNt? MINimum :COUNt? MAXimum
Queries the sourcing mode for the laser diode current source. The mode can be FIXed, LIST, or SWEep.
Queries the current laser diode source function. The function can be DC or PULSe.
Queries the selected source range for the laser diode current source. The query also supports the qualifiers DEFault, MINimum, and MAXimum to ask for the *RST default, lowest, or highest source range.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Optional query qualifier selecting the default, lowest, or highest source range. |
:SOURce[1]:CURRent:RANGe? :SOURce[1]:CURRent:RANGe? DEFault :SOURce[1]:CURRent:RANGe? MINimum :SOURce[1]:CURRent:RANGe? MAXimum
Queries the programmed source amplitude. It can also query the *RST default amplitude, the lowest allowable amplitude, or the highest allowable amplitude using a qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default amplitude, minimum allowable amplitude, or maximum allowable amplitude to query. |
:CURRent? :CURRent? DEFault :CURRent? MINimum :CURRent? MAXimum
Queries the programmed low pulse amplitude. DEFault, MINimum, and MAXimum return the *RST default, lowest allowable, and highest allowable low amplitude, respectively.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects which low amplitude value to query. |
Selects the polarity for the laser diode current source. POSitive selects normal polarity, while NEGative selects reversed polarity.
Queries the programmed voltage protection limit. This limit clamps the current source output voltage at the programmed value.
Queries the pulse delay. The slice also documents qualifier forms to query the default, minimum, or maximum allowable pulse delay.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default pulse delay, the lowest allowable pulse delay, or the highest allowable pulse delay. |
Queries the state of pulse transition control. When on (1), the turn-on edge is intentionally slowed to a fixed 5e-6 setting; when off (0), the leading edge is as fast as the system hardware allows.
Queries the current pulse width. The manual also documents query forms for the default, minimum, and maximum pulse width.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default, minimum, or maximum allowable pulse width to query. |
Selects the scale for the current sweep. Linear scale performs source and measure points on a linear scale; logarithmic scale performs them on a logarithmic scale.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | LINear | LOGarithmic | Selects the sweep scale. |
:SOURce[1]:SWEep:SPACing <name> :SPACing?
Queries the start current level for a sweep. The query also accepts the qualifiers DEFault, MINimum, and MAXimum to request the *RST default, lowest allowable, or highest allowable level.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects which value to query: the *RST default level, the lowest allowable level, or the highest allowable level. |
Queries the stop current level for a sweep. It also accepts the qualifiers DEFault, MINimum, and MAXimum to query the *RST default, lowest allowable, or highest allowable level.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects which stop level to query. |
Queries the center point for a sweep. Optional qualifiers return the *RST default level, the lowest allowable level, or the highest allowable level.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default, minimum, or maximum center level to query. |
:CENTer? :CENTer? DEFault :CENTer? MINimum :CENTER? MAXimum
Queries the span for a sweep. Optional qualifiers return the default, minimum, or maximum allowable level.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default (*RST), lowest allowable, or highest allowable span level. |
:SPAN? :SPAN? DEFault :SPAN? MINimum :SPAN? MAXimum
Specifies the step size for a linear sweep. When the sweep is started, the source level changes in equal steps from the start level to the stop level, with a measurement performed at each step including the start and stop levels.
| Name | Type | Values | Description |
|---|---|---|---|
| n | real | 0 - 5.0 | Set source level step size. |
| qualifieropt | enum | DEFault | MINimum | MAXimum | Returns or selects the default, minimum, or maximum step size. |
Queries the direction of a sweep. The sweep direction is normally set by the corresponding :SOURce[1]:SWEep:DIRection command.
Queries the number of sweep points. The manual also supports qualifier forms to query the default, minimum, or maximum allowable number of sweep points.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | DEFault | MINimum | MAXimum | Selects the default, lowest allowable, or highest allowable number of sweep points to query. |
:POINts? :POINts? DEFault :POINts? MINimum :POINts? MAXimum
Starts the configured sweep. In the example, it is issued after setting source sweep spacing, start/stop values, number of points, and output state.
Take the Model 2520 out of idle state to initiate source and measure operation. Command processing halts until the trigger model returns to the idle state, with a few listed exceptions.
Aborts the source/measure cycle and returns the instrument to the idle state. The manual notes that DCL or SDC can be used as a faster way to return to idle.