Model 2461 Interactive SourceMeter® Instrument Reference Manual
Section 8: TSP command reference
2461-901-01 A/November 2015
8-113
smu.digitize.limit[Y].fail
This attribute queries the results of a limit test.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Attribute (R)
Yes
Not applicable
Not applicable
Not applicable
Usage
value
= smu.digitize.limit[
Y]
.fail
value
The results of the limit test for limit
Y
:
•
smu.FAIL_NONE
: Test passed; measurement under or equal to the high limit
•
smu.FAIL_HIGH
: Test failed; measurement exceeded high limit
•
smu.FAIL_LOW
: Test failed; measurement exceeded low limit
•
smu.FAIL_BOTH
: Test failed; measurement exceeded both limits
Y
Limit number:
1
or
2
Details
This command queries the result of a limit test for the selected digitize function.
The response message indicates if the limit test passed or how it failed (on the high or low limit).
If autoclear is set to off, reading the results of a limit test does not clear the fail indication of the test.
To clear a failure, send the clear command. To automatically clear the results, set auto clear on.
If auto clear is set to on and you are making a series of measurements, the last measurement limit
determines the fail indication for the limit. If auto clear is turned off, the results return a test fail if any
of one of the readings failed.
To use this attribute, you must set the limit state to on.
If the readings are stored in a reading buffer, you can use the
bufferVar
.statuses
command to
see the results.
Example
This example enables limits 1 and 2 for digitize voltage measurements. Limit 1 is checking for
readings to be between 3 and 5 V, while limit 2 is checking for the readings to be between 1 and 7 V.
The auto clear feature is disabled, so if any reading is outside these limits, the corresponding fail is 1.
Therefore, if any one of the fails is 1, analyze the reading buffer data to find out which reading failed
the limits.
