HP-UX

NAME

viAssertTrigger − Asserts a software or hardware trigger

SYNOPSIS

viAssertTrigger(ViSession vi, ViUInt16 protocol);

Description

 
This function asserts a software or hardware trigger dependent on the interface type.  For a GPIB device, the device is addressed to listen, and then the GPIB GET command is sent.  For a VXI device, if VI_ATTR_TRIG_ID is VI_TRIG_SW, then the device is sent the Word Serial Trigger command.  For a VXI device, if VI_ATTR_TRIG_ID is any other value, a hardware trigger is sent on the line corresponding to the value of that attribute.  For GPIB and VXI software triggers, VI_TRIG_PROT_DEFAULT is the only valid protocol.  For VXI hardware triggers, VI_TRIG_PROT_DEFAULT is equivalent to VI_TRIG_PROT_SYNC.
 
 

Parameters

vi An input parameter. The unique logical identifier to session. 
 

protocol An input parameter.  Trigger protocol to use during assertion. Valid values are: VI_TRIG_PROT_DEFAULT, VI_TRIG_PROT_ON, VI_TRIG_PROT_OFF, and VI_TRIG_PROT_SYNC. 
 

Return Values

 
This is the functional return status.  It returns either a completion code or an error code as follows.
 
 

VI_SUCCESS The specified trigger was successfully asserted to the device. 
 

VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value). 
 

VI_ERROR_NSUP_OPER The given vi does not support this function. 
 

VI_ERROR_INV_PROT The protocol specified is invalid. 
 

VI_ERROR_TMO Timeout expired before function completed. 
 

VI_ERROR_RAW_WR_PROT_VIOL Violation of raw write protocol occurred during transfer. 
 

VI_ERROR_RAW_RD_PROT_VIOL Violation of raw read protocol occurred during transfer. 
 

VI_ERROR_INP_PROT_VIOL Device reported an input protocol error occurred during transfer. 
 

VI_ERROR_BERR Bus error occurred during transfer. 
 

VI_ERROR_LINE_IN_USE The specified trigger line is currently in use. 
 

VI_ERROR_NCIC The interface associated with the given vi is not currently the controller in charge. 
 

VI_ERROR_NLISTENERS No Listeners condition is detected (both NRFD and NDAC are deasserted). 
 

AUTHOR

viAssertTrigger was developed by HP
 

Hewlett-Packard Comapny  —  September 29, 1999