TDS640__SetupTrigger (ul_pbar_instruments)

 *  Synopsis:
 *    #include <ul_pbar_instruments:tds640.h>
 *
 *    int TDS640__SetupTrigger( const CTDS640ptr tds640Ptr,
 *				const ETRIGerSOUrce SOUrce,
 *				const ECHANnumber CHannel,
 *				const ETRIGerTYPe TYPe,
 *				const ETRIGerCOUPling COUPling,
 *				const ETRIGerSLOpe SLOpe,
 *				const ETRIGerLEVel LEVel, const float VALue,
 *				const ETRIGerMODe MODe )
 *
 *  Function intent:
 *    TDS640__SetupTrigger() provides settings for TDS 640 trigger parameters
 *    including the following:
 *  Function parameters:
 *    CTDS640ptr	tds640Ptr	Valid TDS 640 module pointer
 *    ETRIGerSOUrce	SOUrce		Trigger source:
 *					  AUXiliary - Aux. trigger input
 *					  CH - input channel 1-4
 *					  LINE - AC line voltage
 *    ECHANnumber	CHannel		TDS 640 channel to be read:
 *					  kChan1 <= channel <= kChan4
 *    ETRIGerTYPe	TYPe		Trigger type:
 *					  EDGE - normal edge trigger
 *					These modes are currently not supported:
 *					  LOGIc - logic condition trigger
 *					  PULse - pulse detector trigger
 *					  VIDeo - specified signal trigger
 *    ETRIGerCOUPling	COUPling	Trigger coupling:
 *					  AC - AC trigger coupling
 *					  DC - DC trigger coupling
 *					  HFRej - removes high freq. components
 *					  LFRej - removes low freq. components
 *					  NOISErej - selects DC low sensitivity
 *    ETRIGerSLOpe	SLOpe		Trigger slope:
 *					  FALL - falling or negative edge
 *					  RISe - rising or positive edge
 *    ETRIGerLEVel	LEVel		Trigger level:
 *					  ECL - preset ECL level of -1.3 volts
 *					  TTL - preset TTL level of 1.4 volts
 *					  ADJust - adjustable level in volts
 *    float		VALue		Adjustable mode trigger level
 *    ETRIGerMODe	MODe		Trigger mode:
 *					  AUTO - always triggers after timeout
 *					  NORMal - wait for valid trigger
 *  Function return value:
 *    CBS_OK		Setup was successful
 *    CLIB_INVID	Invalid channel request
 *    CLIB_INVARG	Invalid parameter value
 *    CLIB_GENERR	Unable to write TDS 640 command(s) 
 *    CLIB_INVALID_DATA	TDS 640 status error after GPIB command