User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-83
channel.trigger[N].set()
Function
Sets the channel status trigger module to watch the state of a specific channel.
Usage
channel.trigger[N].set(<ch_list>, <state_match>)
ch_list: String specifying the channels to query, using normal channel list syntax.
state_match: Value of the state indicators which are to be matched.
Remarks
If the channel list contains more than one channel, then the trigger acts as a logical
OR. When any one of the channels in the list matches the desired state, a trigger
event is generated. Therefore, if an indicator is present in both the match and the
actual state, then an event is triggered. If the match contains more than one state
indicator, only one of those indicators needs be present to trigger the event. There are
a total of eight channel trigger events per Model 3706, defined by [N]. Using this
mechanism, a trigger can be generated when a pattern is matched on an I/O, a
totalizer matches a defined count, or an I/O has an over-current condition.
Latching functionality is not supported.
Switch channels are currently not supported.
To clear a trigger that is no longer needed, pass an empty channel list (“”).
Also see
channel.trigger[N].get() (on page 13-82)
Example
To define channel trigger event 1 to occur when digital I/O Channel 1 matches its
defined match value:
channel.trigger[1].set("1001", channel.IND_MATCH)
channel.trigger[N].wait()
Function
Waits for the desired trigger or timeout period, whichever comes first.
Usage
<triggered> = channel.trigger[N].wait(<timeout>)
triggered: Returns an indication that a trigger occurred.
timeout: Specifies the number of seconds to wait.
Remarks
If one or more trigger events were detected since the last time
channel.trigger[N].wait or channel.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.
The value for timeout must be greater than zero and less than 10,000.
Example
To wait 5 seconds for channel trigger event 1:
channel.trigger[1].wait(5)