If a script is created with the loadscript or loadandrunscript command with no name defined, it is called the anonymous script. There can only be one anonymous script in the runtime environment. If another anonymous script is loaded into the runtime environment, it replaces the existing anonymous script.
The bit functions perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers.
+
Logic operations
+
The bit.bitand(), bit.bitor(), and bit.bitxor() functions in this group perform bitwise logic operations on two numbers. The Test Script Processor (TSP®) scripting engine performs the indicated logic operation on the binary equivalents of the two integers. This bitwise logic operation is performed on all corresponding bits of the two numbers. The result of a logic operation is returned as an integer.
+
Bit operations
+
The rest of the functions in this group are used for operations on the bits of a given number. These functions can be used to:
+
Clear a bit
Toggle a bit
Test a bit
Set a bit or bit field
Retrieve the weighted value of a bit or field value
All these functions use an index parameter to specify the bit position of the given number. The least significant bit of a given number has an index of 1, and the most significant bit has an index of 32.
+
The Test Script Processor (TSP) scripting engine stores all numbers internally as IEEE Std 754 double-precision floating-point values. The logical operations work on 32-bit integers. Any fractional bits are truncated. For numbers larger than 4294967295, only the lower 32 bits are used.
The ADC of the 2601B-PULSE uses a ratiometric A/D conversion technique. To ensure reading accuracy, the instrument must periodically obtain fresh measurements of its internal ground and voltage reference. Separate reference and zero measurements are used for each aperture.
+
As summarized in the table below, there are different settings for autozero. By default, the instrument is set to AUTO, which automatically checks these reference measurements whenever a signal measurement is made. If the reference measurements are out of date when a signal measurement is made, the instrument automatically makes two more A/D conversions, one for the reference and one for the zero, before returning the result. Thus, occasionally, a measurement takes longer than normal.
+
This extra time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the extra time for the reference measurements in these situations, you can select OFF. This setting disables the automatic reference measurements. Note that with automatic reference measurements disabled, the instrument may gradually drift out of specification.
+
To minimize the drift, a reference and zero measurement should be made immediately before a critical test sequence. The ONCE setting can be used to force a refresh of the reference and zero measurements used for the current aperture setting.
+
+
+
Autozero settings
+
+
+
+
Autozero setting
+
+
Description
+
+
+
+
OFF
+
+
Turns automatic reference measurements off.
+
+
+
+
ONCE
+
+
After immediately making one reference and one zero measurement, turns automatic reference measurements off.
+
+
+
+
AUTO
+
+
Automatically takes new acquisitions when the 2601B-PULSE determines reference and zero values are out-of-date.
The filter feature lets you set the filter response to stabilize noisy measurements. The 2601B-PULSE uses a digital filter, which is based on reading conversions. The displayed, stored, or transmitted reading is calculated using one or more reading conversions (from 1 to 100).
Depending on how it is programmed and what is connected to the output (load or source), the instrument can operate in any of the four quadrants. The four quadrants of operation are shown in the continuous operating boundaries figures. When operating in the first (I) or third (III) quadrant, the instrument is operating as a source (V and I have the same polarity). As a source, the instrument is delivering power to a load.
+
+
When operating in the second (II) or fourth (IV) quadrant, the instrument is operating as a sink (V and I have opposite polarity). As a sink, it is dissipating power rather than sourcing it. An external source or an energy storage device, such as a capacitor or battery, can force operation in the sink region.
You can specify the 2601B-PULSE start-up (power-on) configuration. Use the setup.poweron attribute to select which setup to return to upon power-up. To set the setup.poweron configuration attribute:
You can get readings by making overlapped or sequential measurements. Overlapped commands do not finish executing before the next command starts. Sequential commands complete execution before the next command starts executing.
+
The measured value is not the only component of a reading. The measurement status (for example, “In Compliance” or “Overranged”) is also an element of data associated with a particular reading.
+
All routines that return measurements can store the measurements in the reading buffers. Overlapped measurements always return readings in a reading buffer. Non-overlapped measurement functions can return single-point measurement values or store multiple values in a reading buffer.
+
A reading buffer is based on a Lua table. The measurements are accessed by ordinary array accesses. If rb is a reading buffer, the first measurement is accessed as rb[1] and the ninth measurement as rb[9]. The additional information in the table is accessed as additional members of the table.
+
The load, save, and write operations for reading buffers function differently in the remote state. From a remote command interface, you can extract data from reading buffers as the instrument acquires the data.
The selected measurement range affects the accuracy of the measurements and the maximum signal that can be measured. If the range is changed, the front-panel display may contain dashes instead of a reading (for example, --.---- mA). This indicates that no measurement was made using the range that is presently selected. To update the displayed reading, trigger a measurement (if in local control, press the TRIG key).
The SPEED key can select and control the analog-to-digital converter (ADC) through setting the integration time, or measurement aperture (the period of time the input signal is measured). The integration time affects the usable digits, the amount of reading noise, and the reading rate of the instrument. The integration time is specified in parameters based on the number of power line cycles (NPLC), where 1 PLC for 60 Hz is 16.67 ms (1/60) and 1 PLC for 50 Hz is 20 ms (1/50).
+
In general, the fastest integration time (0.001 PLC) results in the fastest reading rate, but also causes increased reading noise and fewer usable digits. The slowest integration time (25 PLC) provides the best common-mode and normal-mode noise rejection, but has the slowest reading rate. Settings between the fastest and slowest integration times are a compromise between speed and noise. The default power-on speed setting is NORMAL (1 PLC).
When making measurements, you may want to subtract an offset value from a measurement.
+
The relative offset feature subtracts a set value or a baseline reading from measurement readings. When you enable relative offset, all measurements are recorded as the difference between the actual measured value and the relative offset value. The formula to calculate the offset value is:
+
Displayed value = Actual measured value - Relative offset value
+
When a relative offset value is established for a measure function, the value is the same for all ranges for that measure function. For example, if 0.5 A is set as a relative offset value on the 1 A range, the relative offset value is also 0.5 A on the lower current ranges. Also, on the 1 A range, the 2601B-PULSE still overflows for a more than 1.02 A input.
+
When relative offset is enabled, the REL indicator turns on. Changing measurement functions changes the relative offset value to the established relative offset value and state for that measurement function.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/12044.htm b/WebHelpDocs/2601B-PULSE/12044.htm
new file mode 100644
index 0000000..126f988
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/12044.htm
@@ -0,0 +1,43 @@
+
+
+
+
+ Time and date values
+
+
+
+
+
+
+
+
+
+
+
+
+
Time and date values
+
Time and date values are represented as the number of seconds since some base. Representing time as a number of seconds is referred to as “standard time format.” There are three time bases:
+
UTC 12:00 am Jan 1, 1970. Some examples of UTC time are reading buffer base timestamps, adjustment dates, and the value returned by os.time().
Instrument on. References time to when the instrument was turned on. The value returned by os.clock() is referenced to the turn-on time.
Event. Time referenced to an event, such as the first reading stored in a reading buffer.
A history of the key code for the last pressed front-panel key is maintained by the 2601B-PULSE. When the instrument is turned on (or when transitioning from local to remote operation), the key code is set to 0 (display.KEY_NONE).
+
When a front-panel key is pressed, the key code value for that key can be captured and returned. There are two functions associated with the capture of key-press codes: display.getlastkey() and display.waitkey().
Display resolution for measured readings can be set to 4-1/2, 5-1/2 or 6-1/2. Configure the type of resolution displayed by setting the display.smua.digits attribute. The following programming example illustrates how to set 5-1/2 digit resolution for measured readings:
The KISweep factory script provides simple sweep test programming and shows how to use the sweeping function.
+
This script is made up of the following functions. Access these functions from the front panel or the remote interfaces. The following functions make up the KISweep factory script:
Settling time in seconds; occurs after stepping the source and before making a measurement
+
+
+
+
points
+
+
Number of sweep points (must be >= 2)
+
+
+
+
+
Details
+
Data for voltage measurements, current source values, and timestamps are stored in smua.nvbuffer1.
+
If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
+
Performs a linear current sweep with voltage measured at every step (point):
+
Sets the SMU to output starti amperes, allows the source to settle for stime seconds, and then makes a voltage measurement.
Sets the SMU to output the next amperes step, allows the source to settle for stime seconds, and then makes a voltage measurement.
Repeats the above sequence until the voltage is measured on the stopi amperes step.
The linear step size is automatically calculated as follows:
+
step = (stopi – starti) / (points – 1)
+
+
Example
+
+
+
+
SweepILinMeasureV(smua, -1e-3, 1e-3, 0, 100)
+
+
+
+
This function performs a 100-point linear current sweep starting at -1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep. Because stime is set for 0 s, voltage is measured as quickly as possible after each current step.
Settling time in seconds; occurs after stepping the source and before making a measurement
+
+
+
+
points
+
+
Number of sweep points (must be >= 2)
+
+
+
+
+
Details
+
Data for current measurements, voltage source values, and timestamps are stored in smua.nvbuffer1.
+
If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
+
Performs a linear voltage sweep with current measured at every step (point):
+
Sets the SMU to output startv amperes, allows the source to settle for stime seconds, and then makes a current measurement.
Sets the SMU to output the next amperes step, allows the source to settle for stime seconds, and then makes a voltage measurement.
Repeats the above sequence until the voltage is measured on the stopv amperes step.
The linear step size is automatically calculated as follows:
+
step = (stopv – startv) / (points – 1)
+
+
Example
+
+
+
+
SweepVLinMeasureI(smua, -1, 1, 1e-3, 1000)
+
+
+
+
This function performs a 1000-point linear voltage sweep starting at -1 V and stopping at +1 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.
This function performs a five-point linear current sweep starting at 10 mA and stopping at 100 mA. Voltage is measured at every step (point) in the sweep. The source is allowed to settle on each step for 1 ms before a measurement is made.
+
+
The following table contains log values and corresponding source levels for the five-point logarithmic sweep:
This function performs a six-point current list sweep starting at the first point in testilist. Voltage is measured at every step (point) in the sweep. The source is allowed to settle on each step for 500 ms before a measurement is performed.
This function performs a five-point logarithmic voltage sweep starting at 1 V and stopping at 10 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.
+
+
The following table contains log values and corresponding source levels for the five-point logarithmic sweep:
The script listing for a factory script can be retrieved and modified. However, it cannot be saved as a factory script. The modified script can be saved as a user script using the same name or a new name.
+
An imported factory script can only be loaded back into the 2601B-PULSE as a user script.
+
The following function retrieves a script listing. The script code is output with the shell keywords (loadscript or loadandrunscript and endscript):
+
script.factory.scripts.name.list()
+
Where: name is the name of the factory script.
+
An example that retrieves the script listing for a factory script named KISweep:
The error queue holds error and status messages. As programming errors and status messages occur, a message that defines the error or status is placed in the error queue.
+
An error or status message is cleared from the error queue when it is read. You can also clear the error queue by sending the command errorqueue.clear(). An empty error queue clears the error available (EAV) bit in the Status Byte Register.
+
Messages in the error queue include a code number, message text, severity, and TSP-Link® node number. See Error summary list for a list of the messages.
+
When you read a single message from the error queue, the oldest message is read. If you attempt to read the error queue when it is empty, the error number 0 and “No Error” is returned.
+
The commands that can be used to control the error queue are listed below.
+
+
+
Error queue commands
+
+
+
+
Error queue command
+
+
Description
+
+
+
+
errorqueue.clear()
+
+
Clear error queue of all errors.
+
+
+
+
errorqueue.count
+
+
Number of messages in the error/event queue.
+
+
+
+
errorCode, message,
+
severity, errorNode =
+
errorqueue.next()
+
+
Request error code, text message, severity, and TSP-Link node number.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/12451.htm b/WebHelpDocs/2601B-PULSE/12451.htm
new file mode 100644
index 0000000..be96113
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/12451.htm
@@ -0,0 +1,44 @@
+
+
+
+
+ Digital I/O port
+
+
+
+
+
+
+
+
+
+
+
+
+
Digital I/O port
+
The Keithley Instruments 2601B-PULSE System SourceMeter® instrument has a digital input/output port that can be used to control external digital circuitry. For example, a handler that is used to perform binning operations can be used with a digital I/O port.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/12571.htm b/WebHelpDocs/2601B-PULSE/12571.htm
new file mode 100644
index 0000000..9e65a9a
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/12571.htm
@@ -0,0 +1,230 @@
+
+
+
+
+ Understanding hardware value and pseudo line state
+
+
+
+
+
+
+
+
+
+
+
+
+
Understanding hardware value and pseudo line state
+
LAN triggering is similar to hardware synchronization except that LXI trigger packets are used instead of hardware signals. A bit in the LXI trigger packet called the hardware value simulates the state of a hardware trigger line. The 2601B-PULSE stores the hardware value of the last LXI trigger packet that was sent or received as the pseudo line state.
+
The stateless event flag is a bit in the LXI trigger packet that indicates if the hardware value should be ignored. If it is set, the 2601B-PULSE ignores the hardware value of the packet and generates a trigger event. The 2601B-PULSE always sets the stateless flag for outgoing LXI trigger packets. If the stateless event flag is not set, the hardware value indicates the state of the signal.
+
Changes in the hardware value of consecutive LXI trigger packets are interpreted as edge transitions. Edge transitions generate trigger events. If the hardware value does not change between successive LXI trigger packets, the 2601B-PULSE assumes an edge transition was missed and generates a trigger event. The following table illustrates edge detection in LAN triggering.
+
+
+
+
LXI trigger edge detection
+
+
+
+
Stateless event flag
+
+
Hardware value
+
+
Pseudo line state
+
+
Falling edge
+
+
Rising edge
+
+
+
+
0
+
+
0
+
+
0
+
+
Detected
+
+
Detected
+
+
+
+
0
+
+
1
+
+
0
+
+
-
+
+
Detected
+
+
+
+
0
+
+
0
+
+
1
+
+
Detected
+
+
-
+
+
+
+
0
+
+
1
+
+
1
+
+
Detected
+
+
Detected
+
+
+
+
1
+
+
-
+
+
-
+
+
Detected
+
+
Detected
+
+
+
+
+
+
Set the LAN trigger mode to configure the edge detection method in incoming LXI trigger packets. The mode that is selected also determines the hardware value in outgoing LXI trigger packets. The following table lists the LAN trigger modes.
+
+
+
+
LAN trigger modes
+
+
+
+
Trigger mode
+
+
Input detected
+
+
Output generated
+
+
Notes
+
+
+
+
Either edge
+
+
Either
+
+
Negative
+
+
+
+
+
+
Falling edge
+
+
Falling
+
+
Negative
+
+
+
+
+
+
Rising edge
+
+
Rising
+
+
Positive
+
+
+
+
+
+
RisingA
+
+
Rising
+
+
Positive
+
+
Same as Rising
+
+
+
+
RisingM
+
+
Rising
+
+
Positive
+
+
Same as Rising
+
+
+
+
Synchronous
+
+
Falling
+
+
Positive
+
+
Same as SynchronousA
+
+
+
+
SynchronousA
+
+
Falling
+
+
Positive
+
+
+
+
+
+
SynchronousM
+
+
Rising
+
+
Negative
+
+
+
+
+
+
+
+
The programming example below illustrates how to configure the LAN trigger mode.
The logical operators in Lua are and, or, and not. All logical operators consider both false and nil as false and anything else as true.
+
The operator not always returns false or true.
+
The conjunction operator and returns its first argument if the first argument is false or nil; otherwise, and returns its second argument. The disjunction operator or returns its first argument if this value is different from nil and false; otherwise, or returns its second argument. Both and and or use shortcut evaluation, that is, the second operand is evaluated only if necessary.
+
The example output you get may vary depending on the data format settings of the instrument.
The Keithley Instruments 2601B-PULSE System SourceMeter® instrument is shipped with one or more factory scripts saved in its flash firmware memory. A factory script is made up of a number of functions. Some of them can be called from the front-panel LOAD TEST menu. All of them can be called using remote programming.
+
As Keithley Instruments develops additional factory scripts, they will be made available on tek.com/keithley as a flash firmware upgrade for the 2601B-PULSE. See Upgrading the firmware for instructions on upgrading the flash firmware of your 2601B-PULSE instrument.
+
A factory script is similar to a user script, except a factory script is created by Keithley Instruments at the factory and is permanently stored in nonvolatile memory. The differences between a user script and a factory script include the following:
+
A factory script cannot be deleted from nonvolatile memory.
The script listing for a factory script can be retrieved and modified, but it is then treated as a user script. A user script cannot be saved as a factory script.
Factory scripts are not stored in global variables. The only references to factory scripts are in the script.factory.scripts attribute.
The script.factory.catalog() function returns an iterator that can be used in a for loop to iterate over all the factory scripts.
Example
+
To retrieve the catalog listing for factory scripts, send:
+
for name in script.factory.catalog() do print(name) end
The KIHighC factory script is made up of two functions: i_leakage_measure() and i_leakage_threshold(). These functions are intended to be used when high capacitance mode is active. Output is generally at a non-zero voltage before calling these functions. These functions can also be used to step the voltage to zero volts in order to measure the leakage current.
Voltage level to step to when this function is called
+
+
+
+
limiti
+
+
Current limit setting for the voltage step
+
+
+
+
sourcedelay
+
+
Delay to wait before lowering the current limit for measurement
+
+
+
+
measurei
+
+
Current limit (and measure range); note the current limit is lower at this level and because high-capacitance mode is active, the measure range will follow
+
+
+
+
measuredelay
+
+
Delay to wait after lowering the current limit before taking the measurement
+
+
+
+
+
Details
+
This function causes the SMU to:
+
Change its current limit to limiti with a voltage output of levelv for sourcedelay time, and then change its current limit to measurei (that also changes the measurement range to measurei) for measuredelay time
When measuredelay time expires, a measurement is made and returned as imeas
When measuring leakage current:
+
Charge the capacitor before calling this function (the output of the instrument is usually at a nonzero voltage before calling this function; when measuring leakage, this function does not charge the capacitor)
This KIHighC factory script function measures the current and compares it to a threshold. This continues until either the measured current drops below the threshold or the timeout expires.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
f = i_leakage_threshold(smua, levelv, limiti, sourcedelay, measurei, measuredelay, threshold, timeout)
+
+
+
+
f
+
+
A Boolean flag; this flag is true when the current is below the threshold, false if threshold is not reached before timeout expires
+
+
+
+
levelv
+
+
Voltage level to step to when this function is called
+
+
+
+
limiti
+
+
Current limit setting for the voltage step
+
+
+
+
sourcedelay
+
+
Delay to wait before lowering the current limit for measurement
+
+
+
+
measurei
+
+
Current limit (and measure range); note the current limit is lower at this level and because high-capacitance mode is active, the measure range will follow
+
+
+
+
measuredelay
+
+
Delay before the first measurement after measure range is changed
+
+
+
+
threshold
+
+
The specified current that establishes the test limit
+
+
+
+
timeout
+
+
Amount of time (in seconds) to wait for the current to drop to threshold after all the delays have occurred
+
+
+
+
+
Details
+
This function causes the SMU to:
+
Change its current limit to limiti with a voltage output of levelv for sourcedelay time, and then changes its current limit to measurei (that also changes the measurement range to measurei) for measuredelay time.
When measuredelay time expires, measurements are taken at a rate determined by the smua.measure.nplc setting.
When testing the leakage current threshold:
+
Charge the capacitor before calling this function. The output of the instrument is usually at a non-zero voltage before calling this function; when measuring leakage, this function does not charge the capacitor.
If testing the leakage current threshold of the device, set levelv = 0.
A Lua table containing the calculated Gm values at each point
+
+
+
+
ibuf
+
+
A reading buffer containing the measured current at each point
+
+
+
+
vbuf
+
+
A reading buffer containing the measured voltage at each point
+
+
+
+
smu
+
+
Instrument channel (for example, smua refers to SMU channel A)
+
+
+
+
start_v
+
+
Starting voltage level of the sweep
+
+
+
+
stop_v
+
+
Ending voltage level of the sweep
+
+
+
+
points
+
+
Number of measurements between start_v and stop_v (must be >= 2)
+
+
+
+
+
Details
+
Output data includes transconductance values, reading buffer with measured currents, reading buffer with measured currents and voltages.
+
The gm_vsweep() function performs a linear voltage sweep, measuring voltage and current, and then calculating the transconductance (Gm) at each point using the central difference method. It can return an array of Gm values, a reading buffer with the measured currents, and a reading buffer with the measured voltages.
+
Example
+
+
+
+
gm_array = gm_vsweep(smua, 0, 5, 20)
+
+
gm_array, ibuf = gm_vsweep(smua, 0, 5, 20)
+
+
+
gm_array, ibuf, vbuf = gm_vsweep(smua, 0, 5, 20)
+
+
SMU A returns Gm values only.
+
+
SMU A returns Gm and reading buffer with measured currents.
+
+
SMU A returns Gm and reading buffers with measured currents and voltages.
A Lua table containing the calculated Gm values at each point
+
+
+
+
vbuf
+
+
A reading buffer containing the measured voltage at each point
+
+
+
+
ibuf
+
+
A reading buffer containing the measured current at each point
+
+
+
+
smu
+
+
Instrument channel (for example, smua refers to SMU channel A)
+
+
+
+
start_i
+
+
Starting current level of the sweep
+
+
+
+
stop_i
+
+
Ending current level of the sweep
+
+
+
+
points
+
+
Number of measurements between start_i and stop_i (must be >= 2)
+
+
+
+
+
Details
+
Output data includes transconductance values, reading buffer with measured voltages, reading buffer with measured voltages and currents.
+
If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
+
The gm_isweep() function performs a linear current sweep, measuring voltage and current, and then calculating the transconductance (Gm) at each point using the central difference method. It can return an array of Gm values, a reading buffer with the measured voltages, and a reading buffer with the measured currents.
+
Example
+
+
+
+
gm_array = gm_isweep(smua, 0, 0.01, 20)
+
+
+
gm_array, vbuf = gm_isweep(smua, 0, 0.01, 20)
+
+
+
gm_array, vbuf, ibuf = gm_isweep(smua, 0,
+
0.01, 20)
+
+
Source-measure unit (SMU) A returns Gm values only.
+
+
SMU A returns Gm and reading buffer with measured voltages.
+
+
SMU A returns Gm and reading buffers with measured voltages and currents.
This section contains an overview of the TSP commands for the instrument. The commands are organized into groups, with a brief description of each group. Each section contains links to the detailed descriptions for each command in the TSP command reference section of this documentation (see TSP commands).
To use automatic source ranging, press SRC then the AUTO range key.
+
To use automatic measure ranging, press the MEAS key followed by the AUTO range key. The AUTO indicator turns on when source or measure autoranging is selected.
+
When autorange is selected, the instrument automatically sets the best range to source or measure the applied signal. The instrument will uprange at 100 percent of the present range.
+
When you change a source value, source autoranging is automatically turned off and remains off until you re-enable it.
Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2601B-PULSE. The 2601B-PULSE has two default reading buffers. In addition to the default buffers, you can create user-defined reading buffers. You can use the reading buffers to acquire readings.
+
You can access reading buffers from the front panel or over the remote command interface.
+
The default reading buffers can store can store over 60,000 readings if you enable the options for timestamps and source values. To store over 140,000 readings internally, you can disable the timestamps and source values.
+
You can save reading buffers to internal nonvolatile memory in the instrument or to a USB flash drive.
+
Once you save the reading buffers to a USB flash drive, insert the USB flash drive into the USB port on your computer to view the data in any compatible data analysis application or to transfer the data from the USB flash drive to your computer.
Function-based commands control actions or activities. A function-based command performs an immediate action on the instrument.
+
Each function consists of a function name followed by a set of parentheses ( ). You should only include information in the parentheses if the function takes a parameter. If the function takes one or more parameters, they are placed between the parentheses and separated by commas.
+
Example 1
+
+
+
+
beeper.beep(0.5, 2400)
+
delay(0.250)
+
beeper.beep(0.5, 2400)
+
+
Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on.
+
+
+
+
+
Example 2
+
You can use the results of a function-based command directly or assign the results to variables for later access. The following code defines x and prints it.
This function resets commands to their default settings.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
reset()
+
reset(system)
+
+
+
+
system
+
+
What to reset:
+
true: If the node is the master, the entire system is reset (default)
false: Only the local group is reset
+
+
+
+
Details
+
The reset() command in its simplest form resets the entire TSP-enabled system, including the controlling node and all subordinate nodes.
+
If you want to reset a specific instrument, use either the localnode.reset() or node[X].reset() command. Use the localnode.reset() command for the local instrument. Use the node[X].reset() command to reset an instrument on a subordinate node.
+
You can only reset the entire system using reset(true) if the node is the master. If the node is not the master node, executing this command generates an error.
+
Example
+
+
+
+
reset(true)
+
+
If the node is the master node, the entire system is reset; if the node is not the master node, an error is generated.
This function sets the real-time clock (sets present time of the system).
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
settime(time)
+
+
+
+
time
+
+
The time in seconds since January 1, 1970 UTC
+
+
+
+
+
Details
+
This function sets the date and time of the instrument based on the time parameter (specified in UTC time). UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).
+
Example
+
+
+
+
systemTime = os.time({year = 2020,
+
month = 3,
+
day = 31,
+
hour = 14,
+
min = 25})
+
settime(systemTime)
+
+
Sets the date and time to Mar 31, 2020 at 2:25 pm.
This function delays the execution of the commands that follow it.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
delay(seconds)
+
+
+
+
seconds
+
+
The number of seconds to delay (0 to 100 ks)
+
+
+
+
+
Details
+
The instrument delays execution of the commands for at least the specified number of seconds and fractional seconds. However, the processing time may cause the instrument to delay 5 μs to 10 μs (typical) more than the requested delay.
+
Example
+
+
+
+
beeper.beep(0.5, 2400)
+
delay(0.250)
+
beeper.beep(0.5, 2400)
+
+
Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on.
This function waits for all previously started overlapped commands to complete.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
waitcomplete()
+
waitcomplete(group)
+
+
+
+
group
+
+
Specifies which TSP-Link group on which to wait
+
+
+
+
+
Details
+
There are two types of instrument commands:
+
Overlapped commands: Commands that allow the execution of subsequent commands while instrument operations of the overlapped command are still in progress.
Sequential commands: Commands whose operations must finish before the next command is executed.
The waitcomplete() command suspends the execution of commands until the instrument operations of all previous overlapped commands are finished. This command is not needed for sequential commands.
+
A group number may only be specified when this node is the master node.
+
If no group is specified, the local group is used.
+
If zero (0) is specified for the group, this function waits for all nodes in the system.
+
Any nodes that are not assigned to a group (group number is 0) are part of the master node's group.
This function adds a user-defined string to nonvolatile memory.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
userstring.add("name", "value")
+
+
+
+
name
+
+
The name of the string; the key of the key-value pair
+
+
+
+
value
+
+
The string to associate with name; the value of the key-value pair
+
+
+
+
+
Details
+
This function associates the string value with the string name and stores this key-value pair in nonvolatile memory.
+
Use the userstring.get() function to retrieve the value associated with the specified name.
+
You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.
+
Example
+
+
+
+
userstring.add("assetnumber", "236")
+
userstring.add("product", "Widgets")
+
userstring.add("contact", "John Doe")
+
for name in userstring.catalog() do
+
print(name .. " = " ..
+
userstring.get(name))
+
end
+
+
Stores user-defined strings in nonvolatile memory and recalls them from the instrument using a for loop.
This function creates an iterator for the user-defined string catalog.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
for name in userstring.catalog() do body end
+
+
+
+
name
+
+
The name of the string; the key of the key-value pair
+
+
+
+
body
+
+
Code to execute in the body of the for loop
+
+
+
+
+
Details
+
The catalog provides access for user-defined string pairs, allowing you to manipulate all the key-value pairs in nonvolatile memory. The entries are enumerated in no particular order.
+
Example 1
+
+
+
+
for name in userstring.catalog() do
+
userstring.delete(name)
+
end
+
+
Deletes all user-defined strings in nonvolatile memory.
+
+
+
+
+
Example 2
+
+
+
+
userstring.add("assetnumber", "236")
+
userstring.add("product", "Widgets")
+
userstring.add("contact", "John Doe")
+
for name in userstring.catalog() do
+
print(name .. " = " ..
+
userstring.get(name))
+
end
+
+
Prints all userstring key-value pairs.
+
Output:
+
product = Widgets
+
assetnumber = 236
+
contact = John Doe
+
Notice the key-value pairs are not listed in the order they were added.
The connection ID to be used as a handle in all other tspnet function calls
+
+
+
+
ipAddress
+
+
IP address to which to connect in a string
+
+
+
+
portNumber
+
+
Port number (default 5025)
+
+
+
+
initString
+
+
Initialization string to send to ipAddress
+
+
+
+
+
Details
+
This command connects a device to another device through the LAN interface. If the portNumber is 23, the interface uses the Telnet protocol and sets appropriate termination characters to communicate with the device.
+
If a portNumber and initString are provided, it is assumed that the remote device is not TSP-enabled. The 2601B-PULSE does not perform any extra processing, prompt handling, error handling, or sending of commands. In addition, the tspnet.tsp.* commands cannot be used on devices that are not TSP-enabled.
+
If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley Instruments TSP-enabled device. Depending on the state of the tspnet.tsp.abortonconnect attribute, the 2601B-PULSE sends an abort command to the remote device on connection.
+
The 2601B-PULSE also enables TSP prompts on the remote device and error management. The 2601B-PULSE places remote errors from the TSP-enabled device in its own error queue and prefaces these errors with Remote Error, followed by an error description.
+
Do not manually change either the prompt functionality (localnode.prompts) or show errors by changing localnode.showerrors on the remote TSP-enabled device. If you do this, subsequent tspnet.tsp.* commands using the connection may fail.
+
You can simultaneously connect to a maximum of 32 remote devices.
The second value decoded from the response message
+
+
+
+
valueN
+
+
The Nth value decoded from the response message; there is one return value for each format specifier in the format string
+
+
+
+
...
+
+
One or more values separated with commas
+
+
+
+
formatString
+
+
Format string for the output
+
+
+
+
+
Details
+
This command sends a command string to the remote instrument. A termination is added to the command string when it is sent to the remote instrument (tspnet.termination()). You can also specify a format string, which causes the command to wait for a response from the remote instrument. The 2601B-PULSE decodes the response message according to the format specified in the format string and returns the message as return values from the function (see tspnet.read() for format specifiers).
+
When this command is sent to a TSP-enabled instrument, the 2601B-PULSE suspends operation until a timeout error is generated or until the instrument responds. The TSP prompt from the remote instrument is read and discarded. The 2601B-PULSE places any remotely generated errors into its error queue. When the optional format string is not specified, this command is equivalent to tspnet.write(), except that a termination is automatically added to the end of the command.
+
Example 1
+
+
+
+
tspnet.execute(instrumentID, "runScript()")
+
+
+
+
Command the remote device to run a script named runScript.
The second value decoded from the response message
+
+
+
+
valueN
+
+
The nth value decoded from the response message; there is one return value for each format specifier in the format string
+
+
+
+
...
+
+
One or more values separated with commas
+
+
+
+
connectionID
+
+
The connection ID returned from tspnet.connect()
+
+
+
+
formatString
+
+
Format string for the output, maximum of 10 specifiers
+
+
+
+
+
Details
+
This command reads available data from the remote instrument and returns responses for the specified number of arguments.
+
The format string can contain the following specifiers:
+
+
+
+
%[width]s
+
+
Read data until the specified length
+
+
+
+
%[max width]t
+
+
Read data until the specified length or until punctuation is found, whichever comes first
+
+
+
+
%[max width]n
+
+
Read data until a newline or carriage return
+
+
+
+
%d
+
+
Read a number (delimited by punctuation)
+
+
+
+
+
A maximum of 10 format specifiers can be used for a maximum of 10 return values.
+
If formatString is not provided, the command returns a string that contains the data until a new line is reached. If no data is available, the 2601B-PULSE pauses operation until the requested data is available or until a timeout error is generated. Use tspnet.timeout to specify the timeout period.
+
When the 2601B-PULSE reads from a TSP-enabled remote instrument, the 2601B-PULSE removes Test Script Processor (TSP®) prompts and places any errors it receives from the remote instrument into its own error queue. The 2601B-PULSE prefaces errors from the remote device with "Remote Error," followed by the error number and error description.
The number of bytes available to be read from the connection
+
+
+
+
connectionID
+
+
The connection ID returned from tspnet.connect()
+
+
+
+
+
Details
+
This command checks to see if any output data is available from the device. No data is read from the instrument. This allows TSP scripts to continue to run without waiting on a remote command to finish.
+
Example
+
+
+
+
ID = tspnet.connect("192.0.2.1")
+
tspnet.write(ID, "*idn?\r\n")
+
+
repeat bytes = tspnet.readavailable(ID) until bytes > 0
This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.
This function sets the device line termination sequence.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
type = tspnet.termination(connectionID)
+
type = tspnet.termination(connectionID, termSequence)
+
+
+
+
type
+
+
An enumerated value indicating the termination type:
+
1 or tspnet.TERM_LF
4 or tspnet.TERM_CR
2 or tspnet.TERM_CRLF
3 or tspnet.TERM_LFCR
+
+
+
connectionID
+
+
The connection ID returned from tspnet.connect()
+
+
+
+
termSequence
+
+
The termination sequence
+
+
+
+
+
Details
+
This function sets and gets the termination character sequence that is used to indicate the end of a line for a TSP-Net connection.
+
Using the termSequence parameter sets the termination sequence. The present termination sequence is always returned.
+
For the termSequence parameter, use the same values listed in the table above for type. There are four possible combinations, all of which are made up of line feeds (LF or 0x10) and carriage returns (CR or 0x13). For TSP-enabled devices, the default is tspnet.TERM_LF. For devices that are not TSP-enabled, the default is tspnet.TERM_CRLF.
+
Example
+
+
+
+
deviceID = tspnet.connect("192.0.2.1")
+
if deviceID then
+
tspnet.termination(deviceID, tspnet.TERM_LF)
+
end
+
+
Sets termination type for IP address 192.0.2.1 to TERM_LF.
This attribute contains the setting for abort on connect to a TSP-enabled instrument.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
No
+
+
Instrument reset Recall setup
+
+
Not saved
+
+
1 (enable)
+
+
+
+
+
Usage
+
tspnet.tsp.abortonconnect = value
+
value = tspnet.tsp.abortonconnect
+
+
+
+
value
+
+
Enable: 1
Disable: 0
+
+
+
+
Details
+
This setting determines if the instrument sends an abort message when it attempts to connect to a TSP-enabled instrument using the tspnet.connect() function.
+
When you send the abort command on an interface, it causes any other active interface on that instrument to close. If you do not send an abort command (or if tspnet.tsp.abortonconnect is set to 0) and another interface is active, connecting to a TSP-enabled remote instrument results in a connection. However, the instrument will not respond to subsequent reads or executes because control of the instrument is not obtained until an abort command has been sent.
+
Example
+
+
+
+
tspnet.tsp.abortonconnect = 0
+
+
Configure the instrument so that it does not send an abort command when connecting to a TSP-enabled instrument.
This function writes a string to the remote instrument.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
tspnet.write(connectionID, "inputString")
+
+
+
+
connectionID
+
+
The connection ID returned from tspnet.connect()
+
+
+
+
inputString
+
+
The string to be written
+
+
+
+
+
Details
+
The tspnet.write() function sends inputString to the remote instrument. It does not wait for command completion on the remote instrument.
+
The 2601B-PULSE sends inputString to the remote instrument exactly as indicated. The inputString must contain any necessary new lines, termination, or other syntax elements needed to complete properly.
+
Because tspnet.write() does not process output from the remote instrument, do not send commands that generate too much output without processing the output. This command can stop executing if there is too much unprocessed output from previous commands.
+
Example
+
+
+
+
tspnet.write(myID, "runscript()\r\n")
+
+
Commands the remote instrument to execute a command or script named runscript() on a remote device identified in the system as myID.
Integer value used as a handle for other tspnet commands
+
+
+
+
name
+
+
The full name of the reading buffer name and synchronous table to copy
+
+
+
+
startIndex
+
+
Integer start value
+
+
+
+
endIndex
+
+
Integer end value
+
+
+
+
+
Details
+
This function is only appropriate for TSP-enabled instruments.
+
This function reads the data from a reading buffer on a remote instrument and returns an array of numbers or a string representing the data. The startIndex and endIndex parameters specify the portion of the reading buffer to read. If no index is specified, the entire buffer is copied.
+
The function returns a table if the table is an array of numbers; otherwise a comma-delimited string is returned.
+
This command is limited to transferring 50,000 readings at a time.
+
Example
+
+
+
+
t = tspnet.tsp.rbtablecopy(testConnection,
+
"testRemotebuffername.readings", 1, 3)
+
print(t[1], t[2], t[3])
+
+
Copy the specified readings table for buffer items 1 through 3, then display the first three readings. Example output:
+
4.56534e-01
+
4.52675e-01
+
4.57535e-01
+
+
+
+
+
Also see
+
None
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/14126.htm b/WebHelpDocs/2601B-PULSE/14126.htm
new file mode 100644
index 0000000..7c1f678
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/14126.htm
@@ -0,0 +1,90 @@
+
+
+
+
+ Status model
+
+
+
+
+
+
+
+
+
+
+
+
+
Status model
+
The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/14129.htm b/WebHelpDocs/2601B-PULSE/14129.htm
new file mode 100644
index 0000000..3b48b1d
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/14129.htm
@@ -0,0 +1,95 @@
+
+
+
+
+ LAN and LXI
+
+
+
+
+
+
+
+
+
+
+
+
+
LAN and LXI
+
The LAN commands have options that allow you to review and configure network settings.
+
The lan.config.* commands allow you to configure LAN settings over the remote interface. Note that you must send lan.applysettings() for the configuration settings to take effect.
+
The lan.status.* commands help you determine the status of the LAN.
+
The lan.trigger[N].* commands allow you to set up and assert trigger events that are sent over the LAN.
+
Other LAN commands allow you to reset the LAN, restore defaults, check LXI domain information, and enable or disable the Nagle algorithm.
This command allows you to turn the beeper on or off.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Recall setup Instrument reset
+
+
Saved setup
+
+
1 (beeper.ON)
+
+
+
+
+
Usage
+
state = beeper.enable
+
beeper.enable = state
+
+
+
+
+
state
+
+
Disable the beeper: beeper.OFF or 0
+
Enable the beeper: beeper.ON or 1
+
+
+
+
+
Details
+
This command enables or disables the beeper. When enabled, a beep signals that a front-panel key has been pressed. Disabling the beeper also disables front-panel key clicks.
+
Example
+
+
+
+
beeper.enable = beeper.ON
+
beeper.beep(2, 2400)
+
+
Enables the beeper and generates a two-second, 2400 Hz tone.
This function overwrites a bit field at a specified index position.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
result = bit.setfield(value, index, width, fieldValue)
+
+
+
+
result
+
+
Result of the bit manipulation
+
+
+
+
value
+
+
Specified number
+
+
+
+
index
+
+
One-based bit position in value to set (1 to 32)
+
+
+
+
width
+
+
The number of bits to include in the field (1 to 32)
+
+
+
+
fieldValue
+
+
Value to write to the field
+
+
+
+
+
Details
+
This function returns result, which is value with a field of bits overwritten, starting at index. The index specifies the position of the least significant bit of value. The width bits starting at index are set to fieldValue.
+
The least significant bit of value is at index position 1; the most significant bit is at index position 32.
+
Before setting the field of bits, any fractional parts of value and fieldValue are truncated to form integers.
+
If fieldValue is wider than width, the most significant bits of the fieldValue that exceed the width are truncated. For example, if width is 4 bits and the binary value for fieldValue is 11110 (5 bits), the most significant bit of fieldValue is truncated and a binary value of 1110 is used.
+
Example
+
+
+
+
testResult = bit.setfield(15, 2, 3, 5)
+
+
+
print(testResult)
+
+
The binary equivalent of decimal 15 is 1111. After overwriting it with a decimal 5 (binary 101) at index position 2, the returned value is decimal 11 (binary 1011).
The resulting value of true or false based on the success of the function
+
+
+
+
value
+
+
The data item to add; value can be of any type
+
+
+
+
timeout
+
+
The maximum number of seconds to wait for space in the data queue
+
+
+
+
+
Details
+
You cannot use the timeout value when accessing the data queue from a remote node (you can only use the timeout value while adding data to the local data queue).
+
The timeout value is ignored if the data queue is not full.
+
The dataqueue.add() function returns false:
+
If the timeout expires before space is available in the data queue
If the data queue is full and a timeout value is not specified
If the value is a table, a duplicate of the table and any subtables is made. The duplicate table does not contain any references to the original table or to any subtables.
This attribute contains the number of items in the data queue.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
count= dataqueue.count
+
+
+
+
count
+
+
The number of items in the data queue
+
+
+
+
+
Details
+
The count is updated as entries are added with dataqueue.add() and read from the data queue with dataqueue.next(). It is also updated when the data queue is cleared with dataqueue.clear().
+
A maximum of dataqueue.CAPACITY items can be stored at any one time in the data queue.
+
Example
+
+
+
+
MaxCount = dataqueue.CAPACITY
+
while dataqueue.count < MaxCount do
+
dataqueue.add(1)
+
end
+
print("There are " .. dataqueue.count
+
.. " items in the data queue")
+
dataqueue.clear()
+
print("There are " .. dataqueue.count
+
.. " items in the data queue")
+
+
+
+
This example fills the data queue and prints the number of items in the queue. It then clears the queue and prints the number of items again.
This function removes the next entry from the data queue.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
value = dataqueue.next()
+
value = dataqueue.next(timeout)
+
+
+
+
value
+
+
The next entry in the data queue
+
+
+
+
timeout
+
+
The number of seconds to wait for data in the queue
+
+
+
+
+
Details
+
If the data queue is empty, the function waits up to the timeout value.
+
If data is not available in the data queue before the timeout expires, the return value is nil.
+
The entries in the data queue are removed in first-in, first-out (FIFO) order.
+
If the value is a table, a duplicate of the original table and any subtables is made. The duplicate table does not contain any references to the original table or to any subtables.
+
Example
+
+
+
+
dataqueue.clear()
+
for i = 1, 10 do
+
dataqueue.add(i)
+
end
+
print("There are " .. dataqueue.count
+
.. " items in the data queue")
+
+
while dataqueue.count > 0 do
+
x = dataqueue.next()
+
print(x)
+
end
+
print("There are " .. dataqueue.count
+
.. " items in the data queue")
+
+
Clears the data queue, adds ten entries, then reads the entries from the data queue. Note that your output may differ depending on the setting of format.asciiprecision.
The present value of the input lines on the digital I/O port
+
+
+
+
+
Details
+
The binary equivalent of the returned value indicates the value of the input lines on the I/O port. The least significant bit (bit B1) of the binary number corresponds to line 1; bit B14 corresponds to line 14.
+
For example, a returned value of 170 has a binary equivalent of 000000010101010, which indicates that lines 2, 4, 6, and 8 are high (1), and the other 10 lines are low (0).
+
Example
+
+
+
+
data = digio.readport()
+
print(data)
+
+
Assume lines 2, 4, 6, and 8 are set high when the I/O port is read.
This function clears the trigger event on a digital I/O line.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
digio.trigger[N].clear()
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
The event detector of a trigger enters the detected state when an event is detected. It is cleared when digio.trigger[N].wait() or digio.trigger[N].clear() is called.
+
digio.trigger[N].clear() clears the event detector of the specified trigger line, discards the history of the trigger line, and clears the digio.trigger[N].overrun attribute.
This constant identifies the trigger event generated by the digital I/O line N.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Constant
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
eventID = digio.trigger[N].EVENT_ID
+
+
+
+
eventID
+
+
The trigger event number
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
To have another trigger object respond to trigger events generated by the trigger line, set the stimulus attribute of the other object to the value of this constant.
This attribute sets the mode in which the trigger event detector and the output trigger generator operate on the given trigger line.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Digital I/O trigger N reset Recall setup
+
+
Not saved
+
+
0 (digio.TRIG_BYPASS)
+
+
+
+
+
Usage
+
triggerMode = digio.trigger[N].mode
+
digio.trigger[N].mode = triggerMode
+
+
+
+
triggerMode
+
+
The trigger mode; see Details for values
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
Set triggerMode to one of the following values:
+
+
+
Trigger mode values
+
+
+
+
triggerMode
+
+
Description
+
+
+
+
digio.TRIG_BYPASS or 0
+
+
Allows direct control of the line.
+
+
+
+
digio.TRIG_FALLING or 1
+
+
Detects falling-edge triggers as input; asserts a TTL-low pulse for output.
+
+
+
+
digio.TRIG_RISING or 2
+
+
If the programmed state of the line is high, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGA. If the programmed state of the line is low, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGM. This setting should only be used if necessary for compatibility with other Keithley Instruments products.
+
+
+
+
digio.TRIG_EITHER or 3
+
+
Detects rising- or falling-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
digio.TRIG_SYNCHRONOUSA or 4
+
+
Detects the falling-edge input triggers and automatically latches and drives the trigger line low. Asserting the output trigger releases the latched line.
+
+
+
+
digio.TRIG_SYNCHRONOUS or 5
+
+
Detects the falling-edge input triggers and automatically latches and drives the trigger line low. Asserts a TTL-low pulse as an output trigger.
+
+
+
+
digio.TRIG_SYNCHRONOUSM or 6
+
+
Detects rising-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
digio.TRIG_RISINGA or 7
+
+
Detects rising-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
digio.TRIG_RISINGM or 8
+
+
Asserts a TTL-high pulse for output. Input edge detection is not possible in this mode.
+
+
+
+
+
When programmed to any mode except digio.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored.
+
Use of either digio.TRIG_SYNCHRONOUSA or digio.TRIG_SYNCHRONOUSM is preferred over digio.TRIG_SYNCHRONOUS, because digio.TRIG_SYNCHRONOUS is provided for compatibility with the digital I/O and TSP-Link triggering on older firmware.
+
To control the line state, set the mode to digio.TRIG_BYPASS and use the digio.writebit() and digio.writeport() commands.
+
Example
+
+
+
+
digio.trigger[4].mode = 2
+
+
Sets the trigger mode for I/O line 4 to digio.TRIG_RISING.
This attribute returns the event detector overrun status.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Instrument reset Digital I/O trigger N clear Digital I/O trigger N reset Recall setup
+
+
Not saved
+
+
Not applicable
+
+
+
+
+
Usage
+
overrun = digio.trigger[N].overrun
+
+
+
+
overrun
+
+
Trigger overrun state (true or false)
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
If this is true, an event was ignored because the event detector was already in the detected state when the event occurred.
+
This is an indication of the state of the event detector built into the line itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.
+
Example
+
+
+
+
overrun = digio.trigger[1].overrun
+
print(overrun)
+
+
If there is no trigger overrun, the following text is output:
This function releases an indefinite length or latched trigger.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
digio.trigger[N].release()
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
Releases a trigger that was asserted with an indefinite pulsewidth time. It also releases a trigger that was latched in response to receiving a synchronous mode trigger. Only the specified trigger line is affected.
The value true if a trigger is detected, or false if no triggers are detected during the timeout period
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
timeout
+
+
Timeout in seconds
+
+
+
+
+
Details
+
This function pauses for up to timeout seconds for an input trigger. If one or more trigger events are detected since the last time digio.trigger[N].wait() or digio.trigger[N].clear() was called, this function returns a value immediately. After waiting for a trigger with this function, the event detector is automatically reset and ready to detect the next trigger. This is true regardless of the number of events detected.
+
Example
+
+
+
+
triggered = digio.trigger[4].wait(3)
+
print(triggered)
+
+
Waits up to three seconds for a trigger to be detected on trigger line 4, then outputs the results.
This function sets a digital I/O line high or low.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
digio.writebit(N, data)
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
data
+
+
The value to write to the bit:
+
0 (low)
Non-zero (high)
+
+
+
+
Details
+
If the output line is write-protected using the digio.writeprotect attribute, the command is ignored.
+
The reset() function does not affect the present state of the digital I/O lines.
+
Use the digio.writebit() and digio.writeport() commands to control the output state of the synchronization line when trigger operation is set to digio.TRIG_BYPASS.
+
The data must be zero (0) to clear the bit. Any value other than zero (0) sets the bit.
The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6, and 8 are set high (1), and the other 10 lines are set low (0).
+
Write-protected lines are not changed.
+
The reset() function does not affect the present states of the digital I/O lines.
+
Use the digio.writebit() and digio.writeport() commands to control the output state of the synchronization line when trigger operation is set to digio.TRIG_BYPASS.
+
Example
+
+
+
+
digio.writeport(255)
+
+
Sets digital I/O Lines 1 through 8 high (binary 00000011111111).
This attribute contains the write-protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup
+
+
Saved setup
+
+
0
+
+
+
+
+
+
Usage
+
mask = digio.writeprotect
+
digio.writeprotect = mask
+
+
+
+
mask
+
+
Sets the value that specifies the bit pattern for write-protect
+
+
+
+
+
Details
+
Bits that are set to one cause the corresponding line to be write-protected.
+
The binary equivalent of mask indicates the mask to be set for the I/O port. For example, a mask value of 7 has a binary equivalent of 00000000000111. This mask write-protects lines 1, 2, and 3.
This function clears all lines of the front-panel display.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
display.clear()
+
Details
+
This function switches to the user screen and then clears the front-panel display.
+
The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.
This function reads the present position of the cursor on the front-panel display.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
row, column, style = display.getcursor()
+
+
+
+
row
+
+
The row where the cursor is: 1 (top row); 2 (bottom row)
+
+
+
+
column
+
+
The column where the cursor is:
+
If the cursor is in the top row: 1 to 20
If the cursor is in the bottom row: 1 to 32
+
+
+
style
+
+
Visibility of the cursor:
+
Invisible: 0
Blinking: 1
+
+
+
+
Details
+
This function switches the front-panel display to the user screen (the text set by display.settext()), and then returns values to indicate the cursor's row and column position and cursor style.
+
Columns are numbered from left to right on the display.
+
Example 1
+
+
+
+
testRow, testColumn = display.getcursor()
+
print(testRow, testColumn)
+
+
This example reads the cursor position into local variables and prints them. Example output:
+
1.00000e+00 1.00000e+00
+
+
+
+
+
Example 2
+
+
+
+
print(display.getcursor())
+
+
This example prints the cursor position directly. In this example, the cursor is in row 1 at column 3, with an invisible cursor:
This function reads the text displayed on the front panel.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
text = display.gettext()
+
text = display.gettext(embellished)
+
text = display.gettext(embellished, row)
+
text = display.gettext(embellished, row, columnStart)
+
text = display.gettext(embellished, row, columnStart, columnEnd)
+
+
+
+
text
+
+
The returned value, which contains the text that is presently displayed
+
+
+
+
embellished
+
+
Indicates type of returned text: false (simple text); true (text with embedded character codes)
+
+
+
+
row
+
+
Selects the row from which to read the text: 1 (row 1); 2 (row 2). If row is not included, both rows of text are read
+
+
+
+
columnStart
+
+
Selects the first column from which to read text; for row 1, the valid column numbers are 1 to 20; for row 2, the valid column numbers are 1 to 32; if nothing is selected, 1 is used
+
+
+
+
columnEnd
+
+
Selects the last column from which to read text; for row 1, the valid column numbers are 1 to 20; for row 2, the valid column numbers are 1 to 32; the default is 20 for row 1, and 32 for row 2
+
+
+
+
+
Details
+
Using the command without any parameters returns both lines of the front-panel display.
+
The $N character code is included in the returned value to show where the top line ends and the bottom line begins. This is not affected by the value of embellished.
+
When embellished is set to true, all other character codes are returned along with the message. When embellished is set to false, only the message and the $N character code is returned. For information on the embedded character codes, see display.settext().
+
The display is not switched to the user screen (the screen set using display.settext()). Text is read from the active screen.
A string that defines how the input field is formatted; see Details for more information
+
+
+
+
default
+
+
The default value for the input value
+
+
+
+
minimum
+
+
The minimum input value
+
+
+
+
maximum
+
+
The maximum input value
+
+
+
+
+
Details
+
The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.
+
+
+
+
Option
+
+
Description
+
+
Examples
+
+
+
+
E
+
+
Include the E to display the value exponentially
+
+
0.00000e+0
+
+
+
+
+
+
+
Allows operators to enter positive or negative values; if the "+" sign is not included, the operator cannot enter a negative value
+
+
+0.00
+
+
+
+
0
+
+
Defines the digit positions for the value; you can use up to six zeros (0)
+
+
+00.0000e+00
+
+
+
+
.
+
+
Include to have a decimal point appear in the value
+
+
+0.00
+
+
+
+
+
The default parameter is the value shown when the value is first displayed.
+
The minimum and maximum parameters can be used to limit the values that can be entered. When + is not selected for format, the minimum limit must be more than or equal to zero (0). When limits are used, you cannot enter values above or below these limits.
+
The input value is limited to ±1e37.
+
Before calling display.inputvalue(), you should send a message prompt to the operator using display.prompt(). Make sure to position the cursor where the edit field should appear.
+
After this command is sent, script execution pauses until you enter a value and press the ENTER key.
+
For positive and negative entry (plus sign (+) used for the value field and/or the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel . Polarity will also toggle when using the navigation wheel to decrease or increase the value or exponent past zero. A zero (0) value or exponent (for example, +00) is always positive and cannot be toggled to negative polarity.
+
After executing this command and pressing the EXIT (LOCAL) key, the function returns nil.
+
Example
+
+
+
+
display.clear()
+
display.settext("Enter value between$N -0.10 and 2.00: ")
+
value = display.inputvalue("+0.00", 0.5, -0.1, 2.0)
+
print("Value entered = ", value)
+
+
+
+
Displays an editable field (+0.50) for operator input. The valid input range is -0.10 to +2.00, with a default of 0.50.
This function presents a menu on the front-panel display.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
selection = display.menu("name", "items")
+
+
+
+
selection
+
+
Name of the variable that holds the selected menu item
+
+
+
+
name
+
+
Menu name to display on the top line
+
+
+
+
items
+
+
Menu items to display on the bottom line
+
+
+
+
+
Details
+
The menu consists of the menu name string on the top line, and a selectable list of items on the bottom line. The menu items must be a single string with each item separated by whitespace. The name for the top line is limited to 20 characters.
+
After sending this command, script execution pauses for the operator to select a menu item. An item is selected by rotating the navigation wheel to place the blinking cursor on the item, and then pressing the navigation wheel (or the ENTER key). When an item is selected, the text of that selection is returned.
+
Pressing the EXIT (LOCAL) keywill not abort the script while the menu is displayed, but it will return nil. The script can be aborted by calling the exit function when nil is returned.
The active column position to set; row 1 has columns 1 to 20, row 2 has columns 1 to 32
+
+
+
+
style
+
+
Set the cursor to invisible (0, default) or blinking (1)
+
+
+
+
+
Details
+
Sending this command selects the user screen and then moves the cursor to the given location.
+
The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.
+
An out-of-range parameter for row sets the cursor to row 2. An out-of-range parameter for column sets the cursor to column 20 for row 1, or 32 for row 2.
+
An out-of-range parameter for style sets it to 0 (invisible).
+
A blinking cursor is only visible when it is positioned over displayed text. It cannot be seen when positioned over a space character.
+
Example
+
+
+
+
display.clear()
+
display.setcursor(1, 8)
+
display.settext("Hello")
+
display.setcursor(2, 14)
+
display.settext("World")
+
+
This example displays a message on the front panel, approximately center. Note that the top line of text is larger than the bottom line of text.
+
The front panel of the instrument displays "Hello" on the top line and "World" on the second line.
This function displays text on the front-panel user screen.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
display.settext("text")
+
+
+
+
text
+
+
Text message to be displayed, with optional character codes
+
+
+
+
+
Details
+
This function selects the user display screen and displays the given text.
+
After the instrument is turned on, the first time you use a display command to write to the display, the message "User Screen" is cleared. After the first write, you need to use display.clear() to clear the message.
+
The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.
+
The text starts at the present cursor position. After the text is displayed, the cursor is after the last character in the display message.
+
Top line text does not wrap to the bottom line of the display automatically. Any text that does not fit on the current line is truncated. If the text is truncated, the cursor remains at the end of the line.
+
The text remains on the display until replaced or cleared.
+
The character codes described in the following table can be also be included in the text string.
+
+
+
Display character codes
+
+
+
+
Character Code
+
+
Description
+
+
+
+
$N
+
+
Newline, starts text on the next line; if the cursor is already on line 2, text will be ignored after the $N is received
+
+
+
+
$R
+
+
Sets text to normal intensity, nonblinking
+
+
+
+
$B
+
+
Sets text to blink
+
+
+
+
$D
+
+
Sets text to dim intensity
+
+
+
+
$F
+
+
Sets the text to background blink
+
+
+
+
$$
+
+
Escape sequence to display a single dollar symbol ($)
This function clears the front-panel trigger event detector.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
display.trigger.clear()
+
Details
+
The trigger event detector remembers if an event has been detected since the last display.trigger.wait() call. This function clears the trigger event detector and discards the previous history of TRIG key presses.
+
This attribute also clears the display.trigger.overrun attribute.
This function waits for the TRIG key on the front panel to be pressed.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
triggered = display.trigger.wait(timeout)
+
+
+
+
triggered
+
+
true: Trigger was detected
+
false: The operation timed out
+
+
+
+
timeout
+
+
Timeout in seconds
+
+
+
+
+
Details
+
If the trigger key was previously pressed and one or more trigger events were detected, this function returns immediately.
+
After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.
+
Use the display.trigger.clear() call to clear the trigger event detector.
+
Example
+
+
+
+
triggered = display.trigger.wait(5)
+
print(triggered)
+
+
Waits up to five seconds for the TRIG key to be pressed. If TRIG is pressed within five seconds, the output is true. If not, the output is false.
This function reads the annunciators (indicators) that are presently turned on.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
annunciators = display.getannunciators()
+
+
+
+
annunciators
+
+
The bitmasked value that shows which indicators are turned on
+
+
+
+
+
Details
+
This function returns a bitmasked value showing which indicators are turned on. The 16-bit binary equivalent of the returned value is the bitmask. The return value is a sum of set annunciators, based on the weighted value, as shown in the following table.
+
+
+
+
Annunciator (indicator) bitmasked values and equivalent constants
Indicates if a trigger event was ignored because the event detector was already in the detected state when the TRIG button was pressed.
+
Indicates the overrun state of the event detector built into the display.
+
This attribute does not indicate whether an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.
+
Example
+
+
+
+
overrun = display.trigger.overrun
+
+
Sets the variable overrun equal to the present state of the event detector built into the display.
A string that defines how the input field is formatted; see Details for more information
+
+
+
+
units
+
+
Set the units text string for the top line (eight characters maximum); this indicates the units (for example, "V" or "A") for the value
+
+
+
+
help
+
+
Text string to display on the bottom line (32 characters maximum)
+
+
+
+
default
+
+
The value that is shown when the value is first displayed
+
+
+
+
minimum
+
+
The minimum input value that can be entered
+
+
+
+
maximum
+
+
The maximum input value that can be entered (must be more than minimum)
+
+
+
+
+
Details
+
This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt:
+
0.00V
+
Input 0 to +2V
+
The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted.
+
The format parameter can include the options shown in the following table.
+
+
+
+
Option
+
+
Description
+
+
Examples
+
+
+
+
E
+
+
Include the E to display the value exponentially. Include a plus sign (+) for positive/negative exponent entry. Do not include the plus sign (+) to prevent negative value entry. 0 defines the digit positions for the exponent.
+
+
+
0.00000E+0
+
+
+
+
+
+
+
Allows operators to enter positive or negative values. If the plus sign (+) is not included, the operator cannot enter a negative value.
+
+
+0.00
+
+
+
+
0
+
+
Defines the digit positions for the value. You can use up to six zeros (0).
+
+
+00.0000E+00
+
+
+
+
.
+
+
The decimal point where needed for the value.
+
+
+0.00
+
+
+
+
+
You can use the minimum and maximum parameters to limit the values that can be entered. When a plus sign (+) is not selected for format, the minimum limit must be greater than or equal to zero (0). When limits are used, the operator cannot enter values above or below these limits.
+
The input value is limited to ±1e37.
+
After sending this command, script execution pauses for the operator to enter a value and press ENTER.
+
For positive and negative entry (plus sign (+) used for the value field and the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel . Polarity will also toggle when using the navigation wheel to decrease or increase the value or exponent past zero. A zero value or exponent (for example, +00) is always positive and cannot be toggled to negative polarity.
+
After executing this command and pressing the EXIT (LOCAL) key, the value returns nil.
+
Example
+
+
+
+
value = display.prompt("0.00", "V", "Input 0 to +2V", 0.5, 0, 2)
+
print(value)
+
+
+
+
The above command prompts the operator to enter a voltage value. The valid input range is 0 to +2.00, with a default of 0.50:
When errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error and status message information.
This function returns all entries from the event log as a single string and removes them from the event log.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
logString = eventlog.all()
+
+
+
+
logString
+
+
A listing of all event log entries
+
+
+
+
+
Details
+
This function returns all events in the event log. Logged items are shown from oldest to newest. The response is a string that has the messages delimited with a new line character.
+
This function also clears the event log.
+
If there are no entries in the event log, this function returns the value nil.
+
Example
+
+
+
+
print(eventlog.all())
+
+
+
+
Get and print all entries from the event log and remove the entries from the log.
This function stops a script that is presently running.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
exit()
+
Details
+
Terminates script execution when called from a script that is being executed.
+
This command does not wait for overlapped commands to complete before terminating script execution. If overlapped commands are required to finish, use the waitcomplete() function before calling exit().
You can use the file I/O commands to open and close directories and files, write data, or to read a file on an installed USB flash drive. File I/O commands are organized into two groups:
+
Commands that reside in the fs and io table, for example: io.open(), io.close(), io.input(), and io.output(). Use these commands to manage file system directories; open and close file descriptors; and perform basic I/O operations on a pair of default files (one input and one output).
Commands that reside in the file descriptors (for example: fileVar:seek(), fileVar:write(), and fileVar:read()) operate exclusively on the file with which they are associated.
The root folder of the USB flash drive has the absolute path:
+
"/usb1/"
+
You can use either the slash (/) or backslash (\) as a directory separator. However, the backslash is also used as an escape character, so if you use it as a directory separator, you will generally need to use a double backslash (\\) when you are creating scripts or sending commands to the instrument.
+
For basic information about navigation and directory listing of files on a flash drive, see File system navigation.
+
File descriptor commands for file I/O use a colon (:) to separate the command parts rather than a period (.), like the io commands.
+
File descriptors cannot be passed between nodes in a TSP-Link® system, so the io.open(), fileVar::read(), and fileVar::write commands are not accessible to the TSP-Link system. However, the default input and output files mentioned above allow for the execution of many file I/O operations without any reference to a file descriptor.
The fileVar:write() or io.write() functions buffer data, which may not be written immediately to the USB flash drive. Use fileVar:flush() to flush this data. Using this function removes the need to close a file after writing to it, allowing the file to be left open to write more data. Data may be lost if the file is not closed or flushed before a script ends.
+
If there is going to be a time delay before more data is written to a file, and you want to keep the file open, flush the file after you write to it to prevent loss of data.
You can use the print(), printbuffer(), and printnumber() functions to query the instrument and generate response messages. The format attributes control how the data is formatted for the print functions used.
+
The localnode commands determine if generated errors are automatically sent and if prompts are generated.
This attribute sets the precision (number of digits) for all numbers returned in the ASCII format.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
No
+
+
Instrument reset Recall setup
+
+
Not saved
+
+
6
+
+
+
+
+
Usage
+
precision = format.asciiprecision
+
format.asciiprecision = precision
+
+
+
+
precision
+
+
A number representing the number of digits to be printed for numbers printed with the print(), printbuffer(), and printnumber() functions; must be a number between 1 and 16
+
+
+
+
+
Details
+
This attribute specifies the precision (number of digits) for numeric data printed with the print(), printbuffer(), and printnumber() functions. The format.asciiprecision attribute is only used with the ASCII format. The precision value must be a number from 0 to 16.
+
Note that the precision is the number of significant digits printed. There is always one digit to the left of the decimal point; be sure to include this digit when setting the precision.
This attribute sets the binary byte order for the data that is printed using the printnumber() and printbuffer() functions.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup
+
+
Not saved
+
+
1 (format.LITTLEENDIAN)
+
+
+
+
+
Usage
+
order= format.byteorder
+
format.byteorder = order
+
+
+
+
order
+
+
Byte order value as follows:
+
Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN
Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN
+
+
+
+
Details
+
This attribute selects the byte order in which data is written when you are printing data values with the printnumber() and printbuffer() functions. The byte order attribute is only used with the format.SREAL, format.REAL, format.REAL32, and format.REAL64 data formats.
+
format.NORMAL, format.BIGENDIAN, and format.NETWORK select the same byte order. format.SWAPPED and format.LITTLEENDIAN select the same byte order. Selecting which to use is a matter of preference.
+
Select the format.SWAPPED or format.LITTLEENDIAN byte order when sending data to a computer with a Microsoft Windows operating system.
+
Example
+
+
+
+
x = 1.23
+
format.data = format.REAL32
+
format.byteorder = format.LITTLEENDIAN
+
printnumber(x)
+
format.byteorder = format.BIGENDIAN
+
printnumber(x)
+
+
Output depends on the terminal program you use, but will look something like:
The precision of numeric values can be controlled with the format.asciiprecision attribute. The byte order of format.SREAL, format.REAL, format.REAL32, and format.REAL64 can be selected with the format.byteorder attribute.
+
REAL32 and SREAL select the same single precision format. REAL and REAL64 select the same double precision format. They are alternative identifiers. Selecting which to use is a matter of preference.
+
The IEEE Std 754 binary formats use four bytes for single-precision values and eight bytes for double-precision values.
+
When data is written with any of the binary formats, the response message starts with #0 and ends with a new line. When data is written with the ASCII format, elements are separated with a comma and space.
+
Binary formats are not intended to be interpreted by humans.
+
Example
+
+
+
+
format.asciiprecision = 10
+
x = 3.14159265
+
format.data = format.ASCII
+
printnumber(x)
+
format.data = format.REAL64
+
printnumber(x)
+
+
Output a number represented by x in ASCII using a precision of 10, then output the same number in binary using double precision format.
This function creates a directory at the specified path.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
path = fs.mkdir("newPath")
+
+
+
+
path
+
+
The returned path of the new directory
+
+
+
+
newpath
+
+
Location (path) of where to create the new directory
+
+
+
+
+
Details
+
The directory path may be absolute or relative to the current working directory.
+
An error is logged to the error queue if the parent folder of the new directory does not exist, or if a file system entry already exists at the given path.
+
Example
+
+
+
+
if fs.is_dir("/usb1/temp") == false then
+
fs.mkdir("/usb1/temp")
+
end
+
+
+
+
Insert a USB flash drive into the front panel of the instrument.
+
Check to see if the temp directory exists.
+
If it does not exist, create a directory named temp.
This function removes a directory from the file system.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
fs.rmdir("path")
+
+
+
+
path
+
+
The path of the directory to remove
+
+
+
+
+
Details
+
This path may be absolute or relative to the present working directory.
+
An error is logged to the error queue if the given path does not exist or does not represent a directory. An error is also logged if the directory is not empty.
+
Example
+
+
+
+
rootDirectory = "/usb1/"
+
tempDirectoryName = "temp"
+
if fs.is_dir(rootDirectory..tempDirectoryName) == false then
+
fs.mkdir(rootDirectory..tempDirectoryName)
+
end
+
fs.rmdir(rootDirectory..tempDirectoryName)
+
+
+
+
Insert a USB flash drive into the front panel of the instrument.
+
Set rootDirectory to be the USB port.
+
Set tempDirectoryName to be equivalent to temp.
+
Check to see if tempDirectoryName exists.
+
If it does not exist, create a directory named temp.
The address can be set to any address value from 1 to 30. However, the address must be unique in the system. It cannot conflict with an address that is assigned to another instrument or to the GPIB controller.
+
A new GPIB address takes effect when the command to change it is processed. If there are response messages in the output queue when this command is processed, they must be read at the new address.
+
If command messages are being queued (sent before this command has executed), the new settings may take effect in the middle of a subsequent command message, so care should be exercised when setting this attribute from the GPIB interface.
+
You should allow sufficient time for the command to be processed before attempting to communicate with the instrument again.
+
The reset() function does not affect the GPIB address.
You must use the io.flush() or io.close() functions to write data to the file system.
+
Data is not automatically written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.
+
This function only flushes the default output file.
+
Using this command removes the need to close a file after writing to it and allows it to be left open to write more data. Data may be lost if the file is not closed or flushed before an application ends. To prevent the loss of data if there is going to be a time delay before more data is written (and when you want to keep the file open and not close it), flush the file after writing to it.
Indicates whether an error was encountered while processing the function
+
+
+
+
path
+
+
The path of the file to open
+
+
+
+
mode
+
+
A string representing the intended access mode ("r" = read, "w" = write, and "a" = append)
+
+
+
+
+
Details
+
The path to the file to open may be absolute or relative to the current working directory. If you successfully open the file, errorMsg is nil and fileVar has the descriptor that can be used to access the file.
+
If an error is encountered, the command returns nil for fileVar and an error string.
This function writes data to the default output file.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
io.write()
+
io.write(data1)
+
io.write(data1, data2)
+
io.write(data1, ..., dataN)
+
+
+
+
data1
+
+
The data to be written
+
+
+
+
data2
+
+
The data to be written
+
+
+
+
dataN
+
+
The data to be written
+
+
+
+
...
+
+
One or more values separated by commas
+
+
+
+
+
Details
+
All data parameters must be either strings or numbers.
+
Data is not immediately written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.
This function re-initializes the LAN interface with new settings.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
lan.applysettings()
+
Details
+
Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.
+
This function initiates a background operation. LAN configuration could be a lengthy operation. Although the function returns immediately, the LAN initialization continues to run in the background.
+
Even though the LAN configuration settings may not have changed since the LAN was last connected, new settings may take effect due to the dynamic nature of dynamic host configuration protocol (DHCP) or dynamic link local addressing (DLLA) configuration.
+
Re-initialization takes effect even if the configuration has not changed since the last time the instrument connected to the LAN.
+
Example
+
+
+
+
lan.applysettings()
+
+
Re-initialize the LAN interface with new settings.
This attribute contains the LAN timed-wait state interval.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
LAN restore defaults
+
+
Nonvolatile memory
+
+
20 (20 s)
+
+
+
+
+
Usage
+
timeout = lan.timedwait
+
lan.timedwait = timeout
+
+
+
+
timeout
+
+
The LAN timed-wait state interval in seconds
+
+
+
+
+
Details
+
This attribute controls the amount of time that resources are allocated to closed TCP connections. When a TCP connection is closed, the connection is put in a timed-wait state and resources remain allocated for the connection until the timed-wait state ends. During the timed-wait interval, the instrument processes delayed packets that arrive after the connection is closed.
+
Use this attribute to tailor the timed-wait state interval for the instrument.
+
Example
+
+
+
+
lan.timedwait = 30
+
+
Set the amount of time resources are allocated to TCP connection to 30 s.
This attribute is an array of DNS (domain name system) server addresses. These addresses take priority for DNS lookups and are consulted before any server addresses that are obtained using DHCP. This allows local DNS servers to be specified that take priority over DHCP-configured global DNS servers.
+
You can specify up to two addresses. The address specified by 1 is consulted first for DNS lookups. dnsAddress must be a string specifying the IP address of the DNS server in dotted decimal notation.
+
Unused entries are returned as "0.0.0.0" when read. To disable an entry, set its value to "0.0.0.0" or the empty string "".
+
Although only two addresses may be manually specified here, the instrument will use up to three DNS server addresses. If two are specified here, only one that is given by a DHCP server is used. If no entries are specified here, up to three addresses that are given by a DHCP server are used.
Dynamic DNS registration domain; use a string of 255 characters or less
+
+
+
+
+
Details
+
This attribute holds the domain to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the domain specified in this attribute with the DNS server.
+
The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters. Although up to 255 characters are allowed, you must make sure the combined length is also no more than 255 characters.
+
Example
+
+
+
+
print(lan.config.dns.domain)
+
+
Outputs the present dynamic DNS domain. For example, if the domain is "Matrix", the response would be:
The dynamic DNS registration state. It may be one of the following values:
+
1 or lan.ENABLE: Enabled
0 or lan.DISABLE: Disabled
+
+
+
+
Details
+
Dynamic DNS registration works with DHCP to register the host name with the DNS server. The host name is specified in the lan.config.dns.hostname attribute.
+
Example
+
+
+
+
print(lan.config.dns.dynamic)
+
+
Outputs the dynamic registration state.
+
If dynamic DNS registration is enabled, the response is:
LAN duplex setting can be one of the following values:
+
1 or lan.FULL: Selects full-duplex operation
0 or lan.HALF: Selects half-duplex operation
+
+
+
+
Details
+
This attribute does not indicate the actual setting currently in effect. Use the lan.status.duplex attribute to determine the present operating state of the LAN.
This attribute contains the LAN default gateway address.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
LAN restore defaults
+
+
Nonvolatile memory
+
+
"0.0.0.0"
+
+
+
+
+
Usage
+
gatewayAddress = lan.config.gateway
+
lan.config.gateway = "gatewayAddress"
+
+
+
+
gatewayAddress
+
+
LAN default gateway address; must be a string specifying the default gateway’s IP address in dotted decimal notation
+
+
+
+
+
Details
+
This attribute specifies the default gateway IP address to use when manual or DLLA configuration methods are used to configure the LAN. If DHCP is enabled, this setting is ignored.
+
This attribute does not indicate the actual setting that is presently in effect. Use the lan.status.gateway attribute to determine the present operating state of the LAN.
+
The IP address must be formatted in four groups of numbers, each separated by a decimal.
+
Example
+
+
+
+
print(lan.config.gateway)
+
+
Outputs the default gateway address. For example, you might see the output:
LAN IP address; must be a string specifying the IP address in dotted decimal notation
+
+
+
+
+
Details
+
This command specifies the LAN IP address to use when the LAN is configured using the manual configuration method. This setting is ignored when DLLA or DHCP is used.
+
This attribute does not indicate the actual setting that is presently in effect. Use the lan.status.ipaddress attribute to determine the present operating state of the LAN.
This attribute contains the LAN settings configuration method.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
LAN restore defaults
+
+
Nonvolatile memory
+
+
0 (lan.AUTO)
+
+
+
+
+
Usage
+
method = lan.config.method
+
lan.config.method = method
+
+
+
+
method
+
+
The method for configuring LAN settings; it can be one of the following values:
+
0 or lan.AUTO: Selects automatic sequencing of configuration methods
1 or lan.MANUAL: Use only manually specified configuration settings
+
+
+
+
Details
+
This attribute controls how the LAN IP address, subnet mask, default gateway address, and DNS server addresses are determined.
+
When method is lan.AUTO, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP). If DHCP fails, it tries dynamic link local addressing (DLLA). If DLLA fails, it uses the manually specified settings.
+
When method is lan.MANUAL, only the manually specified settings are used. Neither DHCP nor DLLA are attempted.
This attribute contains the LAN speed used when restarting in manual configuration mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
LAN restore defaults
+
+
Nonvolatile memory
+
+
100 (100 Mbps)
+
+
+
+
+
Usage
+
speed = lan.config.speed
+
lan.config.speed = speed
+
+
+
+
speed
+
+
LAN speed setting in Mbps (10 or 100)
+
+
+
+
+
Details
+
This attribute stores the speed that will be used if the LAN is restarted for manual configuration operation.
+
This attribute does not indicate the actual setting presently in effect. Use the lan.status.speed attribute to determine the present operating state of the LAN.
+
The LAN speed is measured in megabits per second (Mbps).
String that specifies the LAN subnet mask value in dotted decimal notation
+
+
+
+
+
Details
+
This attribute specifies the LAN subnet mask that will be used when the manual configuration method is used to configure the LAN. This setting is ignored when DLLA or DHCP is used.
+
This attribute does not indicate the actual setting presently in effect. Use the lan.status.subnetmask attribute to determine the present operating state of the LAN.
This attribute contains the DNS server IP addresses.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
dnsAddress = lan.status.dns.address[N]
+
+
+
+
dnsAddress
+
+
DNS server IP address
+
+
+
+
N
+
+
Entry index (1, 2, or 3)
+
+
+
+
+
Details
+
This attribute is an array of DNS server addresses. The instrument can use up to three addresses.
+
Unused or disabled entries are returned as "0.0.0.0" when read. The dnsAddress returned is a string specifying the IP address of the DNS server in dotted decimal notation.
+
You can only specify two addresses manually. However, the instrument uses up to three DNS server addresses. If two are specified, only the one given by a DHCP server is used. If no entries are specified, up to three address given by a DHCP server are used.
+
The value of lan.status.dns.address[1] is referenced first for all DNS lookups. The values of lan.status.dns.address[2] and lan.status.dns.address[3] are referenced second and third, respectively.
This attribute contains the present DNS fully qualified host name.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
hostName = lan.status.dns.name
+
+
+
+
hostName
+
+
Fully qualified DNS host name that can be used to connect to the instrument
+
+
+
+
+
Details
+
A fully qualified domain name (FQDN), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tree hierarchy of the Domain Name System (DNS).
+
A FQDN is the complete domain name for a specific computer or host on the LAN. The FQDN consists of two parts: the host name and the domain name.
+
If the DNS host name for an instrument is not found, this attribute stores the IP address in dotted decimal notation.
The MAC address is a character string representing the MAC address of the instrument in hexadecimal notation. The string includes colons that separate the address octets (see Example).
+
Example
+
+
+
+
print(lan.status.macaddress)
+
+
Outputs the MAC address of the instrument, for example:
This attribute contains the LAN subnet mask that is presently in use by the LAN interface.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
mask = lan.status.subnetmask
+
+
+
+
mask
+
+
A string specifying the subnet mask in dotted decimal notation
+
+
+
+
+
Details
+
Use this attribute to determine the present operating state of the LAN. This attribute will return the present LAN subnet mask value if the LAN is manually configured, or when DLLA or DHCP is used.
+
Example
+
+
+
+
print(lan.status.subnetmask)
+
+
Outputs the subnet mask of the instrument that is presently in use, such as:
This function clears the event detector for a LAN trigger.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
lan.trigger[N].clear()
+
+
+
+
N
+
+
The LAN event number (1 to 8) to clear
+
+
+
+
+
Details
+
The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the history of the trigger packet.
+
This function clears all overruns associated with this LAN trigger.
This function prepares the event generator for outgoing trigger events.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
lan.trigger[N].connect()
+
+
+
+
N
+
+
The LAN event number (1 to 8)
+
+
+
+
+
Details
+
This command prepares the event generator to send event messages. For TCP connections, this opens the TCP connection.
+
The event generator automatically disconnects when either the protocol or IP address for this event is changed.
+
Example
+
+
+
+
lan.trigger[1].protocol = lan.MULTICAST
+
lan.trigger[1].connect()
+
lan.trigger[1].assert()
+
+
Set the protocol for LAN trigger 1 to be multicast when sending LAN triggers. Then, after connecting the LAN trigger, send a message on LAN trigger 1 by asserting it.
This attribute stores the LAN event connection state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
connected = lan.trigger[N].connected
+
+
+
+
connected
+
+
The LAN event connection state:
+
true: Connected
false: Not connected
+
+
+
N
+
+
The LAN event number (1 to 8)
+
+
+
+
+
Details
+
This read-only attribute is set to true when the LAN trigger is connected and ready to send trigger events following a successful lan.trigger[N].connect() command; if the LAN trigger is not ready to send trigger events, this value is false.
+
This attribute is also false when either lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes are changed or the remote connection closes the connection.
+
Example
+
+
+
+
lan.trigger[1].protocol = lan.MULTICAST
+
print(lan.trigger[1].connected)
+
+
Outputs true if connected, or false if not connected.
This attribute sets the trigger operation and detection mode of the specified LAN event.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset LAN trigger N reset Recall setup
+
+
Not saved
+
+
0 (lan.TRIG_EITHER)
+
+
+
+
+
Usage
+
mode = lan.trigger[N].mode
+
lan.trigger[N].mode = mode
+
+
+
+
mode
+
+
A number representing the trigger mode (0 to 7); see the Details section for more information
+
+
+
+
N
+
+
A number representing the LAN event number (1 to 8)
+
+
+
+
+
Details
+
This command controls how the trigger event detector and the output trigger generator operate on the given trigger. These settings are intended to provide behavior similar to the digital I/O triggers.
+
+
+
LAN trigger mode values
+
+
+
+
Mode
+
+
Number
+
+
Trigger packets detected as input
+
+
LAN trigger packet generated for output with a…
+
+
+
+
lan.TRIG_EITHER
+
+
0
+
+
Rising or falling edge (positive or negative state)
+
+
negative state
+
+
+
+
lan.TRIG_FALLING
+
+
1
+
+
Falling edge (negative state)
+
+
negative state
+
+
+
+
lan.TRIG_RISING
+
+
2
+
+
Rising edge (positive state)
+
+
positive state
+
+
+
+
lan.TRIG_RISINGA
+
+
3
+
+
Rising edge (positive state)
+
+
positive state
+
+
+
+
lan.TRIG_RISINGM
+
+
4
+
+
Rising edge (positive state)
+
+
positive state
+
+
+
+
lan.TRIG_SYNCHRONOUS
+
+
5
+
+
Falling edge (negative state)
+
+
positive state
+
+
+
+
lan.TRIG_SYNCHRONOUSA
+
+
6
+
+
Falling edge (negative state)
+
+
positive state
+
+
+
+
lan.TRIG_SYNCHRONOUSM
+
+
7
+
+
Rising edge (positive state)
+
+
negative state
+
+
+
+
+
lan.TRIG_RISING and lan.TRIG_RISINGA are the same.
+
lan.TRIG_RISING and lan.TRIG_RISINGM are the same.
+
Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM over lan.TRIG_SYNCHRONOUS is preferred, as lan.TRIG_SYNCHRONOUS is provided for compatibility with older firmware.
+
Example
+
+
+
+
print(lan.trigger[1].mode)
+
+
Outputs the present LAN trigger mode of LAN event 1.
This attribute contains the overrun status of the LAN event detector.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
LAN trigger N clear LAN trigger N reset Instrument reset Recall setup
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
overrun = lan.trigger[N].overrun
+
+
+
+
overrun
+
+
The trigger overrun state for the specified LAN packet (true or false)
+
+
+
+
N
+
+
The LAN event number (1 to 8)
+
+
+
+
+
Details
+
This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred.
+
This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.
+
It also is not an indication of an output trigger overrun. Output trigger overrun indications are provided in the status model.
+
Example
+
+
+
+
overrun = lan.trigger[5].overrun
+
print(overrun)
+
+
Checks the overrun status of a trigger on LAN5 and outputs the value, such as:
This attribute sets the LAN protocol to use for sending trigger messages.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset LAN trigger N reset Recall setup
+
+
Not saved
+
+
0 (lan.TCP)
+
+
+
+
+
Usage
+
protocol = lan.trigger[N].protocol
+
lan.trigger[N].protocol = protocol
+
+
+
+
protocol
+
+
The protocol to use for messages from the trigger:
+
0 or lan.TCP
1 or lan.UDP
2 or lan.MULTICAST
+
+
+
N
+
+
The LAN event number (1 to 8)
+
+
+
+
+
Details
+
The LAN trigger listens for trigger messages on all supported protocols, but uses the designated protocol for sending outgoing messages. After changing this setting, lan.trigger[N].connect() must be called before outgoing event messages can be sent.
+
When the lan.MULTICAST protocol is selected, the lan.trigger[N].ipaddress attribute is ignored and event messages are sent to the multicast address 224.0.23.159.
+
Example
+
+
+
+
print(lan.trigger[1].protocol)
+
+
Get LAN protocol to use for sending trigger messages for LAN event 1.
Maximum amount of time in seconds to wait for the trigger event
+
+
+
+
+
Details
+
If one or more trigger events have been detected since the last time lan.trigger[N].wait() or lan.trigger[N].clear() was called, this function returns immediately.
+
After waiting for a LAN trigger event with this function, the event detector is automatically reset and rearmed regardless of the number of events detected.
+
Example
+
+
+
+
triggered = lan.trigger[5].wait(3)
+
+
Wait for a trigger with LAN packet 5 with a timeout of 3 seconds.
This attribute enables or disables automatic power line frequency detection at start-up.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
true (enabled)
+
+
+
+
+
Usage
+
flag = localnode.autolinefreq
+
localnode.autolinefreq = flag
+
+
+
+
flag
+
+
The auto line frequency detection setting:
+
true: Enable automatic line frequency detection at start-up
false: Disable automatic line frequency detection at start-up
+
+
+
+
Details
+
When this attribute is set to true, the power line frequency is detected automatically the next time the 2601B-PULSE powers up. After the power line frequency is automatically detected at power-up, the localnode.linefreq attribute is set automatically to 50 or 60.
+
If the localnode.linefreq attribute is explicitly set, localnode.autolinefreq is automatically set to false.
+
When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].autolinefreq.
This attribute stores a user-defined description and mDNS service name of the instrument.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
Instrument specific (see Details)
+
+
+
+
+
Usage
+
localnode.description = "description"
+
description = localnode.description
+
+
+
+
description
+
+
User-defined description and mDNS service name of the instrument; use a string of 63 characters or less
+
+
+
+
+
Details
+
This attribute stores a string that contains a description of the instrument. This value appears on LXI welcome page of the instrument. The value of this attribute is also used as the mDNS service name of the instrument.
+
This attribute's factory default value is "Keithley Instruments SMU <model number> - <serial number>", where <model number> and <serial number> are replaced with the actual model number and serial number of the instrument. Setting this attribute to an empty string (in other words, setting this attribute to a string of length zero, or one consisting entirely of whitespace characters) will revert the description to the factory default value.
+
When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].description.
This function returns the value of a global variable.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
value = node[N].getglobal("name")
+
+
+
+
value
+
+
The value of the variable
+
+
+
+
N
+
+
The node number of this instrument (1 to 64)
+
+
+
+
name
+
+
The global variable name
+
+
+
+
+
Details
+
This function retrieves the value of a global variable from the runtime environment of this node.
+
Do not use this command to retrieve the value of a global variable from the local node. Instead, access the global variable directly. This command should only be used from a remote master when controlling this instrument over a TSP-Link network.
+
Example
+
+
+
+
print(node[5].getglobal("test_val"))
+
+
+
+
Retrieves and outputs the value of the global variable named test_val from node 5.
This attribute contains the power line frequency setting that is used for NPLC calculations.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
60 (60 Hz)
+
+
+
+
+
Usage
+
frequency = localnode.linefreq
+
localnode.linefreq = frequency
+
+
+
+
frequency
+
+
An integer representing the detected or specified line frequency of the instrument
+
+
+
+
+
Details
+
To achieve optimum noise rejection when performing measurements at integer NPLC apertures, set the line frequency attribute to match the frequency (50 Hz or 60 Hz) of the AC power line.
+
When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].linefreq. When this attribute is set, the localnode.autolinefreq attribute is automatically set to false. You can have the instrument automatically detect the AC power line frequency and set this attribute with the line frequency detected when the instrument power is turned on by setting the localnode.autolinefreq attribute to true.
A string that contains the remote interface password
+
+
+
+
+
Details
+
This write-only attribute stores the password that is set for any remote interface. When password usage is enabled (localnode.passwordmode), you must supply a password to change the configuration or to control an instrument from a web page or other remote command interface.
+
The instrument continues to use the old password for all interactions until the command to change it executes. When changing the password, give the instrument time to execute the command before attempting to use the new password.
+
You cannot retrieve a lost password from any command interface.
+
You can reset the password by resetting the LAN from the front panel or by using the lan.reset() command.
+
When using this command from a remote node, localnode should be replaced with the node reference, for example, node[5].password.
+
Example
+
+
+
+
localnode.password = "N3wpa55w0rd"
+
+
Changes the remote interface password to N3wpa55w0rd.
This attribute determines if the instrument generates prompts in response to command messages.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Power cycle
+
+
Not saved
+
+
0 (disabled)
+
+
+
+
+
Usage
+
prompting = localnode.prompts
+
localnode.prompts = prompting
+
+
+
+
prompting
+
+
Prompting mode:
+
Do not generate prompts: 1
Generate prompts: 0
+
+
+
+
Details
+
When the prompting mode is enabled, the instrument generates prompts when the instrument is ready to take another command. Because the prompt is not generated until the previous command completes, enabling prompts provides handshaking with the instrument to prevent buffer overruns.
+
When prompting is enabled, the instrument might generate the following prompts:
+
TSP>. The standard prompt, which indicates that the previous command completed normally.
TSP?. The prompt that is issued if there are unread entries in the error queue when the prompt is issued. Like the TSP> prompt, it indicates that processing of the command is complete. It does not mean the previous command generated an error, only that there were still errors in the queue when the command processing was complete.
>>>>. The continuation prompt, which occurs when downloading scripts. When downloading scripts, many command messages must be sent as a group. The continuation prompt indicates that the instrument is expecting more messages as part of the present command.
Commands do not generate prompts. The instrument generates prompts in response to command completion.
+
Prompts are enabled or disabled only for the remote interface that is active when you send the command. For example, if you enable prompts when the LAN connection is active, they will not be enabled for a subsequent USB connection.
+
Do not disable prompting when using Test Script Builder. Test Script Builder requires prompts and sets the prompting mode automatically. If you disable prompting, the instrument will stop responding when you communicate using Test Script Builder because it is waiting for a common complete prompt from Test Script Builder.
This attribute enables and disables the generation of prompts for IEEE Std 488.2 common commands.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Power cycle
+
+
Not saved
+
+
1 (enabled)
+
+
+
+
+
Usage
+
prompting = localnode.prompts4882
+
localnode.prompts4882 = prompting
+
+
+
+
prompting
+
+
IEEE Std 488.2 prompting mode:
+
Disable prompting: 0
Enable prompting: 1
+
+
+
+
Details
+
When this attribute is enabled, the IEEE Std 488.2 common commands generate prompts if prompting is enabled with the localnode.prompts attribute. If localnode.prompts4882 is enabled, limit the number of *trg commands sent to a running script to 50 regardless of the setting of the localnode.prompts attribute.
+
When this attribute is disabled, IEEE Std 488.2 common commands will not generate prompts. When using the *trg command with a script that executes trigger.wait() repeatedly, disable prompting to avoid problems associated with the command interface input queue filling.
This function sets the value of a global variable.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
node[N].setglobal("name", value)
+
+
+
+
N
+
+
The node number of this instrument (1 to 6463)
+
+
+
+
name
+
+
The global variable name to set
+
+
+
+
value
+
+
The value to assign to the variable
+
+
+
+
+
Details
+
From a remote node, use this function to assign the given value to a global variable.
+
Do not use this command to create or set the value of a global variable from the local node (set the global variable directly instead). This command should only be used from a remote master when controlling this instrument over a TSP-Link network.
+
Example
+
+
+
+
node[3].setglobal("x", 5)
+
+
Sets the global variable x on node 3 to the value of 5.
String representing the daylight savings offset from UTC
+
+
+
+
dstStart
+
+
String representing when daylight savings time starts
+
+
+
+
dstEnd
+
+
String representing when daylight savings time ends
+
+
+
+
+
Details
+
You only need to set the time zone if you use the os.time() and os.date() functions.
+
If only one parameter is given, the same time offset is used throughout the year. If four parameters are given, time is adjusted twice during the year for daylight savings time.
+
offset and dstOffset are strings of the form "[+|-]hh[:mm[:ss]]" that indicate how much time must be added to the local time to get UTC time:
+
hh is a number between 0 and 23 that represents hours
mm is a number between 0 and 59 that represents minutes
ss is a number between 0 and 59 that represents seconds
The minute, second, +, and - fields are optional.
+
For example, to set the UTC-5 time zone, you specify the string "5", because UTC-5 is 5 hours behind UTC and you must add 5 hours to the local time to determine UTC time. To specify the time zone UTC4, you specify "-4", because UTC4 is 4 hours ahead of UTC and 4 hours must be subtracted from the local time to determine UTC.
+
dstStart and dstEnd are strings of the form "MM.w.dw/hh[:mm[:ss]]" that indicate when daylight savings time begins and ends respectively:
+
MM is a number between 1 and 12 that represents the month
w is a number between 1 and 5 that represents the week in the month
dw is a number between 0 and 6 that represents the day of the week (where 0 is Sunday)
The rest of the fields represent the time of day that the change takes effect:
+
hh represents hours
mm represents minutes
ss represents seconds
The minutes and seconds fields are optional.
+
The week of the month and day of the week fields are not specific dates.
+
Example
+
+
+
+
settimezone("8", "1", "3.3.0/02", "11.2.0/02")
+
settimezone(offset)
+
+
Sets offset to equal +8 hours, +1 hour for DST, starts on Mar 14 at 2:00 am, ends on Nov 7 at 2:00 am.
This attribute sets whether or not the instrument automatically sends generated errors.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Power cycle
+
+
Not saved
+
+
0 (disabled)
+
+
+
+
+
Usage
+
errorMode = localnode.showerrors
+
localnode.showerrors = errorMode
+
+
+
+
errorMode
+
+
Show error setting:
+
Show errors: 1
Do not show errors: 0
+
+
+
+
Details
+
If this attribute is set to 1, the instrument automatically sends any generated errors stored in the error queue, and then clears the queue. Errors are processed after executing a command message (just before issuing a prompt, if prompts are enabled).
+
If this attribute is set to 0, errors are left in the error queue and must be explicitly read or cleared.
+
When using this command from a remote node, localnode should be replaced with the node reference, for example, node[5].showerrors.
This function creates a function to get the value of an attribute.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
getter = makegetter(table, "attributeName")
+
+
+
+
getter
+
+
The return value
+
+
+
+
table
+
+
Read-only table where the attribute is located
+
+
+
+
attributeName
+
+
A string representing the name of the attribute
+
+
+
+
+
Details
+
This function is useful for aliasing attributes to improve execution speed. Calling the function created with makegetter() executes more quickly than accessing the attribute directly.
+
Creating a getter function is only useful if it is going to be called several times. Otherwise, the overhead of creating the getter function outweighs the overhead of accessing the attribute directly.
+
Example
+
+
+
+
getlevel = makegetter(smua.source, "levelv")
+
v = getlevel()
+
+
+
+
Creates a getter function called getlevel.
+
When getlevel() is called, it returns the value of smua.source.levelv.
This function creates a function that, when called, sets the value of an attribute.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
setter = makesetter(table, "attributeName")
+
+
+
+
setter
+
+
Function that sets the value of the attribute
+
+
+
+
table
+
+
Read-only table where the attribute is located
+
+
+
+
attributeName
+
+
The string name of the attribute
+
+
+
+
+
Details
+
This function is useful for aliasing attributes to improve execution speed. Calling the setter function execute more quickly than accessing the attribute directly.
+
Creating a setter function is only useful if it is going to be called several times. If you are not calling the setter function several times, it is more efficient to access the attribute directly.
+
Example
+
+
+
+
setlevel = makesetter(smua.source, "levelv")for v = 1, 10 do
+
setlevel(v)
+
end
+
+
+
+
Creates a setter function called setlevel.
+
Using setlevel() in the loop sets the value of smua.source.levelv, performing a source sweep.
This function sets the operation complete status bit when all overlapped commands are completed.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
opc()
+
Details
+
This function causes the operation complete bit in the Standard Event Status Register to be set when all previously started local overlapped commands are complete.
+
Note that each node independently sets its operation complete bits in its own status model. Any nodes that are not actively performing overlapped commands set their bits immediately. All remaining nodes set their own bits as they complete their own overlapped commands.
Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.
+
For detail on using scripts, see Fundamentals of scripting for TSP.
This function creates a script from a specified file.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
scriptVar = script.load("file")
+
scriptVar = script.load("file", "name")
+
+
+
+
scriptVar
+
+
The created script; this is nil if an error is encountered
+
+
+
+
file
+
+
The path and file name of the script file to load
+
+
+
+
name
+
+
The name of the script to be created
+
+
+
+
+
Details
+
The file path may be absolute or relative to the current working directory. The root folder of the USB flash drive has the absolute path "/usb1/". Both the forward slash (/) and backslash (\) are supported as directory separators.
+
The file to be loaded must start with the loadscript or loadandrunscript keywords, contain the body of the script, and end with the endscript keyword.
+
Script naming:
+
If the name parameter is an empty string, or name is absent (or nil) and the script name cannot be extracted from the file, scriptVar is the only handle to the created script.
If name is given (and not nil), any script name embedded in the file is ignored.
If name conflicts with the name of an existing script in the script.user.scripts table, the existing script’s name attribute is set to an empty string before it is replaced in the script.user.scripts table by the new script.
If name is absent or nil, the command attempts to extract the name of the script from the file. Any conflict between the extracted name and that of an existing script in the scripts table generates an error. If the script name cannot be extracted, the created script's name attribute is initialized to the empty string and must be set to a valid nonempty string before saving the script to nonvolatile memory.
The name of the variable that will reference the script
+
+
+
+
code
+
+
A string containing the body of the script
+
+
+
+
name
+
+
The name of the script
+
+
+
+
+
Details
+
The name parameter is the name that is added to the script.user.scripts table. If name is not given, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the existing script's name attribute is set to an empty string before it is replaced by the new script.
+
Note that name is the value that is used for the instrument front panel display. If this value is not defined, the script is not available from the front panel.
+
You must save the new script into nonvolatile memory to keep it when the instrument is turned off.
+
Example 1
+
+
+
+
myTest8 = script.new(
+
"display.clear() display.settext('Hello from myTest8')", "myTest8")
+
myTest8()
+
+
+
+
Creates a new script referenced by the variable myTest8 with the name "myTest8".
+
Runs the script. The instrument displays "Hello from myTest8".
+
+
+
+
+
Example 2
+
+
+
+
autoexec = script.new(
+
"display.clear() display.settext('Hello from autoexec')", 'autoexec')
+
+
+
+
Creates a new autoexec script that clears the display when the instrument is turned on and displays "Hello from autoexec".
This attribute configures the baud rate for the RS-232 port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
9600
+
+
+
+
+
Usage
+
baud = serial.baud
+
serial.baud = baud
+
+
+
+
baud
+
+
The baud rate (300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200)
+
+
+
+
+
Details
+
A new baud rate setting takes effect when the command to change it is processed.
+
Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the baud rate from one of the other command interfaces or from the front panel.
This attribute configures character width (data bits) for the RS-232 port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
8
+
+
+
+
+
Usage
+
bits = serial.databits
+
serial.databits = bits
+
+
+
+
bits
+
+
An integer representing the character width (7 or 8)
+
+
+
+
+
Details
+
A new data width setting takes effect when the command to change it is processed.
+
Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the character width from one of the other command interfaces or from the front panel.
This attribute configures flow control for the RS-232 port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
"none" (serial.FLOW_NONE)
+
+
+
+
+
Usage
+
flow = serial.flowcontrol
+
serial.flowcontrol = flow
+
+
+
+
flow
+
+
A string or value that represents flow control configuration; set to:
+
"none" or serial.FLOW_NONE (selects no flow control)
"hardware" or serial.FLOW_HARDWARE (selects hardware flow control)
+
+
+
+
Details
+
A new flow control setting takes effect when the command to change it is processed.
+
Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the flow control from one of the other command interfaces or from the front panel.
This attribute configures parity for the RS-232 port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
"none" (serial.PARITY_NONE)
+
+
+
+
+
Usage
+
parity = serial.parity
+
serial.parity = parity
+
+
+
+
parity
+
+
Set parity to one of the following values:
+
Select no parity ("none" or serial.PARITY_NONE)
Select even parity ("even" or serial.PARITY_EVEN)
Select odd parity ("odd" or serial.PARITY_ODD)
+
+
+
+
Details
+
A new parity setting takes effect when the command to change it is processed.
+
Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set parity from one of the other command interfaces or from the front panel.
This function reads available characters (data) from the serial port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
data = serial.read(maxchars)
+
+
+
+
data
+
+
A string that consists of all data read from the serial port
+
+
+
+
maxchars
+
+
An integer that specifies the maximum number of characters to read
+
+
+
+
+
Details
+
This function reads available characters from the serial port. It does not wait for new characters to arrive. As long as maxchars is less than 200 characters, all characters that are received by the serial port (before the serial.read() command is executed) are returned. If too many characters are received between calls to this function, the RS-232 buffers will overflow and some characters may be lost.
+
Call this function as many times as necessary to receive the required number of characters. For optimal performance, use a small delay between repeated calls to this function.
+
The data returned is the raw data stream read from the port. No characters, such as control characters or terminator characters, are interpreted.
+
If you attempt to use this function when the serial port is enabled as a command interface, a settings conflict error is generated.
+
Example
+
+
+
+
data = serial.read(200)
+
+
print(data)
+
+
Read data from the serial port.
+
Output:
+
John Doe
+
The above output indicates that the string "John Doe" was read from the serial port.
This function saves the present setup as a user-saved setup.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
setup.save(id)
+
+
+
+
id
+
+
An integer or string specifying where to save the user setup:
+
Save in nonvolatile memory (1 to 5)
Save as user-saved setup on a USB flash drive ("/path/filename")
+
+
+
+
Details
+
When the id parameter is an integer (n), it is interpreted as the setup number to save to the instrument's nonvolatile memory.
+
When you save to a specified integer (1 to 5) in nonvolatile memory, the previous setup at that same location is overwritten.
+
When the id parameter is a string, it is interpreted as the path and file name of the location to save the present setup on a USB flash drive. The path may be absolute or relative to the current working directory.
+
Example
+
+
+
+
setup.save(5)
+
+
Saves the present setup to the internal memory of the instrument at location 5.
This function terminates all overlapped operations on the source-measure unit (SMU).
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.abort()
+
Details
+
The smua.abort() function does not turn the output off or change any settings.
+
If this function is used to abort a sweep, when it is executed, the SMU exits its trigger model immediately and returns to the idle state of the trigger model.
This function disables the commands that change calibration settings.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.cal.lock()
+
+
Details
+
Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored. Error code 5012, "Cal data not saved - save or restore before lock," results if this function is called when the calibration state is smua.CALSTATE_CALIBRATING.
This function loads a stored set of calibration constants.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.cal.restore()
+
smua.cal.restore(calset)
+
+
+
+
calset
+
+
The calibration set to be loaded; set calset to one of the following values:
+
0 or smua.CALSET_NOMINAL: A set of calibration constants that are uncalibrated, but set to nominal values to allow rudimentary functioning of the instrument
1 or smua.CALSET_FACTORY: The calibration constants when the instrument left the factory
2 or smua.CALSET_DEFAULT: The normal calibration set
3 or smua.CALSET_PREVIOUS: The calibration set that was used before the last default set was overwritten
+
+
+
+
Details
+
This function overwrites the present set of calibration constants with constants read from nonvolatile memory.
+
This function is disabled until a successful call to smua.cal.unlock() is made.
+
If calset is not specified, smua.CALSET_DEFAULT is used.
This function stores the active calibration constants to nonvolatile memory.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.cal.save()
+
+
Details
+
This function stores the active set of calibration constants to nonvolatile memory. The previous calibration constants (from the default calibration set) are copied to the previous calibration set (smua.CALSET_PREVIOUS) before overwriting the default calibration set.
+
This function is disabled until a successful call to smua.cal.unlock() is made.
+
If any of the calibration constants have been changed, this function is disabled unless the calibration date, the calibration due date, and the calibration adjust date have been assigned new values.
+
Example
+
+
+
+
smua.cal.save()
+
+
Stores calibration constants in nonvolatile memory.
This attribute stores the date of the last calibration adjustment.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU cal. restore
+
+
SMU nonvolatile memory
+
+
Initially set to factory calibration date
+
+
+
+
+
Usage
+
adjustDate = smua.cal.adjustdate
+
smua.cal.adjustdate = adjustDate
+
+
+
+
adjustDate
+
+
Date of the last adjustment
+
+
+
+
+
Details
+
This attribute stores the adjustment date associated with the active calibration set. The adjustment date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function.
+
You cannot change the adjustment date without first making a change to the calibration constants.
+
Once you change any calibration constants, you must set the adjustment date before you can save the calibration data to the nonvolatile memory of the SMU.
+
This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute reflects the date stored with that set.
+
smua.cal.adjustdate must be set to the date the adjustment was done using the UTC time and date. The date is stored as the number of seconds since UTC, 12:00 am Jan 1, 1970.
+
Due to the internal storage format, smua.cal.adjustdate is only accurate to within a few minutes of the value set.
+
Example
+
+
+
+
smua.cal.adjustdate = os.time()
+
+
Sets the adjustment date to the current time set on the instrument.
This attribute stores the calibration date of the active calibration set.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU calibration restore
+
+
SMU nonvolatile memory
+
+
Initially set to factory calibration date
+
+
+
+
+
Usage
+
calDate = smua.cal.date
+
smua.cal.date = calDate
+
+
+
+
calDate
+
+
The calibration date of the active calibration set
+
+
+
+
+
Details
+
This attribute stores the calibration date that is associated with the active calibration set. The calibration date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function. It is typically set to the date when the instrument was calibrated.
+
This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute will reflect the date stored with that set.
+
smua.cal.date must be set to the date the calibration was done using the UTC time and date. The date is stored as the number of seconds since UTC 12:00 am Jan 1, 1970.
+
Due to the internal storage format, smua.cal.date is accurate to within a few minutes of the value set.
+
Example
+
+
+
+
smua.cal.date = os.time()
+
+
Sets calibration date to the present time set on the instrument.
This attribute stores the calibration due date for the next calibration.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU cal. restore
+
+
SMU nonvolatile memory
+
+
0
+
+
+
+
+
Usage
+
calDue = smua.cal.due
+
smua.cal.due = calDue
+
+
+
+
calDue
+
+
Due date of next calibration (0 indicates that no date is set)
+
+
+
+
+
Details
+
This attribute stores the calibration due date associated with the active calibration set. The calibration due date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function. It is typically set to the date when the next calibration should be performed.
+
This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute reflects the due date stored with that set.
+
smua.cal.due must be set to the date the next calibration is required using the UTC time and date. The date is stored as the number of seconds since UTC 12:00 am Jan 1, 1970.
+
Due to the internal storage format, smua.cal.due is only accurate to within a few minutes of the value set.
+
Example
+
+
+
+
smua.cal.due = os.time() + 365 * 24 * 60 * 60
+
+
Sets the calibration due date equal to one year from the present time set on the instrument.
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Measured
+
+
The value measured by this SMU for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
Contact check measurement calibration does not require range information.
+
Typically, points one and two will be near 0 Ω and 50 Ω, respectively.
+
All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active. If not, corruption of the calibration constants may result.
+
The new calibration constants are activated immediately but are not written to nonvolatile memory. Use smua.cal.save() to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is disabled until a successful call to smua.cal.unlock() is made.
+
Example
+
+
+
+
-- Short SENSE LO and LO terminals.
+
-- Short SENSE HI and HI terminals.
+
-- Allow readings to settle, then get measurements.
+
r0_hi, r0_lo = smua.contact.r()
+
+
-- Connect 50 OHM resistor between SENSE LO and LO.
+
-- Connect 50 OHM resistor between SENSE HI and HI.
+
-- Allow readings to settle, then get measurements.
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Measured
+
+
The value measured by this SMU for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
Contact check measurement adjustment does not require range information.
+
Typically, points one and two are near 0 Ω and 50 Ω, respectively.
+
All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the active calibration set. If not, corruption of the calibration constants may result.
+
The new calibration constants are activated immediately but are not written to nonvolatile memory. Use smua.cal.save() to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is disabled until a successful call to smua.cal.unlock() is made.
+
Example
+
+
+
+
-- Short SENSE LO and LO terminals.
+
-- Short SENSE HI and HI terminals.
+
-- Allow readings to settle, then get measurements.
+
r0_hi, r0_lo = smua.contact.r()
+
+
-- Connect 50 OHM resistor between SENSE LO and LO.
+
-- Connect 50 OHM resistor between SENSE HI and HI.
+
-- Allow readings to settle, then get measurements.
Reading buffers can be created and allocated dynamically using this function. Use bufferSize to designate the number of readings the buffer can store.
+
Dynamically allocated reading buffers can be used interchangeably with the smua.nvbufferY buffers.
+
A reading buffer can be deleted by setting all references to the reading buffer equal to nil, then running the garbage collector (see the collectgarbage() function in Standard libraries).
This attribute stores the measurement autorange setting.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
1 (smua.AUTORANGE_ON)
+
+
+
+
+
Usage
+
autoRange = smua.measure.autorangeY
+
smua.measure.autorangeY = autoRange
+
+
+
+
autoRange
+
+
The state of the measurement autorange setting; set to one of the following values:
+
0 or smua.AUTORANGE_OFF: Disabled
1 or smua.AUTORANGE_ON: Enabled
2 or smua.AUTORANGE_FOLLOW_LIMIT: Measure range automatically set to the limit range
+
+
+
Y
+
+
SMU measure function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute indicates the measurement autorange state. Its value is smua.AUTORANGE_OFF when the SMU measure circuit is on a fixed range and smua.AUTORANGE_ON when it is in autorange mode.
+
Setting this attribute to smua.AUTORANGE_OFF puts the SMU on a fixed range. The fixed range is the present SMU measure range.
+
Setting this attribute to smua.AUTORANGE_ON puts the SMU measure circuit in autorange mode. It remains on its present measure range until the next measurement is requested.
+
If source high capacitance mode is enabled, current autorange is set to smua.AUTORANGE_FOLLOW_LIMIT and cannot be changed.
SMU measurement function (v = voltage, i = current)
+
+
+
+
range
+
+
The measurement range to adjust
+
+
+
+
cp1Measured
+
+
The value measured by this SMU for point 1
+
+
+
+
cp1Reference
+
+
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Measured
+
+
The value measured by this SMU for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
This function generates and activates new calibration constants for the given range.
+
The positive and negative polarities of the instrument must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity.
+
Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.
+
All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active. Corruption of the calibration constants may result if this is ignored.
+
The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is only available when calibration is unlocked using smua.cal.unlock().
This function starts an asynchronous (background) measurement.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.measure.overlappedY(rbuffer)
+
smua.measure.overlappediv(ibuffer, vbuffer)
+
+
+
+
Y
+
+
SMU measurement type (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
rbuffer
+
+
A reading buffer object where the readings are stored
+
+
+
+
ibuffer
+
+
A reading buffer object where current readings are stored
+
+
+
+
vbuffer
+
+
A reading buffer object where voltage readings are stored
+
+
+
+
+
Details
+
This function starts a measurement and returns immediately. The measurements, as they are performed, are stored in a reading buffer (along with any other information that is being acquired). If the instrument is configured to return multiple readings where one is requested, the readings are available as they are made. Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.
+
The second form of this function, smua.measure.overlappediv(), stores current readings in ibuffer and voltage readings in vbuffer.
+
This function is an overlapped command. Script execution continues while the measurements are made in the background. Attempts to access result values that have not yet been generated cause the script to block and wait for the data to become available. The waitcomplete() function can also be used to wait for the measurements to complete before continuing.
+
If a given reading buffer contains any data, it is cleared before making any measurements, unless the reading buffer has been configured to append data.
Returned value of the last (or only) reading of the measurement process
+
+
+
+
Y
+
+
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
readingBuffer
+
+
A reading buffer object where all readings are stored
+
+
+
+
iReading
+
+
The last reading of the current measurement process
+
+
+
+
vReading
+
+
The last reading of the voltage measurement process
+
+
+
+
iReadingBuffer
+
+
A reading buffer object where current readings are stored
+
+
+
+
vReadingBuffer
+
+
A reading buffer object where voltage readings are stored
+
+
+
+
+
Details
+
If you use this function without specifying a reading buffer, it makes one measurement and returns that measurement as reading. To use the additional information that is acquired while making a measurement or to return multiple readings, specify a reading buffer. If the instrument is configured to return multiple readings for a measurement and readingBuffer is specified, all readings are available in readingBuffer, but only the last measurement is returned as reading.
+
Measurements are in the following units of measure:
+
v = volts
i = amperes
r = ohms
p = watts
The smua.measure.iv() function returns the last actual current measurement and voltage measurement as iReading and vReading, respectively. Additionally, it can store current and voltage readings if buffers are provided (iReadingBuffer and vReadingBuffer ).
+
The smua.measure.count attribute determines how many measurements are performed. When using a reading buffer, it also determines the number of readings to store in the buffer. If a reading buffer is not specified, the SMU ignores the smua.measure.count attribute and only makes one measurement.
+
The readingBuffer is cleared before making any measurements unless the buffer is configured to append data.
+
Example
+
+
+
+
smua.measure.count = 10
+
smua.measure.v(smua.nvbuffer1)
+
+
Makes 10 voltage measurements using SMU channel A and stores them in a buffer.
This attribute turns relative measurements on or off.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Not saved
+
+
0 (smua.REL_OFF)
+
+
+
+
+
Usage
+
relEnable = smua.measure.rel.enableY
+
smua.measure.rel.enableY = relEnable
+
+
+
+
relEnable
+
+
Relative measurement control. Set relEnable to one of the following values:
+
0 or smua.REL_OFF: Disables relative measurements
1 or smua.REL_ON: Enables relative measurements
+
+
+
Y
+
+
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
+
Details
+
This attribute enables or disables relative measurements. When relative measurements are enabled, all subsequent measured readings are offset by the relative offset value specified by smua.measure.rel.levelY. Each returned measured relative reading is the result of the following calculation:
+
Relative reading = Actual measured reading - Relative offset value
This attribute sets the offset value for relative measurements.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
relValue = smua.measure.rel.levelY
+
smua.measure.rel.levelY = relValue
+
+
+
+
relValue
+
+
Relative measurement offset value
+
+
+
+
Y
+
+
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
+
Details
+
This attribute specifies the offset value used for relative measurements. When relative measurements are enabled (see smua.measure.rel.enableY), all subsequent measured readings will be offset by the value of this attribute. Each returned measured relative reading is the result of the following calculation:
+
Relative reading = Actual measured reading - Relative offset value
+
Example
+
+
+
+
smua.measure.rel.levelv = smua.measure.v()
+
+
Performs a voltage measurement and then uses it as the relative offset value.
This attribute sets the state of the reading buffer's append mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
0 (disabled)
+
+
+
+
+
Usage
+
state = bufferVar.appendmode
+
bufferVar.appendmode = state
+
+
+
+
state
+
+
The reading buffer append mode; set to one of the following:
+
0: Append mode off; new measurement data overwrites the previous buffer content
1: Append mode on; appends new measurement data to the present buffer content
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
Assigning a value to this attribute enables or disables the buffer append mode. This value can only be changed with an empty buffer. Use bufferVar.clear() to empty the buffer.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
If the append mode is set to 0, any stored readings in the buffer are cleared before new ones are stored. If append mode is set to 1, any stored readings remain in the buffer and new readings are added to the buffer after the stored readings.
+
With append mode on, the first new measurement is stored at rb[n+1], where n is the number of readings stored in buffer rb.
+
Example
+
+
+
+
buffer1.appendmode = 1
+
+
Append new readings to contents of the reading buffer named buffer1.
This attribute contains the timestamp that indicates when the first reading was stored in the buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
0
+
+
+
+
+
Usage
+
basetime = bufferVar.basetimestamp
+
+
+
+
basetime
+
+
The timestamp of the first stored reading
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
+
Details
+
This read-only attribute contains the timestamp (in seconds) of the first reading stored in a buffer (rb[1] stored in reading buffer rb). The timestamp is the number of seconds since 12:00 am January 1, 1970 (UTC) that the measurement was performed and stored.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
See the smua.nvbufferY attribute for details on accessing dedicated reading buffers.
+
Example
+
+
+
+
basetime = smua.nvbuffer1.basetimestamp
+
print(basetime)
+
+
+
+
Read the timestamp for the first reading
+
stored in dedicated reading buffer 1.
+
Output:
+
1.57020e+09
+
This output indicates that the timestamp is 1,570,200,000 seconds (which is Friday, October, 4, 2019 at 14:40:00 pm).
This attribute sets the number of readings a buffer can store.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
bufferCapacity= bufferVar.capacity
+
+
+
+
bufferCapacity
+
+
The maximum number of readings the buffer can store
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
This read-only attribute reads the number of readings that can be stored in the buffer.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
The capacity of the buffer does not change as readings fill the buffer. A dedicated reading buffer that only collects basic items can store over 140,000 readings. Turning on additional collection items, such as timestamps and source values, decreases the capacity of a dedicated reading buffer (for example, smua.nvbuffer1), but does not change the capacity of a user-defined dynamically allocated buffer. A user-defined dynamically allocated buffer has a fixed capacity that is set when the buffer is created.
+
See the smua.nvbufferY attribute for details on accessing dedicated reading buffers. See the smua.makebuffer() function for information on creating user-defined dynamically allocated reading buffers.
+
Example
+
+
+
+
bufferCapacity = smua.nvbuffer1.capacity
+
+
print(bufferCapacity)
+
+
Reads the capacity of dedicated reading buffer 1 (source-measure unit (SMU) channel A).
+
Output:
+
1.49789e+05
+
The above output indicates that the buffer can hold 149789 readings.
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
This function clears all readings and related recall attributes from the buffer (for example, bufferVar.timestamps and bufferVar.statuses) from the specified buffer.
+
Example
+
+
+
+
smua.nvbuffer1.clear()
+
+
Clears dedicated reading buffer 1 (source-measure unit (SMU) channel A).
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
This function clears all readings from the specified cache.
+
If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data. This can happen when you:
+
Initiate successive sweeps without reconfiguring the sweep measurements. Watch for this when running Lua code remotely on more than one node, because values in the reading buffer cache may change while the Lua code is running.
Overwrite data in the reading buffer by setting the bufferVar.fillmode attribute to smua.FILL_WINDOW.
To avoid this, you can include explicit calls to the bufferVar.clearcache() function to remove stale values from the reading buffer cache.
+
Example
+
+
+
+
smua.nvbuffer1.clearcache()
+
+
Clears the reading buffer cache for dedicated reading buffer 1.
This attribute sets whether or not source values are stored with the readings in the buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
0 (disabled)
+
+
+
+
+
Usage
+
state = bufferVar.collectsourcevalues
+
bufferVar.collectsourcevalues =state
+
+
+
+
state
+
+
Source value collection status; set to one of the following:
+
0: Source value collection disabled (off)
1: Source value collection enabled (on)
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
+
Details
+
Assigning a value to this attribute enables or disables the storage of source values. Reading this attribute returns the state of source value collection. This value can only be changed with an empty buffer. Empty the buffer using the bufferVar.clear() function.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
When on, source values are stored with readings in the buffer. This requires four extra bytes of storage for each reading. Turning on additional collection items, such as source values (this attribute) and timestamps, decreases the capacity of a dedicated reading buffer, but does not change the capacity of a user-defined dynamically allocated buffer.
+
You cannot collect source values when smua.trigger.measure.action is set to smua.ASYNC, so this must be set to 0 when the measurement action is set to be asynchronous.
+
Example
+
+
+
+
smua.nvbuffer1.collectsourcevalues = 1
+
+
Include source values with readings for dedicated reading buffer 1.
This attribute sets whether or not timestamp values are stored with the readings in the buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
0 (disabled)
+
+
+
+
+
Usage
+
state = bufferVar.collecttimestamps
+
bufferVar.collecttimestamps = state
+
+
+
+
state
+
+
Timestamp value collection status; set to one of the following:
+
0: Timestamp value collection disabled (off)
1: Timestamp value collection enabled (on)
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
Assigning a value to this attribute enables or disables the storage of timestamps. Reading this attribute returns the state of timestamp collection.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
When on, timestamp values are stored with readings in the buffer. This requires four extra bytes of storage for each reading. Turning on additional collection items, such as timestamps (this attribute) and source values, decreases the capacity of a dedicated reading buffer (for example, smua.nvbuffer1), but does not change the capacity of a user-defined dynamically allocated buffer.
+
This value, off (0) or on (1), can only be changed when the buffer is empty. Empty the buffer using the bufferVar.clear() function.
+
Example
+
+
+
+
smua.nvbuffer1.collecttimestamps = 1
+
+
Include timestamps with readings for dedicated reading buffer 1.
This attribute contains the resolution of the timestamp.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
1e-6 (1 µs)
+
+
+
+
+
Usage
+
resolution = bufferVar.timestampresolution
+
+
+
+
resolution
+
+
Timestamp resolution in seconds
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
Assigning a value to this attribute sets the resolution for the timestamps. Reading this attribute returns the timestamp resolution value. This value can only be changed with an empty buffer. Empty the buffer using the bufferVar.clear() function.
+
The finest timestamp resolution is 0.000001 seconds (1 μs). At this resolution, the reading buffer can store unique timestamps for up to 71 minutes. This value can be increased for very long tests.
+
The value specified when setting this attribute will be rounded to an even power of 2 µs.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example
+
+
+
+
smua.nvbuffer1.timestampresolution = 0.000008
+
+
+
Sets the timestamp resolution of dedicated reading buffer 1 to 8 μs.
This attribute contains the state of the source autorange control (on/off).
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
1 (smua.AUTORANGE_ON)
+
+
+
+
+
Usage
+
sourceAutorange = smua.source.autorangeY
+
smua.source.autorangeY = sourceAutorange
+
+
+
+
sourceAutorange
+
+
The state of the source autorange control. Set to one of the following:
+
0 or smua.AUTORANGE_OFF: Disables source autorange
1 or smua.AUTORANGE_ON: Enables source autorange
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute indicates the source autorange state. Its value is smua.AUTORANGE_OFF when the SMU source circuit is on a fixed range and smua.AUTORANGE_ON when it is in autorange mode.
+
Setting this attribute to smua.AUTORANGE_OFF puts the SMU on a fixed source range. The fixed range used is the present SMU source circuit range.
+
Setting this attribute to smua.AUTORANGE_ON puts the SMU source circuit into autorange mode. If the source output is on, the SMU immediately changes range to the range most appropriate for the value being sourced if that range is different than the present SMU range.
+
Autorange is disabled if the source level is edited from the front panel. Setting the source range also turns off autorange when set by using the smua.source.rangeY attribute.
+
Resetting the instrument selects the smua.AUTORANGE_ON.
This attribute contains the state of source compliance.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
+
Usage
+
compliance = smua.source.compliance
+
+
+
+
compliance
+
+
The state of source compliance:
+
true: Indicates that the limit function is in control of the source (source in compliance)
false: Indicates that the source function is in control of the output (source not in compliance)
+
+
+
+
Details
+
Reading this attribute updates the status model and the front panel with generated compliance information. See Current Limit (ILMT) in the status model diagram for the Measurement event registers. The Voltage Limit (VLMT) is not shown in the status model diagram for the Measurement event registers, but is similar to the Current Limit (ILMT).
+
Example
+
+
+
+
compliance = smua.source.compliance
+
+
print(compliance)
+
+
+
+
Reads the source compliance state.
+
Output:
+
true
+
This output indicates that a configured limit has been reached (voltage, current, or power limit).
Set to the source delay value (for example, to specify an additional 10 ms source delay, set the value to 0.010); you can also set it one of the following values:
+
0 or smua.DELAY_OFF: No delay
-1 or smua.DELAY_AUTO: Automatic delay value
+
+
+
+
Details
+
This attribute allows for additional delay (settling time) after an output step.
+
The smua.DELAY_AUTO setting causes a range-dependent delay to be inserted when the source is changed. Range-dependent delays are based on the output settling time values as defined in the 2601B-PULSE specifications.
+
Example
+
+
+
+
smua.source.delay = smua.DELAY_AUTO
+
+
+
+
Sets the delay to automatic (a range-dependent delay is inserted whenever the source is changed).
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Expected
+
+
The source value set for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
This function generates and activates new calibration constants for the given range.
+
The positive and negative polarities of the source must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity. Do not use 0.0 for a negative point; 0.0 is considered to be a positive number.
+
Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.
+
The two reference measurements must be made with the source using the active calibration set. For example, source a value, measure it, and do not change the active calibration set before issuing this command.
+
The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is only available when calibration is unlocked using smua.cal.unlock().
Generates and activates new source calibration constants for the 1 A range. For point 1, it uses 1e-10 as the source value and 1e-5 as the reference measurement. For point 2, it uses 0.9 for the source value and 0.903 for the reference measurement.
This attribute contains the source function, which can be voltage or current.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
1 (smua.OUTPUT_DCVOLTS)
+
+
+
+
+
Usage
+
sFunction = smua.source.func
+
smua.source.func = sFunction
+
+
+
+
sFunction
+
+
The source function; set to one of the following values:
+
0 or smua.OUTPUT_DCAMPS: Selects the current source function
1 or smua.OUTPUT_DCVOLTS: Selects the voltage source function
+
+
+
+
Details
+
Reading this attribute indicates the output function of the source. Setting this attribute configures the SMU as either a voltage source or a current source.
This attribute sets the limit (current or voltage) used when the source-measure unit (SMU) is in normal output-off mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
Current: 1e-3 (1 mA) Voltage: 40 (40 V)
+
+
+
+
+
Usage
+
sourceLimit = smua.source.offlimitY
+
smua.source.offlimitY = sourceLimit
+
+
+
+
sourceLimit
+
+
Set to the limit to be used when the SMU is in normal output-off mode
+
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
+
Details
+
Setting the current limit to lower than 1 mA may interfere with operation of the contact check function. See smua.contact.check() and smua.contact.r() for details.
+
Example
+
+
+
+
smua.source.offlimiti = 10e-3
+
+
Changes the normal output-off mode limit to 10 mA.
This attribute enables or disables the source output.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0 (smua.OUTPUT_OFF)
+
+
+
+
+
Usage
+
sourceOutput = smua.source.output
+
smua.source.output = sourceOutput
+
+
+
+
sourceOutput
+
+
The output state setting of the source; set to one of the following values:
+
0 or smua.OUTPUT_OFF: Turns off the source output
1 or smua.OUTPUT_ON: Turns on the source output
2 or smua.OUTPUT_HIGH_Z: Turns off the output in high Z mode (allows you to go to high Z mode without first setting the smua.source.offmode attribute to smua.OUTPUT_HIGH_Z)
+
+
+
+
Details
+
Reading this attribute returns the output state of the source. Setting this attribute switches the output of the source on or off.
+
When the output is switched on, the SMU sources either voltage or current, as set by smua.source.func.
+
Setting this attribute to smua.OUTPUT_HIGH_Z causes the output to turn off and go to the High Z mode. If the smua.source.output is read after setting this attribute to smua.OUTPUT_HIGH_Z, it returns 0.
Sets the sink mode on or off; set to one of the following values:
+
0 or smua.DISABLE: Turns off sink mode
1 or smua.ENABLE: Turns on sink mode
+
+
+
+
Details
+
This attribute enables or disables sink mode. When sink mode is enabled, it reduces the source limit inaccuracy that occurs when operating in quadrants II and IV (quadrants I and III will show this source limit inaccuracy).
This attribute sets the arm count in the trigger model.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
1
+
+
+
+
+
Usage
+
triggerArmCount = smua.trigger.arm.count
+
smua.trigger.arm.count = triggerArmCount
+
+
+
+
triggerArmCount
+
+
The arm count in the trigger model
+
+
+
+
+
Details
+
During a sweep, the SMU iterates through the arm layer of the trigger model this many times. After performing this many iterations, the SMU returns to an idle state.
+
If this count is set to zero, the SMU stays in the trigger model indefinitely until aborted.
+
Example
+
+
+
+
smua.trigger.arm.count = 5
+
+
+
+
Sets the SMU to iterate through the arm layer of the trigger model five times and then return to the idle state.
This function sets the arm event detector to the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.arm.set()
+
Details
+
The SMU automatically clears all the event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated.
+
A common example of when this function can be used is when you want the SMU to immediately perform an action the first time through the trigger model even if a programmed trigger event does not occur.
+
This function can also be used to start actions on the SMU in case of a missed trigger event.
+
Example
+
+
+
+
smua.trigger.arm.set()
+
+
+
+
Sets the arm event detector to the detected state.
This attribute selects the event that will cause the arm event detector to enter the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = smua.trigger.arm.stimulus
+
smua.trigger.arm.stimulus = eventID
+
+
+
+
eventID
+
+
Event that triggers the arm detector
+
+
+
+
+
Details
+
Set this attribute to the event ID of any trigger event generator to wait for that event.
+
Set this attribute to zero to bypass waiting for events at the arm event detector (the SMU continues uninterrupted through the remote trigger model). Set eventID to one of the existing trigger event IDs shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
This attribute turns automatic clearing of the event detectors on or off.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0 (smua.DISABLE)
+
+
+
+
+
Usage
+
autoClear = smua.trigger.autoclear
+
smua.trigger.autoclear = autoClear
+
+
+
+
autoClear
+
+
Auto clear setting; set to one of the following values:
+
0 or smua.DISABLE: Turns off automatic clearing of the event detectors
1 or smua.ENABLE: Turns on automatic clearing of the event detectors
+
+
+
+
Details
+
This attribute enables or disables automatic clearing of the trigger model state machine event detectors when the SMU transitions from the arm layer to the trigger layer.
+
Only the detected states of the event detectors are cleared.
+
The overrun statuses of the event detectors are not automatically cleared when the SMU transitions from the arm layer to the trigger layer.
+
The event detectors are always cleared when a sweep is initiated.
+
Example
+
+
+
+
smua.trigger.autoclear = smua.ENABLE
+
+
+
+
Automatically clear the event detectors for the trigger mode state.
This attribute sets the trigger count in the trigger model.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
1
+
+
+
+
+
Usage
+
triggerCount = smua.trigger.count
+
smua.trigger.count = triggerCount
+
+
+
+
triggerCount
+
+
The trigger count is the number of times the source-measure unit (SMU) will iterate in the trigger layer for any given sweep
+
+
+
+
+
Details
+
During a sweep, the SMU iterates through the trigger layer of the trigger model this many times. After performing this many iterations, the SMU returns to the arm layer.
+
If this count is set to zero (0), the SMU stays in the trigger model indefinitely until aborted.
This function sets the end pulse event detector to the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.endpulse.set()
+
Details
+
This function sets the end pulse event detector to the detected state.
+
The SMU automatically clears all the event detectors when the smua.trigger.initiate() function is executed. Therefore, smua.trigger.endpulse.set() should be called after the sweep is initiated. If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.endpulse.set() is issued after the SMU has entered the trigger layer.
This attribute defines which event will cause the end pulse event detector to enter the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = smua.trigger.endpulse.stimulus
+
smua.trigger.endpulse.stimulus = eventID
+
+
+
+
eventID
+
+
Set to the event that triggers the end pulse action of the source
+
+
+
+
+
Details
+
Set this attribute to the event ID of any trigger event generator to wait for that event. To bypass waiting for an event, set this value of this attribute to 0. Set eventID to one of the existing trigger event IDs, which are shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
Configure the end pulse action to achieve a pulse and select the event, trigger.timer[1].EVENT_ID, that causes the arm event detector to enter the detected state.
This attribute sets the action of the source at the end of a sweep.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0 (smua.SOURCE_IDLE)
+
+
+
+
+
Usage
+
action = smua.trigger.endsweep.action
+
smua.trigger.endsweep.action = action
+
+
+
+
action
+
+
The source action at the end of a sweep; set to one of the following values:
+
0 or smua.SOURCE_IDLE: Sets the source level to the programmed (idle) level at the end of the sweep
1 or smua.SOURCE_HOLD: Sets the source level to stay at the level of the last step
+
+
+
+
Details
+
Use this attribute to configure the source action at the end of the sweep. The SMU can be programmed to return to the idle source level or hold the last value of the sweep.
+
Example
+
+
+
+
smua.trigger.endsweep.action = smua.SOURCE_IDLE
+
+
+
+
Sets SMU return the source back to the idle source level at the end of a sweep.
This function causes the SMU to clear the four trigger model event detectors and enter its trigger model (moves the SMU from the idle state into the arm layer).
+
To perform source actions during the sweep, before calling this function, it is necessary to configure and enable one of the following sweep source actions:
+
smua.trigger.source.linearY()
smua.trigger.source.listY()
smua.trigger.source.logY()
To make measurements during the sweep, you must also configure and enable the measure action using smua.trigger.measure.Y().
+
If you run this function more than once without reconfiguring the sweep measurements, the caches on the configured measurement reading buffers will hold stale data; use the bufferVar.clearcache() function to remove stale values from the reading buffer cache.
+
This function initiates an overlapped operation.
+
Example
+
+
+
+
smua.trigger.initiate()
+
+
+
+
Starts a preconfigured sweep and clears the event detectors.
This attribute controls measurement actions during a sweep.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0 (smua.DISABLE)
+
+
+
+
+
Usage
+
action = smua.trigger.measure.action
+
smua.trigger.measure.action = action
+
+
+
+
action
+
+
The sweep measurement action; set to one of the following values:
+
0 or smua.DISABLE: Do not make measurements during the sweep
1 or smua.ENABLE: Make measurements during the sweep
2 or smua.ASYNC: Make measurements during the sweep, but asynchronously with the source area of the trigger model
+
+
+
+
Details
+
With this attribute enabled (setting action to smua.ENABLE or smua.ASYNC), configure the measurement with one of the smua.trigger.measure.Y() functions.
+
If this attribute is set to smua.ASYNC:
+
Asynchronous sweep measurements can only be used with measure autoranging turned off. To turn measure autoranging off for all measurements during the sweep, set the smua.measure.autorangeY attribute to smua.AUTORANGE_OFF.
Autozero must also be turned off. To turn off autozero, set the smua.measure.autozero attribute to smua.AUTOZERO_OFF or smua.AUTOZERO_ONCE.
The reading buffer used by smua.trigger.measure.Y() must have bufferVar.collectsourcevalues set to 0.
If any of the above items is incorrectly configured, the smua.trigger.initiate() function generates an error.
This function sets the measurement event detector to the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.measure.set()
+
Details
+
This function is useful whenever you want the SMU to continue operation without waiting for a programmed trigger event. When called, this function immediately satisfies the event detector, allowing the SMU to continue through the trigger model.
+
For example, you might use this function to have the SMU immediately perform an action the first time through the trigger model, even if a programmed trigger event does not occur.
+
If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.measure.set() is issued after the SMU has entered the trigger layer. This function can also be used to start actions on the SMU in case of a missed trigger event.
+
The SMU automatically clears all event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated.
This attribute selects the event that causes the measure event detector to enter the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = smua.trigger.measure.stimulus
+
smua.trigger.measure.stimulus = eventID
+
+
+
+
eventID
+
+
Event that triggers the measurement detector
+
+
+
+
+
Details
+
Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the measurement event detector portion of the trigger model.
+
Set this attribute to zero to bypass waiting for an event (the SMU continues uninterrupted through the remote trigger model). Set eventID to one of the existing trigger event IDs shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
This function configures the measurements that are to be made in a subsequent sweep.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.measure.Y(rbuffer)
+
smua.trigger.measure.iv(ibuffer, vbuffer)
+
+
+
Y
+
+
SMU measurement type (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
rbuffer
+
+
A reading buffer object where the readings will be stored
+
+
+
+
ibuffer
+
+
A reading buffer object where current readings will be stored
+
+
+
+
vbuffer
+
+
A reading buffer object where voltage readings will be stored
+
+
+
+
+
Details
+
As measurements are made, they are stored in a reading buffer. If the instrument is configured to return multiple readings where one is requested, the readings are available as they are made. Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.
+
The smua.trigger.measure.iv() function stores current readings in ibuffer and voltage readings in vbuffer.
+
If a given reading buffer contains any data, it is cleared before making any measurements, unless the reading buffer has been configured to append data.
+
The SMU only retains the last call to any one of these functions and only that measurement action is performed.
+
After configuring the measurements to make with this function, enable the measurement action.
+
Example
+
+
+
+
smua.trigger.measure.v(vbuffername)
+
smua.trigger.measure.action = smua.ENABLE
+
+
Stores voltage readings during the sweep in buffer vbuffername.
This constant contains the source complete event number.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Constant
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
eventID = smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
+
+
eventID
+
+
The source action complete event number
+
+
+
+
+
Details
+
Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to source complete events from this source-measure unit (SMU).
This attribute enables or disables sweeping the source (on or off).
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0 (smua.DISABLE)
+
+
+
+
+
Usage
+
action = smua.trigger.source.action
+
smua.trigger.source.action = action
+
+
+
+
action
+
+
Sweep source action. Set to one of the following values:
+
0 or smua.DISABLE: Do not sweep the source
1 or smua.ENABLE: Sweep the source
+
+
+
+
Details
+
This attribute is used to enable or disable source level changes during a sweep. In addition to enabling the action before initiating the sweep, make sure to configure it using smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY().
+
Example
+
+
+
+
smua.trigger.source.listv({3, 1, 4, 5, 2})
+
smua.trigger.source.action = smua.ENABLE
+
+
+
+
Configure list sweep (sweep through 3 V, 1 V, 4 V, 5 V, and 2 V).
The source limit that is used during triggered operation; set to:
+
A user-defined value
smua.LIMIT_AUTO
+
+
+
Y
+
+
SMU output function (v = voltage, i = current)
+
+
+
+
+
Details
+
Use this attribute to perform extended operating area (EOA) pulse mode sweeps.
+
If this attribute is set to smua.LIMIT_AUTO (or 0), the SMU uses the normal limit setting during sweeping. If this attribute is set to any other numeric value, the SMU switches in this limit at the start of the source action and returns to the normal limit setting at the end of the end pulse action.
+
Normally, the limit range is automatically adjusted in accordance with the limit value. During sweeping, however, the limit range is fixed to avoid the delays associated with changing range. This fixed limit range is determined by the maximum limit value needed during the sweep; that is, the greater of either the normal limit value (as specified by smua.source.limitY) or the sweep limit value (as specified by smua.trigger.source.limitY). Note that the minimum limit value that can be enforced during the sweep is equal to 10% of the full scale value of the fixed limit range. If the smaller limit value (normal or sweep) falls below this 10% threshold, the 10% value is enforced instead. Likewise, if the limit value falls below the 10% threshold as a result of power compliance, the 10% value is enforced instead.
+
When using the EOA, the SMU will automatically start the end pulse action if the SMU is not triggered before its maximum pulse width. It will also delay the source action if necessary to limit the pulse duty cycle to stay within the capabilities of the SMU.
The number of points used to calculate the step size
+
+
+
+
+
Details
+
This function configures the source action to be a linear source sweep in a subsequent sweep. During the sweep, the source will generate a uniform series of ascending or descending voltage or current changes called steps. The number of source steps is one less than the number of sourced points.
+
The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source will restart at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU will satisfy the trigger count by restarting the sweep values from the beginning.
+
If the subsequent sweep has fewer points than specified in points, endValue will not be reached during the sweep. This means that if the trigger count is less than the number of source values configured, the SMU will satisfy the trigger count and ignore the remaining source values.
+
In cases where the first sweep point is a nonzero value, it may be necessary to pre-charge the circuit so that the sweep will return a stable value for the first measured point without penalizing remaining points in the sweep.
+
With linear sweeps, it is acceptable to maintain a fixed source resolution over the entire sweep. To prevent source range changes during the sweep (especially when sweeping through 0.0), set the source range to a fixed range appropriate for the larger of either startValue or endValue.
+
The SMU will only store the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.
+
Source functions cannot be changed within a sweep.
+
After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.
This function configures an array-based source sweep.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.source.listY(sweepList)
+
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
sweepList
+
+
An array of source values
+
+
+
+
+
Details
+
This function configures the source action to be a list sweep in a subsequent sweep. During the sweep, the source will output the sequence of source values given in the sweepList array.
+
If the subsequent sweep has more points than specified in sweepList, the source will restart at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU will satisfy the trigger count by restarting the sweep values from the beginning.
+
If the subsequent sweep has fewer points than specified in sweepList, the extra values will be ignored. This means that if the trigger count is less than the number of source values configured, the SMU will satisfy the trigger count and ignore the remaining source values.
+
In cases where the first sweep point is a nonzero value, it may be necessary to pre-charge the circuit so that the sweep will return a stable value for the first measured point without penalizing remaining points in the sweep.
+
The SMU will only store the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.
+
Source functions cannot be changed within a sweep.
+
After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.
The number of points used to calculate the step size
+
+
+
+
asymptote
+
+
The asymptotic offset value
+
+
+
+
+
Details
+
This function configures the source action to be a geometric source sweep in a subsequent sweep. During the sweep, the source generates a geometric series of ascending or descending voltage or current changes called steps. Each step is larger or smaller than the previous step by a fixed proportion. The constant of proportionality is determined by the starting value, the ending value, the asymptote, and the number of steps in the sweep. The number of source steps is one less than the number of sourced points.
+
The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source restarts at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU satisfies the trigger count by restarting the sweep values from the beginning.
+
If the subsequent sweep has fewer points than specified in points, endValue is not reached during the sweep. This means that if the trigger count is less than the number of source values configured, the SMU satisfies the trigger count and ignores the remaining source values.
+
In cases where the first sweep point is nonzero, it may be necessary to pre-charge the circuit so that the sweep returns a stable value for the first measured point without penalizing remaining points in the sweep.
+
With logarithmic sweeps, it is usually necessary to allow the source to autorange to maintain good source accuracy when sweeping over more than one decade or across range boundaries.
+
The asymptote parameter can be used to customize the inflection and offset of the source value curve. This allows log sweeps to cross zero. Setting this parameter to zero provides a conventional logarithmic sweep. The asymptote value is the value that the curve has at either positive or negative infinity, depending on the direction of the sweep.
+
The asymptote value must not be equal to or between the starting and ending values. It must be outside the range defined by the starting and ending values.
+
The SMU stores only the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.
+
Source functions cannot be changed within a sweep.
+
After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.
+
Example
+
+
+
+
smua.trigger.source.logv(1, 10, 11, 0)
+
+
Sweeps from 1 V to 10 V in 10 steps with an asymptote of 0 V.
This function sets the source event detector to the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.trigger.source.set()
+
Details
+
This function sets the source event detector to the detected state.
+
The SMU automatically clears all event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated. If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.source.set() is issued after the SMU has entered the trigger layer.
This attribute defines which event causes the source event detector to enter the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = smua.trigger.source.stimulus
+
smua.trigger.source.stimulus = eventID
+
+
+
+
eventID
+
+
Set to the event that triggers the end-pulse source off action
+
+
+
+
+
Details
+
Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the source event detector portion of the trigger model. To bypass waiting for an event, set the value of this attribute to zero (0). Set eventID to one of the existing trigger event IDs shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
Integer value used as an identifier for other tspnet commands
+
+
+
+
name
+
+
The name that is assigned to the script
+
+
+
+
script
+
+
The body of the script as a string
+
+
+
+
+
Details
+
This function is appropriate only for TSP-enabled instruments.
+
This function downloads a script to a remote instrument and runs it. It automatically adds the appropriate loadscript and endscript commands around the script, captures any errors, and reads back any prompts. No additional substitutions are done on the text.
+
The script is automatically loaded, compiled, and run.
+
Any output from previous commands is discarded.
+
This command does not wait for the script to complete.
+
If you do not want the script to do anything immediately, make sure the script only defines functions for later use. Use the tspnet.execute() function to execute those functions later.
+
If no name is specified, the script is loaded as the anonymous script.
+
Example
+
+
+
+
tspnet.tsp.runscript(myconnection, "mytest",
+
"print([[start]]) for d = 1, 10 do print([[work]]) end print([[end]])")
+
+
+
+
Load and run a script entitled mytest on the TSP-enabled instrument connected with myconnection.
This attribute contains the group number of a TSP-Link node.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Power cycle
+
+
Not applicable
+
+
0
+
+
+
+
+
Usage
+
groupNumber = tsplink.group
+
tsplink.group = groupNumber
+
+
+
+
groupNumber
+
+
The group number of the TSP-Link node (0 to 64)
+
+
+
+
+
Details
+
To remove the node from all groups, set the attribute value to 0.
+
When the node is turned off, the group number for that node changes to 0.
+
The master node can be assigned to any group. You can also include other nodes in the group that includes the master. Note that any nodes that are set to 0 are automatically included in the group that contains the master node, regardless of the group that is assigned to the master node.
This attribute reads the node number assigned to the master node.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
masterNodeNumber = tsplink.master
+
+
+
+
masterNodeNumber
+
+
The node number of the master node
+
+
+
+
+
Details
+
After doing a TSP-Link reset (tsplink.reset()), use this attribute to access the node number of the master in a set of instruments connected over TSP-Link.
+
Example
+
+
+
+
LinkMaster = tsplink.master
+
+
Store the TSP-Link master node number in a variable called LinkMaster.
This function reads the TSP-Link trigger lines as a digital I/O port.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
data = tsplink.readport()
+
+
+
+
data
+
+
Numeric value that indicates which lines are set
+
+
+
+
+
Details
+
The binary equivalent of the returned value indicates the input pattern on the I/O port. The least significant bit of the binary number corresponds to line 1 and the value of bit 3 corresponds to line 3. For example, a returned value of 2 has a binary equivalent of 010. This indicates that line 2 is high (1), and that the other two lines are low (0).
+
Example
+
+
+
+
data = tsplink.readport()
+
print(data)
+
+
Reads state of all three TSP-Link lines.
+
Assuming line 2 is set high, the output is:
+
2.000000e+00
+
(binary 010)
+
The format of the output may vary depending on the ASCII precision setting.
This function initializes (resets) all nodes (instruments) in the TSP-Link system.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
nodesFound = tsplink.reset()
+
nodesFound = tsplink.reset(expectedNodes)
+
+
+
+
nodesFound
+
+
The number of nodes actually found on the system
+
+
+
+
expectedNodes
+
+
The number of nodes expected on the system (1 to 64)
+
+
+
+
+
Details
+
This function erases all information regarding other nodes connected on the TSP-Link system and regenerates the system configuration. This function must be called at least once before any remote nodes can be accessed. If the node number for any instrument is changed, the TSP-Link must be reset again.
+
If expectedNodes is not given, this function generates an error if no other nodes are found on the TSP-Link network.
+
If nodesFound is less than expectedNodes, an error is generated. Note that the node on which the command is running is counted as a node. For example, giving an expected node count of 1 will not generate any errors, even if there are no other nodes on the TSP-Link network.
+
Also returns the number of nodes found.
+
Example
+
+
+
+
nodesFound = tsplink.reset(2)
+
print("Nodes found = " .. nodesFound)
+
+
Perform a TSP-Link reset and indicate how many nodes are found.
+
Sample output if two nodes are found: Nodes found = 2
+
Sample output if fewer nodes are found and if localnode.showerrors = 1: 1219, TSP-Link found fewer nodes than expected Nodes found = 1
This function clears the event detector for a LAN trigger.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
tsplink.trigger[N].clear()
+
+
+
+
N
+
+
The trigger line (1 to 3) to clear
+
+
+
+
+
Details
+
The trigger event detector enters the detected state when an event is detected. tsplink.trigger[N].clear() clears a trigger event detector, discards the history of the trigger line, and clears the tsplink.trigger[N].overrun attribute.
This attribute defines the trigger operation and detection mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup TSP-Link trigger N reset
+
+
Not saved
+
+
0 (tsplink.TRIG_BYPASS)
+
+
+
+
+
Usage
+
mode = tsplink.trigger[N].mode
+
tsplink.trigger[N].mode = mode
+
+
+
+
mode
+
+
The trigger mode
+
+
+
+
N
+
+
The trigger line (1 to 3)
+
+
+
+
+
Details
+
This attribute controls the mode in which the trigger event detector and the output trigger generator operate on the given trigger line.
+
The setting for mode can be one of the following values:
+
+
+
+
Mode
+
+
Number value
+
+
Description
+
+
+
+
tsplink.TRIG_BYPASS
+
+
0
+
+
Allows direct control of the line as a digital I/O line.
+
+
+
+
tsplink.TRIG_FALLING
+
+
1
+
+
Detects falling-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
tsplink.TRIG_RISING
+
+
2
+
+
If the programmed state of the line is high, the tsplink.TRIG_RISING mode behaves similarly to tsplink.TRIG_RISINGA.
+
If the programmed state of the line is low, the tsplink.TRIG_RISING mode behaves similarly to tsplink.TRIG_RISINGM.
+
Use tsplink.TRIG_RISINGA if the line is in the high output state.
+
Use tsplink.TRIG_RISINGM if the line is in the low output state.
+
+
+
+
tsplink.TRIG_EITHER
+
+
3
+
+
Detects rising- or falling-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
tsplink.TRIG_SYNCHRONOUSA
+
+
4
+
+
Detects the falling-edge input triggers and automatically latches and drives the trigger line low.
+
+
+
+
tsplink.TRIG_SYNCHRONOUS
+
+
5
+
+
Detects the falling-edge input triggers and automatically latches and drives the trigger line low. Asserts a TTL-low pulse as an output trigger.
+
+
+
+
tsplink.TRIG_SYNCHRONOUSM
+
+
6
+
+
Detects rising-edge triggers as an input. Asserts a TTL-low pulse for output.
+
+
+
+
tsplink.TRIG_RISINGA
+
+
7
+
+
Detects rising-edge triggers as input. Asserts a TTL-low pulse for output.
+
+
+
+
tsplink.TRIG_RISINGM
+
+
8
+
+
Edge detection as an input is not available. Generates a TTL-high pulse as an output trigger.
+
+
+
+
+
When programmed to any mode except tsplink.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored.
+
When the trigger mode is set to tsplink.TRIG_RISING, the user-specified output state of the line is examined. If the output state selected when the mode is changed is high, the actual mode used will be tsplink.TRIG_RISINGA. If the output state selected when the mode is changed is low, the actual mode used will be tsplink.TRIG_RISINGM.
+
mode stores the trigger mode as a numeric value when the attribute is read.
+
To control the line state, use the tsplink.TRIG_BYPASS mode with the tsplink.writebit() and the tsplink.writeport() commands.
+
Example
+
+
+
+
tsplink.trigger[3].mode = tsplink.TRIG_RISINGM
+
+
Sets the trigger mode for synchronization line 3 to tsplink.TRIG_RISINGM.
This attribute indicates if the event detector ignored an event while in the detected state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Instrument reset Recall setup TSP-Link trigger N clear TSP-Link trigger N reset
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
overrun = tsplink.trigger[N].overrun
+
+
+
+
overrun
+
+
Trigger overrun state
+
+
+
+
N
+
+
The trigger line (1 to 3)
+
+
+
+
+
Details
+
This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred.
+
This is an indication of the state of the event detector built into the synchronization line itself.
+
It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event. It also is not an indication of an output trigger overrun. Output trigger overrun indications are provided in the status model.
+
Example
+
+
+
+
print(tsplink.trigger[1].overrun)
+
+
If an event was ignored, displays true; if an event was not ignored, displays false.
This function releases a latched trigger on the given TSP-Link trigger line.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
tsplink.trigger[N].release()
+
+
+
+
N
+
+
The trigger line (1 to 3)
+
+
+
+
+
Details
+
Releases a trigger that was asserted with an indefinite pulse width. It also releases a trigger that was latched in response to receiving a synchronous mode trigger.
Trigger detection indication; set to one of the following values:
+
true: A trigger is detected during the timeout period
+
false: A trigger is not detected during the timeout period
+
+
+
+
N
+
+
The trigger line (1 to 3)
+
+
+
+
timeout
+
+
The timeout value in seconds
+
+
+
+
+
Details
+
This function waits up to the timeout value for an input trigger. If one or more trigger events were detected since the last time tsplink.trigger[N].wait() or tsplink.trigger[N].clear() was called, this function returns immediately.
+
After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.
+
Example
+
+
+
+
triggered = tsplink.trigger[3].wait(10)
+
print(triggered)
+
+
Waits up to 10 seconds for a trigger on TSP-Link® line 3.
+
If false is returned, no trigger was detected during the 10-second timeout.
This function writes to all TSP-Link synchronization lines.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
tsplink.writeport(data)
+
+
+
+
data
+
+
Value to write to the port (0 to 7)
+
+
+
+
+
Details
+
The binary representation of data indicates the output pattern that is written to the I/O port. For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1), and the other two lines are set low (0).
+
Write-protected lines are not changed.
+
Use the tsplink.writebit() and tsplink.writeport() commands to control the output state of the synchronization line when trigger operation is set to tsplink.TRIG_BYPASS.
+
The reset() function does not affect the present states of the trigger lines.
+
Example
+
+
+
+
tsplink.writeport(3)
+
+
Sets the synchronization lines 1 and 2 high (binary 011).
Carefully consider and configure the appropriate output-off state, source, and compliance limits before connecting the 2601B-PULSE to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2601B-PULSE instruments). Configure recommended instrument settings before making connections to the device. Failure to consider the output-off state, source, and compliance limits may result in damage to the instrument or to the device under test (DUT).
This attribute indicates whether or not an event was ignored because of the event detector state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Instrument reset Trigger blender N clear Trigger blender N reset
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
overrun = trigger.blender[N].overrun
+
+
+
+
overrun
+
+
Trigger blender overrun state (true or false)
+
+
+
+
N
+
+
The blender number (up to six)
+
+
+
+
+
Details
+
Indicates if an event was ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector that is built into the event blender itself.
+
This command does not indicate if an overrun occurred in any other part of the trigger model or in any other trigger object that is monitoring the event. It also is not an indication of an action overrun.
This function waits for a blender trigger event to occur.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
triggered = trigger.blender[N].wait(timeout)
+
+
+
+
triggered
+
+
Trigger detection indication for blender
+
+
+
+
N
+
+
The trigger blender (up to six) on which to wait
+
+
+
+
timeout
+
+
Maximum amount of time in seconds to wait for the trigger blender event
+
+
+
+
+
Details
+
This function waits for an event blender trigger event. If one or more trigger events were detected since the last time trigger.blender[N].wait() or trigger.blender[N].clear() was called, this function returns immediately.
+
After detecting a trigger with this function, the event detector automatically resets and rearms. This is true regardless of the number of events detected.
This function clears the command interface trigger event detector.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
trigger.clear()
+
Details
+
The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call. trigger.clear() clears the trigger event detector and discards the history of command interface trigger events.
Instrument reset Recall setup Trigger timer N reset
+
+
Not saved
+
+
10e-6 (10 µs)
+
+
+
+
+
Usage
+
intervals = trigger.timer[N].delaylist
+
trigger.timer[N].delaylist = intervals
+
+
+
+
intervals
+
+
Table of delay intervals in seconds
+
+
+
+
N
+
+
Trigger timer number (1 to 8)
+
+
+
+
+
Details
+
Each time the timer is triggered after it is enabled, it uses the next delay period from the array. The default value is an array with one value of 10 µs.
+
After all elements in the array have been used, the delays restart at the beginning of the list.
+
If the array contains more than one element, the average of the delay intervals in the list must be >= 50 µs.
This attribute indicates if an event was ignored because of the event detector state.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Instrument reset Recall setup Trigger timer N clear Trigger timer N reset
+
+
Not applicable
+
+
false
+
+
+
+
+
Usage
+
overrun = trigger.timer[N].overrun
+
+
+
+
overrun
+
+
Trigger overrun state (true or false)
+
+
+
+
N
+
+
Trigger timer number (1 to 8)
+
+
+
+
+
Details
+
This command indicates if an event was ignored because the event detector was already in the detected state when the event occurred.
+
This is an indication of the state of the event detector built into the timer itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other construct that is monitoring the delay completion event. It also is not an indication of a delay overrun.
+
Delay overrun indications are provided in the status model.
+
Example
+
+
+
+
print(trigger.timer[1].overrun)
+
+
If an event was ignored, the output is true.
+
If the event was not ignored, the output is false.
Maximum amount of time in seconds to wait for the trigger
+
+
+
+
+
Details
+
If one or more trigger events were detected since the last time trigger.timer[N].wait() or trigger.timer[N].clear() was called, this function returns immediately.
+
After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.
+
Example
+
+
+
+
triggered = trigger.timer[3].wait(10)
+
print(triggered)
+
+
Waits up to 10 s for a trigger on timer 3.
+
If false is returned, no trigger was detected during the 10 s timeout.
This function waits for a command interface trigger event.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
triggered = trigger.wait(timeout)
+
+
+
+
triggered
+
+
true: A trigger was detected during the timeout period
+
false: No triggers were detected during the timeout period
+
+
+
+
timeout
+
+
Maximum amount of time in seconds to wait for the trigger
+
+
+
+
+
Details
+
This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when:
+
A GPIB GET command is detected (GPIB only)
A USBTMC TRIGGER message is received (USB only)
A VXI-11 device_trigger method is invoked (VXI-11 only)
A *TRG message is received
If one or more of these trigger events were previously detected, this function returns immediately.
+
After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.
+
Example
+
+
+
+
triggered = trigger.wait(10)
+
print(triggered)
+
+
Waits up to 10 seconds for a trigger.
+
If false is returned, no trigger was detected during the 10-second timeout.
This attribute stores the system node enable register.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
nodeEnableRegister = status.node_enable
+
status.node_enable = nodeEnableRegister
+
+
+
+
nodeEnableRegister
+
+
The status of the system node enable register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
This attribute is used to read or write to the system node enable register. Reading the system node enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register. The register and bit that is set depends on the TSP-Link node number assigned to this instrument.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.MEASUREMENT_SUMMARY_BIT
+
status.MSB
+
Set summary bit indicates that an enabled measurement event has occurred.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
Not used
+
+
+
+
B2
+
+
status.ERROR_AVAILABLE
+
status.EAV
+
Set summary bit indicates that an error or status message is present in the error queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.QUESTIONABLE_SUMMARY_BIT
+
status.QSB
+
Set summary bit indicates that an enabled questionable event has occurred.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.MESSAGE_AVAILABLE
+
status.MAV
+
Set summary bit indicates that a response message is present in the output queue.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.EVENT_SUMMARY_BIT
+
status.ESB
+
Set summary bit indicates that an enabled standard event has occurred.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
status.MASTER_SUMMARY_STATUS
+
status.MSS
+
Set bit indicates that an enabled Master Summary Status (MSS) bit of the Status Byte Register is set.
+
Bit B6 decimal value: 64
+
+
+
+
B7
+
+
status.OPERATION_SUMMARY_BIT
+
status.OSB
+
Set summary bit indicates that an enabled operation event has occurred.
+
Bit B7 decimal value: 128
+
+
+
+
+
As an example, to set the B0 bit of the system node enable register, set status.node_enable = status.MSB.
+
In addition to the above values, nodeEnableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set nodeEnableRegister to the sum of their decimal weights. For example, to set bits B0 and B7, set nodeEnableRegister to 129 (1 + 128).
+
+
+
+
Bit
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
Binary value
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
+
+
Decimal
+
+
128
+
+
64
+
+
32
+
+
16
+
+
8
+
+
4
+
+
2
+
+
1
+
+
+
+
Weights
+
+
(27)
+
+
(26)
+
+
(25)
+
+
(24)
+
+
(23)
+
+
(22)
+
+
(21)
+
+
(20)
+
+
+
+
+
Example 1
+
+
+
+
nodeEnableRegister = status.MSB + status.OSB
+
status.node_enable = nodeEnableRegister
+
+
+
+
Use constants to set the MSB and OSB bits of the system node enable register.
+
+
+
+
+
Example 2
+
+
+
+
-- decimal 129 = binary 10000001
+
nodeEnableRegister = 129
+
status.node_enable = nodeEnableRegister
+
+
+
+
Sets the MSB and OSB bits of the system node enable register using a decimal value.
This attribute stores the status node event register.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
nodeEventRegister = status.node_event
+
+
+
+
nodeEventRegister
+
+
The status of the node event register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
This attribute is used to read the status node event register, which is returned as a numeric value (reading this register returns a value). The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
The returned value can indicate one or more status events occurred.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.MEASUREMENT_SUMMARY_BIT
+
status.MSB
+
Set summary bit indicates that an enabled measurement event has occurred.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
Not used
+
+
+
+
B2
+
+
status.ERROR_AVAILABLE
+
status.EAV
+
Set summary bit indicates that an error or status message is present in the error queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.QUESTIONABLE_SUMMARY_BIT
+
status.QSB
+
Set summary bit indicates that an enabled questionable event has occurred.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.MESSAGE_AVAILABLE
+
status.MAV
+
Set summary bit indicates that a response message is present in the output queue.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.EVENT_SUMMARY_BIT
+
status.ESB
+
Set summary bit indicates that an enabled standard event has occurred.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
status.MASTER_SUMMARY_STATUS
+
status.MSS
+
Set bit indicates that an enabled Master Summary Status (MSS) bit of the Status Byte register is set.
+
Bit B6 decimal value: 64
+
+
+
+
B7
+
+
status.OPERATION_SUMMARY_BIT
+
status.OSB
+
Set summary bit indicates that an enabled operation event has occurred.
+
Bit B7 decimal value: 128
+
+
+
+
+
In addition to the above constants, nodeEventRegister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, nodeEventRegister contains the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).
+
+
+
+
Bit
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
Binary value
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
+
+
Decimal
+
+
128
+
+
64
+
+
32
+
+
16
+
+
8
+
+
4
+
+
2
+
+
1
+
+
+
+
Weights
+
+
(27)
+
+
(26)
+
+
(25)
+
+
(24)
+
+
(23)
+
+
(22)
+
+
(21)
+
+
(20)
+
+
+
+
+
Example
+
+
+
+
nodeEventRegister = status.node_event
+
print(nodeEventRegister)
+
+
+
+
Reads the status node event register.
+
Sample output:
+
1.29000e+02
+
Converting this output (129) to its binary equivalent yields 1000 0001. Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSB) and B7 (OSB).
These attributes manage the operation status register set of the status model.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
31,769 (All bits set)
+
+
+
+
+
Usage
+
operationRegister = status.operation.condition
+
operationRegister = status.operation.enable
+
operationRegister = status.operation.event
+
operationRegister = status.operation.ntr
+
operationRegister = status.operation.ptr
+
status.operation.enable = operationRegister
+
status.operation.ntr = operationRegister
+
status.operation.ptr = operationRegister
+
+
+
+
operationRegister
+
+
The status of the operation status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes read or write the operation status registers.
+
Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 2.04800e+04 (which is 20,480) is read as the value of the condition register, the binary equivalent is 0101 0000 0000 0000. This value indicates that bit B14 (PROGRAM_RUNNING) and bit B12 (USER) are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
1
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.operation.CALIBRATING
+
status.operation.CAL
+
Set bit indicates that the summary bit of the status.operation.calibrating register has been set.
+
Bit B0 decimal value: 1
+
+
+
+
B1 to B2
+
+
Not used
+
+
+
+
B3
+
+
status.operation.SWEEPING
+
status.operation.SWE
+
Set bit indicates that the summary bit from the status.operation.sweeping register is set.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.operation.MEASURING
+
status.operation.MEAS
+
Set bit indicates that the summary bit of the status.operation.measuring register is set.
+
Bit B4 decimal value: 16
+
+
+
+
B5 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.TRIGGER_OVERRUN
+
status.operation.TRGOVR
+
Set bit indicates that the summary bit from the status.operation.trigger_overrun register is set.
+
Bit B10 decimal value: 1,024
+
+
+
+
B11
+
+
status.operation.REMOTE_SUMMARY
+
status.operation.REM
+
Set bit indicates that the summary bit of the status.operation.remote register is set.
+
Bit B11 decimal value: 2,048
+
+
+
+
B12
+
+
status.operation.USER
+
Set bit indicates that the summary bit from the status.operation.user register is set.
+
Bit B12 decimal value: 4,096
+
+
+
+
B13
+
+
status.operation.INSTRUMENT_SUMMARY
+
status.operation.INST
+
Set bit indicates that the summary bit from the status.operation.instrument register is set.
+
Bit B13 decimal value: 8,192
+
+
+
+
B14
+
+
status.operation.PROGRAM_RUNNING
+
status.operation.PROG
+
Set bit indicates that a command or program is running.
+
Bit B14 decimal value: 16,384
+
+
+
+
B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B12 of the operation status enable register, set status.operation.enable= status.operation.USER.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B12 and B14, set operationRegister to 20,480 (which is the sum of 4,096 + 16,384).
The status of the operation status digital I/O summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status digital I/O summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.instrument.digio.TRIGGER_OVERRUN
+
status.operation.instrument.digio.TRGOVR
+
Set bit indicates an enabled bit in the Operation Status Digital I/O Overrun Register is set.
+
Bit B10 decimal value: 1,024
+
Binary value: 0100 0000 0010
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constant, operationRegister can be set to the decimal value of the bit to set.
The status of the operation status digio I/O overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status digital I/O overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
A set bit indicates that the specified digital I/O line generated an action overrun when it was triggered to generate an output trigger.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
As an example, to set bit B1 of the operation status digital I/O overrun enable register, set status.operation.instrument.digio.trigger_overrun.enable = status.operation.instrument.digio.trigger_overrun.LINE1.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024).
The status of the operation status LAN summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status LAN summary registers. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.operation.instrument.lan.CONNECTION
+
status.operation.instrument.lan.CON
+
Set bit indicates that the LAN cable is connected and a link has been detected.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
status.operation.instrument.lan.CONFIGURING
+
status.operation.instrument.lan.CONF
+
Set bit indicates the LAN is performing its configuration sequence.
+
Bit B1 decimal value: 2
+
+
+
+
B2 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.instrument.lan.TRIGGER_OVERRUN
+
status.operation.instrument.lan.TRGOVR
+
Set bit indicates one or more enabled bits for the operation status LAN trigger overrun register is set.
+
Bit B10 decimal value: 1,024
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B0 of the operation status LAN summary enable register, set status.operation.instrument.lan.enable= status.operation.instrument.lan.CON.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1024).
The status of the operation status LAN trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status LAN trigger overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 2.58000e+02 (which is 258) is read as the value of the condition register, the binary equivalent is 0000 0001 0000 0010. This value indicates that bit B1 and bit B8 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
A set bit indicates that the specified LAN trigger generated an action overrun when triggered to generate a trigger packet.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
As an example, to set bit B1 of the operation status LAN trigger overrun enable register, set status.operation.instrument.lan.trigger_overrun.enable = status.operation.instrument.lan.trigger_overrun.LAN1.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set operationRegister to 258 (which is the sum of 2 + 256).
The status of the operation status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02500e+02 (which is 1,025) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B0 and bit B10 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.operation.instrument.smua.CALIBRATING
+
status.operation.instrument.smua.CAL
+
Set bit indicates that smua is unlocked for calibration.
+
Bit B0 decimal value: 1
+
+
+
+
B1 to B2
+
+
Not used
+
+
+
+
B3
+
+
status.operation.instrument.smua.SWEEPING
+
status.operation.instrument.smua.SWE
+
Set bit indicates that smua is sweeping.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.operation.instrument.smua.MEASURING
+
status.operation.instrument.smua.MEAS
+
Bit is set when making an overlapped measurement, but it will not set when taking a normal synchronous measurement.
+
Bit B4 decimal value: 16
+
+
+
+
B5 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.instrument.smua.TRIGGER_OVERRUN
+
status.operation.instrument.smua.TRGOVR
+
Set bit indicates an enabled bit has been set in the operation status smua trigger overrun event register.
+
Bit B10 decimal value: 1,024
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B0 of the operation status SMU A summary enable register, set status.operation.instrument.smua.enable = status.operation.instrument.smua.CAL.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B0 and B10, set operationRegister to 1,025 (which is the sum of 1 + 1,024).
The status of the operation status SMU trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status SMU trigger overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
Set bit indicates that the end pulse event detector of the SMU was already in the detected state when a trigger was received.
+
Bit B4 decimal value: 16
+
+
+
+
B5 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the operation status SMU A trigger overrun enable register, set status.operation.instrument.smua.trigger_overrun.enable= status.operation.instrument.smua.trigger_overrun.ARM.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16).
The status of the operation status trigger blender summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status trigger blender summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
Set bit indicates one or more enabled bits for operation status trigger blender overrun register is set.
+
Bit B10 decimal value: 1,024
+
Binary value: 0100 0000 0000
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.
The status of the operation status trigger timer summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status trigger timer summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
Set bit indicates one or more enabled bits for the operation status trigger timer overrun register is set.
+
Bit B10 decimal value: 1,024
+
Binary value: 0100 0000 0000
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.
The status of the operation status trigger timer trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status trigger timer overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
A set bit indicates the specified timer generated an action overrun because it was still processing a delay from a previous trigger when a new trigger was received.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
As an example, to set bit B1 of the operation status trigger timer trigger overrun enable register, set status.operation.instrument.trigger_timer.trigger_overrun.enable = status.operation.instrument.trigger_timer.trigger_overrun.TMR1.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16).
The status of the operation status TSP-Link summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status TSP-Link summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
Set bit indicates one or more enabled bits for the operation status TSP-Link overrun register is set.
+
Bit B10 decimal value: 1,024
+
Binary value: 0100 0000 0000
+
+
+
+
B11 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.
+
Example
+
+
+
+
status.operation.instrument.tsplink.enable = 1024
+
+
+
+
Uses the decimal value to set the trigger overrun bit of the operation status TSP-Link summary enable register.
The status of the operation status TSP-link overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status TSP-link overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 10 is read as the value of the condition register, the binary equivalent is 0000 0000 0000 1010. This value indicates that bit B1 and bit B3 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
A set bit indicates that the specified line generated an action overrun when triggered to generate an output trigger.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
As an example, to set bit B1 of the operation status TSP-Link overrun enable register, set status.operation.instrument.tsplink.trigger_overrun.enable = status.operation.instrument.tsplink.trigger_overrun.LINE1.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B3, set operationRegister to 10 (which is the sum of 2 + 8).
The status of the operation status remote summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status remote summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.remote.COMMAND_AVAILABLE
+
status.operation.remote.CAV
+
Set bit indicates there is a command available in the execution queue.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0000 0000 0010
+
+
+
+
B2 to B10
+
+
Not used
+
+
+
+
B11
+
+
status.operation.remote.PROMPTS_ENABLED
+
status.operation.remote.PRMPT
+
Set bit indicates command prompts are enabled.
+
Bit B11 decimal value: 2,048
+
Binary value: 0000 0100 0000 0000
+
+
+
+
B12 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the operation status remote summary enable register, set status.operation.remote.enable = status.operation.remote.CAV.
+
In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B11, set operationRegister to 2,050 (which is the sum of 2 + 2,048).
The status of the operation status user register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bits B0 and B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
status.operation.user.BIT0
+
+
1
+
+
+
+
B1
+
+
status.operation.user.BIT1
+
+
2
+
+
+
+
B2
+
+
status.operation.user.BIT2
+
+
4
+
+
+
+
B3
+
+
status.operation.user.BIT3
+
+
8
+
+
+
+
B4
+
+
status.operation.user.BIT4
+
+
16
+
+
+
+
B5
+
+
status.operation.user.BIT5
+
+
32
+
+
+
+
B6
+
+
status.operation.user.BIT6
+
+
64
+
+
+
+
B7
+
+
status.operation.user.BIT7
+
+
128
+
+
+
+
B8
+
+
status.operation.user.BIT8
+
+
256
+
+
+
+
B9
+
+
status.operation.user.BIT9
+
+
512
+
+
+
+
B10
+
+
status.operation.user.BIT10
+
+
1,024
+
+
+
+
B11
+
+
status.operation.user.BIT11
+
+
2,048
+
+
+
+
B12
+
+
status.operation.user.BIT12
+
+
4,096
+
+
+
+
B13
+
+
status.operation.user.BIT13
+
+
8,192
+
+
+
+
B14
+
+
status.operation.user.BIT14
+
+
16,384
+
+
+
+
B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B0 of the operation status user enable register, set status.operation.user.enable= status.operation.user.BIT0.
+
In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B11 and B14, set operationRegister to 18,432 (which is the sum of 2,048 + 16,384).
This function resets all bits in the status model.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
status.reset()
+
Details
+
This function clears all status data structure registers (enable, event, NTR, and PTR) to their default values. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers.
These attributes manage the standard event status register set of the status model.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
253 (All bits set)
+
+
+
+
+
Usage
+
standardRegister = status.standard.condition
+
standardRegister = status.standard.enable
+
standardRegister = status.standard.event
+
standardRegister = status.standard.ntr
+
standardRegister = status.standard.ptr
+
status.standard.enable = standardRegister
+
status.standard.ntr = standardRegister
+
status.standard.ptr = standardRegister
+
+
+
+
standardRegister
+
+
The status of the standard event status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
+
+
B0
+
+
status.standard.OPERATION_COMPLETE
+
status.standard.OPC
+
Set bit indicates that all pending selected instrument operations are completed and the instrument is ready to accept new commands. The bit is set in response to an *OPC command. The opc() function can be used in place of the *OPC command.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
Not used
+
+
+
+
B2
+
+
status.standard.QUERY_ERROR
+
status.standard.QYE
+
Set bit indicates that you attempted to read data from an empty Output Queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.standard.DEVICE_DEPENDENT_ERROR
+
status.standard.DDE
+
Set bit indicates that an instrument operation did not execute properly due to some internal condition.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.standard.EXECUTION_ERROR
+
status.standard.EXE
+
Set bit indicates that the instrument detected an error while trying to execute a command.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.standard.COMMAND_ERROR
+
status.standard.CME
+
Set bit indicates that a command error has occurred. Command errors include:
+
IEEE Std 488.2 syntax error: Instrument received a message that does not follow the defined syntax of the IEEE Std 488.2 standard.
+
Semantic error: Instrument received a command that was misspelled or received an optional IEEE Std 488.2 command that is not implemented.
+
GET error: The instrument received a Group Execute Trigger (GET) inside a program message.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
status.standard.USER_REQUEST
+
status.standard.URQ
+
Set bit indicates that the LOCAL key on the instrument front panel was pressed.
+
Bit B6 decimal value: 64
+
+
+
+
B7
+
+
status.standard.POWER_ON
+
status.standard.PON
+
Set bit indicates that the instrument has been turned off and turned back on since the last time this register has been read.
+
Bit B7 decimal value: 128
+
+
+
+
B8 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B0 of the standard event status enable register, set status.standard.enable = status.standard.OPC.
+
In addition to the above constants, standardRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set standardRegister to the sum of their decimal weights. For example, to set bits B0 and B4, set standardRegister to 17 (which is the sum of 1 + 16).
These attributes manage the TSP-Link® system summary register of the status model for nodes 1 through 14.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
32,767 (All bits set)
+
+
+
+
+
Usage
+
enableRegister = status.system.condition
+
enableRegister = status.system.enable
+
enableRegister = status.system.event
+
enableRegister = status.system.ntr
+
enableRegister = status.system.ptr
+
status.system.enable = enableRegister
+
status.system.ntr = enableRegister
+
status.system.ptr = enableRegister
+
+
+
+
enableRegister
+
+
The status of the system summary register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
status.system.EXTENSION_BIT
+
status.system.EXT
+
+
1
+
+
+
+
B1
+
+
status.system.NODE1
+
+
2
+
+
+
+
B2
+
+
status.system.NODE2
+
+
4
+
+
+
+
B3
+
+
status.system.NODE3
+
+
8
+
+
+
+
B4
+
+
status.system.NODE4
+
+
16
+
+
+
+
B5
+
+
status.system.NODE5
+
+
32
+
+
+
+
B6
+
+
status.system.NODE6
+
+
64
+
+
+
+
B7
+
+
status.system.NODE7
+
+
128
+
+
+
+
B8
+
+
status.system.NODE8
+
+
256
+
+
+
+
B9
+
+
status.system.NODE9
+
+
512
+
+
+
+
B10
+
+
status.system.NODE10
+
+
1,024
+
+
+
+
B11
+
+
status.system.NODE11
+
+
2,048
+
+
+
+
B12
+
+
status.system.NODE12
+
+
4,096
+
+
+
+
B13
+
+
status.system.NODE13
+
+
8,192
+
+
+
+
B14
+
+
status.system.NODE14
+
+
16,384
+
+
+
+
B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B0 of the system summary status enable register, set status.system.enable = status.system.enable.EXT.
+
In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384).
These attributes manage the TSP-Link® system summary register of the status model for nodes 15 through 28.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
32,767 (All bits set)
+
+
+
+
+
Usage
+
enableRegister = status.system2.condition
+
enableRegister = status.system2.enable
+
enableRegister = status.system2.event
+
enableRegister = status.system2.ntr
+
enableRegister = status.system2.ptr
+
status.system2.enable = enableRegister
+
status.system2.ntr = enableRegister
+
status.system2.ptr = enableRegister
+
+
+
+
enableRegister
+
+
The status of the system summary 2 register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
status.system2.EXTENSION_BIT
+
status.system2.EXT
+
+
1
+
+
+
+
B1
+
+
status.system2.NODE15
+
+
2
+
+
+
+
B2
+
+
status.system2.NODE16
+
+
4
+
+
+
+
B3
+
+
status.system2.NODE17
+
+
8
+
+
+
+
B4
+
+
status.system2.NODE18
+
+
16
+
+
+
+
B5
+
+
status.system2.NODE19
+
+
32
+
+
+
+
B6
+
+
status.system2.NODE20
+
+
64
+
+
+
+
B7
+
+
status.system2.NODE21
+
+
128
+
+
+
+
B8
+
+
status.system2.NODE22
+
+
256
+
+
+
+
B9
+
+
status.system2.NODE23
+
+
512
+
+
+
+
B10
+
+
status.system2.NODE24
+
+
1,024
+
+
+
+
B11
+
+
status.system2.NODE25
+
+
2,048
+
+
+
+
B12
+
+
status.system2.NODE26
+
+
4,096
+
+
+
+
B13
+
+
status.system2.NODE27
+
+
8,192
+
+
+
+
B14
+
+
status.system2.NODE28
+
+
16,384
+
+
+
+
B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B0 of the system summary 2 enable register, set status.system2.enable = status.system2.EXT.
+
In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384).
These attributes manage the TSP-Link® system summary register of the status model for nodes 29 through 42.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
32,767 (All bits set)
+
+
+
+
+
Usage
+
enableRegister = status.system3.condition
+
enableRegister = status.system3.enable
+
enableRegister = status.system3.event
+
enableRegister = status.system3.ntr
+
enableRegister = status.system3.ptr
+
status.system3.enable = enableRegister
+
status.system3.ntr = enableRegister
+
status.system3.ptr = enableRegister
+
+
+
+
enableRegister
+
+
The status of the system summary 3 register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0 and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
status.system3.EXTENSION_BIT
+
status.system3.EXT
+
+
1
+
+
+
+
B1
+
+
status.system3.NODE29
+
+
2
+
+
+
+
B2
+
+
status.system3.NODE30
+
+
4
+
+
+
+
B3
+
+
status.system3.NODE31
+
+
8
+
+
+
+
B4
+
+
status.system3.NODE32
+
+
16
+
+
+
+
B5
+
+
status.system3.NODE33
+
+
32
+
+
+
+
B6
+
+
status.system3.NODE34
+
+
64
+
+
+
+
B7
+
+
status.system3.NODE35
+
+
128
+
+
+
+
B8
+
+
status.system3.NODE36
+
+
256
+
+
+
+
B9
+
+
status.system3.NODE37
+
+
512
+
+
+
+
B10
+
+
status.system3.NODE38
+
+
1,024
+
+
+
+
B11
+
+
status.system3.NODE39
+
+
2,048
+
+
+
+
B12
+
+
status.system3.NODE40
+
+
4,096
+
+
+
+
B13
+
+
status.system3.NODE41
+
+
8,192
+
+
+
+
B14
+
+
status.system3.NODE42
+
+
16,384
+
+
+
+
B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B0 of the system summary 3 enable register, set status.system3.enable = status.system3.EXT.
+
In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384).
These attributes manage the TSP-Link® system summary register of the status model for nodes 43 through 56.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
32,767 (All bits set)
+
+
+
+
+
Usage
+
enableRegister = status.system4.condition
+
enableRegister = status.system4.enable
+
enableRegister = status.system4.event
+
enableRegister = status.system4.ntr
+
enableRegister = status.system4.ptr
+
status.system4.enable = enableRegister
+
status.system4.ntr = enableRegister
+
status.system4.ptr = enableRegister
+
+
+
+
enableRegister
+
+
The status of the system summary 4 register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
status.system4.EXTENSION_BIT
+
status.system4.EXT
+
+
1
+
+
+
+
B1
+
+
status.system4.NODE43
+
+
2
+
+
+
+
B2
+
+
status.system4.NODE44
+
+
4
+
+
+
+
B3
+
+
status.system4.NODE45
+
+
8
+
+
+
+
B4
+
+
status.system4.NODE46
+
+
16
+
+
+
+
B5
+
+
status.system4.NODE47
+
+
32
+
+
+
+
B6
+
+
status.system4.NODE48
+
+
64
+
+
+
+
B7
+
+
status.system4.NODE49
+
+
128
+
+
+
+
B8
+
+
status.system4.NODE50
+
+
256
+
+
+
+
B9
+
+
status.system4.NODE51
+
+
512
+
+
+
+
B10
+
+
status.system4.NODE52
+
+
1,024
+
+
+
+
B11
+
+
status.system4.NODE53
+
+
2,048
+
+
+
+
B12
+
+
status.system4.NODE54
+
+
4,096
+
+
+
+
B13
+
+
status.system4.NODE55
+
+
8,192
+
+
+
+
B14
+
+
status.system4.NODE56
+
+
16,384
+
+
+
+
B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B0 of the system summary 4 enable register, set status.system4.enable = status.system4.enable.EXT.
+
In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384).
These attributes manage the TSP-Link® system summary register of the status model for nodes 57 through 64.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute
+
+
- -
+
+
- -
+
+
- -
+
+
- -
+
+
+
+
.condition (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
.enable (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.event (R)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ntr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
.ptr (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
510 (All bits set)
+
+
+
+
+
Usage
+
enableRegister = status.system5.condition
+
enableRegister = status.system5.enable
+
enableRegister = status.system5.event
+
enableRegister = status.system5.ntr
+
enableRegister = status.system5.ptr
+
status.system5.enable = enableRegister
+
status.system5.ntr = enableRegister
+
status.system5.ptr = enableRegister
+
+
+
+
enableRegister
+
+
The status of the system summary 5 register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value, but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.30000e+02 (which is 130) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0010. This value indicates that bit B1 and bit B7 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
Decimal value
+
+
+
+
B0
+
+
Not used
+
+
Not applicable
+
+
+
+
B1
+
+
status.system5.NODE57
+
+
2
+
+
+
+
B2
+
+
status.system5.NODE58
+
+
4
+
+
+
+
B3
+
+
status.system5.NODE59
+
+
8
+
+
+
+
B4
+
+
status.system5.NODE60
+
+
16
+
+
+
+
B5
+
+
status.system5.NODE61
+
+
32
+
+
+
+
B6
+
+
status.system5.NODE62
+
+
64
+
+
+
+
B7
+
+
status.system5.NODE63
+
+
128
+
+
+
+
B8
+
+
status.system5.NODE64
+
+
256
+
+
+
+
B9 to B15
+
+
Not used
+
+
Not applicable
+
+
+
+
+
As an example, to set bit B1 of the system summary 5 enable register, set status.system5.enable = status.system5.NODE57.
+
In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set enableRegister to 18 (which is the sum of 2 + 16).
These steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you must take. See Delete user scripts from the instrument.
+
To delete a script from nonvolatile memory using a remote interface:
+
You can delete the script from nonvolatile memory by sending either of the following commands:
+
script.delete("name")
script.user.delete("name")
Where: name is the user-defined name of the script.
+
Example: Delete a user script from nonvolatile memory
+
+
+
+
script.delete("test8")
+
+
Delete a user script named test8 from nonvolatile memory.
This function restores a script that was removed from the runtime environment.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
script.restore(name)
+
+
+
+
name
+
+
The name of the script to be restored
+
+
+
+
+
Details
+
This command copies the script from nonvolatile memory into the runtime environment. It also creates a global variable with the same name as the name of the script.
+
Example
+
+
+
+
script.restore("test9")
+
+
Restores a script named test9 from nonvolatile memory.
This attribute controls the autorun state of a script.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
No
+
+
Not applicable
+
+
See Details
+
+
See Details
+
+
+
+
+
Usage
+
scriptVar.autorun = "state"
+
state = scriptVar.autorun
+
+
+
+
scriptVar
+
+
The name of the variable that references the script
+
+
+
+
state
+
+
String that indicates whether or not the script runs automatically when powered on:
+
yes: Script runs automatically
no: Script does not run automatically
+
+
+
+
Details
+
Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun.
+
The run order for autorun scripts is arbitrary, so make sure the run order is not important.
+
The default value for scriptVar.autorun depends on how the script was loaded. The default is no if the script was loaded with loadscript or script.new(). It is yes for scripts loaded with loadandrunscript or script.newautorun().
+
Make sure to save the script in nonvolatile memory after setting the autorun attribute so that the instrument keeps the setting.
+
Example
+
+
+
+
test5.autorun = "yes"
+
test5.save()
+
+
Assume a script named test5 is in the runtime environment.
+
The next time the instrument is turned on, test5 script automatically loads and runs.
This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
for name in script.user.catalog() do body end
+
+
+
+
name
+
+
String representing the name of the script
+
+
+
+
body
+
+
Code that implements the body of the for loop to process the names in the catalog
+
+
+
+
+
Details
+
This function accesses the catalog of scripts stored in nonvolatile memory, which allows you to process all scripts in nonvolatile memory. The entries are enumerated in no particular order.
+
Each time the body of the function executes, name takes on the name of one of the scripts stored in nonvolatile memory. The for loop repeats until all scripts have been iterated.
This function saves the script to nonvolatile memory or to a USB flash drive.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
scriptVar.save()
+
scriptVar.save("filename")
+
+
+
+
scriptVar
+
+
The name of variable that references the script
+
+
+
+
filename
+
+
A string that contains the file name to use when saving the script to a USB flash drive
+
+
+
+
+
Details
+
The scriptVar.save() function saves a script to nonvolatile memory or a USB flash drive. The root folder of the USB flash drive has the absolute path /usb1/.
+
If no filename is specified (the file name parameter is an empty string), the script is saved to internal nonvolatile memory. Only a script with filename defined can be saved to internal nonvolatile memory. If a filename is given, the script is saved to the USB flash drive.
+
You can add the file extension, but it is not required. The only allowed extension is .tsp (see Example 2).
+
Example 1
+
+
+
+
test8.save()
+
+
Saves the script referenced by the variable test8 to nonvolatile memory.
+
+
+
+
+
Example 2
+
+
+
+
test8.save("/usb1/myScript.tsp")
+
+
Saves the script referenced by the variable test8 to a file named myScript.tsp on your USB flash drive.
This attribute contains the source code of a script.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW) (see Details)
+
+
No
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
+
Usage
+
code = scriptVar.source
+
scriptVar.source = nil
+
+
+
+
scriptVar
+
+
The name of the variable that references the script that contains the source code
+
+
+
+
code
+
+
A string that contains the body of the script
+
+
+
+
+
Details
+
The loadscript or loadandrunscript and endscript keywords are not included in the source code.
+
The body of the script is a single string with lines separated by the new line character.
+
The instrument automatically stores the source for all scripts that are loaded on the instrument. To free up memory or to obfuscate the code, assign nil to the source attribute of the script. Although this attribute is writable, it can only be set to the nil value.
+
Example
+
+
+
+
test7 = script.new("display.clear() display.settext('Hello from my test')", "")
+
print(test7.source)
+
+
+
+
This example creates a script called test7 that displays a message on the front panel and retrieves the source code.
+
Output:
+
display.clear() display.settext('Hello from my test')
Instruments that are enabled for Test Script Processor (TSP®) operate like conventional instruments by responding to a sequence of commands sent by the controller. You can send individual commands to the TSP-enabled instrument the same way you would when using any other instrument.
+
Unlike conventional instruments, TSP-enabled instruments can execute automated test sequences independently, without an external controller. You can load a series of TSP commands into the instrument. You can store these commands as a script that can be run later by sending a single command message to the instrument.
+
You do not have to choose between using conventional control or script control. You can combine these forms of instrument control in the way that works best for your test application.
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/17030.htm b/WebHelpDocs/2601B-PULSE/17030.htm
new file mode 100644
index 0000000..9194206
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/17030.htm
@@ -0,0 +1,67 @@
+
+
+
+
+ Retrieve source code one line at a time
+
+
+
+
+
+
+
+
+
+
+
+
+
Retrieve source code one line at a time
+
To retrieve the source code one line at a time, send the scriptVar.list() command. When this command is received, the instrument sends the entire script. Each line of the script is sent as a separate response message. The output includes the loadscript or loadandrunscript and endscript keywords.
+
After retrieving the source code, you can modify and save the command lines as a user script under the same name or a new name.
+
To retrieve the source code of a script one line at a time, send the command:
+
scriptVar.list()
+
Where scriptVar is the name of the script.
+
To retrieve the commands in the anonymous script, use script.anonymous.list().
This attribute enables or disables the reading buffer cache (on or off).
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
1 (enabled)
+
+
+
+
+
Usage
+
cacheMode = bufferVar.cachemode
+
bufferVar.cachemode = cacheMode
+
+
+
+
cacheMode
+
+
The reading buffer cache mode; set to one of the following:
+
0: Cache mode disabled (off)
1: Cache mode enabled (on)
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
+
Details
+
Assigning a value to this attribute enables or disables the reading buffer cache. When enabled, the reading buffer cache improves access speed to reading buffer data.
+
If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data. This can happen when initiating successive sweeps without reconfiguring the sweep measurements or when overwriting data in the reading buffer by setting the bufferVar.fillmode attribute to smua.FILL_WINDOW. To avoid this, make sure that you include commands that automatically invalidate the cache as needed (for example, explicit calls to the bufferVar.clearcache() function) or disable the cache using this attribute (bufferVar.cachemode).
+
Example
+
+
+
+
smua.nvbuffer1.cachemode = 1
+
+
Enables reading buffer cache of dedicated reading buffer 1 (source-measure unit (SMU) channel A).
Controlling the instrument by sending individual command messages
+
The simplest method of controlling an instrument through the communication interface is to send it a message that contains remote commands. You can use a test program that resides on a computer (the controller) to sequence the actions of the instrument.
+
TSP commands can be function-based or attribute-based. Function-based commands are commands that control actions or activities. Attribute-based commands define characteristics of an instrument feature or operation.
This attribute contains the write-protect mask that protects bits from changes by the tsplink.writebit() and tsplink.writeport() functions.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup
+
+
Saved setup
+
+
0
+
+
+
+
+
Usage
+
mask = tsplink.writeprotect
+
tsplink.writeprotect = mask
+
+
+
+
mask
+
+
An integer that specifies the value of the bit pattern for write-protect; set bits to 1 to write-protect the corresponding TSP-Link trigger line
+
+
+
+
+
Details
+
The binary equivalent of mask indicates the mask to be set for the TSP-Link trigger line. For example, a mask value of 5 has a binary equivalent of 101. This mask write-protects TSP-Link trigger lines 1 and 3.
TSP-enabled instruments do not have inherent query commands. Like other scripting environments, the print() command and other related print() commands generate output. The print() command creates one response message.
+
The output from multiple arguments is separated with a tab character.
+
Numbers are printed using the format.asciiprecision attribute. If you want use Lua formatting, print the return value from the tostring() function.
+
Example 1
+
+
+
+
x = 10
+
print(x)
+
+
Example of an output response message:
+
10
+
Note that your output might be different if you set your ASCII precision setting to a different value.
This attribute specifies events that cause this trigger to assert.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset LAN trigger N reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
triggerStimulus = lan.trigger[N].stimulus
+
lan.trigger[N].stimulus = triggerStimulus
+
+
+
+
triggerStimulus
+
+
The LAN event identifier used to trigger the event
+
+
+
+
N
+
+
A number specifying the trigger packet over the LAN for which to set or query the trigger source (1 to 8)
+
+
+
+
+
Details
+
This attribute specifies which event causes a LAN trigger packet to be sent for this trigger. Set triggerStimulus to one of the trigger event IDs, which are shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
+
+
+
+
+
Setting this attribute to zero disables automatic trigger generation.
+
If any events are detected prior to calling lan.trigger[N].connect(), the event is ignored and the action overrun is set.
This attribute specifies the event that causes the synchronization line to assert a trigger.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup TSP-Link trigger N reset
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = tsplink.trigger[N].stimulus
+
tsplink.trigger[N].stimulus = eventID
+
+
+
+
eventID
+
+
The event identifier for the triggering event
+
+
+
+
N
+
+
The trigger line (1 to 3)
+
+
+
+
+
Details
+
To disable automatic trigger assertion on the synchronization line, set this attribute to zero (0).
+
Do not use this attribute when triggering under script control. Use tsplink.trigger[N].assert() instead.
+
The eventIDparameter may be one of the existing trigger event IDs shown in the following table.
+
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
+
+
+
+
+
Example
+
+
+
+
print(tsplink.trigger[3].stimulus)
+
+
Prints the event that will start TSP-Link trigger line 3 action.
This attribute specifies the events that trigger the blender.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Trigger blender N reset
+
+
Not applicable
+
+
trigger.EVENT_NONE
+
+
+
+
+
Usage
+
eventID = trigger.blender[N].stimulus[M]
+
trigger.blender[N].stimulus[M] = eventID
+
+
+
+
eventID
+
+
The event that triggers the blender action; see Details
+
+
+
+
N
+
+
An integer representing the trigger event blender (up to six)
+
+
+
+
M
+
+
An integer representing the stimulus index (1 to 4)
+
+
+
+
+
Details
+
There are four stimulus inputs that can each select a different event. The eventID parameter can be the event ID of any trigger event.
+
Use zero to disable the blender input.
+
The eventID parameter may be one of the existing trigger event IDs shown in the following table.
+
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
This attribute specifies which event starts the timer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup Trigger timer N reset
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
eventID = trigger.timer[N].stimulus
+
trigger.timer[N].stimulus = eventID
+
+
+
+
eventID
+
+
The event that triggers the timer delay
+
+
+
+
N
+
+
Trigger timer number (1 to 8)
+
+
+
+
+
Details
+
The eventIDparameter may be one of the trigger event IDs shown in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
+
+
+
+
+
Set this attribute to the eventID of any trigger event to cause the timer to start when that event occurs.
+
Set this attribute to zero (0) to disable event processing.
+
Example
+
+
+
+
print(trigger.timer[1].stimulus)
+
+
Prints the event that will start a trigger 1 timer action.
The name of the variable that references the script
+
+
+
+
+
Details
+
This function generates output in the form of a sequence of response messages (one message for each line of the script). It also generates output of the script control messages (loadscript or loadandrunscript and endscript).
+
Example
+
+
+
+
test7 = script.new("display.clear() display.settext('Hello from my test')", "test7")
+
test7()
+
test7.save()
+
test7.list()
+
+
+
+
The above example code creates a script named test7 that displays text on the front panel and lists the script with the following output:
+
loadscript test7
+
display.clear() display.settext("Hello from my test")
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/17852.htm b/WebHelpDocs/2601B-PULSE/17852.htm
new file mode 100644
index 0000000..f624f1f
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/17852.htm
@@ -0,0 +1,49 @@
+
+
+
+
+ Using the TSP command reference
+
+
+
+
+
+
+
+
+
+
+
+
+
Using the TSP command reference
+
The Test Script Processor (TSP®) command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into subsections. The figure below shows an example of a command description.
+
+
The subsections contain information about the command. The subsections are:
+
Command name and summary table
Usage
Details
Example
Also see
The content of each of these subsections is described in the following topics.
Each instrument command description starts with the command name, followed by a brief description and a table with relevant information for each command. Definitions for the numbered items in the figure below are listed following the figure.
+
+
Instrument command name. Indicates the beginning of the command description. It is followed by a brief description of what the command does.
Type of command. Commands can be functions, attributes, or constants. If the command is an attribute, it can be read-only (R), read-write (RW), or write-only (W). For detail on commands, see Introduction to TSP operation.
TSP-Link accessible. Yes or No; indicates whether or not the command can be accessed through a TSP-Link network.
Affected by. Commands or actions that may change the setting of this command.
LAN restore defaults: This command is reset to the default value when lan.restoredefaults() is sent.
Digital I/O trigger N reset: This command is reset to the default value when digio.trigger[N].reset() is sent.
Recall setup: This command is stored as part of the saved setup and is changed to the value stored in the saved setup when the setup is recalled.
Instrument reset: This command is reset to the default value when reset(), localnode.reset(), or *RST is sent.
SMU reset: This command is reset to the default value when smua.reset() is sent.
Power cycle: This command is set to the default value when the instrument power is cycled.
Where saved. Indicates where the command settings reside once they are used on an instrument. Options include:
Not saved: Command is not saved anywhere and must be typed each time you use it.
Nonvolatile memory: Storage area in the instrument where information is saved when the instrument is turned off.
Saved setup: Command is saved as part of the saved setup.
Default value: Lists the default value or constant for the command. The parameter values are defined in the Usage or Details sections of the command description.
The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage. All possible command usage options are shown.
+
+
1Structure of command usage: Shows how the parts of the command should be organized. If a parameter is shown to the left of the command, it is the return when you print the command. Information to the right is the parameters or other items you need to enter when setting the command.
+
2User-supplied parameters: Indicated by italics. For example, for the function beeper.beep(duration, frequency), replace duration with the number of seconds and frequency with the frequency of the tone. Send beeper.beep(2, 2400) to generate a two-second, 2400 Hz tone.
Some commands have optional parameters. If there are optional parameters, they must be entered in the order presented in the Usage section. You cannot leave out any parameters that precede the optional parameter. Optional parameters are shown as separate lines in usage, presented in the required order with each valid permutation of the optional parameters. For example: printbuffer(startIndex, endIndex, buffer1) printbuffer(startIndex, endIndex, buffer1, buffer2)
+
3Parameter value options: Descriptions of the options that are available for the user-defined parameter.
This attribute sets the reading buffer fill count.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
0
+
+
+
+
+
Usage
+
fillCount = bufferVar.fillcount
+
bufferVar.fillcount = fillCount
+
+
+
+
fillCount
+
+
The reading buffer fill count
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
+
Details
+
The reading buffer fill count sets the number of readings to store before restarting at index 1. If the value is zero (0), then the capacity of the buffer is used. Use this attribute to control when the SMU restarts filling the buffer at index 1, rather than having it restart when the buffer is full.
+
If the bufferVar.fillcount attribute is set to a value higher than the capacity of the buffer, after storing the element at the end of the buffer, the SMU will overwrite the reading at index 1, the reading after that will overwrite the reading at index 2, and so on.
+
This attribute is only used when the bufferVar.fillmode attribute is set to smua.FILL_WINDOW.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example
+
+
+
+
smua.nvbuffer1.fillcount = 50
+
+
Sets fill count of dedicated reading buffer 1 to 50.
The reading buffer fill mode; set to one of the following:
+
0 or smua.FILL_ONCE: Do not overwrite old data
1 or smua.FILL_WINDOW: New readings restart at index 1 after acquiring reading at index bufferVar.fillcount
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
+
Details
+
When this attribute is set to smua.FILL_ONCE, the reading buffer will not overwrite readings. If the buffer fills up, new readings will be discarded.
+
When this attribute is set to smua.FILL_WINDOW, new readings will be added after existing data until the buffer holds bufferVar.fillcount elements. Continuing the sequence, the next reading will overwrite the reading at index 1, the reading after that will overwrite the reading at index 2, and so on.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example
+
+
+
+
smua.nvbuffer1.fillmode = smua.FILL_ONCE
+
+
+
+
Sets fill mode of dedicated reading buffer 1 to fill once (do not overwrite old data).
This function returns the statistics for a specified reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
statistics = smua.buffer.getstats(bufferVar)
+
+
+
+
statistics
+
+
The statistical data about the data in the reading buffer
+
+
+
+
bufferVar
+
+
The reading buffer to process
+
+
+
+
+
Details
+
This function returns a table with statistical data about the data that is placed in the buffer.
+
The SMU automatically updates reading buffer statistics as data is added to the reading buffer. When the reading buffer is configured to wrap around and overwrite older data with new data, the buffer statistics include the data that was overwritten.
+
The table returned from this function is a snapshot. Although the SMU continues to update the statistics, the table returned is not updated. To get fresh statistics, call this function again.
+
The statistics parameter has the attributes described in the following table.
+
+
+
Attribute
+
+
When returned
+
+
Description
+
+
+
+
n
+
+
Always
+
+
The number of data points on which the statistics are based
+
+
+
+
mean
+
+
When n > 0
+
+
The average of all readings added to the buffer
+
+
+
+
stddev
+
+
When n > 1
+
+
The standard deviation of all readings (samples) added to the buffer
+
+
+
+
min
+
+
When n > 0
+
+
A table containing data about the minimum reading value added to the buffer
+
+
+
+
max
+
+
When n > 0
+
+
A table containing data about the maximum reading value added to the buffer
+
+
+
+
+
If n equals zero (0), all other attributes are nil. If n equals 1, the stddev attribute is nil because the standard deviation of a sample size of 1 is undefined.
+
The min and max entries each have the attributes defined in the following table.
+
+
+
Attribute
+
+
Description
+
+
+
+
measurefunction
+
+
String indicating the function that was measured for the reading (current, voltage, ohms or watts)
+
+
+
+
measurerange
+
+
The full-scale range value for the measurement range used when the measurement was made
+
+
+
+
reading
+
+
The reading value
+
+
+
+
sourcefunction
+
+
String indicating the source function at the time of the measurement (current or voltage)
+
+
+
+
sourceoutputstate
+
+
String indicating the state of the source (off or on)
+
+
+
+
sourcerange
+
+
Full-scale range value for the source range used when the measurement was made
+
+
+
+
sourcevalue
+
+
If bufferVar.collectsourcevalues is enabled, the sourced value in effect at the time of the reading
+
+
+
+
status
+
+
Status value for the reading; the status value is a floating-point number that encodes the status value into a floating-point value
+
+
+
+
timestamp
+
+
If bufferVar.collecttimestamps is enabled, the timestamp, in seconds, between when the reading was acquired and when the first reading in the buffer was acquired; adding this value to the base timestamp will give the actual time the measurement was acquired
+
+
+
+
+
Example
+
+
+
+
reset()
+
smua.nvbuffer1.clear()
+
smua.measure.count = 10
+
smua.measure.v(smua.nvbuffer1)
+
stats = smua.buffer.getstats(smua.nvbuffer1)
+
print("n= "..stats.n)
+
print("mean= "..stats.mean)
+
print("stddev= "..stats.stddev)
+
print("min= "..stats.min.reading)
+
print("max= "..stats.max.reading)
+
+
+
+
Make measurements and store them in nvbuffer1. Print the statistics for the data.
This function recalculates the statistics of the specified reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.buffer.recalculatestats(bufferVar)
+
+
+
+
bufferVar
+
+
The reading buffer to process
+
+
+
+
+
Details
+
This function causes the SMU to regenerate the reading buffer statistics about the specified reading buffer. Because the SMU automatically updates reading buffer statistics when data is added to the reading buffer, this function is generally not needed. When the reading buffer is configured to wrap around and overwrite older data with new data, the buffer statistics will include the data that was overwritten. Use this function to recalculate the statistics that include only the data that is presently stored in the buffer.
+
Example
+
+
+
+
smua.buffer.recalculatestats(smua.nvbuffer1)
+
+
+
+
Recalculates the statistics of buffer smua.nvbuffer1.
The 2601B-PULSE SMUs have an integrating analog-to-digital converter (ADC). The integrating ADC uses a ratiometric analog-to-digital conversion technique. Depending on the configuration of the integrating ADC, periodic fresh reference measurements are required to minimize drift. The measurement aperture is used to determine the time interval between these measurement updates. For additional information, see Autozero. To help optimize operation of this ADC, the instrument caches the reference and zero values for up to ten of the most recent number of power line cycles. For additional information, see NPLC caching.
This function creates a script and enables autorun.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
No
+
+
+
+
+
+
+
+
+
+
+
Usage
+
scriptVar = script.newautorun("code")
+
scriptVar = script.newautorun("code", "name")
+
+
+
+
scriptVar
+
+
The name of the variable that will reference the script
+
+
+
+
code
+
+
A string that contains the body of the script
+
+
+
+
name
+
+
The name of the script
+
+
+
+
+
Details
+
The name parameter is the name that is added to the script.user.scripts table. If name is not given, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the existing script's name attribute is set to an empty string before it is replaced by the new script.
+
Note that name is the value that is used for the instrument front panel display. If this value is not defined, the script is not available from the front panel.
+
You must save the new script into nonvolatile memory to keep it when the instrument is turned off.
+
The script is run automatically immediately after it is created.
+
This command is the same as the script.new() function except that the script is automatically run.
+
Example
+
+
+
+
NewAuto = script.newautorun("print('Hello from new auto run command')", 'NewAuto')
+
print(NewAuto.autorun)
+
print(NewAuto.name)
+
+
+
+
Creates a new script called NewAuto that automatically has the autorun attribute set to yes after it is created. The name is set to "NewAuto".
Each time the script.run() command is given, the anonymous script is executed. This script can be run using this command many times without having to re-send it.
The amount of time to play the tone (0.001 s to 100 s)
+
+
+
+
frequency
+
+
The frequency of the tone in Hertz (Hz)
+
+
+
+
+
Details
+
You can use the beeper of the 2601B-PULSE to provide an audible signal at a specified frequency and time duration. For example, you can use the beeper to signal the end of a lengthy sweep.
+
The beeper will not sound if it is disabled. It can be disabled or enabled with the beeper enable command, or through the front panel.
+
Example
+
+
+
+
beeper.enable = beeper.ON
+
beeper.beep(2, 2400)
+
+
Enables the beeper and generates a two-second, 2400 Hz tone.
This function performs a 10-point voltage list sweep starting at the first point in myvlist. Current is measured at every step (point) in the sweep. The source will be allowed to settle on each step for 500 ms before a measurement is performed.
Determines if code is saved to nonvolatile memory:
+
0 or display.DONT_SAVE: Does not save the code to nonvolatile memory
1 or display.SAVE: Saves the code to nonvolatile memory (default)
+
+
+
+
Details
+
After adding code to the load menu, you can run it from the front panel by pressing the LOAD key, then selecting USER to select from the available code to load. Pressing the RUN key will then run the script.
+
You can add items in any order. They are always displayed in alphabetic order when the menu is selected.
+
Any Lua code can be included in the code parameter. If memory is set to display.SAVE, the entry (name and code) is saved in nonvolatile memory. Scripts, functions, and variables used in the code are not saved by display.SAVE. Functions and variables need to be saved with the code. If the code is not saved in nonvolatile memory, it is lost when the 2601B-PULSE is turned off. See Example 2 below.
+
If you do not make a selection for memory, the code is automatically saved to nonvolatile memory.
+
You can create a script that defines several functions, and then use the display.loadmenu.add() command to add items that call those individual functions. This allows the operator to run tests from the front panel.
+
Example 1
+
+
+
+
display.loadmenu.add("Test9", "Test9()")
+
+
+
+
Assume a user script named "Test9" has been loaded into the runtime environment. Adds the menu entry to the USER menu to run the script after loading.
Assume a script with a function named “DUT1” has already been loaded into the instrument, and the script has not been saved in nonvolatile memory.
+
Now assume you want to add a test named “Test” to the USER menu. You want the test to run the function named “DUT1” and sound the beeper. This example adds “Test” to the menu, defines the code, and then saves the displayName and code in nonvolatile memory.
+
When “Test” is run from the front panel USER menu, the function named “DUT1” executes and the beeper beeps for two seconds.
+
Now assume you turn off instrument power. Because the script was not saved in nonvolatile memory, the function named “DUT1” is lost when you turn the instrument on. When “Test” is again run from the front panel, an error is generated because DUT1 no longer exists in the instrument as a function.
Use the saved setups commands to save or restore the configurations to or from the nonvolatile memory of the instrument or an installed USB flash drive. You can use the setup.poweron attribute to specify which setup is recalled when the instrument is turned on.
The measure delay is a specific delay that is applied before each measurement is made. This delay is disabled by default (measurements are made immediately). You can change the default delay by setting the smua.measure.delay attribute either to a specific value or to an auto delay setting (set smua.measure.delay = smua.DELAY_AUTO). If the measure delay is set to the auto delay setting, a range-dependent delay is applied each time the instrument performs a current measurement. This delay also happens for the measurement that is taken after changing current ranges during an autoranged measurement. The default measurement delay varies by model.
+
You can increase or decrease the auto delay by changing the delay factor (for example, to reduce the delay across all ranges by half, set smua.measure.delayfactor = 0.5). For additional information, refer to smua.measure.delayfactor in the "Remote commands" section.
This attribute contains the measurement range values that were used for readings stored in a specified buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
measurerange = bufferVar.measureranges[N]
+
+
+
+
measurerange
+
+
The measurement range used to acquire reading number N in the specified buffer
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
N
+
+
The reading number (1 to bufferVar.n)
+
+
+
+
+
Details
+
The measureranges buffer recall attribute is like an array (a Lua table) of full-scale range values for the measure range used when the measurement was made.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example 1
+
+
+
+
measurerange = smua.nvbuffer1.measureranges[1]
+
+
+
+
Store the measure range that was used to make reading number 1.
+
+
+
+
+
Example 2
+
+
+
+
printbuffer(1, 10, smua.nvbuffer1.measureranges)
+
+
+
+
Print the range values that were used for the first 10 readings saved in dedicated reading buffer 1.
This attribute indicates the state of the source output for readings that are stored in a specified buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
state = bufferVar.sourceoutputstates[N]
+
+
+
+
state
+
+
The output state (Off or On) when reading N of the specified buffer was acquired
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
N
+
+
The reading number (1 to bufferVar.n)
+
+
+
+
+
Details
+
The sourceoutputstates buffer recall attribute is similar to an array (a Lua table) of strings. This array indicates the state of the source output (Off or On) at the time of the measurement.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
This attribute contains the source range that was used for readings stored in a specified reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
sourcerange = bufferVar.sourceranges[N]
+
+
+
+
sourcerange
+
+
The source range used to acquire reading number N in the specified buffer
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
N
+
+
The reading number (1 to bufferVar.n)
+
+
+
+
+
Details
+
The sourceranges buffer recall attribute is like an array (a Lua table) of full-scale range values for the source range used when the measurement was made.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example 1
+
+
+
+
sourcerange = smua.nvbuffer1.sourceranges[1]
+
+
+
Store the source range that was used for the first reading stored in dedicated reading buffer 1.
+
+
+
+
+
Example 2
+
+
+
+
printbuffer(1, 6, smua.nvbuffer1.sourceranges)
+
+
Print the source ranges that were used for the first 6 readings stored in source-measure unit (SMU) A, buffer 1.
When enabled by the bufferVar.collectsourcevalues attribute, this attribute contains the source levels being output when readings in the reading buffer were acquired.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
sourcevalue = bufferVar.sourcevalues[N]
+
+
+
+
sourcevalue
+
+
The output value of the source when reading N of the specified buffer was acquired
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1)
+
+
+
+
N
+
+
The reading number (1 to bufferVar.n)
+
+
+
+
+
Details
+
If the bufferVar.collectsourcevalues attribute is enabled before readings are taken, the bufferVar.sourcevalues buffer recall attribute is like an array (a Lua table) of the sourced value in effect at the time of the reading. Note that you can set the bufferVar.collectsourcevalues attribute only if the affected reading buffer is empty. See bufferVar.collectsourcevalues for more detailed information.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example 1
+
+
+
+
sourcevalue = smua.nvbuffer1.sourcevalues[1]
+
+
+
Get the sourced value of the first reading stored in dedicated reading buffer 1.
+
+
+
+
+
Example 2
+
+
+
+
printbuffer(1, 6, smua.nvbuffer1.sourcevalues)
+
+
Print the sourced value of the first 6 readings stored in source-measure unit (SMU) A, buffer 1.
This attribute contains the readings stored in a specified reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
reading = bufferVar.readings[N]
+
+
+
+
reading
+
+
The value of the reading in the specified reading buffer
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
N
+
+
The reading number N; can be any value from 1 to the number of readings in the buffer; use the bufferVar.n command to determine the number of readings in the buffer
+
+
+
+
+
Details
+
The readings buffer recall attribute is like an array (a Lua table) of the readings stored in the reading buffer. This array holds the same data that is returned when the reading buffer is accessed directly; that is, rb[2] and rb.readings[2] access the same value.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example
+
+
+
+
print(smua.nvbuffer1.readings[1])
+
+
Output the first reading saved in source-measure unit (SMU) channel A, dedicated reading buffer 1.
When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the timestamp when each reading saved in the specified reading buffer occurred.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
timestamp = bufferVar.timestamps[N]
+
+
+
+
timestamp
+
+
The complete timestamp (including date, time, and fractional seconds) of reading number N in the specified reading buffer when the reading was acquired
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
N
+
+
The reading number (1 to bufferVar.n)
+
+
+
+
+
Details
+
The bufferVar.timestamps information from a reading buffer is only available if the bufferVar.collecttimestamps attribute is set to 1 (default setting). If it is set to 0, you cannot access any time information from a reading buffer.
+
If enabled, this buffer recall attribute is like an array (a Lua table) that contains timestamps, in seconds, of when each reading occurred. These are relative to the bufferVar.basetimestamp for the buffer.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
Example
+
+
+
+
timestamp = smua.nvbuffer1.timestamps[1]
+
+
+
Get the timestamp of the first reading stored in source-measure unit (SMU) A, buffer 1.
This function returns an iterator that can be used in a for loop to iterate over all the factory scripts.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
for name in script.factory.catalog() do body end
+
+
+
+
name
+
+
String representing the name of the script
+
+
+
+
body
+
+
Code that implements the body of the for loop to process the names in the catalog
+
+
+
+
+
Details
+
Accessing this catalog of scripts allows you to process the factory scripts. The entries will be enumerated in no particular order.
+
Each time the body of the function executes, name takes on the name of one of the factory scripts. The for loop repeats until all scripts have been iterated.
+
Example
+
+
+
+
for name in script.factory.catalog() do
+
print(name)
+
end
+
+
Retrieve the catalog listing for factory scripts.
+
+
+
+
+
Also see
+
None
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/2408.htm b/WebHelpDocs/2601B-PULSE/2408.htm
new file mode 100644
index 0000000..6b90ce9
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/2408.htm
@@ -0,0 +1,47 @@
+
+
+
+
+ Delete user scripts from the instrument
+
+
+
+
+
+
+
+
+
+
+
+
+
Delete user scripts from the instrument
+
In most circumstances, you can delete a script using script.delete() (as described in Delete user scripts), and then turn the instrument off and back on again. However, if you cannot turn the instrument off, you can use the following steps to completely remove a script from the instrument.
+
When you completely remove a script, you delete all references to the script from the runtime environment, the script.user.scripts table, and nonvolatile memory.
+
To completely remove a script:
+
Remove the script from the runtime environment. Set any variables that refer to the script to nil or assign the variables a different value. For example, to remove the script "beepTwoSec" from the runtime environment, send the following code: beepTwoSec = nil
Remove the script from the script.user.scripts table. Set the name attribute to an empty string (""). This makes the script nameless, but does not make the script become the anonymous script. For example, to remove the script named "beepTwoSec", send the following code: script.user.scripts.beepTwoSec.name = ""
Remove the script from nonvolatile memory. To delete the script from nonvolatile memory, send the command: script.delete("name")
Where name is the name that the script was saved as. For example, to delete "beepTwoSec", you would send: script.delete("beepTwoSec")
Sets the garbage-collection threshold to the given limit (in kilobytes) and checks it against the byte counter. If the new threshold is smaller than the byte counter, Lua immediately runs the garbage collector. If there is no limit parameter, it defaults to zero (0), which forces a garbage-collection cycle. See Lua memory management for more information.
+
+
+
+
gcinfo()
+
+
Returns the number of kilobytes of dynamic memory that the Test Script Processor (TSP®) scripting engine is using and returns the present garbage collector threshold (also in kilobytes). See Lua memory management for more information.
+
+
+
+
tonumber(x)
+
tonumber(x, base)
+
+
Returns x converted to a number. If x is already a number, or a convertible string, the number is returned; otherwise, it returns nil.
+
An optional argument specifies the base to use when interpreting the numeral. The base may be any integer from 2 to 36, inclusive. In bases above 10, the letter A (in either upper or lower case) represents 10, B represents 11, and so forth, with Z representing 35. In base 10, the default, the number may have a decimal part, as well as an optional exponent. In other bases, only unsigned integers are accepted.
+
+
+
+
tostring(x)
+
+
Receives an argument of any type and converts it to a string in a reasonable format.
+
+
+
+
type(v)
+
+
Returns (as a string) the type of its only argument. The possible results of this function are "nil" (a string, not the value nil), "number", "string", "boolean", "table", "function", "thread", and "userdata".
This attribute contains the name of a script in the runtime environment.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
No
+
+
Not applicable
+
+
Not applicable
+
+
Not applicable
+
+
+
+
+
Usage
+
scriptVar.name = "scriptName"
+
scriptName= scriptVar.name
+
+
+
+
scriptVar
+
+
Name of the variable that references the script
+
+
+
+
scriptName
+
+
A string that represents the name of the script
+
+
+
+
+
Details
+
When setting the script name, this attribute renames the script that the variable scriptVar references.
+
This attribute must be either a valid Lua identifier or the empty string. Changing the name of a script changes the index that is used to access the script in the script.user.scripts table. Setting the attribute to an empty string removes the script from the table completely, and the script becomes an unnamed script.
+
As long as there are variables referencing an unnamed script, the script can be accessed through those variables. When all variables that reference an unnamed script are removed, the script is removed from the runtime environment.
+
If the new name is the same as a name that is already used for another script, the name of the other script is set to an empty string, and that script becomes unnamed.
+
Changing the name of a script does not change the name of any variables that reference that script. The variables still reference the script, but the names of the script and variables may not match.
+
Example
+
+
+
+
test7 = script.new("display.clear() display.settext('Hello from my test')", "")
+
test7()
+
print(test7.name)
+
+
test7.name = "test7"
+
print(test7.name)
+
test7.save()
+
+
+
+
This example calls the script.new() function to create a script with no name, runs the script, names the script "test7", and then saves the script in nonvolatile memory.
The date and time (year, month, day, hour, and minute)
+
+
+
+
+
Details
+
The timespec is a table using the fields listed in the table below.
+
+
+
+
year
+
+
The year (1970 or later)
+
+
+
+
month
+
+
The month (1 to 12)
+
+
+
+
day
+
+
The day (1 to 31)
+
+
+
+
hour
+
+
The hour (00 to 23)
+
+
+
+
min
+
+
The minute (00 to 59)
+
+
+
+
sec
+
+
The second (00 to 59)
+
+
+
+
+
If the time (hour, minute, and second) options are not used, they default to noon for that day. When called without a parameter (the first form), the function returns the current time.
+
Set the time zone before calling the os.time() function.
+
Example
+
+
+
+
systemTime = os.time({year = 2019,
+
month = 3,
+
day = 31,
+
hour = 14,
+
min = 25})
+
settime(systemTime)
+
+
Sets the date and time to Mar 31, 2019 at 2:25 pm.
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/2601b-pulse_display_modes_lr.png b/WebHelpDocs/2601B-PULSE/2601b-pulse_display_modes_lr.png
new file mode 100644
index 0000000..7e01be5
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/2601b-pulse_display_modes_lr.png differ
diff --git a/WebHelpDocs/2601B-PULSE/2601b-pulse_pulser_display_modes_lr.png b/WebHelpDocs/2601B-PULSE/2601b-pulse_pulser_display_modes_lr.png
new file mode 100644
index 0000000..4290230
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/2601b-pulse_pulser_display_modes_lr.png differ
diff --git a/WebHelpDocs/2601B-PULSE/2651A_toc.xml b/WebHelpDocs/2601B-PULSE/2651A_toc.xml
new file mode 100644
index 0000000..e69de29
diff --git a/WebHelpDocs/2601B-PULSE/26898.htm b/WebHelpDocs/2601B-PULSE/26898.htm
new file mode 100644
index 0000000..ff6176f
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/26898.htm
@@ -0,0 +1,227 @@
+
+
+
+
+ digio.trigger[N].stimulus
+
+
+
+
+
+
+
+
+
+
+
+
+
digio.trigger[N].stimulus
+
This attribute selects the event that causes a trigger to be asserted on the digital output line.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Digital I/O trigger N reset Recall setup
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
triggerStimulus = digio.trigger[N].stimulus
+
digio.trigger[N].stimulus = triggerStimulus
+
+
+
+
triggerStimulus
+
+
The event identifier for the triggering event
+
+
+
+
N
+
+
Digital I/O trigger line (1 to 14)
+
+
+
+
+
Details
+
Set this attribute to zero (0) to disable the automatic trigger output.
+
Do not use the stimulus attribute for generating output triggers under script control. Use digio.trigger[N].assert() instead.
+
The trigger stimulus for a digital I/O linemay be set to one of the existing trigger event IDs, described in the following table.
+
+
+
Trigger event IDs*
+
+
+
+
Event ID
+
+
Event description
+
+
+
+
smua.trigger.SWEEPING_EVENT_ID
+
+
Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model
+
+
+
+
smua.trigger.ARMED_EVENT_ID
+
+
Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model
+
+
+
+
smua.trigger.SOURCE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a source action
+
+
+
+
smua.trigger.MEASURE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a measurement action
+
+
+
+
smua.trigger.PULSE_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a pulse
+
+
+
+
smua.trigger.SWEEP_COMPLETE_EVENT_ID
+
+
Occurs when the SMU completes a sweep
+
+
+
+
smua.trigger.IDLE_EVENT_ID
+
+
Occurs when the SMU returns to the idle state
+
+
+
+
digio.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a digital I/O line
+
+
+
+
tsplink.trigger[N].EVENT_ID
+
+
Occurs when an edge is detected on a TSP-Link line
+
+
+
+
lan.trigger[N].EVENT_ID
+
+
Occurs when the appropriate LXI trigger packet is received on LAN trigger object N
+
+
+
+
display.trigger.EVENT_ID
+
+
Occurs when the TRIG key on the front panel is pressed
+
+
+
+
trigger.EVENT_ID
+
+
Occurs when a *TRG command is received on the remote interface
+
GPIB only: Occurs when a GET bus command is received
+
USB only: Occurs when a USBTMC TRIGGER message is received
+
VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation
+
+
+
+
trigger.blender[N].EVENT_ID
+
+
Occurs after a collection of events is detected
+
+
+
+
trigger.timer[N].EVENT_ID
+
+
Occurs when a delay expires
+
+
+
+
trigger.generator[N].EVENT_ID
+
+
Occurs when the trigger.generator[N].assert() function is executed
+
+
+
+
* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
This function starts test scripts from a remote node.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes (see Details)
+
+
+
+
+
+
+
+
+
+
+
Usage
+
node[N].execute("scriptCode")
+
+
+
+
N
+
+
The node number of this instrument
+
+
+
+
scriptCode
+
+
A string containing the source code
+
+
+
+
+
Details
+
Only the remote master node can use the execute command to run a script on this node. This function does not run test scripts on the master node; only on this node when initiated by the master node.
+
This function may only be called when the group number of the node is different than the node of the master.
+
This function does not wait for the script to finish execution.
+
This command should only be used from a remote master when controlling this instrument over a TSP-Link®.
+
Example 1
+
+
+
+
node[2].execute(sourcecode)
+
+
Runs script code on node 2. The code is in a string variable called sourcecode.
+
+
+
+
+
Example 2
+
+
+
+
node[3].execute("x = 5")
+
+
Runs script code in string constant ("x = 5") to set x
+
equal to 5 on node 3.
+
+
+
+
+
Example 3
+
+
+
+
node[32].execute(TestDut.source)
+
+
Runs the test script stored in the variable TestDut
+
(previously stored on the master node) on node 32.
Use this function to directly trigger events from the command interface or a script. For example, you can trigger a sweep while the instrument is under script control.
This constant identifies the trigger event generated by the trigger event generator.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Constant
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
eventID = trigger.generator[N].EVENT_ID
+
+
+
+
eventID
+
+
The trigger event number
+
+
+
+
N
+
+
The generator number (1 or 2)
+
+
+
+
+
Details
+
This constant is an identification number that identifies events generated by this generator.
+
To have another trigger object respond to trigger events generated by this generator, set the other object's stimulus attribute to the value of this constant.
The status of the operation status trigger blender overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status trigger blender overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
A set bit value indicates that the specified trigger blender generated an action overrun.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
As an example, to set bit B1 of the operation status trigger blender overrun enable register, set status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16).
This attribute stores the status byte condition register.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
Not applicable
+
+
+
+
+
Usage
+
statusByte = status.condition
+
+
+
+
statusByte
+
+
The status byte; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
This attribute is used to read the status byte, which is returned as a numeric value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
The returned value can indicate one or more status events occurred. When an enabled status event occurs, a summary bit is set in this register to indicate the event occurrence.
+
The individual bits of this register have the following meanings:
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.MEASUREMENT_SUMMARY_BIT
+
status.MSB
+
Set summary bit indicates that an enabled measurement event has occurred.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
status.SYSTEM_SUMMARY_BIT
+
status.SSB
+
Set summary bit indicates that an enabled system event has occurred.
+
Bit B1 decimal value: 2
+
+
+
+
B2
+
+
status.ERROR_AVAILABLE
+
status.EAV
+
Set summary bit indicates that an error or status message is present in the Error Queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.QUESTIONABLE_SUMMARY_BIT
+
status.QSB
+
Set summary bit indicates that an enabled questionable event has occurred.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.MESSAGE_AVAILABLE
+
status.MAV
+
Set summary bit indicates that a response message is present in the Output Queue.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.EVENT_SUMMARY_BIT
+
status.ESB
+
Set summary bit indicates that an enabled standard event has occurred.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
status.MASTER_SUMMARY_STATUS
+
status.MSS
+
Request Service (RQS)/Master Summary Status (MSS). Depending on how it is used, bit B6 of the status byte register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit:
+
When using the GPIB, USB, or VXI-11 serial poll sequence of the 2601B-PULSE to obtain the status byte (serial poll byte), B6 is the RQS bit. The set bit indicates that the Request Service (RQS) bit of the status byte (serial poll byte) is set and a service request (SRQ) has occurred.
When using the status.condition register command or the *STB? common command to read the status byte, B6 is the MSS bit. Set bit indicates that an enabled summary bit of the status byte register is set.
Bit B6 decimal value: 64
+
+
+
+
B7
+
+
status.OPERATION_SUMMARY_BIT
+
status.OSB
+
Set summary bit indicates that an enabled operation event has occurred.
+
Bit B7 decimal value: 128
+
+
+
+
+
In addition to the above constants, when more than one bit of the register is set, statusByte equals the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).
+
+
+
+
Bit
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
Binary value
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
+
+
Decimal
+
+
128
+
+
64
+
+
32
+
+
16
+
+
8
+
+
4
+
+
2
+
+
1
+
+
+
+
Weights
+
+
(27)
+
+
(26)
+
+
(25)
+
+
(24)
+
+
(23)
+
+
(22)
+
+
(21)
+
+
(20)
+
+
+
+
+
Example
+
+
+
+
statusByte = status.condition
+
print(statusByte)
+
+
+
+
Returns statusByte.
+
Sample output:
+
1.29000e+02
+
Converting this output (129) to its binary equivalent yields 1000 0001
+
Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSS) and B7 (OSB).
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/3240.htm b/WebHelpDocs/2601B-PULSE/3240.htm
new file mode 100644
index 0000000..7ffe8a7
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/3240.htm
@@ -0,0 +1,45 @@
+
+
+
+
+ Using groups to manage nodes on TSP-Link network
+
+
+
+
+
+
+
+
+
+
+
+
+
Using groups to manage nodes on TSP-Link network
+
The primary purpose of groups is to allow each group to run a different test script simultaneously.
+
A group can consist of one or more nodes. You must assign group numbers to each node using remote commands. If you do not assign a node to a group, it defaults to group 0, which will always be grouped with the master node (regardless of the group to which the master node is assigned).
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/3247.htm b/WebHelpDocs/2601B-PULSE/3247.htm
new file mode 100644
index 0000000..83004c7
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/3247.htm
@@ -0,0 +1,48 @@
+
+
+
+
+ Using the data queue for real-time communication
+
+
+
+
+
+
+
+
+
+
+
+
+
Using the data queue for real-time communication
+
Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data. You can use the data queue to post numeric values, strings, and tables.
+
Use the data queue commands to:
+
Share data between test scripts running in parallel
Access data from a remote group or a local node on a TSP-Link® network at any time
You cannot access the reading buffers or global variables from any node in a remote group while a node in that group is performing an overlapped operation. However, you can use the data queue to retrieve data from any node in a group that is performing an overlapped operation. In addition, the master node and the group leaders can use the data queue to coordinate activities.
+
Tables in the data queue consume one entry. When a node stores a table in the data queue, a copy of the data in the table is made. When the data is retrieved from the data queue, a new table is created on the node that is retrieving the data. The new table contains a separate copy of the data in the original table, with no references to the original table or any subtables.
+
You can access data from the data queue even if a remote group or a node has overlapped operations in process. See the dataqueue commands in the TSP command reference for more information.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/3249.htm b/WebHelpDocs/2601B-PULSE/3249.htm
new file mode 100644
index 0000000..db05b37
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/3249.htm
@@ -0,0 +1,65 @@
+
+
+
+
+ Removing stale values from the reading buffer cache
+
+
+
+
+
+
+
+
+
+
+
+
+
Removing stale values from the reading buffer cache
+
The node that acquires the data also stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data.
+
When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale. If the values in the reading buffer change while the Lua code runs remotely, another node can hold stale values. Use the clearcache() command to clear the cache. For additional detail on the reading buffer cache commands, see bufferVar.cachemode and bufferVar.clearcache().
+
The following example code demonstrates how stale values occur and how to use the clearcache() command to clear the cache on node 2, which is part of group 7.
+
-- Create a reading buffer on a node in a remote group.
Test Script Processor (TSP®) enabled instruments do not have inherent query commands. Like any other scripting environment, the print() and printnumber() commands generate output in the form of response messages. Each print() command creates one response message.
+
Example
+
+
+
+
x = 10
+
print(x)
+
+
Example of an output response message:
+
10
+
Note that your output may be different if you set your ASCII precision setting to a different value.
Attribute-based commands are commands that set the characteristics of an instrument feature or operation. For example, a characteristic of TSP-enabled instruments is the model number (localnode.model).
+
Attributes can be read-only, read-write, or write-only. They can be used as a parameter of a function or assigned to another variable.
+
+
To set the characteristics, attribute-based commands define a value. For many attributes, the value is in the form of a number or a predefined constant.
+
Example 1: Set an attribute using a number
+
+
+
+
beeper.enable = 0
+
+
+
+
This attribute controls the beeps that occur when front-panel controls are selected. Setting this attribute to 0 turns off the beeper.
+
+
+
+
+
Example 2: Set an attribute using a constant
+
+
+
+
format.data = format.REAL64
+
+
+
+
Using the constant REAL64 sets the print format to double precision floating-point format.
+
+
+
+
+
+
+
To read an attribute, you can use the attribute as the parameter of a function, or assign it to another variable.
+
Example 3: Read an attribute using a function
+
+
+
+
print(format.data)
+
+
+
+
Reads the data format by passing the attribute to the print function. If the data format is set to 3, the output is:
+
3.00000e+00
+
This shows that the data format is set to double precision floating point.
+
+
+
+
+
Example 4: Read an attribute using a variable
+
+
+
+
fd = format.data
+
+
+
+
This reads the data format by assigning the attribute to a variable named fd.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/6500_toc.xml b/WebHelpDocs/2601B-PULSE/6500_toc.xml
new file mode 100644
index 0000000..e69de29
diff --git a/WebHelpDocs/2601B-PULSE/6510_toc.xml b/WebHelpDocs/2601B-PULSE/6510_toc.xml
new file mode 100644
index 0000000..e69de29
diff --git a/WebHelpDocs/2601B-PULSE/66559.htm b/WebHelpDocs/2601B-PULSE/66559.htm
new file mode 100644
index 0000000..6f2d771
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/66559.htm
@@ -0,0 +1,99 @@
+
+
+
+
+ lan.config.dns.hostname
+
+
+
+
+
+
+
+
+
+
+
+
+
lan.config.dns.hostname
+
This attribute defines the dynamic DNS host name.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Not applicable
+
+
Nonvolatile memory
+
+
Instrument specific (see Details)
+
+
+
+
+
Usage
+
hostName = lan.config.dns.hostname
+
lan.config.dns.hostname = "hostName"
+
+
+
+
hostName
+
+
The host name to use for dynamic DNS registration; the host name must:
+
be a string of 63 characters or less
start with a letter
end with a letter or digit
contain only letters, digits, and hyphens
+
+
+
+
Details
+
This attribute holds the host name to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the host name specified in this attribute with the DNS server.
+
The factory default value for hostName is "k-<model number>-<serial number>", where <model number> and <serial number> are replaced with the actual model number and serial number of the instrument (for example, "k-2601B-PULSE-1234567"). Note that hyphens separate the characters of hostName.
+
The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters. Although up to 63 characters can be entered here, care must be taken to be sure the combined length is no more than 255 characters.
+
Setting this attribute to an empty string (in other words, setting this attribute to a string of length zero, or one consisting entirely of whitespace characters) will revert the host name to the factory default value.
This function recalls settings from a saved setup.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
setup.recall(id)
+
+
+
+
id
+
+
An integer or string that specifies the location of the setup to recall:
+
Factory default setup: 0
User-saved setup in nonvolatile memory: 1 to 5
User-saved setup on a USB flash drive: "/path/filename"
+
+
+
+
Details
+
When the id parameter is an integer (n), it is interpreted as the setup number to restore from the instrument's nonvolatile memory. When n = 0, the instrument recalls the factory default setup; when n = 1 to 5, the instrument recalls a user-saved setup.
+
When the id parameter is a string, it is interpreted as the path and file name of the setup to restore from a file on a USB flash drive. The path may be absolute or relative to the current working directory.
+
Before a setup is recalled, an instrument reset is performed.
+
Example 1
+
+
+
+
setup.recall(1)
+
+
Recall the user-saved setup at location 1.
+
+
+
+
+
Example 2
+
+
+
+
setup.recall("/usb1/KEITHLEY_30730.set")
+
+
Recall a user-saved setup stored in a file named KEITHLEY_30730 on a USB flash drive.
Use the functions in this group to store and retrieve user-defined strings in nonvolatile memory. These strings are stored as key-value pairs. The key is a unique identifier such as a part number or identification string.
+
You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.
The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations).
+
The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low). See the pinout diagram in Digital I/O port for additional information.
+
There are commands to read and write to each individual bit, and commands to read and write to the entire port.
Beginning index of the buffer to print; this must be more than one and less than endIndex
+
+
+
+
endIndex
+
+
Ending index of the buffer to print; this must be more than startIndex and less than the index of the last entry in the tables
+
+
+
+
bufferVar
+
+
First table or reading buffer subtable to print
+
+
+
+
bufferVar2
+
+
Second table or reading buffer subtable to print
+
+
+
+
bufferVarN
+
+
The last table or reading buffer subtable to print
+
+
+
+
...
+
+
One or more tables or reading buffer subtables separated with commas
+
+
+
+
+
Details
+
If startIndex ≤ 1, 1 is used as startIndex. If n < endIndex, n is used as endIndex.
+
When any given reading buffers are used in overlapped commands that have not yet completed (at least to the specified index), this function outputs data as it becomes available.
+
When there are outstanding overlapped commands to acquire data, n refers to the index that the last entry in the table has after all the measurements have completed.
+
If you pass a reading buffer instead of a reading buffer subtable, the default subtable for that reading buffer is used.
+
This command generates a single response message that contains all data. The response message is stored in the output queue.
+
The format.data attribute controls the format of the response message.
+
Example
+
+
+
+
format.data = format.ASCII
+
format.asciiprecision = 6
+
printbuffer(1, rb1.n, rb1)
+
+
+
+
This assumes that rb1 is a valid reading buffer in the runtime environment. The use of rb1.n
+
(bufferVar.n) indicates that the instrument should output all readings in the reading buffer. In this example, rb1.n equals 10.
This attribute specifies the pulse measurement aperture when the pulser is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
0.000001
+
+
+
+
+
Usage
+
aperture = smua.pulser.measure.aperture
+
smua.pulser.measure.aperture = aperture
+
+
+
+
aperture
+
+
The measurement aperture; set from 0.000001 s to 0.1 s
+
+
+
+
+
Details
+
When using this attribute with the trigger model or in a pulse-width limited region, the sum of the measure delay and the total measure time must be less than the pulse width. The total measure time depends on the measure count, the filter count, and the measure interval.
+
The settings for this attribute are ignored if the pulser is disabled.
This attribute sets the measurement delay when the pulser is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
0
+
+
+
+
+
Usage
+
delay = smua.pulser.measure.delay
+
smua.pulser.measure.delay = delay
+
+
+
+
delay
+
+
The measurement delay value in seconds; set from 0 to 0.065
+
+
+
+
+
Details
+
Use this attribute with the trigger model when performing a pulse sweep.
+
Set the delay parameter to a nonzero value to specify when a measurement starts during a pulse. The measurement starts after the delay interval expires. This allows the 2601B-PULSE to locate measurements within a pulse with less jitter than those generated using the measure trigger stimulus in the trigger model.
+
The sum of the measure delay and the total measure time must be less than the pulse width configured with the smua.trigger.source.pulsewidth setting. The total measure time depends on the measure count, the filter count, and the measure interval.
+
You cannot use this attribute and a measurement stimulus in the trigger model at the same time.
+
Using both the end-pulse stimulus and this attribute in a script may cause the pulse output to end before the specified duration of the pulse is completed, causing invalid measurements.
+
When this attribute is set to zero, measurements are only triggered by a measurement stimulus.
+
The settings for this attribute are ignored if the pulser is disabled.
+
Example
+
+
+
+
smua.pulser.measure.delay = 35e-6
+
smua.pulser.measure.aperture = 10e-6
+
+
+
+
Specify a 35 µs pulse measure delay and a 10 µs measurement aperture.
This attribute enables or disables the 2601B-PULSE pulser.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
smua.DISABLE
+
+
+
+
+
Usage
+
enable = smua.pulser.enable
+
smua.pulser.enable = enable
+
+
+
+
enable
+
+
Enable or disable the pulser; set to:
+
smua.DISABLE: Conventional pulsing and full source-measure unit (SMU) functionality
smua.ENABLE: Allow fast-edge pulsing using the trigger model
+
+
+
+
Details
+
When the pulser is enabled, there are the following differences in source-measure unit (SMU) functionality:
+
You can only source current (not voltage).
If the output exceeds a maximum pulse width, maximum duty cycle, or the specified protection level during a sweep, the 2601B-PULSE output is shorted, but the sweep continues with no source output until it is finished.
The smua.trigger.source.pulsewidth and smua.pulser.measure.delay attributes provide more precise timing than you can achieve using the smua.trigger.endpulse.stimulus and smua.trigger.measure.stimulus attributes.
Some of the output-off modes behave differently:
OUTPUT_NORMAL: The output circuit is shorted when this output-off mode is selected.
OUTPUT_ZERO: The output circuit is shorted and current cannot be measured when this output-off mode is selected.
You cannot use contact check.
You cannot make measurements when the output is off.
This attribute sets a voltage protection level used to monitor the sense terminals when the pulser is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
20 V
+
+
+
+
+
Usage
+
level = smua.pulser.protect.sensev
+
smua.pulser.protect.sensev = level
+
+
+
+
level
+
+
The voltage protection level when the pulser is enabled; the value must be between 5% and 200% of the voltage range set by the smua.pulser.rangeY attribute
+
+
+
+
+
Details
+
If the voltage on the sense terminals goes above the protection level, the 2601B-PULSE output is shorted for the remainder of the sweep and the output turns off at the end of the sweep.
+
The current pulse terminates within 3 µs after the remotely sensed voltage from the device under test (DUT) exceeds the specified level.
+
Setting the protection level does not guarantee that the output will not go above the protection level. The 2601B-PULSE turns off the output as quickly as possible, but the voltage level can briefly exceed this level, potentially causing damage to the device under test (DUT).
+
The settings for this attribute are ignored if the pulser is disabled.
This attribute indicates if the protection circuit was tripped.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Instrument reset SMU reset
+
+
None
+
+
Not applicable
+
+
+
+
+
Usage
+
tripped = smua.pulser.protect.tripped
+
+
+
+
tripped
+
+
The voltage protection status:
+
true: The protection circuit was tripped
false: The protection circuit was not tripped
+
+
+
+
Details
+
When the pulser is enabled, this attribute indicates if the protection circuit was tripped. When the protection circuit is tripped, the output is shorted and turned off.
+
The following events can trip the protection circuit:
+
A voltage greater than smua.pulser.protect.sensev was detected on the sense terminals.
A voltage greater than smua.pulser.protect.sourcev was detected on the force terminals.
The maximum pulse width was exceeded during trigger model operation.
The maximum duty cycle was exceeded during trigger model operation.
If the SMU cannot keep up with the pulse rate.
If the SMU cannot keep up with the measurement rate.
The status is reset to false when the pulser is disabled or when the output is turned on.
This attribute sets the source and measure ranges when the pulser is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
Current: 10 A Voltage: 10 V
+
+
+
+
+
Usage
+
range = smua.pulser.rangei
+
range = smua.pulser.rangev
+
smua.pulser.rangei = range
+
smua.pulser.rangev = range
+
+
+
+
range
+
+
The source and measure range
+
+
+
+
+
Details
+
When you set a value for the range, the 2601B-PULSE automatically sets the range as appropriate for the specified value.
+
This attribute setting affects the settings that are allowed for the smua.pulser.protect.sensev attribute, which must be between 5 percent and 200 percent of the voltage range.
+
The following table lists the pulser limits for the voltage and current functions.
+
+
+
Voltage range
+
+
Source
+
+
Measure
+
+
+
+
5 V
+
+
Not applicable
+
+
5.1 V
+
+
+
+
10 V
+
+
Not applicable
+
+
10.2 V
+
+
+
+
Current ranges
+
+
+
+
+
+
+
+
1 A
+
+
±1.01 A
+
+
±1.02 A
+
+
+
+
5 A
+
+
±5.05 A
+
+
±5.1 A
+
+
+
+
10 A
+
+
±10.1 A
+
+
±10.2 A
+
+
+
+
250 mA (DC bias)
+
+
±250 mA
+
+
Selected pulse measure range
+
+
+
+
+
The settings for this attribute are ignored if the pulser is disabled.
This attribute sets the source pulse width when using a trigger model sweep when the pulser is enabled
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
0
+
+
+
+
+
Usage
+
pulsewidth = smua.trigger.source.pulsewidth
+
smua.trigger.source.pulsewidth = pulsewidth
+
+
+
+
pulsewidth
+
+
The source pulse width in seconds; set from 0.000001 to 0.065; set to 0 to disable automatic pulsewidth control
+
+
+
+
+
Details
+
Use this attribute only when generating pulses using the trigger model when the pulser is enabled.
+
Set the pulsewidth parameter to a nonzero value to limit the action of the source to the specified pulse width. This allows the 2601B-PULSE to generate pulses with less pulsewidth jitter than those generated using the end-pulse trigger block in the trigger model.
+
The value set for this attribute affects the values you can use for the smua.pulser.measure.aperture and smu.pulser.measure.delay attributes. The sum of the measure delay and the aperture must be less than the specified pulse width.
+
You cannot use this attribute and smua.trigger.endpulse.action in the same trigger model.
The measurement function (v = voltage, i = current)
+
+
+
+
cp1Measured
+
+
The value measured by this SMU for point 1
+
+
+
+
cp1Reference
+
+
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Measured
+
+
The value measured by this SMU for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
This function generates and activates new calibration constants for the given range.
+
The positive and negative polarities of the instrument must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity.
+
Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.
+
The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is only available when calibration is unlocked using smua.cal.unlock().
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Expected
+
+
The source value set for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
The positive and negative polarities must be adjusted separately. To adjust the positive polarity, use the +250e-3 range; to adjust the negative polarity, use the -250e-3 range.
+
Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.
+
The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is only available when calibration is unlocked using smua.cal.unlock().
Adjusts the bias source calibration constant for the 250e-3 pulser range using 1e-10 as the source value and 1e-5 for the reference measurement for point 1 and 0.224 as the source value and 0.225 as the reference measurement for point 2.
The reference measurement for point 1 as measured externally
+
+
+
+
cp2Expected
+
+
The source value set for point 2
+
+
+
+
cp2Reference
+
+
The reference measurement for point 2 as measured externally
+
+
+
+
+
Details
+
This function generates and activates new calibration constants for the given range.
+
Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.
+
The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.
+
This function is only available when calibration is unlocked using smua.cal.unlock().
Generates and activates new source calibration constants for the pulser 1 A range. For point 1, it uses 1e-10 as the source value and 1e-5 as the reference measurement. For point 2, it uses 0.9 for the source value and 0.903 for the reference measurement.
Set to the measurement delay value in seconds (for example, to specify an additional 10 ms measurement delay, set the value to 0.010)
+
You can also set it to one of the following values:
+
0 or smua.DELAY_OFF: No delay
-1 or smua.DELAY_AUTO: Automatic delay value
+
+
+
+
Details
+
This attribute allows for additional delay (settling time) before making a measurement. If you define the value instead of using the automatic delay value, the delay you set is used regardless of the range.
+
The smua.DELAY_AUTO setting causes a current range-dependent delay to be inserted when a current measurement is requested. This happens when a current measurement command is executed, when the measure action is being performed in a sweep, or after changing ranges during an autoranged measurement.
+
If smua.measure.count is greater than 1, the measurement delay is only inserted before the first measurement.
This attribute contains the selected display screen.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset Recall setup
+
+
Saved setup
+
+
0 (display.SMUA)
+
+
+
+
+
+
Usage
+
displayID = display.screen
+
display.screen = displayID
+
+
+
+
displayID
+
+
One of the following values:
+
0 or display.SMUA: Displays source-measure and compliance values
3 or display.USER: Displays the user screen
+
+
+
+
Details
+
Setting this attribute selects the display screen for the front panel. This performs the same action as pressing the DISPLAY key on the front panel. The text for the display screen is set by display.settext().
+
Read this attribute to determine which of the available display screens was last selected.
+
Example
+
+
+
+
display.screen = display.SMUA
+
+
Selects the source-measure and compliance limit display.
Set to the maximum expected voltage or current to be sourced
+
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute contains a value that sets the source-measure unit (SMU) to a fixed range large enough to source the value. When read, the attribute contains the range the instrument is presently on when in autorange.
+
Assigning a value to this attribute sets the SMU to a fixed range large enough to source the assigned value. The instrument selects the best range for sourcing a value of rangeValue.
+
Reading this attribute returns the positive full-scale value of the source range the SMU is currently using. With source autoranging enabled, the output level controls the range. Querying the range after the level is set returns the range the instrument chose as appropriate for that source level.
+
This attribute is primarily intended to eliminate the time required by the automatic range selection performed by a sourcing instrument. Because selecting a fixed range prevents autoranging, an overrange condition can occur. For example, sourcing 10.0 V on the 2601B-PULSE 6 V range causes an overrange condition.
This attribute contains the positive full-scale value of the measurement range for voltage or current.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
Voltage: 100e-3 (100 mV) Current: 100e-3 (100 mA)
+
+
+
+
+
Usage
+
rangeValue = smua.measure.rangeY
+
smua.measure.rangeY = rangeValue
+
+
+
+
rangeValue
+
+
Set to the maximum expected voltage or current to be measured
+
+
+
+
Y
+
+
SMU measurement function (v = voltage, i = current)
+
+
+
+
+
Details
+
Reading this attribute returns the positive full-scale value of the measurement range that the SMU is currently using. Assigning a value to this attribute sets the SMU on a fixed range large enough to measure the assigned value. The instrument will select the best range for measuring a value of rangeValue.
+
This attribute is primarily intended to eliminate the time that is required by the automatic range selection performed by a measuring instrument. Because selecting a fixed range prevents autoranging, an overrange condition can occur. For example, measuring 10.0 V on the 6 V range causes an overrange. The value 9.91000E+37 is returned when this occurs.
+
If the source function is the same as the measurement function (for example, sourcing voltage and measuring voltage), the measurement range is locked to be the same as the source range. However, the setting for the measure range is retained. If the source function is changed (for example, from sourcing voltage to sourcing current), the retained measurement range is used.
+
For example, assume the source function is voltage. The source range is 1 V and you set the measure range for 6 V. Since the source range is 1 V, the SMU performs voltage measurements on the 1 V range. If you now change the source function to current, voltage measurements are made on the 6 V range.
+
Explicitly setting a measure range will disable measure autoranging for that function. Autoranging is controlled separately for each source and measurement function: source voltage, source current, measure voltage and measure current. Autoranging is enabled for all four by default.
+
Changing the range while the output is off does not update the hardware settings, but querying returns the range setting that will be used once the output is turned on. Setting a range while the output is on takes effect immediately.
+
With measure autoranging enabled, the range is changed only when a measurement is taken. Querying the range after a measurement returns the range selected for that measurement.
If there are no entries in the queue, code 0, "Queue is Empty" is returned.
+
Returned severity levels are described in the following table.
+
+
+
+
Number
+
+
Error level
+
+
Description
+
+
+
+
0
+
+
NO_SEVERITY
+
+
The message is information only. This level is used when the Error Queue is empty; the message does not represent an error.
+
+
+
+
10
+
+
INFORMATIONAL
+
+
The message is information only. This level is used to indicate status changes; the message does not represent an error.
+
+
+
+
20
+
+
RECOVERABLE
+
+
The error was caused by improper use of the instrument or by conditions that can be corrected. This message indicates that an error occurred. The instrument is still operating normally.
+
+
+
+
30
+
+
SERIOUS
+
+
There is a condition that prevents the instrument from functioning properly. The message indicates that the instrument is presently operating in an error condition. If the condition is corrected, the instrument will return to normal operation.
+
+
+
+
40
+
+
FATAL
+
+
There is a condition that cannot be corrected that prevents the instrument from functioning properly. Disconnect the DUT and turn the power off and then on again. If the error is a hardware fault that persists after cycling the power, the instrument must be repaired.
+
+
+
+
+
In an expanded system, each TSP-Link enabled instrument is assigned a node number.The variable errorNode stores the node number where the error originated.
+
Example
+
+
+
+
errorcode, message = errorqueue.next()
+
print(errorcode, message)
+
+
Reads the oldest entry in the error queue. The output below indicates that the queue is empty.
This attribute sets the lowest measurement range that is used when the instrument is autoranging.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
Current: 100e-9 (100 nA) Voltage: 100e-3 (100 mV)
+
+
+
+
+
Usage
+
lowRange = smua.measure.lowrangeY
+
smua.measure.lowrangeY = lowRange
+
+
+
+
lowRange
+
+
The lowest voltage or current measurement range used during autoranging
+
+
+
+
Y
+
+
SMU measure function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute is used with autoranging to put a lower bound on the range used. Since lower ranges generally require greater settling times, setting a lowest range limit might make measurements require less settling time.
+
If the instrument is set to autorange and it is on a range lower than the one specified, the range is changed to the lowRange range value.
Set to the source settling mode. Set to one of the following values:
+
0 or smua.SETTLE_SMOOTH: Turns off additional settling operations (default)
1 or smua.SETTLE_FAST_RANGE: Instructs the source-measure unit (SMU) to use a faster procedure when changing ranges
2 or smua.SETTLE_FAST_POLARITY: Instructs the SMU to change polarity without going to zero
3 or smua.SETTLE_DIRECT_IRANGE: Instructs the SMU to change the current range directly
128 or smua.SETTLE_FAST_ALL: Enables all smua.SETTLE_FAST_* operations
+
+
+
+
Details
+
Using smua.SETTLE_FAST_RANGE may cause the SMU to exceed the range change overshoot specification.
+
smua.SETTLE_FAST_POLARITY does not go to zero when changing polarity and may create inconsistencies at the zero crossing.
+
smua.SETTLE_DIRECT_IRANGE switches the SMU directly to the target range instead of the default range-by-range method. This option is mutually exclusive of any other smua.SETTLE_FAST_* commands.
This attribute sets the lowest source range that is used during autoranging.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
Voltage: 100e-3 (100 mV) Current: 100e-9 (100 nA)
+
+
+
+
+
Usage
+
sourceRangeLow = smua.source.lowrangeY
+
smua.source.lowrangeY = sourceRangeLow
+
+
+
+
sourceRangeLow
+
+
Set to the lowest voltage (in volts) or current (in amperes) range to be used
+
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute is used with source autoranging to put a lower bound on the range that is used. Lower ranges generally require greater settling times. If you set a low-range value, you might be able to source small values with less settling time.
+
If the instrument is set to autorange and it is on a range lower than the one specified by sourceRangeLow, the source range will be changed to the range specified by sourceRangeLow.
+
Example
+
+
+
+
smua.source.lowrangev = 1
+
+
Sets the voltage low range to 1 V. This prevents the source from using the 100 mV range when sourcing voltage.
The compliance limit value; set to one of the following values:
+
Voltage compliance: 10 mV to 40 V
Current compliance: 10 nA to 3 A
Power compliance (in watts)
+
+
+
Y
+
+
SMU function (v = voltage, i = current, p = power)
+
+
+
+
+
Details
+
Use the smua.source.limiti attribute to limit the current output of the voltage source. Use smua.source.limitv to limit the voltage output of the current source. The SMU always uses autoranging for the limit setting. Use the smua.source.limitp attribute to limit the output power of the source.
+
This attribute should be set in the test sequence before the turning the source on.
+
Using a limit value of 0 results in error code 1102, "Parameter too small," for v and i. Setting this attribute to zero disables power compliance for p. When setting the power compliance limit to a nonzero value, the SMU adjusts the source limit where appropriate to limit the output to the specified power. The SMU uses the lower of the programmed compliance value (the compliance level that would be used if power compliance were disabled) or the limit calculated from the power compliance setting.
+
Reading this attribute indicates the presently set compliance value. Use smua.source.compliance to read the state of source compliance.
The source value; set to one of the following values:
+
Voltage: 0 V to ±40 V
Current when the pulser is disabled: 0 A to ±3 A
Bias current when the pulser is enabled: 0 A to ±250 mA
+
+
+
Y
+
+
SMU source function (v = voltage, i = current)
+
+
+
+
+
Details
+
This attribute configures the output level of the voltage or current source.
+
If the source is configured as a voltage source and the output is on, the new smua.source.levelv setting is sourced immediately. If the output is off or the source is configured as a current source, the voltage level is sourced when the source is configured as a voltage source and the output is turned on.
+
If the source is configured as a current source and the output is on, the new smua.source.leveli setting is sourced immediately. If the output is off or the source is configured as a voltage source, the current level is sourced when the source is configured as a current source and the output is turned on.
+
The sign of sourceLevel dictates the polarity of the source. Positive values generate positive voltage or current from the high terminal of the source relative to the low terminal. Negative values generate negative voltage or current from the high terminal of the source relative to the low terminal.
+
The reset() function sets the source levels to 0 V and 0 A.
The status of the measurement event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes read or write the measurement event registers.
+
Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For example, assume value 257 is returned for the enable register. The binary equivalent is 0000 0001 0000 0001. This value indicates that bit B0 (VLMT) and bit B8 (BAV) are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.measurement.VOLTAGE_LIMIT
+
status.measurement.VLMT
+
Set bit is a summary of the status.measurement.voltage_limit register.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
status.measurement.CURRENT_LIMIT
+
status.measurement.ILMT
+
Set bit is a summary of the status.measurement.current_limit register.
+
Bit B1 decimal value: 2
+
+
+
+
B2
+
+
Not used
+
+
+
+
B3
+
+
status.measurement.PROTECTION
+
status.measurement.PROT
+
Set bit indicates that the pulser protection was tripped. Refer to smua.pulser.protect.tripped for events that can trip the protection circuits.
+
Bit B1 decimal value: 8
+
+
+
+
B4 to B6
+
+
Not used
+
+
+
+
B7
+
+
status.measurement.READING_OVERFLOW
+
status.measurement.ROF
+
Set bit is a summary of the status.measurement.reading_overflow register.
+
Bit B7 decimal value: 128
+
+
+
+
B8
+
+
status.measurement.BUFFER_AVAILABLE
+
status.measurement.BAV
+
Set bit is a summary of the status.measurement.buffer_available register.
+
Bit B8 decimal value: 256
+
+
+
+
B9 to B10
+
+
Not used
+
+
+
+
B11
+
+
status.measurement.INTERLOCK
+
status.measurement.INT
+
Interlock line. Set bit indicates that interlock is asserted.
+
Bit B11 decimal value: 2,048
+
+
+
+
B12
+
+
Not used
+
+
+
+
B13
+
+
status.measurement.INSTRUMENT_SUMMARY
+
status.measurement.INST
+
Set bit indicates that a bit in the measurement instrument summary register is set.
+
Bit B13 decimal value: 8,192
+
+
+
+
B14 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B8 of the measurement event enable register, set status.measurement.enable = status.measurement.BAV.
+
In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set. To set more than one bit of the register, set measurementRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set measurementRegister to 258 (which is the sum of 2 + 256).
This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values. The following examples show typical uses of italicized text:
+
Example 1:
+
beeper.enable = state
+
Where state can be a value (beeper.ON or beeper.OFF) or an integer (1 or 0) that you specify. For example, to set this attribute on, you would send one of the following commands:
+
beeper.enable = beeper.ON
+
beeper.enable = 1
+
Example 2:
+
digio.trigger[N].assert()
+
Where N is an integer (1 to 14) that you specify. For example, to assert trigger line 7 you would send:
+
digio.trigger[7].assert()
+
To assert a trigger line with a variable as the integer, you would send:
+
triggerline = 7
+
digio.trigger[triggerline].assert()
+
Example 3:
+
smua.trigger.measure.Y(rbuffer)
+
Where:
+
Y is the measurement type that you specify (v, i, r, or p).
rbuffer is the reading buffer object where the readings will be stored.
For example, to make voltage measurements and store them in buffer vbuffername, you would send:
This function determines if contact resistance is lower than the threshold.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
smua.contact.check()
+
Details
+
Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser. See Example 1: Ten-point pulse sweep for a code example.
+
This function returns true if the contact resistance is below the threshold; this function returns false if it is above the threshold. The threshold value is set by the smua.contact.threshold attribute.
+
When the output is on and any of the following:
+
SMU is a current source with current range set to less than 1 mA (error code 5065, "I range too low for contact check")
SMU is a voltage source with current limit set to less than 1 mA (error code 5050, "I limit too low for contact check")
When the output is off and any of the following:
+
The output off mode is High-Z (error code 5048, "Contact check not valid with HIGH-Z OUTPUT off")
The output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCVOLTS and the off current limit set to less than 1 mA (error code 5066, "source.offlimiti too low for contact check")
The output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCAMPS and the source range is less than 1 mA (error code 5065, "I range too low for contact check")
If you attempt to perform a contact check measurement when any of the above conditions exist, an error is generated.
This attribute stores the speed setting for contact check measurements.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Not saved
+
+
0 (smua.CONTACT_FAST)
+
+
+
+
+
Usage
+
speedSetting = smua.contact.speed
+
smua.contact.speed = speedSetting
+
+
+
+
speedSetting
+
+
The speed setting. Set to one of the following:
+
0 or smua.CONTACT_FAST
1 or smua.CONTACT_MEDIUM
2 or smua.CONTACT_SLOW
+
+
+
+
Details
+
This setting controls the aperture of measurements made for contact check. It does not affect the smua.measure.nplc aperture setting.
+
The speed setting can have a dramatic effect on the accuracy of the measurement (see the specifications).
+
Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.
This attribute stores the resistance threshold for the smua.contact.check() function.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Not saved
+
+
50 (50 Ω)
+
+
+
+
+
Usage
+
rValue = smua.contact.threshold
+
smua.contact.threshold = rValue
+
+
+
+
rValue
+
+
The resistance above which contact check should fail (measured in ohms)
+
+
+
+
+
Details
+
The threshold should be set to less than 1 kΩ.
+
Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.
The output-off setting; set to one of the following values:
+
0 or smua.OUTPUT_NORMAL: See Details
1 or smua.OUTPUT_ZERO: See Details
2 or smua.OUTPUT_HIGH_Z: Opens the output relay when the output is turned off
+
+
+
+
+
Details
+
Reading this attribute returns the output-off mode of the source. Setting this attribute configures the SMU output-off mode.
+
When smua.OUTPUT_NORMAL is selected and the pulser is disabled, the source function is configured according to the smua.source.offfunc attribute. The smua.source.offfunc attribute controls whether the SMU is configured as a 0 V voltage source or a 0 A current source. When the SMU is operating as a 0 A current source, the smua.source.offlimitv attribute sets the voltage limit (similar to how the smua.source.offlimiti attribute sets the current limit when the SMU is operating as a 0 V voltage source).
+
When the output-off mode is set to smua.OUTPUT_ZERO and the pulser is disabled, the source is configured to output 0 V. This is equivalent to smua.OUTPUT_NORMAL mode with smua.source.offfunc = smua.OUTPUT_DCVOLTS. If the source function is voltage, the current limit is not changed. If the source function is current, the current limit is set to the current source level or 10% of the current source range, whichever is greater.
+
When smua.OUTPUT_NORMAL or smua.OUTPUT_ZERO is selected and the pulser is enabled, the output circuit is shorted.
+
When sourceOffMode is set to smua.OUTPUT_HIGH_Z, the SMU opens the output relay when the output is turned off. To prevent excessive wear on the output relay, do not use this output-off mode for tests that turn the output off and on frequently.
+
Example
+
+
+
+
smua.source.offmode = smua.OUTPUT_HIGH_Z
+
+
+
+
Sets the output-off mode to open the output relay when the output is turned off.
This attribute sets an absolute voltage protection level used to monitor the force terminals when the pulser is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
40 V
+
+
+
+
+
Usage
+
level = smua.pulser.protect.sourcev
+
smua.pulser.protect.sourcev = level
+
+
+
+
level
+
+
The absolute voltage protection level when the pulser is enabled; 2 V to 40 V
+
+
+
+
+
Details
+
If the voltage on the force terminals goes above the protection level, the 2601B-PULSE automatically turns off the output.
+
The absolute voltage protection level ignores normal transients during the pulse rise and fall time.
+
The current pulse terminates within 3 µs after the remotely sensed voltage from the device under test (DUT) exceeds the specified level.
+
Setting the protection level does not guarantee that the output will not go above the protection level. The 2601B-PULSE turns off the output as quickly as possible, but the voltage level can briefly exceed this level, potentially causing damage to the device under test (DUT).
+
The settings for this attribute are ignored if the pulser is disabled.
This attribute enables or disables pulse sweeps when the pulser is disabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Not saved
+
+
1 (smua.SOURCE_HOLD)
+
+
+
+
+
Usage
+
pulseAction = smua.trigger.endpulse.action
+
smua.trigger.endpulse.action = pulseAction
+
+
+
+
pulseAction
+
+
The pulse mode setting; set to one of the following values (see Details for definition):
+
0 or smua.SOURCE_IDLE
1 or smua.SOURCE_HOLD
+
+
+
+
Details
+
When set to smua.SOURCE_HOLD, this attribute disables pulse mode sweeps, holding the source level for the remainder of the step.
+
When set to smua.SOURCE_IDLE, this attribute enables pulse mode sweeps, setting the source level to the programmed (idle) level at the end of the pulse.
+
You cannot use this attribute and smua.trigger.source.pulsewidth in the same trigger model.
+
When the pulser is enabled, this setting is ignored. The source level is set to the programmed idle level at the end of the pulse.
This function sends a code that simulates the action of a front-panel control.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
display.sendkey(keyCode)
+
+
+
+
keyCode
+
+
A parameter that specifies the key press to simulate; see Details for more information
+
+
+
+
+
Details
+
This command simulates pressing a front-panel key or navigation wheel, or turning the navigation wheel one click to the left or right.
+
+
+
+
Key codes
+
+
+
+
Value
+
+
Key list
+
+
+
+
Value
+
+
Key list
+
+
+
+
65
+
+
display.KEY_RANGEUP
+
+
+
+
85
+
+
display.KEY_RECALL
+
+
+
+
68
+
+
display.KEY_MENU
+
+
+
+
86
+
+
display.KEY_MEASA
+
+
+
+
69
+
+
display.KEY_MODEA
+
+
+
+
87
+
+
display.KEY_DIGITSA
+
+
+
+
70
+
+
display.KEY_RELA
+
+
+
+
88
+
+
display.KEY_OUTPUTA
+
+
+
+
71
+
+
display.KEY_RUN
+
+
+
+
92
+
+
display.KEY_TRIG
+
+
+
+
72
+
+
display.KEY_DISPLAY
+
+
+
+
93
+
+
display.KEY_LIMITA
+
+
+
+
73
+
+
display.KEY_AUTO
+
+
+
+
94
+
+
display.KEY_SPEEDA
+
+
+
+
75
+
+
display.KEY_EXIT
+
+
+
+
95
+
+
display.KEY_LOAD
+
+
+
+
77
+
+
display.KEY_FILTERA
+
+
+
+
97
+
+
display.WHEEL_ENTER
+
+
+
+
78
+
+
display.KEY_STORE
+
+
+
+
103
+
+
display.KEY_RIGHT
+
+
+
+
79
+
+
display.KEY_SRCA
+
+
+
+
104
+
+
display.KEY_LEFT
+
+
+
+
80
+
+
display.KEY_CONFIG
+
+
+
+
107
+
+
display.WHEEL_LEFT
+
+
+
+
81
+
+
display.KEY_RANGEDOWN
+
+
+
+
114
+
+
display.WHEEL_RIGHT
+
+
+
+
82
+
+
display.KEY_ENTER
+
+
+
+
+
+
+
+
+
+
+
When using this function, send built-in constants, such as display.KEY_RIGHT, rather than the numeric value, such as 103. This allows for better forward compatibility with firmware revisions.
This function retrieves the key code for the last pressed key.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
keyCode = display.getlastkey()
+
+
+
+
keyCode
+
+
A returned value that represents the last front-panel key pressed; see Details for more information
+
+
+
+
+
Details
+
A history of the key code for the last pressed front-panel key is maintained by the instrument. When the instrument is turned on, or when it is transitioning from local to remote operation, the key code is set to 0 (display.KEY_NONE).
+
Pressing the EXIT (LOCAL) key normally aborts a script. To use this function with the EXIT (LOCAL) key, you must set display.locallockout to display.LOCK.
+
The table below lists the keyCode value for each front-panel action.
+
+
+
+
Key codes
+
+
+
+
Value
+
+
Key list
+
+
+
+
Value
+
+
Key list
+
+
+
+
0
+
+
display.KEY_NONE
+
+
+
+
82
+
+
display.KEY_ENTER
+
+
+
+
65
+
+
display.KEY_RANGEUP
+
+
+
+
85
+
+
display.KEY_RECALL
+
+
+
+
68
+
+
display.KEY_MENU
+
+
+
+
86
+
+
display.KEY_MEASA
+
+
+
+
69
+
+
display.KEY_MODEA
+
+
+
+
87
+
+
display.KEY_DIGITSA
+
+
+
+
70
+
+
display.KEY_RELA
+
+
+
+
92
+
+
display.KEY_TRIG
+
+
+
+
71
+
+
display.KEY_RUN
+
+
+
+
93
+
+
display.KEY_LIMITA
+
+
+
+
72
+
+
display.KEY_DISPLAY
+
+
+
+
94
+
+
display.KEY_SPEEDA
+
+
+
+
73
+
+
display.KEY_AUTO
+
+
+
+
95
+
+
display.KEY_LOAD
+
+
+
+
75
+
+
display.KEY_EXIT
+
+
+
+
97
+
+
display.WHEEL_ENTER
+
+
+
+
77
+
+
display.KEY_FILTERA
+
+
+
+
103
+
+
display.KEY_RIGHT
+
+
+
+
78
+
+
display.KEY_STORE
+
+
+
+
104
+
+
display.KEY_LEFT
+
+
+
+
79
+
+
display.KEY_SRCA
+
+
+
+
107
+
+
display.WHEEL_LEFT
+
+
+
+
80
+
+
display.KEY_CONFIG
+
+
+
+
114
+
+
display.WHEEL_RIGHT
+
+
+
+
81
+
+
display.KEY_RANGEDOWN
+
+
+
+
+
+
+
+
+
+
+
When using this function, use built-in constants such as display.KEY_RIGHT (rather than the numeric value of 103). This will allow for better forward compatibility with firmware revisions.
+
You cannot use this function to track the OUTPUT ON/OFF control.
+
Example
+
+
+
+
key = display.getlastkey()
+
print(key)
+
+
On the front panel, press the MENU key and then send the code shown here. This retrieves the key code for the last pressed key.
This function captures the key code value for the next front-panel action.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
keyCode = display.waitkey()
+
+
+
+
keyCode
+
+
See Details for more information
+
+
+
+
+
Details
+
After you send this function, script execution pauses until a front-panel action (for example, pressing a key or the navigation wheel , or turning the navigation wheel ). After the action, the value of the key (or action) is returned.
+
If the EXIT (LOCAL) key is pressed while this function is waiting for a front-panel action, the script is not aborted.
+
A typical use for this function is to prompt the user to press the EXIT (LOCAL) key to abort the script or press any other key to continue. For example, if the keyCode value 75 is returned (the EXIT (LOCAL)key was pressed), you can call the exit() function to abort the script.
+
The table below lists the keyCode values for each front panel action.
+
+
+
+
Key codes
+
+
+
+
Value
+
+
Key list
+
+
+
+
Value
+
+
Key list
+
+
+
+
65
+
+
display.KEY_RANGEUP
+
+
+
+
85
+
+
display.KEY_RECALL
+
+
+
+
68
+
+
display.KEY_MENU
+
+
+
+
86
+
+
display.KEY_MEASA
+
+
+
+
69
+
+
display.KEY_MODEA
+
+
+
+
87
+
+
display.KEY_DIGITSA
+
+
+
+
70
+
+
display.KEY_RELA
+
+
+
+
88
+
+
display.KEY_OUTPUTA
+
+
+
+
71
+
+
display.KEY_RUN
+
+
+
+
92
+
+
display.KEY_TRIG
+
+
+
+
72
+
+
display.KEY_DISPLAY
+
+
+
+
93
+
+
display.KEY_LIMITA
+
+
+
+
73
+
+
display.KEY_AUTO
+
+
+
+
94
+
+
display.KEY_SPEEDA
+
+
+
+
75
+
+
display.KEY_EXIT
+
+
+
+
95
+
+
display.KEY_LOAD
+
+
+
+
77
+
+
display.KEY_FILTERA
+
+
+
+
97
+
+
display.WHEEL_ENTER
+
+
+
+
78
+
+
display.KEY_STORE
+
+
+
+
103
+
+
display.KEY_RIGHT
+
+
+
+
79
+
+
display.KEY_SRCA
+
+
+
+
104
+
+
display.KEY_LEFT
+
+
+
+
80
+
+
display.KEY_CONFIG
+
+
+
+
107
+
+
display.WHEEL_LEFT
+
+
+
+
81
+
+
display.KEY_RANGEDOWN
+
+
+
+
114
+
+
display.WHEEL_RIGHT
+
+
+
+
82
+
+
display.KEY_ENTER
+
+
+
+
+
+
+
+
+
+
+
When using this function, send built-in constants, such as display.KEY_RIGHT, rather than the numeric value, such as 103. This allows for better forward compatibility with firmware revisions.
+
Example
+
+
+
+
key = display.waitkey()
+
print(key)
+
+
+
+
Pause script execution until the operator presses a key or the navigation wheel , or rotates the navigation wheel.
This attribute stores the service request (SRQ) enable register.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Status reset
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
requestSRQEnableRegister = status.request_enable
+
status.request_enable = requestSRQEnableRegister
+
+
+
+
requestSRQEnableRegister
+
+
The status of the service request (SRQ) enable register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
This attribute is used to read or write to the service request enable register. Reading the service request enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.MEASUREMENT_SUMMARY_BIT
+
status.MSB
+
Set summary bit indicates that an enabled event in the Measurement Event Register has occurred.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
status.SYSTEM_SUMMARY_BIT
+
status.SSB
+
Set summary bit indicates that an enabled event in the System Summary Register has occurred.
+
Bit B1 decimal value: 2
+
+
+
+
B2
+
+
status.ERROR_AVAILABLE
+
status.EAV
+
Set summary bit indicates that an error or status message is present in the error queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.QUESTIONABLE_SUMMARY_BIT
+
status.QSB
+
Set summary bit indicates that an enabled event in the Questionable Status Register has occurred.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.MESSAGE_AVAILABLE
+
status.MAV
+
Set summary bit indicates that a response message is present in the output queue.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.EVENT_SUMMARY_BIT
+
status.ESB
+
Set summary bit indicates that an enabled event in the Standard Event Status Register has occurred.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
Not used
+
+
+
+
B7
+
+
status.OPERATION_SUMMARY_BIT
+
status.OSB
+
Set summary bit indicates that an enabled event in the Operation Status Register has occurred.
+
Bit B7 decimal value: 128
+
+
+
+
+
As an example, to set bit B0 of the service request enable register, set status.request_enable = status.MSB.
+
In addition to the above values, requestSRQEnableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set requestSRQEnableRegister to the sum of their decimal values. For example, to set bits B0 and B7, set requestSRQEnableRegister to 129 (1 + 128).
This attribute stores the service request (SRQ) event register.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
Not saved
+
+
0
+
+
+
+
+
Usage
+
requestSRQEventRegister = status.request_event
+
+
+
+
requestSRQEventRegister
+
+
The status of the request event register; a zero (0) indicates no bits set; other values indicate various bit settings
+
+
+
+
+
Details
+
This attribute is used to read the service request event register, which is returned as a numeric value. Reading this register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.
+
+
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
The returned value can indicate one or more status events occurred.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
status.MEASUREMENT_SUMMARY_BIT
+
status.MSB
+
Set summary bit indicates that an enabled event in the Measurement Event Register has occurred.
+
Bit B0 decimal value: 1
+
+
+
+
B1
+
+
status.SYSTEM_SUMMARY_BIT
+
status.SSB
+
Set summary bit indicates that an enabled event in the System Summary Register has occurred.
+
Bit B1 decimal value: 2
+
+
+
+
B2
+
+
status.ERROR_AVAILABLE
+
status.EAV
+
Set summary bit indicates that an error or status message is present in the error queue.
+
Bit B2 decimal value: 4
+
+
+
+
B3
+
+
status.QUESTIONABLE_SUMMARY_BIT
+
status.QSB
+
Set summary bit indicates that an enabled event in the Questionable Status Register has occurred.
+
Bit B3 decimal value: 8
+
+
+
+
B4
+
+
status.MESSAGE_AVAILABLE
+
status.MAV
+
Set summary bit indicates that a response message is present in the output queue.
+
Bit B4 decimal value: 16
+
+
+
+
B5
+
+
status.EVENT_SUMMARY_BIT
+
status.ESB
+
Set summary bit indicates that an enabled event in the Standard Event Status Register has occurred.
+
Bit B5 decimal value: 32
+
+
+
+
B6
+
+
Not used
+
+
+
+
B7
+
+
status.OPERATION_SUMMARY_BIT
+
status.OSB
+
Set summary bit indicates that an enabled event in the Operation Status Register has occurred.
+
Bit B7 decimal value: 128
+
+
+
+
+
In addition to the above constants, requestEventRegister can be set to the decimal value of the bits set. When more than one bit of the register is set, requestEventRegister contains the sum of their decimal values. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).
+
+
+
+
Bit
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
Binary value
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
0/1
+
+
+
+
Decimal
+
+
128
+
+
64
+
+
32
+
+
16
+
+
8
+
+
4
+
+
2
+
+
1
+
+
+
+
Weights
+
+
(27)
+
+
(26)
+
+
(25)
+
+
(24)
+
+
(23)
+
+
(22)
+
+
(21)
+
+
(20)
+
+
+
+
+
Example
+
+
+
+
requestEventRegister = status.request_event
+
print(requestEventRegister)
+
+
+
+
Reads the status request event register.
+
Sample output:
+
1.29000e+02
+
Converting this output (129) to its binary equivalent yields 1000 0001.
+
Therefore, this output indicates that the set bits of the status request event register are presently B0 (MSB) and B7 (OSB).
The status of the questionable status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.22880e+04 (which is 12,288) is read as the value of the condition register, the binary equivalent is 0011 0000 0000 0000. This value indicates that bits B12 and B13 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
1
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0 to B7
+
+
Not used
+
+
+
+
B8
+
+
status.questionable.CALIBRATION
+
status.questionable.CAL
+
An enabled bit in the questionable status calibration summary event register is set.
+
Bit B6 decimal value: 256
+
+
+
+
B9
+
+
status.questionable.UNSTABLE_OUTPUT
+
status.questionable.UO
+
An enabled bit in the questionable status unstable output summary event register is set.
+
Bit B9 decimal value: 512
+
+
+
+
B10
+
+
Not used
+
+
+
+
B11
+
+
Not used
+
+
+
+
B12
+
+
status.questionable.OVER_TEMPERATURE
+
status.questionable.OTEMP
+
An enabled bit in the questionable status over temperature summary event register is set.
+
Bit B12 decimal value: 4,096
+
+
+
+
B13
+
+
status.questionable.INSTRUMENT_SUMMARY
+
status.questionable.INST
+
An enabled bit in the questionable status instrument summary event register is set.
+
Bit B13 decimal value: 8,192
+
+
+
+
B14 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B9 of the questionable status enable register, set status.questionable.enable = status.questionable.UO.
+
In addition to the above constants, questionableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal values. For example, to set bits B12 and B13, set questionableRegister to 12,288 (which is the sum of 4,096 + 8,192).
The status of the instrument measurement status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, assume the value 257 is returned for the enable register. The binary equivalent is 0000 0001 0000 0001. This value indicates that bit B0 (VLMT) and bit B8 (BAV) are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0*
+
+
status.measurement.instrument.smua.VOLTAGE_LIMIT
+
status.measurement.instrument.smua.VLMT
+
Set bit indicates that the voltage limit was exceeded.
+
Bit B0 decimal value: 1
+
+
+
+
B1*
+
+
status.measurement.instrument.smua.CURRENT_LIMIT
+
status.measurement.instrument.smua.ILMT
+
Set bit indicates that the current limit was exceeded.
+
Bit B1 decimal value: 2
+
+
+
+
B2
+
+
Not used
+
+
+
+
B3
+
+
status.measurement.instrument.smua.PROTECTION
+
status.measurement.instrument.smua.PROT
+
Set bit indicates that the pulser protection was tripped. Refer to smua.pulser.protect.tripped for events that can trip the protection circuits.
Set bit indicates that there is at least one reading stored in either or both dedicated reading buffers.
+
Bit B8 decimal value: 256
+
+
+
+
B9 to B15
+
+
Not used
+
+
+
+
* This bit is updated only when a measurement is made or smua.source.compliance is invoked.
+
+
+
+
+
As an example, to set bit B0 of the measurement event SMU A summary enable register, set status.measurement.instrument.smua.enable= status.measurement.instrument.smua.VLMT.
+
In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set. To set more than one bit of the register, set measurementRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set measurementRegister to 258 (which is the sum of 2 + 256).
The status of the questionable status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status instrument SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 7.68000e+02 (which is 768) is read as the value of the condition register, the binary equivalent is 0000 0011 0000 0000. This value indicates that bit B8 and bit B9 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0 to B7
+
+
Not used
+
+
+
+
B8
+
+
status.questionable.instrument.smua.CALIBRATION
+
status.questionable.instrument.smua.CAL
+
Set bit indicates that the calibration constants stored in nonvolatile memory were corrupted and could not be loaded when the instrument powered up.
Set bit indicates that an over temperature condition was detected.
+
Bit B12 decimal value: 4,096
+
+
+
+
B13 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B8 of the questionable status SMU A summary enable register, set status.questionable.instrument.smua.enable = status.questionable.instrument.smua.CAL.
+
In addition to the above constants, questionableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal values. For example, to set bits B8 and B9, set questionableRegister to 768 (which is the sum of 256 + 512).
This attribute contains the status values of readings in the reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Clearing the buffer
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
statusInformation = bufferVar.statuses[N]
+
+
+
+
statusInformation
+
+
The status value when reading N of the specified buffer was acquired
+
+
+
+
bufferVar
+
+
The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer
+
+
+
+
N
+
+
The reading number N; can be any value from 1 to the number of readings in the buffer; use the bufferVar.n command to determine the number of readings in the buffer
+
+
+
+
+
Details
+
This read-only buffer recall attribute is like an array (a Lua table) of the status values for all the readings in the buffer. The status values are floating-point numbers that encode the status value; see the following table for values.
+
For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.
+
+
+
Buffer status bits
+
+
+
+
Bit
+
+
Name
+
+
Hex
+
+
Description when bit is true
+
+
+
+
B0
+
+
Pulser
+
+
0x01
+
+
Pulser is enabled
+
+
+
+
B1
+
+
Overtemp
+
+
0x02
+
+
Overtemperature condition
+
+
+
+
B2
+
+
AutoRangeMeas
+
+
0x04
+
+
Measure range was autoranged
+
+
+
+
B3
+
+
AutoRangeSrc
+
+
0x08
+
+
Source range was autoranged
+
+
+
+
B4
+
+
4Wire
+
+
0x10
+
+
4-wire (remote) sense mode enabled
+
+
+
+
B5
+
+
Rel
+
+
0x20
+
+
Relative offset applied to reading
+
+
+
+
B6
+
+
Compliance
+
+
0x40
+
+
Source function was limited because the complementary function would be over the compliance limit
+
+
+
+
B7
+
+
Filtered
+
+
0x80
+
+
Reading was filtered
+
+
+
+
+
Example
+
+
+
+
reset()
+
smua.source.func = smua.OUTPUT_DCVOLTS
+
smua.source.autorangev = smua.AUTORANGE_ON
+
smua.source.levelv = 5
+
smua.source.limiti = 10e-3
+
smua.measure.rangei = 10e-3
+
smua.source.output = smua.OUTPUT_ON
+
print(smua.measure.i(smua.nvbuffer1))
+
smua.source.output = smua.OUTPUT_OFF
+
+
print(smua.nvbuffer1.statuses[1])
+
+
+
+
Reset the instrument.
+
Set the voltage source function to DC volts. Set the range to auto.
+
Set the voltage source to 5 V.
+
Set current measure limit to 10 mA.
+
Set the current measure range to 10 mA.
+
Turn on the output.
+
Print and place the current reading in the reading buffer.
+
Turn off the output.
+
Output status value of the first measurement in the reading buffer.
This attribute contains a dedicated reading buffer.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (R)
+
+
Yes
+
+
Not applicable
+
+
See Details
+
+
Not applicable
+
+
+
+
+
Usage
+
bufferVar = smua.nvbufferY
+
+
+
+
bufferVar
+
+
The dedicated reading buffer
+
+
+
+
Y
+
+
Nonvolatile buffer (1 or 2)
+
+
+
+
+
Details
+
The SMU contains two dedicated reading buffers: smua.nvbuffer1 and smua.nvbuffer2.
+
All routines that return measurements can also store them in either reading buffer. Overlapped measurements are always stored in a reading buffer. Synchronous measurements return either a single-point measurement or can be stored in a reading buffer if passed to the measurement command.
+
The dedicated reading buffers can be saved to internal nonvolatile memory (to retain data between power cycles) using the smua.savebuffer() function.
+
Example
+
+
+
+
smua.measure.overlappedv(smua.nvbuffer1)
+
+
+
+
Store voltage readings into dedicated reading buffer 1.
This function measures aggregate contact resistance.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Function
+
+
Yes
+
+
+
+
+
+
+
+
+
+
+
Usage
+
rhi, rlo = smua.contact.r()
+
+
+
+
rhi
+
+
The measured aggregate contact resistance on the HI/sense HI side
+
+
+
+
rlo
+
+
The measured aggregate contact resistance on the LO/sense LO side
+
+
+
+
+
Details
+
If you attempt to perform a contact resistance measurement when any of the following conditions exist, an error is generated.
+
When the output is on and SMU is a current source with current range set to less than 1 mA
When the output is on and SMU is a voltage source with current limit set to less than 1 mA
When the output is off and the output off mode is High-Z
When the output is off and the output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCVOLTS and the off current limit set to less than 1 mA
When the output is off and the output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCAMPS and the source range is less than 1 mA
When the pulser is enabled (smua.pulser.enable attribute is set to smua.ENABLE)
Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.
This attribute sets the source function that is used (source 0 A or 0 V) when the output is turned off and the source-measure unit (SMU) is in normal output-off mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
1 (smua.OUTPUT_DCVOLTS)
+
+
+
+
+
Usage
+
offfunc = smua.source.offfunc
+
smua.source.offfunc = offfunc
+
+
+
+
offfunc
+
+
Set to the source function to be used when the output is off and the SMU is in normal output-off mode. Set to one of the following values:
+
0 or smua.OUTPUT_DCAMPS: Source 0 A
1 or smua.OUTPUT_DCVOLTS: Source 0 V
+
+
+
+
Details
+
This attribute controls the source function used when the output is turned off and smua.source.offmode is set to smua.OUTPUT_NORMAL.
+
Set this attribute to smua.OUTPUT_DCVOLTS for the source to be a 0 V source when the output is off (smua.source.offlimiti is used).
+
Set it to smua.OUTPUT_DCAMPS for the source to be a 0 A source when the output is off (smua.source.offlimitv is used).
+
If the pulser is enabled and the output-off mode is set to normal, the smua.source.offfunc setting is ignored and the output circuit is shorted.
+
Example
+
+
+
+
smua.source.offmode = smua.OUTPUT_NORMAL
+
smua.source.offfunc = smua.OUTPUT_DCVOLTS
+
+
+
+
Sets the normal output-off mode to source 0 V when the output is turned off.
The status of the measurement event protection summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event protection summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.protection.SMUA
+
Set bit indicates one of the pulser protection circuits have tripped.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.
This command sets the type of filter used for measurements when the measurement filter is enabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
1 (smua.FILTER_REPEAT_AVG)
+
+
+
+
+
Usage
+
filterType = smua.measure.filter.type
+
smua.measure.filter.type = filterType
+
+
+
+
filterType
+
+
The filter type to use when filtering is enabled. Set to one of the following values:
+
0 or smua.FILTER_MOVING_AVG: Selects the moving filter
1 or smua.FILTER_REPEAT_AVG: Selects the repeat filter
2 or smua.FILTER_MEDIAN: Selects the median filter
+
+
+
+
Details
+
The 2601B-PULSE provides a moving average, repeating average, and median filter type.
+
For the repeating filter, the stack (filter count) is filled, and the conversions are averaged to yield a reading. The stack is then cleared, and the process starts over.
+
The moving average filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the measurement conversions are averaged, yielding a reading. For each subsequent conversion placed into the stack, the oldest conversion is discarded. The stack is re-averaged, yielding a new reading.
+
The median filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the reading nearest to the middle is returned. For each subsequent conversion placed into the stack, the oldest reading is discarded. The stack is then re-sorted, yielding a new reading. If the filter count is an even number, the reading returned is the average of the two middle readings.
+
If the pulser is enabled, the repeating filter is the only available filter.
This attribute sets the interval between multiple measurements.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
0 (0 s)
+
+
+
+
+
Usage
+
interval = smua.measure.interval
+
smua.measure.interval = interval
+
+
+
+
interval
+
+
The interval value (in seconds); set to a value between 0 and 1
+
+
+
+
+
+
Details
+
This attribute sets the time interval between measurements when smua.measure.count is set to a value greater than 1.
+
The SMU attempts to start each measurement when scheduled. When the pulser is disabled, if the SMU cannot keep up with the interval setting, measurements are made as quickly as possible. When the pulser is enabled and the trigger model is not configured for asynchronous measurements, if the SMU cannot keep up with the interval setting, it aborts the sweep and turns the output off.
+
If filtered measurements are being made, the time interval is from the start of the first measurement for the filtered reading to the first measurement for a subsequent filtered reading. Extra measurements made to satisfy a filtered reading are not paced by this interval.
+
When the measure count is greater than 1 and the pulser is enabled, this must be less than 65 ms.
This attribute sets the number of measurements made when a measurement is requested.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
1
+
+
+
+
+
Usage
+
count = smua.measure.count
+
smua.measure.count = count
+
+
+
+
count
+
+
Number of measurements
+
+
+
+
+
Details
+
This attribute controls the number of measurements made any time a measurement is requested. When using a reading buffer with a measure command, this attribute also controls the number of readings to be stored.
+
If the count is set to a value greater than 1, any measurement delay set by smua.measure.delay only occurs before the first measurement, while the smua.measure.interval controls the interval between successive measurements.
+
When the pulser is enabled and measurements are not overlapped, this attribute must be less than 3500.
The status of the questionable status unstable output summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid value is 2
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status unstable output summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.questionable.unstable_output.SMUA
+
Set bit indicates that an unstable output condition was detected on SMU A.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the questionable status unstable output summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA.
+
In addition to the above constant, questionableRegister can be set to the decimal value of the bit to set.
The status of the questionable status over temperature summary register; a zero (0) indicates no bits set (also send 0 to clear all bits)
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status over temperature summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates if a register bit is set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.questionable.over_temperature.SMUA
+
Set bit indicates that an over temperature condition was detected on SMU A.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the questionable status over temperature summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA. You can also set the bit to its decimal value.
The status of the questionable status instrument summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid setting is 2
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bit is set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.questionable.instrument.SMUA
+
Set bit indicates one or more enabled bits for the SMU A questionable register are set.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the questionable status instrument summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA.
+
In addition to the constant, questionableRegister can be set to the decimal value of the bit.
The status of the measurement reading overflow summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event reading overflow summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, assume the value 2 is returned for the enable register. The binary equivalent is 0000 0000 0000 0010. This value indicates that bit B1 (SMUA) is set.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.reading_overflow.SMUA
+
Set bit indicates that an overflow reading has been detected for SMU A.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.
The status of the measurement voltage limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other decimal values indicate various bit settings
+
+
+
+
+
Details
+
These attributes read or write to the measurement event voltage limit summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.voltage_limit.SMUA
+
Set bit indicates the enabled VLMT bit for the SMU A measurement register is set.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.
The status of the operation calibrating event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.calibrating.SMUA
+
Set bit indicates that SMU A is unlocked for calibration.
The status of the operation event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1,026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.instrument.SMUA
+
Set bit indicates one or more enabled bits for the operation status SMU A summary register is set.
+
Bit B1 decimal value: 2
+
+
+
+
B2 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.instrument.TRIGGER_BLENDER
+
status.operation.instrument.TRGBLND
+
Set bit indicates one or more enabled bits for the operation status trigger blender summary register is set.
+
Bit B10 decimal value: 1,024.
+
+
+
+
B11
+
+
status.operation.instrument.TRIGGER_TIMER
+
status.operation.instrument.TRGTMR
+
Set bit indicates one or more enabled bits for the operation status trigger timer summary register is set.
+
Bit B11 decimal value: 2,048
+
+
+
+
B12
+
+
status.operation.instrument.DIGITAL_IO
+
status.operation.instrument.DIGIO
+
Set bit indicates one or more enabled bits for the operation status digital I/O summary register is set.
+
Bit B12 decimal value: 4,096
+
+
+
+
B13
+
+
status.operation.instrument.TSPLINK
+
Set bit indicates one or more enabled bits for the operation status TSP-Link summary register is set.
+
Bit B13 decimal value: 8,192
+
+
+
+
B14
+
+
status.operation.instrument.LAN
+
Set bit indicates one or more enabled bits for the operation status LAN summary register is set.
+
Bit B14 decimal value: 16,384
+
+
+
+
B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the operation status instrument summary enable register, set status.operation.instrument.enable= status.operation.instrument.SMUA.
+
In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024).
The status of the operation status measuring summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid value is 2
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status measuring summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.measuring.SMUA
+
Bit is set when SMU A is taking an overlapped measurement, but it is not set when taking a normal synchronous measurement.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
In addition to the above constants, operationRegister can be set to the decimal equivalent of the bit to set.
The status of the questionable status calibration summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the questionable status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.questionable.calibration.SMUA
+
Set bit indicates that the SMU A calibration constants stored in nonvolatile memory were corrupted and could not be loaded when the instrument powered up.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the questionable status calibration summary enable register, set status.questionable.calibration.enable = status.questionable.calibration.SMUA.
+
In addition to the above constants, questionableRegister can be set to 2, the decimal value of the B1 bit.
The status of the operation status trigger overrun summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status trigger overrun summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1,026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.
+
+
+
+
B15
+
+
B14
+
+
B13
+
+
B12
+
+
B11
+
+
B10
+
+
B9
+
+
B8
+
+
B7
+
+
B6
+
+
B5
+
+
B4
+
+
B3
+
+
B2
+
+
B1
+
+
B0
+
+
+
+
**
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
>
+
+
*
+
+
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
0
+
+
1
+
+
0
+
+
+
+
+
* Least significant bit ** Most significant bit
+
The bits in this register summarize events in other registers. A set bit in this summary register indicates that an enabled event in one of the summarized registers is set.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.trigger_overrun.SMUA
+
Set bit indicates one of the enabled bits in the operation status SMU A trigger overrun event register is set.
+
Bit B1 decimal value: 2
+
+
+
+
B2 to B9
+
+
Not used
+
+
+
+
B10
+
+
status.operation.trigger_overrun.TRIGGER_BLENDER
+
status.operation.trigger_overrun.TRGBLND
+
Set bit indicates one of the enabled bits in the operation status trigger blender overrun event register is set.
+
Bit B10 decimal value: 1,024
+
+
+
+
B11
+
+
status.operation.trigger_overrun.TRIGGER_TIMER
+
status.operation.trigger_overrun.TRGTMR
+
Set bit indicates one of the enabled bits in the operation status trigger timer overrun event register is set.
+
Bit B11 decimal value: 2,048
+
+
+
+
B12
+
+
status.operation.trigger_overrun.DIGITAL_IO
+
status.operation.trigger_overrun.DIGIO
+
Set bit indicates one of the enabled bits in the operation status digital I/O overrun event register is set.
+
Bit B12 decimal value: 4,096
+
+
+
+
B13
+
+
status.operation.trigger_overrun.TSPLINK
+
Set bit indicates one of the enabled bits in the operation status TSP-Link overrun event register is set.
+
Bit B13 decimal value: 8,192
+
+
+
+
B14
+
+
status.operation.trigger_overrun.LAN
+
Set bit indicates one of the enabled bits in the operation status LAN trigger overrun event register is set.
+
Bit B14 decimal value: 16,384
+
+
+
+
B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the operation status trigger overrun summary enable register, set status.operation.trigger_overrun.enable = status.operation.trigger_overrun.SMUA.
+
In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024).
The status of the operation status sweeping summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the operation status sweeping summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.operation.sweeping.SMUA
+
Set bit indicates that SMU A is sweeping.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the operation status sweeping summary enable register, set status.operation.sweeping.enable=status.operation.sweeping.SMUA.
+
In addition to the above constants, operationRegister can be set to 2, the decimal value of Bit 1.
The status of the measurement event instrument summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.instrument.SMUA
+
Set bit indicates one or more enabled bits of the measurement event SMU A summary register is set.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the measurement event instrument summary enable register, set status.measurement.instrument.enable = status.measurement.instrument.SMUA.
+
In addition to the constant, measurementRegister can be set to the decimal value of bit B1.
The status of the measurement event current limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event current limit summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.current_limit.SMUA
+
Set bit indicates that the SMU A current limit was exceeded.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the measurement event current limit summary enable register, set status.measurement.current_limit.enable = status.measurement.current_limit.SMUA.
+
In addition to the above constants, measurementRegister can be set to the decimal value of Bit B1.
The status of the measurement event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings
+
+
+
+
+
Details
+
These attributes are used to read or write to the measurement event buffer available summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.
+
For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.
+
+
+
+
Bit
+
+
Value and description
+
+
+
+
B0
+
+
Not used
+
+
+
+
B1
+
+
status.measurement.buffer_available.SMUA
+
Set bit indicates that there is at least one reading stored in either or both of the dedicated reading buffers.
+
Bit B1 decimal value: 2
+
Binary value: 0000 0010
+
+
+
+
B2 to B15
+
+
Not used
+
+
+
+
+
As an example, to set bit B1 of the measurement event buffer available summary enable register, set status.measurement.buffer_available.enable = status.measurement.buffer_available.SMUA.
+
In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.
This attribute contains the state of the sense mode.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
SMU reset Instrument reset Recall setup
+
+
Saved setup
+
+
0 (smua.SENSE_LOCAL)
+
+
+
+
+
Usage
+
senseMode = smua.sense
+
smua.sense = senseMode
+
+
+
+
senseMode
+
+
The sense mode; set to one of the following:
+
0 or smua.SENSE_LOCAL: Selects local sense (2-wire)
1 or smua.SENSE_REMOTE: Selects remote sense (4-wire)
3 or smua.SENSE_CALA: Selects calibration sense mode
+
+
+
+
+
Details
+
You can do source-measure operations using either 2-wire local sense connections or 4-wire remote sense connections.
+
When the pulser is enabled, the instrument always uses 4-wire remote sensing. The setting of smua.sense is ignored.
+
You can change the sense mode between local and remote while the output is on.
+
The smua.SENSE_CALA mode is only used for calibration and may only be selected when calibration is enabled. The calibration sense mode cannot be selected while the output is on.
The polarity to use for measurements. Set to one of the following values:
+
0 or smua.CAL_AUTO: Automatic polarity detection
1 or smua.CAL_POSITIVE: Measure with positive polarity calibration constants
2 or smua.CAL_NEGATIVE: Measure with negative polarity calibration constants
+
+
+
+
Details
+
This attribute controls which polarity calibration constants are used to make all subsequent measurements.
+
This attribute does not affect the smua.measure.calibrateY() and smua.pulser.measure.calibrateY() commands. The polarity for the measure calibrate commands is dictated by their range parameters. The measure calibration commands require the measurements provided to have been made using the polarity being calibrated.
+
When making measurements for points far away from zero, the desired polarity constants are inherently used. However, when making measurements near zero, it is possible that the instrument could use the calibration constants from the wrong polarity. Setting smua.cal.polarity to positive or negative forces measurements to be made using the calibration constants for a given polarity, rather than basing the choice on the raw measurement data.
+
This attribute can only be set to positive or negative when calibration is unlocked. This attribute is automatically set to smua.CAL_AUTO when calibration is locked.
+
Example
+
+
+
+
smua.cal.polarity = smua.CAL_POSITIVE
+
+
+
+
Selects positive calibration constants for all subsequent measurements.
Triggering allows you to capture measurements when an input signal or combination of input signals meet a set of conditions that you set. See Sweep operation for details on sweeping.
SMU measurement function (v = voltage, i = current, r = resistance, p = power)
+
+
+
+
sourceValue
+
+
Source value to be set after the measurement is made
+
+
+
+
iReading
+
+
The current reading before stepping the source
+
+
+
+
vReading
+
+
The voltage reading before stepping the source
+
+
+
+
+
Details
+
The smua.measureYandstep() function makes a measurement and then sets the source to sourceValue. The smua.measureivandstep() function makes two measurements simultaneously, one for current (i) and one for voltage (v), and then sets the source to sourceValue.
+
Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.
+
The specified source value should be appropriate for the selected source function. For example, if the source voltage function is selected, then sourceValue is expected to be a new voltage level.
+
Both source and measure autorange must be disabled before using this function. This function cannot be used if source high capacitance mode is enabled (high capacitance mode requires autoranging to be enabled).
+
This function is provided for very fast execution of source-measure loops. The measurement is made before the source is stepped. Before using this function, and before any loop this function may be used in, set the source value to its initial level.
+
This function is not available when the pulser is enabled.
+
Example
+
+
+
+
local ivalues = {}
+
smua.source.rangev = 1
+
smua.source.levelv = 0
+
smua.measure.rangei = 0.01
+
smua.source.output = smua.OUTPUT_ON
+
for index = 1, 10 do
+
ivalues[index] = smua.measureiandstep(index / 10)
+
end
+
ivalues[11] = smua.measure.i()
+
+
+
+
This use of the measure and step function measures current, starting at a source value of 0 V. After each current measurement, the source is stepped 100 mV for the next current measurement. The final source level is 1 V, where current is measured again.
This command sets the integration aperture for measurements when the pulser is disabled.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
1.0
+
+
+
+
+
Usage
+
nplc = smua.measure.nplc
+
smua.measure.nplc = nplc
+
+
+
+
nplc
+
+
The integration aperture; set from 0.001 to 25
+
+
+
+
+
+
Details
+
This attribute controls the integration aperture for the analog-to-digital converter (ADC) that is used when the pulser is disabled.
+
The integration aperture is based on the number of power line cycles (NPLC), where 1 PLC for 60 Hz is 16.67 ms (1/60) and 1 PLC for 50 Hz is 20 ms (1/50).
This attribute enables or disables automatic updates to the internal reference measurements (autozero) of the instrument.
+
+
+
Type
+
+
TSP-Link accessible
+
+
Affected by
+
+
Where saved
+
+
Default value
+
+
+
+
Attribute (RW)
+
+
Yes
+
+
Instrument reset SMU reset Recall setup
+
+
Saved setup
+
+
2 (smua.AUTOZERO_AUTO)
+
+
+
+
+
Usage
+
azMode = smua.measure.autozero
+
smua.measure.autozero = azMode
+
+
+
+
azMode
+
+
Indicates status of autozero; set to one of the following values:
+
0 or smua.AUTOZERO_OFF: Autozero disabled
1 or smua.AUTOZERO_ONCE: Performs autozero once, then disables autozero
2 or smua.AUTOZERO_AUTO: Automatic checking of reference and zero measurements; an autozero is performed when needed
+
+
+
+
+
Details
+
The analog-to-digital converter (ADC) uses a ratiometric A/D conversion technique. To ensure the accuracy of readings, the instrument must periodically obtain new measurements of its internal ground and voltage reference. The time interval between updates to these reference measurements is determined by the integration aperture being used for measurements. The 2601B-PULSE uses separate reference and zero measurements for each aperture.
+
By default, the instrument automatically checks these reference measurements whenever a signal measurement is made. If the reference measurements have expired when a signal measurement is made, the instrument will automatically take two more A/D conversions, one for the reference and one for the zero, before returning the result. Thus, occasionally, a measurement takes longer than normal.
+
This additional time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the time that is needed for the reference measurements in these situations, you can use the smua.measure.autozero attribute to disable the automatic reference measurements.
+
Disabling automatic reference measurements may allow the instrument to gradually drift out of specification. To minimize the drift, a reference and zero measurement should be made immediately before any critical test sequences. You can use the smua.AUTOZERO_ONCE setting to force a refresh of the reference and zero measurements that are used for the present aperture setting.
+
The 2601B-PULSE stores the reference measurements for the last ten NPLC settings that were used in a reference cache. If an NPLC setting is selected and an entry for it is not in the cache, the oldest (least recently used) entry is discarded to make room for the new entry.
+
When the pulser is enabled, two high-speed digitizing sampling ADCs are used to measure voltage and current. These ADCs do not use a ratiometric conversion technique, so the autozero settings are ignored when the pulser is enabled.
+
+
+
+
+
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/AfterPublish.bat b/WebHelpDocs/2601B-PULSE/AfterPublish.bat
new file mode 100644
index 0000000..9068f2b
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/AfterPublish.bat
@@ -0,0 +1,19 @@
+::--------------------------------------------------
+:: AfterPublishing.bat - Runs OracleToEclipse
+::--------------------------------------------------
+
+@echo off
+
+::Get the current batch file's short path
+for %%x in (%0) do set BatchPath=%%~dpsx
+for %%x in (%BatchPath%) do set BatchPath=%%~dpsx
+echo BatchPath = %BatchPath%
+
+echo "Enter ShortName (2600B, 3700, 707B, 2651A, 2657A, 2450, 2460):"
+set /p ShortName=
+
+echo "ShortName is " %ShortName%
+
+cd %BatchPath%
+OracleToEclipse toc.xml %ShortName%
+
diff --git a/WebHelpDocs/2601B-PULSE/EclipseHelpTemplate.html b/WebHelpDocs/2601B-PULSE/EclipseHelpTemplate.html
new file mode 100644
index 0000000..40cd810
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/EclipseHelpTemplate.html differ
diff --git a/WebHelpDocs/2601B-PULSE/Model 2601B-PULSE help files.hs b/WebHelpDocs/2601B-PULSE/Model 2601B-PULSE help files.hs
new file mode 100644
index 0000000..5b64de4
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/Model 2601B-PULSE help files.hs
@@ -0,0 +1,25 @@
+
+
+
+
+Model 2601B-PULSE TSB help files
+
+
+
+ O19545
+
+
+
+
+
+
+ oracle.help.navigator.tocNavigator.TOCNavigator
+ toc.xml
+
+
+
+ oracle.help.navigator.searchNavigator.SearchNavigator
+ search.idx
+
+
+
diff --git a/WebHelpDocs/2601B-PULSE/OracleToEclipse.exe b/WebHelpDocs/2601B-PULSE/OracleToEclipse.exe
new file mode 100644
index 0000000..696ed36
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/OracleToEclipse.exe differ
diff --git a/WebHelpDocs/2601B-PULSE/OracleToEclipse.xslt b/WebHelpDocs/2601B-PULSE/OracleToEclipse.xslt
new file mode 100644
index 0000000..73c713c
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/OracleToEclipse.xslt
@@ -0,0 +1,28 @@
+
+
+
+
+
+
+
+
+ /.html
+
+
+
+
+
+
+
+
+ _toc.xml
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/WebHelpDocs/2601B-PULSE/caution_large_no_exclaim_lr.png b/WebHelpDocs/2601B-PULSE/caution_large_no_exclaim_lr.png
new file mode 100644
index 0000000..1bfee3b
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/caution_large_no_exclaim_lr.png differ
diff --git a/WebHelpDocs/2601B-PULSE/contents1.gif b/WebHelpDocs/2601B-PULSE/contents1.gif
new file mode 100644
index 0000000..18ec664
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/contents1.gif differ
diff --git a/WebHelpDocs/2601B-PULSE/contents2.gif b/WebHelpDocs/2601B-PULSE/contents2.gif
new file mode 100644
index 0000000..aac2736
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/contents2.gif differ
diff --git a/WebHelpDocs/2601B-PULSE/contents3.gif b/WebHelpDocs/2601B-PULSE/contents3.gif
new file mode 100644
index 0000000..9fef3ca
Binary files /dev/null and b/WebHelpDocs/2601B-PULSE/contents3.gif differ
diff --git a/WebHelpDocs/2601B-PULSE/dhtml_search.htm b/WebHelpDocs/2601B-PULSE/dhtml_search.htm
new file mode 100644
index 0000000..09106f8
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/dhtml_search.htm
@@ -0,0 +1,13 @@
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/WebHelpDocs/2601B-PULSE/dhtml_search.js b/WebHelpDocs/2601B-PULSE/dhtml_search.js
new file mode 100644
index 0000000..39feb8e
--- /dev/null
+++ b/WebHelpDocs/2601B-PULSE/dhtml_search.js
@@ -0,0 +1,628 @@
+/* Generated with Author-it 6.4.3.37098 4/14/2020 1:30:43 PM */
+Page=new Array();Page[0]=new Array("Instruments that are enabled for Test Script Processor (TSP®) operate like conventional instruments by responding to a sequence of commands sent by the controller. You can send individual commands to the TSP-enabled instrument the same way you would when using any other instrument. ","Unlike conventional instruments, TSP-enabled instruments can execute automated test sequences independently, without an external controller. You can load a series of TSP commands into the instrument. You can store these commands as a script that can be run later by sending a single command message to the instrument.","You do not have to choose between using conventional control or script control. You can combine these forms of instrument control in the way that works best for your test application.","Introduction to TSP operation","17029.htm");
+Page[1]=new Array("The simplest method of controlling an instrument through the communication interface is to send it a message that contains remote commands. You can use a test program that resides on a computer (the controller) to sequence the actions of the instrument.","TSP commands can be function-based or attribute-based. Function-based commands are commands that control actions or activities. Attribute-based commands define characteristics of an instrument feature or operation.","Constants represent fixed values.","Controlling the instrument by sending individual command messages","17268.htm");
+Page[2]=new Array("Function-based commands control actions or activities. A function-based command performs an immediate action on the instrument.","Each function consists of a function name followed by a set of parentheses ( ). You should only include information in the parentheses if the function takes a parameter. If the function takes one or more parameters, they are placed between the parentheses and separated by commas.","Example 1","beeper.beep(0.5, 2400)","delay(0.250)","beeper.beep(0.5, 2400)","Emit a double‑beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on.","Example 2","You can use the results of a function-based command directly or assign the results to variables for later access. The following code defines x and prints it.","x = math.abs(-100)","print(x)","Output:","100","Functions","13811.htm");
+Page[3]=new Array("Attribute-based commands are commands that set the characteristics of an instrument feature or operation. For example, a characteristic of TSP‑enabled instruments is the model number (localnode.model).","Attributes can be read-only, read-write, or write-only. They can be used as a parameter of a function or assigned to another variable.","Attributes","492.htm");
+Page[4]=new Array("To set the characteristics, attribute-based commands define a value. For many attributes, the value is in the form of a number or a predefined constant.","Example 1: Set an attribute using a number","beeper.enable = 0","This attribute controls the beeps that occur when front‑panel controls are selected. Setting this attribute to 0 turns off the beeper.","Example 2: Set an attribute using a constant","format.data = format.REAL64","Using the constant REAL64 sets the print format to double precision floating-point format.","","492.htm#o493");
+Page[5]=new Array("To read an attribute, you can use the attribute as the parameter of a function, or assign it to another variable.","Example 3: Read an attribute using a function","print(format.data)","Reads the data format by passing the attribute to the print function. If the data format is set to 3, the output is:","3.00000e+00","This shows that the data format is set to double precision floating point.","Example 4: Read an attribute using a variable","fd = format.data","This reads the data format by assigning the attribute to a variable named fd.","","492.htm#o494");
+Page[6]=new Array("Test Script Processor (TSP®) enabled instruments do not have inherent query commands. Like any other scripting environment, the print() and printnumber() commands generate output in the form of response messages. Each print() command creates one response message.","Example","x = 10","print(x)","Example of an output response message: ","10","Note that your output may be different if you set your ASCII precision setting to a different value.","Queries","368.htm");
+Page[7]=new Array("If you need information about using scripts with your TSP‑enabled instrument, see Fundamentals of scripting for TSP.","If you need information about using the Lua programming language with the instrument, see Fundamentals of programming for TSP.","Information on scripting and programming","17789.htm");
+Page[8]=new Array("This section contains an overview of the TSP commands for the instrument. The commands are organized into groups, with a brief description of each group. Each section contains links to the detailed descriptions for each command in the TSP command reference section of this documentation (see TSP commands).","About TSP commands","13401.htm");
+Page[9]=new Array("The beeper commands allow you to enable or disable and sound the instrument beeper.","beeper.beep()","beeper.enable","Beeper control","14127.htm");
+Page[10]=new Array("The bit functions perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers.","Logic operations","The bit.bitand(), bit.bitor(), and bit.bitxor() functions in this group perform bitwise logic operations on two numbers. The Test Script Processor (TSP®) scripting engine performs the indicated logic operation on the binary equivalents of the two integers. This bitwise logic operation is performed on all corresponding bits of the two numbers. The result of a logic operation is returned as an integer.","Bit operations","The rest of the functions in this group are used for operations on the bits of a given number. These functions can be used to:","Clear a bit","Toggle a bit","Test a bit","Set a bit or bit field","Retrieve the weighted value of a bit or field value","All these functions use an index parameter to specify the bit position of the given number. The least significant bit of a given number has an index of 1, and the most significant bit has an index of 32.","@The Test Script Processor (TSP) scripting engine stores all numbers internally as IEEE Std 754 double-precision floating-point values. The logical operations work on 32‑bit integers. Any fractional bits are truncated. For numbers larger than 4294967295, only the lower 32 bits are used.","bit.bitand()","bit.bitor()","bit.bitxor()","bit.clear()","bit.get()","bit.getfield()","bit.set()","bit.setfield()","bit.test()","bit.toggle()","Bit manipulation and logic operations","11382.htm");
+Page[11]=new Array("smua.cal.adjustdate","smua.cal.date","smua.cal.due","smua.cal.lock()","smua.cal.password","smua.cal.polarity","smua.cal.restore()","smua.cal.save()","smua.cal.state","smua.cal.unlock()","smua.contact.calibratehi()","smua.contact.calibratelo()","smua.measure.calibrateY()","smua.pulser.measure.calibrateY()","smua.pulser.source.calibratebiasi()","smua.pulser.source.calibratei()","smua.source.calibrateY()","Calibration","92710.htm");
+Page[12]=new Array("Use the data queue commands to:","Share data between test scripts running in parallel","Access data from a remote group or a local node on a TSP‑Link® network at any time","The data queue in the Test Script Processor (TSP®) scripting engine is first-in, first-out (FIFO).","You can access data from the data queue even if a remote group or a node has overlapped operations in process.","dataqueue.add()","dataqueue.CAPACITY","dataqueue.clear()","dataqueue.count","dataqueue.next()","Data queue","14653.htm");
+Page[13]=new Array("The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations).","The I/O port has 14 lines. Each line can be at TTL logic state 1 (high) or 0 (low). See the pinout diagram in Digital I/O port for additional information.","There are commands to read and write to each individual bit, and commands to read and write to the entire port.","digio.readbit()","digio.readport()","digio.trigger[N].assert()","digio.trigger[N].clear()","digio.trigger[N].EVENT_ID","digio.trigger[N].mode","digio.trigger[N].overrun","digio.trigger[N].pulsewidth","digio.trigger[N].release()","digio.trigger[N].reset()","digio.trigger[N].stimulus","digio.trigger[N].wait()","digio.writebit()","digio.writeport()","digio.writeprotect","Digital I/O","77502.htm");
+Page[14]=new Array("display.clear()","display.getannunciators()","display.getcursor()","display.getlastkey()","display.gettext()","display.inputvalue()","display.loadmenu.add()","display.loadmenu.catalog()","display.loadmenu.delete()","display.locallockout","display.menu()","display.numpad","display.prompt()","display.screen","display.sendkey()","display.setcursor()","display.settext()","display.smua.digits","display.smua.limit.func","display.smua.measure.func","display.trigger.clear()","display.trigger.EVENT_ID","display.trigger.overrun","display.trigger.wait()","display.waitkey()","Display","15965.htm");
+Page[15]=new Array("When errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error and status message information.","errorqueue.clear()","errorqueue.count","errorqueue.next()","Error queue","14748.htm");
+Page[16]=new Array("You can use the event log to view specific details about LAN triggering events.","eventlog.all()","eventlog.clear()","eventlog.count","eventlog.enable","eventlog.next()","eventlog.overwritemethod","Event log","10905.htm");
+Page[17]=new Array("You can use the file I/O commands to open and close directories and files, write data, or to read a file on an installed USB flash drive. File I/O commands are organized into two groups:","Commands that reside in the fs and io table, for example: io.open(), io.close(), io.input(), and io.output(). Use these commands to manage file system directories; open and close file descriptors; and perform basic I/O operations on a pair of default files (one input and one output).","Commands that reside in the file descriptors (for example: fileVar:seek(), fileVar:write(), and fileVar:read()) operate exclusively on the file with which they are associated.","The root folder of the USB flash drive has the absolute path:",""/usb1/"","@You can use either the slash (/) or backslash (\\) as a directory separator. However, the backslash is also used as an escape character, so if you use it as a directory separator, you will generally need to use a double backslash (\\\\) when you are creating scripts or sending commands to the instrument.","For basic information about navigation and directory listing of files on a flash drive, see File system navigation.","File descriptor commands for file I/O use a colon (:) to separate the command parts rather than a period (.), like the io commands.","File descriptors cannot be passed between nodes in a TSP-Link® system, so the io.open(), fileVar::read(), and fileVar::write commands are not accessible to the TSP-Link system. However, the default input and output files mentioned above allow for the execution of many file I/O operations without any reference to a file descriptor.","fileVar:close()","fileVar:flush()","fileVar:read()","fileVar:seek()","fileVar:write()","fs.chdir()","fs.cwd()","fs.is_dir()","fs.is_file()","fs.mkdir()","fs.readdir()","fs.rmdir()","io.close()","io.flush()","io.input()","io.open()","io.output()","io.read()","io.type()","io.write()","os.remove()","os.rename()","The following standard I/O commands are not supported:","File","I/O","fileVar:lines()","fileVar:setvbuf()","io.lines()","io.popen()","File I/O","14771.htm");
+Page[18]=new Array("This attribute stores the GPIB address.","gpib.address","GPIB","14859.htm");
+Page[19]=new Array("These commands store strings that describe the instrument.","localnode.description","localnode.model","localnode.revision","localnode.serialno","Instrument identification","19423.htm");
+Page[20]=new Array("The LAN commands have options that allow you to review and configure network settings.","The lan.config.* commands allow you to configure LAN settings over the remote interface. Note that you must send lan.applysettings() for the configuration settings to take effect.","The lan.status.* commands help you determine the status of the LAN.","The lan.trigger[N].* commands allow you to set up and assert trigger events that are sent over the LAN.","Other LAN commands allow you to reset the LAN, restore defaults, check LXI domain information, and enable or disable the Nagle algorithm.","lan.applysettings()","lan.autoconnect","lan.config.dns.address[N]","lan.config.dns.domain","lan.config.dns.dynamic","lan.config.dns.hostname","lan.config.dns.verify","lan.config.duplex","lan.config.gateway","lan.config.ipaddress","lan.config.method","lan.config.speed","lan.config.subnetmask","lan.linktimeout","lan.lxidomain","lan.nagle","lan.reset()","lan.restoredefaults()","lan.status.dns.address[N]","lan.status.dns.name","lan.status.duplex","lan.status.gateway","lan.status.ipaddress","lan.status.macaddress","lan.status.port.dst","lan.status.port.rawsocket","lan.status.port.telnet","lan.status.port.vxi11","lan.status.speed","lan.status.subnetmask","lan.timedwait","lan.trigger[N].assert()","lan.trigger[N].clear()","lan.trigger[N].connect()","lan.trigger[N].connected","lan.trigger[N].disconnect()","lan.trigger[N].EVENT_ID","lan.trigger[N].ipaddress","lan.trigger[N].mode","lan.trigger[N].overrun","lan.trigger[N].protocol","lan.trigger[N].pseudostate","lan.trigger[N].stimulus","lan.trigger[N].wait()","localnode.description","localnode.password","localnode.passwordmode","LAN and LXI","14129.htm");
+Page[21]=new Array("delay()","exit()","localnode.autolinefreq","localnode.linefreq","makegetter()","makesetter()","meminfo()","opc()","waitcomplete()","Miscellaneous","19424.htm");
+Page[22]=new Array("dataqueue.add()","dataqueue.CAPACITY","dataqueue.clear()","dataqueue.count","dataqueue.next()","node[N].execute()","node[N].getglobal()","node[N].setglobal()","tsplink.group","tsplink.master","tsplink.node","Parallel script execution","19425.htm");
+Page[23]=new Array("You can use the print(), printbuffer(), and printnumber() functions to query the instrument and generate response messages. The format attributes control how the data is formatted for the print functions used.","The localnode commands determine if generated errors are automatically sent and if prompts are generated.","format.asciiprecision","format.byteorder","format.data","localnode.prompts","localnode.prompts4882","localnode.showerrors","print()","printbuffer()","printnumber()","Queries and response messages","14795.htm");
+Page[24]=new Array("Reading buffers capture measurements, ranges, instrument status, and output states of the instrument.","bufferVar.appendmode","bufferVar.basetimestamp","bufferVar.cachemode","bufferVar.capacity","bufferVar.clear()","bufferVar.clearcache()","bufferVar.collectsourcevalues","bufferVar.collecttimestamps","bufferVar.fillcount","bufferVar.fillmode","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestampresolution","bufferVar.timestamps","savebuffer()","smua.buffer.getstats()","smua.buffer.recalculatestats()","smua.makebuffer()","smua.nvbufferY","smua.savebuffer()","Reading buffer","17112.htm");
+Page[25]=new Array("Resets settings to their default settings.","digio.trigger[N].reset()","lan.reset()","localnode.reset()","reset()","smua.reset()","timer.reset()","trigger.blender[N].reset()","trigger.timer[N].reset()","tsplink.trigger[N].reset()","Reset","15061.htm");
+Page[26]=new Array("serial.baud","serial.databits","serial.flowcontrol","serial.parity","serial.read()","serial.write()","RS-232","15067.htm");
+Page[27]=new Array("Use the saved setups commands to save or restore the configurations to or from the nonvolatile memory of the instrument or an installed USB flash drive. You can use the setup.poweron attribute to specify which setup is recalled when the instrument is turned on.","setup.poweron","setup.recall()","setup.save()","Saved setups","19516.htm");
+Page[28]=new Array("Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.","For detail on using scripts, see Fundamentals of scripting for TSP.","exit()","makegetter()","makesetter()","script.anonymous","script.delete()","script.factory.catalog()","script.load()","script.new()","script.newautorun()","script.restore()","script.run()","script.user.catalog()","scriptVar.autorun","scriptVar.list()","scriptVar.name","scriptVar.run()","scriptVar.save()","scriptVar.source","Scripting","15062.htm");
+Page[29]=new Array("localnode.linefreq","smua.abort()","smua.buffer.getstats()","smua.buffer.recalculatestats()","smua.contact.check()","smua.contact.r()","smua.contact.speed","smua.contact.threshold","smua.makebuffer()","smua.measure.autorangeY","smua.measure.autozero","smua.measure.count","smua.measure.delay","smua.measure.delayfactor","smua.measure.filter.count","smua.measure.filter.enable","smua.measure.filter.type ","smua.measure.highcrangedelayfactor ","smua.measure.interval","smua.measure.lowrangeY","smua.measure.nplc","smua.measure.overlappedY()","smua.measure.rangeY","smua.measure.rel.enableY","smua.measure.rel.levelY","smua.measure.Y()","smua.measureYandstep()","smua.nvbufferY","smua.pulser.enable","smua.pulser.measure.aperture","smua.pulser.measure.delay","smua.pulser.protect.sensev","smua.pulser.protect.sourcev","smua.pulser.protect.tripped","smua.pulser.rangeY","smua.reset()","smua.savebuffer()","smua.sense","smua.source.autorangeY","smua.source.compliance","smua.source.delay","smua.source.func","smua.source.highc","smua.source.levelY","smua.source.limitY","smua.source.lowrangeY","smua.source.offlimitY","smua.source.offmode","smua.source.output","smua.source.rangeY","smua.source.settling","smua.trigger.arm.count","smua.trigger.arm.set()","smua.trigger.arm.stimulus","smua.trigger.ARMED_EVENT_ID","smua.trigger.autoclear","smua.trigger.count","smua.trigger.endpulse.action","smua.trigger.endpulse.set()","smua.trigger.endpulse.stimulus","smua.trigger.endsweep.action","smua.trigger.IDLE_EVENT_ID","smua.trigger.initiate()","smua.trigger.measure.action","smua.trigger.measure.set()","smua.trigger.measure.stimulus","smua.trigger.measure.Y()","smua.trigger.MEASURE_COMPLETE_EVENT_ID","smua.trigger.PULSE_COMPLETE_EVENT_ID","smua.trigger.source.action","smua.trigger.source.limitY","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","smua.trigger.source.pulsewidth","smua.trigger.source.set()","smua.trigger.source.stimulus","smua.trigger.SOURCE_COMPLETE_EVENT_ID","smua.trigger.SWEEP_COMPLETE_EVENT_ID","smua.trigger.SWEEPING_EVENT_ID","SMU","93150.htm");
+Page[30]=new Array("The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events.","status.condition","status.measurement.*","status.measurement.buffer_available.*","status.measurement.current_limit.*","status.measurement.instrument.*","status.measurement.instrument.smua.*","status.measurement.reading_overflow.*","status.measurement.voltage_limit.*","status.node_enable","status.node_event","status.operation.*","status.operation.calibrating.*","status.operation.instrument.*","status.operation.instrument.digio.*","status.operation.instrument.digio.trigger_overrun.*","status.operation.instrument.lan.*","status.operation.instrument.lan.trigger_overrun.*","status.operation.instrument.smua.*","status.operation.instrument.smua.trigger_overrrun.*","status.operation.instrument.trigger_blender.*","status.operation.instrument.trigger_blender.trigger_overrun.*","status.operation.instrument.trigger_timer.*","status.operation.instrument.trigger_timer.trigger_overrun.*","status.operation.instrument.tsplink.*","status.operation.instrument.tsplink.trigger_overrun.*","status.operation.measuring.*","status.operation.remote.*","status.operation.sweeping.*","status.operation.trigger_overrun.*","status.operation.user.*","status.questionable.*","status.questionable.calibration.*","status.questionable.instrument.*","status.questionable.instrument.smua.*","status.questionable.over_temperature.*","status.questionable.unstable_output.*","status.request_enable","status.request_event","status.reset()","status.standard.*","status.system.*","status.system2.*","status.system3.*","status.system4.*","status.system5.*","Status model","14126.htm");
+Page[31]=new Array("bufferVar.basetimestamp","bufferVar.collecttimestamps","bufferVar.timestampresolution","bufferVar.timestamps","delay()","gettimezone()","os.time()","settime()","settimezone()","timer.measure.t()","timer.reset()","Time","19432.htm");
+Page[32]=new Array("Triggering allows you to capture measurements when an input signal or combination of input signals meet a set of conditions that you set. See Sweep operation for details on sweeping.","digio.trigger[N].assert()","digio.trigger[N].clear()","digio.trigger[N].EVENT_ID","digio.trigger[N].mode","digio.trigger[N].overrun","digio.trigger[N].pulsewidth","digio.trigger[N].release()","digio.trigger[N].reset()","digio.trigger[N].stimulus","digio.trigger[N].wait()","display.trigger.clear()","display.trigger.EVENT_ID","display.trigger.overrun","display.trigger.wait()","lan.trigger[N].assert()","lan.trigger[N].clear()","lan.trigger[N].connect()","lan.trigger[N].connected","lan.trigger[N].disconnect()","lan.trigger[N].EVENT_ID","lan.trigger[N].ipaddress","lan.trigger[N].mode","lan.trigger[N].overrun","lan.trigger[N].protocol","lan.trigger[N].pseudostate","lan.trigger[N].stimulus","lan.trigger[N].wait()","smua.pulser.measure.delay","smua.trigger.arm.count","smua.trigger.arm.set()","smua.trigger.arm.stimulus","smua.trigger.ARMED_EVENT_ID","smua.trigger.autoclear","smua.trigger.count","smua.trigger.endpulse.action","smua.trigger.endpulse.set()","smua.trigger.endpulse.stimulus","smua.trigger.endsweep.action","smua.trigger.IDLE_EVENT_ID","smua.trigger.initiate()","smua.trigger.measure.action","smua.trigger.measure.set()","smua.trigger.measure.stimulus","smua.trigger.measure.Y()","smua.trigger.MEASURE_COMPLETE_EVENT_ID","smua.trigger.PULSE_COMPLETE_EVENT_ID","smua.trigger.source.action","smua.trigger.source.limitY","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","smua.trigger.source.pulsewidth","smua.trigger.source.set()","smua.trigger.source.stimulus","smua.trigger.SOURCE_COMPLETE_EVENT_ID","smua.trigger.SWEEP_COMPLETE_EVENT_ID","smua.trigger.SWEEPING_EVENT_ID","trigger.blender[N].clear()","trigger.blender[N].EVENT_ID","trigger.blender[N].orenable","trigger.blender[N].overrun","trigger.blender[N].reset()","trigger.blender[N].stimulus[M]","trigger.blender[N].wait()","trigger.clear()","trigger.EVENT_ID","trigger.generator[N].assert()","trigger.generator[N].EVENT_ID","trigger.timer[N].clear()","trigger.timer[N].count","trigger.timer[N].delay","trigger.timer[N].delaylist","trigger.timer[N].EVENT_ID","trigger.timer[N].overrun","trigger.timer[N].passthrough","trigger.timer[N].reset()","trigger.timer[N].stimulus","trigger.timer[N].wait()","trigger.wait()","tsplink.trigger[N].assert()","tsplink.trigger[N].clear()","tsplink.trigger[N].EVENT_ID","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].pulsewidth","tsplink.trigger[N].release()","tsplink.trigger[N].reset()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","Triggering","93152.htm");
+Page[33]=new Array("These functions and attributes allow you to set up and work with a system that is connected by a TSP‑Link® network.","tsplink.group","tsplink.master","tsplink.node","tsplink.readbit()","tsplink.readport()","tsplink.reset()","tsplink.state","tsplink.trigger[N].assert()","tsplink.trigger[N].clear()","tsplink.trigger[N].EVENT_ID","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].pulsewidth","tsplink.trigger[N].release()","tsplink.trigger[N].reset()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.writebit()","tsplink.writeport()","tsplink.writeprotect","TSP-Link","77377.htm");
+Page[34]=new Array("The TSP-Net module provides a simple socket-like programming interface to Test Script Processor (TSP®) enabled instruments.","tspnet.clear()","tspnet.connect()","tspnet.disconnect()","tspnet.execute()","tspnet.idn()","tspnet.read()","tspnet.readavailable()","tspnet.reset()","tspnet.termination()","tspnet.timeout","tspnet.tsp.abort()","tspnet.tsp.abortonconnect","tspnet.tsp.rbtablecopy()","tspnet.tsp.runscript()","tspnet.write()","TSP-Net","14072.htm");
+Page[35]=new Array("Use the functions in this group to store and retrieve user-defined strings in nonvolatile memory. These strings are stored as key‑value pairs. The key is a unique identifier such as a part number or identification string.","You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.","userstring.add()","userstring.catalog()","userstring.delete()","userstring.get()","Userstrings","72522.htm");
+Page[36]=new Array("The Keithley Instruments 2601B-PULSE System SourceMeter® instrument is shipped with one or more factory scripts saved in its flash firmware memory. A factory script is made up of a number of functions. Some of them can be called from the front‑panel LOAD TEST menu. All of them can be called using remote programming.","As Keithley Instruments develops additional factory scripts, they will be made available on tek.com/keithley as a flash firmware upgrade for the 2601B-PULSE. See Upgrading the firmware for instructions on upgrading the flash firmware of your 2601B-PULSE instrument.","A factory script is similar to a user script, except a factory script is created by Keithley Instruments at the factory and is permanently stored in nonvolatile memory. The differences between a user script and a factory script include the following:","A factory script cannot be deleted from nonvolatile memory.","The script listing for a factory script can be retrieved and modified, but it is then treated as a user script. A user script cannot be saved as a factory script.","Factory scripts are not stored in global variables. The only references to factory scripts are in the script.factory.scripts attribute.","The script.factory.catalog() function returns an iterator that can be used in a for loop to iterate over all the factory scripts.","Example","To retrieve the catalog listing for factory scripts, send:","for name in script.factory.catalog() do print(name) end","Factory scripts","12911.htm");
+Page[37]=new Array("Use either of the following commands to run a factory script:","script.factory.scripts.name() script.factory.scripts.name.run()","Where: name is the name of the factory script.","Example:","Run the factory script named KISweep.","script.factory.scripts.KISweep()","Running a factory script","12913.htm");
+Page[38]=new Array("Press the LOAD key.","Select FACTORY.","Select the function to run and press the ENTER key or navigation wheel @.","Press the RUN key.","Follow the prompts on the front panel to run the script.","Running a factory script function from the front-panel controls","12914.htm");
+Page[39]=new Array("The script listing for a factory script can be retrieved and modified. However, it cannot be saved as a factory script. The modified script can be saved as a user script using the same name or a new name.","An imported factory script can only be loaded back into the 2601B-PULSE as a user script.","The following function retrieves a script listing. The script code is output with the shell keywords (loadscript or loadandrunscript and endscript):","script.factory.scripts.name.list()","Where: name is the name of the factory script.","An example that retrieves the script listing for a factory script named KISweep:","script.factory.scripts.KISweep.list()","Retrieving and modifying a factory script listing","12194.htm");
+Page[40]=new Array("The KISweep factory script provides simple sweep test programming and shows how to use the sweeping function.","This script is made up of the following functions. Access these functions from the front panel or the remote interfaces. The following functions make up the KISweep factory script:","SweepILinMeasureV()","SweepIListMeasureV()","SweepILogMeasureV()","SweepVLinMeasureI()","SweepVListMeasureI()","SweepVLogMeasureI()","KISweep factory script","12175.htm");
+Page[41]=new Array("The KIHighC factory script is made up of two functions: i_leakage_measure() and i_leakage_threshold(). These functions are intended to be used when high capacitance mode is active. Output is generally at a non-zero voltage before calling these functions. These functions can also be used to step the voltage to zero volts in order to measure the leakage current.","i_leakage_measure()","i_leakage_threshold()","KIHighC factory script","12950.htm");
+Page[42]=new Array("The KIParlib factory script is made up of two functions: gm_vsweep() and gm_isweep().","gm_vsweep()","gm_isweep()","KIParlib factory script","12954.htm");
+Page[43]=new Array("The KISavebuffer script has one function: savebuffer().","savebuffer()","KISavebuffer factory script","12958.htm");
+Page[44]=new Array("This section contains general information about using TSP commands.","TSP command programming notes","19536.htm");
+Page[45]=new Array("This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values. The following examples show typical uses of italicized text: ","Example 1:","beeper.enable = state","Where state can be a value (beeper.ON or beeper.OFF) or an integer (1 or 0) that you specify. For example, to set this attribute on, you would send one of the following commands:","beeper.enable = beeper.ON","beeper.enable = 1","Example 2:","digio.trigger[N].assert()","Where N is an integer (1 to 14) that you specify. For example, to assert trigger line 7 you would send:","digio.trigger[7].assert()","To assert a trigger line with a variable as the integer, you would send:","triggerline = 7","digio.trigger[triggerline].assert()","Example 3:","smua.trigger.measure.Y(rbuffer)","Where: ","Y is the measurement type that you specify (v, i, r, or p). ","rbuffer is the reading buffer object where the readings will be stored. ","For example, to make voltage measurements and store them in buffer vbuffername, you would send:","smua.trigger.measure.v(vbuffername)","Placeholder text","92460.htm");
+Page[46]=new Array("Use these syntax requirements to build well-formed instrument control commands.","Instrument commands are case sensitive. Refer to the command reference descriptions for the correct case.","The white space in lists of parameters in functions is optional. For example, the following functions are equivalent:","digio.writebit(3,0)","digio.writebit (3, 0)"," All functions must have a set of parentheses () immediately following the function, even if there are no parameters specified. For example:","waitcomplete(G)","timezone = localnode.gettimezone()","If there are multiple parameters, they must be separated by commas (,). For example:","beeper.beep(0.5, 2400)","Syntax rules","17860.htm");
+Page[47]=new Array("Time and date values are represented as the number of seconds since some base. Representing time as a number of seconds is referred to as “standard time format.” There are three time bases:","UTC 12:00 am Jan 1, 1970. Some examples of UTC time are reading buffer base timestamps, adjustment dates, and the value returned by os.time().","Instrument on. References time to when the instrument was turned on. The value returned by os.clock() is referenced to the turn-on time.","Event. Time referenced to an event, such as the first reading stored in a reading buffer.","Time and date values","12044.htm");
+Page[48]=new Array("The following source-measure unit (SMU) settings are ignored when the pulser is enabled:","display.smua.limit.func","smua.measure.autorangeY","smua.measure.autozero","smua.measure.delay","smua.measure.highcrangedelayfactor","smua.measure.lowrangeY","smua.measure.nplc","smua.measure.rangeY","smua.sense","smua.source.autorangeY","smua.source.delay","smua.source.func","smua.source.highc","smua.source.limitY","smua.source.lowrangeY","smua.source.offlimitY","smua.source.rangeY","smua.source.settling","smua.source.sink","smua.trigger.endpulse.action","smua.trigger.endsweep.action","Settings ignored when the pulser is enabled","91979.htm");
+Page[49]=new Array("The following pulser settings do not affect source-measure unit (SMU) operation when the pulser is disabled:","smua.pulser.measure.aperture","smua.pulser.measure.delay","smua.pulser.protect.sensev","smua.pulser.protect.sourcev","smua.pulser.rangeY","Settings ignored when the pulser is disabled","91702.htm");
+Page[50]=new Array("The Test Script Processor (TSP®) command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into subsections. The figure below shows an example of a command description.","The subsections contain information about the command. The subsections are:","Command name and summary table","Usage","Details","Example","Also see","The content of each of these subsections is described in the following topics.","Using the TSP command reference","17852.htm");
+Page[51]=new Array("Each instrument command description starts with the command name, followed by a brief description and a table with relevant information for each command. Definitions for the numbered items in the figure below are listed following the figure.","Instrument command name. Indicates the beginning of the command description. It is followed by a brief description of what the command does.","Type of command. Commands can be functions, attributes, or constants. If the command is an attribute, it can be read-only (R), read-write (RW), or write-only (W). For detail on commands, see Introduction to TSP operation.","TSP-Link accessible. Yes or No; indicates whether or not the command can be accessed through a TSP-Link network.","Affected by. Commands or actions that may change the setting of this command.","LAN restore defaults: This command is reset to the default value when lan.restoredefaults() is sent.","Digital I/O trigger N reset: This command is reset to the default value when digio.trigger[N].reset() is sent.","Recall setup: This command is stored as part of the saved setup and is changed to the value stored in the saved setup when the setup is recalled.","Instrument reset: This command is reset to the default value when reset(), localnode.reset(), or *RST is sent.","SMU reset: This command is reset to the default value when smua.reset() is sent.","Power cycle: This command is set to the default value when the instrument power is cycled.","Where saved. Indicates where the command settings reside once they are used on an instrument. Options include:","Not saved: Command is not saved anywhere and must be typed each time you use it.","Nonvolatile memory: Storage area in the instrument where information is saved when the instrument is turned off.","Saved setup: Command is saved as part of the saved setup.","Default value: Lists the default value or constant for the command. The parameter values are defined in the Usage or Details sections of the command description.","Command name and summary table","17853.htm");
+Page[52]=new Array("The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage. All possible command usage options are shown.","1 Structure of command usage: Shows how the parts of the command should be organized. If a parameter is shown to the left of the command, it is the return when you print the command. Information to the right is the parameters or other items you need to enter when setting the command.","2 User-supplied parameters: Indicated by italics. For example, for the function beeper.beep(duration, frequency), replace duration with the number of seconds and frequency with the frequency of the tone. Send beeper.beep(2, 2400) to generate a two-second, 2400 Hz tone.
Some commands have optional parameters. If there are optional parameters, they must be entered in the order presented in the Usage section. You cannot leave out any parameters that precede the optional parameter. Optional parameters are shown as separate lines in usage, presented in the required order with each valid permutation of the optional parameters. For example: printbuffer(startIndex, endIndex, buffer1) printbuffer(startIndex, endIndex, buffer1, buffer2)","3 Parameter value options: Descriptions of the options that are available for the user-defined parameter.","Command usage","17854.htm");
+Page[53]=new Array("This section lists additional information you need to know to successfully use the remote command.","Command details","17855.htm");
+Page[54]=new Array("The Example section of the remote command description shows examples of how you can use the command.","1 Actual example code that you can copy from this table and paste into your own programming application.","2 Description of the code and what it does. This may also contain example output of the code.","Example section","17856.htm");
+Page[55]=new Array("The Also see section of the remote command description lists additional commands or sections that are related to the command.","Related commands and information","17857.htm");
+Page[56]=new Array("The TSP commands available for the instrument are listed in alphabetic order.","TSP commands","19389.htm");
+Page[57]=new Array("This function generates an audible tone.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","beeper.beep(duration, frequency)","duration","The amount of time to play the tone (0.001 s to 100 s)","frequency","The frequency of the tone in Hertz (Hz)","Details","You can use the beeper of the 2601B-PULSE to provide an audible signal at a specified frequency and time duration. For example, you can use the beeper to signal the end of a lengthy sweep.","The beeper will not sound if it is disabled. It can be disabled or enabled with the beeper enable command, or through the front panel.","Example","beeper.enable = beeper.ON","beeper.beep(2, 2400)","Enables the beeper and generates a two‑second, 2400 Hz tone.","Also see","beeper.enable","beeper.beep()","18841.htm");
+Page[58]=new Array("This command allows you to turn the beeper on or off.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Recall setup Instrument reset","Saved setup","1 (beeper.ON)","Usage","state = beeper.enable","beeper.enable = state","state","Disable the beeper: beeper.OFF or 0","Enable the beeper: beeper.ON or 1","Details","This command enables or disables the beeper. When enabled, a beep signals that a front‑panel key has been pressed. Disabling the beeper also disables front‑panel key clicks.","Example","beeper.enable = beeper.ON","beeper.beep(2, 2400)","Enables the beeper and generates a two‑second, 2400 Hz tone.","Also see","beeper.beep()","beeper.enable","14435.htm");
+Page[59]=new Array("This function performs a bitwise logical AND operation on two numbers.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.bitand(value1, value2)","result","Result of the logical AND operation","value1","Operand for the logical AND operation","value2","Operand for the logical AND operation","Details","Any fractional parts of value1 and value2 are truncated to form integers. The returned result is also an integer.","Example","testResult = bit.bitand(10, 9)","print(testResult)","Performs a logical AND operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 8 (binary 1000).","Output:","8.00000e+00","Also see","Bit manipulation and logic operations","bit.bitor()","bit.bitxor()","bit.bitand()","14632.htm");
+Page[60]=new Array("This function performs a bitwise logical OR operation on two numbers.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.bitor(value1, value2)","result","Result of the logical OR operation","value1","Operand for the logical OR operation","value2","Operand for the logical OR operation","Details","Any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer.","Example","testResult = bit.bitor(10, 9)","print(testResult)","Performs a bitwise logical OR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 11 (binary 1011).","Output:","1.10000e+01","Also see","Bit manipulation and logic operations","bit.bitand()","bit.bitxor()","bit.bitor()","14634.htm");
+Page[61]=new Array("This function performs a bitwise logical XOR (exclusive OR) operation on two numbers.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.bitxor(value1, value2)","result","Result of the logical XOR operation","value1","Operand for the logical XOR operation","value2","Operand for the logical XOR operation","Details","Any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer.","Example","testResult = bit.bitxor(10, 9)","print(testResult)","Performs a logical XOR operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 3 (binary 0011).","Output:","3.00000e+00","Also see","Bit manipulation and logic operations","bit.bitand()","bit.bitor()","bit.bitxor()","14635.htm");
+Page[62]=new Array("This function clears a bit at a specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.clear(value, index)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to clear (1 to 32)","Details","Any fractional part of value is truncated to make it an integer. The returned result is also an integer.","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","Example","testResult = bit.clear(15, 2)","print(testResult)","The binary equivalent of decimal 15 is 1111. If you clear the bit at index position 2, the returned decimal value is 13 (binary 1101).","Output:","1.30000e+01","Also see","Bit manipulation and logic operations","bit.get()","bit.set()","bit.test()","bit.toggle()","bit.clear()","14636.htm");
+Page[63]=new Array("This function retrieves the weighted value of a bit at a specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.get(value, index)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to get (1 to 32)","Details","This function returns the value of the bit in value at index. This is the same as returning value with all other bits set to zero (0).","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","If the indexed bit for the number is set to zero (0), the result will be zero (0).","Example","testResult = bit.get(10, 4)","print(testResult)","The binary equivalent of decimal 10 is 1010. If you get the bit at index position 4, the returned decimal value is 8.","Output:","8.00000e+00","Also see","Bit manipulation and logic operations","bit.clear()","bit.set()","bit.test()","bit.toggle()","bit.get()","14637.htm");
+Page[64]=new Array("This function returns a field of bits from the value starting at the specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.getfield(value, index, width)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to get (1 to 32)","width","The number of bits to include in the field (1 to 32)","Details","A field of bits is a contiguous group of bits. This function retrieves a field of bits from value starting at index.","The index position is the least significant bit of the retrieved field. The number of bits to return is specified by width.","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","Example","myResult = bit.getfield(13, 2, 3)","print(myResult)","The binary equivalent of decimal 13 is 1101. ","The field at index position 2 and width 3 consists of the binary bits 110. The returned value is decimal 6 (binary 110).","Output:","6.00000e+00","Also see","Bit manipulation and logic operations","bit.get()","bit.set()","bit.setfield()","bit.getfield()","14638.htm");
+Page[65]=new Array("This function sets a bit at the specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.set(value, index)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to set (1 to 32)","Details","This function returns result, which is value with the indexed bit set. The index must be between 1 and 32.","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","Any fractional part of value is truncated to make it an integer.","Example","testResult = bit.set(8, 3)","print(testResult)","The binary equivalent of decimal 8 is 1000. If the bit at index position 3 is set to 1, the returned value is decimal 12 (binary 1100).","Output:","1.20000e+01","Also see","Bit manipulation and logic operations","bit.clear()","bit.get()","bit.getfield()","bit.setfield()","bit.test()","bit.toggle()","bit.set()","14639.htm");
+Page[66]=new Array("This function overwrites a bit field at a specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.setfield(value, index, width, fieldValue)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position in value to set (1 to 32)","width","The number of bits to include in the field (1 to 32)","fieldValue","Value to write to the field","Details","This function returns result, which is value with a field of bits overwritten, starting at index. The index specifies the position of the least significant bit of value. The width bits starting at index are set to fieldValue.","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","Before setting the field of bits, any fractional parts of value and fieldValue are truncated to form integers.","If fieldValue is wider than width, the most significant bits of the fieldValue that exceed the width are truncated. For example, if width is 4 bits and the binary value for fieldValue is 11110 (5 bits), the most significant bit of fieldValue is truncated and a binary value of 1110 is used.","Example","testResult = bit.setfield(15, 2, 3, 5)","print(testResult)","The binary equivalent of decimal 15 is 1111. After overwriting it with a decimal 5 (binary 101) at index position 2, the returned value is decimal 11 (binary 1011).","Output:","1.10000e+01","Also see","Bit manipulation and logic operations","bit.get()","bit.set()","bit.getfield()","bit.setfield()","14640.htm");
+Page[67]=new Array("This function returns the Boolean value (true or false) of a bit at the specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.test(value, index)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to test (1 to 32)","Details","This function returns result, which is the result of the tested bit. ","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","If the indexed bit for value is 0, result is false. If the bit of value at index is 1, the returned value is true.","If index is bigger than the number of bits in value, the result is false.","Example","testResult = bit.test(10, 4)","print(testResult)","The binary equivalent of decimal 10 is 1010. Testing the bit at index position 4 returns a Boolean value of true.","Output:","true","Also see","Bit manipulation and logic operations","bit.clear()","bit.get()","bit.set()","bit.toggle()","bit.test()","14641.htm");
+Page[68]=new Array("This function toggles the value of a bit at a specified index position.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","result = bit.toggle(value, index)","result","Result of the bit manipulation","value","Specified number","index","One‑based bit position within value to toggle (1 to 32)","Details","This function returns result, which is the result of toggling the bit index in value.","Any fractional part of value is truncated to make it an integer. The returned value is also an integer.","The least significant bit of value is at index position 1; the most significant bit is at index position 32.","The indexed bit for value is toggled from 0 to 1, or 1 to 0.","Example","testResult = bit.toggle(10, 3)","print(testResult)","The binary equivalent of decimal 10 is 1010. Toggling the bit at index position 3 returns a decimal value of 14 (binary 1110).","Output:","1.40000e+01","Also see","Bit manipulation and logic operations","bit.clear()","bit.get()","bit.set()","bit.test()","bit.toggle()","14642.htm");
+Page[69]=new Array("This attribute sets the state of the reading buffer's append mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","0 (disabled)","Usage","state = bufferVar.appendmode","bufferVar.appendmode = state","state","The reading buffer append mode; set to one of the following:","0: Append mode off; new measurement data overwrites the previous buffer content","1: Append mode on; appends new measurement data to the present buffer content","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","Assigning a value to this attribute enables or disables the buffer append mode. This value can only be changed with an empty buffer. Use bufferVar.clear() to empty the buffer.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","If the append mode is set to 0, any stored readings in the buffer are cleared before new ones are stored. If append mode is set to 1, any stored readings remain in the buffer and new readings are added to the buffer after the stored readings.","With append mode on, the first new measurement is stored at rb[n+1], where n is the number of readings stored in buffer rb.","Example","buffer1.appendmode = 1","Append new readings to contents of the reading buffer named buffer1.","Also see","bufferVar.clear()","Reading buffers","bufferVar.appendmode","15127.htm");
+Page[70]=new Array("This attribute contains the timestamp that indicates when the first reading was stored in the buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","See Details","0","Usage","basetime = bufferVar.basetimestamp","basetime","The timestamp of the first stored reading","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","Details","This read-only attribute contains the timestamp (in seconds) of the first reading stored in a buffer (rb[1] stored in reading buffer rb). The timestamp is the number of seconds since 12:00 am January 1, 1970 (UTC) that the measurement was performed and stored.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","See the smua.nvbufferY attribute for details on accessing dedicated reading buffers.","Example","basetime = smua.nvbuffer1.basetimestamp","print(basetime)","Read the timestamp for the first reading","stored in dedicated reading buffer 1.","Output:","1.57020e+09","This output indicates that the timestamp is 1,570,200,000 seconds (which is Friday, October, 4, 2019 at 14:40:00 pm).","Also see","Reading buffers","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.Y()","bufferVar.basetimestamp","15128.htm");
+Page[71]=new Array("This attribute enables or disables the reading buffer cache (on or off).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Not saved","1 (enabled)","Usage","cacheMode = bufferVar.cachemode","bufferVar.cachemode = cacheMode","cacheMode","The reading buffer cache mode; set to one of the following:","0: Cache mode disabled (off)","1: Cache mode enabled (on)","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","Assigning a value to this attribute enables or disables the reading buffer cache. When enabled, the reading buffer cache improves access speed to reading buffer data. ","If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data. This can happen when initiating successive sweeps without reconfiguring the sweep measurements or when overwriting data in the reading buffer by setting the bufferVar.fillmode attribute to smua.FILL_WINDOW. To avoid this, make sure that you include commands that automatically invalidate the cache as needed (for example, explicit calls to the bufferVar.clearcache() function) or disable the cache using this attribute (bufferVar.cachemode).","Example","smua.nvbuffer1.cachemode = 1","Enables reading buffer cache of dedicated reading buffer 1 (source‑measure unit (SMU) channel A).","Also see","bufferVar.clearcache()","bufferVar.fillmode","Reading buffers","bufferVar.cachemode","17109.htm");
+Page[72]=new Array("This attribute sets the number of readings a buffer can store.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","See Details","Not applicable","Usage","bufferCapacity = bufferVar.capacity","bufferCapacity","The maximum number of readings the buffer can store","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","This read-only attribute reads the number of readings that can be stored in the buffer.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","The capacity of the buffer does not change as readings fill the buffer. A dedicated reading buffer that only collects basic items can store over 140,000 readings. Turning on additional collection items, such as timestamps and source values, decreases the capacity of a dedicated reading buffer (for example, smua.nvbuffer1), but does not change the capacity of a user-defined dynamically allocated buffer. A user-defined dynamically allocated buffer has a fixed capacity that is set when the buffer is created.","See the smua.nvbufferY attribute for details on accessing dedicated reading buffers. See the smua.makebuffer() function for information on creating user-defined dynamically allocated reading buffers.","Example","bufferCapacity = smua.nvbuffer1.capacity","print(bufferCapacity)","Reads the capacity of dedicated reading buffer 1 (source‑measure unit (SMU) channel A).","Output:","1.49789e+05","The above output indicates that the buffer can hold 149789 readings.","Also see","Reading buffers","smua.makebuffer()","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.Y()","bufferVar.capacity","15129.htm");
+Page[73]=new Array("This function empties the buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","bufferVar.clear()","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","This function clears all readings and related recall attributes from the buffer (for example, bufferVar.timestamps and bufferVar.statuses) from the specified buffer.","Example","smua.nvbuffer1.clear()","Clears dedicated reading buffer 1 (source‑measure unit (SMU) channel A).","Also see","Reading buffers","smua.nvbufferY","bufferVar.clear()","15130.htm");
+Page[74]=new Array("This function clears the cache.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","bufferVar.clearcache()","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","This function clears all readings from the specified cache. ","If you run successive operations that overwrite reading buffer data, the reading buffer may return stale cache data. This can happen when you:","Initiate successive sweeps without reconfiguring the sweep measurements. Watch for this when running Lua code remotely on more than one node, because values in the reading buffer cache may change while the Lua code is running.","Overwrite data in the reading buffer by setting the bufferVar.fillmode attribute to smua.FILL_WINDOW.","To avoid this, you can include explicit calls to the bufferVar.clearcache() function to remove stale values from the reading buffer cache.","Example","smua.nvbuffer1.clearcache()","Clears the reading buffer cache for dedicated reading buffer 1.","Also see","bufferVar.fillmode","Reading buffers","Removing stale values from the reading buffer cache","smua.nvbufferY","bufferVar.clearcache()","15131.htm");
+Page[75]=new Array("This attribute sets whether or not source values are stored with the readings in the buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","0 (disabled)","Usage","state = bufferVar.collectsourcevalues","bufferVar.collectsourcevalues = state","state","Source value collection status; set to one of the following:","0: Source value collection disabled (off)","1: Source value collection enabled (on)","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","Details","Assigning a value to this attribute enables or disables the storage of source values. Reading this attribute returns the state of source value collection. This value can only be changed with an empty buffer. Empty the buffer using the bufferVar.clear() function.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","When on, source values are stored with readings in the buffer. This requires four extra bytes of storage for each reading. Turning on additional collection items, such as source values (this attribute) and timestamps, decreases the capacity of a dedicated reading buffer, but does not change the capacity of a user-defined dynamically allocated buffer.","You cannot collect source values when smua.trigger.measure.action is set to smua.ASYNC, so this must be set to 0 when the measurement action is set to be asynchronous.","Example","smua.nvbuffer1.collectsourcevalues = 1","Include source values with readings for dedicated reading buffer 1.","Also see","bufferVar.clear()","Reading buffers","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.action","smua.trigger.measure.Y()","bufferVar.collectsourcevalues","15132.htm");
+Page[76]=new Array("This attribute sets whether or not timestamp values are stored with the readings in the buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","0 (disabled)","Usage","state = bufferVar.collecttimestamps","bufferVar.collecttimestamps = state","state","Timestamp value collection status; set to one of the following:","0: Timestamp value collection disabled (off)","1: Timestamp value collection enabled (on)","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","Assigning a value to this attribute enables or disables the storage of timestamps. Reading this attribute returns the state of timestamp collection. ","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","When on, timestamp values are stored with readings in the buffer. This requires four extra bytes of storage for each reading. Turning on additional collection items, such as timestamps (this attribute) and source values, decreases the capacity of a dedicated reading buffer (for example, smua.nvbuffer1), but does not change the capacity of a user-defined dynamically allocated buffer.","This value, off (0) or on (1), can only be changed when the buffer is empty. Empty the buffer using the bufferVar.clear() function.","Example","smua.nvbuffer1.collecttimestamps = 1","Include timestamps with readings for dedicated reading buffer 1.","Also see","bufferVar.clear()","Reading buffers","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.Y()","bufferVar.collecttimestamps","15133.htm");
+Page[77]=new Array("This attribute sets the reading buffer fill count.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","0","Usage","fillCount = bufferVar.fillcount","bufferVar.fillcount = fillCount","fillCount","The reading buffer fill count","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","Details","The reading buffer fill count sets the number of readings to store before restarting at index 1. If the value is zero (0), then the capacity of the buffer is used. Use this attribute to control when the SMU restarts filling the buffer at index 1, rather than having it restart when the buffer is full. ","If the bufferVar.fillcount attribute is set to a value higher than the capacity of the buffer, after storing the element at the end of the buffer, the SMU will overwrite the reading at index 1, the reading after that will overwrite the reading at index 2, and so on.","This attribute is only used when the bufferVar.fillmode attribute is set to smua.FILL_WINDOW.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","smua.nvbuffer1.fillcount = 50","Sets fill count of dedicated reading buffer 1 to 50.","Also see","bufferVar.fillmode","bufferVar.fillcount","18551.htm");
+Page[78]=new Array("This attribute sets the reading buffer fill mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","0 (smua.FILL_ONCE)","Usage","fillMode = bufferVar.fillmode","bufferVar.fillmode = fillMode","fillMode","The reading buffer fill mode; set to one of the following:","0 or smua.FILL_ONCE: Do not overwrite old data","1 or smua.FILL_WINDOW: New readings restart at index 1 after acquiring reading at index bufferVar.fillcount","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","Details","When this attribute is set to smua.FILL_ONCE, the reading buffer will not overwrite readings. If the buffer fills up, new readings will be discarded. ","When this attribute is set to smua.FILL_WINDOW, new readings will be added after existing data until the buffer holds bufferVar.fillcount elements. Continuing the sequence, the next reading will overwrite the reading at index 1, the reading after that will overwrite the reading at index 2, and so on. ","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","smua.nvbuffer1.fillmode = smua.FILL_ONCE","Sets fill mode of dedicated reading buffer 1 to fill once (do not overwrite old data).","Also see","bufferVar.fillcount","Reading buffers","bufferVar.fillmode","18552.htm");
+Page[79]=new Array("This attribute contains the measurement function that was used to acquire a reading stored in a specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","measurefunction = bufferVar.measurefunctions[N]","measurefunction","The measurement function used (Current, Voltage, Ohms, or Watts) to acquire reading number N in the specified buffer","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","The measurefunctions buffer recall attribute is like an array (a Lua table) of strings indicating the function measured for the reading.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example 1","measurefunction = smua.nvbuffer1.measurefunctions[5]","Store the measure function used to make reading number 5.","Example 2","printbuffer(1, 5, smua.nvbuffer1.measurefunctions)","Print the measurement function that was used to measure the first five readings saved in dedicated reading buffer 1.","Example output:","Current, Current, Current, Current, Current","Also see","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.measurefunctions","19914.htm");
+Page[80]=new Array("This attribute contains the measurement range values that were used for readings stored in a specified buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","measurerange = bufferVar.measureranges[N]","measurerange","The measurement range used to acquire reading number N in the specified buffer","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","The measureranges buffer recall attribute is like an array (a Lua table) of full-scale range values for the measure range used when the measurement was made.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example 1","measurerange = smua.nvbuffer1.measureranges[1]","Store the measure range that was used to make reading number 1.","Example 2","printbuffer(1, 10, smua.nvbuffer1.measureranges)","Print the range values that were used for the first 10 readings saved in dedicated reading buffer 1.","Example output:","1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07, 1.00000e-07","Also see","bufferVar.measurefunctions","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.measureranges","19915.htm");
+Page[81]=new Array("This attribute contains the number of readings in the buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","numberOfReadings = bufferVar.n","numberOfReadings","The number of readings stored in the buffer","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","This read-only attribute contains the number of readings presently stored in the buffer.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","numberOfReadings = smua.nvbuffer1.n","print(numberOfReadings)","Reads the number of readings stored in dedicated reading buffer 1 (source‑measure unit (SMU) channel A).","Output:","1.25000+02","The above output indicates that there are 125 readings stored in the buffer.","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.Y()","bufferVar.n","15134.htm");
+Page[82]=new Array("This attribute contains the readings stored in a specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","reading = bufferVar.readings[N]","reading","The value of the reading in the specified reading buffer","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","N","The reading number N; can be any value from 1 to the number of readings in the buffer; use the bufferVar.n command to determine the number of readings in the buffer","Details","The readings buffer recall attribute is like an array (a Lua table) of the readings stored in the reading buffer. This array holds the same data that is returned when the reading buffer is accessed directly; that is, rb[2] and rb.readings[2] access the same value.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","print(smua.nvbuffer1.readings[1])","Output the first reading saved in source‑measure unit (SMU) channel A, dedicated reading buffer 1.","Output:","8.81658e-08","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.readings","19920.htm");
+Page[83]=new Array("This attribute contains the source function that was being used when the readings were stored in a specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","sourcefunction = bufferVar.sourcefunctions[N]","sourcefunction","The source function used (Current or Voltage) to acquire reading number N in the specified buffer","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","The sourcefunctions buffer recall attribute is like an array (a Lua table) of strings indicating the source function at the time of the measurement.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example 1","sourcefunction = smua.nvbuffer1.sourcefunctions[3]","print(sourcefunction)","Store the source function used to make reading number 3 and output the value.","Example 2","printbuffer(1, 10, smua.nvbuffer1.sourcefunctions)","Print the source function used for 10 readings stored in dedicated reading buffer 1.","Example output:","Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage, Voltage","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.sourcefunctions","19916.htm");
+Page[84]=new Array("This attribute indicates the state of the source output for readings that are stored in a specified buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","state = bufferVar.sourceoutputstates[N]","state","The output state (Off or On) when reading N of the specified buffer was acquired","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","The sourceoutputstates buffer recall attribute is similar to an array (a Lua table) of strings. This array indicates the state of the source output (Off or On) at the time of the measurement.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","printbuffer(1, 1, smua.nvbuffer1.sourceoutputstates)","Print the source output for the first reading stored in dedicated reading buffer 1.","Example output:","On","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.sourceoutputstates","19917.htm");
+Page[85]=new Array("This attribute contains the source range that was used for readings stored in a specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","sourcerange = bufferVar.sourceranges[N]","sourcerange","The source range used to acquire reading number N in the specified buffer","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","The sourceranges buffer recall attribute is like an array (a Lua table) of full-scale range values for the source range used when the measurement was made.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example 1","sourcerange = smua.nvbuffer1.sourceranges[1]","Store the source range that was used for the first reading stored in dedicated reading buffer 1.","Example 2","printbuffer(1, 6, smua.nvbuffer1.sourceranges)","Print the source ranges that were used for the first 6 readings stored in source‑measure unit (SMU) A, buffer 1.","Example output:","1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04, 1.00000e-04","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourcevalues","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.sourceranges","19918.htm");
+Page[86]=new Array("When enabled by the bufferVar.collectsourcevalues attribute, this attribute contains the source levels being output when readings in the reading buffer were acquired.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","sourcevalue = bufferVar.sourcevalues[N]","sourcevalue","The output value of the source when reading N of the specified buffer was acquired","bufferVar","The reading buffer; can be a dynamically allocated buffer (user‑defined), or a dedicated reading buffer (such as smua.nvbuffer1)","N","The reading number (1 to bufferVar.n)","Details","If the bufferVar.collectsourcevalues attribute is enabled before readings are taken, the bufferVar.sourcevalues buffer recall attribute is like an array (a Lua table) of the sourced value in effect at the time of the reading. Note that you can set the bufferVar.collectsourcevalues attribute only if the affected reading buffer is empty. See bufferVar.collectsourcevalues for more detailed information.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example 1","sourcevalue = smua.nvbuffer1.sourcevalues[1]","Get the sourced value of the first reading stored in dedicated reading buffer 1.","Example 2","printbuffer(1, 6, smua.nvbuffer1.sourcevalues)","Print the sourced value of the first 6 readings stored in source‑measure unit (SMU) A, buffer 1.","Example output:","1.00000e-04, 1.00000e-04,","1.00000e-04, 1.00000e-04,","1.00000e-04, 1.00000e-04","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.statuses","bufferVar.timestamps","Reading buffers","bufferVar.sourcevalues","19919.htm");
+Page[87]=new Array("This attribute contains the status values of readings in the reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","statusInformation = bufferVar.statuses[N]","statusInformation","The status value when reading N of the specified buffer was acquired","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","N","The reading number N; can be any value from 1 to the number of readings in the buffer; use the bufferVar.n command to determine the number of readings in the buffer","Details","This read‑only buffer recall attribute is like an array (a Lua table) of the status values for all the readings in the buffer. The status values are floating-point numbers that encode the status value; see the following table for values. ","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Buffer status bits","Bit","Name","Hex","Description when bit is true","B0","Pulser","0x01","Pulser is enabled","B1","Overtemp","0x02","Overtemperature condition","B2","AutoRangeMeas","0x04","Measure range was autoranged","B3","AutoRangeSrc","0x08","Source range was autoranged","B4","4Wire","0x10","4-wire (remote) sense mode enabled","B5","Rel","0x20","Relative offset applied to reading","B6","Compliance","0x40","Source function was limited because the complementary function would be over the compliance limit","B7","Filtered","0x80","Reading was filtered","Example","reset() ","smua.source.func = smua.OUTPUT_DCVOLTS","smua.source.autorangev = smua.AUTORANGE_ON","smua.source.levelv = 5 ","smua.source.limiti = 10e-3","smua.measure.rangei = 10e-3","smua.source.output = smua.OUTPUT_ON","print(smua.measure.i(smua.nvbuffer1))","smua.source.output = smua.OUTPUT_OFF","print(smua.nvbuffer1.statuses[1])","Reset the instrument.","Set the voltage source function to DC volts. Set the range to auto.","Set the voltage source to 5 V.","Set current measure limit to 10 mA.","Set the current measure range to 10 mA.","Turn on the output.","Print and place the current reading in the reading buffer.","Turn off the output.","Output status value of the first measurement in the reading buffer. ","Output example:","3.99470e-06","4.00000e+00","Also see","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.timestamps","Reading buffers","bufferVar.statuses","92702.htm");
+Page[88]=new Array("This attribute contains the resolution of the timestamp.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","See Details","1e-6 (1 µs)","Usage","resolution = bufferVar.timestampresolution","resolution","Timestamp resolution in seconds","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","Details","Assigning a value to this attribute sets the resolution for the timestamps. Reading this attribute returns the timestamp resolution value. This value can only be changed with an empty buffer. Empty the buffer using the bufferVar.clear() function.","The finest timestamp resolution is 0.000001 seconds (1 μs). At this resolution, the reading buffer can store unique timestamps for up to 71 minutes. This value can be increased for very long tests.","The value specified when setting this attribute will be rounded to an even power of 2 µs.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","smua.nvbuffer1.timestampresolution = 0.000008","Sets the timestamp resolution of dedicated reading buffer 1 to 8 μs.","Also see","bufferVar.clear()","bufferVar.collecttimestamps","bufferVar.timestamps","Reading buffers","smua.measure.overlappedY()","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.Y()","bufferVar.timestampresolution","15135.htm");
+Page[89]=new Array("When enabled by the bufferVar.collecttimestamps attribute, this attribute contains the timestamp when each reading saved in the specified reading buffer occurred.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Clearing the buffer","See Details","Not applicable","Usage","timestamp = bufferVar.timestamps[N]","timestamp","The complete timestamp (including date, time, and fractional seconds) of reading number N in the specified reading buffer when the reading was acquired","bufferVar","The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer","N","The reading number (1 to bufferVar.n)","Details","The bufferVar.timestamps information from a reading buffer is only available if the bufferVar.collecttimestamps attribute is set to 1 (default setting). If it is set to 0, you cannot access any time information from a reading buffer. ","If enabled, this buffer recall attribute is like an array (a Lua table) that contains timestamps, in seconds, of when each reading occurred. These are relative to the bufferVar.basetimestamp for the buffer.","For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory.","Example","timestamp = smua.nvbuffer1.timestamps[1]","Get the timestamp of the first reading stored in source‑measure unit (SMU) A, buffer 1.","Also see","bufferVar.clear()","bufferVar.collecttimestamps","bufferVar.measurefunctions","bufferVar.measureranges","bufferVar.n","bufferVar.readings","bufferVar.sourcefunctions","bufferVar.sourceoutputstates","bufferVar.sourceranges","bufferVar.sourcevalues","bufferVar.statuses","Reading buffers","bufferVar.timestamps","19922.htm");
+Page[90]=new Array("This function adds an entry to the data queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","result = dataqueue.add(value)","result = dataqueue.add(value, timeout)","result","The resulting value of true or false based on the success of the function","value","The data item to add; value can be of any type","timeout","The maximum number of seconds to wait for space in the data queue","Details","You cannot use the timeout value when accessing the data queue from a remote node (you can only use the timeout value while adding data to the local data queue).","The timeout value is ignored if the data queue is not full.","The dataqueue.add() function returns false:","If the timeout expires before space is available in the data queue","If the data queue is full and a timeout value is not specified","If the value is a table, a duplicate of the table and any subtables is made. The duplicate table does not contain any references to the original table or to any subtables.","Example","dataqueue.clear()","dataqueue.add(10)","dataqueue.add(11, 2)","result = dataqueue.add(12, 3)","if result == false then"," print("Failed to add 12 to the dataqueue")","end","print("The dataqueue contains:")","while dataqueue.count > 0 do"," print(dataqueue.next())","end","Clear the data queue.","Each line adds one item to the data queue.","Output:","The dataqueue contains:","10","11","12","Also see","dataqueue.CAPACITY","dataqueue.clear()","dataqueue.count","dataqueue.next()","Using the data queue for real-time communication","dataqueue.add()","14654.htm");
+Page[91]=new Array("This constant is the maximum number of entries that you can store in the data queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","count = dataqueue.CAPACITY","count","The variable that is assigned the value of dataqueue.CAPACITY","Details","This constant always returns the maximum number of entries that can be stored in the data queue.","Example","MaxCount = dataqueue.CAPACITY","while dataqueue.count < MaxCount do"," dataqueue.add(1)","end","print("There are " .. dataqueue.count"," .. " items in the data queue")","This example fills the data queue until it is full and prints the number of items in the queue.","Output:","There are 128 items in the data queue","Also see","dataqueue.add()","dataqueue.clear()","dataqueue.count","dataqueue.next()","Using the data queue for real-time communication","dataqueue.CAPACITY","14656.htm");
+Page[92]=new Array("This function clears the data queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","dataqueue.clear()","Details","This function forces all dataqueue.add() commands that are in progress to time out and deletes all data from the data queue.","Example","MaxCount = dataqueue.CAPACITY","while dataqueue.count < MaxCount do"," dataqueue.add(1)","end","print("There are " .. dataqueue.count"," .. " items in the data queue")","dataqueue.clear()","print("There are " .. dataqueue.count"," .. " items in the data queue")","This example fills the data queue and prints the number of items in the queue. It then clears the queue and prints the number of items again.","Output:","There are 128 items in the data queue","There are 0 items in the data queue","Also see","dataqueue.add()","dataqueue.CAPACITY","dataqueue.count","dataqueue.next()","Using the data queue for real-time communication","dataqueue.clear()","14655.htm");
+Page[93]=new Array("This attribute contains the number of items in the data queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","count = dataqueue.count","count","The number of items in the data queue","Details","The count is updated as entries are added with dataqueue.add() and read from the data queue with dataqueue.next(). It is also updated when the data queue is cleared with dataqueue.clear().","A maximum of dataqueue.CAPACITY items can be stored at any one time in the data queue.","Example","MaxCount = dataqueue.CAPACITY","while dataqueue.count < MaxCount do"," dataqueue.add(1)","end","print("There are " .. dataqueue.count"," .. " items in the data queue")","dataqueue.clear()","print("There are " .. dataqueue.count"," .. " items in the data queue")","This example fills the data queue and prints the number of items in the queue. It then clears the queue and prints the number of items again.","Output:","There are 128 items in the data queue","There are 0 items in the data queue","Also see","dataqueue.add()","dataqueue.CAPACITY","dataqueue.clear()","dataqueue.next()","Using the data queue for real-time communication","dataqueue.count","14657.htm");
+Page[94]=new Array("This function removes the next entry from the data queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","value = dataqueue.next()","value = dataqueue.next(timeout)","value","The next entry in the data queue","timeout","The number of seconds to wait for data in the queue","Details","If the data queue is empty, the function waits up to the timeout value.","If data is not available in the data queue before the timeout expires, the return value is nil.","The entries in the data queue are removed in first-in, first-out (FIFO) order.","If the value is a table, a duplicate of the original table and any subtables is made. The duplicate table does not contain any references to the original table or to any subtables.","Example","dataqueue.clear()","for i = 1, 10 do"," dataqueue.add(i)","end","print("There are " .. dataqueue.count"," .. " items in the data queue")","while dataqueue.count > 0 do"," x = dataqueue.next()"," print(x)","end","print("There are " .. dataqueue.count"," .. " items in the data queue")","Clears the data queue, adds ten entries, then reads the entries from the data queue. Note that your output may differ depending on the setting of format.asciiprecision.","Output:","There are 10 items in the data queue","1","2","3","4","5","6","7","8","9","10","There are 0 items in the data queue","Also see","dataqueue.add()","dataqueue.CAPACITY","dataqueue.clear()","dataqueue.count","format.asciiprecision","Using the data queue for real-time communication","dataqueue.next()","14658.htm");
+Page[95]=new Array("This function delays the execution of the commands that follow it.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","delay(seconds)","seconds","The number of seconds to delay (0 to 100 ks)","Details","The instrument delays execution of the commands for at least the specified number of seconds and fractional seconds. However, the processing time may cause the instrument to delay 5 μs to 10 μs (typical) more than the requested delay.","Example","beeper.beep(0.5, 2400)","delay(0.250)","beeper.beep(0.5, 2400)","Emit a double‑beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on.","Also see","None","delay()","13949.htm");
+Page[96]=new Array("This function reads one digital I/O line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data = digio.readbit(N)","data","The state of the I/O line","N","Digital I/O line number to be read (1 to 14)","Details","A returned value of zero (0) indicates that the line is low. A returned value of one (1) indicates that the line is high.","Example","print(digio.readbit(4))","Assume line 4 is set high, and it is then read.","Output:","1.00000e+00","Also see","digio.readport()","digio.writebit()","digio.writeport()","Digital I/O port","digio.readbit()","14668.htm");
+Page[97]=new Array("This function reads the digital I/O port. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data = digio.readport()","data","The present value of the input lines on the digital I/O port","Details","The binary equivalent of the returned value indicates the value of the input lines on the I/O port. The least significant bit (bit B1) of the binary number corresponds to line 1; bit B14 corresponds to line 14.","For example, a returned value of 170 has a binary equivalent of 000000010101010, which indicates that lines 2, 4, 6, and 8 are high (1), and the other 10 lines are low (0).","Example","data = digio.readport()","print(data)","Assume lines 2, 4, 6, and 8 are set high when the I/O port is read.","Output:","1.70000e+02","This is binary 10101010","Also see","digio.readbit()","digio.writebit()","digio.writeport()","Digital I/O port","digio.readport()","14669.htm");
+Page[98]=new Array("This function asserts a trigger pulse on one of the digital I/O lines. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.trigger[N].assert()","N","Digital I/O trigger line (1 to 14)","Details","The pulse width that is set determines how long the instrument asserts the trigger.","Example","digio.trigger[2].assert()","Asserts a trigger on digital I/O line 2.","Also see","digio.trigger[N].pulsewidth","digio.trigger[N].assert()","14670.htm");
+Page[99]=new Array("This function clears the trigger event on a digital I/O line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.trigger[N].clear()","N","Digital I/O trigger line (1 to 14)","Details","The event detector of a trigger enters the detected state when an event is detected. It is cleared when digio.trigger[N].wait() or digio.trigger[N].clear() is called.","digio.trigger[N].clear() clears the event detector of the specified trigger line, discards the history of the trigger line, and clears the digio.trigger[N].overrun attribute.","Example","digio.trigger[2].clear()","Clears the trigger event detector on I/O line 2.","Also see","digio.trigger[N].overrun","digio.trigger[N].wait()","digio.trigger[N].clear()","14671.htm");
+Page[100]=new Array("This constant identifies the trigger event generated by the digital I/O line N. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = digio.trigger[N].EVENT_ID","eventID","The trigger event number","N","Digital I/O trigger line (1 to 14)","Details","To have another trigger object respond to trigger events generated by the trigger line, set the stimulus attribute of the other object to the value of this constant.","Example","digio.trigger[5].stimulus = digio.trigger[3].EVENT_ID","Uses a trigger event on digital I/O trigger line 3 to be the stimulus for digital I/O trigger line 5.","Also see","None","digio.trigger[N].EVENT_ID","14672.htm");
+Page[101]=new Array("This attribute sets the mode in which the trigger event detector and the output trigger generator operate on the given trigger line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Digital I/O trigger N reset Recall setup","Not saved ","0 (digio.TRIG_BYPASS)","Usage","triggerMode = digio.trigger[N].mode","digio.trigger[N].mode = triggerMode","triggerMode","The trigger mode; see Details for values","N","Digital I/O trigger line (1 to 14)","Details","Set triggerMode to one of the following values:","Trigger mode values","triggerMode","Description","digio.TRIG_BYPASS or 0","Allows direct control of the line.","digio.TRIG_FALLING or 1","Detects falling‑edge triggers as input; asserts a TTL-low pulse for output.","digio.TRIG_RISING or 2","If the programmed state of the line is high, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGA. If the programmed state of the line is low, the digio.TRIG_RISING mode behavior is similar to digio.TRIG_RISINGM. This setting should only be used if necessary for compatibility with other Keithley Instruments products.","digio.TRIG_EITHER or 3","Detects rising- or falling‑edge triggers as input. Asserts a TTL‑low pulse for output.","digio.TRIG_SYNCHRONOUSA or 4","Detects the falling‑edge input triggers and automatically latches and drives the trigger line low. Asserting the output trigger releases the latched line.","digio.TRIG_SYNCHRONOUS or 5","Detects the falling‑edge input triggers and automatically latches and drives the trigger line low. Asserts a TTL‑low pulse as an output trigger.","digio.TRIG_SYNCHRONOUSM or 6","Detects rising‑edge triggers as input. Asserts a TTL‑low pulse for output.","digio.TRIG_RISINGA or 7","Detects rising‑edge triggers as input. Asserts a TTL‑low pulse for output.","digio.TRIG_RISINGM or 8","Asserts a TTL-high pulse for output. Input edge detection is not possible in this mode.","When programmed to any mode except digio.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user‑specified output state of the line is ignored.","Use of either digio.TRIG_SYNCHRONOUSA or digio.TRIG_SYNCHRONOUSM is preferred over digio.TRIG_SYNCHRONOUS, because digio.TRIG_SYNCHRONOUS is provided for compatibility with the digital I/O and TSP-Link triggering on older firmware.","To control the line state, set the mode to digio.TRIG_BYPASS and use the digio.writebit() and digio.writeport() commands.","Example","digio.trigger[4].mode = 2","Sets the trigger mode for I/O line 4 to digio.TRIG_RISING.","Also see","digio.trigger[N].clear()","digio.trigger[N].reset()","digio.writebit()","digio.writeport()","Sweep operation","digio.trigger[N].mode","14674.htm");
+Page[102]=new Array("This attribute returns the event detector overrun status. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset Digital I/O trigger N clear Digital I/O trigger N reset Recall setup","Not saved","Not applicable","Usage","overrun = digio.trigger[N].overrun","overrun","Trigger overrun state (true or false)","N","Digital I/O trigger line (1 to 14)","Details","If this is true, an event was ignored because the event detector was already in the detected state when the event occurred.","This is an indication of the state of the event detector built into the line itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.","Example","overrun = digio.trigger[1].overrun","print(overrun)","If there is no trigger overrun, the following text is output:","false","Also see","digio.trigger[N].clear()","digio.trigger[N].reset()","digio.trigger[N].overrun","14675.htm");
+Page[103]=new Array("This attribute describes the length of time that the trigger line is asserted for output triggers. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Digital I/O trigger N reset Recall setup","Not saved ","10e-6 (10 µs)","Usage","width = digio.trigger[N].pulsewidth","digio.trigger[N].pulsewidth = width","width","The pulse width (seconds)","N","Digital I/O trigger line (1 to 14)","Details","Setting the pulse width to zero (0) seconds asserts the trigger indefinitely. To release the trigger line, use digio.trigger[N].release().","Example","digio.trigger[4].pulsewidth = 20e-6","Sets the pulse width for trigger line 4 to 20 μs.","Also see","digio.trigger[N].assert()","digio.trigger[N].reset()","digio.trigger[N].release()","digio.trigger[N].pulsewidth","17691.htm");
+Page[104]=new Array("This function releases an indefinite length or latched trigger. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.trigger[N].release()","N","Digital I/O trigger line (1 to 14)","Details","Releases a trigger that was asserted with an indefinite pulsewidth time. It also releases a trigger that was latched in response to receiving a synchronous mode trigger. Only the specified trigger line is affected.","Example","digio.trigger[4].release()","Releases digital I/O trigger line 4.","Also see","digio.trigger[N].assert()","digio.trigger[N].pulsewidth","digio.trigger[N].release()","14677.htm");
+Page[105]=new Array("This function resets trigger values to their factory defaults. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.trigger[N].reset()","N","Digital I/O trigger line (1 to 14)","Details","This function resets the following attributes to factory default settings:","digio.trigger[N].mode","digio.trigger[N].pulsewidth","digio.trigger[N].stimulus","It also clears digio.trigger[N].overrun.","Example","digio.trigger[3].mode = 2","digio.trigger[3].pulsewidth = 50e-6","digio.trigger[3].stimulus = digio.trigger[5].EVENT_ID","print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus)","digio.trigger[3].reset()","print(digio.trigger[3].mode, digio.trigger[3].pulsewidth, digio.trigger[3].stimulus)","Set the digital I/O trigger line 3 for a falling edge with a pulsewidth of 50 µs.","Use digital I/O line 5 to trigger the event on line 3.","Reset the line back to factory default values.","Output before reset:","2.00000e+00 5.00000e-05 5.00000e+00","Output after reset:","0.00000e+00 1.00000e-05 0.00000e+00","Also see","digio.trigger[N].mode","digio.trigger[N].overrun","digio.trigger[N].pulsewidth","digio.trigger[N].stimulus","digio.trigger[N].reset()","17719.htm");
+Page[106]=new Array("This attribute selects the event that causes a trigger to be asserted on the digital output line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Digital I/O trigger N reset Recall setup","Not saved","0","Usage","triggerStimulus = digio.trigger[N].stimulus","digio.trigger[N].stimulus = triggerStimulus","triggerStimulus","The event identifier for the triggering event","N","Digital I/O trigger line (1 to 14)","Details","Set this attribute to zero (0) to disable the automatic trigger output.","Do not use the stimulus attribute for generating output triggers under script control. Use digio.trigger[N].assert() instead.","The trigger stimulus for a digital I/O line may be set to one of the existing trigger event IDs, described in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example 1","digio.trigger[3].stimulus = 0","Clear the trigger stimulus of digital I/O line 3.","Example 2","digio.trigger[3].stimulus = smua.trigger.SOURCE_COMPLETE_EVENT_ID","Set the trigger stimulus of digital I/O line 3 to be the source complete event.","Also see","digio.trigger[N].assert()","digio.trigger[N].clear()","digio.trigger[N].reset()","digio.trigger[N].stimulus","26898.htm");
+Page[107]=new Array("This function waits for a trigger. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = digio.trigger[N].wait(timeout)","triggered","The value true if a trigger is detected, or false if no triggers are detected during the timeout period","N","Digital I/O trigger line (1 to 14)","timeout","Timeout in seconds","Details","This function pauses for up to timeout seconds for an input trigger. If one or more trigger events are detected since the last time digio.trigger[N].wait() or digio.trigger[N].clear() was called, this function returns a value immediately. After waiting for a trigger with this function, the event detector is automatically reset and ready to detect the next trigger. This is true regardless of the number of events detected.","Example","triggered = digio.trigger[4].wait(3)","print(triggered)","Waits up to three seconds for a trigger to be detected on trigger line 4, then outputs the results.","Output if no trigger is detected:","false","Output if a trigger is detected:","true","Also see","digio.trigger[N].clear()","digio.trigger[N].wait()","14679.htm");
+Page[108]=new Array("This function sets a digital I/O line high or low. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.writebit(N, data)","N","Digital I/O trigger line (1 to 14)","data","The value to write to the bit:","0 (low)","Non‑zero (high)","Details","If the output line is write‑protected using the digio.writeprotect attribute, the command is ignored.","The reset() function does not affect the present state of the digital I/O lines.","Use the digio.writebit() and digio.writeport() commands to control the output state of the synchronization line when trigger operation is set to digio.TRIG_BYPASS.","The data must be zero (0) to clear the bit. Any value other than zero (0) sets the bit.","Example","digio.writebit(4, 0)","Sets digital I/O line 4 low (0).","Also see","digio.readbit()","digio.readport()","digio.trigger[N].mode","digio.writeport()","digio.writeprotect","digio.writebit()","14680.htm");
+Page[109]=new Array("This function writes to all digital I/O lines. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","digio.writeport(data)","data","Value to write to the port (0 to 16383)","Details","The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6, and 8 are set high (1), and the other 10 lines are set low (0).","Write‑protected lines are not changed.","The reset() function does not affect the present states of the digital I/O lines.","Use the digio.writebit() and digio.writeport() commands to control the output state of the synchronization line when trigger operation is set to digio.TRIG_BYPASS.","Example","digio.writeport(255)","Sets digital I/O Lines 1 through 8 high (binary 00000011111111).","Also see","digio.readbit()","digio.readport()","digio.writebit()","digio.writeprotect","digio.writeport()","14681.htm");
+Page[110]=new Array("This attribute contains the write‑protect mask that protects bits from changes from the digio.writebit() and digio.writeport() functions. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","0"," ","Usage","mask = digio.writeprotect","digio.writeprotect = mask","mask","Sets the value that specifies the bit pattern for write‑protect","Details","Bits that are set to one cause the corresponding line to be write‑protected.","The binary equivalent of mask indicates the mask to be set for the I/O port. For example, a mask value of 7 has a binary equivalent of 00000000000111. This mask write‑protects lines 1, 2, and 3.","Example","digio.writeprotect = 15","Write‑protects lines 1, 2, 3, and 4.","Also see","digio.writebit()","digio.writeport()","digio.writeprotect","14682.htm");
+Page[111]=new Array("This function clears all lines of the front‑panel display.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.clear()","Details","This function switches to the user screen and then clears the front‑panel display.","The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.","Also see","display.setcursor()","display.settext()","display.clear()","14699.htm");
+Page[112]=new Array("This function reads the annunciators (indicators) that are presently turned on.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","annunciators = display.getannunciators()","annunciators","The bitmasked value that shows which indicators are turned on","Details","This function returns a bitmasked value showing which indicators are turned on. The 16‑bit binary equivalent of the returned value is the bitmask. The return value is a sum of set annunciators, based on the weighted value, as shown in the following table.","Annunciator (indicator) bitmasked values and equivalent constants","Indicator","Bit","Weighted value","Equivalent constant","FILT","1","1","display.ANNUNCIATOR_FILTER","MATH","2","2","display.ANNUNCIATOR_MATH","4W","3","4","display.ANNUNCIATOR_4_WIRE","AUTO","4","8","display.ANNUNCIATOR_AUTO","ARM","5","16","display.ANNUNCIATOR_ARM","TRIG","6","32","display.ANNUNCIATOR_TRIGGER","* (asterisk)","7","64","display.ANNUNCIATOR_STAR","SMPL","8","128","display.ANNUNCIATOR_SAMPLE","EDIT","9","256","display.ANNUNCIATOR_EDIT","ERR","10","512","display.ANNUNCIATOR_ERROR","REM","11","1024","display.ANNUNCIATOR_REMOTE","TALK","12","2048","display.ANNUNCIATOR_TALK ","LSTN","13","4096","display.ANNUNCIATOR_LISTEN","SRQ","14","8192","display.ANNUNCIATOR_SRQ","REAR","15","16384","display.ANNUNCIATOR_REAR","REL","16","32768","display.ANNUNCIATOR_REL","Example 1","testAnnunciators = display.getannunciators()","print(testAnnunciators)","rem = bit.bitand(testAnnunciators, 1024)","if rem > 0 then"," print("REM is on")","else"," print("REM is off")","end","REM indicator is turned on.","Output:","1.28000e+03","REM is on","Example 2","print(display.ANNUNCIATOR_EDIT)","print(display.ANNUNCIATOR_TRIGGER)","print(display.ANNUNCIATOR_AUTO)","Output:","2.56000e+02","3.20000e+01","8.00000e+00","Also see","bit.bitand()","display.getannunciators()","14719.htm");
+Page[113]=new Array("This function reads the present position of the cursor on the front‑panel display.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","row, column, style = display.getcursor()","row","The row where the cursor is: 1 (top row); 2 (bottom row)","column","The column where the cursor is:","If the cursor is in the top row: 1 to 20","If the cursor is in the bottom row: 1 to 32","style","Visibility of the cursor:","Invisible: 0","Blinking: 1","Details","This function switches the front‑panel display to the user screen (the text set by display.settext()), and then returns values to indicate the cursor's row and column position and cursor style.","Columns are numbered from left to right on the display.","Example 1","testRow, testColumn = display.getcursor()","print(testRow, testColumn)","This example reads the cursor position into local variables and prints them. Example output:","1.00000e+00 1.00000e+00","Example 2","print(display.getcursor())","This example prints the cursor position directly. In this example, the cursor is in row 1 at column 3, with an invisible cursor:","1.00000e+00 3.00000e+00 0.00000e+00","Also see","display.gettext()","display.screen","display.setcursor()","display.settext()","display.getcursor()","14700.htm");
+Page[114]=new Array("This function retrieves the key code for the last pressed key.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","keyCode = display.getlastkey()","keyCode","A returned value that represents the last front-panel key pressed; see Details for more information","Details","A history of the key code for the last pressed front‑panel key is maintained by the instrument. When the instrument is turned on, or when it is transitioning from local to remote operation, the key code is set to 0 (display.KEY_NONE).","Pressing the EXIT (LOCAL) key normally aborts a script. To use this function with the EXIT (LOCAL) key, you must set display.locallockout to display.LOCK.","The table below lists the keyCode value for each front‑panel action.","Key codes","Value","Key list","Value","Key list","0","display.KEY_NONE","82","display.KEY_ENTER","65","display.KEY_RANGEUP","85","display.KEY_RECALL","68","display.KEY_MENU","86","display.KEY_MEASA","69","display.KEY_MODEA","87","display.KEY_DIGITSA","70","display.KEY_RELA","92","display.KEY_TRIG","71","display.KEY_RUN","93","display.KEY_LIMITA","72","display.KEY_DISPLAY","94","display.KEY_SPEEDA","73","display.KEY_AUTO","95","display.KEY_LOAD","75","display.KEY_EXIT","97","display.WHEEL_ENTER","77","display.KEY_FILTERA","103","display.KEY_RIGHT","78","display.KEY_STORE","104","display.KEY_LEFT","79","display.KEY_SRCA","107","display.WHEEL_LEFT","80","display.KEY_CONFIG","114","display.WHEEL_RIGHT","81","display.KEY_RANGEDOWN","@When using this function, use built-in constants such as display.KEY_RIGHT (rather than the numeric value of 103). This will allow for better forward compatibility with firmware revisions.","You cannot use this function to track the OUTPUT ON/OFF control.","Example","key = display.getlastkey()","print(key)","On the front panel, press the MENU key and then send the code shown here. This retrieves the key code for the last pressed key.","Output:","6.80000e+01","Also see","display.locallockout","display.sendkey()","display.getlastkey()","92660.htm");
+Page[115]=new Array("This function reads the text displayed on the front panel.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","text = display.gettext()","text = display.gettext(embellished)","text = display.gettext(embellished, row)","text = display.gettext(embellished, row, columnStart)","text = display.gettext(embellished, row, columnStart, columnEnd)","text","The returned value, which contains the text that is presently displayed","embellished","Indicates type of returned text: false (simple text); true (text with embedded character codes)","row","Selects the row from which to read the text: 1 (row 1); 2 (row 2). If row is not included, both rows of text are read","columnStart","Selects the first column from which to read text; for row 1, the valid column numbers are 1 to 20; for row 2, the valid column numbers are 1 to 32; if nothing is selected, 1 is used","columnEnd","Selects the last column from which to read text; for row 1, the valid column numbers are 1 to 20; for row 2, the valid column numbers are 1 to 32; the default is 20 for row 1, and 32 for row 2","Details","Using the command without any parameters returns both lines of the front‑panel display.","The $N character code is included in the returned value to show where the top line ends and the bottom line begins. This is not affected by the value of embellished.","When embellished is set to true, all other character codes are returned along with the message. When embellished is set to false, only the message and the $N character code is returned. For information on the embedded character codes, see display.settext().","The display is not switched to the user screen (the screen set using display.settext()). Text is read from the active screen.","Example 1","display.clear()","display.setcursor(1, 1)","display.settext("ABCDEFGHIJ$DKLMNOPQRST")","display.setcursor(2, 1)","display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456")","print(display.gettext())","print(display.gettext(true))","print(display.gettext(false, 2))","print(display.gettext(true, 2, 9))","print(display.gettext(false, 2, 9, 10))","This example shows how to retrieve the display text in multiple ways. The output is:","ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456","$RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456","abcdefghijklmnopqrstuvwxyz123456","$Rijklm$Bnopqrstuvwxyz$F123456","ij","Example 2","display.clear()","display.settext("User Screen")","text = display.gettext()","print(text)","This outputs all text in both lines of the display:","User Screen $N","This indicates that the message “User Screen” is on the top line. The bottom line is blank.","Also see","display.clear()","display.getcursor()","display.setcursor()","display.settext()","display.gettext()","14702.htm");
+Page[116]=new Array("This function displays a formatted input field on the front‑panel display that the operator can edit.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.inputvalue("format")","display.inputvalue("format", default)","display.inputvalue("format", default, minimum)","display.inputvalue("format", default, minimum, maximum)","format","A string that defines how the input field is formatted; see Details for more information","default","The default value for the input value","minimum","The minimum input value","maximum","The maximum input value","Details","The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.","Option","Description","Examples","E","Include the E to display the value exponentially","0.00000e+0","+","Allows operators to enter positive or negative values; if the "+" sign is not included, the operator cannot enter a negative value","+0.00","0","Defines the digit positions for the value; you can use up to six zeros (0)","+00.0000e+00",".","Include to have a decimal point appear in the value","+0.00","The default parameter is the value shown when the value is first displayed.","The minimum and maximum parameters can be used to limit the values that can be entered. When + is not selected for format, the minimum limit must be more than or equal to zero (0). When limits are used, you cannot enter values above or below these limits.","The input value is limited to ±1e37.","Before calling display.inputvalue(), you should send a message prompt to the operator using display.prompt(). Make sure to position the cursor where the edit field should appear.","After this command is sent, script execution pauses until you enter a value and press the ENTER key.","For positive and negative entry (plus sign (+) used for the value field and/or the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel @. Polarity will also toggle when using the navigation wheel @ to decrease or increase the value or exponent past zero. A zero (0) value or exponent (for example, +00) is always positive and cannot be toggled to negative polarity.","After executing this command and pressing the EXIT (LOCAL) key, the function returns nil.","Example","display.clear()","display.settext("Enter value between$N -0.10 and 2.00: ")","value = display.inputvalue("+0.00", 0.5, -0.1, 2.0)","print("Value entered = ", value)","Displays an editable field (+0.50) for operator input. The valid input range is -0.10 to +2.00, with a default of 0.50.","Output:","Value entered = 1.35000e+00","Also see","display.prompt()","display.setcursor()","display.settext()","display.inputvalue()","14703.htm");
+Page[117]=new Array("This function adds an entry to the USER menu, which can be accessed by pressing the LOAD key on the front panel.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.loadmenu.add("displayName", "code")","display.loadmenu.add("displayName", "code", memory)","displayName","The name that is added to the USER menu","code","The code that is run from the USER menu","memory","Determines if code is saved to nonvolatile memory:","0 or display.DONT_SAVE: Does not save the code to nonvolatile memory","1 or display.SAVE: Saves the code to nonvolatile memory (default)","Details","After adding code to the load menu, you can run it from the front panel by pressing the LOAD key, then selecting USER to select from the available code to load. Pressing the RUN key will then run the script.","You can add items in any order. They are always displayed in alphabetic order when the menu is selected.","Any Lua code can be included in the code parameter. If memory is set to display.SAVE, the entry (name and code) is saved in nonvolatile memory. Scripts, functions, and variables used in the code are not saved by display.SAVE. Functions and variables need to be saved with the code. If the code is not saved in nonvolatile memory, it is lost when the 2601B-PULSE is turned off. See Example 2 below.","If you do not make a selection for memory, the code is automatically saved to nonvolatile memory.","@You can create a script that defines several functions, and then use the display.loadmenu.add() command to add items that call those individual functions. This allows the operator to run tests from the front panel.","Example 1","display.loadmenu.add("Test9", "Test9()")","Assume a user script named "Test9" has been loaded into the runtime environment. Adds the menu entry to the USER menu to run the script after loading.","Example 2","display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE)","Assume a script with a function named “DUT1” has already been loaded into the instrument, and the script has not been saved in nonvolatile memory.","Now assume you want to add a test named “Test” to the USER menu. You want the test to run the function named “DUT1” and sound the beeper. This example adds “Test” to the menu, defines the code, and then saves the displayName and code in nonvolatile memory.","When “Test” is run from the front panel USER menu, the function named “DUT1” executes and the beeper beeps for two seconds.","Now assume you turn off instrument power. Because the script was not saved in nonvolatile memory, the function named “DUT1” is lost when you turn the instrument on. When “Test” is again run from the front panel, an error is generated because DUT1 no longer exists in the instrument as a function.","Example 3","display.loadmenu.add("Part1", "testpart([[Part1]], 5.0)", display.SAVE)","Adds an entry called “Part1” to the front panel USER load menu for the code testpart([[Part1]], 5.0), and saves it in nonvolatile memory.","Also see","display.loadmenu.delete()","display.loadmenu.add()","19382.htm");
+Page[118]=new Array("This function creates an iterator for the user menu items accessed using the LOAD key on the front panel.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","for displayName in display.loadmenu.catalog() do body end","for displayName, code in display.loadmenu.catalog() do body end","displayName","The name displayed in the menu","code","The code associated with the displayName","body","The body of the code to process the entries in the loop","Details","Each time through the loop, displayName and code will take on the values in the USER menu.","The instrument goes through the list in random order.","Example","for displayName, code in display.loadmenu.catalog() do"," print(displayName, code)","end","Output:","Test DUT1() beeper.beep(2, 500)","Part1 testpart([[Part1]], 5.0)","Test9 Test9()","Also see","display.loadmenu.add()","display.loadmenu.delete()","display.loadmenu.catalog()","14705.htm");
+Page[119]=new Array("This function removes an entry from the USER menu, which can be accessed using the LOAD key on the front panel.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.loadmenu.delete("displayName")","displayName","The name to be deleted from the USER menu","Details","If you delete an entry from the USER menu, you can no longer run it by pressing the LOAD key.","Example","display.loadmenu.delete("Test9")","for displayName, code in display.loadmenu.catalog() do"," print(displayName, code)","end","Deletes the entry named Test9.","Output:","Test DUT1() beeper.beep(2, 500)","Part1 testpart([[Part1]], 5.0)","Also see","display.loadmenu.add()","display.loadmenu.catalog()","display.loadmenu.delete()","14706.htm");
+Page[120]=new Array("This attribute describes whether or not the EXIT (LOCAL) key on the instrument front panel is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not saved","0 (display.UNLOCK)","Usage","lockout = display.locallockout","display.locallockout = lockout","lockout","0 or display.UNLOCK: Unlocks EXIT (LOCAL) key","1 or display.LOCK: Locks out EXIT (LOCAL) key","Details","Set display.locallockout to display.LOCK to prevent the user from interrupting remote operation by pressing the EXIT (LOCAL) key.","Set this attribute to display.UNLOCK to allow the EXIT (LOCAL) key to interrupt script or remote operation.","Example","display.locallockout = display.LOCK","Disables the front‑panel EXIT (LOCAL) key.","Also see","None","display.locallockout","14707.htm");
+Page[121]=new Array("This function presents a menu on the front‑panel display.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","selection = display.menu("name", "items")","selection","Name of the variable that holds the selected menu item","name","Menu name to display on the top line","items","Menu items to display on the bottom line","Details","The menu consists of the menu name string on the top line, and a selectable list of items on the bottom line. The menu items must be a single string with each item separated by whitespace. The name for the top line is limited to 20 characters.","After sending this command, script execution pauses for the operator to select a menu item. An item is selected by rotating the navigation wheel @ to place the blinking cursor on the item, and then pressing the navigation wheel @ (or the ENTER key). When an item is selected, the text of that selection is returned.","Pressing the EXIT (LOCAL) key will not abort the script while the menu is displayed, but it will return nil. The script can be aborted by calling the exit function when nil is returned.","Example","selection = display.menu("Menu", "Test1 Test2 Test3")","print(selection)","Displays a menu with three menu items. If the second menu item is selected, selection is given the value Test2.","Output:","Test2","Also see","None","display.menu()","14708.htm");
+Page[122]=new Array("This attribute controls whether the front panel keys act as a numeric keypad during value entry.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","1 (display.ENABLE)","Usage","numericKeypad = display.numpad","display.numpad = numericKeypad","numericKeypad","Enable the numeric keypad feature (1 or display.ENABLE)","Disable the numeric keypad feature (0 or display.DISABLE)","Details","The numeric keypad feature is only available when editing a numeric value at the same time that the EDIT indicator is lit.","Example","display.numpad = display.ENABLE","Turn on the numeric keypad feature.","Also see","Setting a value","display.numpad","14709.htm");
+Page[123]=new Array("This function prompts the user to enter a parameter from the front panel of the instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.prompt("format", "units", "help")","display.prompt("format", "units", "help", default)","display.prompt("format", "units", "help", default, minimum)","display.prompt("format", "units", "help", default, minimum, maximum)","format","A string that defines how the input field is formatted; see Details for more information","units","Set the units text string for the top line (eight characters maximum); this indicates the units (for example, "V" or "A") for the value","help","Text string to display on the bottom line (32 characters maximum)","default","The value that is shown when the value is first displayed","minimum","The minimum input value that can be entered","maximum","The maximum input value that can be entered (must be more than minimum)","Details","This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt:","0.00V","Input 0 to +2V","The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted.","The format parameter can include the options shown in the following table.","Option","Description","Examples","E","Include the E to display the value exponentially. Include a plus sign (+) for positive/negative exponent entry. Do not include the plus sign (+) to prevent negative value entry. 0 defines the digit positions for the exponent.","0.00000E+0","+","Allows operators to enter positive or negative values. If the plus sign (+) is not included, the operator cannot enter a negative value.","+0.00","0","Defines the digit positions for the value. You can use up to six zeros (0).","+00.0000E+00",".","The decimal point where needed for the value.","+0.00","You can use the minimum and maximum parameters to limit the values that can be entered. When a plus sign (+) is not selected for format, the minimum limit must be greater than or equal to zero (0). When limits are used, the operator cannot enter values above or below these limits.","The input value is limited to ±1e37.","After sending this command, script execution pauses for the operator to enter a value and press ENTER.","For positive and negative entry (plus sign (+) used for the value field and the exponent field), polarity of a nonzero value or exponent can be toggled by positioning the cursor on the polarity sign and turning the navigation wheel @. Polarity will also toggle when using the navigation wheel @ to decrease or increase the value or exponent past zero. A zero value or exponent (for example, +00) is always positive and cannot be toggled to negative polarity.","After executing this command and pressing the EXIT (LOCAL) key, the value returns nil.","Example","value = display.prompt("0.00", "V", "Input 0 to +2V", 0.5, 0, 2)","print(value)","The above command prompts the operator to enter a voltage value. The valid input range is 0 to +2.00, with a default of 0.50:","0.50V","Input 0 to +2V","If the operator enters 0.70, the output is:","7.00000e-01","Also see","display.inputvalue()","display.prompt()","14740.htm");
+Page[124]=new Array("This attribute contains the selected display screen.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","0 (display.SMUA)","Usage","displayID = display.screen","display.screen = displayID","displayID","One of the following values:","0 or display.SMUA: Displays source-measure and compliance values","3 or display.USER: Displays the user screen","Details","Setting this attribute selects the display screen for the front panel. This performs the same action as pressing the DISPLAY key on the front panel. The text for the display screen is set by display.settext().","Read this attribute to determine which of the available display screens was last selected.","Example","display.screen = display.SMUA","Selects the source-measure and compliance limit display.","Also see","display.settext()","display.screen","92282.htm");
+Page[125]=new Array("This function sends a code that simulates the action of a front‑panel control.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.sendkey(keyCode)","keyCode","A parameter that specifies the key press to simulate; see Details for more information","Details","This command simulates pressing a front‑panel key or navigation wheel, or turning the navigation wheel one click to the left or right.","Key codes","Value","Key list","Value","Key list","65","display.KEY_RANGEUP","85","display.KEY_RECALL","68","display.KEY_MENU","86","display.KEY_MEASA","69","display.KEY_MODEA","87","display.KEY_DIGITSA","70","display.KEY_RELA","88","display.KEY_OUTPUTA","71","display.KEY_RUN","92","display.KEY_TRIG","72","display.KEY_DISPLAY","93","display.KEY_LIMITA","73","display.KEY_AUTO","94","display.KEY_SPEEDA","75","display.KEY_EXIT","95","display.KEY_LOAD","77","display.KEY_FILTERA","97","display.WHEEL_ENTER","78","display.KEY_STORE","103","display.KEY_RIGHT","79","display.KEY_SRCA","104","display.KEY_LEFT","80","display.KEY_CONFIG","107","display.WHEEL_LEFT","81","display.KEY_RANGEDOWN","114","display.WHEEL_RIGHT","82","display.KEY_ENTER","@When using this function, send built-in constants, such as display.KEY_RIGHT, rather than the numeric value, such as 103. This allows for better forward compatibility with firmware revisions.","Example","display.sendkey(display.KEY_RUN)","Simulates pressing the RUN key.","Also see","Front panel","display.sendkey()","92659.htm");
+Page[126]=new Array("This attribute sets the front‑panel display resolution of the selected measurement.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","5 (display.DIGITS_5_5)","Usage","digits = display.smua.digits","display.smua.digits = digits","digits","Set digits to one of the following values:","Select 4-1/2 digit resolution (4 or display.DIGITS_4_5)","Select 5-1/2 digit resolution (5 or display.DIGITS_5_5)","Select 6-1/2 digit resolution (6 or display.DIGITS_6_5)","Details","This attribute sets the display resolution.","Example","display.smua.digits = display.DIGITS_5_5","Select 5-1/2 digit resolution.","Also see","Display resolution","display.smua.digits","92073.htm");
+Page[127]=new Array("This function sets the position of the cursor.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.setcursor(row, column)","display.setcursor(row, column, style)","row","The row number for the cursor (1 or 2)","column","The active column position to set; row 1 has columns 1 to 20, row 2 has columns 1 to 32","style","Set the cursor to invisible (0, default) or blinking (1)","Details","Sending this command selects the user screen and then moves the cursor to the given location.","The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.","An out‑of-range parameter for row sets the cursor to row 2. An out‑of‑range parameter for column sets the cursor to column 20 for row 1, or 32 for row 2.","An out‑of‑range parameter for style sets it to 0 (invisible).","A blinking cursor is only visible when it is positioned over displayed text. It cannot be seen when positioned over a space character.","Example","display.clear()","display.setcursor(1, 8)","display.settext("Hello")","display.setcursor(2, 14)","display.settext("World")","This example displays a message on the front panel, approximately center. Note that the top line of text is larger than the bottom line of text.","The front panel of the instrument displays "Hello" on the top line and "World" on the second line.","Also see","display.clear()","display.getcursor()","display.gettext()","display.screen","display.settext()","display.setcursor()","14711.htm");
+Page[128]=new Array("This function displays text on the front‑panel user screen.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.settext("text")","text","Text message to be displayed, with optional character codes","Details","This function selects the user display screen and displays the given text.","After the instrument is turned on, the first time you use a display command to write to the display, the message "User Screen" is cleared. After the first write, you need to use display.clear() to clear the message.","The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the display. For performance considerations, they update the display as soon as processing time becomes available.","The text starts at the present cursor position. After the text is displayed, the cursor is after the last character in the display message.","Top line text does not wrap to the bottom line of the display automatically. Any text that does not fit on the current line is truncated. If the text is truncated, the cursor remains at the end of the line.","The text remains on the display until replaced or cleared.","The character codes described in the following table can be also be included in the text string.","Display character codes","Character Code","Description","$N","Newline, starts text on the next line; if the cursor is already on line 2, text will be ignored after the $N is received","$R","Sets text to normal intensity, nonblinking","$B","Sets text to blink","$D","Sets text to dim intensity","$F","Sets the text to background blink","$$","Escape sequence to display a single dollar symbol ($)","Example","display.clear()","display.settext("Normal $BBlinking$N")","display.settext("$DDim $FBackgroundBlink$R $$$$ 2 dollars")","This example sets the display to:","Normal Blinking","Dim BackgroundBlink $$ 2 dollars","with the named effect on each word.","Also see","display.clear()","display.getcursor()","display.gettext()","display.screen","display.setcursor()","display.settext()","14712.htm");
+Page[129]=new Array("This attribute specifies the type of limit value setting displayed for the SMU.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","0 (display.LIMIT_IV)","Usage","func = display.smua.limit.func","display.smua.limit.func = func","func","One of the following values:","0 or display.LIMIT_IV: Displays the primary limit setting","1 or display.LIMIT_P: Displays the power limit setting","Details","Selects the displayed limit function for the SMU: primary (IV) or power (P).","Example","display.smua.limit.func = display.LIMIT_P","Specifies that the power limit value is displayed.","Also see","display.smua.measure.func","Display mode","display.smua.limit.func","92074.htm");
+Page[130]=new Array("This attribute specifies the type of measurement that is being displayed.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","1 (display.MEASURE_DCVOLTS)","Usage","func = display.smua.measure.func","display.smua.measure.func = func","func","The type of measurement:","0 or display.MEASURE_DCAMPS: Current measurement function","1 or display.MEASURE_DCVOLTS: Voltage measurement function","2 or display.MEASURE_OHMS: Resistance measurement function","3 or display.MEASURE_WATTS: Power measurement function","Details","Selects the measurement function that is displayed on the front panel: Amps, volts, ohms, or watts.","Example","display.smua.measure.func = display.MEASURE_DCAMPS","Selects the current measure function.","Also see","display.smua.limit.func","display.smua.measure.func","92075.htm");
+Page[131]=new Array("This function clears the front‑panel trigger event detector.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","display.trigger.clear()","Details","The trigger event detector remembers if an event has been detected since the last display.trigger.wait() call. This function clears the trigger event detector and discards the previous history of TRIG key presses.","This attribute also clears the display.trigger.overrun attribute.","Also see","display.trigger.overrun","display.trigger.wait()","display.trigger.clear()","14715.htm");
+Page[132]=new Array("This constant is the event ID of the event generated when the front‑panel TRIG key is pressed.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = display.trigger.EVENT_ID","eventID","The trigger event number","Details","Set the stimulus of any trigger event detector to the value of this constant to have it respond to front-panel trigger key events.","Also see","None","display.trigger.EVENT_ID","14716.htm");
+Page[133]=new Array("This attribute contains the event detector overrun status.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Display trigger clear Instrument reset Recall setup","Not saved","false","Usage","overrun = display.trigger.overrun","overrun","The trigger overrun state (true or false)","Details","Indicates if a trigger event was ignored because the event detector was already in the detected state when the TRIG button was pressed.","Indicates the overrun state of the event detector built into the display.","This attribute does not indicate whether an overrun occurred in any other part of the trigger model or in any other detector that is monitoring the event.","Example","overrun = display.trigger.overrun","Sets the variable overrun equal to the present state of the event detector built into the display. ","Also see","display.trigger.clear()","display.trigger.overrun","14739.htm");
+Page[134]=new Array("This function waits for the TRIG key on the front panel to be pressed.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = display.trigger.wait(timeout)","triggered","true: Trigger was detected","false: The operation timed out","timeout","Timeout in seconds","Details","If the trigger key was previously pressed and one or more trigger events were detected, this function returns immediately.","After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.","Use the display.trigger.clear() call to clear the trigger event detector.","Example","triggered = display.trigger.wait(5)","print(triggered)","Waits up to five seconds for the TRIG key to be pressed. If TRIG is pressed within five seconds, the output is true. If not, the output is false.","Also see","display.trigger.clear()","display.trigger.wait()","14717.htm");
+Page[135]=new Array("This function captures the key code value for the next front‑panel action.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","keyCode = display.waitkey()","keyCode","See Details for more information","Details","After you send this function, script execution pauses until a front‑panel action (for example, pressing a key or the navigation wheel @, or turning the navigation wheel @). After the action, the value of the key (or action) is returned.","If the EXIT (LOCAL) key is pressed while this function is waiting for a front‑panel action, the script is not aborted.","A typical use for this function is to prompt the user to press the EXIT (LOCAL) key to abort the script or press any other key to continue. For example, if the keyCode value 75 is returned (the EXIT (LOCAL) key was pressed), you can call the exit() function to abort the script.","The table below lists the keyCode values for each front panel action.","Key codes","Value","Key list","Value","Key list","65","display.KEY_RANGEUP","85","display.KEY_RECALL","68","display.KEY_MENU","86","display.KEY_MEASA","69","display.KEY_MODEA","87","display.KEY_DIGITSA","70","display.KEY_RELA","88","display.KEY_OUTPUTA","71","display.KEY_RUN","92","display.KEY_TRIG","72","display.KEY_DISPLAY","93","display.KEY_LIMITA","73","display.KEY_AUTO","94","display.KEY_SPEEDA","75","display.KEY_EXIT","95","display.KEY_LOAD","77","display.KEY_FILTERA","97","display.WHEEL_ENTER","78","display.KEY_STORE","103","display.KEY_RIGHT","79","display.KEY_SRCA","104","display.KEY_LEFT","80","display.KEY_CONFIG","107","display.WHEEL_LEFT","81","display.KEY_RANGEDOWN","114","display.WHEEL_RIGHT","82","display.KEY_ENTER","@When using this function, send built-in constants, such as display.KEY_RIGHT, rather than the numeric value, such as 103. This allows for better forward compatibility with firmware revisions.","Example","key = display.waitkey()","print(key)","Pause script execution until the operator presses a key or the navigation wheel @, or rotates the navigation wheel.","If the output is:","8.60000e+01","It indicates that the MEAS(A) key was pressed.","Also see","Capturing key-press codes","display.getlastkey()","display.sendkey()","display.settext()","display.waitkey()","92661.htm");
+Page[136]=new Array("This function clears all entries out of the error queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","errorqueue.clear()","Details","See the Error queue topic for additional information about the error queue.","Also see","errorqueue.count","errorqueue.next()","errorqueue.clear()","14749.htm");
+Page[137]=new Array("This attribute gets the number of entries in the error queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Power cycle Clearing error queue Reading error messages","Not applicable","Not applicable","Usage","count = errorqueue.count","count","The number of entries in the error queue","Example","count = errorqueue.count","print(count)","Returns the number of entries in the error queue.","The output below indicates that there are four entries in the error queue:","4.00000e+00","Also see","Error queue","errorqueue.clear()","errorqueue.next()","errorqueue.count","14750.htm");
+Page[138]=new Array("This function reads the oldest entry from the error queue and removes it from the queue.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","errorCode, message, severity, errorNode = errorqueue.next()","errorCode","The error code number for the entry","message","The message that describes the error code","severity","The severity level (0, 10, 20, 30, or 40); see Details for more information","errorNode","The node number where the error originated","Details","Entries are stored in a first-in, first-out (FIFO) queue. This function reads the oldest entry and removes it from the queue.","Error codes and messages are listed in the Error summary list.","If there are no entries in the queue, code 0, "Queue is Empty" is returned.","Returned severity levels are described in the following table.","Number","Error level","Description","0","NO_SEVERITY","The message is information only. This level is used when the Error Queue is empty; the message does not represent an error.","10","INFORMATIONAL","The message is information only. This level is used to indicate status changes; the message does not represent an error.","20","RECOVERABLE","The error was caused by improper use of the instrument or by conditions that can be corrected. This message indicates that an error occurred. The instrument is still operating normally.","30","SERIOUS","There is a condition that prevents the instrument from functioning properly. The message indicates that the instrument is presently operating in an error condition. If the condition is corrected, the instrument will return to normal operation.","40","FATAL","There is a condition that cannot be corrected that prevents the instrument from functioning properly. Disconnect the DUT and turn the power off and then on again. If the error is a hardware fault that persists after cycling the power, the instrument must be repaired.","In an expanded system, each TSP‑Link enabled instrument is assigned a node number. The variable errorNode stores the node number where the error originated.","Example","errorcode, message = errorqueue.next()","print(errorcode, message)","Reads the oldest entry in the error queue. The output below indicates that the queue is empty.","Output:","0.00000e+00 Queue Is Empty","Also see","Error queue","errorqueue.clear()","errorqueue.count","Error summary list","errorqueue.next()","92325.htm");
+Page[139]=new Array("This function returns all entries from the event log as a single string and removes them from the event log.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","logString = eventlog.all()","logString","A listing of all event log entries","Details","This function returns all events in the event log. Logged items are shown from oldest to newest. The response is a string that has the messages delimited with a new line character.","This function also clears the event log.","If there are no entries in the event log, this function returns the value nil.","Example","print(eventlog.all())","Get and print all entries from the event log and remove the entries from the log.","Output:","17:26:35.690 10 Oct 2019, LAN0, 192.168.1.102, LXI, 0, 1570728395, 1192037155.733269000, 0, 0x0","17:26:39.009 10 Oct 2019, LAN5, 192.168.1.102, LXI, 0, 1570728399, 1192037159.052777000, 0, 0x0","Also see","eventlog.clear()","eventlog.count","eventlog.enable","eventlog.next()","eventlog.overwritemethod","eventlog.all()","14756.htm");
+Page[140]=new Array("This function clears the event log.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","eventlog.clear()","Details","This command removes all messages from the event log.","Also see","eventlog.all()","eventlog.count","eventlog.enable","eventlog.next()","eventlog.overwritemethod","eventlog.clear()","14758.htm");
+Page[141]=new Array("This attribute returns the number of unread events in the event log.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset Clearing event log Reading event log","Not applicable","Not applicable","Usage","N = eventlog.count","N","The number of events in the event log","Example","print(eventlog.count)","Displays the present number of events in the instrument event log.","Output looks similar to:","3.00000e+00","Also see","eventlog.all()","eventlog.clear()","eventlog.enable","eventlog.next()","eventlog.overwritemethod","eventlog.count","14757.htm");
+Page[142]=new Array("This attribute enables or disables the event log.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Not saved","1 (eventlog.ENABLE)","Usage","status = eventlog.enable","eventlog.enable = status","status","The enable status of the event log:","1 or eventlog.ENABLE: Event log enable","0 or eventlog.DISABLE: Event log disable","Details","When the event log is disabled (eventlog.DISABLE or 0), no new events are added to the event log. You can, however, read and remove existing events.","When the event log is enabled, new events are logged.","Example","print(eventlog.enable)","eventlog.enable = eventlog.DISABLE","print(eventlog.enable)","Displays the present status of the 2601B-PULSE event log.","Output:","1.00000e+00","0.00000e+00","Also see","eventlog.all()","eventlog.clear()","eventlog.count","eventlog.next()","eventlog.overwritemethod","eventlog.enable","14760.htm");
+Page[143]=new Array("This function returns the oldest unread event message from the event log and removes it from the event log.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","logString = eventlog.next()","logString","The next log entry","Details","Returns the next entry from the event log and removes it from the log.","If there are no entries in the event log, returns the value nil.","Example 1","print(eventlog.next())","Get the oldest message in the event log and remove that entry from the log.","Output:","17:28:22.085 10 Oct 2019, LAN2, 192.168.1.102, LXI, 0, 1570728502, <no time>, 0, 0x0","Example 2","print(eventlog.next())","If you send this command when there is nothing in the event log, you will get the following output:","nil","Also see","eventlog.all()","eventlog.clear()","eventlog.count","eventlog.enable","eventlog.overwritemethod","eventlog.next()","14761.htm");
+Page[144]=new Array("This attribute controls how the event log processes events if the event log is full.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Not saved ","1 (eventlog.DISCARD_OLDEST)","Usage","method = eventlog.overwritemethod","eventlog.overwritemethod = method","method","Set to one of the following values:","0 or eventlog.DISCARD_NEWEST: New entries are not logged","1 or eventlog.DISCARD_OLDEST: Old entries are deleted as new events are logged","Details","When this attribute is set to eventlog.DISCARD_NEWEST, new entries are not logged.","When this attribute is set to eventlog.DISCARD_OLDEST, the oldest entry is discarded when a new entry is added.","Example","eventlog.overwritemethod = 0","When the log is full, the event log will ignore new entries.","Also see","eventlog.all()","eventlog.clear()","eventlog.count","eventlog.enable","eventlog.next()","eventlog.overwritemethod","14759.htm");
+Page[145]=new Array("This function stops a script that is presently running.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","exit()","Details","Terminates script execution when called from a script that is being executed.","This command does not wait for overlapped commands to complete before terminating script execution. If overlapped commands are required to finish, use the waitcomplete() function before calling exit().","Also see","waitcomplete()","exit()","14769.htm");
+Page[146]=new Array("This function closes the file that is represented by the fileVar variable.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","fileVar:close()","fileVar","The file descriptor variable to close","Details","This command is equivalent to io.close(fileVar).","Note that files are automatically closed when the file descriptors are garbage collected.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","print("\\n*** fileVar:close")","do","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","end","myfile, myfile_err, myfile_errnum = io.open(fileName, "r")","myfile:close()","os.remove(fileName)","Opens file myfile.txt for writing. If no errors were found while opening, writes Removing file and closes the file.","Also see","fileVar:flush()","fileVar:read()","fileVar:seek()","fileVar:write()","io.close()","io.open()","fileVar:close()","14772.htm");
+Page[147]=new Array("This function writes buffered data to a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","fileVar:flush()","fileVar","The file descriptor variable to flush","Details","The fileVar:write() or io.write() functions buffer data, which may not be written immediately to the USB flash drive. Use fileVar:flush() to flush this data. Using this function removes the need to close a file after writing to it, allowing the file to be left open to write more data. Data may be lost if the file is not closed or flushed before a script ends. ","If there is going to be a time delay before more data is written to a file, and you want to keep the file open, flush the file after you write to it to prevent loss of data.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** io.read")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1\\n")","myfile:flush()","myfile:close()","do","fileHandle = io.input(fileName)","value = io.read("*a")","print(value)","end","fileHandle:close()","print(errorqueue.next())","Writes data to a USB flash drive.","Also see","fileVar:write()","io.open()","io.write()","fileVar:flush()","14786.htm");
+Page[148]=new Array("This function reads data from a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","data1 = fileVar:read() ","data1 = fileVar:read(format1)","data1, data2 = fileVar:read("format1", "format2")","data1, ..., datan = fileVar:read("format1", ..., "formatn")","data1","First data read from the file","data2","Second data read from the file","datan","Last data read from the file","fileVar","The descriptor of the file to be read","format1","A string or number indicating the first type of data to be read","format2","A string or number indicating the second type of data to be read","formatn","A string or number indicating the last type of data to be read","...","One or more entries (or values) separated by commas","Details","The format parameters may be any of the following:",""*n": Returns a number.",""*a": Returns the whole file, starting at the current position (returns an empty string if the current file position is at the end of the file).",""*l": Returns the next line, skipping the end of line; returns nil if the current file position is at the end of file.","n: Returns a string with up to n characters; returns an empty string if n is zero; returns nil if the current file position is at the end of file.","If no format parameters are provided, the function will perform as if the function is passed the value "*l".","Any number of format parameters may be passed to this command, each corresponding to a returned data value.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","print("fileVar:read")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","do","myfile, myfile_err, myfile_errnum = io.open(fileName, "r")","contents = myfile:read("*a")","print(contents)","end","myfile:close()","os.remove(fileName)","Reads data from the input file.","Also see","fileVar:write()","io.input()","io.open()","fileVar:read()","14787.htm");
+Page[149]=new Array("This function sets and gets the present position of a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","position, errorMsg = fileVar:seek()","position, errorMsg = fileVar:seek("whence")","position, errorMsg = fileVar:seek("whence", offset)","position","The new file position, measured in bytes from the beginning of the file","errorMsg","A string containing the error message","fileVar","The file descriptor variable","whence","A string indicating the base against which offset is applied; the default is "cur"","offset","The intended new position, measured in bytes from a base indicated by whence (default is 0)","Details","The whence parameters may be any of the following:",""set": Beginning of file",""cur": Current position",""end": End of file","If an error is encountered, it is logged to the error queue, and the command returns nil and the error string.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** fileVar:seek")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","do","myfile, myfile_err, myfile_errnum = io.open(fileName, "r")","position = myfile:seek("end", -1)","print(position)","end","myfile:close()","os.remove(fileName)","Get the present position of a file.","Also see","io.open()","fileVar:seek()","14788.htm");
+Page[150]=new Array("This function writes data to a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","fileVar:write(data)","fileVar:write(data1, data2)","fileVar:write(data1, ..., datan)","fileVar","The file descriptor variable","data","Write all data to the file","data1","The first data to write to the file","data2","The second data to write to the file","datan","The last data to write to the file","...","One or more entries (or values) separated by commas","Details","This function may buffer data until a flush (fileVar:flush() or io.flush()) or close (fileVar:close() or io.close()) operation is performed.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** fileVar:write")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","do","myfile:write("Line 1")","end","myfile:close()","os.remove(fileName)","Write data to a file.","Also see","fileVar:close()","fileVar:flush()","io.close()","io.flush()","io.open()","fileVar:write()","14789.htm");
+Page[151]=new Array("This attribute sets the precision (number of digits) for all numbers returned in the ASCII format.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Instrument reset Recall setup","Not saved","6","Usage","precision = format.asciiprecision","format.asciiprecision = precision","precision","A number representing the number of digits to be printed for numbers printed with the print(), printbuffer(), and printnumber() functions; must be a number between 1 and 16","Details","This attribute specifies the precision (number of digits) for numeric data printed with the print(), printbuffer(), and printnumber() functions. The format.asciiprecision attribute is only used with the ASCII format. The precision value must be a number from 0 to 16.","Note that the precision is the number of significant digits printed. There is always one digit to the left of the decimal point; be sure to include this digit when setting the precision.","Example","format.asciiprecision = 10","x = 2.54","printnumber(x)","format.asciiprecision = 3","printnumber(x)","Output:","2.540000000e+00","2.54e+00","Also see","format.byteorder","format.data","print()","printbuffer()","printnumber()","format.asciiprecision","14797.htm");
+Page[152]=new Array("This attribute sets the binary byte order for the data that is printed using the printnumber() and printbuffer() functions.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Not saved","1 (format.LITTLEENDIAN)","Usage","order = format.byteorder","format.byteorder = order","order","Byte order value as follows:","Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN","Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN","Details","This attribute selects the byte order in which data is written when you are printing data values with the printnumber() and printbuffer() functions. The byte order attribute is only used with the format.SREAL, format.REAL, format.REAL32, and format.REAL64 data formats.","format.NORMAL, format.BIGENDIAN, and format.NETWORK select the same byte order. format.SWAPPED and format.LITTLEENDIAN select the same byte order. Selecting which to use is a matter of preference.","Select the format.SWAPPED or format.LITTLEENDIAN byte order when sending data to a computer with a Microsoft Windows operating system.","Example","x = 1.23","format.data = format.REAL32","format.byteorder = format.LITTLEENDIAN","printnumber(x)","format.byteorder = format.BIGENDIAN","printnumber(x)","Output depends on the terminal program you use, but will look something like:","#0¤p??","#0??p¤","Also see","format.asciiprecision","format.data","printbuffer()","printnumber()","format.byteorder","14801.htm");
+Page[153]=new Array("This attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Instrument reset Recall setup","Not saved","1 (format.ASCII)","Usage","value = format.data","format.data = value","value","The format to use for data, set to one of the following values:","ASCII format: 1 or format.ASCII","Single‑precision IEEE Std 754 binary format: 2, format.SREAL, or format.REAL32","Double‑precision IEEE Std 754 binary format: 3, format.REAL, format.REAL64, or format.DREAL","Details","The precision of numeric values can be controlled with the format.asciiprecision attribute. The byte order of format.SREAL, format.REAL, format.REAL32, and format.REAL64 can be selected with the format.byteorder attribute.","REAL32 and SREAL select the same single precision format. REAL and REAL64 select the same double precision format. They are alternative identifiers. Selecting which to use is a matter of preference.","The IEEE Std 754 binary formats use four bytes for single‑precision values and eight bytes for double‑precision values.","When data is written with any of the binary formats, the response message starts with #0 and ends with a new line. When data is written with the ASCII format, elements are separated with a comma and space.","@Binary formats are not intended to be interpreted by humans.","Example","format.asciiprecision = 10","x = 3.14159265","format.data = format.ASCII","printnumber(x)","format.data = format.REAL64","printnumber(x)","Output a number represented by x in ASCII using a precision of 10, then output the same number in binary using double precision format.","Output:","3.141592650e+00","#0ñÔÈSû! @","Also see","format.asciiprecision","format.byteorder","printbuffer()","printnumber()","format.data","14803.htm");
+Page[154]=new Array("This function sets the current working directory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","workingDirectory = fs.chdir("path")","workingDirectory","Returned value containing the working path","path","A string indicating the new working directory path","Details","The new working directory path may be absolute or relative to the current working directory.","An error is logged to the error queue if the given path does not exist.","Example","if fs.is_dir("/usb1/temp") == true then"," fs.chdir("/usb1/temp")"," testPath = fs.cwd()"," print(testPath)","else"," testPath = fs.cwd()"," print(testPath)","end","Insert a USB flash drive into the front panel of the instrument.","Verify that /usb1/temp is a directory and change it to be the current working directory.","Set the variable for the current working directory to be testPath.","The return should be:","/usb1/temp","If /usb1/temp is not a directory, set the variable for the current working directory to be testPath.","The return should be:","/usb1","Also see","None","fs.chdir()","14808.htm");
+Page[155]=new Array("This function returns the absolute path of the current working directory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","path = fs.cwd()","path","The absolute path of the current working directory","Example","if fs.is_dir("/usb1/temp") == true then"," fs.chdir("/usb1/temp")"," testPath = fs.cwd()"," print(testPath)","else"," testPath = fs.cwd()"," print(testPath)","end","Insert a USB flash drive into the front panel of the instrument.","Verify that /usb1/temp is a directory and change it to be the current working directory.","Set the variable for the current working directory to be testPath.","The return should be:","/usb1/temp","If /usb1/temp is not a directory, set the variable for the current working directory to be testPath.","The return should be:","/usb1","Also see","None","fs.cwd()","14810.htm");
+Page[156]=new Array("This function tests whether or not the specified path refers to a directory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","status = fs.is_dir("path")","status","Whether or not the given path is a directory (true or false)","path","The path of the file system entry to test","Details","The file system path may be absolute or relative to the current working system path.","Example 1","print("Is directory: ", fs.is_dir("/usb1/"))","Because /usb1/ is always the root directory of an inserted flash drive, you can use this command to verify that USB flash drive is inserted.","Example 2","if fs.is_dir("/usb1/temp") == false then"," fs.mkdir("/usb1/temp")","end","Insert a USB flash drive into the front panel of the instrument.","Check to see if the temp directory exists.","If it does not exist, create a directory named temp.","Also see","fs.is_file()","fs.is_dir()","14811.htm");
+Page[157]=new Array("Tests whether the specified path refers to a file (as opposed to a directory).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","status = fs.is_file("path")","status","true if the given path is a file; otherwise, false","path","The path of the file system entry to test","Details","The file system path may be absolute or relative to the current working system path.","Example","rootDirectory = "/usb1/"","print("Is file: ", fs.is_file(rootDirectory))","Insert a USB flash drive into the front panel of the instrument.","Set rootDirectory to be the USB port.","Check to see if rootDirectory is a file. Because rootDirectory was set up as a directory, the return is false.","Also see","fs.is_dir()","fs.is_file()","14824.htm");
+Page[158]=new Array("This function creates a directory at the specified path.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","path = fs.mkdir("newPath")","path","The returned path of the new directory","newpath","Location (path) of where to create the new directory","Details","The directory path may be absolute or relative to the current working directory.","An error is logged to the error queue if the parent folder of the new directory does not exist, or if a file system entry already exists at the given path.","Example","if fs.is_dir("/usb1/temp") == false then"," fs.mkdir("/usb1/temp")","end","Insert a USB flash drive into the front panel of the instrument.","Check to see if the temp directory exists.","If it does not exist, create a directory named temp.","Also see","fs.rmdir()","fs.mkdir()","14812.htm");
+Page[159]=new Array("This function returns a list of the file system entries in the directory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","files = fs.readdir("path")","files","A table containing the names of all the file system entries in the specified directory","path","The directory path","Details","The directory path may be absolute or relative to the current working directory.","This command is nonrecursive. For example, entries in subfolders are not returned.","An error is logged to the error queue if the given path does not exist or does not represent a directory.","Example","rootDirectory = "/usb1/"","entries = fs.readdir(rootDirectory)","count = table.getn(entries)","print("Found a total of "..count.." files and directories")","for i = 1, count do"," print(entries[i])","end","Insert a USB flash drive into the front panel of the instrument.","Set rootDirectory to be the USB port.","Set entries as the variable for the file system entries in rootDirectory.","Return the number of files and directories in the directory.","Also see","None","fs.readdir()","14814.htm");
+Page[160]=new Array("This function removes a directory from the file system.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","fs.rmdir("path")","path","The path of the directory to remove","Details","This path may be absolute or relative to the present working directory.","An error is logged to the error queue if the given path does not exist or does not represent a directory. An error is also logged if the directory is not empty.","Example","rootDirectory = "/usb1/"","tempDirectoryName = "temp"","if fs.is_dir(rootDirectory..tempDirectoryName) == false then"," fs.mkdir(rootDirectory..tempDirectoryName)","end","fs.rmdir(rootDirectory..tempDirectoryName)","Insert a USB flash drive into the front panel of the instrument.","Set rootDirectory to be the USB port.","Set tempDirectoryName to be equivalent to temp.","Check to see if tempDirectoryName exists.","If it does not exist, create a directory named temp.","Remove the directory.","Also see","fs.mkdir()","fs.rmdir()","14815.htm");
+Page[161]=new Array("This function retrieves the local time zone.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","timeZone = gettimezone()","timeZone","The local time zone of the instrument","Details","See settimezone() for additional details about the time zone format and a description of the fields.","timeZone can be in either of the following formats:","If one parameter was used with settimezone(), the format used is: GMThh:mm:ss","If four parameters were used with settimezone(), the format used is: GMThh:mm:ssGMThh:mm:ss,Mmm.w.dw/hh:mm:ss,Mmm.w.dw/hh:mm:ss","Example","timezone = gettimezone()","Reads the value of the local time zone.","Also see","settimezone()","gettimezone()","15011.htm");
+Page[162]=new Array("This KIParlib factory script function performs a linear current sweep and calculates the transconductance (Gm) at each point.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","gm_array, vbuf, ibuf = gm_isweep(smu, start_i, stop_i, points)","gm_array","A Lua table containing the calculated Gm values at each point","vbuf","A reading buffer containing the measured voltage at each point","ibuf","A reading buffer containing the measured current at each point","smu","Instrument channel (for example, smua refers to SMU channel A)","start_i","Starting current level of the sweep ","stop_i","Ending current level of the sweep ","points","Number of measurements between start_i and stop_i (must be ³ 2)","Details","Output data includes transconductance values, reading buffer with measured voltages, reading buffer with measured voltages and currents.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","The gm_isweep() function performs a linear current sweep, measuring voltage and current, and then calculating the transconductance (Gm) at each point using the central difference method. It can return an array of Gm values, a reading buffer with the measured voltages, and a reading buffer with the measured currents.","Example","gm_array = gm_isweep(smua, 0, 0.01, 20)","gm_array, vbuf = gm_isweep(smua, 0, 0.01, 20)","gm_array, vbuf, ibuf = gm_isweep(smua, 0,"," 0.01, 20)","Source‑measure unit (SMU) A returns Gm values only.","SMU A returns Gm and reading buffer with measured voltages.","SMU A returns Gm and reading buffers with measured voltages and currents.","Also see","gm_vsweep()","KIParlib factory script","gm_isweep()","12957.htm");
+Page[163]=new Array("This KIParlib factory script function performs a linear voltage sweep and calculates the transconductance (Gm) at each point.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","gm_array, ibuf, vbuf = gm_vsweep(smu, start_v, stop_v, points)","gm_array","A Lua table containing the calculated Gm values at each point","ibuf","A reading buffer containing the measured current at each point","vbuf","A reading buffer containing the measured voltage at each point","smu","Instrument channel (for example, smua refers to SMU channel A)","start_v","Starting voltage level of the sweep ","stop_v","Ending voltage level of the sweep ","points","Number of measurements between start_v and stop_v (must be ³ 2)","Details","Output data includes transconductance values, reading buffer with measured currents, reading buffer with measured currents and voltages.","The gm_vsweep() function performs a linear voltage sweep, measuring voltage and current, and then calculating the transconductance (Gm) at each point using the central difference method. It can return an array of Gm values, a reading buffer with the measured currents, and a reading buffer with the measured voltages.","Example","gm_array = gm_vsweep(smua, 0, 5, 20)","gm_array, ibuf = gm_vsweep(smua, 0, 5, 20)","gm_array, ibuf, vbuf = gm_vsweep(smua, 0, 5, 20)","SMU A returns Gm values only.","SMU A returns Gm and reading buffer with measured currents.","SMU A returns Gm and reading buffers with measured currents and voltages.","Also see","gm_isweep()","KIParlib factory script","gm_vsweep()","12955.htm");
+Page[164]=new Array("This attribute contains the GPIB address.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Not applicable","Nonvolatile memory","26","Usage","address = gpib.address","gpib.address = address","address","The GPIB address of the instrument (1 to 30)","Details","The address can be set to any address value from 1 to 30. However, the address must be unique in the system. It cannot conflict with an address that is assigned to another instrument or to the GPIB controller.","A new GPIB address takes effect when the command to change it is processed. If there are response messages in the output queue when this command is processed, they must be read at the new address.","If command messages are being queued (sent before this command has executed), the new settings may take effect in the middle of a subsequent command message, so care should be exercised when setting this attribute from the GPIB interface.","You should allow sufficient time for the command to be processed before attempting to communicate with the instrument again.","The reset() function does not affect the GPIB address.","Example","gpib.address = 26","address = gpib.address","print(address)","Sets the GPIB address and reads the address.","Output:","26","Also see","None","gpib.address","14860.htm");
+Page[165]=new Array("This KIHighC factory script function performs a current leakage measurement after stepping the output voltage.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","imeas = i_leakage_measure(smua, levelv, limiti, sourcedelay, measurei, measuredelay)","imeas","The measured current","levelv","Voltage level to step to when this function is called","limiti","Current limit setting for the voltage step","sourcedelay","Delay to wait before lowering the current limit for measurement","measurei","Current limit (and measure range); note the current limit is lower at this level and because high-capacitance mode is active, the measure range will follow","measuredelay","Delay to wait after lowering the current limit before taking the measurement","Details","This function causes the SMU to:","Change its current limit to limiti with a voltage output of levelv for sourcedelay time, and then change its current limit to measurei (that also changes the measurement range to measurei) for measuredelay time ","When measuredelay time expires, a measurement is made and returned as imeas","When measuring leakage current:","Charge the capacitor before calling this function (the output of the instrument is usually at a nonzero voltage before calling this function; when measuring leakage, this function does not charge the capacitor)","Set levelv = 0","Example","smua.source.highc = smua.ENABLE","smua.source.levelv = 5","smua.source.output = smua.OUTPUT_ON","delay(1)","imeas = i_leakage_measure(smua, 0, 1, 300e-3, 10e-6, 0.1)","Enable high-capacitance mode. Charge the capacitor at 5 V for 1 second set by delay(1).","The parameters passed on to the i_leakage_measure() function in this example are:","smu = smua","levelv = 0 V","limiti = 1 A","sourcedelay = 300 ms","measurei = 10 µA range","measuredelay = 100 ms","The levels and delays depend on the value and type of capacitor used.","Also see","i_leakage_threshold()","High-capacitance mode","KIHighC factory script","i_leakage_measure()","12951.htm");
+Page[166]=new Array("This KIHighC factory script function measures the current and compares it to a threshold. This continues until either the measured current drops below the threshold or the timeout expires.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","f = i_leakage_threshold(smua, levelv, limiti, sourcedelay, measurei, measuredelay, threshold, timeout)","f","A Boolean flag; this flag is true when the current is below the threshold, false if threshold is not reached before timeout expires","levelv","Voltage level to step to when this function is called","limiti","Current limit setting for the voltage step","sourcedelay","Delay to wait before lowering the current limit for measurement","measurei","Current limit (and measure range); note the current limit is lower at this level and because high-capacitance mode is active, the measure range will follow","measuredelay","Delay before the first measurement after measure range is changed","threshold","The specified current that establishes the test limit","timeout","Amount of time (in seconds) to wait for the current to drop to threshold after all the delays have occurred","Details","This function causes the SMU to:","Change its current limit to limiti with a voltage output of levelv for sourcedelay time, and then changes its current limit to measurei (that also changes the measurement range to measurei) for measuredelay time. ","When measuredelay time expires, measurements are taken at a rate determined by the smua.measure.nplc setting.","When testing the leakage current threshold:","Charge the capacitor before calling this function. The output of the instrument is usually at a non-zero voltage before calling this function; when measuring leakage, this function does not charge the capacitor.","If testing the leakage current threshold of the device, set levelv = 0.","Example","smua.source.highc = smua.ENABLE","smua.source.levelv = 5","smua.source.output = smua.OUTPUT_ON","delay(1)","pass = i_leakage_threshold(smua, 0, 1, 300e-3, 10e-6, 100e-3, 1e-6, 1)","Enable high-capacitance mode.","Charge the capacitor. ","The parameters passed on to the i_threshold_measure() function in this example are:","smu = smua","levelv = 0 V","limiti = 1 A","sourcedelay = 300 ms","measurei = 10 µA range","measuredelay = 100 ms","threshold = 1 µA","timeout = 1 s","The levels and delays depend on the value and type of capacitor used.","Sets pass = true if the current is measured below 1 µA in less than 1 second.","Also see","High-capacitance mode","i_leakage_measure()","High-capacitance mode","KIHighC factory script","i_leakage_threshold()","12953.htm");
+Page[167]=new Array("This function closes a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes (see Details)","Usage","io.close()","io.close(file)","file","The descriptor of the file to close","Details","If a file is not specified, the default output file closes.","Only io.close(), used without specifying a parameter, can be accessed from a remote node.","Example","testFile, testError = io.open("testfile.txt", "w")","if nil == testError then"," testFile:write("This is my test file")"," io.close(testFile)","end","Opens file testfile.txt for writing. If no errors were found while opening, writes "This is my test file" and closes the file.","Also see","io.open()","io.close()","14868.htm");
+Page[168]=new Array("This function saves buffered data to a file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","io.flush()","Details","You must use the io.flush() or io.close() functions to write data to the file system.","@Data is not automatically written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.","This function only flushes the default output file.","Using this command removes the need to close a file after writing to it and allows it to be left open to write more data. Data may be lost if the file is not closed or flushed before an application ends. To prevent the loss of data if there is going to be a time delay before more data is written (and when you want to keep the file open and not close it), flush the file after writing to it.","Also see","fileVar:flush()","fileVar:write()","io.write()","io.flush()","14870.htm");
+Page[169]=new Array("This function assigns a previously opened file, or opens a new file, as the default input file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes (see Details)","Usage","fileVar = io.input()","fileVar = io.input("newfile")","fileVar","The descriptor of the input file or an error message (if the function fails)","newfile","A string representing the path of a file to open as the default input file, or the file descriptor of an open file to use as the default input file","Details","The newfile path may be absolute or relative to the current working directory.","When using this function from a remote TSP-Link® node, this command does not accept a file descriptor and does not return a value.","If the function fails, an error message is returned.","Also see","io.open()","io.output()","io.input()","66560.htm");
+Page[170]=new Array("This function opens a file for later reference.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","fileVar, errorMsg = io.open("path")","fileVar, errorMsg = io.open("path", "mode")","fileVar","The descriptor of the opened file","errorMsg","Indicates whether an error was encountered while processing the function","path","The path of the file to open","mode","A string representing the intended access mode ("r" = read, "w" = write, and "a" = append)","Details","The path to the file to open may be absolute or relative to the current working directory. If you successfully open the file, errorMsg is nil and fileVar has the descriptor that can be used to access the file.","If an error is encountered, the command returns nil for fileVar and an error string.","Example","testFile, testError = io.open("testfile.txt", "w")","if testError == nil then"," testFile:write("This is my test file")"," io.close(testFile)","end","Opens file testfile.txt for writing. If no errors were found while opening, writes "This is my test file" and closes the file.","Also see","io.close()","io.open()","14872.htm");
+Page[171]=new Array("This function assigns a previously opened file or opens a new file as the default output file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes (see Details)","Usage","fileVar = io.output()","fileVar = io.output("newfile")","fileVar","The descriptor of the output file or an error message (if the function fails)","newfile","A file descriptor to assign (or the path of a file to open) as the default output file","Details","The path of the file to open may be absolute or relative to the current working directory.","When accessed from a remote node using the TSP-Link network, this command does not accept a file descriptor parameter and does not return a value.","If the function fails, an error message is returned.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** io.output")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","do","fileHandle = io.output(fileName)","print(fileHandle)","end","io.close(fileHandle)","print(fileHandle)","os.remove(fileName)","Assign the file to be the default output file.","Also see","io.input()","io.open()","io.output()","14873.htm");
+Page[172]=new Array("This function reads data from the default input file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data1 = io.read()","data1 = io.read("format1")","data1, data2 = io.read("format1", "format2")","data1, ..., dataN = io.read("format1", ..., "formatN")","data1","The data read from the file","data2","The data read from the file","dataN","The data read from the file; the number of return values matches the number of format values given","format1","A string or number indicating the type of data to be read","format2","A string or number indicating the type of data to be read","formatN","A string or number indicating the type of data to be read","...","One or more entries (or values) separated by commas","Details","The format parameters may be any of the following:","Format parameter","Description",""*n"","Returns a number",""*a"","Returns the whole file, starting at the present position; returns an empty string if it is at the end of file",""*l"","Returns the next line, skipping the end of line; returns nil if the present file position is at the end of file","N","Returns a string with up to N characters; returns an empty string if N is zero (0); returns nil if the present file position is at the end of file","Any number of format parameters may be passed to this command, each corresponding to a returned data value.","If no format parameters are provided, the function will perform as if the function was passed the value "*l".","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","-- io.read","print("\\n*** io.read")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1\\n")","myfile:flush()","myfile:close()","do","fileHandle = io.input(fileName)","value = io.read("*a")","print(value)","end","fileHandle:close()","print(errorqueue.next())","Read data from the default input file.","Also see","None","io.read()","14874.htm");
+Page[173]=new Array("This function checks whether or not a given object is a file handle.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","type = io.type(obj)","type","Indicates whether the object is an open file handle","obj","Object to check","Details","Returns the string "file" if the object is an open file handle. If it is not an open file handle, nil is returned.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** io.type")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","do","fileHandle = io.output(fileName)","state = io.type(fileHandle)","print(state)","end","io.close(fileHandle)","local state = io.type(fileHandle)","print(state)","os.remove(fileName)","Check whether or not fileName is a file handle.","Also see","io.open()","io.type()","14875.htm");
+Page[174]=new Array("This function writes data to the default output file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","io.write()","io.write(data1)","io.write(data1, data2)","io.write(data1, ..., dataN)","data1","The data to be written","data2","The data to be written","dataN","The data to be written","...","One or more values separated by commas","Details","All data parameters must be either strings or numbers.","@Data is not immediately written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.","Example","local fileName = "/usb1/myfile.txt"","if fs.is_file(fileName) then"," os.remove(fileName)"," print("Removing file")","else"," print("Nothing removed")","end","errorqueue.clear()","print("\\n*** io.write")","myfile, myfile_err, myfile_errnum = io.open(fileName, "w")","myfile:write("Line 1")","myfile:close()","do","fileHandle = io.output(fileName)","io.write("Line 2")","end","io.close(fileHandle)","os.remove(fileName)","Writes data to the default output file.","Also see","io.flush()","io.write()","14877.htm");
+Page[175]=new Array("This function re-initializes the LAN interface with new settings.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.applysettings()","Details","Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.","This function initiates a background operation. LAN configuration could be a lengthy operation. Although the function returns immediately, the LAN initialization continues to run in the background.","Even though the LAN configuration settings may not have changed since the LAN was last connected, new settings may take effect due to the dynamic nature of dynamic host configuration protocol (DHCP) or dynamic link local addressing (DLLA) configuration.","Re-initialization takes effect even if the configuration has not changed since the last time the instrument connected to the LAN.","Example","lan.applysettings()","Re-initialize the LAN interface with new settings.","Also see","None","lan.applysettings()","14890.htm");
+Page[176]=new Array("This attribute is used to enable or disable link monitoring.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","1 (lan.ENABLE)","Usage","state = lan.autoconnect","lan.autoconnect = state","state","LAN link monitoring state:","1 or lan.ENABLE: Enables automatic link reconnection and monitoring","0 or lan.DISABLE: Disables automatic link reconnection and monitoring","Details","This attribute sets the LAN link monitoring and automatic connection state.","When this is set to lan.ENABLE, all connections are closed if the link to the LAN is lost for more than the time specified by lan.linktimeout.","Set this attribute to lan.ENABLE to automatically reset the LAN connection after the LAN link is established.","Example","lan.autoconnect = lan.ENABLE","Enable LANK link monitoring.","Also see","lan.linktimeout","lan.restoredefaults()","lan.autoconnect","14891.htm");
+Page[177]=new Array("Configures DNS server IP addresses.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory",""0.0.0.0"","Usage","dnsAddress = lan.config.dns.address[N]","lan.config.dns.address[N] = "dnsAddress"","dnsAddress","DNS server IP address","N","Entry index (1 or 2)","Details","This attribute is an array of DNS (domain name system) server addresses. These addresses take priority for DNS lookups and are consulted before any server addresses that are obtained using DHCP. This allows local DNS servers to be specified that take priority over DHCP‑configured global DNS servers.","You can specify up to two addresses. The address specified by 1 is consulted first for DNS lookups. dnsAddress must be a string specifying the IP address of the DNS server in dotted decimal notation.","Unused entries are returned as "0.0.0.0" when read. To disable an entry, set its value to "0.0.0.0" or the empty string "".","Although only two addresses may be manually specified here, the instrument will use up to three DNS server addresses. If two are specified here, only one that is given by a DHCP server is used. If no entries are specified here, up to three addresses that are given by a DHCP server are used.","Example","dnsaddress = "164.109.48.173"","lan.config.dns.address[1] = dnsaddress","Set the DNS address 1 to "164.109.48.173"","Also see","lan.config.dns.domain","lan.config.dns.dynamic","lan.config.dns.hostname","lan.config.dns.verify","lan.restoredefaults()","lan.config.dns.address[N]","14898.htm");
+Page[178]=new Array("Configures the dynamic DNS domain.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","""","Usage","domain = lan.config.dns.domain","lan.config.dns.domain = "domain"","domain","Dynamic DNS registration domain; use a string of 255 characters or less","Details","This attribute holds the domain to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the domain specified in this attribute with the DNS server.","The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters. Although up to 255 characters are allowed, you must make sure the combined length is also no more than 255 characters.","Example","print(lan.config.dns.domain)","Outputs the present dynamic DNS domain. For example, if the domain is "Matrix", the response would be:","Matrix","Also see","lan.config.dns.dynamic","lan.config.dns.hostname","lan.config.dns.verify","lan.restoredefaults()","lan.config.dns.domain","14899.htm");
+Page[179]=new Array("Enables or disables the dynamic DNS registration.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","1 (lan.ENABLE)","Usage","state = lan.config.dns.dynamic","lan.config.dns.dynamic = state","state","The dynamic DNS registration state. It may be one of the following values:","1 or lan.ENABLE: Enabled","0 or lan.DISABLE: Disabled","Details","Dynamic DNS registration works with DHCP to register the host name with the DNS server. The host name is specified in the lan.config.dns.hostname attribute.","Example","print(lan.config.dns.dynamic)","Outputs the dynamic registration state.","If dynamic DNS registration is enabled, the response is:","1.00000e+00","Also see","lan.config.dns.hostname","lan.restoredefaults()","lan.config.dns.dynamic","14900.htm");
+Page[180]=new Array("This attribute defines the dynamic DNS host name.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","Instrument specific (see Details)","Usage","hostName = lan.config.dns.hostname","lan.config.dns.hostname = "hostName"","hostName","The host name to use for dynamic DNS registration; the host name must:","be a string of 63 characters or less","start with a letter","end with a letter or digit","contain only letters, digits, and hyphens","Details","This attribute holds the host name to request during dynamic DNS registration. Dynamic DNS registration works with DHCP to register the host name specified in this attribute with the DNS server.","The factory default value for hostName is "k‑<model number>‑<serial number>", where <model number> and <serial number> are replaced with the actual model number and serial number of the instrument (for example, "k‑2601B-PULSE‑1234567"). Note that hyphens separate the characters of hostName. ","The length of the fully qualified host name (combined length of the domain and host name with separator characters) must be less than or equal to 255 characters. Although up to 63 characters can be entered here, care must be taken to be sure the combined length is no more than 255 characters.","Setting this attribute to an empty string (in other words, setting this attribute to a string of length zero, or one consisting entirely of whitespace characters) will revert the host name to the factory default value.","Example","print(lan.config.dns.hostname)","Outputs the present dynamic DNS host name.","Also see","lan.config.dns.domain","lan.config.dns.dynamic","lan.restoredefaults()","lan.config.dns.hostname","66559.htm");
+Page[181]=new Array("This attribute defines the DNS host name verification state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","1 (lan.ENABLE)","Usage","state = lan.config.dns.verify","lan.config.dns.verify = state","state","DNS hostname verification state:","1 or lan.ENABLE: DNS host name verification enabled","0 or lan.DISABLE: DNS host name verification disabled","Details","When this is enabled, the instrument performs DNS lookups to verify that the DNS host name matches the value specified by lan.config.dns.hostname.","Example","print(lan.config.dns.verify)","Outputs the present DNS host name verification state.","If it is enabled, the output is:","1.00000e+00","Also see","lan.config.dns.hostname","lan.restoredefaults()","lan.config.dns.verify","14902.htm");
+Page[182]=new Array("This attribute defines the LAN duplex mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","1 (lan.FULL)","Usage","duplex = lan.config.duplex","lan.config.duplex = duplex","duplex","LAN duplex setting can be one of the following values:","1 or lan.FULL: Selects full-duplex operation","0 or lan.HALF: Selects half-duplex operation","Details","This attribute does not indicate the actual setting currently in effect. Use the lan.status.duplex attribute to determine the present operating state of the LAN.","Example","lan.config.duplex = lan.FULL","Select the LAN duplex mode to full.","Also see","lan.restoredefaults()","lan.config.duplex","14903.htm");
+Page[183]=new Array("This attribute contains the LAN default gateway address.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory",""0.0.0.0"","Usage","gatewayAddress = lan.config.gateway","lan.config.gateway = "gatewayAddress"","gatewayAddress","LAN default gateway address; must be a string specifying the default gateway’s IP address in dotted decimal notation","Details","This attribute specifies the default gateway IP address to use when manual or DLLA configuration methods are used to configure the LAN. If DHCP is enabled, this setting is ignored.","This attribute does not indicate the actual setting that is presently in effect. Use the lan.status.gateway attribute to determine the present operating state of the LAN.","The IP address must be formatted in four groups of numbers, each separated by a decimal.","Example","print(lan.config.gateway)","Outputs the default gateway address. For example, you might see the output:","192.168.0.1","Also see","lan.restoredefaults()","lan.status.gateway","lan.config.gateway","14904.htm");
+Page[184]=new Array("This command specifies the LAN IP address.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory",""192.168.0.2"","Usage","ipAddress = lan.config.ipaddress","lan.config.ipaddress = "ipAddress"","ipAddress","LAN IP address; must be a string specifying the IP address in dotted decimal notation","Details","This command specifies the LAN IP address to use when the LAN is configured using the manual configuration method. This setting is ignored when DLLA or DHCP is used. ","This attribute does not indicate the actual setting that is presently in effect. Use the lan.status.ipaddress attribute to determine the present operating state of the LAN.","Example","ipaddress = lan.config.ipaddress","Retrieves the presently set LAN IP address.","Also see","lan.restoredefaults()","lan.status.ipaddress","lan.config.ipaddress","14905.htm");
+Page[185]=new Array("This attribute contains the LAN settings configuration method.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","0 (lan.AUTO)","Usage","method = lan.config.method","lan.config.method = method","method","The method for configuring LAN settings; it can be one of the following values:","0 or lan.AUTO: Selects automatic sequencing of configuration methods","1 or lan.MANUAL: Use only manually specified configuration settings","Details","This attribute controls how the LAN IP address, subnet mask, default gateway address, and DNS server addresses are determined.","When method is lan.AUTO, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP). If DHCP fails, it tries dynamic link local addressing (DLLA). If DLLA fails, it uses the manually specified settings.","When method is lan.MANUAL, only the manually specified settings are used. Neither DHCP nor DLLA are attempted.","Example","print(lan.config.method)","Outputs the current method.","For example:","1.00000e+00","Also see","lan.restoredefaults()","lan.config.method","14906.htm");
+Page[186]=new Array("This attribute contains the LAN speed used when restarting in manual configuration mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","100 (100 Mbps)","Usage","speed = lan.config.speed","lan.config.speed = speed","speed","LAN speed setting in Mbps (10 or 100)","Details","This attribute stores the speed that will be used if the LAN is restarted for manual configuration operation.","This attribute does not indicate the actual setting presently in effect. Use the lan.status.speed attribute to determine the present operating state of the LAN.","The LAN speed is measured in megabits per second (Mbps).","Example","lan.config.speed = 100","Configure LAN speed for 100.","Also see","lan.restoredefaults()","lan.status.speed","lan.config.speed","14907.htm");
+Page[187]=new Array("This attribute contains the LAN subnet mask.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory",""255.255.255.0"","Usage","mask = lan.config.subnetmask","lan.config.subnetmask = "mask"","mask","String that specifies the LAN subnet mask value in dotted decimal notation","Details","This attribute specifies the LAN subnet mask that will be used when the manual configuration method is used to configure the LAN. This setting is ignored when DLLA or DHCP is used.","This attribute does not indicate the actual setting presently in effect. Use the lan.status.subnetmask attribute to determine the present operating state of the LAN.","Example","print(lan.config.subnetmask)","Outputs the LAN subnet mask, such as:","255.255.255.0","Also see","lan.restoredefaults()","lan.status.subnetmask","lan.config.subnetmask","14908.htm");
+Page[188]=new Array("This attribute contains the LAN link timeout period.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","20 (20 s)","Usage","timeout = lan.linktimeout ","lan.linktimeout = timeout","timeout","The LAN link monitor time-out period (in seconds)","Details","You must enable the command lan.autoconnect before you can use this attribute.","The timeout value represents the amount of time that passes before the instrument disconnects from the LAN due to the loss of the LAN link integrity.","The LAN interface does not disconnect if the connection to the LAN is reestablished before the timeout value expires.","If the LAN link integrity is not restored before the timeout value expires, the instrument begins to monitor for a new connection.","Example","print(lan.linktimeout)","Outputs the present LAN link timeout setting.","Also see","lan.autoconnect","lan.restoredefaults()","lan.linktimeout","14892.htm");
+Page[189]=new Array("This attribute contains the LXI domain.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","0","Usage","domain = lan.lxidomain","lan.lxidomain = domain","domain","The LXI domain number (0 to 255)","Details","This attribute sets the LXI domain number.","All outgoing LXI packets are generated with this domain number. All inbound LXI packets are ignored unless they have this domain number.","Example","print(lan.lxidomain)","Displays the LXI domain.","Also see","None","lan.lxidomain","14893.htm");
+Page[190]=new Array("This attribute controls the state of the LAN Nagle algorithm.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not saved","0 (lan.DISABLE)","Usage","state = lan.nagle","lan.nagle = state","state","The state of the Nagle algorithm:","1 or lan.ENABLE: Enable the LAN Nagle algorithm for TCP connections","0 or lan.DISABLE: Disable the Nagle algorithm for TCP connections","Details","This attribute enables or disables the use of the LAN Nagle algorithm on transmission control protocol (TCP) connections.","Also see","lan.restoredefaults()","lan.nagle","14894.htm");
+Page[191]=new Array("This function resets the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.reset()","Details","This function resets the LAN interface. It performs the commands lan.restoredefaults() and lan.applysettings().","Also see","lan.applysettings()","lan.restoredefaults()","lan.reset()","14895.htm");
+Page[192]=new Array("This function resets LAN settings to default values.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.restoredefaults()","Details","The settings that are restored are shown in the following table.","Settings that are restored to default","Attribute","Default setting","lan.autoconnect","lan.ENABLE","lan.config.dns.address[N]",""0.0.0.0"","lan.config.dns.domain","""","lan.config.dns.dynamic","lan.ENABLE","lan.config.dns.hostname",""K-<model number>-<serial number>"","lan.config.dns.verify","lan.ENABLE","lan.config.duplex","lan.FULL","lan.config.gateway",""0.0.0.0"","lan.config.ipaddress",""0.0.0.0"","lan.config.method","lan.AUTO","lan.config.speed","100","lan.config.subnetmask",""255.255.255.0"","lan.linktimeout","20 (seconds)","lan.lxidomain","0","lan.nagle","lan.DISABLE","lan.timedwait","20 (seconds)","This command is run when lan.reset() is sent.","Example","lan.restoredefaults()","Restores the LAN defaults.","Also see","lan.reset()","localnode.password","lan.restoredefaults()","14896.htm");
+Page[193]=new Array("This attribute contains the DNS server IP addresses.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","dnsAddress = lan.status.dns.address[N]","dnsAddress","DNS server IP address","N","Entry index (1, 2, or 3)","Details","This attribute is an array of DNS server addresses. The instrument can use up to three addresses.","Unused or disabled entries are returned as "0.0.0.0" when read. The dnsAddress returned is a string specifying the IP address of the DNS server in dotted decimal notation.","You can only specify two addresses manually. However, the instrument uses up to three DNS server addresses. If two are specified, only the one given by a DHCP server is used. If no entries are specified, up to three address given by a DHCP server are used.","The value of lan.status.dns.address[1] is referenced first for all DNS lookups. The values of lan.status.dns.address[2] and lan.status.dns.address[3] are referenced second and third, respectively.","Example","print(lan.status.dns.address[1])","Outputs DNS server address 1, for example:","164.109.48.173","Also see","lan.status.dns.name","lan.status.dns.address[N]","14909.htm");
+Page[194]=new Array("This attribute contains the present DNS fully qualified host name.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","hostName = lan.status.dns.name","hostName","Fully qualified DNS host name that can be used to connect to the instrument","Details","A fully qualified domain name (FQDN), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tree hierarchy of the Domain Name System (DNS).","A FQDN is the complete domain name for a specific computer or host on the LAN. The FQDN consists of two parts: the host name and the domain name.","If the DNS host name for an instrument is not found, this attribute stores the IP address in dotted decimal notation.","Example","print(lan.status.dns.name)","Outputs the dynamic DNS host name.","Also see","lan.config.dns.address[N]","lan.config.dns.hostname","lan.status.dns.name","14910.htm");
+Page[195]=new Array("This attribute contains the duplex mode presently in use by the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","duplex = lan.status.duplex","duplex","LAN duplex setting can be one of the following values:","0 or lan.HALF: half-duplex operation","1 or lan.FULL: full-duplex operation","Example","print(lan.status.duplex)","Outputs the present LAN duplex mode, such as:","1.00000e+00","Also see","None","lan.status.duplex","14911.htm");
+Page[196]=new Array("This attribute contains the gateway address presently in use by the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","gatewayAddress = lan.status.gateway","gatewayAddress","LAN gateway address presently being used","Details","The value of gatewayAddress is a string that indicates the IP address of the gateway in dotted decimal notation.","Example","print(lan.status.gateway)","Outputs the gateway address, such as:","192.168.0.1","Also see","lan.config.gateway","lan.status.gateway","14912.htm");
+Page[197]=new Array("This attribute contains the LAN IP address presently in use by the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","ipAddress = lan.status.ipaddress","ipAddress","LAN IP address specified in dotted decimal notation","Details","The IP address is a character string that represents the IP address assigned to the instrument.","Example","print(lan.status.ipaddress)","Outputs the LAN IP address currently in use, such as:","192.168.0.2","Also see","lan.config.ipaddress","lan.status.ipaddress","14913.htm");
+Page[198]=new Array("This attribute contains the LAN MAC address.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","macAddress = lan.status.macaddress","macAddress","The instrument MAC address","Details","The MAC address is a character string representing the MAC address of the instrument in hexadecimal notation. The string includes colons that separate the address octets (see Example).","Example","print(lan.status.macaddress)","Outputs the MAC address of the instrument, for example:","08:00:11:00:00:57","Also see","None","lan.status.macaddress","14914.htm");
+Page[199]=new Array("This attribute contains the LAN dead socket termination port number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","port = lan.status.port.dst","port","Dead socket termination socket port number","Details","This attribute holds the TCP port number used to reset all other LAN socket connections.","To reset all LAN connections, open a connection to the DST port number.","Example","print(lan.status.port.dst)","Outputs the LAN dead socket termination port number, such as:","5.03000e+03","Also see","None","lan.status.port.dst","14915.htm");
+Page[200]=new Array("This attribute contains the LAN raw socket connection port number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","port = lan.status.port.rawsocket","port","Raw socket port number","Details","The TCP port number used to connect the instrument and to control the instrument over a raw socket communication interface.","Example","print(lan.status.port.rawsocket)","Outputs the LAN raw socket port number, such as:","5.02500e+03","Also see","None","lan.status.port.rawsocket","14916.htm");
+Page[201]=new Array("This attribute contains the LAN Telnet connection port number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","port = lan.status.port.telnet","port","Telnet port number","Details","This attribute holds the TCP port number used to connect to the instrument to control it over a Telnet interface.","Example","print(lan.status.port.telnet)","Get the LAN Telnet connection port number.","Output:","2.30000e+01","Also see","None","lan.status.port.telnet","14917.htm");
+Page[202]=new Array("This attribute contains the LAN VXI-11 connection port number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","port = lan.status.port.vxi11","port","LAN VXI-11 port number","Details","This attribute stores the TCP port number used to connect to the instrument over a VXI-11 interface.","Example","print(lan.status.port.vxi11)","Outputs the VXI-11 number, such as:","1.02400e+03","Also see","None","lan.status.port.vxi11","14918.htm");
+Page[203]=new Array("This attribute contains the LAN speed.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","speed = lan.status.speed","speed","LAN speed in Mbps, either 10 or 100","Details","This attribute indicates the transmission speed currently in use by the LAN interface.","Example","print(lan.status.speed)","Outputs the transmission speed of the instrument presently in use, such as:","1.00000e+02","Also see","None","lan.status.speed","14919.htm");
+Page[204]=new Array("This attribute contains the LAN subnet mask that is presently in use by the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","mask = lan.status.subnetmask","mask","A string specifying the subnet mask in dotted decimal notation","Details","Use this attribute to determine the present operating state of the LAN. This attribute will return the present LAN subnet mask value if the LAN is manually configured, or when DLLA or DHCP is used.","Example","print(lan.status.subnetmask)","Outputs the subnet mask of the instrument that is presently in use, such as:","255.255.255.0","Also see","lan.config.subnetmask","lan.status.subnetmask","14920.htm");
+Page[205]=new Array("This attribute contains the LAN timed-wait state interval.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","LAN restore defaults","Nonvolatile memory","20 (20 s)","Usage","timeout = lan.timedwait","lan.timedwait = timeout","timeout","The LAN timed-wait state interval in seconds","Details","This attribute controls the amount of time that resources are allocated to closed TCP connections. When a TCP connection is closed, the connection is put in a timed-wait state and resources remain allocated for the connection until the timed-wait state ends. During the timed-wait interval, the instrument processes delayed packets that arrive after the connection is closed.","Use this attribute to tailor the timed-wait state interval for the instrument.","Example","lan.timedwait = 30","Set the amount of time resources are allocated to TCP connection to 30 s.","Also see","lan.restoredefaults()","lan.timedwait","14897.htm");
+Page[206]=new Array("This function simulates the occurrence of the trigger and generates the corresponding event ID.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.trigger[N].assert()","N","The LAN event number (1 to 8)","Details","Generates and sends a LAN trigger packet for the LAN event number specified.","Sets the pseudo line state to the appropriate state.","The following indexes provide the listed LXI events:","1:LAN0","2:LAN1","3:LAN2","…","8:LAN7","Example","lan.trigger[5].assert()","Creates a trigger with LAN packet 5.","Also see","lan.lxidomain","lan.trigger[N].clear()","lan.trigger[N].mode","lan.trigger[N].overrun","lan.trigger[N].stimulus","lan.trigger[N].wait()","Understanding hardware value and pseudo line state","lan.trigger[N].assert()","14921.htm");
+Page[207]=new Array("This function clears the event detector for a LAN trigger.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.trigger[N].clear()","N","The LAN event number (1 to 8) to clear","Details","The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the history of the trigger packet.","This function clears all overruns associated with this LAN trigger.","Example","lan.trigger[5].clear()","Clears the event detector with LAN packet 5.","Also see","lan.trigger[N].assert()","lan.trigger[N].overrun","lan.trigger[N].stimulus","lan.trigger[N].wait()","lan.trigger[N].clear()","14922.htm");
+Page[208]=new Array("This function prepares the event generator for outgoing trigger events.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.trigger[N].connect()","N","The LAN event number (1 to 8)","Details","This command prepares the event generator to send event messages. For TCP connections, this opens the TCP connection.","The event generator automatically disconnects when either the protocol or IP address for this event is changed.","Example","lan.trigger[1].protocol = lan.MULTICAST","lan.trigger[1].connect()","lan.trigger[1].assert()","Set the protocol for LAN trigger 1 to be multicast when sending LAN triggers. Then, after connecting the LAN trigger, send a message on LAN trigger 1 by asserting it.","Also see","lan.trigger[N].assert()","lan.trigger[N].ipaddress","lan.trigger[N].overrun","lan.trigger[N].protocol","lan.trigger[N].stimulus","lan.trigger[N].wait()","lan.trigger[N].connect()","14923.htm");
+Page[209]=new Array("This attribute stores the LAN event connection state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","connected = lan.trigger[N].connected","connected","The LAN event connection state:","true: Connected","false: Not connected","N","The LAN event number (1 to 8)","Details","This read-only attribute is set to true when the LAN trigger is connected and ready to send trigger events following a successful lan.trigger[N].connect() command; if the LAN trigger is not ready to send trigger events, this value is false.","This attribute is also false when either lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes are changed or the remote connection closes the connection.","Example","lan.trigger[1].protocol = lan.MULTICAST","print(lan.trigger[1].connected)","Outputs true if connected, or false if not connected.","Example output:","false","Also see","lan.trigger[N].connect()","lan.trigger[N].ipaddress","lan.trigger[N].protocol","lan.trigger[N].connected","14924.htm");
+Page[210]=new Array("This function disconnects the LAN trigger.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","lan.trigger[N].disconnect()","N","The LAN event number (1 to 8)","Details","For TCP connections, this closes the TCP connection.","The LAN trigger automatically disconnects when either the lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes for this event are changed.","Also see","lan.trigger[N].ipaddress","lan.trigger[N].protocol","lan.trigger[N].disconnect()","14925.htm");
+Page[211]=new Array("This constant is the event identifier used to route the LAN trigger to other subsystems (using stimulus properties).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","lan.trigger[N].EVENT_ID","N","The LAN event number (1 to 8)","Details","Set the stimulus of any trigger event detector to the value of this constant to have it respond to incoming LAN trigger packets.","Example","digio.trigger[14].stimulus = lan.trigger[1].EVENT_ID","Route occurrences of triggers on LAN trigger 1 to digital I/O trigger 14.","Also see","None","lan.trigger[N].EVENT_ID","14926.htm");
+Page[212]=new Array("This attribute specifies the address (in dotted‑decimal format) of UDP or TCP listeners.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset LAN trigger N reset Recall setup","Not saved ",""0.0.0.0"","Usage","ipAddress = lan.trigger[N].ipaddress","lan.trigger[N].ipaddress = "ipAddress"","ipAddress","The LAN address for this attribute as a string in dotted decimal notation","N","The LAN event number (1 to 8)","Details","Sets the IP address for outgoing trigger events.","Set to "0.0.0.0" for multicast.","After changing this setting, the lan.trigger[N].connect() command must be called before outgoing messages can be sent.","Example","lan.trigger[3].protocol = lan.TCP","lan.trigger[3].ipaddress = "192.168.1.100"","lan.trigger[3].connect()","Set the protocol for LAN trigger 3 to be lan.TCP when sending LAN triggers.","Use IP address "192.168.1.100" to connect the LAN trigger.","Also see","lan.trigger[N].connect()","lan.trigger[N].ipaddress","14927.htm");
+Page[213]=new Array("This attribute sets the trigger operation and detection mode of the specified LAN event.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset LAN trigger N reset Recall setup","Not saved","0 (lan.TRIG_EITHER)","Usage","mode = lan.trigger[N].mode","lan.trigger[N].mode = mode","mode","A number representing the trigger mode (0 to 7); see the Details section for more information","N","A number representing the LAN event number (1 to 8)","Details","This command controls how the trigger event detector and the output trigger generator operate on the given trigger. These settings are intended to provide behavior similar to the digital I/O triggers.","LAN trigger mode values","Mode ","Number","Trigger packets detected as input","LAN trigger packet generated for output with a…","lan.TRIG_EITHER","0","Rising or falling edge (positive or negative state)","negative state","lan.TRIG_FALLING","1","Falling edge (negative state)","negative state","lan.TRIG_RISING","2","Rising edge (positive state)","positive state","lan.TRIG_RISINGA","3","Rising edge (positive state)","positive state","lan.TRIG_RISINGM","4","Rising edge (positive state)","positive state","lan.TRIG_SYNCHRONOUS","5","Falling edge (negative state)","positive state","lan.TRIG_SYNCHRONOUSA","6","Falling edge (negative state)","positive state","lan.TRIG_SYNCHRONOUSM","7","Rising edge (positive state)","negative state","lan.TRIG_RISING and lan.TRIG_RISINGA are the same.","lan.TRIG_RISING and lan.TRIG_RISINGM are the same.","Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM over lan.TRIG_SYNCHRONOUS is preferred, as lan.TRIG_SYNCHRONOUS is provided for compatibility with older firmware.","Example","print(lan.trigger[1].mode)","Outputs the present LAN trigger mode of LAN event 1.","Also see","Digital I/O","TSP-Link system expansion interface","lan.trigger[N].mode","14928.htm");
+Page[214]=new Array("This attribute contains the overrun status of the LAN event detector.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","LAN trigger N clear LAN trigger N reset Instrument reset Recall setup","Not applicable","Not applicable","Usage","overrun = lan.trigger[N].overrun","overrun","The trigger overrun state for the specified LAN packet (true or false)","N","The LAN event number (1 to 8)","Details","This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred.","This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.","It also is not an indication of an output trigger overrun. Output trigger overrun indications are provided in the status model.","Example","overrun = lan.trigger[5].overrun","print(overrun)","Checks the overrun status of a trigger on LAN5 and outputs the value, such as:","false","Also see","lan.trigger[N].assert()","lan.trigger[N].clear()","lan.trigger[N].stimulus","lan.trigger[N].wait()","lan.trigger[N].overrun","14929.htm");
+Page[215]=new Array("This attribute sets the LAN protocol to use for sending trigger messages.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset LAN trigger N reset Recall setup","Not saved ","0 (lan.TCP)","Usage","protocol = lan.trigger[N].protocol","lan.trigger[N].protocol = protocol","protocol","The protocol to use for messages from the trigger:","0 or lan.TCP","1 or lan.UDP","2 or lan.MULTICAST","N","The LAN event number (1 to 8)","Details","The LAN trigger listens for trigger messages on all supported protocols, but uses the designated protocol for sending outgoing messages. After changing this setting, lan.trigger[N].connect() must be called before outgoing event messages can be sent.","When the lan.MULTICAST protocol is selected, the lan.trigger[N].ipaddress attribute is ignored and event messages are sent to the multicast address 224.0.23.159.","Example","print(lan.trigger[1].protocol)","Get LAN protocol to use for sending trigger messages for LAN event 1.","Also see","lan.trigger[N].connect()","lan.trigger[N].ipaddress","lan.trigger[N].protocol","14930.htm");
+Page[216]=new Array("This attribute sets the simulated line state for the LAN trigger.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset LAN trigger N reset Recall setup","Not saved ","1","Usage","pseudostate = lan.trigger[N].pseudostate","lan.trigger[N].pseudostate = pseudostate","pseudostate","The simulated line state (0 or 1)","N","A number representing the LAN event number (1 to 8)","Details","This attribute can be set to initialize the pseudo line state to a known value.","Setting this attribute does not cause the LAN trigger to generate any events or output packets.","Example","print(lan.trigger[1].pseudostate)","Get the present simulated line state for the LAN event 1.","Also see","None","lan.trigger[N].pseudostate","14931.htm");
+Page[217]=new Array("This attribute specifies events that cause this trigger to assert.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset LAN trigger N reset Recall setup","Not saved","0","Usage","triggerStimulus = lan.trigger[N].stimulus","lan.trigger[N].stimulus = triggerStimulus","triggerStimulus","The LAN event identifier used to trigger the event","N","A number specifying the trigger packet over the LAN for which to set or query the trigger source (1 to 8)","Details","This attribute specifies which event causes a LAN trigger packet to be sent for this trigger. Set triggerStimulus to one of the trigger event IDs, which are shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Setting this attribute to zero disables automatic trigger generation.","If any events are detected prior to calling lan.trigger[N].connect(), the event is ignored and the action overrun is set.","Example","lan.trigger[5].stimulus = trigger.timer[1].EVENT_ID","Use timer 1 trigger event as the source for LAN packet 5 trigger stimulus.","Also see","lan.trigger[N].assert()","lan.trigger[N].clear()","lan.trigger[N].connect()","lan.trigger[N].overrun","lan.trigger[N].wait()","lan.trigger[N].stimulus","17679.htm");
+Page[218]=new Array("This function waits for an input trigger.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = lan.trigger[N].wait(timeout)","triggered","Trigger detection indication (true or false)","N","The trigger packet over LAN to wait for (1 to 8)","timeout","Maximum amount of time in seconds to wait for the trigger event","Details","If one or more trigger events have been detected since the last time lan.trigger[N].wait() or lan.trigger[N].clear() was called, this function returns immediately.","After waiting for a LAN trigger event with this function, the event detector is automatically reset and rearmed regardless of the number of events detected.","Example","triggered = lan.trigger[5].wait(3)","Wait for a trigger with LAN packet 5 with a timeout of 3 seconds.","Also see","lan.trigger[N].assert()","lan.trigger[N].clear()","lan.trigger[N].overrun","lan.trigger[N].stimulus","lan.trigger[N].wait()","14933.htm");
+Page[219]=new Array("This attribute enables or disables automatic power line frequency detection at start‑up.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","true (enabled)","Usage","flag = localnode.autolinefreq","localnode.autolinefreq = flag","flag","The auto line frequency detection setting:","true: Enable automatic line frequency detection at start-up","false: Disable automatic line frequency detection at start-up","Details","When this attribute is set to true, the power line frequency is detected automatically the next time the 2601B-PULSE powers up. After the power line frequency is automatically detected at power-up, the localnode.linefreq attribute is set automatically to 50 or 60.","If the localnode.linefreq attribute is explicitly set, localnode.autolinefreq is automatically set to false.","When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].autolinefreq.","Also see","localnode.linefreq","localnode.autolinefreq","15007.htm");
+Page[220]=new Array("This attribute stores a user-defined description and mDNS service name of the instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","Instrument specific (see Details)","Usage","localnode.description = "description"","description = localnode.description","description","User-defined description and mDNS service name of the instrument; use a string of 63 characters or less","Details","This attribute stores a string that contains a description of the instrument. This value appears on LXI welcome page of the instrument. The value of this attribute is also used as the mDNS service name of the instrument.","This attribute's factory default value is "Keithley Instruments SMU <model number> - <serial number>", where <model number> and <serial number> are replaced with the actual model number and serial number of the instrument. Setting this attribute to an empty string (in other words, setting this attribute to a string of length zero, or one consisting entirely of whitespace characters) will revert the description to the factory default value.","When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].description.","Example","description = "System in Lab 05"","localnode.description = description","Set description to "System in Lab 05".","Also see","None","localnode.description","15008.htm");
+Page[221]=new Array("This attribute returns the product license agreements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Nonvolatile memory","Not applicable","Usage","license_agreement = localnode.license","license_agreement","The text of the license agreements","Example","print(localnode.license)","Returns the license agreements for the 2601B-PULSE.","Also see","None","localnode.license","92667.htm");
+Page[222]=new Array("This attribute contains the power line frequency setting that is used for NPLC calculations.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","60 (60 Hz)","Usage","frequency = localnode.linefreq","localnode.linefreq = frequency","frequency","An integer representing the detected or specified line frequency of the instrument","Details","To achieve optimum noise rejection when performing measurements at integer NPLC apertures, set the line frequency attribute to match the frequency (50 Hz or 60 Hz) of the AC power line. ","When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].linefreq. When this attribute is set, the localnode.autolinefreq attribute is automatically set to false. You can have the instrument automatically detect the AC power line frequency and set this attribute with the line frequency detected when the instrument power is turned on by setting the localnode.autolinefreq attribute to true.","Example 1","frequency = localnode.linefreq","Reads line frequency setting.","Example 2","localnode.linefreq = 60","Sets the line frequency to 60 Hz.","Also see","localnode.autolinefreq","localnode.linefreq","15012.htm");
+Page[223]=new Array("This attribute stores the model number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","model = localnode.model","model","The model number of the instrument","Example","print(localnode.model)","Outputs the model number of the local node. For example:","2601B-PULSE","Also see","localnode.serialno","localnode.model","92703.htm");
+Page[224]=new Array("This attribute stores the remote access password.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (W)","Yes","LAN reset LAN restore defaults","Nonvolatile memory","""","Usage","localnode.password = "password"","password","A string that contains the remote interface password","Details","This write-only attribute stores the password that is set for any remote interface. When password usage is enabled (localnode.passwordmode), you must supply a password to change the configuration or to control an instrument from a web page or other remote command interface.","The instrument continues to use the old password for all interactions until the command to change it executes. When changing the password, give the instrument time to execute the command before attempting to use the new password.","You cannot retrieve a lost password from any command interface.","You can reset the password by resetting the LAN from the front panel or by using the lan.reset() command.","When using this command from a remote node, localnode should be replaced with the node reference, for example, node[5].password.","Example","localnode.password = "N3wpa55w0rd"","Changes the remote interface password to N3wpa55w0rd.","Also see","lan.reset()","localnode.passwordmode","localnode.password","15014.htm");
+Page[225]=new Array("This attribute stores the remote access password enable mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","1 (localnode.PASSWORD_WEB)","Usage","mode = localnode.passwordmode","localnode.passwordmode = mode","mode","The remote password enable mode","Details","This attribute controls if and where remote access passwords are required. Set this attribute to one of the values below to enable password checking:","localnode.PASSWORD_NONE or 0: Disable passwords everywhere","localnode.PASSWORD_WEB or 1: Use passwords on the web interface only","localnode.PASSWORD_LAN or 2: Use passwords on the web interface and all LAN interfaces","localnode.PASSWORD_ALL or 3: Use passwords on the web interface and all remote command interfaces","When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].passwordmode.","You must also set a password.","Example","mode = localnode.PASSWORD_WEB","localnode.passwordmode = mode","localnode.password = "SMU1234"","Sets value of mode to PASSWORD_WEB.","Allows use of passwords on the web interface only.","Set the password to SMU1234.","Also see","localnode.password","localnode.passwordmode","15015.htm");
+Page[226]=new Array("This attribute determines if the instrument generates prompts in response to command messages.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not saved","0 (disabled)","Usage","prompting = localnode.prompts","localnode.prompts = prompting","prompting","Prompting mode:","Do not generate prompts: 1","Generate prompts: 0","Details","When the prompting mode is enabled, the instrument generates prompts when the instrument is ready to take another command. Because the prompt is not generated until the previous command completes, enabling prompts provides handshaking with the instrument to prevent buffer overruns.","When prompting is enabled, the instrument might generate the following prompts:","TSP>. The standard prompt, which indicates that the previous command completed normally.","TSP?. The prompt that is issued if there are unread entries in the error queue when the prompt is issued. Like the TSP> prompt, it indicates that processing of the command is complete. It does not mean the previous command generated an error, only that there were still errors in the queue when the command processing was complete.",">>>>. The continuation prompt, which occurs when downloading scripts. When downloading scripts, many command messages must be sent as a group. The continuation prompt indicates that the instrument is expecting more messages as part of the present command.","Commands do not generate prompts. The instrument generates prompts in response to command completion.","Prompts are enabled or disabled only for the remote interface that is active when you send the command. For example, if you enable prompts when the LAN connection is active, they will not be enabled for a subsequent USB connection.","@ Do not disable prompting when using Test Script Builder. Test Script Builder requires prompts and sets the prompting mode automatically. If you disable prompting, the instrument will stop responding when you communicate using Test Script Builder because it is waiting for a common complete prompt from Test Script Builder.","Example","localnode.prompts = 1","Enable prompting.","Also see","localnode.showerrors","tsplink.reset()","localnode.prompts","15016.htm");
+Page[227]=new Array("This attribute enables and disables the generation of prompts for IEEE Std 488.2 common commands.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not saved","1 (enabled)","Usage","prompting = localnode.prompts4882","localnode.prompts4882 = prompting","prompting","IEEE Std 488.2 prompting mode:","Disable prompting: 0","Enable prompting: 1","Details","When this attribute is enabled, the IEEE Std 488.2 common commands generate prompts if prompting is enabled with the localnode.prompts attribute. If localnode.prompts4882 is enabled, limit the number of *trg commands sent to a running script to 50 regardless of the setting of the localnode.prompts attribute.","When this attribute is disabled, IEEE Std 488.2 common commands will not generate prompts. When using the *trg command with a script that executes trigger.wait() repeatedly, disable prompting to avoid problems associated with the command interface input queue filling.","Example","localnode.prompts4882 = 0","Disables IEEE Std 488.2 common command prompting.","Also see","localnode.prompts","localnode.prompts4882","15017.htm");
+Page[228]=new Array("This function resets the local node instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","localnode.reset()","Details","If you want to reset a specific instrument or a subordinate node, use the node[X].reset() command.","A local node reset includes:","Source‑measure unit (SMU) attributes affected by a SMU reset are reset","Other settings are restored back to factory default settings","A localnode.reset() is different than a reset() because reset() resets the entire system. ","When using this command from a remote node, localnode should be replaced with the node reference, for example node[5].reset().","Example","localnode.reset()","Resets the local node.","Also see","reset()","smua.reset()","localnode.reset()","16978.htm");
+Page[229]=new Array("This attribute stores the firmware revision level.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","revision = localnode.revision","revision","Firmware revision level","Details","This attribute indicates the revision number of the firmware that is presently running in the instrument.","When using this command from a remote node, localnode should be replaced with the node reference. For example, node[5].revision.","Example","print(localnode.revision)","Outputs the present revision level.","Sample output:","1.0.0","Also see","localnode.description","localnode.model","localnode.serialno","localnode.revision","15018.htm");
+Page[230]=new Array("This attribute stores the instrument's serial number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","serialno = localnode.serialno","serialno","The serial number of the instrument","Details","This indicates the instrument serial number.","Example","display.clear()","display.settext(localnode.serialno)","Clears the instrument display.","Places the serial number of the instrument on the top line of its display.","Also see","localnode.description","localnode.model","localnode.revision","localnode.serialno","15019.htm");
+Page[231]=new Array("This attribute sets whether or not the instrument automatically sends generated errors.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not saved","0 (disabled)","Usage","errorMode = localnode.showerrors","localnode.showerrors = errorMode","errorMode","Show error setting:","Show errors: 1","Do not show errors: 0","Details","If this attribute is set to 1, the instrument automatically sends any generated errors stored in the error queue, and then clears the queue. Errors are processed after executing a command message (just before issuing a prompt, if prompts are enabled).","If this attribute is set to 0, errors are left in the error queue and must be explicitly read or cleared.","When using this command from a remote node, localnode should be replaced with the node reference, for example, node[5].showerrors.","Example","localnode.showerrors = 1","Enables sending of generated errors.","Also see","localnode.prompts","localnode.showerrors","15022.htm");
+Page[232]=new Array("This function creates a function to get the value of an attribute.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","getter = makegetter(table, "attributeName")","getter","The return value","table","Read‑only table where the attribute is located","attributeName","A string representing the name of the attribute","Details","This function is useful for aliasing attributes to improve execution speed. Calling the function created with makegetter() executes more quickly than accessing the attribute directly.","Creating a getter function is only useful if it is going to be called several times. Otherwise, the overhead of creating the getter function outweighs the overhead of accessing the attribute directly.","Example","getlevel = makegetter(smua.source, "levelv")","v = getlevel()","Creates a getter function called getlevel.","When getlevel() is called, it returns the value of smua.source.levelv. ","Also see","makesetter()","makegetter()","15041.htm");
+Page[233]=new Array("This function creates a function that, when called, sets the value of an attribute.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","setter = makesetter(table, "attributeName")","setter","Function that sets the value of the attribute","table","Read-only table where the attribute is located","attributeName","The string name of the attribute","Details","This function is useful for aliasing attributes to improve execution speed. Calling the setter function execute more quickly than accessing the attribute directly.","Creating a setter function is only useful if it is going to be called several times. If you are not calling the setter function several times, it is more efficient to access the attribute directly. ","Example","setlevel = makesetter(smua.source, "levelv")for v = 1, 10 do"," setlevel(v)","end","Creates a setter function called setlevel.","Using setlevel() in the loop sets the value of smua.source.levelv, performing a source sweep.","Also see","makegetter()","makesetter()","15042.htm");
+Page[234]=new Array("This function returns the present amount of available memory and the total amount of memory in the instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","freeMem, totalMem = meminfo()","freeMem","The amount of free dynamically allocated memory available","totalMem","The total amount of dynamically allocated memory in the instrument","Details","This function returns two values:","The amount of free dynamically allocated memory available in kilobytes","The total amount of dynamically allocated memory on the instrument in kilobytes","The difference between the two values is the amount presently used.","Example","print(meminfo())","Retrieve the amount of free and total memory in the instrument.","Output:","2.89840e+04 3.27680e+04","Also see","None","meminfo()","15050.htm");
+Page[235]=new Array("This function starts test scripts from a remote node. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes (see Details)","Usage","node[N].execute("scriptCode")","N","The node number of this instrument","scriptCode","A string containing the source code","Details","Only the remote master node can use the execute command to run a script on this node. This function does not run test scripts on the master node; only on this node when initiated by the master node.","This function may only be called when the group number of the node is different than the node of the master.","This function does not wait for the script to finish execution.","This command should only be used from a remote master when controlling this instrument over a TSP-Link®.","Example 1","node[2].execute(sourcecode)","Runs script code on node 2. The code is in a string variable called sourcecode.","Example 2","node[3].execute("x = 5")","Runs script code in string constant ("x = 5") to set x","equal to 5 on node 3.","Example 3","node[32].execute(TestDut.source)","Runs the test script stored in the variable TestDut","(previously stored on the master node) on node 32.","Also see","TSP advanced features","tsplink.group","node[N].execute()","29213.htm");
+Page[236]=new Array("This function returns the value of a global variable. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","value = node[N].getglobal("name")","value","The value of the variable","N","The node number of this instrument (1 to 64)","name","The global variable name","Details","This function retrieves the value of a global variable from the runtime environment of this node.","Do not use this command to retrieve the value of a global variable from the local node. Instead, access the global variable directly. This command should only be used from a remote master when controlling this instrument over a TSP-Link network.","Example","print(node[5].getglobal("test_val"))","Retrieves and outputs the value of the global variable named test_val from node 5.","Also see","node[N].setglobal()","TSP advanced features","node[N].getglobal()","15010.htm");
+Page[237]=new Array("This function sets the value of a global variable. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","node[N].setglobal("name", value)","N","The node number of this instrument (1 to 6463)","name","The global variable name to set","value","The value to assign to the variable","Details","From a remote node, use this function to assign the given value to a global variable.","Do not use this command to create or set the value of a global variable from the local node (set the global variable directly instead). This command should only be used from a remote master when controlling this instrument over a TSP-Link network.","Example","node[3].setglobal("x", 5)","Sets the global variable x on node 3 to the value of 5.","Also see","node[N].getglobal()","TSP advanced features","node[N].setglobal()","15020.htm");
+Page[238]=new Array("This function sets the operation complete status bit when all overlapped commands are completed.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","opc()","Details","This function causes the operation complete bit in the Standard Event Status Register to be set when all previously started local overlapped commands are complete. ","Note that each node independently sets its operation complete bits in its own status model. Any nodes that are not actively performing overlapped commands set their bits immediately. All remaining nodes set their own bits as they complete their own overlapped commands.","Example","opc()","waitcomplete()","print("1")","Output:","1","Also see","Status model","waitcomplete()","opc()","15054.htm");
+Page[239]=new Array("This function deletes the file or directory with a given name.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","success, msg = os.remove("filename")","success","A success indicator (true or nil)","msg","A message value (nil or an error message)","filename","A string representing the name of the file or directory to delete","Details","Directories must be empty before using the os.remove() function to delete them.","If this function fails, it returns nil (for success) and an error message string (for msg).","Example","os.remove("testFile")","Delete the file named testFile.","Also see","os.rename()","os.remove()","19929.htm");
+Page[240]=new Array("This function renames an existing file or directory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","success, msg = os.rename("oldname", "newname")","success","A success indicator (true or nil)","msg","A message value (nil or an error message)","oldname","String representing the name of the file or directory to rename","newname","String represent the new name of the file or directory","Details","If this function fails, it returns nil (for success) and an error message string (for msg).","Example","os.rename("testFile", "exampleFile")","Changes the name of the existing file testFile to the name exampleFile.","Also see","os.remove()","os.rename()","19930.htm");
+Page[241]=new Array("This function generates a time value in UTC time.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","utcTime = os.time()","utcTime = os.time(timespec)","utcTime","Time value in UTC time","timespec","The date and time (year, month, day, hour, and minute)","Details","The timespec is a table using the fields listed in the table below.","year","The year (1970 or later)","month","The month (1 to 12)","day","The day (1 to 31)","hour","The hour (00 to 23)","min","The minute (00 to 59)","sec","The second (00 to 59)","If the time (hour, minute, and second) options are not used, they default to noon for that day. When called without a parameter (the first form), the function returns the current time.","Set the time zone before calling the os.time() function.","Example","systemTime = os.time({year = 2019,"," month = 3,"," day = 31,"," hour = 14,"," min = 25})","settime(systemTime)","Sets the date and time to Mar 31, 2019 at 2:25 pm.","Also see","settime()","settimezone()","os.time()","25959.htm");
+Page[242]=new Array("This function generates a response message.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","print(value1)","print(value1, value2)","print(value1, ..., valueN)","value1","The first argument to output","value2","The second argument to output","valueN","The last argument to output","...","One or more values separated with commas","Details","TSP-enabled instruments do not have inherent query commands. Like other scripting environments, the print() command and other related print() commands generate output. The print() command creates one response message.","The output from multiple arguments is separated with a tab character.","Numbers are printed using the format.asciiprecision attribute. If you want use Lua formatting, print the return value from the tostring() function.","Example 1","x = 10","print(x)","Example of an output response message:","10","Note that your output might be different if you set your ASCII precision setting to a different value.","Example 2","x = true","print(tostring(x))","Example of an output response message:","true","Also see","format.asciiprecision","print()","17645.htm");
+Page[243]=new Array("This function prints data from tables or reading buffer subtables.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","printbuffer(startIndex, endIndex, bufferVar)","printbuffer(startIndex, endIndex, bufferVar, bufferVar2)","printbuffer(startIndex, endIndex, bufferVar, ..., bufferVarN)","startIndex","Beginning index of the buffer to print; this must be more than one and less than endIndex","endIndex","Ending index of the buffer to print; this must be more than startIndex and less than the index of the last entry in the tables","bufferVar","First table or reading buffer subtable to print","bufferVar2","Second table or reading buffer subtable to print","bufferVarN","The last table or reading buffer subtable to print","...","One or more tables or reading buffer subtables separated with commas","Details","If startIndex ≤ 1, 1 is used as startIndex. If n < endIndex, n is used as endIndex.","When any given reading buffers are used in overlapped commands that have not yet completed (at least to the specified index), this function outputs data as it becomes available.","When there are outstanding overlapped commands to acquire data, n refers to the index that the last entry in the table has after all the measurements have completed.","If you pass a reading buffer instead of a reading buffer subtable, the default subtable for that reading buffer is used.","This command generates a single response message that contains all data. The response message is stored in the output queue.","The format.data attribute controls the format of the response message.","Example","format.data = format.ASCII","format.asciiprecision = 6","printbuffer(1, rb1.n, rb1)","This assumes that rb1 is a valid reading buffer in the runtime environment. The use of rb1.n","(bufferVar.n) indicates that the instrument should output all readings in the reading buffer. In this example, rb1.n equals 10.","Example of output data (rb1.readings):","4.07205e-05, 4.10966e-05, 4.06867e-05, 4.08865e-05, 4.08220e-05, 4.08988e-05, 4.08250e-05, 4.09741e-05, 4.07174e-05, 4.07881e-05","Also see","bufferVar.n","bufferVar.readings","format.asciiprecision","format.byteorder","format.data","printnumber()","printbuffer()","80596.htm");
+Page[244]=new Array("This function prints numbers using the configured format.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","printnumber(value1)","printnumber(value1, value2)","printnumber(value1, ..., valueN)","value1","First value to print in the configured format","value2","Second value to print in the configured format","valueN","Last value to print in the configured format","...","One or more values separated with commas","Details","There are multiple ways to use this function, depending on how many numbers are to be printed.","This function prints the given numbers using the data format specified by format.data and format.asciiprecision.","Example","format.asciiprecision = 10","x = 2.54","printnumber(x)","format.asciiprecision = 3","printnumber(x, 2.54321, 3.1)","Configure the ASCII precision to 10 and set x to 2.54.","Read the value of x based on these settings.","Change the ASCII precision to 3.","View how the change affects the output of x and some numbers.","Output:","2.540000000e+00","2.54e+00, 2.54e+00, 3.10e+00","Also see","format.asciiprecision","format.byteorder","format.data","print()","printbuffer()printbuffer()","printnumber()","15058.htm");
+Page[245]=new Array("This function resets commands to their default settings.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","reset()","reset(system)","system","What to reset:","true: If the node is the master, the entire system is reset (default)","false: Only the local group is reset","Details","The reset() command in its simplest form resets the entire TSP‑enabled system, including the controlling node and all subordinate nodes.","If you want to reset a specific instrument, use either the localnode.reset() or node[X].reset() command. Use the localnode.reset() command for the local instrument. Use the node[X].reset() command to reset an instrument on a subordinate node.","You can only reset the entire system using reset(true) if the node is the master. If the node is not the master node, executing this command generates an error.","Example","reset(true)","If the node is the master node, the entire system is reset; if the node is not the master node, an error is generated.","Also see","localnode.reset()","reset()","13933.htm");
+Page[246]=new Array("This KISavebuffer factory script function saves a specified reading buffer as either a CSV file or an XML file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","savebuffer(buffer, "formatType", "fileName")","buffer","The reading buffer to save","formatType","A string indicating which file type to use: csv or xml","fileName","The file name of the saved buffer","Details","Use this function to save the specified buffer to a USB flash drive.","This function will only save to a USB flash drive. ","You are not required to qualify the path to the USB flash drive, but you can add /usb1/ before the fileName (see Example 2).","Example 1","savebuffer(smua.nvbuffer1, "csv", "mybuffer.csv")","Save smua dedicated reading buffer 1 as a CSV file named mybuffer.csv.","Example 2","savebuffer(smua.nvbuffer1, "csv", "/usb1/mybuffer.csv")","Save smua dedicated reading buffer 1 to an installed USB flash drive as a CSV file named mybuffer.csv.","Also see","KISavebuffer factory script","smua.savebuffer()","savebuffer()","12959.htm");
+Page[247]=new Array("This is a reference to the anonymous script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","No","See Details","See Details","Not applicable","Usage","scriptVar = script.anonymous","scriptVar","The name of the variable that references the script","Details","You can use the script.anonymous script like any other script. Also, you can save the anonymous script as a user script by giving it a name.","This script is replaced by loading a script with the loadscript or loadandrunscript commands when they are used without a name. ","Example 1","script.anonymous.list()","Displays the content of the anonymous script.","Example 2","print(script.anonymous.source)","Retrieves the source of the anonymous script.","Also see","Anonymous scripts","scriptVar.autorun","scriptVar.list()","scriptVar.name","scriptVar.run()","scriptVar.save()","scriptVar.source","script.anonymous","17040.htm");
+Page[248]=new Array("This function deletes a script from nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","script.delete("scriptName")","scriptName","The string that represents the name of the script","Example","script.delete("test8")","Deletes a user script named "test8" from nonvolatile memory.","Also see","Delete user scripts from the instrument","scriptVar.save()","script.delete()","16853.htm");
+Page[249]=new Array("This function returns an iterator that can be used in a for loop to iterate over all the factory scripts.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","for name in script.factory.catalog() do body end","name","String representing the name of the script","body","Code that implements the body of the for loop to process the names in the catalog","Details","Accessing this catalog of scripts allows you to process the factory scripts. The entries will be enumerated in no particular order.","Each time the body of the function executes, name takes on the name of one of the factory scripts. The for loop repeats until all scripts have been iterated.","Example","for name in script.factory.catalog() do"," print(name)","end","Retrieve the catalog listing for factory scripts.","Also see","None","script.factory.catalog()","19931.htm");
+Page[250]=new Array("This function creates a script from a specified file.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar = script.load("file")","scriptVar = script.load("file", "name")","scriptVar","The created script; this is nil if an error is encountered","file","The path and file name of the script file to load","name","The name of the script to be created","Details","The file path may be absolute or relative to the current working directory. The root folder of the USB flash drive has the absolute path "/usb1/". Both the forward slash (/) and backslash (\\) are supported as directory separators.","The file to be loaded must start with the loadscript or loadandrunscript keywords, contain the body of the script, and end with the endscript keyword.","Script naming:","If the name parameter is an empty string, or name is absent (or nil) and the script name cannot be extracted from the file, scriptVar is the only handle to the created script.","If name is given (and not nil), any script name embedded in the file is ignored.","If name conflicts with the name of an existing script in the script.user.scripts table, the existing script’s name attribute is set to an empty string before it is replaced in the script.user.scripts table by the new script.","If name is absent or nil, the command attempts to extract the name of the script from the file. Any conflict between the extracted name and that of an existing script in the scripts table generates an error. If the script name cannot be extracted, the created script's name attribute is initialized to the empty string and must be set to a valid nonempty string before saving the script to nonvolatile memory.","Example","myTest8 = script.load("/usb1/filename.tsp", "myTest8")","Loads the script myTest8 from the USB flash drive.","Also see","script.new()","script.load()","15063.htm");
+Page[251]=new Array("This function creates a script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar = script.new("code")","scriptVar = script.new("code", "name")","scriptVar","The name of the variable that will reference the script","code","A string containing the body of the script","name","The name of the script","Details","The name parameter is the name that is added to the script.user.scripts table. If name is not given, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the existing script's name attribute is set to an empty string before it is replaced by the new script.","Note that name is the value that is used for the instrument front panel display. If this value is not defined, the script is not available from the front panel. ","You must save the new script into nonvolatile memory to keep it when the instrument is turned off.","Example 1","myTest8 = script.new("," "display.clear() display.settext('Hello from myTest8')", "myTest8")","myTest8()","Creates a new script referenced by the variable myTest8 with the name "myTest8".","Runs the script. The instrument displays "Hello from myTest8".","Example 2","autoexec = script.new("," "display.clear() display.settext('Hello from autoexec')", 'autoexec')","Creates a new autoexec script that clears the display when the instrument is turned on and displays "Hello from autoexec".","Also see","Create a script using the script.new() command","Global variables and the script.user.scripts table","Named scripts","scriptVar.save()","script.newautorun()","script.new()","15064.htm");
+Page[252]=new Array("This function creates a script and enables autorun.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar = script.newautorun("code")","scriptVar = script.newautorun("code", "name")","scriptVar","The name of the variable that will reference the script","code","A string that contains the body of the script","name","The name of the script","Details","The name parameter is the name that is added to the script.user.scripts table. If name is not given, an empty string is used, and the script is unnamed. If the name already exists in script.user.scripts, the existing script's name attribute is set to an empty string before it is replaced by the new script.","Note that name is the value that is used for the instrument front panel display. If this value is not defined, the script is not available from the front panel. ","You must save the new script into nonvolatile memory to keep it when the instrument is turned off.","The script is run automatically immediately after it is created.","This command is the same as the script.new() function except that the script is automatically run.","Example","NewAuto = script.newautorun("print('Hello from new auto run command')", 'NewAuto')","print(NewAuto.autorun)","print(NewAuto.name)","Creates a new script called NewAuto that automatically has the autorun attribute set to yes after it is created. The name is set to "NewAuto".","Output:","Hello from new auto run command","yes","NewAuto","Also see","Create a script using the script.new() command","Global variables and the script.user.scripts table","Named scripts","script.new()","scriptVar.autorun","scriptVar.save()","script.newautorun()","18832.htm");
+Page[253]=new Array("This function restores a script that was removed from the runtime environment.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","script.restore(name)","name","The name of the script to be restored","Details","This command copies the script from nonvolatile memory into the runtime environment. It also creates a global variable with the same name as the name of the script.","Example","script.restore("test9")","Restores a script named test9 from nonvolatile memory.","Also see","script.delete()","script.restore()","16851.htm");
+Page[254]=new Array("This function runs the anonymous script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","script.run()","run()","Details","Each time the script.run() command is given, the anonymous script is executed. This script can be run using this command many times without having to re-send it. ","Example","run()","Runs the anonymous script.","Also see","script.anonymous","script.run()","18833.htm");
+Page[255]=new Array("This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","for name in script.user.catalog() do body end","name","String representing the name of the script","body","Code that implements the body of the for loop to process the names in the catalog","Details","This function accesses the catalog of scripts stored in nonvolatile memory, which allows you to process all scripts in nonvolatile memory. The entries are enumerated in no particular order.","Each time the body of the function executes, name takes on the name of one of the scripts stored in nonvolatile memory. The for loop repeats until all scripts have been iterated.","Example","for name in script.user.catalog() do"," print(name)","end","Retrieve the catalog listing for user scripts.","Also see","None","script.user.catalog()","16862.htm");
+Page[256]=new Array("This attribute controls the autorun state of a script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Not applicable","See Details","See Details","Usage","scriptVar.autorun = "state"","state = scriptVar.autorun","scriptVar","The name of the variable that references the script","state","String that indicates whether or not the script runs automatically when powered on:","yes: Script runs automatically","no: Script does not run automatically","Details","Autorun scripts run automatically when the instrument is turned on. You can set any number of scripts to autorun.","The run order for autorun scripts is arbitrary, so make sure the run order is not important.","The default value for scriptVar.autorun depends on how the script was loaded. The default is no if the script was loaded with loadscript or script.new(). It is yes for scripts loaded with loadandrunscript or script.newautorun().","@Make sure to save the script in nonvolatile memory after setting the autorun attribute so that the instrument keeps the setting.","Example","test5.autorun = "yes"","test5.save()","Assume a script named test5 is in the runtime environment.","The next time the instrument is turned on, test5 script automatically loads and runs.","Also see","None","scriptVar.autorun","16852.htm");
+Page[257]=new Array("This function generates a script listing.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar.list()","scriptVar","The name of the variable that references the script","Details","This function generates output in the form of a sequence of response messages (one message for each line of the script). It also generates output of the script control messages (loadscript or loadandrunscript and endscript).","Example","test7 = script.new("display.clear() display.settext('Hello from my test')", "test7")","test7()","test7.save()","test7.list()","The above example code creates a script named test7 that displays text on the front panel and lists the script with the following output:","loadscript test7","display.clear() display.settext("Hello from my test")","endscript","Also see","Load a script by sending commands over the remote interface","Retrieve source code one line at a time","scriptVar.list()","17785.htm");
+Page[258]=new Array("This attribute contains the name of a script in the runtime environment.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Not applicable","Not applicable","Not applicable","Usage","scriptVar.name = "scriptName"","scriptName = scriptVar.name","scriptVar","Name of the variable that references the script","scriptName","A string that represents the name of the script","Details","When setting the script name, this attribute renames the script that the variable scriptVar references.","This attribute must be either a valid Lua identifier or the empty string. Changing the name of a script changes the index that is used to access the script in the script.user.scripts table. Setting the attribute to an empty string removes the script from the table completely, and the script becomes an unnamed script.","As long as there are variables referencing an unnamed script, the script can be accessed through those variables. When all variables that reference an unnamed script are removed, the script is removed from the runtime environment.","If the new name is the same as a name that is already used for another script, the name of the other script is set to an empty string, and that script becomes unnamed. ","@Changing the name of a script does not change the name of any variables that reference that script. The variables still reference the script, but the names of the script and variables may not match.","Example","test7 = script.new("display.clear() display.settext('Hello from my test')", "")","test7()","print(test7.name)","test7.name = "test7"","print(test7.name) ","test7.save()","This example calls the script.new() function to create a script with no name, runs the script, names the script "test7", and then saves the script in nonvolatile memory.","Also see","Rename a script","script.new()","scriptVar.save()","scriptVar.name","2589.htm");
+Page[259]=new Array("This function runs a script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar.run()","scriptVar()","scriptVar","The name of the variable that references the script","Details","The scriptVar.run() function runs the script referenced by scriptVar. You can also run the script by using scriptVar().","To run a factory script, use script.factory.scripts.scriptName(), replacing scriptName with the name of the factory script.","Example","test8.run()","Runs the script referenced by the variable test8.","Also see","None","scriptVar.run()","16856.htm");
+Page[260]=new Array("This function saves the script to nonvolatile memory or to a USB flash drive.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","scriptVar.save()","scriptVar.save("filename")","scriptVar","The name of variable that references the script","filename","A string that contains the file name to use when saving the script to a USB flash drive","Details","The scriptVar.save() function saves a script to nonvolatile memory or a USB flash drive. The root folder of the USB flash drive has the absolute path /usb1/.","If no filename is specified (the file name parameter is an empty string), the script is saved to internal nonvolatile memory. Only a script with filename defined can be saved to internal nonvolatile memory. If a filename is given, the script is saved to the USB flash drive.","You can add the file extension, but it is not required. The only allowed extension is .tsp (see Example 2).","Example 1","test8.save()","Saves the script referenced by the variable test8 to nonvolatile memory.","Example 2","test8.save("/usb1/myScript.tsp")","Saves the script referenced by the variable test8 to a file named myScript.tsp on your USB flash drive.","Also see","Save a user script","scriptVar.save()","16863.htm");
+Page[261]=new Array("This attribute contains the source code of a script.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW) (see Details)","No","Not applicable","Not saved","Not applicable","Usage","code = scriptVar.source","scriptVar.source = nil","scriptVar","The name of the variable that references the script that contains the source code","code","A string that contains the body of the script","Details","The loadscript or loadandrunscript and endscript keywords are not included in the source code. ","The body of the script is a single string with lines separated by the new line character.","The instrument automatically stores the source for all scripts that are loaded on the instrument. To free up memory or to obfuscate the code, assign nil to the source attribute of the script. Although this attribute is writable, it can only be set to the nil value.","Example","test7 = script.new("display.clear() display.settext('Hello from my test')", "")","print(test7.source)","This example creates a script called test7 that displays a message on the front panel and retrieves the source code.","Output:","display.clear() display.settext('Hello from my test')","Also see","scriptVar.list()","scriptVar.source","16867.htm");
+Page[262]=new Array("This attribute configures the baud rate for the RS-232 port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","9600","Usage","baud = serial.baud","serial.baud = baud","baud","The baud rate (300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200)","Details","A new baud rate setting takes effect when the command to change it is processed.","@Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the baud rate from one of the other command interfaces or from the front panel.","The reset function has no effect on data bits.","Example","serial.baud = 1200","Sets the baud rate to 1200.","Also see","RS-232 interface operation","serial.databits","serial.flowcontrol","serial.parity","serial.baud","15068.htm");
+Page[263]=new Array("This attribute configures character width (data bits) for the RS-232 port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","8","Usage","bits = serial.databits","serial.databits = bits","bits","An integer representing the character width (7 or 8)","Details","A new data width setting takes effect when the command to change it is processed.","@Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the character width from one of the other command interfaces or from the front panel.","The reset function has no effect on data bits.","Example","serial.databits = 8","Sets data width to 8.","Also see","RS-232 interface operation","serial.baud","serial.flowcontrol","serial.parity","serial.databits","15069.htm");
+Page[264]=new Array("This attribute configures flow control for the RS-232 port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory",""none" (serial.FLOW_NONE)","Usage","flow = serial.flowcontrol","serial.flowcontrol = flow","flow","A string or value that represents flow control configuration; set to:",""none" or serial.FLOW_NONE (selects no flow control)",""hardware" or serial.FLOW_HARDWARE (selects hardware flow control)","Details","A new flow control setting takes effect when the command to change it is processed.","@Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set the flow control from one of the other command interfaces or from the front panel.","The reset function has no effect on flow control.","Example","serial.flowcontrol = serial.FLOW_NONE","Sets flow control to none.","Also see","serial.baud","serial.databits","serial.parity","serial.flowcontrol","15070.htm");
+Page[265]=new Array("This attribute configures parity for the RS-232 port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory",""none" (serial.PARITY_NONE)","Usage","parity = serial.parity","serial.parity = parity","parity","Set parity to one of the following values:","Select no parity ("none" or serial.PARITY_NONE)","Select even parity ("even" or serial.PARITY_EVEN)","Select odd parity ("odd" or serial.PARITY_ODD)","Details","A new parity setting takes effect when the command to change it is processed.","@Allow ample time for the command to be processed before attempting to communicate with the instrument again. If possible, set parity from one of the other command interfaces or from the front panel.","The reset function has no effect on parity.","Example","serial.parity = serial.PARITY_NONE","Sets parity to none.","Also see","RS-232 interface operation","serial.baud","serial.databits","serial.flowcontrol","serial.parity","15071.htm");
+Page[266]=new Array("This function reads available characters (data) from the serial port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data = serial.read(maxchars)","data","A string that consists of all data read from the serial port","maxchars","An integer that specifies the maximum number of characters to read","Details","This function reads available characters from the serial port. It does not wait for new characters to arrive. As long as maxchars is less than 200 characters, all characters that are received by the serial port (before the serial.read() command is executed) are returned. If too many characters are received between calls to this function, the RS-232 buffers will overflow and some characters may be lost.","Call this function as many times as necessary to receive the required number of characters. For optimal performance, use a small delay between repeated calls to this function.","The data returned is the raw data stream read from the port. No characters, such as control characters or terminator characters, are interpreted.","If you attempt to use this function when the serial port is enabled as a command interface, a settings conflict error is generated.","Example","data = serial.read(200)","print(data)","Read data from the serial port.","Output:","John Doe","The above output indicates that the string "John Doe" was read from the serial port.","Also see","serial.write()","serial.read()","15072.htm");
+Page[267]=new Array("This function writes data to the serial port.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","serial.write("data")","data","A string representing the data to write","Details","This function writes the specified string to the serial port, where it can be read by connected equipment (for example, a component handler). ","No terminator characters are added to the data, and data is written exactly as specified by the data parameter.","Example","serial.write("1 2 3 4")","Write data string "1 2 3 4" to the serial port.","Also see","serial.read()","serial.write()","15073.htm");
+Page[268]=new Array("This function sets the real-time clock (sets present time of the system).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","settime(time)","time","The time in seconds since January 1, 1970 UTC","Details","This function sets the date and time of the instrument based on the time parameter (specified in UTC time). UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).","Example","systemTime = os.time({year = 2020,"," month = 3,"," day = 31,"," hour = 14,"," min = 25})","settime(systemTime)","Sets the date and time to Mar 31, 2020 at 2:25 pm.","Also see","gettimezone()","os.time()","settimezone()","settime()","13943.htm");
+Page[269]=new Array("This function sets the local time zone.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","settimezone(offset)","settimezone("offset", "dstOffset", "dstStart", "dstEnd")","offset","String representing offset from UTC","dstOffset","String representing the daylight savings offset from UTC","dstStart","String representing when daylight savings time starts","dstEnd","String representing when daylight savings time ends","Details","You only need to set the time zone if you use the os.time() and os.date() functions. ","If only one parameter is given, the same time offset is used throughout the year. If four parameters are given, time is adjusted twice during the year for daylight savings time.","offset and dstOffset are strings of the form "[+|-]hh[:mm[:ss]]" that indicate how much time must be added to the local time to get UTC time:","hh is a number between 0 and 23 that represents hours","mm is a number between 0 and 59 that represents minutes","ss is a number between 0 and 59 that represents seconds","The minute, second, +, and - fields are optional.","For example, to set the UTC-5 time zone, you specify the string "5", because UTC-5 is 5 hours behind UTC and you must add 5 hours to the local time to determine UTC time. To specify the time zone UTC4, you specify "-4", because UTC4 is 4 hours ahead of UTC and 4 hours must be subtracted from the local time to determine UTC.","dstStart and dstEnd are strings of the form "MM.w.dw/hh[:mm[:ss]]" that indicate when daylight savings time begins and ends respectively:","MM is a number between 1 and 12 that represents the month","w is a number between 1 and 5 that represents the week in the month","dw is a number between 0 and 6 that represents the day of the week (where 0 is Sunday)","The rest of the fields represent the time of day that the change takes effect:","hh represents hours","mm represents minutes","ss represents seconds","The minutes and seconds fields are optional.","The week of the month and day of the week fields are not specific dates.","Example","settimezone("8", "1", "3.3.0/02", "11.2.0/02")
","settimezone(offset)","Sets offset to equal +8 hours, +1 hour for DST, starts on Mar 14 at 2:00 am, ends on Nov 7 at 2:00 am.","Sets local time zone to offset.","Also see","gettimezone()","os.time()","settime()","settimezone()","15021.htm");
+Page[270]=new Array("This attribute specifies which saved setup to recall when the instrument is turned on.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","0","Usage","id = setup.poweron","setup.poweron = id","id","An integer that specifies the setup to recall when the instrument power is turned on (0 to 5)","Details","When id = 0, the instrument uses the factory default setup when it is turned on. When id is set to 1 to 5, it uses the setup saved with setup.save().","Only setups stored in nonvolatile memory are available (you cannot recall a script from a USB flash drive with this command).","To save a script that is used when the instrument is powered on, you can create a configuration script and name it autoexec.","Example","setup.poweron = 0","Set the instrument to use the factory default setup when power is turned on.","Also see","setup.save() ","Start-up (power-on) configuration","setup.poweron","15081.htm");
+Page[271]=new Array("This function recalls settings from a saved setup.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","setup.recall(id)","id","An integer or string that specifies the location of the setup to recall:","Factory default setup: 0","User-saved setup in nonvolatile memory: 1 to 5","User-saved setup on a USB flash drive: "/path/filename"","Details","When the id parameter is an integer (n), it is interpreted as the setup number to restore from the instrument's nonvolatile memory. When n = 0, the instrument recalls the factory default setup; when n = 1 to 5, the instrument recalls a user-saved setup.","When the id parameter is a string, it is interpreted as the path and file name of the setup to restore from a file on a USB flash drive. The path may be absolute or relative to the current working directory.","Before a setup is recalled, an instrument reset is performed.","Example 1","setup.recall(1)","Recall the user-saved setup at location 1.","Example 2","setup.recall("/usb1/KEITHLEY_30730.set")","Recall a user-saved setup stored in a file named KEITHLEY_30730 on a USB flash drive.","Also see","Saved setups","setup.save()","setup.recall()","66566.htm");
+Page[272]=new Array("This function saves the present setup as a user-saved setup.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","setup.save(id)","id","An integer or string specifying where to save the user setup:","Save in nonvolatile memory (1 to 5)","Save as user-saved setup on a USB flash drive ("/path/filename")","Details","When the id parameter is an integer (n), it is interpreted as the setup number to save to the instrument's nonvolatile memory.","@When you save to a specified integer (1 to 5) in nonvolatile memory, the previous setup at that same location is overwritten.","When the id parameter is a string, it is interpreted as the path and file name of the location to save the present setup on a USB flash drive. The path may be absolute or relative to the current working directory.","Example","setup.save(5)","Saves the present setup to the internal memory of the instrument at location 5.","Also see","Saved setups","setup.recall()","setup.save()","15083.htm");
+Page[273]=new Array("This function terminates all overlapped operations on the source‑measure unit (SMU).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.abort()","Details","The smua.abort() function does not turn the output off or change any settings.","If this function is used to abort a sweep, when it is executed, the SMU exits its trigger model immediately and returns to the idle state of the trigger model.","Example","smua.abort()","Terminates all overlapped operations.","Also see","smua.measure.overlappedY()","smua.trigger.initiate()","smua.abort()","15088.htm");
+Page[274]=new Array("This function returns the statistics for a specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","statistics = smua.buffer.getstats(bufferVar)","statistics","The statistical data about the data in the reading buffer","bufferVar","The reading buffer to process","Details","This function returns a table with statistical data about the data that is placed in the buffer.","The SMU automatically updates reading buffer statistics as data is added to the reading buffer. When the reading buffer is configured to wrap around and overwrite older data with new data, the buffer statistics include the data that was overwritten.","The table returned from this function is a snapshot. Although the SMU continues to update the statistics, the table returned is not updated. To get fresh statistics, call this function again.","The statistics parameter has the attributes described in the following table.","Attribute","When returned","Description","n","Always","The number of data points on which the statistics are based","mean","When n > 0","The average of all readings added to the buffer","stddev","When n > 1","The standard deviation of all readings (samples) added to the buffer","min","When n > 0","A table containing data about the minimum reading value added to the buffer","max","When n > 0","A table containing data about the maximum reading value added to the buffer","If n equals zero (0), all other attributes are nil. If n equals 1, the stddev attribute is nil because the standard deviation of a sample size of 1 is undefined.","The min and max entries each have the attributes defined in the following table.","Attribute","Description","measurefunction","String indicating the function that was measured for the reading (current, voltage, ohms or watts)","measurerange","The full-scale range value for the measurement range used when the measurement was made","reading","The reading value","sourcefunction","String indicating the source function at the time of the measurement (current or voltage)","sourceoutputstate","String indicating the state of the source (off or on)","sourcerange","Full-scale range value for the source range used when the measurement was made","sourcevalue","If bufferVar.collectsourcevalues is enabled, the sourced value in effect at the time of the reading","status","Status value for the reading; the status value is a floating-point number that encodes the status value into a floating-point value","timestamp","If bufferVar.collecttimestamps is enabled, the timestamp, in seconds, between when the reading was acquired and when the first reading in the buffer was acquired; adding this value to the base timestamp will give the actual time the measurement was acquired","Example","reset()","smua.nvbuffer1.clear()","smua.measure.count = 10","smua.measure.v(smua.nvbuffer1)","stats = smua.buffer.getstats(smua.nvbuffer1)","print("n= "..stats.n)","print("mean= "..stats.mean)","print("stddev= "..stats.stddev)","print("min= "..stats.min.reading)","print("max= "..stats.max.reading)","Make measurements and store them in nvbuffer1. Print the statistics for the data.","Example output:","n= 10","mean= -2.3851394871599e-05","stddev= 4.406545187484e-07","min= -2.4557113647461e-05","max= -2.322196996829e-05","Also see","smua.buffer.recalculatestats()","smua.buffer.getstats()","18554.htm");
+Page[275]=new Array("This function recalculates the statistics of the specified reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.buffer.recalculatestats(bufferVar)","bufferVar","The reading buffer to process","Details","This function causes the SMU to regenerate the reading buffer statistics about the specified reading buffer. Because the SMU automatically updates reading buffer statistics when data is added to the reading buffer, this function is generally not needed. When the reading buffer is configured to wrap around and overwrite older data with new data, the buffer statistics will include the data that was overwritten. Use this function to recalculate the statistics that include only the data that is presently stored in the buffer.","Example","smua.buffer.recalculatestats(smua.nvbuffer1)","Recalculates the statistics of buffer smua.nvbuffer1.","Also see","bufferVar.fillmode","smua.buffer.getstats()","smua.buffer.recalculatestats()","18556.htm");
+Page[276]=new Array("This attribute stores the date of the last calibration adjustment.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU cal. restore","SMU nonvolatile memory","Initially set to factory calibration date","Usage","adjustDate = smua.cal.adjustdate","smua.cal.adjustdate = adjustDate","adjustDate","Date of the last adjustment","Details","This attribute stores the adjustment date associated with the active calibration set. The adjustment date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function.","You cannot change the adjustment date without first making a change to the calibration constants.","Once you change any calibration constants, you must set the adjustment date before you can save the calibration data to the nonvolatile memory of the SMU.","This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute reflects the date stored with that set.","smua.cal.adjustdate must be set to the date the adjustment was done using the UTC time and date. The date is stored as the number of seconds since UTC, 12:00 am Jan 1, 1970.","Due to the internal storage format, smua.cal.adjustdate is only accurate to within a few minutes of the value set.","Example","smua.cal.adjustdate = os.time()","Sets the adjustment date to the current time set on the instrument.","Also see","Adjustment","os.time()","smua.cal.date","smua.cal.due","smua.cal.lock()","smua.cal.restore()","smua.cal.save()","smua.cal.state","smua.cal.unlock()","smua.cal.adjustdate","15093.htm");
+Page[277]=new Array("This attribute stores the calibration date of the active calibration set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU calibration restore","SMU nonvolatile memory","Initially set to factory calibration date","Usage","calDate = smua.cal.date","smua.cal.date = calDate","calDate","The calibration date of the active calibration set","Details","This attribute stores the calibration date that is associated with the active calibration set. The calibration date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function. It is typically set to the date when the instrument was calibrated.","This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute will reflect the date stored with that set.","smua.cal.date must be set to the date the calibration was done using the UTC time and date. The date is stored as the number of seconds since UTC 12:00 am Jan 1, 1970.","Due to the internal storage format, smua.cal.date is accurate to within a few minutes of the value set.","Example","smua.cal.date = os.time()","Sets calibration date to the present time set on the instrument.","Also see","Adjustment","os.time()","smua.cal.adjustdate","smua.cal.due","smua.cal.lock()","smua.cal.restore()","smua.cal.save()","smua.cal.state","smua.cal.unlock()","smua.cal.date","15094.htm");
+Page[278]=new Array("This attribute stores the calibration due date for the next calibration.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU cal. restore","SMU nonvolatile memory","0","Usage","calDue = smua.cal.due","smua.cal.due = calDue","calDue","Due date of next calibration (0 indicates that no date is set)","Details","This attribute stores the calibration due date associated with the active calibration set. The calibration due date can be read at any time but can only be assigned a new value when calibration has been enabled with the smua.cal.unlock() function. It is typically set to the date when the next calibration should be performed.","This attribute is stored with the active calibration set. If a different calibration set is restored, this attribute reflects the due date stored with that set.","smua.cal.due must be set to the date the next calibration is required using the UTC time and date. The date is stored as the number of seconds since UTC 12:00 am Jan 1, 1970.","Due to the internal storage format, smua.cal.due is only accurate to within a few minutes of the value set.","Example","smua.cal.due = os.time() + 365 * 24 * 60 * 60","Sets the calibration due date equal to one year from the present time set on the instrument.","Also see","Adjustment","os.time()","smua.cal.adjustdate","smua.cal.date","smua.cal.lock()","smua.cal.restore()","smua.cal.state","smua.cal.unlock()","smua.cal.due","15095.htm");
+Page[279]=new Array("This function disables the commands that change calibration settings.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.cal.lock()","Details","Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored. Error code 5012, "Cal data not saved - save or restore before lock," results if this function is called when the calibration state is smua.CALSTATE_CALIBRATING. ","Example","smua.cal.lock()","Disables calibration functions.","Also see","Adjustment","smua.cal.restore()","smua.cal.save()","smua.cal.state","smua.cal.unlock()","smua.cal.lock()","15089.htm");
+Page[280]=new Array("This attribute stores the password required to enable calibration.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (W)","Yes","Not applicable","SMU nonvolatile memory",""KI0026XX"","Usage","smua.cal.password = "newPassword"","newPassword","A string that contains the new password","Details","A new password can only be assigned when calibration has been unlocked.","The calibration password is write-only and cannot be read.","Example","smua.cal.password = "LetMeIn"","Assigns a new calibration password.","Also see","Adjustment","smua.cal.unlock()","smua.cal.password","15096.htm");
+Page[281]=new Array("This attribute controls which calibration constants are used for all subsequent measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset SMU calibration lock Recall setup","Not saved","0 (smua.CAL_AUTO)","Usage","calPolarity = smua.cal.polarity","smua.cal.polarity = calPolarity","calPolarity","The polarity to use for measurements. Set to one of the following values:","0 or smua.CAL_AUTO: Automatic polarity detection","1 or smua.CAL_POSITIVE: Measure with positive polarity calibration constants","2 or smua.CAL_NEGATIVE: Measure with negative polarity calibration constants","Details","This attribute controls which polarity calibration constants are used to make all subsequent measurements.","This attribute does not affect the smua.measure.calibrateY() and smua.pulser.measure.calibrateY() commands. The polarity for the measure calibrate commands is dictated by their range parameters. The measure calibration commands require the measurements provided to have been made using the polarity being calibrated.","When making measurements for points far away from zero, the desired polarity constants are inherently used. However, when making measurements near zero, it is possible that the instrument could use the calibration constants from the wrong polarity. Setting smua.cal.polarity to positive or negative forces measurements to be made using the calibration constants for a given polarity, rather than basing the choice on the raw measurement data.","This attribute can only be set to positive or negative when calibration is unlocked. This attribute is automatically set to smua.CAL_AUTO when calibration is locked.","Example","smua.cal.polarity = smua.CAL_POSITIVE","Selects positive calibration constants for all subsequent measurements.","Also see","Adjustment","reset()","smua.cal.lock()","smua.cal.unlock()","smua.measure.calibrateY()","smua.pulser.measure.calibrateY()","smua.reset()","smua.cal.polarity","93060.htm");
+Page[282]=new Array("This function loads a stored set of calibration constants.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.cal.restore()","smua.cal.restore(calset)","calset","The calibration set to be loaded; set calset to one of the following values:","0 or smua.CALSET_NOMINAL: A set of calibration constants that are uncalibrated, but set to nominal values to allow rudimentary functioning of the instrument","1 or smua.CALSET_FACTORY: The calibration constants when the instrument left the factory","2 or smua.CALSET_DEFAULT: The normal calibration set","3 or smua.CALSET_PREVIOUS: The calibration set that was used before the last default set was overwritten","Details","This function overwrites the present set of calibration constants with constants read from nonvolatile memory.","This function is disabled until a successful call to smua.cal.unlock() is made.","If calset is not specified, smua.CALSET_DEFAULT is used.","Example","smua.cal.restore()","Restores factory calibration constants.","Also see","Adjustment","smua.cal.lock()","smua.cal.unlock()","smua.cal.restore()","15090.htm");
+Page[283]=new Array("This function stores the active calibration constants to nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.cal.save()","Details","This function stores the active set of calibration constants to nonvolatile memory. The previous calibration constants (from the default calibration set) are copied to the previous calibration set (smua.CALSET_PREVIOUS) before overwriting the default calibration set.","This function is disabled until a successful call to smua.cal.unlock() is made.","If any of the calibration constants have been changed, this function is disabled unless the calibration date, the calibration due date, and the calibration adjust date have been assigned new values.","Example","smua.cal.save()","Stores calibration constants in nonvolatile memory.","Also see","Adjustment","smua.cal.adjustdate","smua.cal.date","smua.cal.due","smua.cal.lock()","smua.cal.restore()","smua.cal.unlock()","smua.cal.save()","15091.htm");
+Page[284]=new Array("This attribute returns the present calibration state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not saved","Not applicable","Usage","calState = smua.cal.state","calState","The present calibration state; when reading this attribute, calState has one of the following values:","0 or smua.CALSTATE_LOCKED: Calibration is locked","1 or smua.CALSTATE_CALIBRATING: The calibration constants or dates have been changed but not yet saved to nonvolatile memory","2 or smua.CALSTATE_UNLOCKED: Calibration is unlocked but none of the calibration constants or dates have changed since the last save/restore","Details","This read-only attribute indicates the calibration state of the instrument: Locked, calibrating, or unlocked.","Example","calstate = smua.cal.state","print(calstate)","Reads calibration state.","Output:","0.000000e+00","The above output indicates that calibration is locked.","Also see","Adjustment","smua.cal.lock()","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.cal.state","15098.htm");
+Page[285]=new Array("This function enables the commands that change calibration settings.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.cal.unlock(password)","password","Calibration password","Details","This function enables the calibration functions to change the calibration settings.","The password when the instrument is shipped from the factory is "KI0026XX".","Example","smua.cal.unlock("KI0026XX")","Unlocks calibration.","Also see","Adjustment","smua.cal.lock()","smua.cal.password","smua.cal.state","smua.cal.unlock()","15092.htm");
+Page[286]=new Array("This function adjusts the high/sense high contact check measurement. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.contact.calibratehi(cp1Measured, cp1Reference, cp2Measured, cp2Reference)","cp1Measured","The value measured by this SMU for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Measured","The value measured by this SMU for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","Contact check measurement calibration does not require range information.","Typically, points one and two will be near 0 Ω and 50 Ω, respectively.","All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active. If not, corruption of the calibration constants may result.","The new calibration constants are activated immediately but are not written to nonvolatile memory. Use smua.cal.save() to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is disabled until a successful call to smua.cal.unlock() is made.","Example","-- Short SENSE LO and LO terminals.","-- Short SENSE HI and HI terminals.","-- Allow readings to settle, then get measurements.","r0_hi, r0_lo = smua.contact.r()","-- Connect 50 OHM resistor between SENSE LO and LO.","-- Connect 50 OHM resistor between SENSE HI and HI.","-- Allow readings to settle, then get measurements.","r50_hi, r50_lo = smua.contact.r()","smua.contact.calibratelo(r0_lo, Z_actual_lo, r50_lo, 50_ohm_actual_lo)","smua.contact.calibratehi(r0_hi, Z_actual_hi, r50_hi, 50_ohm_actual_hi)","The instrument performs a contact check.","Install and measure two resistors.","The user sends the contact check LO calibration command.","The user sends the contact check HI calibration command.","Also see","Adjustment","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.contact.calibratelo()","smua.contact.calibratehi()","15099.htm");
+Page[287]=new Array("This function adjusts the low/sense low contact check measurement. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.contact.calibratelo(cp1Measured, cp1Reference, cp2Measured, cp2Reference)","cp1Measured","The value measured by this SMU for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Measured","The value measured by this SMU for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","Contact check measurement adjustment does not require range information.","Typically, points one and two are near 0 Ω and 50 Ω, respectively.","All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the active calibration set. If not, corruption of the calibration constants may result.","The new calibration constants are activated immediately but are not written to nonvolatile memory. Use smua.cal.save() to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is disabled until a successful call to smua.cal.unlock() is made.","Example","-- Short SENSE LO and LO terminals.","-- Short SENSE HI and HI terminals.","-- Allow readings to settle, then get measurements.","r0_hi, r0_lo = smua.contact.r()","-- Connect 50 OHM resistor between SENSE LO and LO.","-- Connect 50 OHM resistor between SENSE HI and HI.","-- Allow readings to settle, then get measurements.","r50_hi, r50_lo = smua.contact.r()","smua.contact.calibratelo(r0_lo, Z_actual_lo, r50_lo, 50_ohm_actual_lo)","smua.contact.calibratehi(r0_hi, Z_actual_hi, r50_hi, 50_ohm_actual_hi)","The instrument performs a contact check.","Install and measure two resistors.","The user sends the contact check LO calibration command.","The user sends the contact check HI calibration command.","Also see","Adjustment","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.contact.calibratehi()","smua.contact.calibratelo()","15100.htm");
+Page[288]=new Array("This function determines if contact resistance is lower than the threshold.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.contact.check()","Details","@Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser. See Example 1: Ten-point pulse sweep for a code example.","This function returns true if the contact resistance is below the threshold; this function returns false if it is above the threshold. The threshold value is set by the smua.contact.threshold attribute.","When the output is on and any of the following:","SMU is a current source with current range set to less than 1 mA (error code 5065, "I range too low for contact check")","SMU is a voltage source with current limit set to less than 1 mA (error code 5050, "I limit too low for contact check")","When the output is off and any of the following:","The output off mode is High-Z (error code 5048, "Contact check not valid with HIGH-Z OUTPUT off")","The output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCVOLTS and the off current limit set to less than 1 mA (error code 5066, "source.offlimiti too low for contact check")","The output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCAMPS and the source range is less than 1 mA (error code 5065, "I range too low for contact check")","If you attempt to perform a contact check measurement when any of the above conditions exist, an error is generated.","Example","if not smua.contact.check() then"," -- take action","end","Takes action if contact check fails.","Also see","Contact check connections","Contact check measurements","smua.contact.speed","smua.contact.threshold","smua.source.offfunc","smua.contact.check()","92517.htm");
+Page[289]=new Array("This function measures aggregate contact resistance. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","rhi, rlo = smua.contact.r()","rhi","The measured aggregate contact resistance on the HI/sense HI side","rlo","The measured aggregate contact resistance on the LO/sense LO side","Details","If you attempt to perform a contact resistance measurement when any of the following conditions exist, an error is generated.","When the output is on and SMU is a current source with current range set to less than 1 mA","When the output is on and SMU is a voltage source with current limit set to less than 1 mA","When the output is off and the output off mode is High-Z","When the output is off and the output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCVOLTS and the off current limit set to less than 1 mA","When the output is off and the output off mode is Normal with the smua.source.offfunc attribute set to smua.OUTPUT_DCAMPS and the source range is less than 1 mA","When the pulser is enabled (smua.pulser.enable attribute is set to smua.ENABLE)","@Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.","Example","if not smua.contact.check() then"," smua.contact.speed = smua.CONTACT_SLOW"," rhi, rlo = smua.contact.r()"," print(rhi, rlo)"," exit()","end","Check contacts against threshold.","Set speed to slow.","Get resistance readings.","Output contact resistances.","Terminate execution.","Also see","Contact check connections","Contact check measurements","smua.contact.check()","smua.contact.speed","smua.contact.r()","92712.htm");
+Page[290]=new Array("This attribute stores the speed setting for contact check measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Not saved","0 (smua.CONTACT_FAST)","Usage","speedSetting = smua.contact.speed","smua.contact.speed = speedSetting","speedSetting","The speed setting. Set to one of the following:","0 or smua.CONTACT_FAST","1 or smua.CONTACT_MEDIUM","2 or smua.CONTACT_SLOW","Details","This setting controls the aperture of measurements made for contact check. It does not affect the smua.measure.nplc aperture setting.","The speed setting can have a dramatic effect on the accuracy of the measurement (see the specifications).","@Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.","Example","smua.contact.speed = smua.CONTACT_SLOW","Configure contact check for higher accuracy.","Also see","Contact check connections","Contact check measurements","reset()","smua.contact.check()","smua.contact.r()","smua.reset()","smua.contact.speed","92519.htm");
+Page[291]=new Array("This attribute stores the resistance threshold for the smua.contact.check() function.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Not saved","50 (50 Ω)","Usage","rValue = smua.contact.threshold","smua.contact.threshold = rValue","rValue","The resistance above which contact check should fail (measured in ohms)","Details","The threshold should be set to less than 1 kΩ.","@Contact check is not available when the pulser is enabled. If you need to use the contact check function in a pulser application, you can disable the pulser, run the contact check measurements, then enable the pulser.","Example","smua.contact.threshold = 5","Set the contact check threshold to 5 Ω.","Also see","Contact check connections","Contact check measurements","reset()","smua.contact.check()","smua.reset()","smua.contact.threshold","92520.htm");
+Page[292]=new Array("This attribute enables or disables use of the interlock signal.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","smua.DISABLE","Usage","interlockState = smua.interlock.enable","smua.interlock.enable = interlockState","interlockState","Enable or disable use of the interlock signal:","Turn the output off if the interlock signal is not asserted: smua.ENABLE","Ignore the interlock signal: smua.DISABLE","Details","The setting of this attribute must match the jumper setting on the 2601B-P-INT Interlock and Cable Connector Box.","Example","smua.interlock.enable = smua.ENABLE","Enable the interlock.","Also see","Using the interlock","smua.interlock.enable","92713.htm");
+Page[293]=new Array("This function creates a reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","bufferVar = smua.makebuffer(bufferSize)","bufferVar","The created reading buffer","bufferSize","Maximum number of readings that can be stored","Details","Reading buffers can be created and allocated dynamically using this function. Use bufferSize to designate the number of readings the buffer can store.","Dynamically allocated reading buffers can be used interchangeably with the smua.nvbufferY buffers.","A reading buffer can be deleted by setting all references to the reading buffer equal to nil, then running the garbage collector (see the collectgarbage() function in Standard libraries).","Example","mybuffer2 = smua.makebuffer(200)","Creates a 200 element reading buffer (mybuffer2).","Also see","collectgarbage() in Base library functions","Remote reading buffer programming","savebuffer()","smua.nvbufferY","smua.makebuffer()","15105.htm");
+Page[294]=new Array("This attribute stores the measurement autorange setting.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","1 (smua.AUTORANGE_ON)","Usage","autoRange = smua.measure.autorangeY","smua.measure.autorangeY = autoRange","autoRange","The state of the measurement autorange setting; set to one of the following values:","0 or smua.AUTORANGE_OFF: Disabled","1 or smua.AUTORANGE_ON: Enabled","2 or smua.AUTORANGE_FOLLOW_LIMIT: Measure range automatically set to the limit range","Y","SMU measure function (v = voltage, i = current)","Details","This attribute indicates the measurement autorange state. Its value is smua.AUTORANGE_OFF when the SMU measure circuit is on a fixed range and smua.AUTORANGE_ON when it is in autorange mode.","Setting this attribute to smua.AUTORANGE_OFF puts the SMU on a fixed range. The fixed range is the present SMU measure range.","Setting this attribute to smua.AUTORANGE_ON puts the SMU measure circuit in autorange mode. It remains on its present measure range until the next measurement is requested.","If source high capacitance mode is enabled, current autorange is set to smua.AUTORANGE_FOLLOW_LIMIT and cannot be changed.","Example","smua.measure.autorangev = smua.AUTORANGE_ON","Enables voltage measurement autoranging.","Also see","Autoranging","Range","reset()","setup.recall()","smua.measure.rangeY","smua.reset()","smua.measure.autorangeY","15107.htm");
+Page[295]=new Array("This attribute enables or disables automatic updates to the internal reference measurements (autozero) of the instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","2 (smua.AUTOZERO_AUTO)","Usage","azMode = smua.measure.autozero","smua.measure.autozero = azMode","azMode","Indicates status of autozero; set to one of the following values:","0 or smua.AUTOZERO_OFF: Autozero disabled","1 or smua.AUTOZERO_ONCE: Performs autozero once, then disables autozero","2 or smua.AUTOZERO_AUTO: Automatic checking of reference and zero measurements; an autozero is performed when needed","Details","The analog-to-digital converter (ADC) uses a ratiometric A/D conversion technique. To ensure the accuracy of readings, the instrument must periodically obtain new measurements of its internal ground and voltage reference. The time interval between updates to these reference measurements is determined by the integration aperture being used for measurements. The 2601B-PULSE uses separate reference and zero measurements for each aperture.","By default, the instrument automatically checks these reference measurements whenever a signal measurement is made. If the reference measurements have expired when a signal measurement is made, the instrument will automatically take two more A/D conversions, one for the reference and one for the zero, before returning the result. Thus, occasionally, a measurement takes longer than normal.","This additional time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the time that is needed for the reference measurements in these situations, you can use the smua.measure.autozero attribute to disable the automatic reference measurements.","Disabling automatic reference measurements may allow the instrument to gradually drift out of specification. To minimize the drift, a reference and zero measurement should be made immediately before any critical test sequences. You can use the smua.AUTOZERO_ONCE setting to force a refresh of the reference and zero measurements that are used for the present aperture setting.","The 2601B-PULSE stores the reference measurements for the last ten NPLC settings that were used in a reference cache. If an NPLC setting is selected and an entry for it is not in the cache, the oldest (least recently used) entry is discarded to make room for the new entry.","When the pulser is enabled, two high-speed digitizing sampling ADCs are used to measure voltage and current. These ADCs do not use a ratiometric conversion technique, so the autozero settings are ignored when the pulser is enabled.","Example","smua.measure.autozero = smua.AUTOZERO_ONCE","Performs autozero once.","Also see","Autozero","reset()","smua.measure.nplc","setup.recall()","smua.reset()","smua.measure.autozero","93207.htm");
+Page[296]=new Array("This function generates and activates new measurement calibration constants.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.measure.calibrateY(range, cp1Measured, cp1Reference, cp2Measured, cp2Reference)","Y","SMU measurement function (v = voltage, i = current)","range","The measurement range to adjust","cp1Measured","The value measured by this SMU for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Measured ","The value measured by this SMU for point 2","cp2Reference ","The reference measurement for point 2 as measured externally","Details","This function generates and activates new calibration constants for the given range.","The positive and negative polarities of the instrument must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity.","Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.","All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active. Corruption of the calibration constants may result if this is ignored.","The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is only available when calibration is unlocked using smua.cal.unlock().","Example","smua.measure.calibratev(1, 1e-4, 1e-5, 0.92, 0.903)","Adjust SMU channel A voltage measurement using the following values:","1 V calibration range","1e-4 for +zero measurement reading","1e-5 for +zero DMM measurement reading","0.92 for +FS measurement reading","0.903 for the +FS DMM measurement reading","Also see","Adjustment","smua.cal.lock()","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.source.calibrateY()","smua.measure.calibrateY()","15109.htm");
+Page[297]=new Array("This attribute sets the number of measurements made when a measurement is requested.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","1","Usage","count = smua.measure.count","smua.measure.count = count","count","Number of measurements","Details","This attribute controls the number of measurements made any time a measurement is requested. When using a reading buffer with a measure command, this attribute also controls the number of readings to be stored.","If the count is set to a value greater than 1, any measurement delay set by smua.measure.delay only occurs before the first measurement, while the smua.measure.interval controls the interval between successive measurements.","When the pulser is enabled and measurements are not overlapped, this attribute must be less than 3500.","Example","smua.measure.count = 10","Sets the measure count to 10.","Also see","reset()","setup.recall()","smua.measure.delay","smua.measure.interval","smua.measure.overlappedY()","smua.measure.Y()","smua.reset()","smua.measure.count","92991.htm");
+Page[298]=new Array("This attribute controls the measurement delay.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0 (smua.DELAY_OFF)","Usage","mDelay = smua.measure.delay","smua.measure.delay = mDelay","mDelay","Set to the measurement delay value in seconds (for example, to specify an additional 10 ms measurement delay, set the value to 0.010)","You can also set it to one of the following values:","0 or smua.DELAY_OFF: No delay","-1 or smua.DELAY_AUTO: Automatic delay value","Details","This attribute allows for additional delay (settling time) before making a measurement. If you define the value instead of using the automatic delay value, the delay you set is used regardless of the range.","The smua.DELAY_AUTO setting causes a current range-dependent delay to be inserted when a current measurement is requested. This happens when a current measurement command is executed, when the measure action is being performed in a sweep, or after changing ranges during an autoranged measurement.","If smua.measure.count is greater than 1, the measurement delay is only inserted before the first measurement.","Example","smua.measure.delay = 0.010","Sets a 10 ms measurement delay.","Also see","Measure auto delay","reset()","smua.measure.count","smua.measure.delayfactor","smua.source.delay","smua.reset()","smua.measure.delay","92241.htm");
+Page[299]=new Array("This attribute stores a multiplier to the delays that are used when smua.measure.delay is set to smua.DELAY_AUTO.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Not saved","1","Usage","delayFactor = smua.measure.delayfactor","smua.measure.delayfactor = delayFactor","delayFactor","The delay factor multiplier","Details","The delay factor is only applied when smua.measure.delay = smua.DELAY_AUTO.","This attribute can be set to a value less than 1 (for example, 0.5) to decrease the automatic delay.","This attribute can be set to a value greater than 1 (for example, 1.5 or 2.0) to increase the automatic delay.","Setting this attribute to zero disables delays when smua.measure.delay = smua.DELAY_AUTO.","Example","smua.measure.delayfactor = 2.0","Doubles the measure delay.","Also see","Measure auto delay","reset()","smua.measure.delay","smua.reset()","smua.measure.delayfactor","15112.htm");
+Page[300]=new Array("This command sets the number of measured readings that are required to yield one filtered measurement.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","1","Usage","filterCount = smua.measure.filter.count","smua.measure.filter.count = filterCount","filterCount","The number of readings required for each filtered measurement (1 to 100)","Details","This attribute sets the size of the stack used for filtered measurements.","Example","smua.measure.filter.count = 10","smua.measure.filter.type = smua.FILTER_MOVING_AVG","smua.measure.filter.enable = smua.FILTER_ON","Sets the filter count to 10.","Sets the filter type to moving average.","Enables the filter.","Also see","Filters","reset()","setup.recall()","smua.measure.filter.enable","smua.measure.filter.type","smua.reset()","smua.measure.filter.count","15113.htm");
+Page[301]=new Array("This command enables or disables filtered measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0 (smua.FILTER_OFF)","Usage","filterState = smua.measure.filter.enable","smua.measure.filter.enable = filterState","filterState","The filter status; set to one of the following values:","0 or smua.FILTER_OFF: Disables the filter","1 or smua.FILTER_ON: Enables the filter","Details","This command enables or disables the filter.","Example","smua.measure.filter.count = 10","smua.measure.filter.type = smua.FILTER_MOVING_AVG","smua.measure.filter.enable = smua.FILTER_ON","Sets the filter count to 10.","Sets the filter type to moving average.","Enables the filter.","Also see","Filters","reset()","setup.recall()","smua.measure.filter.count","smua.measure.filter.type","smua.reset()","smua.measure.filter.enable","15114.htm");
+Page[302]=new Array("This command sets the type of filter used for measurements when the measurement filter is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","1 (smua.FILTER_REPEAT_AVG)","Usage","filterType = smua.measure.filter.type","smua.measure.filter.type = filterType","filterType","The filter type to use when filtering is enabled. Set to one of the following values:","0 or smua.FILTER_MOVING_AVG: Selects the moving filter","1 or smua.FILTER_REPEAT_AVG: Selects the repeat filter","2 or smua.FILTER_MEDIAN: Selects the median filter","Details","The 2601B-PULSE provides a moving average, repeating average, and median filter type.","For the repeating filter, the stack (filter count) is filled, and the conversions are averaged to yield a reading. The stack is then cleared, and the process starts over. ","The moving average filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the measurement conversions are averaged, yielding a reading. For each subsequent conversion placed into the stack, the oldest conversion is discarded. The stack is re-averaged, yielding a new reading.","The median filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the reading nearest to the middle is returned. For each subsequent conversion placed into the stack, the oldest reading is discarded. The stack is then re-sorted, yielding a new reading. If the filter count is an even number, the reading returned is the average of the two middle readings.","@If the pulser is enabled, the repeating filter is the only available filter.","Example","smua.measure.filter.count = 10","smua.measure.filter.type = smua.FILTER_MOVING_AVG","smua.measure.filter.enable = smua.FILTER_ON","Sets the filter count to 10.","Sets the filter type to moving average.","Enables the filter.","Also see","Filters","reset()","setup.recall()","smua.measure.filter.count","smua.measure.filter.enable","smua.reset()","smua.measure.filter.type","92979.htm");
+Page[303]=new Array("This attribute contains a delay multiplier that is only used during range changes when the high-capacitance mode is active.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","10","Usage","delayFactor = smua.measure.highcrangedelayfactor","smua.measure.highcrangedelayfactor = delayFactor","delayFactor","The delay factor; set to a value between 1 and 99","Details","This delay multiplier is only active when the high-capacitance mode is active.","Example","smua.measure.highcrangedelayfactor = 5","Increases the delay used during range changes by a factor of 5.","Also see","High-capacitance mode","reset()","setup.recall()","smua.reset()","smua.source.highc","smua.measure.highcrangedelayfactor","15116.htm");
+Page[304]=new Array("This attribute sets the interval between multiple measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0 (0 s)","Usage","interval = smua.measure.interval","smua.measure.interval = interval","interval","The interval value (in seconds); set to a value between 0 and 1","Details","This attribute sets the time interval between measurements when smua.measure.count is set to a value greater than 1.","The SMU attempts to start each measurement when scheduled. When the pulser is disabled, if the SMU cannot keep up with the interval setting, measurements are made as quickly as possible. When the pulser is enabled and the trigger model is not configured for asynchronous measurements, if the SMU cannot keep up with the interval setting, it aborts the sweep and turns the output off.","If filtered measurements are being made, the time interval is from the start of the first measurement for the filtered reading to the first measurement for a subsequent filtered reading. Extra measurements made to satisfy a filtered reading are not paced by this interval.","When the measure count is greater than 1 and the pulser is enabled, this must be less than 65 ms.","Example","smua.measure.interval = 0.5","Sets the measure interval to 0.5 s.","Also see","reset()","setup.recall()","smua.measure.count","smua.reset()","smua.measure.interval","92990.htm");
+Page[305]=new Array("This attribute sets the lowest measurement range that is used when the instrument is autoranging.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","Current: 100e-9 (100 nA) Voltage: 100e-3 (100 mV)","Usage","lowRange = smua.measure.lowrangeY","smua.measure.lowrangeY = lowRange","lowRange","The lowest voltage or current measurement range used during autoranging","Y","SMU measure function (v = voltage, i = current)","Details","This attribute is used with autoranging to put a lower bound on the range used. Since lower ranges generally require greater settling times, setting a lowest range limit might make measurements require less settling time.","If the instrument is set to autorange and it is on a range lower than the one specified, the range is changed to the lowRange range value.","Example","smua.measure.lowrangev = 1","Sets voltage low range to 1 V.","Also see","Range","reset()","setup.recall()","smua.measure.autorangeY","smua.reset()","smua.measure.lowrangeY","92333.htm");
+Page[306]=new Array("This command sets the integration aperture for measurements when the pulser is disabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","1.0","Usage","nplc = smua.measure.nplc","smua.measure.nplc = nplc","nplc","The integration aperture; set from 0.001 to 25","Details","This attribute controls the integration aperture for the analog‑to‑digital converter (ADC) that is used when the pulser is disabled.","The integration aperture is based on the number of power line cycles (NPLC), where 1 PLC for 60 Hz is 16.67 ms (1/60) and 1 PLC for 50 Hz is 20 ms (1/50).","Example","smua.measure.nplc = 0.5","Sets the integration time to 0.5.","Also see","Speed","reset()","setup.recall()","smua.pulser.measure.aperture","smua.reset()","smua.measure.nplc","93175.htm");
+Page[307]=new Array("This function starts an asynchronous (background) measurement.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","smua.measure.overlappedY(rbuffer)","smua.measure.overlappediv(ibuffer, vbuffer)","Y","SMU measurement type (v = voltage, i = current, r = resistance, p = power)","rbuffer","A reading buffer object where the readings are stored","ibuffer","A reading buffer object where current readings are stored","vbuffer","A reading buffer object where voltage readings are stored","Details","This function starts a measurement and returns immediately. The measurements, as they are performed, are stored in a reading buffer (along with any other information that is being acquired). If the instrument is configured to return multiple readings where one is requested, the readings are available as they are made. Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.","The second form of this function, smua.measure.overlappediv(), stores current readings in ibuffer and voltage readings in vbuffer.","This function is an overlapped command. Script execution continues while the measurements are made in the background. Attempts to access result values that have not yet been generated cause the script to block and wait for the data to become available. The waitcomplete() function can also be used to wait for the measurements to complete before continuing.","If a given reading buffer contains any data, it is cleared before making any measurements, unless the reading buffer has been configured to append data.","Example","smua.measure.overlappedv(smua.nvbuffer1)","Starts background voltage measurements.","Also see","Reading buffers","smua.measure.Y()","smua.nvbufferY","waitcomplete()","smua.measure.overlappedY()","15120.htm");
+Page[308]=new Array("This attribute contains the positive full‑scale value of the measurement range for voltage or current.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","Voltage: 100e-3 (100 mV) Current: 100e-3 (100 mA)","Usage","rangeValue = smua.measure.rangeY","smua.measure.rangeY = rangeValue","rangeValue","Set to the maximum expected voltage or current to be measured","Y","SMU measurement function (v = voltage, i = current)","Details","Reading this attribute returns the positive full-scale value of the measurement range that the SMU is currently using. Assigning a value to this attribute sets the SMU on a fixed range large enough to measure the assigned value. The instrument will select the best range for measuring a value of rangeValue.","This attribute is primarily intended to eliminate the time that is required by the automatic range selection performed by a measuring instrument. Because selecting a fixed range prevents autoranging, an overrange condition can occur. For example, measuring 10.0 V on the 6 V range causes an overrange. The value 9.91000E+37 is returned when this occurs.","If the source function is the same as the measurement function (for example, sourcing voltage and measuring voltage), the measurement range is locked to be the same as the source range. However, the setting for the measure range is retained. If the source function is changed (for example, from sourcing voltage to sourcing current), the retained measurement range is used.","For example, assume the source function is voltage. The source range is 1 V and you set the measure range for 6 V. Since the source range is 1 V, the SMU performs voltage measurements on the 1 V range. If you now change the source function to current, voltage measurements are made on the 6 V range.","Explicitly setting a measure range will disable measure autoranging for that function. Autoranging is controlled separately for each source and measurement function: source voltage, source current, measure voltage and measure current. Autoranging is enabled for all four by default.","Changing the range while the output is off does not update the hardware settings, but querying returns the range setting that will be used once the output is turned on. Setting a range while the output is on takes effect immediately.","With measure autoranging enabled, the range is changed only when a measurement is taken. Querying the range after a measurement returns the range selected for that measurement.","Example","smua.measure.rangev = 0.5","Selects the 1 V measurement range.","Also see","Range","reset()","setup.recall()","smua.measure.autorangeY","smua.pulser.rangeY","smua.reset()","smua.source.rangeY","smua.measure.rangeY","92317.htm");
+Page[309]=new Array("This attribute turns relative measurements on or off. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Not saved","0 (smua.REL_OFF)","Usage","relEnable = smua.measure.rel.enableY","smua.measure.rel.enableY = relEnable","relEnable","Relative measurement control. Set relEnable to one of the following values:","0 or smua.REL_OFF: Disables relative measurements","1 or smua.REL_ON: Enables relative measurements","Y","SMU measurement function (v = voltage, i = current, r = resistance, p = power)","Details","This attribute enables or disables relative measurements. When relative measurements are enabled, all subsequent measured readings are offset by the relative offset value specified by smua.measure.rel.levelY. Each returned measured relative reading is the result of the following calculation:","Relative reading = Actual measured reading - Relative offset value","Example","smua.measure.rel.enablev = smua.REL_ON","Enables relative voltage measurements.","Also see","Relative offset","reset()","setup.recall()","smua.measure.rel.levelY","smua.reset()","smua.measure.rel.enableY","15123.htm");
+Page[310]=new Array("This attribute sets the offset value for relative measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Not saved","0","Usage","relValue = smua.measure.rel.levelY","smua.measure.rel.levelY = relValue","relValue","Relative measurement offset value","Y","SMU measurement function (v = voltage, i = current, r = resistance, p = power)","Details","This attribute specifies the offset value used for relative measurements. When relative measurements are enabled (see smua.measure.rel.enableY), all subsequent measured readings will be offset by the value of this attribute. Each returned measured relative reading is the result of the following calculation: ","Relative reading = Actual measured reading - Relative offset value","Example","smua.measure.rel.levelv = smua.measure.v()","Performs a voltage measurement and then uses it as the relative offset value.","Also see","Relative offset","reset()","smua.measure.rel.enableY","smua.reset()","smua.measure.rel.levelY","15124.htm");
+Page[311]=new Array("This function makes one or more measurements.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","reading = smua.measure.Y()","reading = smua.measure.Y(readingBuffer)","iReading, vReading = smua.measure.iv()","iReading, vReading = smua.measure.iv(iReadingBuffer)","iReading, vReading = smua.measure.iv(iReadingBuffer, vReadingBuffer)","reading","Returned value of the last (or only) reading of the measurement process","Y","SMU measurement function (v = voltage, i = current, r = resistance, p = power)","readingBuffer","A reading buffer object where all readings are stored","iReading","The last reading of the current measurement process","vReading","The last reading of the voltage measurement process","iReadingBuffer","A reading buffer object where current readings are stored","vReadingBuffer","A reading buffer object where voltage readings are stored","Details","If you use this function without specifying a reading buffer, it makes one measurement and returns that measurement as reading. To use the additional information that is acquired while making a measurement or to return multiple readings, specify a reading buffer. If the instrument is configured to return multiple readings for a measurement and readingBuffer is specified, all readings are available in readingBuffer, but only the last measurement is returned as reading.","Measurements are in the following units of measure:","v = volts","i = amperes","r = ohms","p = watts","The smua.measure.iv() function returns the last actual current measurement and voltage measurement as iReading and vReading, respectively. Additionally, it can store current and voltage readings if buffers are provided (iReadingBuffer and vReadingBuffer ).","The smua.measure.count attribute determines how many measurements are performed. When using a reading buffer, it also determines the number of readings to store in the buffer. If a reading buffer is not specified, the SMU ignores the smua.measure.count attribute and only makes one measurement.","The readingBuffer is cleared before making any measurements unless the buffer is configured to append data.","Example","smua.measure.count = 10","smua.measure.v(smua.nvbuffer1)","Makes 10 voltage measurements using SMU channel A and stores them in a buffer.","Also see","Reading buffers","smua.measure.count","smua.measure.overlappedY()","smua.nvbufferY","smua.measure.Y()","15122.htm");
+Page[312]=new Array("This function makes one or two measurements and then steps the source.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","reading = smua.measureYandstep(sourceValue)","iReading, vReading = smua.measureivandstep(sourceValue)","reading","The measured reading before stepping the source","Y","SMU measurement function (v = voltage, i = current, r = resistance, p = power)","sourceValue","Source value to be set after the measurement is made","iReading","The current reading before stepping the source","vReading","The voltage reading before stepping the source","Details","The smua.measureYandstep() function makes a measurement and then sets the source to sourceValue. The smua.measureivandstep() function makes two measurements simultaneously, one for current (i) and one for voltage (v), and then sets the source to sourceValue.","Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.","The specified source value should be appropriate for the selected source function. For example, if the source voltage function is selected, then sourceValue is expected to be a new voltage level.","Both source and measure autorange must be disabled before using this function. This function cannot be used if source high capacitance mode is enabled (high capacitance mode requires autoranging to be enabled).","This function is provided for very fast execution of source-measure loops. The measurement is made before the source is stepped. Before using this function, and before any loop this function may be used in, set the source value to its initial level.","@This function is not available when the pulser is enabled.","Example","local ivalues = {}","smua.source.rangev = 1","smua.source.levelv = 0","smua.measure.rangei = 0.01","smua.source.output = smua.OUTPUT_ON","for index = 1, 10 do"," ivalues[index] = smua.measureiandstep(index / 10)","end","ivalues[11] = smua.measure.i()","This use of the measure and step function measures current, starting at a source value of 0 V. After each current measurement, the source is stepped 100 mV for the next current measurement. The final source level is 1 V, where current is measured again.","Also see","smua.measure.autorangeY","smua.measure.Y()","smua.source.autorangeY","smua.trigger.source.limitY","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","Sweep Operation","smua.measureYandstep()","93173.htm");
+Page[313]=new Array("This attribute contains a dedicated reading buffer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","See Details","Not applicable","Usage","bufferVar = smua.nvbufferY","bufferVar","The dedicated reading buffer","Y","Nonvolatile buffer (1 or 2)","Details","The SMU contains two dedicated reading buffers: smua.nvbuffer1 and smua.nvbuffer2.","All routines that return measurements can also store them in either reading buffer. Overlapped measurements are always stored in a reading buffer. Synchronous measurements return either a single-point measurement or can be stored in a reading buffer if passed to the measurement command.","The dedicated reading buffers can be saved to internal nonvolatile memory (to retain data between power cycles) using the smua.savebuffer() function.","Example","smua.measure.overlappedv(smua.nvbuffer1)","Store voltage readings into dedicated reading buffer 1.","Also see","Configuring and running sweeps","Reading buffers","savebuffer()","smua.makebuffer()","smua.measure.overlappedY()","smua.savebuffer()","smua.trigger.measure.action","smua.trigger.measure.set()","smua.trigger.measure.stimulus","smua.trigger.measure.Y()","smua.nvbufferY","92706.htm");
+Page[314]=new Array("This attribute enables or disables the 2601B-PULSE pulser.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","smua.DISABLE","Usage","enable = smua.pulser.enable","smua.pulser.enable = enable","enable","Enable or disable the pulser; set to:","smua.DISABLE: Conventional pulsing and full source‑measure unit (SMU) functionality","smua.ENABLE: Allow fast-edge pulsing using the trigger model","Details","When the pulser is enabled, there are the following differences in source-measure unit (SMU) functionality:","You can only source current (not voltage).","If the output exceeds a maximum pulse width, maximum duty cycle, or the specified protection level during a sweep, the 2601B-PULSE output is shorted, but the sweep continues with no source output until it is finished.","Some SMU settings are ignored; see Settings ignored when the pulser is enabled for details.","The smua.trigger.source.pulsewidth and smua.pulser.measure.delay attributes provide more precise timing than you can achieve using the smua.trigger.endpulse.stimulus and smua.trigger.measure.stimulus attributes.","Some of the output‑off modes behave differently:","OUTPUT_NORMAL: The output circuit is shorted when this output-off mode is selected.","OUTPUT_ZERO: The output circuit is shorted and current cannot be measured when this output-off mode is selected.","You cannot use contact check.","You cannot make measurements when the output is off.","Example","smua.pulser.enable = smua.ENABLE","Enable the pulser.","Also see","Pulser operation","smua.pulser.measure.delay","smua.trigger.source.pulsewidth","smua.pulser.enable","91674.htm");
+Page[315]=new Array("This attribute specifies the pulse measurement aperture when the pulser is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0.000001","Usage","aperture = smua.pulser.measure.aperture","smua.pulser.measure.aperture = aperture","aperture","The measurement aperture; set from 0.000001 s to 0.1 s","Details","When using this attribute with the trigger model or in a pulse-width limited region, the sum of the measure delay and the total measure time must be less than the pulse width. The total measure time depends on the measure count, the filter count, and the measure interval."," The settings for this attribute are ignored if the pulser is disabled.","Example","smua.pulser.measure.aperture = 10e-6","Set the measurement aperture to 10 µs.","Also see","smua.trigger.source.pulsewidth","smua.pulser.measure.aperture","91672.htm");
+Page[316]=new Array("This function generates and activates new measurement calibration constants for the pulser.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.pulser.measure.calibrateY(range, cp1Measured, cp1Reference, cp2Measured, cp2Reference)","range","The pulse measurement range to adjust","Y","The measurement function (v = voltage, i = current)","cp1Measured","The value measured by this SMU for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Measured","The value measured by this SMU for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","This function generates and activates new calibration constants for the given range. ","The positive and negative polarities of the instrument must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity.","Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.","The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is only available when calibration is unlocked using smua.cal.unlock().","Example","smua.pulser.measure.calibratei(1, 0.01, 0.011, 0.75, 0.76)","Adjusts the current measurement using the following values:","1 A measurement range","0.01 for the +zero measurement reading","0.011 for the +zero DMM measurement reading","0.75 for the + full‑scale measurement reading","0.76 for the + full‑scale DMM measurement reading","Also see","Calibration","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.pulser.source.calibratebiasi()","smua.pulser.source.calibratei()","smua.pulser.measure.calibrateY()","91895.htm");
+Page[317]=new Array("This attribute sets the measurement delay when the pulser is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0","Usage","delay = smua.pulser.measure.delay","smua.pulser.measure.delay = delay","delay","The measurement delay value in seconds; set from 0 to 0.065","Details","Use this attribute with the trigger model when performing a pulse sweep.","Set the delay parameter to a nonzero value to specify when a measurement starts during a pulse. The measurement starts after the delay interval expires. This allows the 2601B-PULSE to locate measurements within a pulse with less jitter than those generated using the measure trigger stimulus in the trigger model.","The sum of the measure delay and the total measure time must be less than the pulse width configured with the smua.trigger.source.pulsewidth setting. The total measure time depends on the measure count, the filter count, and the measure interval.","You cannot use this attribute and a measurement stimulus in the trigger model at the same time.","@Using both the end-pulse stimulus and this attribute in a script may cause the pulse output to end before the specified duration of the pulse is completed, causing invalid measurements.","When this attribute is set to zero, measurements are only triggered by a measurement stimulus.","The settings for this attribute are ignored if the pulser is disabled.","Example","smua.pulser.measure.delay = 35e-6","smua.pulser.measure.aperture = 10e-6","Specify a 35 µs pulse measure delay and a 10 µs measurement aperture.","Also see","Triggering","smua.pulser.measure.aperture","smua.pulser.enable","smua.trigger.source.pulsewidth","smua.pulser.measure.delay","91673.htm");
+Page[318]=new Array("This attribute sets a voltage protection level used to monitor the sense terminals when the pulser is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","20 V","Usage","level = smua.pulser.protect.sensev","smua.pulser.protect.sensev = level","level","The voltage protection level when the pulser is enabled; the value must be between 5% and 200% of the voltage range set by the smua.pulser.rangeY attribute","Details","If the voltage on the sense terminals goes above the protection level, the 2601B-PULSE output is shorted for the remainder of the sweep and the output turns off at the end of the sweep.","The current pulse terminates within 3 µs after the remotely sensed voltage from the device under test (DUT) exceeds the specified level.","@Setting the protection level does not guarantee that the output will not go above the protection level. The 2601B-PULSE turns off the output as quickly as possible, but the voltage level can briefly exceed this level, potentially causing damage to the device under test (DUT).","The settings for this attribute are ignored if the pulser is disabled.","Example","smua.pulser.protect.sensev = 8","Set the voltage protection limit to 8 V.","Also see","smua.pulser.protect.sourcev","smua.pulser.protect.tripped","smua.pulser.rangeY","smua.pulser.protect.sensev","91675.htm");
+Page[319]=new Array("This attribute sets an absolute voltage protection level used to monitor the force terminals when the pulser is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","40 V","Usage","level = smua.pulser.protect.sourcev","smua.pulser.protect.sourcev = level","level","The absolute voltage protection level when the pulser is enabled; 2 V to 40 V","Details","If the voltage on the force terminals goes above the protection level, the 2601B-PULSE automatically turns off the output.","The absolute voltage protection level ignores normal transients during the pulse rise and fall time.","The current pulse terminates within 3 µs after the remotely sensed voltage from the device under test (DUT) exceeds the specified level.","@Setting the protection level does not guarantee that the output will not go above the protection level. The 2601B-PULSE turns off the output as quickly as possible, but the voltage level can briefly exceed this level, potentially causing damage to the device under test (DUT).","The settings for this attribute are ignored if the pulser is disabled.","Example","smua.pulser.protect.sourcev = 8","Set the voltage protection limit to 8 V.","Also see","smua.pulser.protect.sensev","smua.pulser.protect.tripped","smua.pulser.protect.sourcev","92539.htm");
+Page[320]=new Array("This attribute indicates if the protection circuit was tripped.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset SMU reset","None","Not applicable","Usage","tripped = smua.pulser.protect.tripped","tripped","The voltage protection status:","true: The protection circuit was tripped","false: The protection circuit was not tripped","Details","When the pulser is enabled, this attribute indicates if the protection circuit was tripped. When the protection circuit is tripped, the output is shorted and turned off.","The following events can trip the protection circuit:","A voltage greater than smua.pulser.protect.sensev was detected on the sense terminals.","A voltage greater than smua.pulser.protect.sourcev was detected on the force terminals.","The maximum pulse width was exceeded during trigger model operation.","The maximum duty cycle was exceeded during trigger model operation.","If the SMU cannot keep up with the pulse rate.","If the SMU cannot keep up with the measurement rate.","The status is reset to false when the pulser is disabled or when the output is turned on.","Example","print(smua.pulser.protect.tripped)","Determine if the protection circuit was tripped.","Also see","smua.pulser.protect.sensev","smua.pulser.protect.sourcev","smua.pulser.protect.tripped","91676.htm");
+Page[321]=new Array("This attribute sets the source and measure ranges when the pulser is enabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","Current: 10 A Voltage: 10 V","Usage","range = smua.pulser.rangei","range = smua.pulser.rangev","smua.pulser.rangei = range","smua.pulser.rangev = range","range","The source and measure range","Details","When you set a value for the range, the 2601B-PULSE automatically sets the range as appropriate for the specified value.","This attribute setting affects the settings that are allowed for the smua.pulser.protect.sensev attribute, which must be between 5 percent and 200 percent of the voltage range.","The following table lists the pulser limits for the voltage and current functions.","Voltage range","Source","Measure","5 V","Not applicable","5.1 V","10 V","Not applicable","10.2 V","Current ranges","1 A","±1.01 A","±1.02 A","5 A","±5.05 A","±5.1 A","10 A","±10.1 A","±10.2 A","250 mA (DC bias)","±250 mA","Selected pulse measure range","The settings for this attribute are ignored if the pulser is disabled.","Example","smua.pulser.rangei = 1","Set the pulser current range to 1 A.","Also see","smua.pulser.protect.sensev","smua.pulser.rangeY","91677.htm");
+Page[322]=new Array("This function generates and activates new bias source calibration constants for the pulser.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.pulser.source.calibratebiasi(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference)","range","The pulser bias current range to adjust","cp1Expected","The source value set for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Expected","The source value set for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","The positive and negative polarities must be adjusted separately. To adjust the positive polarity, use the +250e-3 range; to adjust the negative polarity, use the -250e-3 range.","Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.","The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is only available when calibration is unlocked using smua.cal.unlock().","Example","smua.pulser.source.calibratebiasi(250e-3, 1e-10, 1e-5, 0.224, 0.225)","Adjusts the bias source calibration constant for the 250e-3 pulser range using 1e-10 as the source value and 1e-5 for the reference measurement for point 1 and 0.224 as the source value and 0.225 as the reference measurement for point 2.","Also see","Calibration","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.pulser.measure.calibrateY()","smua.pulser.source.calibratei()","smua.pulser.source.calibratebiasi()","91897.htm");
+Page[323]=new Array("This function generates and activates new source calibration constants for the pulser.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.pulser.source.calibratei(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference)","range","The pulser current range to adjust","cp1Expected","The source value set for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Expected","The source value set for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","This function generates and activates new calibration constants for the given range. ","Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.","The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is only available when calibration is unlocked using smua.cal.unlock().","Example","smua.pulser.source.calibratei(1, 1e-10, 1e-5, 0.9, 0.903)","Generates and activates new source calibration constants for the pulser 1 A range. For point 1, it uses 1e-10 as the source value and 1e-5 as the reference measurement. For point 2, it uses 0.9 for the source value and 0.903 for the reference measurement.","Also see","Calibration","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.pulser.measure.calibrateY()","smua.pulser.source.calibratebiasi()","smua.pulser.source.calibratei()","91898.htm");
+Page[324]=new Array("This function turns off the output and resets the commands that begin with smua. to their default settings.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.reset()","Details","This function turns off the output and returns the specified SMU to its default settings.","Example","smua.reset()","Turns off the output and resets SMU to its default settings.","Also see","reset()","smua.reset()","15136.htm");
+Page[325]=new Array("This function saves one source‑measure unit (SMU) dedicated reading buffer to nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.savebuffer(smua.nvbufferY)","Y","SMU dedicated reading buffer (1 or 2)","Details","When the instrument is turned off and back on, the dedicated reading buffers are restored from nonvolatile memory to their last saved values.","Example","smua.savebuffer(smua.nvbuffer1)","Saves buffer 1 to internal memory.","Also see","Reading buffers","savebuffer()","smua.nvbufferY","smua.savebuffer()","15137.htm");
+Page[326]=new Array("This attribute contains the state of the sense mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","0 (smua.SENSE_LOCAL)","Usage","senseMode = smua.sense","smua.sense = senseMode","senseMode","The sense mode; set to one of the following:","0 or smua.SENSE_LOCAL: Selects local sense (2-wire)","1 or smua.SENSE_REMOTE: Selects remote sense (4-wire)","3 or smua.SENSE_CALA: Selects calibration sense mode","Details","You can do source-measure operations using either 2-wire local sense connections or 4-wire remote sense connections.","@When the pulser is enabled, the instrument always uses 4‑wire remote sensing. The setting of smua.sense is ignored.","You can change the sense mode between local and remote while the output is on.","The smua.SENSE_CALA mode is only used for calibration and may only be selected when calibration is enabled. The calibration sense mode cannot be selected while the output is on.","Example","smua.sense = smua.SENSE_REMOTE","Select 4-wire remote sensing.","Also see","2-wire local sensing connections","4-wire remote sensing connections","Sense mode selection","smua.sense","93042.htm");
+Page[327]=new Array("This attribute contains the state of the source autorange control (on/off). ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","1 (smua.AUTORANGE_ON)","Usage","sourceAutorange = smua.source.autorangeY","smua.source.autorangeY = sourceAutorange","sourceAutorange","The state of the source autorange control. Set to one of the following:","0 or smua.AUTORANGE_OFF: Disables source autorange","1 or smua.AUTORANGE_ON: Enables source autorange","Y","SMU source function (v = voltage, i = current)","Details","This attribute indicates the source autorange state. Its value is smua.AUTORANGE_OFF when the SMU source circuit is on a fixed range and smua.AUTORANGE_ON when it is in autorange mode.","Setting this attribute to smua.AUTORANGE_OFF puts the SMU on a fixed source range. The fixed range used is the present SMU source circuit range.","Setting this attribute to smua.AUTORANGE_ON puts the SMU source circuit into autorange mode. If the source output is on, the SMU immediately changes range to the range most appropriate for the value being sourced if that range is different than the present SMU range.","Autorange is disabled if the source level is edited from the front panel. Setting the source range also turns off autorange when set by using the smua.source.rangeY attribute.","Resetting the instrument selects the smua.AUTORANGE_ON.","Example","smua.source.autorangev = smua.AUTORANGE_ON","Enables volts source autorange.","Also see","smua.measure.autorangeY","smua.source.rangeY","smua.source.autorangeY","15139.htm");
+Page[328]=new Array("This function generates and activates new source calibration constants.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.source.calibrateY(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference)","Y","SMU source function (v = voltage, i = current)","range","The measurement range to adjust","cp1Expected","The source value set for point 1","cp1Reference","The reference measurement for point 1 as measured externally","cp2Expected","The source value set for point 2","cp2Reference","The reference measurement for point 2 as measured externally","Details","This function generates and activates new calibration constants for the given range.","The positive and negative polarities of the source must be adjusted separately. Use a positive value for range to adjust the positive polarity and a negative value for range to adjust the negative polarity. Do not use 0.0 for a negative point; 0.0 is considered to be a positive number.","Typically, the two points that are used are near zero for point 1 and 90% of full scale for point 2. Full scale for point 2 should be avoided if the source of the SMU is substantially out of calibration.","The two reference measurements must be made with the source using the active calibration set. For example, source a value, measure it, and do not change the active calibration set before issuing this command.","The new calibration constants are activated immediately but they are not written to nonvolatile memory. Use the smua.cal.save() function to save the new constants to nonvolatile memory. The active calibration constants stay in effect until the instrument is power cycled or a calibration set is loaded from nonvolatile memory with the smua.cal.restore() function.","This function is only available when calibration is unlocked using smua.cal.unlock().","Example","smua.source.calibratev(1, 1e-10, 1e-5, 0.9, 0.903)","Generates and activates new source calibration constants for the 1 A range. For point 1, it uses 1e-10 as the source value and 1e-5 as the reference measurement. For point 2, it uses 0.9 for the source value and 0.903 for the reference measurement.","Also see","Calibration","smua.cal.restore()","smua.cal.save()","smua.cal.unlock()","smua.measure.calibrateY()","smua.source.calibrateY()","15143.htm");
+Page[329]=new Array("This attribute contains the state of source compliance. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not saved","Not applicable","Usage","compliance = smua.source.compliance","compliance","The state of source compliance:","true: Indicates that the limit function is in control of the source (source in compliance)","false: Indicates that the source function is in control of the output (source not in compliance)","Details","Reading this attribute updates the status model and the front panel with generated compliance information. See Current Limit (ILMT) in the status model diagram for the Measurement event registers. The Voltage Limit (VLMT) is not shown in the status model diagram for the Measurement event registers, but is similar to the Current Limit (ILMT).","Example","compliance = smua.source.compliance","print(compliance)","Reads the source compliance state.","Output:","true","This output indicates that a configured limit has been reached (voltage, current, or power limit).","Also see","smua.source.limitY","smua.source.compliance","15141.htm");
+Page[330]=new Array("This attribute contains the source delay.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.DELAY_OFF)","Usage","sDelay = smua.source.delay","smua.source.delay = sDelay","sDelay","Set to the source delay value (for example, to specify an additional 10 ms source delay, set the value to 0.010); you can also set it one of the following values:","0 or smua.DELAY_OFF: No delay","-1 or smua.DELAY_AUTO: Automatic delay value","Details","This attribute allows for additional delay (settling time) after an output step.","The smua.DELAY_AUTO setting causes a range-dependent delay to be inserted when the source is changed. Range-dependent delays are based on the output settling time values as defined in the 2601B-PULSE specifications.","Example","smua.source.delay = smua.DELAY_AUTO","Sets the delay to automatic (a range-dependent delay is inserted whenever the source is changed).","Also see","reset()","smua.measure.count","smua.measure.delay","smua.reset()","smua.source.delay","15142.htm");
+Page[331]=new Array("This attribute contains the source function, which can be voltage or current.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","1 (smua.OUTPUT_DCVOLTS)","Usage","sFunction = smua.source.func","smua.source.func = sFunction","sFunction","The source function; set to one of the following values:","0 or smua.OUTPUT_DCAMPS: Selects the current source function","1 or smua.OUTPUT_DCVOLTS: Selects the voltage source function","Details","Reading this attribute indicates the output function of the source. Setting this attribute configures the SMU as either a voltage source or a current source.","Example","smua.source.func = smua.OUTPUT_DCAMPS","Sets the source function to be a current source.","Also see","smua.source.levelY","smua.source.output","smua.source.func","15144.htm");
+Page[332]=new Array("This attribute enables or disables high-capacitance mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","0 (smua.DISABLE)","Usage","highC = smua.source.highc","smua.source.highc = highC","highC ","The state of the high-capacitance mode; set to one of the following values:","0 or smua.DISABLE: Disables high-capacitance mode","1 or smua.ENABLE: Enables high-capacitance mode","Details","When enabled, the high-capacitance mode has the following effects on the SMU settings:","smua.measure.autorangei is set to smua.AUTORANGE_FOLLOW_LIMIT and cannot be changed","Current ranges below 1 µA are not accessible","If smua.source.limiti is less than 1 µA, it is raised to 1 µA","If smua.source.rangei is less than 1 µA, it is raised to 1 µA","If smua.source.lowrangei is less than 1 µA, it is raised to 1 µA","If smua.measure.lowrangei is less than 1 µA, it is raised to 1 µA","@High-capacitance mode is not available when the pulser is enabled.","Example","smua.source.highc = smua.ENABLE","Activates high-capacitance mode.","Also see","High-capacitance mode","smua.source.highc","15145.htm");
+Page[333]=new Array("This attribute sets the source level.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","0","Usage","sourceLevel = smua.source.levelY","smua.source.levelY = sourceLevel","sourceLevel","The source value; set to one of the following values:","Voltage: 0 V to ±40 V","Current when the pulser is disabled: 0 A to ±3 A","Bias current when the pulser is enabled: 0 A to ±250 mA","Y","SMU source function (v = voltage, i = current)","Details","This attribute configures the output level of the voltage or current source.","If the source is configured as a voltage source and the output is on, the new smua.source.levelv setting is sourced immediately. If the output is off or the source is configured as a current source, the voltage level is sourced when the source is configured as a voltage source and the output is turned on.","If the source is configured as a current source and the output is on, the new smua.source.leveli setting is sourced immediately. If the output is off or the source is configured as a voltage source, the current level is sourced when the source is configured as a current source and the output is turned on.","The sign of sourceLevel dictates the polarity of the source. Positive values generate positive voltage or current from the high terminal of the source relative to the low terminal. Negative values generate negative voltage or current from the high terminal of the source relative to the low terminal.","The reset() function sets the source levels to 0 V and 0 A.","Example","smua.source.levelv = 1","Sets voltage source of SMU channel A to 1 V.","Also see","smua.source.compliance","smua.source.func","smua.source.output","Source-measure concepts","smua.source.levelY","92361.htm");
+Page[334]=new Array("This attribute sets compliance limits.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","Limit voltage: 40 (40 V) Limit current: 1 (1 A) Limit power: 0 (disabled)","Usage","limit = smua.source.limitY","smua.source.limitY = limit","limit","The compliance limit value; set to one of the following values:","Voltage compliance: 10 mV to 40 V","Current compliance: 10 nA to 3 A","Power compliance (in watts)","Y","SMU function (v = voltage, i = current, p = power)","Details","Use the smua.source.limiti attribute to limit the current output of the voltage source. Use smua.source.limitv to limit the voltage output of the current source. The SMU always uses autoranging for the limit setting. Use the smua.source.limitp attribute to limit the output power of the source.","This attribute should be set in the test sequence before the turning the source on.","Using a limit value of 0 results in error code 1102, "Parameter too small," for v and i. Setting this attribute to zero disables power compliance for p. When setting the power compliance limit to a nonzero value, the SMU adjusts the source limit where appropriate to limit the output to the specified power. The SMU uses the lower of the programmed compliance value (the compliance level that would be used if power compliance were disabled) or the limit calculated from the power compliance setting.","Reading this attribute indicates the presently set compliance value. Use smua.source.compliance to read the state of source compliance.","Example","smua.source.limitv = 15","Sets the voltage limit to 15 V.","Also see","DUT test connections","smua.source.compliance","smua.source.func","smua.source.output","smua.source.limitY","92359.htm");
+Page[335]=new Array("This attribute sets the lowest source range that is used during autoranging.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","Voltage: 100e‑3 (100 mV) Current: 100e‑9 (100 nA)","Usage","sourceRangeLow = smua.source.lowrangeY","smua.source.lowrangeY = sourceRangeLow","sourceRangeLow","Set to the lowest voltage (in volts) or current (in amperes) range to be used","Y","SMU source function (v = voltage, i = current)","Details","This attribute is used with source autoranging to put a lower bound on the range that is used. Lower ranges generally require greater settling times. If you set a low-range value, you might be able to source small values with less settling time.","If the instrument is set to autorange and it is on a range lower than the one specified by sourceRangeLow, the source range will be changed to the range specified by sourceRangeLow.","Example","smua.source.lowrangev = 1","Sets the voltage low range to 1 V. This prevents the source from using the 100 mV range when sourcing voltage.","Also see","smua.source.autorangeY","smua.source.lowrangeY","92358.htm");
+Page[336]=new Array("This attribute sets the source function that is used (source 0 A or 0 V) when the output is turned off and the source‑measure unit (SMU) is in normal output-off mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","1 (smua.OUTPUT_DCVOLTS)","Usage","offfunc = smua.source.offfunc","smua.source.offfunc = offfunc","offfunc","Set to the source function to be used when the output is off and the SMU is in normal output-off mode. Set to one of the following values:","0 or smua.OUTPUT_DCAMPS: Source 0 A","1 or smua.OUTPUT_DCVOLTS: Source 0 V","Details","This attribute controls the source function used when the output is turned off and smua.source.offmode is set to smua.OUTPUT_NORMAL.","Set this attribute to smua.OUTPUT_DCVOLTS for the source to be a 0 V source when the output is off (smua.source.offlimiti is used).","Set it to smua.OUTPUT_DCAMPS for the source to be a 0 A source when the output is off (smua.source.offlimitv is used).","@If the pulser is enabled and the output‑off mode is set to normal, the smua.source.offfunc setting is ignored and the output circuit is shorted.","Example","smua.source.offmode = smua.OUTPUT_NORMAL","smua.source.offfunc = smua.OUTPUT_DCVOLTS","Sets the normal output-off mode to source 0 V when the output is turned off.","Also see","Output-off states","smua.source.offlimitY","smua.source.offmode","smua.source.output","smua.source.offfunc","92715.htm");
+Page[337]=new Array("This attribute sets the limit (current or voltage) used when the source‑measure unit (SMU) is in normal output-off mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","Current: 1e-3 (1 mA) Voltage: 40 (40 V)","Usage","sourceLimit = smua.source.offlimitY","smua.source.offlimitY = sourceLimit","sourceLimit","Set to the limit to be used when the SMU is in normal output-off mode","Y","SMU source function (v = voltage, i = current)","Details","Setting the current limit to lower than 1 mA may interfere with operation of the contact check function. See smua.contact.check() and smua.contact.r() for details.","Example","smua.source.offlimiti = 10e-3","Changes the normal output-off mode limit to 10 mA.","Also see","smua.contact.check()","smua.contact.r()","smua.source.offfunc","smua.source.offmode","smua.source.offlimitY","15149.htm");
+Page[338]=new Array("This attribute sets the source output-off mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","0 (smua.OUTPUT_NORMAL)","Usage","sourceOffMode = smua.source.offmode","smua.source.offmode = sourceOffMode","sourceOffMode","The output-off setting; set to one of the following values:","0 or smua.OUTPUT_NORMAL: See Details","1 or smua.OUTPUT_ZERO: See Details","2 or smua.OUTPUT_HIGH_Z: Opens the output relay when the output is turned off","Details","Reading this attribute returns the output-off mode of the source. Setting this attribute configures the SMU output-off mode.","When smua.OUTPUT_NORMAL is selected and the pulser is disabled, the source function is configured according to the smua.source.offfunc attribute. The smua.source.offfunc attribute controls whether the SMU is configured as a 0 V voltage source or a 0 A current source. When the SMU is operating as a 0 A current source, the smua.source.offlimitv attribute sets the voltage limit (similar to how the smua.source.offlimiti attribute sets the current limit when the SMU is operating as a 0 V voltage source).","When the output‑off mode is set to smua.OUTPUT_ZERO and the pulser is disabled, the source is configured to output 0 V. This is equivalent to smua.OUTPUT_NORMAL mode with smua.source.offfunc = smua.OUTPUT_DCVOLTS. If the source function is voltage, the current limit is not changed. If the source function is current, the current limit is set to the current source level or 10% of the current source range, whichever is greater.","When smua.OUTPUT_NORMAL or smua.OUTPUT_ZERO is selected and the pulser is enabled, the output circuit is shorted.","When sourceOffMode is set to smua.OUTPUT_HIGH_Z, the SMU opens the output relay when the output is turned off. To prevent excessive wear on the output relay, do not use this output-off mode for tests that turn the output off and on frequently.","Example","smua.source.offmode = smua.OUTPUT_HIGH_Z","Sets the output‑off mode to open the output relay when the output is turned off.","Also see","Output-off states","smua.source.offfunc","smua.source.offlimitY","smua.source.output","smua.source.offmode","92521.htm");
+Page[339]=new Array("This attribute enables or disables the source output.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.OUTPUT_OFF)","Usage","sourceOutput = smua.source.output","smua.source.output = sourceOutput","sourceOutput","The output state setting of the source; set to one of the following values:","0 or smua.OUTPUT_OFF: Turns off the source output","1 or smua.OUTPUT_ON: Turns on the source output","2 or smua.OUTPUT_HIGH_Z: Turns off the output in high Z mode (allows you to go to high Z mode without first setting the smua.source.offmode attribute to smua.OUTPUT_HIGH_Z)","Details","Reading this attribute returns the output state of the source. Setting this attribute switches the output of the source on or off.","When the output is switched on, the SMU sources either voltage or current, as set by smua.source.func.","Setting this attribute to smua.OUTPUT_HIGH_Z causes the output to turn off and go to the High Z mode. If the smua.source.output is read after setting this attribute to smua.OUTPUT_HIGH_Z, it returns 0.","Example","smua.source.output = smua.OUTPUT_ON","Turns on the source output.","Also see","DUT test connections","smua.source.func","smua.source.offmode","smua.source.output","15151.htm");
+Page[340]=new Array("This attribute contains the source range.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","Voltage: 100e-3 (100 mV) Current: 100e-9 (100 nA)","Usage","rangeValue = smua.source.rangeY","smua.source.rangeY = rangeValue","rangeValue","Set to the maximum expected voltage or current to be sourced","Y","SMU source function (v = voltage, i = current)","Details","This attribute contains a value that sets the source‑measure unit (SMU) to a fixed range large enough to source the value. When read, the attribute contains the range the instrument is presently on when in autorange.","Assigning a value to this attribute sets the SMU to a fixed range large enough to source the assigned value. The instrument selects the best range for sourcing a value of rangeValue.","Reading this attribute returns the positive full-scale value of the source range the SMU is currently using. With source autoranging enabled, the output level controls the range. Querying the range after the level is set returns the range the instrument chose as appropriate for that source level.","This attribute is primarily intended to eliminate the time required by the automatic range selection performed by a sourcing instrument. Because selecting a fixed range prevents autoranging, an overrange condition can occur. For example, sourcing 10.0 V on the 2601B-PULSE 6 V range causes an overrange condition.","Example","smua.source.rangev = 1","Selects the 1 V source range.","Also see","Range","reset()","setup.recall()","smua.measure.rangeY","smua.reset()","smua.source.autorangeY","smua.source.rangeY","92312.htm");
+Page[341]=new Array("This attribute contains the source settling mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.SETTLE_SMOOTH)","Usage","settleOption = smua.source.settling","smua.source.settling = settleOption","settleOption","Set to the source settling mode. Set to one of the following values:","0 or smua.SETTLE_SMOOTH: Turns off additional settling operations (default)","1 or smua.SETTLE_FAST_RANGE: Instructs the source‑measure unit (SMU) to use a faster procedure when changing ranges","2 or smua.SETTLE_FAST_POLARITY: Instructs the SMU to change polarity without going to zero","3 or smua.SETTLE_DIRECT_IRANGE: Instructs the SMU to change the current range directly","128 or smua.SETTLE_FAST_ALL: Enables all smua.SETTLE_FAST_* operations","Details","Using smua.SETTLE_FAST_RANGE may cause the SMU to exceed the range change overshoot specification.","smua.SETTLE_FAST_POLARITY does not go to zero when changing polarity and may create inconsistencies at the zero crossing.","smua.SETTLE_DIRECT_IRANGE switches the SMU directly to the target range instead of the default range-by-range method. This option is mutually exclusive of any other smua.SETTLE_FAST_* commands.","Example","smua.source.settling = smua.SETTLE_FAST_POLARITY","Selects fast polarity changing.","Also see","Range","smua.source.settling","92343.htm");
+Page[342]=new Array("This attribute turns sink mode on or off.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Saved setup","0 (smua.DISABLE)","Usage","sinkMode = smua.source.sink","smua.source.sink = sinkMode","sinkMode","Sets the sink mode on or off; set to one of the following values:","0 or smua.DISABLE: Turns off sink mode","1 or smua.ENABLE: Turns on sink mode","Details","This attribute enables or disables sink mode. When sink mode is enabled, it reduces the source limit inaccuracy that occurs when operating in quadrants II and IV (quadrants I and III will show this source limit inaccuracy).","Example","smua.source.sink = smua.ENABLE","Enables sink mode.","Also see","Source or sink","smua.source.sink","15155.htm");
+Page[343]=new Array("This attribute sets the arm count in the trigger model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","1","Usage","triggerArmCount = smua.trigger.arm.count","smua.trigger.arm.count = triggerArmCount","triggerArmCount","The arm count in the trigger model","Details","During a sweep, the SMU iterates through the arm layer of the trigger model this many times. After performing this many iterations, the SMU returns to an idle state.","If this count is set to zero, the SMU stays in the trigger model indefinitely until aborted.","Example","smua.trigger.arm.count = 5","Sets the SMU to iterate through the arm layer of the trigger model five times and then return to the idle state.","Also see","smua.trigger.count","smua.trigger.arm.count","15156.htm");
+Page[344]=new Array("This function sets the arm event detector to the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.arm.set()","Details","The SMU automatically clears all the event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated.","A common example of when this function can be used is when you want the SMU to immediately perform an action the first time through the trigger model even if a programmed trigger event does not occur. ","This function can also be used to start actions on the SMU in case of a missed trigger event.","Example","smua.trigger.arm.set()","Sets the arm event detector to the detected state.","Also see","smua.trigger.initiate()","smua.trigger.measure.set()","smua.trigger.source.set()","smua.trigger.arm.set()","15157.htm");
+Page[345]=new Array("This attribute selects the event that will cause the arm event detector to enter the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0","Usage","eventID = smua.trigger.arm.stimulus","smua.trigger.arm.stimulus = eventID","eventID","Event that triggers the arm detector","Details","Set this attribute to the event ID of any trigger event generator to wait for that event.","Set this attribute to zero to bypass waiting for events at the arm event detector (the SMU continues uninterrupted through the remote trigger model). Set eventID to one of the existing trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","smua.trigger.arm.stimulus = trigger.timer[1].EVENT_ID","An event on trigger timer 1 causes the arm event detector to enter the detected state.","Also see","Triggering","smua.trigger.arm.stimulus","15158.htm");
+Page[346]=new Array("This constant contains the number of the armed event.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.ARMED_EVENT_ID","eventID","The armed event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to armed events from this SMU.","Example","trigger.timer[1].stimulus = smua.trigger.ARMED_EVENT_ID","Trigger timer when the SMU passes through the arm layer.","Also see","Triggering","smua.trigger.ARMED_EVENT_ID","15159.htm");
+Page[347]=new Array("This attribute turns automatic clearing of the event detectors on or off.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.DISABLE)","Usage","autoClear = smua.trigger.autoclear","smua.trigger.autoclear = autoClear","autoClear","Auto clear setting; set to one of the following values:","0 or smua.DISABLE: Turns off automatic clearing of the event detectors","1 or smua.ENABLE: Turns on automatic clearing of the event detectors","Details","This attribute enables or disables automatic clearing of the trigger model state machine event detectors when the SMU transitions from the arm layer to the trigger layer.","Only the detected states of the event detectors are cleared.","The overrun statuses of the event detectors are not automatically cleared when the SMU transitions from the arm layer to the trigger layer.","The event detectors are always cleared when a sweep is initiated.","Example","smua.trigger.autoclear = smua.ENABLE","Automatically clear the event detectors for the trigger mode state.","Also see","Triggering","smua.trigger.autoclear","15160.htm");
+Page[348]=new Array("This attribute sets the trigger count in the trigger model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","1","Usage","triggerCount = smua.trigger.count","smua.trigger.count = triggerCount","triggerCount","The trigger count is the number of times the source‑measure unit (SMU) will iterate in the trigger layer for any given sweep","Details","During a sweep, the SMU iterates through the trigger layer of the trigger model this many times. After performing this many iterations, the SMU returns to the arm layer.","If this count is set to zero (0), the SMU stays in the trigger model indefinitely until aborted.","Example","reset()","period_timer = trigger.timer[1]","pulse_timer = trigger.timer[2]","smua.trigger.source.listv( {5} )","smua.trigger.source.action = smua.ENABLE","smua.source.rangev = 5","smua.trigger.measure.action = smua.DISABLE","pulse_timer.delay = 0.0006","pulse_timer.stimulus = period_timer.EVENT_ID","pulse_timer.count = 1","period_timer.delay = 0.005","period_timer.count = 9","period_timer.stimulus = smua.trigger.SWEEPING_EVENT_ID","period_timer.passthrough = true","smua.trigger.source.stimulus = period_timer.EVENT_ID","smua.trigger.endpulse.action = smua.SOURCE_IDLE","smua.trigger.endpulse.stimulus = pulse_timer.EVENT_ID","smua.trigger.count = 1","smua.trigger.arm.count = 10","smua.source.output = smua.OUTPUT_ON","smua.trigger.initiate()","waitcomplete()","smua.source.output = smua.OUTPUT_OFF","Generate a 10-point pulse train where each pulse has a width of 600 µs and a pulse period of 5 ms.","Alias the trigger timers to use for pulse width and period.","Create a fixed level voltage sweep.","Set the pulse width and trigger the pulse width timer with a period timer.","Set the pulse period to output one pulse per period and the count to generate 10 pulses.","Trigger the pulse period timer when a sweep is initiated.","Configure the timer to output a trigger event when it starts the first delay.","Trigger the SMU source action using pulse period timer.","Trigger the SMU end pulse action using pulse width timer.","Set the trigger model counts.","Configure the SMU to execute a 10-point pulse train.","Start the trigger model.","Wait for the sweep to complete.","Also see","Triggering","smua.trigger.count","15161.htm");
+Page[349]=new Array("This attribute enables or disables pulse sweeps when the pulser is disabled.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","1 (smua.SOURCE_HOLD)","Usage","pulseAction = smua.trigger.endpulse.action","smua.trigger.endpulse.action = pulseAction","pulseAction","The pulse mode setting; set to one of the following values (see Details for definition):","0 or smua.SOURCE_IDLE","1 or smua.SOURCE_HOLD","Details","When set to smua.SOURCE_HOLD, this attribute disables pulse mode sweeps, holding the source level for the remainder of the step. ","When set to smua.SOURCE_IDLE, this attribute enables pulse mode sweeps, setting the source level to the programmed (idle) level at the end of the pulse.","You cannot use this attribute and smua.trigger.source.pulsewidth in the same trigger model.","When the pulser is enabled, this setting is ignored. The source level is set to the programmed idle level at the end of the pulse.","Example","smua.trigger.endpulse.action = smua.SOURCE_IDLE","smua.trigger.endpulse.stimulus = trigger.timer[1].EVENT_ID","Configure the end pulse action to achieve a pulse and configure trigger timer 1 to control the end of pulse.","Also see","smua.trigger.source.pulsewidth","Triggering","smua.trigger.endpulse.action","92540.htm");
+Page[350]=new Array("This function sets the end pulse event detector to the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.endpulse.set()","Details","This function sets the end pulse event detector to the detected state.","The SMU automatically clears all the event detectors when the smua.trigger.initiate() function is executed. Therefore, smua.trigger.endpulse.set() should be called after the sweep is initiated. If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.endpulse.set() is issued after the SMU has entered the trigger layer.","Example","reset()","period_timer = trigger.timer[1]","pulse_timer = trigger.timer[2]","smua.trigger.source.listv( {5} )","smua.trigger.source.action = smua.ENABLE","smua.source.rangev = 5","smua.trigger.measure.action = smua.DISABLE","pulse_timer.delay = 0.0006","pulse_timer.stimulus = period_timer.EVENT_ID","pulse_timer.count = 1","period_timer.delay = 0.005","period_timer.count = 9","period_timer.stimulus = smua.trigger.SWEEPING_EVENT_ID","period_timer.passthrough = true","smua.trigger.source.stimulus = period_timer.EVENT_ID","smua.trigger.endpulse.action = smua.SOURCE_IDLE","smua.trigger.endpulse.stimulus = pulse_timer.EVENT_ID","smua.trigger.count = 1","smua.trigger.arm.count = 10","smua.source.output = smua.OUTPUT_ON","smua.trigger.initiate()","waitcomplete()","smua.source.output = smua.OUTPUT_OFF","Generate a 10-point pulse train where each pulse has a width of 600 µs and a pulse period of 5 ms.","Alias the trigger timers to use for pulse width and period.","Create a fixed level voltage sweep.","Set the pulse width and trigger the pulse width timer with a period timer.","Set the pulse period to output one pulse per period and the count to generate 10 pulses.","Trigger the pulse period timer when a sweep is initiated.","Configure the timer to output a trigger event when it starts the first delay.","Trigger the SMU source action using pulse period timer.","Trigger the SMU end pulse action using pulse width timer.","Set the trigger model counts.","Configure the SMU to execute a 10-point pulse train.","Start the trigger model.","Wait for the sweep to complete.","Also see","smua.trigger.autoclear","smua.trigger.initiate()","Triggering","smua.trigger.endpulse.set()","15163.htm");
+Page[351]=new Array("This attribute defines which event will cause the end pulse event detector to enter the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0","Usage","eventID = smua.trigger.endpulse.stimulus","smua.trigger.endpulse.stimulus = eventID","eventID","Set to the event that triggers the end pulse action of the source","Details","Set this attribute to the event ID of any trigger event generator to wait for that event. To bypass waiting for an event, set this value of this attribute to 0. Set eventID to one of the existing trigger event IDs, which are shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","smua.trigger.endpulse.action = smua.SOURCE_IDLE","smua.trigger.endpulse.stimulus = trigger.timer[1].EVENT_ID","Configure the end pulse action to achieve a pulse and select the event, trigger.timer[1].EVENT_ID, that causes the arm event detector to enter the detected state.","Also see","Triggering","smua.trigger.endpulse.stimulus","15165.htm");
+Page[352]=new Array("This attribute sets the action of the source at the end of a sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.SOURCE_IDLE)","Usage","action = smua.trigger.endsweep.action","smua.trigger.endsweep.action = action","action","The source action at the end of a sweep; set to one of the following values:","0 or smua.SOURCE_IDLE: Sets the source level to the programmed (idle) level at the end of the sweep","1 or smua.SOURCE_HOLD: Sets the source level to stay at the level of the last step","Details","Use this attribute to configure the source action at the end of the sweep. The SMU can be programmed to return to the idle source level or hold the last value of the sweep.","Example","smua.trigger.endsweep.action = smua.SOURCE_IDLE","Sets SMU return the source back to the idle source level at the end of a sweep.","Also see","Triggering","smua.trigger.endsweep.action","15166.htm");
+Page[353]=new Array("This constant contains the idle event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.IDLE_EVENT_ID","eventID","The idle event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to idle events from this SMU.","Example","trigger.timer[1].stimulus = smua.trigger.IDLE_EVENT_ID","Trigger timer 1 when the SMU returns to the idle layer.","Also see","Triggering","smua.trigger.IDLE_EVENT_ID","15167.htm");
+Page[354]=new Array("This function initiates a sweep operation.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.initiate()","Details","This function causes the SMU to clear the four trigger model event detectors and enter its trigger model (moves the SMU from the idle state into the arm layer).","To perform source actions during the sweep, before calling this function, it is necessary to configure and enable one of the following sweep source actions:","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","To make measurements during the sweep, you must also configure and enable the measure action using smua.trigger.measure.Y().","If you run this function more than once without reconfiguring the sweep measurements, the caches on the configured measurement reading buffers will hold stale data; use the bufferVar.clearcache() function to remove stale values from the reading buffer cache.","This function initiates an overlapped operation.","Example","smua.trigger.initiate()","Starts a preconfigured sweep and clears the event detectors.","Also see","bufferVar.clearcache()","Configuring and running sweeps","smua.trigger.measure.action","smua.trigger.measure.Y()","smua.trigger.source.action","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","Triggering","smua.trigger.initiate()","15168.htm");
+Page[355]=new Array("This attribute controls measurement actions during a sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.DISABLE)","Usage","action = smua.trigger.measure.action","smua.trigger.measure.action = action","action","The sweep measurement action; set to one of the following values:","0 or smua.DISABLE: Do not make measurements during the sweep","1 or smua.ENABLE: Make measurements during the sweep","2 or smua.ASYNC: Make measurements during the sweep, but asynchronously with the source area of the trigger model","Details","With this attribute enabled (setting action to smua.ENABLE or smua.ASYNC), configure the measurement with one of the smua.trigger.measure.Y() functions.","If this attribute is set to smua.ASYNC:","Asynchronous sweep measurements can only be used with measure autoranging turned off. To turn measure autoranging off for all measurements during the sweep, set the smua.measure.autorangeY attribute to smua.AUTORANGE_OFF.","Autozero must also be turned off. To turn off autozero, set the smua.measure.autozero attribute to smua.AUTOZERO_OFF or smua.AUTOZERO_ONCE.","The reading buffer used by smua.trigger.measure.Y() must have bufferVar.collectsourcevalues set to 0.","If any of the above items is incorrectly configured, the smua.trigger.initiate() function generates an error.","Example","smua.trigger.measure.v(smua.nvbuffer1)","smua.trigger.measure.action = smua.ENABLE","Configure sweep voltage measurements.","Enable voltage measurements during the sweep.","Also see","bufferVar.collectsourcevalues","smua.trigger.autoclear","smua.trigger.measure.Y()","Triggering","smua.trigger.measure.action","15169.htm");
+Page[356]=new Array("This function sets the measurement event detector to the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.measure.set()","Details","This function is useful whenever you want the SMU to continue operation without waiting for a programmed trigger event. When called, this function immediately satisfies the event detector, allowing the SMU to continue through the trigger model.","For example, you might use this function to have the SMU immediately perform an action the first time through the trigger model, even if a programmed trigger event does not occur.","If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.measure.set() is issued after the SMU has entered the trigger layer. This function can also be used to start actions on the SMU in case of a missed trigger event.","The SMU automatically clears all event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated.","Example","smua.trigger.measure.set()","Sets the measure event detector.","Also see","smua.trigger.arm.set()","smua.trigger.autoclear","smua.trigger.endpulse.set()","smua.trigger.source.set()","smua.trigger.measure.set()","15170.htm");
+Page[357]=new Array("This attribute selects the event that causes the measure event detector to enter the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0","Usage","eventID = smua.trigger.measure.stimulus","smua.trigger.measure.stimulus = eventID","eventID","Event that triggers the measurement detector","Details","Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the measurement event detector portion of the trigger model.","Set this attribute to zero to bypass waiting for an event (the SMU continues uninterrupted through the remote trigger model). Set eventID to one of the existing trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","smua.trigger.measure.stimulus = trigger.timer[1].EVENT_ID","Sets delay before measurement begins.","Also see","Triggering","smua.trigger.measure.stimulus","15171.htm");
+Page[358]=new Array("This function configures the measurements that are to be made in a subsequent sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.measure.Y(rbuffer)","smua.trigger.measure.iv(ibuffer, vbuffer)","Y","SMU measurement type (v = voltage, i = current, r = resistance, p = power)","rbuffer","A reading buffer object where the readings will be stored","ibuffer","A reading buffer object where current readings will be stored","vbuffer","A reading buffer object where voltage readings will be stored","Details","As measurements are made, they are stored in a reading buffer. If the instrument is configured to return multiple readings where one is requested, the readings are available as they are made. Measurements are in the following units of measure: v = volts, i = amperes, r = ohms, p = watts.","The smua.trigger.measure.iv() function stores current readings in ibuffer and voltage readings in vbuffer.","If a given reading buffer contains any data, it is cleared before making any measurements, unless the reading buffer has been configured to append data.","The SMU only retains the last call to any one of these functions and only that measurement action is performed.","After configuring the measurements to make with this function, enable the measurement action.","Example","smua.trigger.measure.v(vbuffername)","smua.trigger.measure.action = smua.ENABLE","Stores voltage readings during the sweep in buffer vbuffername.","Also see","Reading buffers","smua.measure.Y()","smua.nvbufferY","smua.trigger.measure.action","Sweep Operation","Triggering","waitcomplete()","smua.trigger.measure.Y()","15172.htm");
+Page[359]=new Array("This constant contains the measurement complete event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.MEASURE_COMPLETE_EVENT_ID","eventID","The measurement complete event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to measure complete events from this SMU.","Example","trigger.timer[1].stimulus = smua.trigger.MEASURE_COMPLETE_EVENT_ID","Trigger the timer when the SMU completes a measurement.","Also see","Triggering","smua.trigger.MEASURE_COMPLETE_EVENT_ID","15173.htm");
+Page[360]=new Array("This constant contains the pulse complete event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.PULSE_COMPLETE_EVENT_ID","eventID","The pulse complete event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to pulse complete events.","Example","trigger.timer[1].stimulus = smua.trigger.PULSE_COMPLETE_EVENT_ID","Trigger a timer when the SMU completes a pulse.","Also see","Triggering","smua.trigger.PULSE_COMPLETE_EVENT_ID","15174.htm");
+Page[361]=new Array("This attribute enables or disables sweeping the source (on or off).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.DISABLE)","Usage","action = smua.trigger.source.action","smua.trigger.source.action = action","action","Sweep source action. Set to one of the following values:","0 or smua.DISABLE: Do not sweep the source","1 or smua.ENABLE: Sweep the source","Details","This attribute is used to enable or disable source level changes during a sweep. In addition to enabling the action before initiating the sweep, make sure to configure it using smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY().","Example","smua.trigger.source.listv({3, 1, 4, 5, 2})","smua.trigger.source.action = smua.ENABLE","Configure list sweep (sweep through 3 V, 1 V, 4 V, 5 V, and 2 V).","Enable the source action.","Also see","smua.trigger.source.linearY()","smua.trigger.source.listY()","smua.trigger.source.logY()","Triggering","smua.trigger.source.action","15178.htm");
+Page[362]=new Array("This attribute sets the sweep source limit.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0 (smua.LIMIT_AUTO)","Usage","sweepSourceLimit = smua.trigger.source.limitY","smua.trigger.source.limitY = sweepSourceLimit","sweepSourceLimit","The source limit that is used during triggered operation; set to:","A user-defined value","smua.LIMIT_AUTO","Y","SMU output function (v = voltage, i = current)","Details","Use this attribute to perform extended operating area (EOA) pulse mode sweeps.","If this attribute is set to smua.LIMIT_AUTO (or 0), the SMU uses the normal limit setting during sweeping. If this attribute is set to any other numeric value, the SMU switches in this limit at the start of the source action and returns to the normal limit setting at the end of the end pulse action.","Normally, the limit range is automatically adjusted in accordance with the limit value. During sweeping, however, the limit range is fixed to avoid the delays associated with changing range. This fixed limit range is determined by the maximum limit value needed during the sweep; that is, the greater of either the normal limit value (as specified by smua.source.limitY) or the sweep limit value (as specified by smua.trigger.source.limitY). Note that the minimum limit value that can be enforced during the sweep is equal to 10% of the full scale value of the fixed limit range. If the smaller limit value (normal or sweep) falls below this 10% threshold, the 10% value is enforced instead. Likewise, if the limit value falls below the 10% threshold as a result of power compliance, the 10% value is enforced instead.","When using the EOA, the SMU will automatically start the end pulse action if the SMU is not triggered before its maximum pulse width. It will also delay the source action if necessary to limit the pulse duty cycle to stay within the capabilities of the SMU.","Example","smua.trigger.source.limitv = 10","Sets the voltage sweep limit to 10 V.","Also see","Configuring and running sweeps","smua.source.limitY","Triggering","smua.trigger.source.limitY","15179.htm");
+Page[363]=new Array("This function configures a linear source sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.source.linearY(startValue, endValue, points)","Y","SMU source function (v = voltage, i = current)","startValue","Source value of the first point","endValue","Source value of the last point","points","The number of points used to calculate the step size","Details","This function configures the source action to be a linear source sweep in a subsequent sweep. During the sweep, the source will generate a uniform series of ascending or descending voltage or current changes called steps. The number of source steps is one less than the number of sourced points.","The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source will restart at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU will satisfy the trigger count by restarting the sweep values from the beginning. ","If the subsequent sweep has fewer points than specified in points, endValue will not be reached during the sweep. This means that if the trigger count is less than the number of source values configured, the SMU will satisfy the trigger count and ignore the remaining source values.","In cases where the first sweep point is a nonzero value, it may be necessary to pre-charge the circuit so that the sweep will return a stable value for the first measured point without penalizing remaining points in the sweep.","With linear sweeps, it is acceptable to maintain a fixed source resolution over the entire sweep. To prevent source range changes during the sweep (especially when sweeping through 0.0), set the source range to a fixed range appropriate for the larger of either startValue or endValue. ","The SMU will only store the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.","Source functions cannot be changed within a sweep.","After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.","Example","smua.trigger.source.linearv(0, 10, 11)","Sweeps from 0 V to 10 V in 1 V steps.","Also see","smua.trigger.source.action","smua.trigger.source.listY()","smua.trigger.source.logY()","Sweep Operation","smua.trigger.source.linearY()","15180.htm");
+Page[364]=new Array("This function configures an array-based source sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.source.listY(sweepList)","Y","SMU source function (v = voltage, i = current)","sweepList","An array of source values","Details","This function configures the source action to be a list sweep in a subsequent sweep. During the sweep, the source will output the sequence of source values given in the sweepList array.","If the subsequent sweep has more points than specified in sweepList, the source will restart at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU will satisfy the trigger count by restarting the sweep values from the beginning. ","If the subsequent sweep has fewer points than specified in sweepList, the extra values will be ignored. This means that if the trigger count is less than the number of source values configured, the SMU will satisfy the trigger count and ignore the remaining source values.","In cases where the first sweep point is a nonzero value, it may be necessary to pre-charge the circuit so that the sweep will return a stable value for the first measured point without penalizing remaining points in the sweep.","The SMU will only store the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.","Source functions cannot be changed within a sweep.","After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.","Example","smua.trigger.source.listv({3, 1, 4, 5, 2})","Sweeps through 3 V, 1 V, 4 V, 5 V, and 2 V.","Also see","smua.trigger.source.action","smua.trigger.source.linearY()","smua.trigger.source.logY()","Sweep Operation","smua.trigger.source.listY()","15181.htm");
+Page[365]=new Array("This function configures an exponential (geometric) source sweep.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.source.logY(startValue, endValue, points, asymptote)","Y","SMU source function (v = voltage, i = current)","startValue","Source value of the first point","endValue","Source value of the last point","points","The number of points used to calculate the step size","asymptote","The asymptotic offset value","Details","This function configures the source action to be a geometric source sweep in a subsequent sweep. During the sweep, the source generates a geometric series of ascending or descending voltage or current changes called steps. Each step is larger or smaller than the previous step by a fixed proportion. The constant of proportionality is determined by the starting value, the ending value, the asymptote, and the number of steps in the sweep. The number of source steps is one less than the number of sourced points.","The points parameter does not set the number of steps in a sweep, but rather is used to calculate source values within a subsequent sweep. If the subsequent sweep has more points than specified in points, the source restarts at the beginning. This means that if the trigger count is greater than the number of points in a sweep as configured, the SMU satisfies the trigger count by restarting the sweep values from the beginning. ","If the subsequent sweep has fewer points than specified in points, endValue is not reached during the sweep. This means that if the trigger count is less than the number of source values configured, the SMU satisfies the trigger count and ignores the remaining source values.","In cases where the first sweep point is nonzero, it may be necessary to pre-charge the circuit so that the sweep returns a stable value for the first measured point without penalizing remaining points in the sweep.","With logarithmic sweeps, it is usually necessary to allow the source to autorange to maintain good source accuracy when sweeping over more than one decade or across range boundaries.","The asymptote parameter can be used to customize the inflection and offset of the source value curve. This allows log sweeps to cross zero. Setting this parameter to zero provides a conventional logarithmic sweep. The asymptote value is the value that the curve has at either positive or negative infinity, depending on the direction of the sweep.","The asymptote value must not be equal to or between the starting and ending values. It must be outside the range defined by the starting and ending values.","The SMU stores only the most recent configured source action. The last call to smua.trigger.source.linearY(), smua.trigger.source.listY(), or smua.trigger.source.logY() is used for the source action.","Source functions cannot be changed within a sweep.","After configuring the sweep source values, enable the source action by setting smua.trigger.source.action.","Example","smua.trigger.source.logv(1, 10, 11, 0)","Sweeps from 1 V to 10 V in 10 steps with an asymptote of 0 V.","Also see","smua.trigger.source.action","smua.trigger.source.linearY()","smua.trigger.source.listY()","Sweep operation","smua.trigger.source.logY()","15182.htm");
+Page[366]=new Array("This attribute sets the source pulse width when using a trigger model sweep when the pulser is enabled","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset SMU reset Recall setup","Saved setup","0","Usage","pulsewidth = smua.trigger.source.pulsewidth","smua.trigger.source.pulsewidth = pulsewidth","pulsewidth","The source pulse width in seconds; set from 0.000001 to 0.065; set to 0 to disable automatic pulsewidth control","Details","Use this attribute only when generating pulses using the trigger model when the pulser is enabled.","Set the pulsewidth parameter to a nonzero value to limit the action of the source to the specified pulse width. This allows the 2601B-PULSE to generate pulses with less pulsewidth jitter than those generated using the end‑pulse trigger block in the trigger model.","The value set for this attribute affects the values you can use for the smua.pulser.measure.aperture and smu.pulser.measure.delay attributes. The sum of the measure delay and the aperture must be less than the specified pulse width.","You cannot use this attribute and smua.trigger.endpulse.action in the same trigger model.","Example","smua.trigger.source.pulsewidth = 50e-6","Set the source pulse width to 50 µs.","Also see","smua.pulser.measure.aperture","smua.pulser.measure.delay","smua.trigger.endpulse.action","smua.trigger.source.pulsewidth","91678.htm");
+Page[367]=new Array("This function sets the source event detector to the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","smua.trigger.source.set()","Details","This function sets the source event detector to the detected state.","The SMU automatically clears all event detectors when the smua.trigger.initiate() function is executed. This function should be called after the sweep is initiated. If the event detectors are configured to clear automatically because the smua.trigger.autoclear attribute is set to smua.ENABLE, make sure that smua.trigger.source.set() is issued after the SMU has entered the trigger layer.","Example","reset()","smua.trigger.source.listv({5})","smua.trigger.source.stimulus = display.trigger.EVENT_ID","smua.source.output = smua.OUTPUT_ON","smua.trigger.initiate()","delay(1)","-- Continue even if the display trigger key was not pressed.","smua.trigger.source.set()","waitcomplete()","Sets the source event detector.","Also see","smua.trigger.arm.set()","smua.trigger.autoclear","smua.trigger.endpulse.set()","smua.trigger.initiate()","smua.trigger.measure.set()","Triggering","smua.trigger.source.set()","15183.htm");
+Page[368]=new Array("This attribute defines which event causes the source event detector to enter the detected state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","SMU reset Instrument reset Recall setup","Not saved","0","Usage","eventID = smua.trigger.source.stimulus","smua.trigger.source.stimulus = eventID","eventID","Set to the event that triggers the end‑pulse source off action","Details","Set this attribute to the event ID of any trigger event generator to wait for that event. When set, the SMU waits for the event at the source event detector portion of the trigger model. To bypass waiting for an event, set the value of this attribute to zero (0). Set eventID to one of the existing trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","smua.trigger.source.stimulus = digio.trigger[2].EVENT_ID","Configure to start its source action when a trigger event occurs on digital I/O line 2.","Also see","Triggering","smua.trigger.source.stimulus","15184.htm");
+Page[369]=new Array("This constant contains the source complete event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.SOURCE_COMPLETE_EVENT_ID","eventID","The source action complete event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to source complete events from this source‑measure unit (SMU).","Example","trigger.timer[1].stimulus = smua.trigger.SOURCE_COMPLETE_EVENT_ID","Trigger the timer when the SMU updates the source level or starts a pulse.","Also see","Triggering","smua.trigger.SOURCE_COMPLETE_EVENT_ID","15175.htm");
+Page[370]=new Array("This constant contains the sweep complete event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.SWEEP_COMPLETE_EVENT_ID","eventID","The sweep complete event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to sweep complete events from this SMU.","Example","digio.trigger[2].mode = digio.TRIG_RISINGA","digio.trigger[2].clear()","smua.trigger.source.stimulus = digio.trigger[2].EVENT_ID","digio.trigger[4].mode = digio.TRIG_RISINGM","digio.trigger[4].pulsewidth = 0.001","digio.trigger[4].stimulus = smua.trigger.SWEEP_COMPLETE_EVENT_ID","Configure the 2601B-PULSE to detect a rising edge on digital I/O line 2.","Configure SMU A to start its source action when a trigger event occurs on digital I/O line 2.","Configure digital I/O line 4 to output a 1 ms rising-edge trigger pulse at the completion of the SMU sweep.","Also see","Triggering","smua.trigger.SWEEP_COMPLETE_EVENT_ID","15176.htm");
+Page[371]=new Array("This constant contains the sweeping event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = smua.trigger.SWEEPING_EVENT_ID","eventID","The sweeping event number","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to sweeping events from this SMU.","Example","reset()","period_timer = trigger.timer[1]","pulse_timer = trigger.timer[2]","smua.trigger.source.listv( {5} )","smua.trigger.source.action = smua.ENABLE","smua.source.rangev = 5","smua.trigger.measure.action = smua.DISABLE","pulse_timer.delay = 0.0006","pulse_timer.stimulus = period_timer.EVENT_ID","pulse_timer.count = 1","period_timer.delay = 0.005","period_timer.count = 9","period_timer.stimulus = smua.trigger.SWEEPING_EVENT_ID","period_timer.passthrough = true","smua.trigger.source.stimulus = period_timer.EVENT_ID","smua.trigger.endpulse.action = smua.SOURCE_IDLE","smua.trigger.endpulse.stimulus = pulse_timer.EVENT_ID","smua.trigger.count = 1","smua.trigger.arm.count = 10","smua.source.output = smua.OUTPUT_ON","smua.trigger.initiate()","waitcomplete()","smua.source.output = smua.OUTPUT_OFF","Generate a 10-point pulse train where each pulse has a width of 600 µs and a pulse period of 5 ms.","Alias the trigger timers to use for pulse width and period.","Create a fixed level voltage sweep.","Set the pulse width and trigger the pulse width timer with a period timer.","Set the pulse period to output one pulse per period and the count to generate 10 pulses.","Trigger the pulse period timer when a sweep is initiated.","Configure the timer to output a trigger event when it starts the first delay.","Trigger the SMU source action using pulse period timer.","Trigger the SMU end pulse action using pulse width timer.","Set the trigger model counts.","Configure the SMU to execute a 10-point pulse train.","Start the trigger model.","Wait for the sweep to complete.","Also see","Triggering","smua.trigger.SWEEPING_EVENT_ID","15177.htm");
+Page[372]=new Array("This attribute stores the status byte condition register.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not saved","Not applicable","Usage","statusByte = status.condition","statusByte","The status byte; a zero (0) indicates no bits set; other values indicate various bit settings","Details","This attribute is used to read the status byte, which is returned as a numeric value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">","*","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","The returned value can indicate one or more status events occurred. When an enabled status event occurs, a summary bit is set in this register to indicate the event occurrence.","The individual bits of this register have the following meanings:","Bit","Value and description","B0","status.MEASUREMENT_SUMMARY_BIT","status.MSB","Set summary bit indicates that an enabled measurement event has occurred. ","Bit B0 decimal value: 1","B1","status.SYSTEM_SUMMARY_BIT","status.SSB","Set summary bit indicates that an enabled system event has occurred.","Bit B1 decimal value: 2","B2","status.ERROR_AVAILABLE","status.EAV","Set summary bit indicates that an error or status message is present in the Error Queue. ","Bit B2 decimal value: 4","B3","status.QUESTIONABLE_SUMMARY_BIT","status.QSB","Set summary bit indicates that an enabled questionable event has occurred. ","Bit B3 decimal value: 8","B4","status.MESSAGE_AVAILABLE","status.MAV","Set summary bit indicates that a response message is present in the Output Queue. ","Bit B4 decimal value: 16","B5","status.EVENT_SUMMARY_BIT","status.ESB","Set summary bit indicates that an enabled standard event has occurred. ","Bit B5 decimal value: 32","B6","status.MASTER_SUMMARY_STATUS","status.MSS","Request Service (RQS)/Master Summary Status (MSS). Depending on how it is used, bit B6 of the status byte register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit:","When using the GPIB, USB, or VXI-11 serial poll sequence of the 2601B-PULSE to obtain the status byte (serial poll byte), B6 is the RQS bit. The set bit indicates that the Request Service (RQS) bit of the status byte (serial poll byte) is set and a service request (SRQ) has occurred. ","When using the status.condition register command or the *STB? common command to read the status byte, B6 is the MSS bit. Set bit indicates that an enabled summary bit of the status byte register is set.","Bit B6 decimal value: 64","B7","status.OPERATION_SUMMARY_BIT","status.OSB","Set summary bit indicates that an enabled operation event has occurred.","Bit B7 decimal value: 128","In addition to the above constants, when more than one bit of the register is set, statusByte equals the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example","statusByte = status.condition","print(statusByte)","Returns statusByte.","Sample output:","1.29000e+02","Converting this output (129) to its binary equivalent yields 1000 0001 ","Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSS) and B7 (OSB).","Also see","Status byte and service request (SRQ)","status.condition","29255.htm");
+Page[373]=new Array("This attribute contains the measurement event register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","10,635 (All bits set)","Usage","measurementRegister = status.measurement.condition","measurementRegister = status.measurement.enable","measurementRegister = status.measurement.event","measurementRegister = status.measurement.ntr","measurementRegister = status.measurement.ptr","status.measurement.enable = measurementRegister","status.measurement.ntr = measurementRegister","status.measurement.ptr = measurementRegister","measurementRegister","The status of the measurement event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes read or write the measurement event registers.","Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. ","For example, assume value 257 is returned for the enable register. The binary equivalent is 0000 0001 0000 0001. This value indicates that bit B0 (VLMT) and bit B8 (BAV) are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","1","0","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.measurement.VOLTAGE_LIMIT","status.measurement.VLMT","Set bit is a summary of the status.measurement.voltage_limit register.","Bit B0 decimal value: 1","B1","status.measurement.CURRENT_LIMIT","status.measurement.ILMT","Set bit is a summary of the status.measurement.current_limit register.","Bit B1 decimal value: 2","B2","Not used","B3","status.measurement.PROTECTION","status.measurement.PROT","Set bit indicates that the pulser protection was tripped. Refer to smua.pulser.protect.tripped for events that can trip the protection circuits.","Bit B1 decimal value: 8","B4 to B6","Not used","B7","status.measurement.READING_OVERFLOW","status.measurement.ROF","Set bit is a summary of the status.measurement.reading_overflow register.","Bit B7 decimal value: 128","B8","status.measurement.BUFFER_AVAILABLE","status.measurement.BAV","Set bit is a summary of the status.measurement.buffer_available register.","Bit B8 decimal value: 256","B9 to B10","Not used","B11","status.measurement.INTERLOCK","status.measurement.INT","Interlock line. Set bit indicates that interlock is asserted.","Bit B11 decimal value: 2,048","B12","Not used","B13","status.measurement.INSTRUMENT_SUMMARY","status.measurement.INST","Set bit indicates that a bit in the measurement instrument summary register is set.","Bit B13 decimal value: 8,192","B14 to B15","Not used","As an example, to set bit B8 of the measurement event enable register, set status.measurement.enable = status.measurement.BAV. ","In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set. To set more than one bit of the register, set measurementRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set measurementRegister to 258 (which is the sum of 2 + 256).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example","status.measurement.enable = status.measurement.BAV","Sets the BAV bit of the measurement event enable register.","Also see","Measurement event registers","smua.pulser.protect.tripped","status.measurement.*","92390.htm");
+Page[374]=new Array("This attribute contains the measurement event buffer available summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","measurementRegister = status.measurement.buffer_available.condition","measurementRegister = status.measurement.buffer_available.enable","measurementRegister = status.measurement.buffer_available.event","measurementRegister = status.measurement.buffer_available.ntr","measurementRegister = status.measurement.buffer_available.ptr","status.measurement.buffer_available.enable = measurementRegister","status.measurement.buffer_available.ntr = measurementRegister","status.measurement.buffer_available.ptr = measurementRegister","measurementRegister","The status of the measurement event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event buffer available summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.measurement.buffer_available.SMUA","Set bit indicates that there is at least one reading stored in either or both of the dedicated reading buffers.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the measurement event buffer available summary enable register, set status.measurement.buffer_available.enable = status.measurement.buffer_available.SMUA.","In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set.","Example 1","status.measurement.buffer_available.enable = status.measurement.buffer_available.SMUA","Uses the constant to set the SMUA bit of the measurement event buffer available summary enable register.","Example 2","status.measurement.buffer_available.enable = 2","Uses the decimal value to set the SMUA bit of the measurement event buffer available summary enable register.","Also see","Measurement event registers","status.measurement.buffer_available.*","93041.htm");
+Page[375]=new Array("This attribute contains the measurement event current limit summary registers.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","measurementRegister = status.measurement.current_limit.condition","measurementRegister = status.measurement.current_limit.enable","measurementRegister = status.measurement.current_limit.event","measurementRegister = status.measurement.current_limit.ntr","measurementRegister = status.measurement.current_limit.ptr","status.measurement.current_limit.enable = measurementRegister","status.measurement.current_limit.ntr = measurementRegister","status.measurement.current_limit.ptr = measurementRegister","measurementRegister","The status of the measurement event current limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event current limit summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.measurement.current_limit.SMUA","Set bit indicates that the SMU A current limit was exceeded.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the measurement event current limit summary enable register, set status.measurement.current_limit.enable = status.measurement.current_limit.SMUA.","In addition to the above constants, measurementRegister can be set to the decimal value of Bit B1.","Example 1","status.measurement.current_limit.enable = status.measurement.current_limit.SMUA","Sets the SMUA bit of the Measurement Event Current Limit Summary Enable Register using a constant.","Example 2","status.measurement.current_limit.enable = 2","Sets the SMUA bit of the Measurement Event Current Limit Summary Enable Register using a decimal value.","Also see","Measurement event registers","status.measurement.instrument.smua.*","status.measurement.current_limit.*","93040.htm");
+Page[376]=new Array("This attribute contains the registers of the measurement event instrument summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","measurementRegister = status.measurement.instrument.condition","measurementRegister = status.measurement.instrument.enable","measurementRegister = status.measurement.instrument.event","measurementRegister = status.measurement.instrument.ntr","measurementRegister = status.measurement.instrument.ptr","status.measurement.instrument.enable = measurementRegister","status.measurement.instrument.ntr = measurementRegister","status.measurement.instrument.ptr = measurementRegister","measurementRegister","The status of the measurement event instrument summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table. ","Bit","Value and description","B0","Not used","B1","status.measurement.instrument.SMUA","Set bit indicates one or more enabled bits of the measurement event SMU A summary register is set.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the measurement event instrument summary enable register, set status.measurement.instrument.enable = status.measurement.instrument.SMUA.","In addition to the constant, measurementRegister can be set to the decimal value of bit B1.","Example 1","status.measurement.instrument.enable = status.measurement.instrument.SMUA","Uses the constant to set the SMU A bit of the measurement event instrument summary enable register.","Example 2","status.measurement.instrument.enable = 2","Uses the decimal value to set the SMU A bit of the measurement event instrument summary enable register.","Also see","Measurement event registers","status.measurement.instrument.*","93039.htm");
+Page[377]=new Array("This attribute contains the registers of the measurement event SMU A summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","395 (All bits set) ","Usage","measurementRegister = status.measurement.instrument.smua.condition","measurementRegister = status.measurement.instrument.smua.enable","measurementRegister = status.measurement.instrument.smua.event","measurementRegister = status.measurement.instrument.smua.ntr","measurementRegister = status.measurement.instrument.smua.ptr","status.measurement.instrument.smua.enable = measurementRegister","status.measurement.instrument.smua.ntr = measurementRegister","status.measurement.instrument.smua.ptr = measurementRegister ","measurementRegister","The status of the instrument measurement status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, assume the value 257 is returned for the enable register. The binary equivalent is 0000 0001 0000 0001. This value indicates that bit B0 (VLMT) and bit B8 (BAV) are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","1","0","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0*","status.measurement.instrument.smua.VOLTAGE_LIMIT","status.measurement.instrument.smua.VLMT","Set bit indicates that the voltage limit was exceeded.","Bit B0 decimal value: 1","B1*","status.measurement.instrument.smua.CURRENT_LIMIT","status.measurement.instrument.smua.ILMT","Set bit indicates that the current limit was exceeded.","Bit B1 decimal value: 2","B2","Not used","B3","status.measurement.instrument.smua.PROTECTION","status.measurement.instrument.smua.PROT","Set bit indicates that the pulser protection was tripped. Refer to smua.pulser.protect.tripped for events that can trip the protection circuits.","Bit B0 decimal value: 8","B4 to B6","Not used","B7","status.measurement.instrument.smua.READING_OVERFLOW","status.measurement.instrument.smua.ROF","Set bit indicates that an overflow reading has been detected.","Bit B7 decimal value: 128","B8","status.measurement.instrument.smua.BUFFER_AVAILABLE","status.measurement.instrument.smua.BAV","Set bit indicates that there is at least one reading stored in either or both dedicated reading buffers.","Bit B8 decimal value: 256","B9 to B15","Not used","* This bit is updated only when a measurement is made or smua.source.compliance is invoked.","As an example, to set bit B0 of the measurement event SMU A summary enable register, set status.measurement.instrument.smua.enable = status.measurement.instrument.smua.VLMT.","In addition to the above constants, measurementRegister can be set to the decimal equivalent of the bit to set. To set more than one bit of the register, set measurementRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set measurementRegister to 258 (which is the sum of 2 + 256). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.measurement.instrument.smua.enable = status.measurement.instrument.smua.VLMT","Uses a constant to set the VLMT bit of the measurement event SMU A summary enable register.","Example 2","status.measurement.instrument.smua.enable = 1","Uses the decimal value to set the VLMT bit of the measurement event SMU A summary enable register.","Also see","Measurement event registers","smua.pulser.protect.tripped","status.measurement.instrument.smua.*","92690.htm");
+Page[378]=new Array("This attribute contains the registers of the measurement event protection summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","measurementRegister = status.measurement.protection.condition","measurementRegister = status.measurement.protection.enable","measurementRegister = status.measurement.protection.event","measurementRegister = status.measurement.protection.ntr","measurementRegister = status.measurement.protection.ptr","status.measurement.protection.enable = measurementRegister","status.measurement.protection.ntr = measurementRegister","status.measurement.protection.ptr = measurementRegister","measurementRegister","The status of the measurement event protection summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event protection summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table. ","Bit","Value","B0","Not used","B1","status.measurement.protection.SMUA","Set bit indicates one of the pulser protection circuits have tripped.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.","Example 1","status.measurement.protection.enable = status.measurement.protection.SMUA","Uses the constant to set bit 1, the SMU A bit of the measurement event protection summary enable register.","Example 2","status.measurement.protection.enable = 2","Uses the decimal value to set bit 1, the SMU A bit of the measurement event protection summary enable register.","Also see","Measurement event registers","status.measurement.protection.*","92743.htm");
+Page[379]=new Array("This attribute contains the measurement event reading overflow summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","measurementRegister = status.measurement.reading_overflow.condition","measurementRegister = status.measurement.reading_overflow.enable","measurementRegister = status.measurement.reading_overflow.event","measurementRegister = status.measurement.reading_overflow.ntr","measurementRegister = status.measurement.reading_overflow.ptr","status.measurement.reading_overflow.enable = measurementRegister","status.measurement.reading_overflow.ntr = measurementRegister","status.measurement.reading_overflow.ptr = measurementRegister","measurementRegister","The status of the measurement reading overflow summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the measurement event reading overflow summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, assume the value 2 is returned for the enable register. The binary equivalent is 0000 0000 0000 0010. This value indicates that bit B1 (SMUA) is set.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.measurement.reading_overflow.SMUA","Set bit indicates that an overflow reading has been detected for SMU A.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.","Example 1","status.measurement.reading_overflow.enable = status.measurement.reading_overflow.SMUA","Uses the constant to set bit B1 of the measurement reading overflow summary enable register.","Example 2","status.measurement.reading_overflow.enable = 2","Uses the decimal value to set bit B1 of the measurement reading overflow summary enable register.","Also see","Measurement event registers","status.measurement.reading_overflow.*","93010.htm");
+Page[380]=new Array("This attribute contains the measurement event voltage limit summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set) ","Usage","measurementRegister = status.measurement.voltage_limit.condition","measurementRegister = status.measurement.voltage_limit.enable","measurementRegister = status.measurement.voltage_limit.event","measurementRegister = status.measurement.voltage_limit.ntr","measurementRegister = status.measurement.voltage_limit.ptr","status.measurement.voltage_limit.enable = measurementRegister","status.measurement.voltage_limit.ntr = measurementRegister","status.measurement.voltage_limit.ptr = measurementRegister","measurementRegister","The status of the measurement voltage limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other decimal values indicate various bit settings ","Details","These attributes read or write to the measurement event voltage limit summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.measurement.voltage_limit.SMUA","Set bit indicates the enabled VLMT bit for the SMU A measurement register is set.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","In addition to the above constants, measurementRegister can be set to the decimal value of the bit to set.","Example 1","status.measurement.voltage_limit.enable = status.measurement.voltage_limit.SMUA","Uses the constant to set the SMUA bit, B1, of the measurement event voltage limit summary enable register.","Example 2","status.measurement.voltage_limit.enable = 2","Uses the decimal value to set the SMUA bit, B1, of the measurement event voltage limit summary enable register.","Also see","Measurement event registers","status.measurement.voltage_limit.*","93012.htm");
+Page[381]=new Array("This attribute stores the system node enable register. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Status reset","Not saved","0","Usage","nodeEnableRegister = status.node_enable","status.node_enable = nodeEnableRegister","nodeEnableRegister","The status of the system node enable register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","This attribute is used to read or write to the system node enable register. Reading the system node enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">","*","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register. The register and bit that is set depends on the TSP-Link node number assigned to this instrument.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.MEASUREMENT_SUMMARY_BIT","status.MSB","Set summary bit indicates that an enabled measurement event has occurred.","Bit B0 decimal value: 1","B1","Not used","B2","status.ERROR_AVAILABLE","status.EAV","Set summary bit indicates that an error or status message is present in the error queue.","Bit B2 decimal value: 4","B3","status.QUESTIONABLE_SUMMARY_BIT","status.QSB","Set summary bit indicates that an enabled questionable event has occurred.","Bit B3 decimal value: 8","B4","status.MESSAGE_AVAILABLE","status.MAV","Set summary bit indicates that a response message is present in the output queue.","Bit B4 decimal value: 16","B5","status.EVENT_SUMMARY_BIT","status.ESB","Set summary bit indicates that an enabled standard event has occurred.","Bit B5 decimal value: 32","B6","status.MASTER_SUMMARY_STATUS","status.MSS","Set bit indicates that an enabled Master Summary Status (MSS) bit of the Status Byte Register is set.","Bit B6 decimal value: 64","B7","status.OPERATION_SUMMARY_BIT","status.OSB","Set summary bit indicates that an enabled operation event has occurred.","Bit B7 decimal value: 128","As an example, to set the B0 bit of the system node enable register, set status.node_enable = status.MSB.","In addition to the above values, nodeEnableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set nodeEnableRegister to the sum of their decimal weights. For example, to set bits B0 and B7, set nodeEnableRegister to 129 (1 + 128).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example 1","nodeEnableRegister = status.MSB + status.OSB","status.node_enable = nodeEnableRegister","Use constants to set the MSB and OSB bits of the system node enable register.","Example 2","-- decimal 129 = binary 10000001","nodeEnableRegister = 129","status.node_enable = nodeEnableRegister","Sets the MSB and OSB bits of the system node enable register using a decimal value.","Also see","status.condition","status.system.*","Status byte and service request (SRQ)","status.node_enable","15830.htm");
+Page[382]=new Array("This attribute stores the status node event register.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not saved","0","Usage","nodeEventRegister = status.node_event","nodeEventRegister","The status of the node event register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","This attribute is used to read the status node event register, which is returned as a numeric value (reading this register returns a value). The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">","*","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","The returned value can indicate one or more status events occurred.","Bit","Value and description","B0","status.MEASUREMENT_SUMMARY_BIT","status.MSB","Set summary bit indicates that an enabled measurement event has occurred.","Bit B0 decimal value: 1","B1","Not used","B2","status.ERROR_AVAILABLE","status.EAV","Set summary bit indicates that an error or status message is present in the error queue.","Bit B2 decimal value: 4","B3","status.QUESTIONABLE_SUMMARY_BIT","status.QSB","Set summary bit indicates that an enabled questionable event has occurred.","Bit B3 decimal value: 8","B4","status.MESSAGE_AVAILABLE","status.MAV","Set summary bit indicates that a response message is present in the output queue.","Bit B4 decimal value: 16","B5","status.EVENT_SUMMARY_BIT","status.ESB","Set summary bit indicates that an enabled standard event has occurred.","Bit B5 decimal value: 32","B6","status.MASTER_SUMMARY_STATUS","status.MSS","Set bit indicates that an enabled Master Summary Status (MSS) bit of the Status Byte register is set.","Bit B6 decimal value: 64","B7","status.OPERATION_SUMMARY_BIT","status.OSB","Set summary bit indicates that an enabled operation event has occurred.","Bit B7 decimal value: 128","In addition to the above constants, nodeEventRegister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, nodeEventRegister contains the sum of their decimal weights. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example","nodeEventRegister = status.node_event","print(nodeEventRegister)","Reads the status node event register.","Sample output:","1.29000e+02","Converting this output (129) to its binary equivalent yields 1000 0001. Therefore, this output indicates that the set bits of the status byte condition register are presently B0 (MSB) and B7 (OSB).","Also see","Status byte and service request (SRQ)","status.condition","status.system.*","status.node_event","15831.htm");
+Page[383]=new Array("These attributes manage the operation status register set of the status model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","31,769 (All bits set)","Usage","operationRegister = status.operation.condition","operationRegister = status.operation.enable","operationRegister = status.operation.event","operationRegister = status.operation.ntr","operationRegister = status.operation.ptr","status.operation.enable = operationRegister","status.operation.ntr = operationRegister","status.operation.ptr = operationRegister","operationRegister","The status of the operation status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes read or write the operation status registers.","Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 2.04800e+04 (which is 20,480) is read as the value of the condition register, the binary equivalent is 0101 0000 0000 0000. This value indicates that bit B14 (PROGRAM_RUNNING) and bit B12 (USER) are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","1","0","1","0","0","0","0","0","0","0","0","0","0","0","0","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.operation.CALIBRATING","status.operation.CAL","Set bit indicates that the summary bit of the status.operation.calibrating register has been set.","Bit B0 decimal value: 1","B1 to B2","Not used","B3","status.operation.SWEEPING","status.operation.SWE","Set bit indicates that the summary bit from the status.operation.sweeping register is set.","Bit B3 decimal value: 8","B4","status.operation.MEASURING","status.operation.MEAS","Set bit indicates that the summary bit of the status.operation.measuring register is set.","Bit B4 decimal value: 16","B5 to B9","Not used","B10","status.operation.TRIGGER_OVERRUN","status.operation.TRGOVR","Set bit indicates that the summary bit from the status.operation.trigger_overrun register is set.","Bit B10 decimal value: 1,024","B11","status.operation.REMOTE_SUMMARY","status.operation.REM","Set bit indicates that the summary bit of the status.operation.remote register is set. ","Bit B11 decimal value: 2,048","B12","status.operation.USER","Set bit indicates that the summary bit from the status.operation.user register is set.","Bit B12 decimal value: 4,096","B13","status.operation.INSTRUMENT_SUMMARY","status.operation.INST","Set bit indicates that the summary bit from the status.operation.instrument register is set.","Bit B13 decimal value: 8,192","B14","status.operation.PROGRAM_RUNNING","status.operation.PROG","Set bit indicates that a command or program is running.","Bit B14 decimal value: 16,384","B15","Not used","As an example, to set bit B12 of the operation status enable register, set status.operation.enable = status.operation.USER.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B12 and B14, set operationRegister to 20,480 (which is the sum of 4,096 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.USER + status.operation.PROG","status.operation.enable = operationRegister","Uses constants to set the USER and PROG bits of the operation status enable register.","Example 2","-- decimal 20480 = binary 0101 0000 0000 0000","operationRegister = 20480","status.operation.enable = operationRegister","Uses a decimal value to set the USER and PROG bits of the operation status enable register.","Also see","Operation Status Registers","status.operation.*","15833.htm");
+Page[384]=new Array("This attribute contains the operation status calibration summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","operationRegister = status.operation.calibrating.condition","operationRegister = status.operation.calibrating.enable","operationRegister = status.operation.calibrating.event","operationRegister = status.operation.calibrating.ntr","operationRegister = status.operation.calibrating.ptr","status.operation.calibrating.enable = operationRegister","status.operation.calibrating.ntr = operationRegister","status.operation.calibrating.ptr = operationRegister ","operationRegister","The status of the operation calibrating event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings ","Details","These attributes are used to read or write to the operation status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table. ","Bit","Value and description","B0","Not used","B1","status.operation.calibrating.SMUA","Set bit indicates that SMU A is unlocked for calibration.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","Example 1","status.operation.calibrating.enable = status.operation.calibrating.SMUA","Sets the SMUA bit, B1, of the operation status calibration summary enable register using a constant.","Example 2","status.operation.calibrating.enable = 2","Sets the SMUA bit, B1, of the operation status calibration summary enable register using a decimal value.","Also see","Operation Status Registers","status.operation.*","status.operation.calibrating.*","93014.htm");
+Page[385]=new Array("This attribute contains the operation status instrument summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","31,746 (All bits set)","Usage","operationRegister = status.operation.instrument.condition","operationRegister = status.operation.instrument.enable","operationRegister = status.operation.instrument.event","operationRegister = status.operation.instrument.ntr","operationRegister = status.operation.instrument.ptr","status.operation.instrument.enable = operationRegister","status.operation.instrument.ntr = operationRegister","status.operation.instrument.ptr = operationRegister ","operationRegister","The status of the operation event register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1,026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","1","0","0","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.operation.instrument.SMUA","Set bit indicates one or more enabled bits for the operation status SMU A summary register is set.","Bit B1 decimal value: 2","B2 to B9","Not used","B10","status.operation.instrument.TRIGGER_BLENDER","status.operation.instrument.TRGBLND","Set bit indicates one or more enabled bits for the operation status trigger blender summary register is set.","Bit B10 decimal value: 1,024.","B11","status.operation.instrument.TRIGGER_TIMER","status.operation.instrument.TRGTMR","Set bit indicates one or more enabled bits for the operation status trigger timer summary register is set.","Bit B11 decimal value: 2,048","B12","status.operation.instrument.DIGITAL_IO","status.operation.instrument.DIGIO","Set bit indicates one or more enabled bits for the operation status digital I/O summary register is set.","Bit B12 decimal value: 4,096","B13","status.operation.instrument.TSPLINK","Set bit indicates one or more enabled bits for the operation status TSP-Link summary register is set.","Bit B13 decimal value: 8,192","B14","status.operation.instrument.LAN","Set bit indicates one or more enabled bits for the operation status LAN summary register is set.","Bit B14 decimal value: 16,384","B15","Not used","As an example, to set bit B1 of the operation status instrument summary enable register, set status.operation.instrument.enable = status.operation.instrument.SMUA.","In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.instrument.SMUA +"," status.operation.instrument.TRGBLND","status.operation.instrument.enable = operationRegister","Use constants to set bit B1 and bit B10 of the operation status instrument summary enable register. ","Example 2","-- 1026 = binary 0000 0100 0000 0010","operationRegister = 1026","status.operation.instrument.enable = operationRegister","Uses a decimal value to set bit B1 and bit B10 of the operation status instrument summary enable register.","Also see","Operation Status Registers","status.operation.*","Condition register sets of:","• status.operation.instrument.digio.*","• status.operation.instrument.lan.*","• status.operation.instrument.trigger_blender.*","• status.operation.instrument.trigger_timer.*","• status.operation.instrument.tsplink.*","status.operation.instrument.*","93016.htm");
+Page[386]=new Array("This attribute contains the operation status digital I/O summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1024 (All bits set)","Usage","operationRegister = status.operation.instrument.digio.condition","operationRegister = status.operation.instrument.digio.enable","operationRegister = status.operation.instrument.digio.event","operationRegister = status.operation.instrument.digio.ntr","operationRegister = status.operation.instrument.digio.ptr","status.operation.instrument.digio.enable = operationRegister","status.operation.instrument.digio.ntr = operationRegister","status.operation.instrument.digio.ptr = operationRegister ","operationRegister","The status of the operation status digital I/O summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024","Details","These attributes are used to read or write to the operation status digital I/O summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B9","Not used","B10","status.operation.instrument.digio.TRIGGER_OVERRUN","status.operation.instrument.digio.TRGOVR","Set bit indicates an enabled bit in the Operation Status Digital I/O Overrun Register is set.","Bit B10 decimal value: 1,024","Binary value: 0100 0000 0010","B11 to B15","Not used","In addition to the above constant, operationRegister can be set to the decimal value of the bit to set.","Example 1","status.operation.instrument.digio.enable = status.operation.instrument.digio.TRGOVR","Uses a constant to set the TRGOVR bit of the operation status digital I/O summary enable register.","Example 2","status.operation.instrument.digio.enable = 1024","Uses the decimal value to set the TRGOVR bit of the operation status digital I/O summary enable register.","Also see","Operation Status Registers","status.operation.instrument.digio.trigger_overrun.*","status.operation.instrument.digio.*","15836.htm");
+Page[387]=new Array("This attribute contains the operation status digital I/O overrun register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,766 (All bits set)","Usage","operationRegister = status.operation.instrument.digio.trigger_overrun.condition","operationRegister = status.operation.instrument.digio.trigger_overrun.enable","operationRegister = status.operation.instrument.digio.trigger_overrun.event","operationRegister = status.operation.instrument.digio.trigger_overrun.ntr","operationRegister = status.operation.instrument.digio.trigger_overrun.ptr","status.operation.instrument.digio.trigger_overrun.enable = operationRegister","status.operation.instrument.digio.trigger_overrun.ntr = operationRegister","status.operation.instrument.digio.trigger_overrun.ptr = operationRegister","operationRegister","The status of the operation status digio I/O overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status digital I/O overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","1","0","0","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit ","A set bit indicates that the specified digital I/O line generated an action overrun when it was triggered to generate an output trigger.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.operation.instrument.digio.trigger_overrun.LINE1","2","B2","status.operation.instrument.digio.trigger_overrun.LINE2","4","B3","status.operation.instrument.digio.trigger_overrun.LINE3","8","B4","status.operation.instrument.digio.trigger_overrun.LINE4","16","B5","status.operation.instrument.digio.trigger_overrun.LINE5","32","B6","status.operation.instrument.digio.trigger_overrun.LINE6","64","B7","status.operation.instrument.digio.trigger_overrun.LINE7","128","B8","status.operation.instrument.digio.trigger_overrun.LINE8","256","B9","status.operation.instrument.digio.trigger_overrun.LINE9","512","B10","status.operation.instrument.digio.trigger_overrun.LINE10","1,024","B11","status.operation.instrument.digio.trigger_overrun.LINE11","2,048","B12","status.operation.instrument.digio.trigger_overrun.LINE12","4,096","B13","status.operation.instrument.digio.trigger_overrun.LINE13","8,192","B14","status.operation.instrument.digio.trigger_overrun.LINE14","16,384","B15","Not used","Not applicable","As an example, to set bit B1 of the operation status digital I/O overrun enable register, set status.operation.instrument.digio.trigger_overrun.enable = status.operation.instrument.digio.trigger_overrun.LINE1.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.instrument.digio.trigger_overrun.LINE1 +"," status.operation.instrument.digio.trigger_overrun.LINE10","status.operation.instrument.digio.trigger_overrun.enable = operationRegister","Uses constants to set bit B1 and bit B10 of the operation status digital I/O overrun enable register.","Example 2","operationRegister = 1026","status.operation.instrument.digio.trigger_overrun.enable = operationRegister","Uses the decimal value to set bit B1 and bit B10 of the operation status digital I/O overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.digio.*","status.operation.instrument.digio.trigger_overrun.*","15837.htm");
+Page[388]=new Array("This attribute contains the operation status LAN summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1027 (All bits set)","Usage","operationRegister = status.operation.instrument.lan.condition","operationRegister = status.operation.instrument.lan.enable","operationRegister = status.operation.instrument.lan.event","operationRegister = status.operation.instrument.lan.ntr","operationRegister = status.operation.instrument.lan.ptr","status.operation.instrument.lan.enable = operationRegister","status.operation.instrument.lan.ntr = operationRegister","status.operation.instrument.lan.ptr = operationRegister ","operationRegister","The status of the operation status LAN summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status LAN summary registers. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","1","0","0","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.operation.instrument.lan.CONNECTION","status.operation.instrument.lan.CON","Set bit indicates that the LAN cable is connected and a link has been detected.","Bit B0 decimal value: 1","B1","status.operation.instrument.lan.CONFIGURING","status.operation.instrument.lan.CONF","Set bit indicates the LAN is performing its configuration sequence.","Bit B1 decimal value: 2","B2 to B9","Not used","B10","status.operation.instrument.lan.TRIGGER_OVERRUN","status.operation.instrument.lan.TRGOVR","Set bit indicates one or more enabled bits for the operation status LAN trigger overrun register is set.","Bit B10 decimal value: 1,024","B11 to B15","Not used","As an example, to set bit B0 of the operation status LAN summary enable register, set status.operation.instrument.lan.enable = status.operation.instrument.lan.CON.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1024). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.instrument.lan.CONF +"," status.operation.instrument.lan.TRGOVR","status.operation.instrument.lan.enable = operationRegister","Use constants to set bit B1 and bit B10 of the operation status LAN summary enable register.","Example 2","operationRegister = 1026","status.operation.instrument.lan.enable = operationRegister","Use the decimal value to set bit B1 and bit B10 of the operation status LAN summary enable register.","Also see","Operation Status Registers","status.operation.instrument.lan.trigger_overrun.*","status.operation.instrument.lan.*","15838.htm");
+Page[389]=new Array("This attribute contains the operation status LAN trigger overrun register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","510 (All bits set)","Usage","operationRegister = status.operation.instrument.lan.trigger_overrun.condition","operationRegister = status.operation.instrument.lan.trigger_overrun.enable","operationRegister = status.operation.instrument.lan.trigger_overrun.event","operationRegister = status.operation.instrument.lan.trigger_overrun.ntr","operationRegister = status.operation.instrument.lan.trigger_overrun.ptr","status.operation.instrument.lan.trigger_overrun.enable = operationRegister","status.operation.instrument.lan.trigger_overrun.ntr = operationRegister","status.operation.instrument.lan.trigger_overrun.ptr = operationRegister ","operationRegister","The status of the operation status LAN trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status LAN trigger overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 2.58000e+02 (which is 258) is read as the value of the condition register, the binary equivalent is 0000 0001 0000 0010. This value indicates that bit B1 and bit B8 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit ","A set bit indicates that the specified LAN trigger generated an action overrun when triggered to generate a trigger packet.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.operation.instrument.lan.trigger_overrun.LAN1","2","B2","status.operation.instrument.lan.trigger_overrun.LAN2","4","B3","status.operation.instrument.lan.trigger_overrun.LAN3","8","B4","status.operation.instrument.lan.trigger_overrun.LAN4","16","B5","status.operation.instrument.lan.trigger_overrun.LAN5","32","B6","status.operation.instrument.lan.trigger_overrun.LAN6","64","B7","status.operation.instrument.lan.trigger_overrun.LAN7","128","B8","status.operation.instrument.lan.trigger_overrun.LAN8","256","B9 to B15","Not used","Not applicable","As an example, to set bit B1 of the operation status LAN trigger overrun enable register, set status.operation.instrument.lan.trigger_overrun.enable = status.operation.instrument.lan.trigger_overrun.LAN1.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B8, set operationRegister to 258 (which is the sum of 2 + 256).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.instrument.lan.trigger_overrun.LAN1 +"," status.operation.instrument.lan.trigger_overrun.LAN8","status.operation.instrument.lan.trigger_overrun.enable = operationRegister","Use constants to set bit B1 and bit B8 of the operation status LAN trigger overrun enable register.","Example 2","operationRegister = 258","status.operation.instrument.lan.trigger_overrun.enable = operationRegister","Use the decimal value to set bit B1 and bit B8 of the operation status LAN trigger overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.lan.*","status.operation.instrument.lan.trigger_overrun.*","15839.htm");
+Page[390]=new Array("This attribute contains the operation status SMU summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1049 (All bits set)","Usage","operationRegister = status.operation.instrument.smua.condition","operationRegister = status.operation.instrument.smua.enable","operationRegister = status.operation.instrument.smua.event","operationRegister = status.operation.instrument.smua.ntr","operationRegister = status.operation.instrument.smua.ptr","status.operation.instrument.smua.enable = operationRegister","status.operation.instrument.smua.ntr = operationRegister","status.operation.instrument.smua.ptr = operationRegister ","operationRegister","The status of the operation status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02500e+02 (which is 1,025) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B0 and bit B10 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","1","0","0","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.operation.instrument.smua.CALIBRATING","status.operation.instrument.smua.CAL","Set bit indicates that smua is unlocked for calibration.","Bit B0 decimal value: 1","B1 to B2","Not used","B3","status.operation.instrument.smua.SWEEPING","status.operation.instrument.smua.SWE","Set bit indicates that smua is sweeping.","Bit B3 decimal value: 8","B4","status.operation.instrument.smua.MEASURING","status.operation.instrument.smua.MEAS","Bit is set when making an overlapped measurement, but it will not set when taking a normal synchronous measurement.","Bit B4 decimal value: 16","B5 to B9","Not used","B10","status.operation.instrument.smua.TRIGGER_OVERRUN","status.operation.instrument.smua.TRGOVR","Set bit indicates an enabled bit has been set in the operation status smua trigger overrun event register.","Bit B10 decimal value: 1,024","B11 to B15","Not used","As an example, to set bit B0 of the operation status SMU A summary enable register, set status.operation.instrument.smua.enable = status.operation.instrument.smua.CAL.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B0 and B10, set operationRegister to 1,025 (which is the sum of 1 + 1,024). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.operation.instrument.smua.enable = status.operation.instrument.smua.MEAS","Use a constant to set bit B4t of the operation status SMU A summary enable register.","Example 2","status.operation.instrument.smua.enable = 1025","Use the decimal value to set bits B0 and B10 of the operation status SMU A summary enable register.","Also see","Operation Status Registers","status.operation.instrument.smua.trigger_overrrun.*","status.operation.instrument.smua.*","15840.htm");
+Page[391]=new Array("This attribute contains the operation status SMU trigger overrun register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","30 (All bits set)","Usage","operationRegister = status.operation.instrument.smua.trigger_overrun.condition","operationRegister = status.operation.instrument.smua.trigger_overrun.enable","operationRegister = status.operation.instrument.smua.trigger_overrun.event","operationRegister = status.operation.instrument.smua.trigger_overrun.ntr","operationRegister = status.operation.instrument.smua.trigger_overrun.ptr","status.operation.instrument.smua.trigger_overrun.enable = operationRegister","status.operation.instrument.smua.trigger_overrun.ntr = operationRegister","status.operation.instrument.smua.trigger_overrun.ptr = operationRegister ","operationRegister","The status of the operation status SMU trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status SMU trigger overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","0","0","0","1","0","0","1","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.operation.instrument.smua.trigger_overrun.ARM","Set bit indicates that the arm event detector of the SMU was already in the detected state when a trigger was received.","Bit B1 decimal value: 2","B2","status.operation.instrument.smua.trigger_overrun.SRC","Set bit indicates that the source event detector of the SMU was already in the detected state when a trigger was received.","Bit B2 decimal value: 4","B3","status.operation.instrument.smua.trigger_overrun.MEAS","Set bit indicates that the measurement event detector of the SMU was already in the detected state when a trigger was received.","Bit B3 decimal value: 8","B4","status.operation.instrument.smua.trigger_overrun.ENDP","Set bit indicates that the end pulse event detector of the SMU was already in the detected state when a trigger was received.","Bit B4 decimal value: 16","B5 to B15","Not used","As an example, to set bit B1 of the operation status SMU A trigger overrun enable register, set status.operation.instrument.smua.trigger_overrun.enable = status.operation.instrument.smua.trigger_overrun.ARM.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.operation.instrument.smua.trigger_overrun.enable ="," status.operation.instrument.smua.trigger_overrun.ARM","Uses a constant to sets the ARM bit of the operation status SMU A trigger overrun enable register.","Example 2","status.operation.instrument.smua.trigger_overrun.enable = 18","Uses the decimal value to set bits B1 and B4 of the operation status SMU A trigger overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.smua.*","status.operation.instrument.smua.trigger_overrrun.*","15841.htm");
+Page[392]=new Array("This attribute contains the operation status trigger blender summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1024 (All bits set)","Usage","operationRegister = status.operation.instrument.trigger_blender.condition","operationRegister = status.operation.instrument.trigger_blender.enable","operationRegister = status.operation.instrument.trigger_blender.event","operationRegister = status.operation.instrument.trigger_blender.ntr","operationRegister = status.operation.instrument.trigger_blender.ptr","status.operation.instrument.trigger_blender.enable = operationRegister","status.operation.instrument.trigger_blender.ntr = operationRegister","status.operation.instrument.trigger_blender.ptr = operationRegister","operationRegister","The status of the operation status trigger blender summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024","Details","These attributes are used to read or write to the operation status trigger blender summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B9","Not used","B10","status.operation.instrument.trigger_blender.TRIGGER_OVERRUN","status.operation.instrument.trigger_blender.TRGOVR","Set bit indicates one or more enabled bits for operation status trigger blender overrun register is set.","Bit B10 decimal value: 1,024","Binary value: 0100 0000 0000","B11 to B15","Not used","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.","Example","status.operation.instrument.trigger_blender.enable = 1024","Uses a decimal value to set the TRGOVR bit of the operation status trigger blender summary enable.","Also see","Operation Status Registers","status.operation.instrument.trigger_blender.trigger_overrun.*","status.operation.instrument.trigger_blender.*","15842.htm");
+Page[393]=new Array("This attribute contains the operation status trigger blender overrun register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","126 (All bits set)","Usage","operationRegister = "," status.operation.instrument.trigger_blender.trigger_overrun.condition","operationRegister ="," status.operation.instrument.trigger_blender.trigger_overrun.enable","operationRegister ="," status.operation.instrument.trigger_blender.trigger_overrun.event","operationRegister ="," status.operation.instrument.trigger_blender.trigger_overrun.ntr","operationRegister ="," status.operation.instrument.trigger_blender.trigger_overrun.ptr","status.operation.instrument.trigger_blender.trigger_overrun.enable ="," operationRegister","status.operation.instrument.trigger_blender.trigger_overrun.ntr ="," operationRegister","status.operation.instrument.trigger_blender.trigger_overrun.ptr ="," operationRegister ","operationRegister","The status of the operation status trigger blender overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status trigger blender overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","0","0","0","1","0","0","1","0","* Least significant bit ** Most significant bit ","A set bit value indicates that the specified trigger blender generated an action overrun.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.operation.instrument.trigger_blender.trigger_overrun.BLND1","2","B2","status.operation.instrument.trigger_blender.trigger_overrun.BLND2","4","B3","status.operation.instrument.trigger_blender.trigger_overrun.BLND3","8","B4","status.operation.instrument.trigger_blender.trigger_overrun.BLND4","16","B5","status.operation.instrument.trigger_blender.trigger_overrun.BLND5","32","B6","status.operation.instrument.trigger_blender.trigger_overrun.BLND6"," 64","B7 to B15","Not used","Not applicable","As an example, to set bit B1 of the operation status trigger blender overrun enable register, set status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example","status.operation.instrument.trigger_blender.trigger_overrun.enable"," = status.operation.instrument.trigger_blender.trigger_overrun.BLND1","Uses the constant to set the bit for blender 1 of the operation status trigger blender overrun enable register.","Example","status.operation.instrument.trigger_blender.trigger_overrun.enable = 18","Uses the decimal value to set the bits for blenders 1 and 4 of the operation status trigger blender overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.trigger_blender.*","status.operation.instrument.trigger_blender.trigger_overrun.*","29234.htm");
+Page[394]=new Array("This attribute contains the operation status trigger timer summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1024 (All bits set)","Usage","operationRegister = status.operation.instrument.trigger_timer.condition","operationRegister = status.operation.instrument.trigger_timer.enable","operationRegister = status.operation.instrument.trigger_timer.event","operationRegister = status.operation.instrument.trigger_timer.ntr","operationRegister = status.operation.instrument.trigger_timer.ptr","status.operation.instrument.trigger_timer.enable = operationRegister","status.operation.instrument.trigger_timer.ntr = operationRegister","status.operation.instrument.trigger_timer.ptr = operationRegister ","operationRegister","The status of the operation status trigger timer summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024","Details","These attributes are used to read or write to the operation status trigger timer summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B9","Not used","B10","status.operation.instrument.trigger_timer.TRIGGER_OVERRUN","status.operation.instrument.trigger_timer.TRGOVR","Set bit indicates one or more enabled bits for the operation status trigger timer overrun register is set.","Bit B10 decimal value: 1,024","Binary value: 0100 0000 0000","B11 to B15","Not used","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.","Example","status.operation.instrument.trigger_timer.enable = 1024","Uses the decimal value to set the TRGOVR bit of the operation status trigger timer summary enable register.","Also see","Operation Status Registers","status.operation.instrument.trigger_timer.trigger_overrun.*","status.operation.instrument.trigger_timer.*","15844.htm");
+Page[395]=new Array("This attribute contains the operation status trigger timer overrun register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","510 (All bits set)","Usage","operationRegister = "," status.operation.instrument.trigger_timer.trigger_overrun.condition","operationRegister = "," status.operation.instrument.trigger_timer.trigger_overrun.enable","operationRegister = "," status.operation.instrument.trigger_timer.trigger_overrun.event","operationRegister = "," status.operation.instrument.trigger_timer.trigger_overrun.ntr","operationRegister = "," status.operation.instrument.trigger_timer.trigger_overrun.ptr","status.operation.instrument.trigger_timer.trigger_overrun.enable = "," operationRegister","status.operation.instrument.trigger_timer.trigger_overrun.ntr = "," operationRegister","status.operation.instrument.trigger_timer.trigger_overrun.ptr = "," operationRegister ","operationRegister","The status of the operation status trigger timer trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status trigger timer overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 18 is read as the value of the condition register, the binary equivalent is 0000 0000 0001 0010. This value indicates that bit B1 and bit B4 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","0","0","0","1","0","0","1","0","* Least significant bit ** Most significant bit","A set bit indicates the specified timer generated an action overrun because it was still processing a delay from a previous trigger when a new trigger was received.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.operation.instrument.trigger_timer.trigger_overrun.TMR1","2","B2","status.operation.instrument.trigger_timer.trigger_overrun.TMR2","4","B3","status.operation.instrument.trigger_timer.trigger_overrun.TMR3","8","B4","status.operation.instrument.trigger_timer.trigger_overrun.TMR4","16","B5","status.operation.instrument.trigger_timer.trigger_overrun.TMR5","32","B6","status.operation.instrument.trigger_timer.trigger_overrun.TMR6","64","B7","status.operation.instrument.trigger_timer.trigger_overrun.TMR7","128","B8","status.operation.instrument.trigger_timer.trigger_overrun.TMR8","256","B9 to B15","Not used","Not applicable","As an example, to set bit B1 of the operation status trigger timer trigger overrun enable register, set status.operation.instrument.trigger_timer.trigger_overrun.enable = status.operation.instrument.trigger_timer.trigger_overrun.TMR1.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set operationRegister to 18 (which is the sum of 2 + 16). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.operation.instrument.trigger_timer.trigger_overrun.enable ="," status.operation.instrument.trigger_timer.trigger_overrun.TMR3","Uses a constant to set the timer 3 bit of the operation status trigger timer overrun enable register.","Example 2","status.operation.instrument.trigger_timer.trigger_overrun.enable = 18","Uses a constant to set timer bits B1 and B4 of the operation status trigger timer overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.trigger_timer.*","status.operation.instrument.trigger_timer.trigger_overrun.*","15845.htm");
+Page[396]=new Array("This attribute contains the operation status TSP-Link summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","1024 (All bits set)","Usage","operationRegister = status.operation.instrument.tsplink.condition","operationRegister = status.operation.instrument.tsplink.enable","operationRegister = status.operation.instrument.tsplink.event","operationRegister = status.operation.instrument.tsplink.ntr","operationRegister = status.operation.instrument.tsplink.ptr","status.operation.instrument.tsplink.enable = operationRegister","status.operation.instrument.tsplink.ntr = operationRegister","status.operation.instrument.tsplink.ptr = operationRegister ","operationRegister","The status of the operation status TSP-Link summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only valid value other than 0 is 1024","Details","These attributes are used to read or write to the operation status TSP-Link summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B9","Not used","B10","status.operation.instrument.tsplink.TRIGGER_OVERRUN","status.operation.instrument.tsplink.TRGOVR","Set bit indicates one or more enabled bits for the operation status TSP-Link overrun register is set.","Bit B10 decimal value: 1,024","Binary value: 0100 0000 0000","B11 to B15","Not used","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024.","Example","status.operation.instrument.tsplink.enable = 1024","Uses the decimal value to set the trigger overrun bit of the operation status TSP-Link summary enable register.","Also see","Operation Status Registers","status.operation.instrument.tsplink.trigger_overrun.*","status.operation.instrument.tsplink.*","15846.htm");
+Page[397]=new Array("This attribute contains the operation status TSP-Link overrun register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","14 (All bits set)","Usage","operationRegister = "," status.operation.instrument.tsplink.trigger_overrun.condition","operationRegister = status.operation.instrument.tsplink.trigger_overrun.enable","operationRegister = status.operation.instrument.tsplink.trigger_overrun.event","operationRegister = status.operation.instrument.tsplink.trigger_overrun.ntr","operationRegister = status.operation.instrument.tsplink.trigger_overrun.ptr","status.operation.instrument.tsplink.trigger_overrun.enable = operationRegister","status.operation.instrument.tsplink.trigger_overrun.ntr = operationRegister","status.operation.instrument.tsplink.trigger_overrun.ptr = operationRegister ","operationRegister","The status of the operation status TSP-link overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status TSP-link overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 10 is read as the value of the condition register, the binary equivalent is 0000 0000 0000 1010. This value indicates that bit B1 and bit B3 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","0","0","0","0","1","0","1","0","* Least significant bit ** Most significant bit ","A set bit indicates that the specified line generated an action overrun when triggered to generate an output trigger.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.operation.instrument.tsplink.trigger_overrun.LINE1","2","B2","status.operation.instrument.tsplink.trigger_overrun.LINE2","4","B3","status.operation.instrument.tsplink.trigger_overrun.LINE3","8","B4 to B15","Not used","Not applicable","As an example, to set bit B1 of the operation status TSP-Link overrun enable register, set status.operation.instrument.tsplink.trigger_overrun.enable = status.operation.instrument.tsplink.trigger_overrun.LINE1.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B3, set operationRegister to 10 (which is the sum of 2 + 8). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.operation.instrument.tsplink.trigger_overrun.enable ="," status.operation.instrument.tsplink.trigger_overrun.LINE1","Uses a constant to set the line 1 bit of the operation status TSP-Link overrun enable register.","Example 2","status.operation.instrument.tsplink.trigger_overrun.enable = 10","Uses the decimal value to set bits for lines 1 and 3 of the operation status TSP-Link overrun enable register.","Also see","Operation Status Registers","status.operation.instrument.trigger_timer.*","status.operation.instrument.tsplink.trigger_overrun.*","15847.htm");
+Page[398]=new Array("This attribute contains the operation status measuring summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","operationRegister = status.operation.measuring.condition","operationRegister = status.operation.measuring.enable","operationRegister = status.operation.measuring.event","operationRegister = status.operation.measuring.ntr","operationRegister = status.operation.measuring.ptr","status.operation.measuring.enable = operationRegister","status.operation.measuring.ntr = operationRegister","status.operation.measuring.ptr = operationRegister ","operationRegister","The status of the operation status measuring summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid value is 2","Details","These attributes are used to read or write to the operation status measuring summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table. ","Bit","Value and description","B0","Not used","B1","status.operation.measuring.SMUA","Bit is set when SMU A is taking an overlapped measurement, but it is not set when taking a normal synchronous measurement.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","In addition to the above constants, operationRegister can be set to the decimal equivalent of the bit to set.","Example 1","status.operation.measuring.enable = status.operation.measuring.SMUA","Uses the constant to set the SMUA bit, B1, of the operation status measuring summary enable register.","Example 2","status.operation.measuring.enable = 2","Uses the decimal value to set the SMUA bit, B1, of the operation status measuring summary enable register.","Also see","Operation Status Registers","status.operation.*","status.operation.measuring.*","93017.htm");
+Page[399]=new Array("This attribute contains the operation status remote summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2050 (All bits set)","Usage","operationRegister = status.operation.remote.condition","operationRegister = status.operation.remote.enable","operationRegister = status.operation.remote.event","operationRegister = status.operation.remote.ntr","operationRegister = status.operation.remote.ptr","status.operation.remote.enable = operationRegister","status.operation.remote.ntr = operationRegister","status.operation.remote.ptr = operationRegister ","operationRegister","The status of the operation status remote summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status remote summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.operation.remote.COMMAND_AVAILABLE","status.operation.remote.CAV","Set bit indicates there is a command available in the execution queue.","Bit B1 decimal value: 2","Binary value: 0000 0000 0000 0010","B2 to B10","Not used","B11","status.operation.remote.PROMPTS_ENABLED","status.operation.remote.PRMPT","Set bit indicates command prompts are enabled.","Bit B11 decimal value: 2,048","Binary value: 0000 0100 0000 0000","B12 to B15","Not used","As an example, to set bit B1 of the operation status remote summary enable register, set status.operation.remote.enable = status.operation.remote.CAV.","In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B1 and B11, set operationRegister to 2,050 (which is the sum of 2 + 2,048). ","Example 1","status.operation.remote.enable = status.operation.remote.CAV","Uses a constant to set the CAV bit, B1, of the operation status remote summary enable register.","Example 2","status.operation.remote.enable = 2050","Uses the decimal value to set bits B1 and B11 of the operation status remote summary enable register.","Also see","Operation Status Registers","status.operation.*","status.operation.remote.*","15849.htm");
+Page[400]=new Array("This attribute contains the operation status sweeping summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","operationRegister = status.operation.sweeping.condition","operationRegister = status.operation.sweeping.enable","operationRegister = status.operation.sweeping.event","operationRegister = status.operation.sweeping.ntr","operationRegister = status.operation.sweeping.ptr","status.operation.sweeping.enable = operationRegister","status.operation.sweeping.ntr = operationRegister","status.operation.sweeping.ptr = operationRegister ","operationRegister","The status of the operation status sweeping summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status sweeping summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.operation.sweeping.SMUA","Set bit indicates that SMU A is sweeping.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the operation status sweeping summary enable register, set status.operation.sweeping.enable = status.operation.sweeping.SMUA.","In addition to the above constants, operationRegister can be set to 2, the decimal value of Bit 1.","Example","status.operation.sweeping.enable = status.operation.sweeping.SMUA","Uses a constant to set the SMUA bit of the operation status sweeping summary enable register.","Also see","Operation Status Registers","status.operation.*","status.operation.sweeping.*","93038.htm");
+Page[401]=new Array("This attribute contains the operation status trigger overrun summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","31,746 (All bits set)","Usage","operationRegister = status.operation.trigger_overrun.condition","operationRegister = status.operation.trigger_overrun.enable","operationRegister = status.operation.trigger_overrun.event","operationRegister = status.operation.trigger_overrun.ntr","operationRegister = status.operation.trigger_overrun.ptr","status.operation.trigger_overrun.enable = operationRegister","status.operation.trigger_overrun.ntr = operationRegister","status.operation.trigger_overrun.ptr = operationRegister ","operationRegister","The status of the operation status trigger overrun summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status trigger overrun summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.02600e+03 (which is 1,026) is read as the value of the condition register, the binary equivalent is 0000 0100 0000 0010. This value indicates that bit B1 and bit B10 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","1","0","0","0","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit","The bits in this register summarize events in other registers. A set bit in this summary register indicates that an enabled event in one of the summarized registers is set.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.operation.trigger_overrun.SMUA","Set bit indicates one of the enabled bits in the operation status SMU A trigger overrun event register is set.","Bit B1 decimal value: 2","B2 to B9","Not used","B10","status.operation.trigger_overrun.TRIGGER_BLENDER","status.operation.trigger_overrun.TRGBLND","Set bit indicates one of the enabled bits in the operation status trigger blender overrun event register is set.","Bit B10 decimal value: 1,024","B11","status.operation.trigger_overrun.TRIGGER_TIMER","status.operation.trigger_overrun.TRGTMR","Set bit indicates one of the enabled bits in the operation status trigger timer overrun event register is set.","Bit B11 decimal value: 2,048","B12","status.operation.trigger_overrun.DIGITAL_IO","status.operation.trigger_overrun.DIGIO","Set bit indicates one of the enabled bits in the operation status digital I/O overrun event register is set.","Bit B12 decimal value: 4,096","B13","status.operation.trigger_overrun.TSPLINK","Set bit indicates one of the enabled bits in the operation status TSP-Link overrun event register is set.","Bit B13 decimal value: 8,192","B14","status.operation.trigger_overrun.LAN","Set bit indicates one of the enabled bits in the operation status LAN trigger overrun event register is set.","Bit B14 decimal value: 16,384","B15","Not used","As an example, to set bit B1 of the operation status trigger overrun summary enable register, set status.operation.trigger_overrun.enable = status.operation.trigger_overrun.SMUA.","In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights. For example, to set bits B1 and B10, set operationRegister to 1,026 (which is the sum of 2 + 1,024).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.trigger_overrun.SMUA + status.operation.trigger_overrun.TRGBLND","status.operation.trigger_overrun.enable = operationRegister","Uses constants to set bits B1 and bit B10 of the operation status trigger overrun summary enable register.","Example 2","operationRegister = 1026","status.operation.trigger_overrun.enable = operationRegister","Uses the decimal value to set bits B1 and bit B10 of the operation status trigger overrun summary enable register.","Also see","Operation Status Registers","status.operation.*","status.operation.trigger_overrun.*","93037.htm");
+Page[402]=new Array("These attributes manage the operation status user register set of the status model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (RW)","Yes","Status reset","Not saved","0",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,767 (All bits set)","Usage","operationRegister = status.operation.user.condition","operationRegister = status.operation.user.enable","operationRegister = status.operation.user.event","operationRegister = status.operation.user.ntr","operationRegister = status.operation.user.ptr","status.operation.user.condition = operationRegister","status.operation.user.enable = operationRegister","status.operation.user.ntr = operationRegister","status.operation.user.ptr = operationRegister","operationRegister","The status of the operation status user register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bits B0 and B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","status.operation.user.BIT0","1","B1","status.operation.user.BIT1","2","B2","status.operation.user.BIT2","4","B3","status.operation.user.BIT3","8","B4","status.operation.user.BIT4","16","B5","status.operation.user.BIT5","32","B6","status.operation.user.BIT6","64","B7","status.operation.user.BIT7","128","B8","status.operation.user.BIT8","256","B9","status.operation.user.BIT9","512","B10","status.operation.user.BIT10","1,024","B11","status.operation.user.BIT11","2,048","B12","status.operation.user.BIT12","4,096","B13","status.operation.user.BIT13","8,192","B14","status.operation.user.BIT14","16,384","B15","Not used","Not applicable","As an example, to set bit B0 of the operation status user enable register, set status.operation.user.enable = status.operation.user.BIT0.","In addition to the above constants, operationRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values. For example, to set bits B11 and B14, set operationRegister to 18,432 (which is the sum of 2,048 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","operationRegister = status.operation.user.BIT11 + status.operation.user.BIT14","status.operation.user.enable = operationRegister","Uses constants to set bits B11 and B14 of the operation status user enable register.","Example 2","-- 18432 = binary 0100 1000 0000 0000","operationRegister = 18432","status.operation.enable = operationRegister","Uses the decimal value to set bits B11 and B14 of the operation status user enable register.","Also see","Operation Status Registers","status.operation.*","status.operation.user.*","15852.htm");
+Page[403]=new Array("These attributes manage the questionable status register set of the status model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","13,056 (All bits set)","Usage","questionableRegister = status.questionable.condition","questionableRegister = status.questionable.enable","questionableRegister = status.questionable.event","questionableRegister = status.questionable.ntr","questionableRegister = status.questionable.ptr","status.questionable.enable = questionableRegister","status.questionable.ntr = questionableRegister","status.questionable.ptr = questionableRegister","questionableRegister","The status of the questionable status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.22880e+04 (which is 12,288) is read as the value of the condition register, the binary equivalent is 0011 0000 0000 0000. This value indicates that bits B12 and B13 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","1","1","0","0","0","0","0","0","0","0","0","0","0","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B7","Not used","B8","status.questionable.CALIBRATION","status.questionable.CAL","An enabled bit in the questionable status calibration summary event register is set.","Bit B6 decimal value: 256","B9","status.questionable.UNSTABLE_OUTPUT","status.questionable.UO","An enabled bit in the questionable status unstable output summary event register is set.","Bit B9 decimal value: 512","B10","Not used","B11","Not used","B12","status.questionable.OVER_TEMPERATURE","status.questionable.OTEMP","An enabled bit in the questionable status over temperature summary event register is set.","Bit B12 decimal value: 4,096","B13","status.questionable.INSTRUMENT_SUMMARY","status.questionable.INST","An enabled bit in the questionable status instrument summary event register is set.","Bit B13 decimal value: 8,192","B14 to B15","Not used","As an example, to set bit B9 of the questionable status enable register, set status.questionable.enable = status.questionable.UO.","In addition to the above constants, questionableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal values. For example, to set bits B12 and B13, set questionableRegister to 12,288 (which is the sum of 4,096 + 8,192).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","status.questionable.enable = status.questionable.OTEMP","Uses a constant to set the OTEMP bit of the questionable status enable register.","Example 2","status.questionable.enable = 12288","Uses the decimal value to set the B12 and B13 bits of the questionable status enable register.","Also see","Questionable Status Registers","status.questionable.*","92683.htm");
+Page[404]=new Array("This attribute contains the questionable status calibration summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","questionableRegister = status.questionable.calibration.condition","questionableRegister = status.questionable.calibration.enable","questionableRegister = status.questionable.calibration.event","questionableRegister = status.questionable.calibration.ntr","questionableRegister = status.questionable.calibration.ptr","status.questionable.calibration.enable = questionableRegister","status.questionable.calibration.ntr = questionableRegister","status.questionable.calibration.ptr = questionableRegister ","questionableRegister","The status of the questionable status calibration summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the questionable status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table. ","Bit","Value and description","B0","Not used","B1","status.questionable.calibration.SMUA","Set bit indicates that the SMU A calibration constants stored in nonvolatile memory were corrupted and could not be loaded when the instrument powered up.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the questionable status calibration summary enable register, set status.questionable.calibration.enable = status.questionable.calibration.SMUA.","In addition to the above constants, questionableRegister can be set to 2, the decimal value of the B1 bit.","Example","status.questionable.calibration.enable = status.questionable.calibration.SMUA","Uses a constant to set the SMUA bit of the questionable status calibration summary enable register.","Also see","Questionable Status Registers","status.questionable.*","status.questionable.calibration.*","93035.htm");
+Page[405]=new Array("This attribute contains the questionable status instrument summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","questionableRegister = status.questionable.instrument.condition","questionableRegister = status.questionable.instrument.enable","questionableRegister = status.questionable.instrument.event","questionableRegister = status.questionable.instrument.ntr","questionableRegister = status.questionable.instrument.ptr","status.questionable.instrument.enable = questionableRegister","status.questionable.instrument.ntr = questionableRegister","status.questionable.instrument.ptr = questionableRegister ","questionableRegister","The status of the questionable status instrument summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid setting is 2","Details","These attributes are used to read or write to the questionable status instrument summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bit is set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.questionable.instrument.SMUA","Set bit indicates one or more enabled bits for the SMU A questionable register are set.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the questionable status instrument summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA.","In addition to the constant, questionableRegister can be set to the decimal value of the bit.","Example","status.questionable.instrument.enable = status.questionable.instrument.SMUA","Uses a constant to set the SMUA bit of the questionable status instrument summary enable register.","Also see","Questionable Status Registers","status.questionable.*","status.questionable.instrument.*","93000.htm");
+Page[406]=new Array("This attribute contains the questionable status SMU A summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","—","—","—","—",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","4864 (All bits set)","Usage","questionableRegister = status.questionable.instrument.smua.condition","questionableRegister = status.questionable.instrument.smua.enable","questionableRegister = status.questionable.instrument.smua.event","questionableRegister = status.questionable.instrument.smua.ntr","questionableRegister = status.questionable.instrument.smua.ptr","status.questionable.instrument.smua.enable = questionableRegister","status.questionable.instrument.smua.ntr = questionableRegister","status.questionable.instrument.smua.ptr = questionableRegister ","questionableRegister","The status of the questionable status SMU summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the questionable status instrument SMU summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 7.68000e+02 (which is 768) is read as the value of the condition register, the binary equivalent is 0000 0011 0000 0000. This value indicates that bit B8 and bit B9 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","1","1","0","0","0","0","0","0","0","0","* Least significant bit ** Most significant bit ","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0 to B7","Not used","B8","status.questionable.instrument.smua.CALIBRATION","status.questionable.instrument.smua.CAL","Set bit indicates that the calibration constants stored in nonvolatile memory were corrupted and could not be loaded when the instrument powered up.","Bit B8 decimal value: 256","B9","status.questionable.instrument.smua.UNSTABLE_OUTPUT","status.questionable.instrument.smua.UO","Set bit indicates that an unstable output condition was detected.","Bit B9 decimal value: 512","B10 to B11","Not used","B12","status.questionable.instrument.smua.OVER_TEMPERATURE","status.questionable.instrument.smua.OTEMP","Set bit indicates that an over temperature condition was detected.","Bit B12 decimal value: 4,096","B13 to B15","Not used","As an example, to set bit B8 of the questionable status SMU A summary enable register, set status.questionable.instrument.smua.enable = status.questionable.instrument.smua.CAL.","In addition to the above constants, questionableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set questionableRegister to the sum of their decimal values. For example, to set bits B8 and B9, set questionableRegister to 768 (which is the sum of 256 + 512).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example","questionableRegister = status.questionable.instrument.smua.CAL +"," status.questionable.instrument.smua.UO","status.questionable.instrument.smua.enable = questionableRegister","Uses constants to set bits B8 and bit B9 of the questionable status SMU A summary enable register.","Example","questionableRegister = 768","status.questionable.instrument.smua.enable = questionableRegister","Uses the decimal value to set bits B8 and bit B9 of the questionable status SMU A summary enable register.","Also see","Questionable Status Registers","status.operation.*","status.questionable.instrument.smua.*","92697.htm");
+Page[407]=new Array("This attribute contains the questionable status over temperature summary register set. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","questionableRegister = status.questionable.over_temperature.condition","questionableRegister = status.questionable.over_temperature.enable","questionableRegister = status.questionable.over_temperature.event","questionableRegister = status.questionable.over_temperature.ntr","questionableRegister = status.questionable.over_temperature.ptr","status.questionable.over_temperature.enable = questionableRegister","status.questionable.over_temperature.ntr = questionableRegister","status.questionable.over_temperature.ptr = questionableRegister ","operationRegister","The status of the questionable status over temperature summary register; a zero (0) indicates no bits set (also send 0 to clear all bits)","Details","These attributes are used to read or write to the questionable status over temperature summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates if a register bit is set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","B0","Not used","B1","status.questionable.over_temperature.SMUA","Set bit indicates that an over temperature condition was detected on SMU A.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the questionable status over temperature summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA. You can also set the bit to its decimal value.","Example","status.questionable.over_temperature.enable = status.questionable.over_temperature.SMUA","Uses the constant to set the SMU A over temperature summary enable bit of the questionable status register.","Also see","Questionable Status Registers","status.questionable.*","status.questionable.over_temperature.*","92999.htm");
+Page[408]=new Array("This attribute contains the questionable status unstable output summary register set.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","2 (All bits set)","Usage","questionableRegister = status.questionable.unstable_output.condition","questionableRegister = status.questionable.unstable_output.enable","questionableRegister = status.questionable.unstable_output.event","questionableRegister = status.questionable.unstable_output.ntr","questionableRegister = status.questionable.unstable_output.ptr","status.questionable.unstable_output.enable = questionableRegister","status.questionable.unstable_output.ntr = questionableRegister","status.questionable.unstable_output.ptr = questionableRegister ","operationRegister","The status of the questionable status unstable output summary register; a zero (0) indicates no bits set (also send 0 to clear all bits); the only other valid value is 2","Details","These attributes are used to read or write to the questionable status unstable output summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","Not used","B1","status.questionable.unstable_output.SMUA","Set bit indicates that an unstable output condition was detected on SMU A.","Bit B1 decimal value: 2","Binary value: 0000 0010","B2 to B15","Not used","As an example, to set bit B1 of the questionable status unstable output summary enable register, set status.questionable.instrument.enable = status.questionable.instrument.SMUA.","In addition to the above constant, questionableRegister can be set to the decimal value of the bit to set.","Example","status.questionable.unstable_output.enable = status.questionable.unstable_output.SMUA","Uses the constant to set the SMU A bit in the questionable status unstable output summary enable register bit.","Also see","Questionable Status Registers","status.questionable.*","status.questionable.unstable_output.*","92998.htm");
+Page[409]=new Array("This attribute stores the service request (SRQ) enable register.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Status reset","Not saved","0","Usage","requestSRQEnableRegister = status.request_enable","status.request_enable = requestSRQEnableRegister","requestSRQEnableRegister","The status of the service request (SRQ) enable register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","This attribute is used to read or write to the service request enable register. Reading the service request enable register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">","*","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.MEASUREMENT_SUMMARY_BIT","status.MSB","Set summary bit indicates that an enabled event in the Measurement Event Register has occurred.","Bit B0 decimal value: 1","B1","status.SYSTEM_SUMMARY_BIT","status.SSB","Set summary bit indicates that an enabled event in the System Summary Register has occurred.","Bit B1 decimal value: 2","B2","status.ERROR_AVAILABLE","status.EAV","Set summary bit indicates that an error or status message is present in the error queue.","Bit B2 decimal value: 4","B3","status.QUESTIONABLE_SUMMARY_BIT","status.QSB","Set summary bit indicates that an enabled event in the Questionable Status Register has occurred.","Bit B3 decimal value: 8","B4","status.MESSAGE_AVAILABLE","status.MAV","Set summary bit indicates that a response message is present in the output queue.","Bit B4 decimal value: 16","B5","status.EVENT_SUMMARY_BIT","status.ESB","Set summary bit indicates that an enabled event in the Standard Event Status Register has occurred.","Bit B5 decimal value: 32","B6","Not used","B7","status.OPERATION_SUMMARY_BIT","status.OSB","Set summary bit indicates that an enabled event in the Operation Status Register has occurred.","Bit B7 decimal value: 128","As an example, to set bit B0 of the service request enable register, set status.request_enable = status.MSB.","In addition to the above values, requestSRQEnableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set requestSRQEnableRegister to the sum of their decimal values. For example, to set bits B0 and B7, set requestSRQEnableRegister to 129 (1 + 128).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example 1","requestSRQEnableRegister = status.MSB + status.OSB","status.request_enable = requestSRQEnableRegister","Uses constants to set the MSB and OSB bits of the service request (SRQ) enable register.","Example 2","-- decimal 129 = binary 10000001","requestSRQEnableRegister = 129","status.request_enable = requestSRQEnableRegister","Uses the decimal value to set the MSB and OSB bits of the service request (SRQ) enable register.","Also see","Status byte and service request (SRQ)","status.condition","status.system.*","status.request_enable","92663.htm");
+Page[410]=new Array("This attribute stores the service request (SRQ) event register.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not saved","0","Usage","requestSRQEventRegister = status.request_event","requestSRQEventRegister","The status of the request event register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","This attribute is used to read the service request event register, which is returned as a numeric value. Reading this register returns a value. The binary equivalent of the value of this attribute indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B7. For example, if a value of 1.29000e+02 (which is 129) is read as the value of this register, the binary equivalent is 1000 0001. This value indicates that bit B0 and bit B7 are set.","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">","*","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","The returned value can indicate one or more status events occurred.","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value and description","B0","status.MEASUREMENT_SUMMARY_BIT","status.MSB","Set summary bit indicates that an enabled event in the Measurement Event Register has occurred.","Bit B0 decimal value: 1","B1","status.SYSTEM_SUMMARY_BIT","status.SSB","Set summary bit indicates that an enabled event in the System Summary Register has occurred. ","Bit B1 decimal value: 2","B2","status.ERROR_AVAILABLE","status.EAV","Set summary bit indicates that an error or status message is present in the error queue.","Bit B2 decimal value: 4","B3","status.QUESTIONABLE_SUMMARY_BIT","status.QSB","Set summary bit indicates that an enabled event in the Questionable Status Register has occurred.","Bit B3 decimal value: 8","B4","status.MESSAGE_AVAILABLE","status.MAV","Set summary bit indicates that a response message is present in the output queue.","Bit B4 decimal value: 16","B5","status.EVENT_SUMMARY_BIT","status.ESB","Set summary bit indicates that an enabled event in the Standard Event Status Register has occurred.","Bit B5 decimal value: 32","B6","Not used","B7","status.OPERATION_SUMMARY_BIT","status.OSB","Set summary bit indicates that an enabled event in the Operation Status Register has occurred.","Bit B7 decimal value: 128","In addition to the above constants, requestEventRegister can be set to the decimal value of the bits set. When more than one bit of the register is set, requestEventRegister contains the sum of their decimal values. For example, if 129 is returned, bits B0 and B7 are set (1 + 128).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example","requestEventRegister = status.request_event","print(requestEventRegister)","Reads the status request event register.","Sample output:","1.29000e+02","Converting this output (129) to its binary equivalent yields 1000 0001.","Therefore, this output indicates that the set bits of the status request event register are presently B0 (MSB) and B7 (OSB).","Also see","status.condition","status.system.*","Status byte and service request (SRQ)","status.request_event","92664.htm");
+Page[411]=new Array("This function resets all bits in the status model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","status.reset()","Details","This function clears all status data structure registers (enable, event, NTR, and PTR) to their default values. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers.","Example","status.reset()","Resets the instrument status model.","Also see","Status model","status.reset()","15861.htm");
+Page[412]=new Array("These attributes manage the standard event status register set of the status model.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","253 (All bits set)","Usage","standardRegister = status.standard.condition","standardRegister = status.standard.enable","standardRegister = status.standard.event","standardRegister = status.standard.ntr","standardRegister = status.standard.ptr","status.standard.enable = standardRegister","status.standard.ntr = standardRegister","status.standard.ptr = standardRegister","standardRegister","The status of the standard event status register; a zero (0) indicates no bits set (also send 0 to clear all bits); other values indicate various bit settings","Details","These attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set. The least significant bit of the binary number is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","B0","status.standard.OPERATION_COMPLETE","status.standard.OPC","Set bit indicates that all pending selected instrument operations are completed and the instrument is ready to accept new commands. The bit is set in response to an *OPC command. The opc() function can be used in place of the *OPC command.","Bit B0 decimal value: 1","B1","Not used","B2","status.standard.QUERY_ERROR","status.standard.QYE","Set bit indicates that you attempted to read data from an empty Output Queue.","Bit B2 decimal value: 4","B3","status.standard.DEVICE_DEPENDENT_ERROR","status.standard.DDE","Set bit indicates that an instrument operation did not execute properly due to some internal condition. ","Bit B3 decimal value: 8","B4","status.standard.EXECUTION_ERROR","status.standard.EXE","Set bit indicates that the instrument detected an error while trying to execute a command.","Bit B4 decimal value: 16","B5","status.standard.COMMAND_ERROR","status.standard.CME","Set bit indicates that a command error has occurred. Command errors include:","IEEE Std 488.2 syntax error: Instrument received a message that does not follow the defined syntax of the IEEE Std 488.2 standard.","Semantic error: Instrument received a command that was misspelled or received an optional IEEE Std 488.2 command that is not implemented.","GET error: The instrument received a Group Execute Trigger (GET) inside a program message.","Bit B5 decimal value: 32","B6","status.standard.USER_REQUEST","status.standard.URQ","Set bit indicates that the LOCAL key on the instrument front panel was pressed.","Bit B6 decimal value: 64","B7","status.standard.POWER_ON","status.standard.PON","Set bit indicates that the instrument has been turned off and turned back on since the last time this register has been read.","Bit B7 decimal value: 128","B8 to B15","Not used","As an example, to set bit B0 of the standard event status enable register, set status.standard.enable = status.standard.OPC.","In addition to the above constants, standardRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set standardRegister to the sum of their decimal weights. For example, to set bits B0 and B4, set standardRegister to 17 (which is the sum of 1 + 16).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Example 1","standardRegister = status.standard.OPC + status.standard.EXE","status.standard.enable = standardRegister","Uses constants to set the OPC and EXE bits of the standard event status enable register.","Example 2","-- decimal 17 = binary 0001 0001","standardRegister = 17","status.standard.enable = standardRegister","Uses the decimal value to set the OPC and EXE bits of the standard event status enable register.","Also see","Standard Event Register ","status.standard.*","15862.htm");
+Page[413]=new Array("These attributes manage the TSP-Link® system summary register of the status model for nodes 1 through 14. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,767 (All bits set)","Usage","enableRegister = status.system.condition","enableRegister = status.system.enable","enableRegister = status.system.event","enableRegister = status.system.ntr","enableRegister = status.system.ptr","status.system.enable = enableRegister","status.system.ntr = enableRegister","status.system.ptr = enableRegister","enableRegister","The status of the system summary register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","status.system.EXTENSION_BIT","status.system.EXT","1","B1","status.system.NODE1","2","B2","status.system.NODE2","4","B3","status.system.NODE3","8","B4","status.system.NODE4","16","B5","status.system.NODE5","32","B6","status.system.NODE6","64","B7","status.system.NODE7","128","B8","status.system.NODE8","256","B9","status.system.NODE9","512","B10","status.system.NODE10","1,024","B11","status.system.NODE11","2,048","B12","status.system.NODE12","4,096","B13","status.system.NODE13","8,192","B14","status.system.NODE14","16,384","B15","Not used","Not applicable","As an example, to set bit B0 of the system summary status enable register, set status.system.enable = status.system.enable.EXT.","In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","enableRegister = status.system.NODE11 + status.system.NODE14","status.system.enable = enableRegister","Uses constants to set bits B11 and B14 of the system summary enable register.","Example 2","-- decimal 18432 = binary 0100 1000 0000 0000","enableRegister = 18432","status.system.enable = enableRegister","Uses the decimal value to set bits B11 and B14 of the system summary enable register.","Also see","status.system2.*","System summary and standard event registers","status.system.*","15863.htm");
+Page[414]=new Array("These attributes manage the TSP-Link® system summary register of the status model for nodes 15 through 28. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,767 (All bits set)","Usage","enableRegister = status.system2.condition","enableRegister = status.system2.enable","enableRegister = status.system2.event","enableRegister = status.system2.ntr","enableRegister = status.system2.ptr","status.system2.enable = enableRegister","status.system2.ntr = enableRegister","status.system2.ptr = enableRegister","enableRegister","The status of the system summary 2 register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","status.system2.EXTENSION_BIT","status.system2.EXT","1","B1","status.system2.NODE15","2","B2","status.system2.NODE16","4","B3","status.system2.NODE17","8","B4","status.system2.NODE18","16","B5","status.system2.NODE19","32","B6","status.system2.NODE20","64","B7","status.system2.NODE21","128","B8","status.system2.NODE22","256","B9","status.system2.NODE23","512","B10","status.system2.NODE24","1,024","B11","status.system2.NODE25","2,048","B12","status.system2.NODE26","4,096","B13","status.system2.NODE27","8,192","B14","status.system2.NODE28","16,384","B15","Not used","Not applicable","As an example, to set bit B0 of the system summary 2 enable register, set status.system2.enable = status.system2.EXT.","In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","enableRegister = status.system2.NODE25 + status.system2.NODE28","status.system2.enable = enableRegister ","Uses constants to set bits B11 and B14 of the system summary 2 enable register.","Example 2","-- decimal 18432 = binary 0100 1000 0000 0000","enableRegister = 18432","status.system2.enable = enableRegister","Uses the decimal value to set bits B11 and B14 of the system summary 2 enable register.","Also see","status.system.*","status.system3.*","System summary and standard event registers","status.system2.*","15864.htm");
+Page[415]=new Array("These attributes manage the TSP-Link® system summary register of the status model for nodes 29 through 42. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,767 (All bits set)","Usage","enableRegister = status.system3.condition","enableRegister = status.system3.enable","enableRegister = status.system3.event","enableRegister = status.system3.ntr","enableRegister = status.system3.ptr","status.system3.enable = enableRegister","status.system3.ntr = enableRegister","status.system3.ptr = enableRegister","enableRegister","The status of the system summary 3 register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0 and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","status.system3.EXTENSION_BIT","status.system3.EXT","1","B1","status.system3.NODE29","2","B2","status.system3.NODE30","4","B3","status.system3.NODE31","8","B4","status.system3.NODE32","16","B5","status.system3.NODE33","32","B6","status.system3.NODE34","64","B7","status.system3.NODE35","128","B8","status.system3.NODE36","256","B9","status.system3.NODE37","512","B10","status.system3.NODE38","1,024","B11","status.system3.NODE39","2,048","B12","status.system3.NODE40","4,096","B13","status.system3.NODE41","8,192","B14","status.system3.NODE42","16,384","B15","Not used","Not applicable","As an example, to set bit B0 of the system summary 3 enable register, set status.system3.enable = status.system3.EXT.","In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","enableRegister = status.system3.NODE39 + status.system3.NODE42","status.system3.enable = enableRegister","Uses constants to set bits B11 and B14 of the system summary 3 enable register.","Example 2","-- decimal 18432 = binary 0100 1000 0000 0000","enableRegister = 18432","status.system3.enable = enableRegister","Uses the decimal value to set bits B11 and B14 of the system summary 3 enable register.","Also see","status.system2.*","status.system4.*","System summary and standard event registers","status.system3.*","15865.htm");
+Page[416]=new Array("These attributes manage the TSP-Link® system summary register of the status model for nodes 43 through 56. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","32,767 (All bits set)","Usage","enableRegister = status.system4.condition","enableRegister = status.system4.enable","enableRegister = status.system4.event","enableRegister = status.system4.ntr","enableRegister = status.system4.ptr","status.system4.enable = enableRegister","status.system4.ntr = enableRegister","status.system4.ptr = enableRegister","enableRegister","The status of the system summary 4 register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.29000e+02 (which is 129) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0001. This value indicates that bit B0 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","0","1","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","status.system4.EXTENSION_BIT","status.system4.EXT","1","B1","status.system4.NODE43","2","B2","status.system4.NODE44","4","B3","status.system4.NODE45","8","B4","status.system4.NODE46","16","B5","status.system4.NODE47","32","B6","status.system4.NODE48","64","B7","status.system4.NODE49","128","B8","status.system4.NODE50","256","B9","status.system4.NODE51","512","B10","status.system4.NODE52","1,024","B11","status.system4.NODE53","2,048","B12","status.system4.NODE54","4,096","B13","status.system4.NODE55","8,192","B14","status.system4.NODE56","16,384","B15","Not used","Not applicable","As an example, to set bit B0 of the system summary 4 enable register, set status.system4.enable = status.system4.enable.EXT.","In addition to the above constants, enableRegister can be set to the decimal value of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal values. For example, to set bits B11 and B14, set enableRegister to 18,432 (which is the sum of 2,048 + 16,384). ","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","enableRegister = status.system4.NODE53 + status.system4.NODE56","status.system2.enable = enableRegister ","Uses constants to set bit B11 and bit B14 of the system summary 4 enable register.","Example 2","-- decimal 18432 = binary 0100 1000 0000 0000","enableRegister = 18432","status.system4.enable = enableRegister","Uses a decimal value to set bit B11 and bit B14 of the system summary 4 enable register.","Also see","status.system3.*","status.system5.*","System summary and standard event registers","status.system4.*","15866.htm");
+Page[417]=new Array("These attributes manage the TSP-Link® system summary register of the status model for nodes 57 through 64. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute","- -","- -","- -","- -",".condition (R)","Yes","Not applicable","Not saved","Not applicable",".enable (RW)","Yes","Status reset","Not saved","0",".event (R)","Yes","Status reset","Not saved","0",".ntr (RW)","Yes","Status reset","Not saved","0",".ptr (RW)","Yes","Status reset","Not saved","510 (All bits set)","Usage","enableRegister = status.system5.condition","enableRegister = status.system5.enable","enableRegister = status.system5.event","enableRegister = status.system5.ntr","enableRegister = status.system5.ptr","status.system5.enable = enableRegister","status.system5.ntr = enableRegister","status.system5.ptr = enableRegister","enableRegister","The status of the system summary 5 register; a zero (0) indicates no bits set; other values indicate various bit settings","Details","In an expanded system (TSP-Link), these attributes are used to read or write to the system summary registers. They are set using a constant or a numeric value, but are returned as a numeric value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15. For example, if a value of 1.30000e+02 (which is 130) is read as the value of the condition register, the binary equivalent is 0000 0000 1000 0010. This value indicates that bit B1 and bit B7 are set.","B15","B14","B13","B12","B11","B10","B9","B8","B7","B6","B5","B4","B3","B2","B1","B0","**",">",">",">",">",">",">",">",">",">",">",">",">",">",">","*","0","0","0","0","0","0","0","0","1","0","0","0","0","0","1","0","* Least significant bit ** Most significant bit","For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents and Enable and transition registers. The individual bits of this register are defined in the following table.","Bit","Value","Decimal value","B0","Not used","Not applicable","B1","status.system5.NODE57","2","B2","status.system5.NODE58","4","B3","status.system5.NODE59","8","B4","status.system5.NODE60","16","B5","status.system5.NODE61","32","B6","status.system5.NODE62","64","B7","status.system5.NODE63","128","B8","status.system5.NODE64","256","B9 to B15","Not used","Not applicable","As an example, to set bit B1 of the system summary 5 enable register, set status.system5.enable = status.system5.NODE57.","In addition to the above constants, enableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set enableRegister to the sum of their decimal weights. For example, to set bits B1 and B4, set enableRegister to 18 (which is the sum of 2 + 16).","Bit","B7","B6","B5","B4","B3","B2","B1","B0","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","128","64","32","16","8","4","2","1","Weights","(27)","(26)","(25)","(24)","(23)","(22)","(21)","(20)","Bit","B15","B14","B13","B12","B11","B10","B9","B8","Binary value","0/1","0/1","0/1","0/1","0/1","0/1","0/1","0/1","Decimal","32,768","16,384","8,192","4,096","2,048","1,024","512","256","Weights","(215)","(214)","(213)","(212)","(211)","(210)","(29)","(28)","Example 1","enableRegister = status.system5.NODE57 + status.system5.NODE60","status.system2.enable = enableRegister ","Uses constants to set bits B1 and B4 of the system summary 5 enable register.","Example 2","-- decimal 18 = binary 0000 0000 0001 0010","enableRegister = 18","status.system5.enable = enableRegister","Uses the decimal value to set bits B1 and B4 of the system summary 5 enable register.","Also see","status.system4.*","System summary and standard event registers","status.system5.*","15867.htm");
+Page[418]=new Array("This KISweep factory script function performs a linear current sweep with voltage measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepILinMeasureV(smua, starti, stopi, stime, points)","starti","Sweep start current in amperes","stopi","Sweep stop current in amperes","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³2)","Details","Data for voltage measurements, current source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a linear current sweep with voltage measured at every step (point):","Sets the SMU to output starti amperes, allows the source to settle for stime seconds, and then makes a voltage measurement.","Sets the SMU to output the next amperes step, allows the source to settle for stime seconds, and then makes a voltage measurement.","Repeats the above sequence until the voltage is measured on the stopi amperes step.","The linear step size is automatically calculated as follows:","step = (stopi – starti) / (points – 1)","Example","SweepILinMeasureV(smua, -1e-3, 1e-3, 0, 100)","This function performs a 100-point linear current sweep starting at -1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep. Because stime is set for 0 s, voltage is measured as quickly as possible after each current step.","Also see","KISweep factory script","SweepILinMeasureV()","12177.htm");
+Page[419]=new Array("This KISweep factory script function performs a current list sweep with voltage measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepIListMeasureV(smua, ilist, stime, points)","ilist","Arbitrary list of current source values; ilist = {value1, value2, ...valueN}","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³ 2)","Details","Data for voltage measurements, current source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a current list sweep with voltage measured at every step (point):","Sets the SMU to output ilist amperes value, allows the source to settle for stime seconds, and then performs a voltage measurement.","Sets the SMU to output the next ilist step, allows the source to settle for stime seconds, and then performs a voltage measurement.","Repeats the above sequence until the voltage is measured for the last amperes value. The last point in the list to be measured is points.","Example","testilist = {-100e-9, 100e-9, -1e-6, 1e-6, -1e-3, 1e-3}","SweepIListMeasureV(smua, testilist, 500e-3, 6)","This function performs a six‑point current list sweep starting at the first point in testilist. Voltage is measured at every step (point) in the sweep. The source is allowed to settle on each step for 500 ms before a measurement is performed.","Also see","KISweep factory script","SweepIListMeasureV()","12190.htm");
+Page[420]=new Array("This KISweep factory script function performs a logarithmic current sweep with voltage measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepILogMeasureV(smua, starti, stopi, stime, points)","starti","Sweep start current in amperes","stopi","Sweep stop current in amperes","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³ 2)","Details","Data for voltage measurements, current source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a logarithmic current sweep with voltage measured at every step (point):","Sets the SMU to output starti amperes value, allows the source to settle for stime seconds, and then performs a voltage measurement.","Sets the SMU to output the next amperes step, allows the source to settle for stime seconds, and then performs a voltage measurement.","Repeats the above sequence until the voltage is measured on the stopi amperes step.","The source level at each step (SourceStepLevel) is automatically calculated as follows:","MeasurePoint = The step point number for a measurement ","For example, for a five-point sweep (points = 5), a measurement is performed at MeasurePoint 1, 2, 3, 4, and 5.","LogStepSize = (log10(stopi) – log10(starti)) / (points – 1)","LogStep = (MeasurePoint – 1) * (LogStepSize)","SourceStepLevel = antilog(LogStep) * starti","Example","SweepILogMeasureV(smua, 0.01, 0.1, 0.001, 5)","This function performs a five‑point linear current sweep starting at 10 mA and stopping at 100 mA. Voltage is measured at every step (point) in the sweep. The source is allowed to settle on each step for 1 ms before a measurement is made.","The following table contains log values and corresponding source levels for the five‑point logarithmic sweep:","MeasurePoint","LogStepSize","LogStep","SourceStepLevel","1","0.25","0.0","0.01 A","2","0.25","0.25","0.017783 A","3","0.25","0.5","0.031623 A","4","0.25","0.75","0.056234 A","5","0.25","1.0","0.1 A","Also see","KISweep factory script","SweepILogMeasureV()","12184.htm");
+Page[421]=new Array("This KISweep factory script function performs a linear voltage sweep with current measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepVLinMeasureI(smua, startv, stopv, stime, points)","startv","Sweep start voltage in volts","stopv","Sweep stop voltage in volts","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³ 2)","Details","Data for current measurements, voltage source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a linear voltage sweep with current measured at every step (point):","Sets the SMU to output startv amperes, allows the source to settle for stime seconds, and then makes a current measurement.","Sets the SMU to output the next amperes step, allows the source to settle for stime seconds, and then makes a voltage measurement.","Repeats the above sequence until the voltage is measured on the stopv amperes step.","The linear step size is automatically calculated as follows:","step = (stopv – startv) / (points – 1)","Example","SweepVLinMeasureI(smua, -1, 1, 1e-3, 1000)","This function performs a 1000-point linear voltage sweep starting at -1 V and stopping at +1 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.","Also see","KISweep factory script","SweepVLinMeasureI()","12181.htm");
+Page[422]=new Array("This KISweep factory script function performs a voltage list sweep with current measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepVListMeasureI(smua, vlist, stime, points)","vlist","Arbitrary list of voltage source values; vlist = {value1, value2, ... valueN}","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³ 2)","Details","Data for current measurements, voltage source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a voltage list sweep with current measured at every step (point):","Sets the SMU to output vlist volts value, allows the source to settle for stime seconds, and then performs a current measurement.","Sets the SMU to output the next vlist volts value, allows the source to settle for stime seconds, and then performs a current measurement.","Repeats the above sequence until the current is measured for the last volts value. The last point in the list to be measured is points.","Example","myvlist = {-0.1, 0.1, -1, 1, -6, 6, -40, 40, 0, 0}","SweepVListMeasureI(smua, myvlist, 500E-3, 10)","This function performs a 10‑point voltage list sweep starting at the first point in myvlist. Current is measured at every step (point) in the sweep. The source will be allowed to settle on each step for 500 ms before a measurement is performed.","Also see","KISweep factory script","SweepVListMeasureI()","19138.htm");
+Page[423]=new Array("This KISweep factory script function performs a logarithmic voltage sweep with current measured at every step (point).","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","SweepVLogMeasureI(smua, startv, stopv, stime, points)","startv","Sweep start voltage in volts","stopv","Sweep stop voltage in volts","stime","Settling time in seconds; occurs after stepping the source and before making a measurement","points","Number of sweep points (must be ³ 2)","Details","Data for current measurements, voltage source values, and timestamps are stored in smua.nvbuffer1.","If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.","Performs a logarithmic voltage sweep with current measured at every step (point):","Sets the SMU to output startv amperes, allows the source to settle for stime seconds, and then makes a current measurement.","Sets the SMU to output the next volts step, allows the source to settle for stime seconds, and then makes a current measurement.","Repeats the above sequence until the voltage is measured on the stopv volts step.","The source level at each step (SourceStepLevel) is automatically calculated as follows:","MeasurePoint = The step point number for a measurement ","For example, for a five-point sweep (points = 5), a measurement is made at MeasurePoint 1, 2, 3, 4, and 5.","LogStepSize = (log10(stopi) – log10(starti)) / (points – 1)","LogStep = (MeasurePoint – 1) * (LogStepSize)","SourceStepLevel = antilog(LogStep) * startv","Example","SweepVLogMeasureI(smua, 1, 10, 0.001, 5)","This function performs a five‑point logarithmic voltage sweep starting at 1 V and stopping at 10 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.","The following table contains log values and corresponding source levels for the five‑point logarithmic sweep:","MeasurePoint","LogStepSize","LogStep","SourceStepLevel","1","0.25","0.0","1.0000 V","2","0.25","0.25","1.7783 V","3","0.25","0.5","3.1623 V","4","0.25","0.75","5.6234 V","5","0.25","1.0","10.000 V","Also see","KISweep factory script","SweepVLogMeasureI()","12192.htm");
+Page[424]=new Array("This function measures the elapsed time since the timer was last reset.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","time = timer.measure.t()","time","The elapsed time in seconds (1 µs resolution)","Example 1","timer.reset()","-- (intervening code)","time = timer.measure.t()","print(time)","This example resets the timer and measures the time since the reset.","Output:","1.469077e+01","The output will vary. The above output indicates that timer.measure.t() was executed 14.69077 seconds after timer.reset().","Example 2","beeper.enable = beeper.ON","beeper.beep(0.5, 2400)","print("reset timer")","timer.reset()","delay(0.5)","dt = timer.measure.t()","print("timer after delay:", dt)","beeper.beep(0.5, 2400)","Enable the beeper.","Emit a beep and set the beeper.","Reset the timer.","Set a delay.","Verify the duration of the delay before emitting another beep.","Output:","reset timer","timer after delay: 5.00e-01","Also see","timer.reset()","timer.measure.t()","15281.htm");
+Page[425]=new Array("This function resets the timer to zero (0) seconds.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","timer.reset()","Example","timer.reset()","-- (intervening code)","time = timer.measure.t()","print(time)","Resets the timer and then measures the time since the reset.","Output:","1.469077e+01","The above output indicates that timer.measure.t() was executed 14.69077 seconds after timer.reset().","Also see","timer.measure.t()","timer.reset()","15282.htm");
+Page[426]=new Array("This function clears the blender event detector and resets the overrun indicator of blender N.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","trigger.blender[N].clear()","N","The blender number (up to six)","Details","This command sets the blender event detector to the undetected state and resets the overrun indicator of the event detector.","Example","trigger.blender[2].clear()","Clears the event detector for blender 2.","Also see","None","trigger.blender[N].clear()","15785.htm");
+Page[427]=new Array("This constant contains the trigger blender event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = trigger.blender[N].EVENT_ID","eventID","Trigger event number","N","The blender number (up to six)","Details","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to trigger events from this trigger blender.","Example","digio.trigger[1].stimulus = trigger.blender[2].EVENT_ID","Set the trigger stimulus of digital I/O trigger 1 to be controlled by the trigger blender 2 event.","Also see","None","trigger.blender[N].EVENT_ID","15786.htm");
+Page[428]=new Array("This attribute selects whether the blender performs OR operations or AND operations.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Trigger blender N reset Recall setup","Not saved","false (AND mode)","Usage","orenable = trigger.blender[N].orenable","trigger.blender[N].orenable = orenable","orenable","The type of operation:","true: OR operation","false: AND operation","N","The blender number (up to six)","Details","This command selects whether the blender waits for any one event (OR) or waits for all selected events (AND) before signaling an output event.","Example","trigger.blender[1].orenable = true","trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID","trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID","Generate a trigger blender 1 event when a digital I/O trigger happens on line 3 or 5.","Also see","trigger.blender[N].reset()","trigger.blender[N].orenable","15787.htm");
+Page[429]=new Array("This attribute indicates whether or not an event was ignored because of the event detector state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset Trigger blender N clear Trigger blender N reset","Not applicable","Not applicable","Usage","overrun = trigger.blender[N].overrun","overrun","Trigger blender overrun state (true or false)","N","The blender number (up to six)","Details","Indicates if an event was ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector that is built into the event blender itself.","This command does not indicate if an overrun occurred in any other part of the trigger model or in any other trigger object that is monitoring the event. It also is not an indication of an action overrun.","Example","print(trigger.blender[1].overrun)","If an event was ignored, the output is true.","If an event was not ignored, the output is false.","Also see","trigger.blender[N].reset()","trigger.blender[N].overrun","15788.htm");
+Page[430]=new Array("This function resets some of the trigger blender settings to their factory defaults.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","trigger.blender[N].reset()","N","The trigger event blender (up to six)","Details","The trigger.blender[N].reset() function resets the following attributes to their factory defaults:","trigger.blender[N].orenable","trigger.blender[N].stimulus[M]","It also clears trigger.blender[N].overrun.","Example","trigger.blender[1].reset()","Resets the trigger blender 1 settings to factory defaults.","Also see","trigger.blender[N].orenable","trigger.blender[N].overrun","trigger.blender[N].stimulus[M]","trigger.blender[N].reset()","17666.htm");
+Page[431]=new Array("This attribute specifies the events that trigger the blender.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Trigger blender N reset","Not applicable","trigger.EVENT_NONE","Usage","eventID = trigger.blender[N].stimulus[M]","trigger.blender[N].stimulus[M] = eventID","eventID","The event that triggers the blender action; see Details","N","An integer representing the trigger event blender (up to six)","M","An integer representing the stimulus index (1 to 4)","Details","There are four stimulus inputs that can each select a different event. The eventID parameter can be the event ID of any trigger event.","Use zero to disable the blender input. ","The eventID parameter may be one of the existing trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","digio.trigger[3].mode = digio.TRIG_FALLING","digio.trigger[5].mode = digio.TRIG_FALLING","trigger.blender[1].orenable = true","trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID","trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID","Generate a trigger blender 1 event when a digital I/O trigger happens on line 3 or 5.","Also see","trigger.blender[N].reset()","trigger.blender[N].stimulus[M]","17684.htm");
+Page[432]=new Array("This function waits for a blender trigger event to occur.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = trigger.blender[N].wait(timeout)","triggered","Trigger detection indication for blender","N","The trigger blender (up to six) on which to wait","timeout","Maximum amount of time in seconds to wait for the trigger blender event","Details","This function waits for an event blender trigger event. If one or more trigger events were detected since the last time trigger.blender[N].wait() or trigger.blender[N].clear() was called, this function returns immediately.","After detecting a trigger with this function, the event detector automatically resets and rearms. This is true regardless of the number of events detected.","Example","digio.trigger[3].mode = digio.TRIG_FALLING","digio.trigger[5].mode = digio.TRIG_FALLING","trigger.blender[1].orenable = true","trigger.blender[1].stimulus[1] = digio.trigger[3].EVENT_ID","trigger.blender[1].stimulus[2] = digio.trigger[5].EVENT_ID","print(trigger.blender[1].wait(3))","Generate a trigger blender 1 event when a digital I/O trigger happens either on line 3 or 5.","Wait three seconds while checking if trigger blender 1 event has occurred.","If the blender trigger event has happened, then true is output. If the trigger event has not happened, then false is output after the timeout expires.","Also see","trigger.blender[N].clear()","trigger.blender[N].wait()","15790.htm");
+Page[433]=new Array("This function clears the command interface trigger event detector.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","trigger.clear()","Details","The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call. trigger.clear() clears the trigger event detector and discards the history of command interface trigger events.","Also see","trigger.wait()","trigger.clear()","15791.htm");
+Page[434]=new Array("This constant contains the command interface trigger event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = trigger.EVENT_ID","eventID","The event ID for the command interface triggers","Details","You can set the stimulus of any trigger object to the value of this constant to have the trigger object respond to command interface trigger events.","Example","trigger.timer[1].stimulus = trigger.EVENT_ID","Sets the trigger stimulus of trigger timer 1 to the command interface trigger event.","Also see","None","trigger.EVENT_ID","15792.htm");
+Page[435]=new Array("This function generates a trigger event.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","trigger.generator[N].assert()","N","The generator number (1 or 2)","Details","Use this function to directly trigger events from the command interface or a script. For example, you can trigger a sweep while the instrument is under script control.","Example","trigger.generator[2].assert()","Generates a trigger event on generator 2.","Also see","trigger.generator[N].EVENT_ID","trigger.generator[N].assert()","29218.htm");
+Page[436]=new Array("This constant identifies the trigger event generated by the trigger event generator.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = trigger.generator[N].EVENT_ID","eventID","The trigger event number","N","The generator number (1 or 2)","Details","This constant is an identification number that identifies events generated by this generator.","To have another trigger object respond to trigger events generated by this generator, set the other object's stimulus attribute to the value of this constant.","Example","digio.trigger[5].stimulus = trigger.generator[2].EVENT_ID","Uses a trigger event on generator 2 to be the stimulus for digital I/O trigger line 5.","Also see","trigger.generator[N].assert()","trigger.generator[N].EVENT_ID","29219.htm");
+Page[437]=new Array("This function clears the timer event detector and overrun indicator for the specified trigger timer number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","trigger.timer[N].clear()","N","Trigger timer number (1 to 8)","Details","This command sets the timer event detector to the undetected state and resets the overrun indicator.","Example","trigger.timer[1].clear()","Clears trigger timer 1.","Also see","trigger.timer[N].count","trigger.timer[N].clear()","15793.htm");
+Page[438]=new Array("This attribute sets the number of events to generate each time the timer generates a trigger event.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup Trigger timer N reset","Not saved","1","Usage","count = trigger.timer[N].count","trigger.timer[N].count = count","count","Number of times to repeat the trigger (0 to 1,048,575)","N","Trigger timer number (1 to 8)","Details","If the count is set to a number greater than 1, the timer automatically starts the next trigger timer delay at the expiration of the previous delay.","Set the count to zero (0) to cause the timer to generate trigger events indefinitely.","If you use the trigger timer with a trigger model, make sure the count value is the same or more than any count values expected in the trigger model.","Example","print(trigger.timer[1].count)","Read trigger count for timer number 1.","Also see","trigger.timer[N].clear()","trigger.timer[N].delay","trigger.timer[N].reset()","trigger.timer[N].count","15820.htm");
+Page[439]=new Array("This attribute sets and reads the timer delay.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup Trigger timer N reset","Not saved","10e-6 (10 µs)","Usage","interval = trigger.timer[N].delay","trigger.timer[N].delay = interval","interval","Delay interval in seconds (0.5 µs to 100 ks)","N","Trigger timer number (1 to 8)","Details","Once the timer is enabled, each time the timer is triggered, it uses this delay period.","Assigning a value to this attribute is equivalent to:","trigger.timer[N].delaylist = {interval}","This creates a delay list of one value.","Reading this attribute returns the delay interval that will be used the next time the timer is triggered.","Example","trigger.timer[1].delay = 50e-6","Set the trigger timer 1 to delay for 50 µs.","Also see","trigger.timer[N].reset()","trigger.timer[N].delay","15794.htm");
+Page[440]=new Array("This attribute sets an array of timer intervals.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup Trigger timer N reset","Not saved","10e-6 (10 µs)","Usage","intervals = trigger.timer[N].delaylist","trigger.timer[N].delaylist = intervals","intervals","Table of delay intervals in seconds","N","Trigger timer number (1 to 8)","Details","Each time the timer is triggered after it is enabled, it uses the next delay period from the array. The default value is an array with one value of 10 µs.","After all elements in the array have been used, the delays restart at the beginning of the list.","If the array contains more than one element, the average of the delay intervals in the list must be ³ 50 µs.","Example","trigger.timer[3].delaylist = {50e-6, 100e-6, 150e-6}","DelayList = trigger.timer[3].delaylist","for x = 1, table.getn(DelayList) do"," print(DelayList[x])","end","Set a delay list on trigger timer 3 with three delays (50 µs, 100 µs, and 150 µs).","Read the delay list on trigger timer 3.","Output:","5e-05","0.0001","0.00015","Also see","trigger.timer[N].reset()","trigger.timer[N].delaylist","15795.htm");
+Page[441]=new Array("This constant specifies the trigger timer event number.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = trigger.timer[N].EVENT_ID","eventID","The trigger event number","N","Trigger timer number (1 to 8)","Details","This constant is an identification number that identifies events generated by this timer.","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to events from this timer.","Example","trigger.timer[1].stimulus = tsplink.trigger[2].EVENT_ID","Sets the trigger stimulus of trigger timer 1 to the TSP-Link trigger 2 event.","Also see","None","trigger.timer[N].EVENT_ID","15796.htm");
+Page[442]=new Array("This attribute indicates if an event was ignored because of the event detector state.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset Recall setup Trigger timer N clear Trigger timer N reset","Not applicable","false","Usage","overrun = trigger.timer[N].overrun","overrun","Trigger overrun state (true or false)","N","Trigger timer number (1 to 8)","Details","This command indicates if an event was ignored because the event detector was already in the detected state when the event occurred.","This is an indication of the state of the event detector built into the timer itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other construct that is monitoring the delay completion event. It also is not an indication of a delay overrun.","Delay overrun indications are provided in the status model.","Example","print(trigger.timer[1].overrun)","If an event was ignored, the output is true.","If the event was not ignored, the output is false.","Also see","trigger.timer[N].reset()","trigger.timer[N].overrun","15797.htm");
+Page[443]=new Array("This attribute enables or disables the timer trigger pass‑through mode.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup Trigger timer N reset","Not saved ","false (disabled)","Usage","passthrough = trigger.timer[N].passthrough","trigger.timer[N].passthrough = passthrough","passthrough","The state of pass-through mode; set to one of the following values:","true: Enabled","false: Disabled","N","Trigger timer number (1 to 8)","Details","When pass-through mode is enabled, triggers are passed through immediately and initiate the delay. When disabled, a trigger only initiates a delay.","Example","trigger.timer[1].passthrough = true","Enables pass‑through mode on trigger timer 1.","Also see","trigger.timer[N].reset()","trigger.timer[N].passthrough","15798.htm");
+Page[444]=new Array("This function resets some of the trigger timer settings to their factory defaults.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","trigger.timer[N].reset()","N","Trigger timer number (1 to 8)","Details","The trigger.timer[N].reset() function resets the following attributes to their factory defaults:","trigger.timer[N].count","trigger.timer[N].delay","trigger.timer[N].delaylist","trigger.timer[N].passthrough","trigger.timer[N].stimulus","It also clears trigger.timer[N].overrun.","Example","trigger.timer[1].reset()","Resets the attributes associated with timer 1 back to factory default values.","Also see","trigger.timer[N].count","trigger.timer[N].delay","trigger.timer[N].delaylist","trigger.timer[N].overrun","trigger.timer[N].passthrough","trigger.timer[N].stimulus","trigger.timer[N].reset()","17668.htm");
+Page[445]=new Array("This attribute specifies which event starts the timer.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup Trigger timer N reset","Not saved","0","Usage","eventID = trigger.timer[N].stimulus","trigger.timer[N].stimulus = eventID","eventID","The event that triggers the timer delay","N","Trigger timer number (1 to 8)","Details","The eventID parameter may be one of the trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Set this attribute to the eventID of any trigger event to cause the timer to start when that event occurs.","Set this attribute to zero (0) to disable event processing.","Example","print(trigger.timer[1].stimulus)","Prints the event that will start a trigger 1 timer action.","Also see","trigger.timer[N].reset()","trigger.timer[N].stimulus","17688.htm");
+Page[446]=new Array("This function waits for a trigger.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = trigger.timer[N].wait(timeout)","triggered","Trigger detection indication","N","Trigger timer number (1 to 8)","timeout","Maximum amount of time in seconds to wait for the trigger","Details","If one or more trigger events were detected since the last time trigger.timer[N].wait() or trigger.timer[N].clear() was called, this function returns immediately.","After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.","Example","triggered = trigger.timer[3].wait(10)","print(triggered)","Waits up to 10 s for a trigger on timer 3.","If false is returned, no trigger was detected during the 10 s timeout.","If true is returned, a trigger was detected.","Also see","trigger.timer[N].clear()","trigger.timer[N].wait()","15800.htm");
+Page[447]=new Array("This function waits for a command interface trigger event.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","triggered = trigger.wait(timeout)","triggered","true: A trigger was detected during the timeout period","false: No triggers were detected during the timeout period","timeout","Maximum amount of time in seconds to wait for the trigger","Details","This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when:","A GPIB GET command is detected (GPIB only)","A USBTMC TRIGGER message is received (USB only)","A VXI-11 device_trigger method is invoked (VXI-11 only)","A *TRG message is received","If one or more of these trigger events were previously detected, this function returns immediately.","After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.","Example","triggered = trigger.wait(10)","print(triggered)","Waits up to 10 seconds for a trigger.","If false is returned, no trigger was detected during the 10‑second timeout.","If true is returned, a trigger was detected.","Also see","trigger.clear()","trigger.wait()","15801.htm");
+Page[448]=new Array("This attribute contains the group number of a TSP‑Link node. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Power cycle","Not applicable","0","Usage","groupNumber = tsplink.group","tsplink.group = groupNumber","groupNumber","The group number of the TSP-Link node (0 to 64)","Details","To remove the node from all groups, set the attribute value to 0.","When the node is turned off, the group number for that node changes to 0.","The master node can be assigned to any group. You can also include other nodes in the group that includes the master. Note that any nodes that are set to 0 are automatically included in the group that contains the master node, regardless of the group that is assigned to the master node.","Example","tsplink.group = 3","Assign the instrument to TSP-Link group number 3.","Also see","Using groups to manage nodes on a TSP-Link system","tsplink.group","15285.htm");
+Page[449]=new Array("This attribute reads the node number assigned to the master node. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","masterNodeNumber = tsplink.master","masterNodeNumber","The node number of the master node","Details","After doing a TSP-Link reset (tsplink.reset()), use this attribute to access the node number of the master in a set of instruments connected over TSP-Link.","Example","LinkMaster = tsplink.master","Store the TSP-Link master node number in a variable called LinkMaster.","Also see","tsplink.reset()","tsplink.master","15286.htm");
+Page[450]=new Array("This attribute defines the node number. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Not applicable","Nonvolatile memory","1","Usage","nodeNumber = tsplink.node","tsplink.node = nodeNumber","nodeNumber","The node number of the instrument or enclosure (1 to 64 )","Details","This command sets the TSP‑Link node number and saves the value in nonvolatile memory.","Changes to the node number do not take effect until tsplink.reset() from an earlier TSP‑Link instrument is executed on any node in the system.","Each node connected to the TSP-Link system must be assigned a different node number.","Example","tsplink.node = 3","Sets the TSP‑Link node for this instrument to number 3.","Also see","tsplink.reset()","tsplink.state","tsplink.node","15287.htm");
+Page[451]=new Array("This function reads the state of a TSP-Link synchronization line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data = tsplink.readbit(N)","data","The state of the synchronization line","N","The trigger line (1 to 3)","Details","Returns a value of zero (0) if the line is low and 1 if the line is high.","Example","data = tsplink.readbit(3)","print(data)","Assume line 3 is set high, and it is then read.","Output:","1.000000e+00","Also see","tsplink.readport()","tsplink.writebit()","tsplink.readbit()","15288.htm");
+Page[452]=new Array("This function reads the TSP-Link trigger lines as a digital I/O port. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","data = tsplink.readport()","data","Numeric value that indicates which lines are set","Details","The binary equivalent of the returned value indicates the input pattern on the I/O port. The least significant bit of the binary number corresponds to line 1 and the value of bit 3 corresponds to line 3. For example, a returned value of 2 has a binary equivalent of 010. This indicates that line 2 is high (1), and that the other two lines are low (0).","Example","data = tsplink.readport()","print(data)","Reads state of all three TSP-Link lines.","Assuming line 2 is set high, the output is:","2.000000e+00","(binary 010)","The format of the output may vary depending on the ASCII precision setting.","Also see","TSP-Link trigger lines","tsplink.readbit()","tsplink.writebit() ","tsplink.writeport()","tsplink.readport()","15289.htm");
+Page[453]=new Array("This function initializes (resets) all nodes (instruments) in the TSP‑Link system. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","nodesFound = tsplink.reset()","nodesFound = tsplink.reset(expectedNodes)","nodesFound","The number of nodes actually found on the system","expectedNodes","The number of nodes expected on the system (1 to 64)","Details","This function erases all information regarding other nodes connected on the TSP-Link system and regenerates the system configuration. This function must be called at least once before any remote nodes can be accessed. If the node number for any instrument is changed, the TSP-Link must be reset again.","If expectedNodes is not given, this function generates an error if no other nodes are found on the TSP‑Link network.","If nodesFound is less than expectedNodes, an error is generated. Note that the node on which the command is running is counted as a node. For example, giving an expected node count of 1 will not generate any errors, even if there are no other nodes on the TSP-Link network.","Also returns the number of nodes found.","Example","nodesFound = tsplink.reset(2)","print("Nodes found = " .. nodesFound)","Perform a TSP-Link reset and indicate how many nodes are found.","Sample output if two nodes are found: Nodes found = 2","Sample output if fewer nodes are found and if localnode.showerrors = 1: 1219, TSP-Link found fewer nodes than expected Nodes found = 1","Also see","localnode.showerrors","tsplink.node","tsplink.state","tsplink.reset()","15290.htm");
+Page[454]=new Array("This attribute describes the TSP‑Link online state. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Not applicable","Not applicable","Not applicable","Usage","state = tsplink.state","state","TSP-Link state (online or offline)","Details","When the instrument power is first turned on, the state is offline. After tsplink.reset() is successful, the state is online.","Example","state = tsplink.state","print(state)","Read the state of the TSP‑Link system. If it is online, the output is:","online","Also see","tsplink.node","tsplink.reset()","tsplink.state","15291.htm");
+Page[455]=new Array("This function simulates the occurrence of the trigger and generates the corresponding event ID. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.trigger[N].assert()","N","The trigger line (1 to 3)","Details","The set pulse width determines how long the trigger is asserted.","Example","tsplink.trigger[2].assert()","Asserts trigger on trigger line 2.","Also see","tsplink.trigger[N].clear()","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].pulsewidth","tsplink.trigger[N].release()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.trigger[N].assert()","15292.htm");
+Page[456]=new Array("This function clears the event detector for a LAN trigger. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.trigger[N].clear()","N","The trigger line (1 to 3) to clear","Details","The trigger event detector enters the detected state when an event is detected. tsplink.trigger[N].clear() clears a trigger event detector, discards the history of the trigger line, and clears the tsplink.trigger[N].overrun attribute.","Example","tsplink.trigger[2].clear()","Clears trigger event on synchronization line 2.","Also see","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].release()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.trigger[N].clear()","15293.htm");
+Page[457]=new Array("This constant identifies the number that is used for the trigger events. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Constant","Yes","Usage","eventID = tsplink.trigger[N].EVENT_ID","eventID","The trigger event number","N","The trigger line (1 to 3)","Details","This number is used by the TSP-Link trigger line when it detects an input trigger.","Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to trigger events from this line.","Example","trigger.timer[1].stimulus = tsplink.trigger[2].EVENT_ID","Sets the trigger stimulus of trigger timer 1 to the TSP-Link trigger 2 event.","Also see","None","tsplink.trigger[N].EVENT_ID","15294.htm");
+Page[458]=new Array("This attribute defines the trigger operation and detection mode. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup TSP-Link trigger N reset","Not saved","0 (tsplink.TRIG_BYPASS)","Usage","mode = tsplink.trigger[N].mode","tsplink.trigger[N].mode = mode","mode","The trigger mode","N","The trigger line (1 to 3)","Details","This attribute controls the mode in which the trigger event detector and the output trigger generator operate on the given trigger line.","The setting for mode can be one of the following values:","Mode","Number value","Description","tsplink.TRIG_BYPASS","0","Allows direct control of the line as a digital I/O line.","tsplink.TRIG_FALLING","1","Detects falling‑edge triggers as input. Asserts a TTL-low pulse for output.","tsplink.TRIG_RISING","2","If the programmed state of the line is high, the tsplink.TRIG_RISING mode behaves similarly to tsplink.TRIG_RISINGA.","If the programmed state of the line is low, the tsplink.TRIG_RISING mode behaves similarly to tsplink.TRIG_RISINGM.","Use tsplink.TRIG_RISINGA if the line is in the high output state.","Use tsplink.TRIG_RISINGM if the line is in the low output state.","tsplink.TRIG_EITHER","3","Detects rising‑ or falling‑edge triggers as input. Asserts a TTL‑low pulse for output.","tsplink.TRIG_SYNCHRONOUSA","4","Detects the falling‑edge input triggers and automatically latches and drives the trigger line low.","tsplink.TRIG_SYNCHRONOUS","5","Detects the falling‑edge input triggers and automatically latches and drives the trigger line low. Asserts a TTL-low pulse as an output trigger.","tsplink.TRIG_SYNCHRONOUSM","6","Detects rising‑edge triggers as an input. Asserts a TTL‑low pulse for output.","tsplink.TRIG_RISINGA","7","Detects rising‑edge triggers as input. Asserts a TTL‑low pulse for output.","tsplink.TRIG_RISINGM","8","Edge detection as an input is not available. Generates a TTL‑high pulse as an output trigger.","When programmed to any mode except tsplink.TRIG_BYPASS, the output state of the I/O line is controlled by the trigger logic, and the user-specified output state of the line is ignored.","When the trigger mode is set to tsplink.TRIG_RISING, the user‑specified output state of the line is examined. If the output state selected when the mode is changed is high, the actual mode used will be tsplink.TRIG_RISINGA. If the output state selected when the mode is changed is low, the actual mode used will be tsplink.TRIG_RISINGM.","mode stores the trigger mode as a numeric value when the attribute is read.","To control the line state, use the tsplink.TRIG_BYPASS mode with the tsplink.writebit() and the tsplink.writeport() commands.","Example","tsplink.trigger[3].mode = tsplink.TRIG_RISINGM","Sets the trigger mode for synchronization line 3 to tsplink.TRIG_RISINGM.","Also see","digio.writebit()","digio.writeport()","tsplink.trigger[N].assert()","tsplink.trigger[N].clear()","tsplink.trigger[N].overrun","tsplink.trigger[N].release()","tsplink.trigger[N].reset()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.trigger[N].mode","15295.htm");
+Page[459]=new Array("This attribute indicates if the event detector ignored an event while in the detected state. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (R)","Yes","Instrument reset Recall setup TSP-Link trigger N clear TSP-Link trigger N reset","Not applicable","Not applicable","Usage","overrun = tsplink.trigger[N].overrun","overrun","Trigger overrun state","N","The trigger line (1 to 3)","Details","This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred.","This is an indication of the state of the event detector built into the synchronization line itself.","It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event. It also is not an indication of an output trigger overrun. Output trigger overrun indications are provided in the status model.","Example","print(tsplink.trigger[1].overrun)","If an event was ignored, displays true; if an event was not ignored, displays false.","Also see","tsplink.trigger[N].assert()","tsplink.trigger[N].clear()","tsplink.trigger[N].mode","tsplink.trigger[N].release()","tsplink.trigger[N].reset()","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.trigger[N].overrun","15296.htm");
+Page[460]=new Array("This attribute sets the length of time that the trigger line is asserted for output triggers. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset TSP-Link trigger N reset Recall setup","Not saved","10e-6 (10 µs)","Usage","width = tsplink.trigger[N].pulsewidth","tsplink.trigger[N].pulsewidth = width","width","The pulse width (in seconds)","N","The trigger line (1 to 3)","Details","Setting the pulse width to 0 (seconds) asserts the trigger indefinitely.","Example","tsplink.trigger[3].pulsewidth = 20e-6","Sets pulse width for trigger line 3 to 20 μs.","Also see","tsplink.trigger[N].release()","tsplink.trigger[N].pulsewidth","15297.htm");
+Page[461]=new Array("This function releases a latched trigger on the given TSP‑Link trigger line. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.trigger[N].release()","N","The trigger line (1 to 3)","Details","Releases a trigger that was asserted with an indefinite pulse width. It also releases a trigger that was latched in response to receiving a synchronous mode trigger.","Example","tsplink.trigger[3].release()","Releases trigger line 3.","Also see","tsplink.trigger[N].assert()","tsplink.trigger[N].clear()","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].pulsewidth","tsplink.trigger[N].stimulus","tsplink.trigger[N].wait()","tsplink.trigger[N].release()","15298.htm");
+Page[462]=new Array("This function resets some of the TSP-Link trigger attributes to their factory defaults. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.trigger[N].reset()","N","The trigger line (1 to 3)","Details","The tsplink.trigger[N].reset() function resets the following attributes to their factory defaults:","tsplink.trigger[N].mode","tsplink.trigger[N].stimulus","tsplink.trigger[N].pulsewidth","This also clears tsplink.trigger[N].overrun.","Example","tsplink.trigger[3].reset()","Resets TSP-Link trigger line 3 attributes back to factory default values.","Also see","tsplink.trigger[N].mode","tsplink.trigger[N].overrun","tsplink.trigger[N].pulsewidth","tsplink.trigger[N].stimulus","tsplink.trigger[N].reset()","17669.htm");
+Page[463]=new Array("This attribute specifies the event that causes the synchronization line to assert a trigger. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup TSP-Link trigger N reset","Not saved","0","Usage","eventID = tsplink.trigger[N].stimulus","tsplink.trigger[N].stimulus = eventID","eventID","The event identifier for the triggering event","N","The trigger line (1 to 3)","Details","To disable automatic trigger assertion on the synchronization line, set this attribute to zero (0).","Do not use this attribute when triggering under script control. Use tsplink.trigger[N].assert() instead.","The eventID parameter may be one of the existing trigger event IDs shown in the following table.","Trigger event IDs*","Event ID","Event description","smua.trigger.SWEEPING_EVENT_ID","Occurs when the source‑measure unit (SMU) transitions from the idle state to the arm layer of the trigger model","smua.trigger.ARMED_EVENT_ID","Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model","smua.trigger.SOURCE_COMPLETE_EVENT_ID","Occurs when the SMU completes a source action","smua.trigger.MEASURE_COMPLETE_EVENT_ID","Occurs when the SMU completes a measurement action","smua.trigger.PULSE_COMPLETE_EVENT_ID","Occurs when the SMU completes a pulse","smua.trigger.SWEEP_COMPLETE_EVENT_ID","Occurs when the SMU completes a sweep","smua.trigger.IDLE_EVENT_ID","Occurs when the SMU returns to the idle state","digio.trigger[N].EVENT_ID","Occurs when an edge is detected on a digital I/O line","tsplink.trigger[N].EVENT_ID","Occurs when an edge is detected on a TSP‑Link line","lan.trigger[N].EVENT_ID","Occurs when the appropriate LXI trigger packet is received on LAN trigger object N","display.trigger.EVENT_ID","Occurs when the TRIG key on the front panel is pressed","trigger.EVENT_ID","Occurs when a *TRG command is received on the remote interface","GPIB only: Occurs when a GET bus command is received","USB only: Occurs when a USBTMC TRIGGER message is received","VXI-11 only: Occurs with the VXI-11 command device_trigger; reference the VXI-11 standard for additional details on the device trigger operation","trigger.blender[N].EVENT_ID","Occurs after a collection of events is detected","trigger.timer[N].EVENT_ID","Occurs when a delay expires","trigger.generator[N].EVENT_ID","Occurs when the trigger.generator[N].assert() function is executed","* Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).","Example","print(tsplink.trigger[3].stimulus)","Prints the event that will start TSP-Link trigger line 3 action.","Also see","tsplink.trigger[N].assert()","tsplink.trigger[N].reset()","tsplink.trigger[N].stimulus","17682.htm");
+Page[464]=new Array("This function waits for a trigger. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","triggered = tsplink.trigger[N].wait(timeout)","triggered","Trigger detection indication; set to one of the following values:","true: A trigger is detected during the timeout period","false: A trigger is not detected during the timeout period","N","The trigger line (1 to 3)","timeout","The timeout value in seconds","Details","This function waits up to the timeout value for an input trigger. If one or more trigger events were detected since the last time tsplink.trigger[N].wait() or tsplink.trigger[N].clear() was called, this function returns immediately.","After waiting for a trigger with this function, the event detector is automatically reset and rearmed. This is true regardless of the number of events detected.","Example","triggered = tsplink.trigger[3].wait(10)","print(triggered)","Waits up to 10 seconds for a trigger on TSP-Link® line 3.","If false is returned, no trigger was detected during the 10-second timeout.","If true is returned, a trigger was detected.","Also see","tsplink.trigger[N].clear()","tsplink.trigger[N].wait()","15300.htm");
+Page[465]=new Array("This function sets a TSP-Link trigger line high or low. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.writebit(N, data)","N","The trigger line (1 to 3)","data","The value to write to the bit:","Low: 0","High: 1","Details","Use tsplink.writebit() and tsplink.writeport() to control the output state of the trigger line when trigger operation is set to tsplink.TRIG_BYPASS.","If the output line is write‑protected by the tsplink.writeprotect attribute, this command is ignored.","The reset function does not affect the present states of the TSP-Link trigger lines.","Example","tsplink.writebit(3, 0)","Sets trigger line 3 low (0).","Also see","tsplink.readbit()","tsplink.readport()","tsplink.writeport()","tsplink.writeprotect","tsplink.writebit()","15301.htm");
+Page[466]=new Array("This function writes to all TSP‑Link synchronization lines. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tsplink.writeport(data)","data","Value to write to the port (0 to 7)","Details","The binary representation of data indicates the output pattern that is written to the I/O port. For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1), and the other two lines are set low (0).","Write‑protected lines are not changed.","Use the tsplink.writebit() and tsplink.writeport() commands to control the output state of the synchronization line when trigger operation is set to tsplink.TRIG_BYPASS.","The reset() function does not affect the present states of the trigger lines.","Example","tsplink.writeport(3)","Sets the synchronization lines 1 and 2 high (binary 011).","Also see","tsplink.readbit()","tsplink.readport()","tsplink.writebit()","tsplink.writeprotect","tsplink.writeport()","15302.htm");
+Page[467]=new Array("This attribute contains the write‑protect mask that protects bits from changes by the tsplink.writebit() and tsplink.writeport() functions. ","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","Yes","Instrument reset Recall setup","Saved setup","0","Usage","mask = tsplink.writeprotect","tsplink.writeprotect = mask","mask","An integer that specifies the value of the bit pattern for write‑protect; set bits to 1 to write‑protect the corresponding TSP-Link trigger line","Details","The binary equivalent of mask indicates the mask to be set for the TSP-Link trigger line. For example, a mask value of 5 has a binary equivalent of 101. This mask write‑protects TSP-Link trigger lines 1 and 3.","Example","tsplink.writeprotect = 5","Write‑protects TSP-Link trigger lines 1 and 3.","Also see","Controlling digital I/O lines","tsplink.readbit()","tsplink.readport()","tsplink.writebit()","tsplink.writeport()","tsplink.writeprotect","17630.htm");
+Page[468]=new Array("This function clears any pending output data from the instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.clear(connectionID)","connectionID","The connection ID returned from tspnet.connect()","Details","This function clears any pending output data from the device. No data is returned to the caller and no data is processed.","Example","tspnet.write(testdevice, "print([[hello]])")","print(tspnet.readavailable(testdevice))","tspnet.clear(testdevice)","print(tspnet.readavailable(testdevice))","Write data to a device, then print how much is available.","Output:","6.00000e+00","Clear data and print how much data is available again.","Output:","0.00000e+00","Also see","tspnet.connect()","tspnet.readavailable()","tspnet.write()","tspnet.clear()","14073.htm");
+Page[469]=new Array("This function establishes a network connection with another LAN instrument or device through the LAN interface.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","connectionID = tspnet.connect("ipAddress")","connectionID = tspnet.connect("ipAddress", portNumber, "initString")","connectionID","The connection ID to be used as a handle in all other tspnet function calls","ipAddress","IP address to which to connect in a string","portNumber","Port number (default 5025)","initString","Initialization string to send to ipAddress","Details","This command connects a device to another device through the LAN interface. If the portNumber is 23, the interface uses the Telnet protocol and sets appropriate termination characters to communicate with the device.","If a portNumber and initString are provided, it is assumed that the remote device is not TSP‑enabled. The 2601B-PULSE does not perform any extra processing, prompt handling, error handling, or sending of commands. In addition, the tspnet.tsp.* commands cannot be used on devices that are not TSP‑enabled.","If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley Instruments TSP‑enabled device. Depending on the state of the tspnet.tsp.abortonconnect attribute, the 2601B-PULSE sends an abort command to the remote device on connection. ","The 2601B-PULSE also enables TSP prompts on the remote device and error management. The 2601B-PULSE places remote errors from the TSP‑enabled device in its own error queue and prefaces these errors with Remote Error, followed by an error description. ","Do not manually change either the prompt functionality (localnode.prompts) or show errors by changing localnode.showerrors on the remote TSP-enabled device. If you do this, subsequent tspnet.tsp.* commands using the connection may fail.","You can simultaneously connect to a maximum of 32 remote devices.","Example 1","instrumentID = tspnet.connect("192.0.2.1")","if instrumentID then"," -- Use instrumentID as needed here"," tspnet.disconnect(instrumentID)","end","Connect to a TSP-enabled device.","Example 2","instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\\r\\n")","if instrumentID then"," -- Use instrumentID as needed here"," tspnet.disconnect(instrumentID)","end","Connect to a device that is not TSP‑enabled.","Also see","localnode.prompts","localnode.showerrors","tspnet.tsp.abortonconnect","tspnet.disconnect()","tspnet.connect()","14074.htm");
+Page[470]=new Array("This function disconnects a specified TSP-Net session.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.disconnect(connectionID)","connectionID","The connection ID returned from tspnet.connect()","Details","This function disconnects the two devices by closing the connection. The connectionID is the session handle returned by tspnet.connect().","For TSP-enabled devices, this aborts any remotely running commands or scripts.","Example","testID = tspnet.connect("192.0.2.0")","-- Use the connection","tspnet.disconnect(testID)","Create a TSP‑Net session.","Close the session.","Also see","tspnet.connect()","tspnet.disconnect()","14076.htm");
+Page[471]=new Array("This function sends a command string to the remote device.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.execute("connectionID", "commandString")","value1 = tspnet.execute("connectionID", "commandString", formatString)","value1, value2 = tspnet.execute("connectionID", "commandString", formatString)","value1, ..., valueN = tspnet.execute("connectionID", "commandString", formatString)","connectionID","The connection ID returned from tspnet.connect()","commandString","The command to send to the remote device","value1","The first value decoded from the response message","value2","The second value decoded from the response message","valueN","The Nth value decoded from the response message; there is one return value for each format specifier in the format string","...","One or more values separated with commas","formatString","Format string for the output","Details","This command sends a command string to the remote instrument. A termination is added to the command string when it is sent to the remote instrument (tspnet.termination()). You can also specify a format string, which causes the command to wait for a response from the remote instrument. The 2601B-PULSE decodes the response message according to the format specified in the format string and returns the message as return values from the function (see tspnet.read() for format specifiers).","When this command is sent to a TSP-enabled instrument, the 2601B-PULSE suspends operation until a timeout error is generated or until the instrument responds. The TSP prompt from the remote instrument is read and discarded. The 2601B-PULSE places any remotely generated errors into its error queue. When the optional format string is not specified, this command is equivalent to tspnet.write(), except that a termination is automatically added to the end of the command.","Example 1","tspnet.execute(instrumentID, "runScript()")","Command the remote device to run a script named runScript.","Example 2","tspnet.timeout = 5","id_instr = tspnet.connect("192.0.2.23", 23, "*rst\\r\\n")","tspnet.termination(id_instr, tspnet.TERM_CRLF)","tspnet.execute(id_instr, "*idn?")","print("tspnet.execute returns:", tspnet.read(id_instr))","Print the *idn? string from the remote device.","Also see","tspnet.connect()","tspnet.read()","tspnet.termination()","tspnet.write()","tspnet.execute()","14077.htm");
+Page[472]=new Array("This function retrieves the response of the remote device to *IDN?.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","idnString = tspnet.idn(connectionID)","idnString","The returned *IDN? string","connectionID","The connection ID returned from tspnet.connect()","Details","This function retrieves the response of the remote device to *IDN?.","Example","deviceID = tspnet.connect("192.0.2.1")","print(tspnet.idn(deviceID))","tspnet.disconnect(deviceID)","Assume the instrument is at IP address 192.0.2.1.","The output that is produced when you connect to the instrument and read the identification string may appear as:","Keithley Instruments,Model 2601B-PULSE, 1398687, 1.0.0","Also see","tspnet.connect()","tspnet.idn()","14078.htm");
+Page[473]=new Array("This function reads data from a remote device.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","value1 = tspnet.read(connectionID)","value1 = tspnet.read(connectionID, formatString)","value1, value2 = tspnet.read(connectionID, formatString)","value1, ..., valueN = tspnet.read(connectionID, formatString)","value1","The first value decoded from the response message","value2","The second value decoded from the response message","valueN","The nth value decoded from the response message; there is one return value for each format specifier in the format string","...","One or more values separated with commas","connectionID","The connection ID returned from tspnet.connect()","formatString","Format string for the output, maximum of 10 specifiers","Details","This command reads available data from the remote instrument and returns responses for the specified number of arguments.","The format string can contain the following specifiers:","%[width]s","Read data until the specified length","%[max width]t","Read data until the specified length or until punctuation is found, whichever comes first","%[max width]n","Read data until a newline or carriage return","%d","Read a number (delimited by punctuation)","A maximum of 10 format specifiers can be used for a maximum of 10 return values.","If formatString is not provided, the command returns a string that contains the data until a new line is reached. If no data is available, the 2601B-PULSE pauses operation until the requested data is available or until a timeout error is generated. Use tspnet.timeout to specify the timeout period.","When the 2601B-PULSE reads from a TSP-enabled remote instrument, the 2601B-PULSE removes Test Script Processor (TSP®) prompts and places any errors it receives from the remote instrument into its own error queue. The 2601B-PULSE prefaces errors from the remote device with "Remote Error," followed by the error number and error description.","Example","tspnet.write(deviceID, "*idn?\\r\\n")","print("write/read returns:", tspnet.read(deviceID))","Send the "*idn?\\r\\n" message to the instrument connected as deviceID.","Display the response that is read from deviceID (based on the *idn? message).","Also see","tspnet.connect()","tspnet.readavailable()","tspnet.timeout","tspnet.write()","tspnet.read()","14079.htm");
+Page[474]=new Array("This function checks to see if data is available from the remote device.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","bytesAvailable = tspnet.readavailable(connectionID)","bytesAvailable","The number of bytes available to be read from the connection","connectionID","The connection ID returned from tspnet.connect()","Details","This command checks to see if any output data is available from the device. No data is read from the instrument. This allows TSP scripts to continue to run without waiting on a remote command to finish.","Example","ID = tspnet.connect("192.0.2.1")","tspnet.write(ID, "*idn?\\r\\n")","repeat bytes = tspnet.readavailable(ID) until bytes > 0","print(tspnet.read(ID))","tspnet.disconnect(ID)","Send commands that will create data.","Wait for data to be available.","Also see","tspnet.connect()","tspnet.read()","tspnet.readavailable()","14080.htm");
+Page[475]=new Array("This function disconnects all TSP-Net sessions.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.reset()","Details","This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.","Also see","None","tspnet.reset()","14081.htm");
+Page[476]=new Array("This function sets the device line termination sequence.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","type = tspnet.termination(connectionID)","type = tspnet.termination(connectionID, termSequence)","type","An enumerated value indicating the termination type:","1 or tspnet.TERM_LF","4 or tspnet.TERM_CR","2 or tspnet.TERM_CRLF","3 or tspnet.TERM_LFCR","connectionID","The connection ID returned from tspnet.connect()","termSequence","The termination sequence","Details","This function sets and gets the termination character sequence that is used to indicate the end of a line for a TSP-Net connection.","Using the termSequence parameter sets the termination sequence. The present termination sequence is always returned.","For the termSequence parameter, use the same values listed in the table above for type. There are four possible combinations, all of which are made up of line feeds (LF or 0x10) and carriage returns (CR or 0x13). For TSP-enabled devices, the default is tspnet.TERM_LF. For devices that are not TSP‑enabled, the default is tspnet.TERM_CRLF.","Example","deviceID = tspnet.connect("192.0.2.1")","if deviceID then"," tspnet.termination(deviceID, tspnet.TERM_LF)","end","Sets termination type for IP address 192.0.2.1 to TERM_LF.","Also see","tspnet.connect()","tspnet.disconnect()","tspnet.termination()","14082.htm");
+Page[477]=new Array("This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Instrument reset Recall setup","Not saved","20.0 (20 s)"," ","Usage","value = tspnet.timeout","tspnet.timeout = value","value","The timeout duration in seconds (1 ms to 30.0 s)","Details","This attribute sets the amount of time the tspnet.connect(), tspnet.execute(), and tspnet.read() commands will wait for a response.","The time is specified in seconds. The timeout may be specified to millisecond resolution but is only accurate to the nearest 10 ms.","Example","tspnet.timeout = 2.0","Sets the timeout duration to 2 s.","Also see","tspnet.connect()","tspnet.execute()","tspnet.read()","tspnet.timeout","14084.htm");
+Page[478]=new Array("This function causes the TSP-enabled instrument to stop executing any of the commands that were sent to it.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.tsp.abort(connectionID)","connectionID","Integer value used as a handle for other tspnet commands","Details","This function is appropriate only for TSP-enabled instruments.","Sends an abort command to the remote instrument.","Example","tspnet.tsp.abort(testConnection)","Stops remote instrument execution on testConnection.","Also see","None","tspnet.tsp.abort()","14085.htm");
+Page[479]=new Array("This attribute contains the setting for abort on connect to a TSP-enabled instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Attribute (RW)","No","Instrument reset Recall setup","Not saved","1 (enable)","Usage","tspnet.tsp.abortonconnect = value","value = tspnet.tsp.abortonconnect","value","Enable: 1","Disable: 0","Details","This setting determines if the instrument sends an abort message when it attempts to connect to a TSP‑enabled instrument using the tspnet.connect() function.","When you send the abort command on an interface, it causes any other active interface on that instrument to close. If you do not send an abort command (or if tspnet.tsp.abortonconnect is set to 0) and another interface is active, connecting to a TSP‑enabled remote instrument results in a connection. However, the instrument will not respond to subsequent reads or executes because control of the instrument is not obtained until an abort command has been sent.","Example","tspnet.tsp.abortonconnect = 0","Configure the instrument so that it does not send an abort command when connecting to a TSP‑enabled instrument.","Also see","tspnet.connect()","tspnet.tsp.abortonconnect","14086.htm");
+Page[480]=new Array("This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","table = tspnet.tsp.rbtablecopy(connectionID, "name")","table = tspnet.tsp.rbtablecopy(connectionID, "name", startIndex, endIndex)","table","A copy of the synchronous table or a string","connectionID","Integer value used as a handle for other tspnet commands","name","The full name of the reading buffer name and synchronous table to copy","startIndex","Integer start value","endIndex","Integer end value","Details","This function is only appropriate for TSP-enabled instruments.","This function reads the data from a reading buffer on a remote instrument and returns an array of numbers or a string representing the data. The startIndex and endIndex parameters specify the portion of the reading buffer to read. If no index is specified, the entire buffer is copied. ","The function returns a table if the table is an array of numbers; otherwise a comma‑delimited string is returned.","This command is limited to transferring 50,000 readings at a time.","Example","t = tspnet.tsp.rbtablecopy(testConnection,"," "testRemotebuffername.readings", 1, 3)","print(t[1], t[2], t[3])","Copy the specified readings table for buffer items 1 through 3, then display the first three readings. Example output:","4.56534e-01","4.52675e-01","4.57535e-01","Also see","None","tspnet.tsp.rbtablecopy()","14090.htm");
+Page[481]=new Array("This function loads and runs a script on a remote TSP-enabled instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","Yes","Usage","tspnet.tsp.runscript(connectionID, "script")","tspnet.tsp.runscript(connectionID, "name", "script")","connectionID","Integer value used as an identifier for other tspnet commands","name","The name that is assigned to the script","script","The body of the script as a string","Details","This function is appropriate only for TSP-enabled instruments.","This function downloads a script to a remote instrument and runs it. It automatically adds the appropriate loadscript and endscript commands around the script, captures any errors, and reads back any prompts. No additional substitutions are done on the text.","The script is automatically loaded, compiled, and run.","Any output from previous commands is discarded.","This command does not wait for the script to complete.","If you do not want the script to do anything immediately, make sure the script only defines functions for later use. Use the tspnet.execute() function to execute those functions later.","If no name is specified, the script is loaded as the anonymous script.","Example","tspnet.tsp.runscript(myconnection, "mytest",",""print([[start]]) for d = 1, 10 do print([[work]]) end print([[end]])")","Load and run a script entitled mytest on the TSP‑enabled instrument connected with myconnection.","Also see","tspnet.execute()","tspnet.tsp.runscript()","15280.htm");
+Page[482]=new Array("This function writes a string to the remote instrument.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","tspnet.write(connectionID, "inputString")","connectionID","The connection ID returned from tspnet.connect()","inputString","The string to be written","Details","The tspnet.write() function sends inputString to the remote instrument. It does not wait for command completion on the remote instrument.","The 2601B-PULSE sends inputString to the remote instrument exactly as indicated. The inputString must contain any necessary new lines, termination, or other syntax elements needed to complete properly.","Because tspnet.write() does not process output from the remote instrument, do not send commands that generate too much output without processing the output. This command can stop executing if there is too much unprocessed output from previous commands.","Example","tspnet.write(myID, "runscript()\\r\\n")","Commands the remote instrument to execute a command or script named runscript() on a remote device identified in the system as myID.","Also see","tspnet.connect()","tspnet.read()","tspnet.write()","14089.htm");
+Page[483]=new Array("This function adds a user-defined string to nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","userstring.add("name", "value")","name","The name of the string; the key of the key-value pair","value","The string to associate with name; the value of the key-value pair","Details","This function associates the string value with the string name and stores this key-value pair in nonvolatile memory.","Use the userstring.get() function to retrieve the value associated with the specified name.","You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.","Example","userstring.add("assetnumber", "236")","userstring.add("product", "Widgets")","userstring.add("contact", "John Doe")","for name in userstring.catalog() do"," print(name .. " = " .."," userstring.get(name))","end","Stores user-defined strings in nonvolatile memory and recalls them from the instrument using a for loop.","Example output:","assetnumber = 236","contact = John Doe","product = Widgets","Also see","userstring.catalog()","userstring.delete()","userstring.get()","userstring.add()","13987.htm");
+Page[484]=new Array("This function creates an iterator for the user‑defined string catalog.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","for name in userstring.catalog() do body end","name","The name of the string; the key of the key-value pair","body","Code to execute in the body of the for loop","Details","The catalog provides access for user‑defined string pairs, allowing you to manipulate all the key-value pairs in nonvolatile memory. The entries are enumerated in no particular order.","Example 1","for name in userstring.catalog() do"," userstring.delete(name)","end","Deletes all user‑defined strings in nonvolatile memory.","Example 2","userstring.add("assetnumber", "236")","userstring.add("product", "Widgets")","userstring.add("contact", "John Doe")","for name in userstring.catalog() do"," print(name .. " = " .."," userstring.get(name))","end","Prints all userstring key‑value pairs.","Output:","product = Widgets","assetnumber = 236","contact = John Doe","Notice the key-value pairs are not listed in the order they were added.","Also see","userstring.add()","userstring.delete()","userstring.get()","userstring.catalog()","13988.htm");
+Page[485]=new Array("This function deletes a user-defined string from nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","userstring.delete("name")","name","The name (key) of the key-value pair of the user‑defined string to delete","Details","This function deletes the string that is associated with name from nonvolatile memory.","Example","userstring.delete("assetnumber")","userstring.delete("product")","userstring.delete("contact")","Deletes the user-defined strings associated with the assetnumber, product, and contact names.","Also see","userstring.add()","userstring.catalog()","userstring.get()","userstring.delete()","13989.htm");
+Page[486]=new Array("This function retrieves a user-defined string from nonvolatile memory.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","value = userstring.get("name")","value","The value of the user‑defined string key-value pair","name","The name (key) of the user‑defined string","Details","This function retrieves the string that is associated with name from nonvolatile memory.","Example","userstring.add("assetnumber", "236")","value = userstring.get("assetnumber")","print(value)","Create the user-defined string assetnumber, set to a value of 236.","Read the value associated with the user-defined string named assetnumber.","Store it in a variable called value, then print the variable value.","Output:","236","Also see","userstring.add()","userstring.catalog()","userstring.delete()","userstring.get()","13990.htm");
+Page[487]=new Array("This function waits for all previously started overlapped commands to complete.","Type","TSP-Link accessible","Affected by","Where saved","Default value","Function","No","Usage","waitcomplete()","waitcomplete(group)","group","Specifies which TSP-Link group on which to wait","Details","There are two types of instrument commands:","Overlapped commands: Commands that allow the execution of subsequent commands while instrument operations of the overlapped command are still in progress.","Sequential commands: Commands whose operations must finish before the next command is executed.","The waitcomplete() command suspends the execution of commands until the instrument operations of all previous overlapped commands are finished. This command is not needed for sequential commands.","A group number may only be specified when this node is the master node.","If no group is specified, the local group is used.","If zero (0) is specified for the group, this function waits for all nodes in the system.","@ Any nodes that are not assigned to a group (group number is 0) are part of the master node's group.","Example 1","waitcomplete()","Waits for all nodes in the local group.","Example 2","waitcomplete(G)","Waits for all nodes in group G.","Example 3","waitcomplete(0)","Waits for all nodes on the TSP-Link network.","Also see","None","waitcomplete()","13986.htm");
+Page[488]=new Array("See the "2-wire local sensing connections" topic in the 2601B-PULSE reference manual.","2-wire local sensing connections","19568.htm");
+Page[489]=new Array("See the "4-wire remote sensing connections" topic in the 2601B-PULSE reference manual.","4-wire remote sensing connections","19569.htm");
+Page[490]=new Array("See the "Adjustment" topic in the 2601B-PULSE reference manual.","Adjustment","19563.htm");
+Page[491]=new Array("The 2601B-PULSE SMUs have an integrating analog-to-digital converter (ADC). The integrating ADC uses a ratiometric analog-to-digital conversion technique. Depending on the configuration of the integrating ADC, periodic fresh reference measurements are required to minimize drift. The measurement aperture is used to determine the time interval between these measurement updates. For additional information, see Autozero. To help optimize operation of this ADC, the instrument caches the reference and zero values for up to ten of the most recent number of power line cycles. For additional information, see NPLC caching.","Analog-to-digital converter","18560.htm");
+Page[492]=new Array("If a script is created with the loadscript or loadandrunscript command with no name defined, it is called the anonymous script. There can only be one anonymous script in the runtime environment. If another anonymous script is loaded into the runtime environment, it replaces the existing anonymous script.","Anonymous scripts","10835.htm");
+Page[493]=new Array("To use automatic source ranging, press SRC then the AUTO range key.","To use automatic measure ranging, press the MEAS key followed by the AUTO range key. The AUTO indicator turns on when source or measure autoranging is selected.","When autorange is selected, the instrument automatically sets the best range to source or measure the applied signal. The instrument will uprange at 100 percent of the present range.","@When you change a source value, source autoranging is automatically turned off and remains off until you re‑enable it.","Autoranging","13605.htm");
+Page[494]=new Array("The ADC of the 2601B-PULSE uses a ratiometric A/D conversion technique. To ensure reading accuracy, the instrument must periodically obtain fresh measurements of its internal ground and voltage reference. Separate reference and zero measurements are used for each aperture.","As summarized in the table below, there are different settings for autozero. By default, the instrument is set to AUTO, which automatically checks these reference measurements whenever a signal measurement is made. If the reference measurements are out of date when a signal measurement is made, the instrument automatically makes two more A/D conversions, one for the reference and one for the zero, before returning the result. Thus, occasionally, a measurement takes longer than normal.","This extra time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the extra time for the reference measurements in these situations, you can select OFF. This setting disables the automatic reference measurements. Note that with automatic reference measurements disabled, the instrument may gradually drift out of specification.","To minimize the drift, a reference and zero measurement should be made immediately before a critical test sequence. The ONCE setting can be used to force a refresh of the reference and zero measurements used for the current aperture setting.","Autozero settings","Autozero setting","Description","OFF","Turns automatic reference measurements off.","ONCE","After immediately making one reference and one zero measurement, turns automatic reference measurements off. ","AUTO","Automatically takes new acquisitions when the 2601B-PULSE determines reference and zero values are out-of-date.","Autozero","11440.htm");
+Page[495]=new Array("Base library functions","Function","Description","collectgarbage()","collectgarbage(limit)","Sets the garbage-collection threshold to the given limit (in kilobytes) and checks it against the byte counter. If the new threshold is smaller than the byte counter, Lua immediately runs the garbage collector. If there is no limit parameter, it defaults to zero (0), which forces a garbage‑collection cycle. See Lua memory management for more information.","gcinfo()","Returns the number of kilobytes of dynamic memory that the Test Script Processor (TSP®) scripting engine is using and returns the present garbage collector threshold (also in kilobytes). See Lua memory management for more information.","tonumber(x)","tonumber(x, base)","Returns x converted to a number. If x is already a number, or a convertible string, the number is returned; otherwise, it returns nil.","An optional argument specifies the base to use when interpreting the numeral. The base may be any integer from 2 to 36, inclusive. In bases above 10, the letter A (in either upper or lower case) represents 10, B represents 11, and so forth, with Z representing 35. In base 10, the default, the number may have a decimal part, as well as an optional exponent. In other bases, only unsigned integers are accepted.","tostring(x)","Receives an argument of any type and converts it to a string in a reasonable format.","type(v)","Returns (as a string) the type of its only argument. The possible results of this function are "nil" (a string, not the value nil), "number", "string", "boolean", "table", "function", "thread", and "userdata".","Base library functions","2430.htm");
+Page[496]=new Array("See the "Calibration" topic in the 2601B-PULSE reference manual.","Calibration","19570.htm");
+Page[497]=new Array("A history of the key code for the last pressed front‑panel key is maintained by the 2601B-PULSE. When the instrument is turned on (or when transitioning from local to remote operation), the key code is set to 0 (display.KEY_NONE).","When a front‑panel key is pressed, the key code value for that key can be captured and returned. There are two functions associated with the capture of key-press codes: display.getlastkey() and display.waitkey().","Capturing key-press codes","12125.htm");
+Page[498]=new Array("See the "Configuring and running sweeps" topic in the 2601B-PULSE reference manual.","Configuring and running sweeps","19567.htm");
+Page[499]=new Array("See the "Contact check connections" topic in the 2601B-PULSE reference manual.","Contact check connections","19564.htm");
+Page[500]=new Array("See the "Contact check measurements" topic in the 2601B-PULSE reference manual.","Contact check measurements","19565.htm");
+Page[501]=new Array("See the "Controlling digital I/O lines" topic in the 2601B-PULSE reference manual.","Controlling digital I/O lines","11274.htm");
+Page[502]=new Array("See the "Create a script using the script.new() command" topic in the 2601B-PULSE reference manual.","Create a script using the script.new() command","19556.htm");
+Page[503]=new Array("@These steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you must take. See Delete user scripts from the instrument.","To delete a script from nonvolatile memory using a remote interface:","You can delete the script from nonvolatile memory by sending either of the following commands:","script.delete("name")","script.user.delete("name")","Where: name is the user-defined name of the script.","Example: Delete a user script from nonvolatile memory","script.delete("test8")","Delete a user script named test8 from nonvolatile memory.","Delete user scripts","16805.htm");
+Page[504]=new Array("In most circumstances, you can delete a script using script.delete() (as described in Delete user scripts), and then turn the instrument off and back on again. However, if you cannot turn the instrument off, you can use the following steps to completely remove a script from the instrument.","When you completely remove a script, you delete all references to the script from the runtime environment, the script.user.scripts table, and nonvolatile memory.","To completely remove a script:","Remove the script from the runtime environment. Set any variables that refer to the script to nil or assign the variables a different value. For example, to remove the script "beepTwoSec" from the runtime environment, send the following code: beepTwoSec = nil","Remove the script from the script.user.scripts table. Set the name attribute to an empty string (""). This makes the script nameless, but does not make the script become the anonymous script. For example, to remove the script named "beepTwoSec", send the following code: script.user.scripts.beepTwoSec.name = ""","Remove the script from nonvolatile memory. To delete the script from nonvolatile memory, send the command: script.delete("name")","Where name is the name that the script was saved as. For example, to delete "beepTwoSec", you would send: script.delete("beepTwoSec")","Delete user scripts from the instrument","2408.htm");
+Page[505]=new Array("See the "Digital I/O" topic in the 2601B-PULSE reference manual.","Digital I/O","19553.htm");
+Page[506]=new Array("Bit weighting for the digital I/O lines is shown in the following table.","Digital bit weight","Line #","Bit","Decimal weighting","Hexadecimal weighting","1","B1","1","0x0001","2","B2","2","0x0002","3","B3","4","0x0004","4","B4","8","0x0008","5","B5","16","0x0010","6","B6","32","0x0020","7","B7","64","0x0040","8","B8","128","0x0080","9","B9","256","0x0100","10","B10","512","0x0200","11","B11","1,024","0x0400","12","B12","2,048","0x0800","13","B13","4,096","0x1000","14","B14","8,192","0x2000","Digital I/O bit weighting","11500.htm");
+Page[507]=new Array("The Keithley Instruments 2601B-PULSE System SourceMeter® instrument has a digital input/output port that can be used to control external digital circuitry. For example, a handler that is used to perform binning operations can be used with a digital I/O port.","Digital I/O port","12451.htm");
+Page[508]=new Array("Use the DISPLAY key to scroll through the display modes shown in the figure below.","Display mode","92127.htm");
+Page[509]=new Array("Display resolution for measured readings can be set to 4-1/2, 5-1/2 or 6-1/2. Configure the type of resolution displayed by setting the display.smua.digits attribute. The following programming example illustrates how to set 5-1/2 digit resolution for measured readings:","display.smua.digits = display.DIGITS_5_5","Display resolution","12137.htm");
+Page[510]=new Array("See the "DUT test connections" topic in the 2601B-PULSE reference manual.","DUT test connections","19573.htm");
+Page[511]=new Array("The error queue holds error and status messages. As programming errors and status messages occur, a message that defines the error or status is placed in the error queue.","An error or status message is cleared from the error queue when it is read. You can also clear the error queue by sending the command errorqueue.clear(). An empty error queue clears the error available (EAV) bit in the Status Byte Register.","Messages in the error queue include a code number, message text, severity, and TSP-Link® node number. See Error summary list for a list of the messages.","When you read a single message from the error queue, the oldest message is read. If you attempt to read the error queue when it is empty, the error number 0 and “No Error” is returned.","The commands that can be used to control the error queue are listed below.","Error queue commands","Error queue command","Description","errorqueue.clear()","Clear error queue of all errors.","errorqueue.count","Number of messages in the error/event queue.","errorCode, message,"," severity, errorNode ="," errorqueue.next()","Request error code, text message, severity, and TSP-Link node number.","Error queue","12259.htm");
+Page[512]=new Array("Error summary","Error number","Error level","Error message","-430","RECOVERABLE","Query DEADLOCKED","-420","RECOVERABLE","Query UNTERMINATED","-410","RECOVERABLE","Query INTERRUPTED","-363","RECOVERABLE","Input buffer overrun","-360","RECOVERABLE","Communications error","-350","RECOVERABLE","Queue overflow","-315","RECOVERABLE","Configuration memory lost","-314","RECOVERABLE","Save/recall memory lost","-292","RECOVERABLE","Referenced name does not exist","-286","RECOVERABLE","TSP Runtime error","-285","RECOVERABLE","Program syntax","-282","RECOVERABLE","Illegal program name","-281","RECOVERABLE","Cannot create program","-225","RECOVERABLE","Out of memory or TSP Memory allocation error","-224","RECOVERABLE","Illegal parameter value","-222","RECOVERABLE","Parameter data out of range","-221","RECOVERABLE","Settings conflict","-220","RECOVERABLE","Parameter error","-211","RECOVERABLE","Trigger ignored","-203","RECOVERABLE","Command protected","-154","RECOVERABLE","String too long","-151","RECOVERABLE","Invalid string data","-110","RECOVERABLE","Command header error","-109","RECOVERABLE","Missing parameter","-108","RECOVERABLE","Parameter not allowed","-105","RECOVERABLE","Trigger not allowed","-104","RECOVERABLE","Data type error","0","NO_SEVERITY","Queue Is Empty","503","RECOVERABLE","Calibration overflow","601","RECOVERABLE","Reading buffer data lost","603","RECOVERABLE","Power on state lost","702","FATAL","Unresponsive digital FPGA","802","RECOVERABLE","OUTPUT blocked by interlock","819","RECOVERABLE","Error parsing exponent","820","RECOVERABLE","Error parsing value","900","FATAL","Internal system error","1100","RECOVERABLE","Command unavailable","1101","RECOVERABLE","Parameter too big","1102","RECOVERABLE","Parameter too small","1103","RECOVERABLE","Min greater than max","1104","RECOVERABLE","Too many digits for param type","1105","RECOVERABLE","Too many parameters","1107","RECOVERABLE","Cannot modify factory menu","1108","RECOVERABLE","Menu name does not exist","1109","RECOVERABLE","Menu name already exists","1110","FATAL","Analog supply failure: over temperature","1113","RECOVERABLE","Data too complex","1122","SERIOUS","Interlock or power supply failure","1200","RECOVERABLE","TSP-Link initialization failed","1202","RECOVERABLE","TSP-Link initialization failed","1203","RECOVERABLE","TSP-Link initialization failed (possible loop in node chain)","1204","RECOVERABLE","TSP-Link initialization failed","1205","RECOVERABLE","TSP-Link initialization failed (no remote nodes found)","1206","RECOVERABLE","TSP-Link initialization failed","1207","RECOVERABLE","TSP-Link initialization failed","1208","RECOVERABLE","TSP-Link initialization failed","1209","RECOVERABLE","TSP-Link initialization failed","1210","RECOVERABLE","TSP-Link initialization failed (node ID conflict)","1211","RECOVERABLE","Node NN is inaccessible","1212","RECOVERABLE","Invalid node ID","1213","RECOVERABLE","TSP-Link session expired","1215","RECOVERABLE","Code execution requested within the local group","1216","RECOVERABLE","Remote execution requested on node in group with pending overlapped operations","1217","RECOVERABLE","Remote execution requested on node outside the local group","1218","RECOVERABLE","Operation allowed only when TSP-Link master","1219","RECOVERABLE","TSP-Link found fewer nodes than expected","1400","RECOVERABLE","Expected at least NN parameters","1401","RECOVERABLE","Parameter NN is invalid","1402","RECOVERABLE","User scripts lost","1403","RECOVERABLE","Factory scripts lost","1404","RECOVERABLE","Invalid byte order","1405","RECOVERABLE","Invalid ASCII precision","1406","RECOVERABLE","Invalid data format","1500","RECOVERABLE","Invalid baud rate setting","1501","RECOVERABLE","Invalid parity setting","1502","RECOVERABLE","Invalid terminator setting","1503","RECOVERABLE","Invalid bits setting","1504","RECOVERABLE","Invalid flow control setting","1600","RECOVERABLE","Maximum GPIB message length exceeded","1700","RECOVERABLE","Display area boundary exceeded","1800","RECOVERABLE","Invalid digital trigger mode","1801","RECOVERABLE","Invalid digital I/O line","2000","SERIOUS","Flash download error","2001","RECOVERABLE","Cannot flash with error in queue","2101","FATAL","Could not close socket","2102","RECOVERABLE","Lan configuration already in progress","2103","RECOVERABLE","Lan disabled","2104","RECOVERABLE","Socket error","2105","RECOVERABLE","Unreachable gateway","2106","RECOVERABLE","Could not acquire ip address","2110","RECOVERABLE","Could not resolve hostname","2111","RECOVERABLE","DNS name (FQDN) too long","2112","RECOVERABLE","Connection not established","2200","RECOVERABLE","File write error","2201","RECOVERABLE","File read error","2202","RECOVERABLE","Cannot close file","2203","RECOVERABLE","Cannot open file","2204","RECOVERABLE","Directory not found","2205","RECOVERABLE","File not found","2206","RECOVERABLE","Cannot read current working directory","2207","RECOVERABLE","Cannot change directory","2211","RECOVERABLE","File system error","2212","RECOVERABLE","File system command not supported","2213","RECOVERABLE","Too many open files","2214","RECOVERABLE","File access denied","2215","RECOVERABLE","Invalid file handle","2216","RECOVERABLE","Invalid drive","2217","RECOVERABLE","File system busy","2218","RECOVERABLE","Disk full","2219","RECOVERABLE","File corrupt","2220","RECOVERABLE","File already exists","2221","RECOVERABLE","File seek error","2222","RECOVERABLE","End-of-file error","2223","RECOVERABLE","Directory not empty","2400","RECOVERABLE","Invalid specified connection","2401","RECOVERABLE","Invalid timeout seconds (.001 to 30)","2402","RECOVERABLE","TSPnet remote error: XXX, where XXX explains the remote error","2403","RECOVERABLE","TSPnet failure","2404","RECOVERABLE","TSPnet read failure","2405","RECOVERABLE","TSPnet read failure, aborted","2406","RECOVERABLE","TSPnet read failure, timeout","2407","RECOVERABLE","TSPnet write failure","2408","RECOVERABLE","TSPnet write failure, aborted","2409","RECOVERABLE","TSPnet write failure, timeout","2410","RECOVERABLE","TSPnet max connections reached","2411","RECOVERABLE","TSPnet connection failed","2412","RECOVERABLE","TSPnet invalid termination","2413","RECOVERABLE","TSPnet invalid reading buffer table","2414","RECOVERABLE","TSPnet invalid reading buffer index range","2415","RECOVERABLE","TSPnet feature only supported on TSP connections","2416","RECOVERABLE","TSPnet must specify both port and init","2417","RECOVERABLE","TSPnet disconnected by other side","2418","RECOVERABLE","TSPnet read input buffer overflow","2419","RECOVERABLE","Invalid format specifier","2420","RECOVERABLE","Termination locked while using TSP connection","2500","RECOVERABLE","Average delay must be at least NNN seconds","4900","RECOVERABLE","Reading buffer index NN is invalid","4903","RECOVERABLE","Reading buffer expired","4904","SERIOUS","ICX parameter count mismatch, %s (Line #%d)","4905","SERIOUS","ICX parameter invalid value, %s (Line #%d)","4906","SERIOUS","ICX invalid function id, %s (Line #%d)","5001","FATAL","SMU is unresponsive. Disconnect DUT and cycle power","5003","SERIOUS","Saved calibration constants corrupted","5004","RECOVERABLE","Operation conflicts with CALA sense mode","5005","RECOVERABLE","Value too big for range","5007","RECOVERABLE","Operation would exceed safe operating area of the instrument","5008","RECOVERABLE","Operation not permitted while OUTPUT is on","5009","SERIOUS","Unknown sourcing function","5010","SERIOUS","No such SMU function","5011","RECOVERABLE","Operation not permitted while cal is locked","5012","RECOVERABLE","Cal data not saved - save or restore before lock","5013","RECOVERABLE","Cannot save cal data - unlock before save","5014","RECOVERABLE","Cannot restore cal data - unlock before restore","5015","RECOVERABLE","Save to cal set disallowed","5016","RECOVERABLE","Cannot change cal date - unlock before operation","5017","RECOVERABLE","Cannot change cal constants - unlock before operation","5018","SERIOUS","Cal version inconsistency","5019","RECOVERABLE","Cannot unlock - invalid password","5021","SERIOUS","Cannot restore default calset. Using previous calset","5022","SERIOUS","Cannot restore previous calset. Using factory calset","5023","SERIOUS","Cannot restore factory calset. Using nominal calset","5024","SERIOUS","Cannot restore nominal calset. Using firmware defaults","5025","RECOVERABLE","Cannot set filter.count > 1 when measure.count > 1","5027","RECOVERABLE","Unlock cal data with factory password","5028","RECOVERABLE","Cannot perform requested operation while source autorange is enabled","5029","RECOVERABLE","Cannot save without changing cal adjustment date","5032","RECOVERABLE","Cannot change this setting unless buffer is cleared","5033","RECOVERABLE","Reading buffer not found within device","5038","RECOVERABLE","Index exceeds maximum reading","5040","RECOVERABLE","Cannot use same reading buffer for multiple overlapped measurements","5042","RECOVERABLE","Cannot perform requested action while an overlapped operation is in progress","5043","RECOVERABLE","Cannot perform requested operation while voltage measure autorange is enabled","5044","RECOVERABLE","Cannot perform requested operation while current measure autorange is enabled","5045","RECOVERABLE","Cannot perform requested operation while filter is enabled","5046","SERIOUS","SMU too hot","5047","RECOVERABLE","Minimum timestamp resolution is 1us","5048","RECOVERABLE","Contact check not valid with HIGH-Z OUTPUT off","5049","RECOVERABLE","Contact check not valid while an active current source","5050","RECOVERABLE","I limit too low for contact check","5051","FATAL","Model number/SMU hardware mismatch. Disconnect DUT and cycle power","5053","RECOVERABLE","Unstable output detected - Measurements may not be valid","5055","RECOVERABLE","Cannot change adjustment date - change cal constants before operation","5059","RECOVERABLE","trigger.source.action enabled without configuration","5060","RECOVERABLE","trigger.measure.action enabled without configuration","5061","RECOVERABLE","Operation not permitted while OUTPUT is off","5062","SERIOUS","SMU overload. Automatic OUTPUT off.","5063","RECOVERABLE","Cannot perform requested operation while measure autozero is on","5064","RECOVERABLE","Cannot use reading buffer that collects source values","5065","RECOVERABLE","I range too low for contact check","5066","RECOVERABLE","source.offlimiti too low for contact check","5069","SERIOUS","Autorange locked for HighC mode","5108","RECOVERABLE","Maximum pulse width exceeded","5109","RECOVERABLE","Maximum duty cycle exceeded","5111","RECOVERABLE","Total measure time exceeds pulse width","5126","RECOVERABLE","Operation not permitted while pulser is enabled","5127","RECOVERABLE","Output protection level exceeded","5128","RECOVERABLE","Pulse width too small","5129","RECOVERABLE","Measure time exceeds measure interval ","5130","RECOVERABLE","Filter type not permitted while pulser is enabled ","5131","RECOVERABLE","Current source as off-function not permitted while pulser is enabled","5132","RECOVERABLE","Voltage sweeps not permitted while pulser is enabled","5133","RECOVERABLE","Measure stimulus not allowed with pulser measure delay when pulser is enabled","5134","RECOVERABLE","Measure stimulus requires asynchronous measure when pulser is enabled","5135","RECOVERABLE","Measure not permitted with output off when pulser is enabled","5136","RECOVERABLE","Measure count too big with pulser enabled","5137","RECOVERABLE","Measure interval too big with pulser enabled","5138","RECOVERABLE","trigger.source.action required when pulser is enabled","5139","RECOVERABLE","trigger.source.stimulus required when pulser is enabled","5140","RECOVERABLE","Measure stimulus or measure delay required when pulser is enabled","5141","RECOVERABLE","Pulse width not permitted when pulser is disabled","5142","RECOVERABLE","Measure count multiplied by filter count is too big","5143","RECOVERABLE","End pulse stimulus or pulse width required when pulser is enabled","5144","RECOVERABLE","Maximum measurement rate exceeded","5145","RECOVERABLE","Maximum pulse rate exceeded","Error summary list","93187.htm");
+Page[513]=new Array("The filter feature lets you set the filter response to stabilize noisy measurements. The 2601B-PULSE uses a digital filter, which is based on reading conversions. The displayed, stored, or transmitted reading is calculated using one or more reading conversions (from 1 to 100).","Filters","11532.htm");
+Page[514]=new Array("See the "Front panel" topic in the 2601B-PULSE reference manual.","Front panel","93212.htm");
+Page[515]=new Array("See the "Global variables and the script.user.scripts table" topic in the 2601B-PULSE reference manual.","Global variables and the script.user.scripts table","19557.htm");
+Page[516]=new Array("See the "GPIB setup" topic in the 2601B-PULSE reference manual.","GPIB setup","24524.htm");
+Page[517]=new Array("See the "High-capacitance mode" topic in the 2601B-PULSE reference manual.","High-capacitance mode","19566.htm");
+Page[518]=new Array("See the "Load a script by sending commands over the remote interface" topic in the 2601B-PULSE reference manual.","Load a script by sending commands over the remote interface","19559.htm");
+Page[519]=new Array("The logical operators in Lua are and, or, and not. All logical operators consider both false and nil as false and anything else as true.","The operator not always returns false or true.","The conjunction operator and returns its first argument if the first argument is false or nil; otherwise, and returns its second argument. The disjunction operator or returns its first argument if this value is different from nil and false; otherwise, or returns its second argument. Both and and or use shortcut evaluation, that is, the second operand is evaluated only if necessary.","@ The example output you get may vary depending on the data format settings of the instrument.","Example","print(10 or errorqueue.next())","print(nil or "a")","print(nil and 10)","print(false and errorqueue.next())","print(false and nil)","print(false or nil)","print(10 and 20)","1.00000e+01","a","nil","false","false","nil","2.00000e+01","Logical operators","12893.htm");
+Page[520]=new Array("The measure delay is a specific delay that is applied before each measurement is made. This delay is disabled by default (measurements are made immediately). You can change the default delay by setting the smua.measure.delay attribute either to a specific value or to an auto delay setting (set smua.measure.delay = smua.DELAY_AUTO). If the measure delay is set to the auto delay setting, a range-dependent delay is applied each time the instrument performs a current measurement. This delay also happens for the measurement that is taken after changing current ranges during an autoranged measurement. The default measurement delay varies by model.","You can increase or decrease the auto delay by changing the delay factor (for example, to reduce the delay across all ranges by half, set smua.measure.delayfactor = 0.5). For additional information, refer to smua.measure.delayfactor in the "Remote commands" section.","Measure auto delay","19632.htm");
+Page[521]=new Array("See the "Measurement event registers" topic in the 2601B-PULSE reference manual.","Measurement event registers","19571.htm");
+Page[522]=new Array("See the "Named scripts" topic in the 2601B-PULSE reference manual.","Named scripts","19558.htm");
+Page[523]=new Array("See the "Operation Status Registers" topic in the 2601B-PULSE reference manual.","Operation Status Registers","19578.htm");
+Page[524]=new Array(" ","@Carefully consider and configure the appropriate output-off state, source, and compliance limits before connecting the 2601B-PULSE to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2601B-PULSE instruments). Configure recommended instrument settings before making connections to the device. Failure to consider the output-off state, source, and compliance limits may result in damage to the instrument or to the device under test (DUT).","Output-off states","15424.htm");
+Page[525]=new Array("See the "Pulser operation" topic in the 2601B-PULSE reference manual.","Pulser operation","93214.htm");
+Page[526]=new Array("See the "Questionable Status Registers" topic in the 2601B-PULSE reference manual.","Questionable Status Registers","19579.htm");
+Page[527]=new Array("See the "Queues" topic in the 2601B-PULSE reference manual.","Queues","19552.htm");
+Page[528]=new Array("The selected measurement range affects the accuracy of the measurements and the maximum signal that can be measured. If the range is changed, the front‑panel display may contain dashes instead of a reading (for example, --.---- mA). This indicates that no measurement was made using the range that is presently selected. To update the displayed reading, trigger a measurement (if in local control, press the TRIG key).","Range","11993.htm");
+Page[529]=new Array("Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2601B-PULSE. The 2601B-PULSE has two default reading buffers. In addition to the default buffers, you can create user-defined reading buffers. You can use the reading buffers to acquire readings.","You can access reading buffers from the front panel or over the remote command interface.","The default reading buffers can store can store over 60,000 readings if you enable the options for timestamps and source values. To store over 140,000 readings internally, you can disable the timestamps and source values.","You can save reading buffers to internal nonvolatile memory in the instrument or to a USB flash drive.","Once you save the reading buffers to a USB flash drive, insert the USB flash drive into the USB port on your computer to view the data in any compatible data analysis application or to transfer the data from the USB flash drive to your computer.","Overview","13629.htm");
+Page[530]=new Array("When making measurements, you may want to subtract an offset value from a measurement. ","The relative offset feature subtracts a set value or a baseline reading from measurement readings. When you enable relative offset, all measurements are recorded as the difference between the actual measured value and the relative offset value. The formula to calculate the offset value is:","Displayed value = Actual measured value - Relative offset value","When a relative offset value is established for a measure function, the value is the same for all ranges for that measure function. For example, if 0.5 A is set as a relative offset value on the 1 A range, the relative offset value is also 0.5 A on the lower current ranges. Also, on the 1 A range, the 2601B-PULSE still overflows for a more than 1.02 A input.","When relative offset is enabled, the REL indicator turns on. Changing measurement functions changes the relative offset value to the established relative offset value and state for that measurement function.","Relative offset","12001.htm");
+Page[531]=new Array("You can get readings by making overlapped or sequential measurements. Overlapped commands do not finish executing before the next command starts. Sequential commands complete execution before the next command starts executing.","The measured value is not the only component of a reading. The measurement status (for example, “In Compliance” or “Overranged”) is also an element of data associated with a particular reading.","All routines that return measurements can store the measurements in the reading buffers. Overlapped measurements always return readings in a reading buffer. Non-overlapped measurement functions can return single-point measurement values or store multiple values in a reading buffer.","A reading buffer is based on a Lua table. The measurements are accessed by ordinary array accesses. If rb is a reading buffer, the first measurement is accessed as rb[1] and the ninth measurement as rb[9]. The additional information in the table is accessed as additional members of the table.","The load, save, and write operations for reading buffers function differently in the remote state. From a remote command interface, you can extract data from reading buffers as the instrument acquires the data.","Remote reading buffer programming","11655.htm");
+Page[532]=new Array("The node that acquires the data also stores the data for the reading buffer. To optimize data access, all nodes can cache data from the node that stores the reading buffer data.","When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale. If the values in the reading buffer change while the Lua code runs remotely, another node can hold stale values. Use the clearcache() command to clear the cache. For additional detail on the reading buffer cache commands, see bufferVar.cachemode and bufferVar.clearcache().","The following example code demonstrates how stale values occur and how to use the clearcache() command to clear the cache on node 2, which is part of group 7.","-- Create a reading buffer on a node in a remote group.","node[2].tsplink.group = 7","node[2].execute("rbremote = smua.makebuffer(20)" .."," "smua.measure.count = 20 " .."," "smua.measure.v(rbremote)")","-- Create a variable on the local node to","-- access the reading buffer.","rblocal = node[2].getglobal("rbremote")","-- Access data from the reading buffer.","print(rblocal[1])","-- Run code on the remote node that updates the reading buffer.","node[2].execute("smua.measure.v(rbremote)")","-- Use the clearcache command if the reading buffer contains cached data.","rblocal.clearcache()","-- If you do not use the clearcache command, the data buffer","-- values will never update. Every time the print command is","-- issued after the first print command, the same data buffer","-- values will print.","print(rblocal[1])","Removing stale values from the reading buffer cache","3249.htm");
+Page[533]=new Array("See the "Rename a script" topic in the 2601B-PULSE reference manual.","Rename a script","19560.htm");
+Page[534]=new Array("To retrieve the source code one line at a time, send the scriptVar.list() command. When this command is received, the instrument sends the entire script. Each line of the script is sent as a separate response message. The output includes the loadscript or loadandrunscript and endscript keywords.","After retrieving the source code, you can modify and save the command lines as a user script under the same name or a new name.","To retrieve the source code of a script one line at a time, send the command:","scriptVar.list()","Where scriptVar is the name of the script.","@To retrieve the commands in the anonymous script, use script.anonymous.list().","Example: Retrieve source code one line at a time","test.list()","Retrieve the source of a script named "test".","The output will look similar to:","loadscript test","display.clear()","display.settext("This is a test")","print("This is a test")","endscript ","Retrieve source code one line at a time","17030.htm");
+Page[535]=new Array("See the "RS-232 interface operation" topic in the 2601B-PULSE reference manual.","RS-232 interface operation","19561.htm");
+Page[536]=new Array("You can save scripts to nonvolatile memory using commands.","Only named scripts can be saved to nonvolatile memory. The anonymous script must be named before it can be saved to nonvolatile memory.","@If a script is not saved to nonvolatile memory, the script is lost when the instrument is turned off.","Save a user script","16803.htm");
+Page[537]=new Array("See the "Saved setups" topic in the 2601B-PULSE reference manual.","Saved setups","19562.htm");
+Page[538]=new Array("The sense mode can be set to use 2-wire local sensing connections or 4-wire remote sensing connections. The default sense setting is 2-wire local.","Sense mode selection","11848.htm");
+Page[539]=new Array("See the "Setting a value" topic in the 2601B-PULSE reference manual.","Setting a value","29272.htm");
+Page[540]=new Array("Depending on how it is programmed and what is connected to the output (load or source), the instrument can operate in any of the four quadrants. The four quadrants of operation are shown in the continuous operating boundaries figures. When operating in the first (I) or third (III) quadrant, the instrument is operating as a source (V and I have the same polarity). As a source, the instrument is delivering power to a load.","When operating in the second (II) or fourth (IV) quadrant, the instrument is operating as a sink (V and I have opposite polarity). As a sink, it is dissipating power rather than sourcing it. An external source or an energy storage device, such as a capacitor or battery, can force operation in the sink region.","Source or sink","11584.htm");
+Page[541]=new Array("See the "Source-measure concepts" topic in the 2601B-PULSE reference manual.","Source-measure concepts","19572.htm");
+Page[542]=new Array(" The SPEED key can select and control the analog-to-digital converter (ADC) through setting the integration time, or measurement aperture (the period of time the input signal is measured). The integration time affects the usable digits, the amount of reading noise, and the reading rate of the instrument. The integration time is specified in parameters based on the number of power line cycles (NPLC), where 1 PLC for 60 Hz is 16.67 ms (1/60) and 1 PLC for 50 Hz is 20 ms (1/50).","In general, the fastest integration time (0.001 PLC) results in the fastest reading rate, but also causes increased reading noise and fewer usable digits. The slowest integration time (25 PLC) provides the best common-mode and normal-mode noise rejection, but has the slowest reading rate. Settings between the fastest and slowest integration times are a compromise between speed and noise. The default power‑on speed setting is NORMAL (1 PLC).","Speed","11998.htm");
+Page[543]=new Array("See the "Standard Event Register" topic in the 2601B-PULSE reference manual.","Standard Event Register","19580.htm");
+Page[544]=new Array("You can specify the 2601B-PULSE start-up (power-on) configuration. Use the setup.poweron attribute to select which setup to return to upon power-up. To set the setup.poweron configuration attribute:","setup.poweron = n -- Select power-on setup.","Where n is:","0 (*RST or reset() factory defaults)","1 to 5 (user setup 1 to 5)","Start-up (power-on) configuration","11613.htm");
+Page[545]=new Array("See the "Status byte and service request (SRQ)" topic in the 2601B-PULSE reference manual.","Status byte and service request (SRQ)","19576.htm");
+Page[546]=new Array("See the "Status Model" topic in the Model 2601B-PULSE Reference Manual.","Status model","19551.htm");
+Page[547]=new Array("See the "Status model overview" topic in the 2601B-PULSE reference manual.","Status model overview","19575.htm");
+Page[548]=new Array("See the "Sweep operation" topic in the 2601B-PULSE reference manual.","Sweep operation","19550.htm");
+Page[549]=new Array("See the "System summary and standard event registers" topic in the 2601B-PULSE reference manual.","System summary and standard event registers","19581.htm");
+Page[550]=new Array("See the "Triggering" topic in the 2601B-PULSE reference manual.","Triggering","19574.htm");
+Page[551]=new Array("See the "TSP advanced features" topic in the 2601B-PULSE reference manual.","TSP advanced features","19555.htm");
+Page[552]=new Array("See the "TSP-Link" topic in the 2601B-PULSE reference manual.","TSP-Link","19554.htm");
+Page[553]=new Array("The 2601B-PULSE has three trigger lines that you can use for triggering, digital I/O, and to synchronize multiple instruments on a TSP-Link® network.","TSP-Link trigger lines","92304.htm");
+Page[554]=new Array("LAN triggering is similar to hardware synchronization except that LXI trigger packets are used instead of hardware signals. A bit in the LXI trigger packet called the hardware value simulates the state of a hardware trigger line. The 2601B-PULSE stores the hardware value of the last LXI trigger packet that was sent or received as the pseudo line state.","The stateless event flag is a bit in the LXI trigger packet that indicates if the hardware value should be ignored. If it is set, the 2601B-PULSE ignores the hardware value of the packet and generates a trigger event. The 2601B-PULSE always sets the stateless flag for outgoing LXI trigger packets. If the stateless event flag is not set, the hardware value indicates the state of the signal.","Changes in the hardware value of consecutive LXI trigger packets are interpreted as edge transitions. Edge transitions generate trigger events. If the hardware value does not change between successive LXI trigger packets, the 2601B-PULSE assumes an edge transition was missed and generates a trigger event. The following table illustrates edge detection in LAN triggering.","LXI trigger edge detection","Stateless event flag","Hardware value","Pseudo line state","Falling edge","Rising edge","0","0","0","Detected","Detected","0","1","0","-","Detected","0","0","1","Detected","-","0","1","1","Detected","Detected","1","-","-","Detected","Detected","Set the LAN trigger mode to configure the edge detection method in incoming LXI trigger packets. The mode that is selected also determines the hardware value in outgoing LXI trigger packets. The following table lists the LAN trigger modes.","LAN trigger modes","Trigger mode","Input detected","Output generated","Notes","Either edge","Either","Negative","Falling edge","Falling","Negative","Rising edge","Rising","Positive","RisingA","Rising","Positive","Same as Rising","RisingM","Rising","Positive","Same as Rising","Synchronous","Falling","Positive","Same as SynchronousA","SynchronousA","Falling","Positive","SynchronousM","Rising","Negative","The programming example below illustrates how to configure the LAN trigger mode.","-- Set LAN trigger 2 to have falling-edge mode.","lan.trigger[2].mode = lan.TRIG_FALLING","Understanding hardware value and pseudo line state","12571.htm");
+Page[555]=new Array("See the "Upgrading the firmware" topic in the 2601B-PULSE reference manual.","Upgrading the firmware","93219.htm");
+Page[556]=new Array("The primary purpose of groups is to allow each group to run a different test script simultaneously.","A group can consist of one or more nodes. You must assign group numbers to each node using remote commands. If you do not assign a node to a group, it defaults to group 0, which will always be grouped with the master node (regardless of the group to which the master node is assigned).","Using groups to manage nodes on TSP-Link network","3240.htm");
+Page[557]=new Array("Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data. You can use the data queue to post numeric values, strings, and tables. ","Use the data queue commands to:","Share data between test scripts running in parallel","Access data from a remote group or a local node on a TSP‑Link® network at any time","You cannot access the reading buffers or global variables from any node in a remote group while a node in that group is performing an overlapped operation. However, you can use the data queue to retrieve data from any node in a group that is performing an overlapped operation. In addition, the master node and the group leaders can use the data queue to coordinate activities.","Tables in the data queue consume one entry. When a node stores a table in the data queue, a copy of the data in the table is made. When the data is retrieved from the data queue, a new table is created on the node that is retrieving the data. The new table contains a separate copy of the data in the original table, with no references to the original table or any subtables.","You can access data from the data queue even if a remote group or a node has overlapped operations in process. See the dataqueue commands in the TSP command reference for more information.","Using the data queue for real-time communication","3247.htm");
+Page[558]=new Array("See the "Using the interlock" topic in the 2601B-PULSE reference manual.","Using the interlock","93213.htm");
+var PageCount=559;
+
+function search(SearchWord){
+var Result="";
+var NrRes=0;
+Result='\n';
+Result+="\n";
+Result+="\n";
+Result+="\n";
+Result+="Search Results\n";
+Result+='\n';
+Result+='\n';
+Result+="\n";
+Result+="\n";
+Result+="\n";
+Result+='
.
+
+
