Series 2600B System SourceMeter® instrument Reference Manual Section 9: TSP command reference
2600BS-901-01 Rev. F/August 2021 9-77
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.
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.
Allows operators to enter positive or negative values. If the
plus sign (+) is not included, the operator cannot enter a
negative value.
Defines the digit positions for the value. You can use up to six
zeros (0).
The decimal point where needed for the value.
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 also toggles 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() (on page 9-70)