Keithley DMM7510 - Trigger.model.load() - Loopuntilevent

Section
8: TSP command reference Model DMM7510 7½ Digit Graphical Sampling Multimeter
Reference Manual
8-296 DMM7510-901-01 Rev. B / May 2015
trigger.model.load() — LoopUntilEvent
This function loads a predefined trigger model configuration that makes continuous measurements until the
specified event occurs.
Type TSP-Link accessible
Affected by Where saved Default value
Function
Yes
Usage
trigger.model.load("LoopUntilEvent", triggerEvent, position, clear)
trigger.model.load("LoopUntilEvent", triggerEvent, position, clear, delay)
trigger.model.load("LoopUntilEvent", triggerEvent, position, clear, delay,
bufferName)
trigger.model.load("LoopUntilEvent", triggerEvent, position, clear, delay,
bufferName, readingBlock)
triggerEvent
The event that ends infinite triggering or readings set to occur before the
trigger; see Details
position
The number of readings to make in relation to the size of the reading
buffer; enter as a percentage (0 % to 100 %)
clear
To clear previously detected trigger events when entering the wait block
(default): trigger.CLEAR_ENTER
To immediately act on any previously detected triggers and not clear them:
trigger.CLEAR_NEVER
delay
The delay time before each measurement (167 ns to 10 ks); default is 0 for
no delay
bufferName
The name of the reading buffer, which may be a default buffer
(defbuffer1 or defbuffer2) or a user-defined buffer; defaults to
defbuffer1
readingBlock
Define a measure or digitize block for the trigger model; options are:
• trigger.READING_ACTIVE: Add a measure or digitize block to the
trigger model based on the active function; if no option defined,
trigger.READING_ACTIVE is used
• trigger.READING_MEASURE: Adds a measure block to the trigger
model
• trigger.READING_DIGITIZE: Adds a digitize block to the trigger
model
Details
The event constant is the event that ends infinite triggering or ends readings set to occur before the
trigger and start post-trigger readings. The trigger model makes readings until it detects the event
constant. After the event, it makes a finite number of readings, based on the setting of the trigger
position.
The position marks the location in the reading buffer where the trigger will occur. The position is set
as a percentage of the active buffer capacity. The buffer captures measurements until a trigger
occurs. When the trigger occurs, the buffer retains the percentage of readings specified by the
position, then captures remaining readings until 100 percent of the buffer is filled. For example, if this
is set to 75 for a reading buffer that holds 10,000 readings, the trigger model makes 2500 readings
after it detects the source event. There will be 7500 pre-trigger readings and 2500 post-trigger
readings.