TDS640__Initialize (ul_pbar_instruments)
* Synopsis:
* #include <ul_pbar_instruments:tds640.h>
*
* CTDS640ptr TDS640__Initialize( int *errorCode, const int retryCount,
* const char *houseName,
* const char *moduleType,
* const int nodeID,
* const int moduleAddress,
* const char *moduleName )
*
* Function intent:
* TDS640__Initialize() does a GPIB select to establish a connection to
* the specified module and if successful returns a unique TDS 640 module
* pointer for use in future TDS640__ calls.
* It also initializes the TDS 640 to the factory settings as outlined in
* Appendix F of the User Manual.
* It also initializes the Device Event Status Enable Register (DESER), the
* Event Status Enable Register (ESER) and the Service Request Enable
* Register (SRER).
* Function parameters:
* int *errorCode GPIB I/O status/error code - returned
* int retryCount ACNET I/O error retry count:
* 0 <= retryCount <= 10
* char *houseName ASCII house name (2 characters)
* char *moduleType ASCII module type (4 characters)
* int nodeID Front end node identification. If the node
* points to a VME crate, the houseName and
* moduleType arguments are ignored.
* int modAddress Unit's GPIB addres
* 0 <= modAddress <= 255
* char *moduleName Any descriptive text identifying the module
* if NULL is passed the module's nodeID
* and modAddress are encoded into a string
* of the form:
* TDS 640 @ Addr xxxx
* errorCode return values:
* CBS_OK The unit was successfully initialized
* CLIB_INVARG Invalid parameter value
* CLIB_INVALID_DATA TDS 640 status error after GPIB command
* CLIB_MEMFAIL Memory allocation failed
* CLIB_NO_SUCH The responding module returned the wrong *IDN? string
* CBS_INVARG Invalid GPIB address or
* no such module type for the given front end
* CBS_NO_SUCH VME interface device doesn't exist
* CBS_NODAT VME interface device could not be retrieved
* for this GPIB address
* DIO_xxx Error retrieving VME interface device
* GAS_xxx_yyy GAS error
* Function return value:
* NULL GPIB I/O error, see errorCode parameter
* otherwise unique TDS 640 module pointer