niswitch.h

此为某测试平台的上位机软件部分

                                             ViInt32* position);
ViStatus _VI_FUNC  niSwitch_RelayControl(ViSession vi, 
                                         ViConstString relayName, 
                                         ViInt32 relayAction);

    /*- Interchangeability Checking Functions ------------------------------*/
ViStatus _VI_FUNC  niSwitch_GetNextInterchangeWarning(ViSession vi, 
                                                      ViInt32 bufferSize, 
                                                      ViChar warnString[]);
ViStatus _VI_FUNC  niSwitch_ResetInterchangeCheck(ViSession vi);
ViStatus _VI_FUNC  niSwitch_ClearInterchangeWarnings(ViSession vi);

    /*- Coercion Functions -------------------------------------------------*/
ViStatus _VI_FUNC  niSwitch_GetNextCoercionRecord(ViSession vi,
                                                  ViInt32 bufferSize, 
                                                  ViChar record[]);

    /*- Utility Functions --------------------------------------------------*/
ViStatus _VI_FUNC  niSwitch_Commit(ViSession vi);
ViStatus _VI_FUNC  niSwitch_InvalidateAllAttributes(ViSession vi);
ViStatus _VI_FUNC  niSwitch_ResetWithDefaults(ViSession vi);
ViStatus _VI_FUNC  niSwitch_Disable(ViSession vi);
ViStatus _VI_FUNC  niSwitch_reset(ViSession vi);
ViStatus _VI_FUNC  niSwitch_self_test(ViSession vi, 
                                      ViInt16 *selfTestResult,
                                      ViChar selfTestMessage[]);
ViStatus _VI_FUNC  niSwitch_revision_query(ViSession vi, 
                                           ViChar instrumentDriverRevision[],
                                           ViChar firmwareRevision[]);

    /*- Set, Get, and Check Attribute Functions ----------------------------*/
ViStatus _VI_FUNC  niSwitch_GetAttributeViInt32(ViSession vi, ViConstString channelName, ViAttr attribute, ViInt32 *value);
ViStatus _VI_FUNC  niSwitch_GetAttributeViReal64(ViSession vi, ViConstString channelName, ViAttr attribute, ViReal64 *value);
ViStatus _VI_FUNC  niSwitch_GetAttributeViString(ViSession vi, ViConstString channelName, ViAttr attribute, ViInt32 bufferSize, ViChar value[]); 
ViStatus _VI_FUNC  niSwitch_GetAttributeViSession(ViSession vi, ViConstString channelName, ViAttr attribute, ViSession *value);
ViStatus _VI_FUNC  niSwitch_GetAttributeViBoolean(ViSession vi, ViConstString channelName, ViAttr attribute, ViBoolean *value);

ViStatus _VI_FUNC  niSwitch_SetAttributeViInt32(ViSession vi, ViConstString channelName, ViAttr attribute, ViInt32 value);
ViStatus _VI_FUNC  niSwitch_SetAttributeViReal64(ViSession vi, ViConstString channelName, ViAttr attribute, ViReal64 value);
ViStatus _VI_FUNC  niSwitch_SetAttributeViString(ViSession vi, ViConstString channelName, ViAttr attribute, ViConstString value); 
ViStatus _VI_FUNC  niSwitch_SetAttributeViSession(ViSession vi, ViConstString channelName, ViAttr attribute, ViSession value);
ViStatus _VI_FUNC  niSwitch_SetAttributeViBoolean(ViSession vi, ViConstString channelName, ViAttr attribute, ViBoolean value);

ViStatus _VI_FUNC  niSwitch_CheckAttributeViInt32(ViSession vi, ViConstString channelName, ViAttr attribute, ViInt32 value);
ViStatus _VI_FUNC  niSwitch_CheckAttributeViReal64(ViSession vi, ViConstString channelName, ViAttr attribute, ViReal64 value);
ViStatus _VI_FUNC  niSwitch_CheckAttributeViString(ViSession vi, ViConstString channelName, ViAttr attribute, ViConstString value); 
ViStatus _VI_FUNC  niSwitch_CheckAttributeViSession(ViSession vi, ViConstString channelName, ViAttr attribute, ViSession value);
ViStatus _VI_FUNC  niSwitch_CheckAttributeViBoolean(ViSession vi, ViConstString channelName, ViAttr attribute, ViBoolean value);

/****************************************************************************
 *------------------------ Error And Completion Codes ----------------------*
 ****************************************************************************/

#define NISWITCH_ERROR_SESSION_ALREADY_OPEN                (IVI_SPECIFIC_ERROR_BASE + 1)
#define NISWITCH_ERROR_INVALID_RESOURCE_DESCRIPTOR         (IVI_SPECIFIC_ERROR_BASE + 2)
#define NISWITCH_ERROR_SCANNING_NOT_SUPPORTED              (IVI_SPECIFIC_ERROR_BASE + 3)
#define NISWITCH_ERROR_MUST_SPECIFY_MODULE                 (IVI_SPECIFIC_ERROR_BASE + 4)
#define NISWITCH_ERROR_MODULE_FIFO_LENGTH_EXCEEDED         (IVI_SPECIFIC_ERROR_BASE + 5)
#define NISWITCH_ERROR_HW_COMMUNICATE_TMO                  (IVI_SPECIFIC_ERROR_BASE + 6)
#define NISWITCH_ERROR_TTL_BUS_REQUIRED                    (IVI_SPECIFIC_ERROR_BASE + 7)
#define NISWITCH_ERROR_MODULE_IS_BBM_ONLY                  (IVI_SPECIFIC_ERROR_BASE + 8)
#define NISWITCH_ERROR_1127_TTL1_CONFLICT                  (IVI_SPECIFIC_ERROR_BASE + 9)
#define NISWITCH_ERROR_INVALID_DRIVER_SETUP_STRING         (IVI_SPECIFIC_ERROR_BASE + 11)
#define NISWITCH_ERROR_TOPOLOGY_NOT_SUPPORTED              (IVI_SPECIFIC_ERROR_BASE + 12)
#define NISWITCH_ERROR_INVALID_TOPOLOGY                    (IVI_SPECIFIC_ERROR_BASE + 13)
#define NISWITCH_ERROR_HARDWARE_UNEXPECTEDLY_RESET         (IVI_SPECIFIC_ERROR_BASE + 14)
#define NISWITCH_ERROR_HANDSHAKING_INITIATION_CONFLICT     (IVI_SPECIFIC_ERROR_BASE + 15)
#define NISWITCH_ERROR_LEGACY_DESCRIPTOR_DAQMX_RSC_TYPE    (IVI_SPECIFIC_ERROR_BASE + 16)
#define NISWITCH_ERROR_DAQMX_DESCRIPTOR_LEGACY_RSC_TYPE    (IVI_SPECIFIC_ERROR_BASE + 17)
#define NISWITCH_ERROR_AMBIGUOUS_MODEL_CODE                (IVI_SPECIFIC_ERROR_BASE + 18)
#define NISWITCH_ERROR_TRIGGER_INPUT_NOT_SUPPORTED         (IVI_SPECIFIC_ERROR_BASE + 19)
#define NISWITCH_ERROR_INVALID_TERMINALBLOCK_FOR_TOPOLOGY  (IVI_SPECIFIC_ERROR_BASE + 20)
#define NISWITCH_ERROR_CANT_INVERT_WHEN_SOURCE_EQUALS_DEST (IVI_SPECIFIC_ERROR_BASE + 21)
#define NISWITCH_ERROR_CONFLICTING_TRIGGER_ROUTE_EXISTS    (IVI_SPECIFIC_ERROR_BASE + 22)
#define NISWITCH_ERROR_INVALID_VALUE_FOR_DEVICE            (IVI_SPECIFIC_ERROR_BASE + 23)
#define NISWITCH_ERROR_TRIGGER_POLARITY_CONFLICT           (IVI_SPECIFIC_ERROR_BASE + 24)
#define NISWITCH_ERROR_INTERNAL_ERROR                      (IVI_SPECIFIC_ERROR_BASE + 25)
#define NISWITCH_ERROR_RESET_NEEDED_TO_CHANGE_TOPOLOGY     (IVI_SPECIFIC_ERROR_BASE + 26)


#define NISWITCH_WARN_PATH_REMAINS                       IVISWTCH_WARN_PATH_REMAINS
#define NISWITCH_WARN_IMPLICIT_CONNECTION_EXISTS         IVISWTCH_WARN_IMPLICIT_CONNECTION_EXISTS

#define NISWITCH_ERROR_INVALID_SWITCH_PATH               IVISWTCH_ERROR_INVALID_SWITCH_PATH
#define NISWITCH_ERROR_INVALID_SCAN_LIST                 IVISWTCH_ERROR_INVALID_SCAN_LIST
#define NISWITCH_ERROR_RSRC_IN_USE                       IVISWTCH_ERROR_RSRC_IN_USE
#define NISWITCH_ERROR_EMPTY_SCAN_LIST                   IVISWTCH_ERROR_EMPTY_SCAN_LIST
#define NISWITCH_ERROR_EMPTY_SWITCH_PATH                 IVISWTCH_ERROR_EMPTY_SWITCH_PATH
#define NISWITCH_ERROR_SCAN_IN_PROGRESS                  IVISWTCH_ERROR_SCAN_IN_PROGRESS
#define NISWITCH_ERROR_NO_SCAN_IN_PROGRESS               IVISWTCH_ERROR_NO_SCAN_IN_PROGRESS
#define NISWITCH_ERROR_NO_SUCH_PATH                      IVISWTCH_ERROR_NO_SUCH_PATH
#define NISWITCH_ERROR_IS_CONFIGURATION_CHANNEL          IVISWTCH_ERROR_IS_CONFIGURATION_CHANNEL
#define NISWITCH_ERROR_NOT_A_CONFIGURATION_CHANNEL       IVISWTCH_ERROR_NOT_A_CONFIGURATION_CHANNEL
#define NISWITCH_ERROR_ATTEMPT_TO_CONNECT_SOURCES        IVISWTCH_ERROR_ATTEMPT_TO_CONNECT_SOURCES
#define NISWITCH_ERROR_EXPLICIT_CONNECTION_EXISTS        IVISWTCH_ERROR_EXPLICIT_CONNECTION_EXISTS
#define NISWITCH_ERROR_LEG_MISSING_FIRST_CHANNEL         IVISWTCH_ERROR_LEG_MISSING_FIRST_CHANNEL
#define NISWITCH_ERROR_LEG_MISSING_SECOND_CHANNEL        IVISWTCH_ERROR_LEG_MISSING_SECOND_CHANNEL
#define NISWITCH_ERROR_CHANNEL_DUPLICATED_IN_LEG         IVISWTCH_ERROR_CHANNEL_DUPLICATED_IN_LEG
#define NISWITCH_ERROR_CHANNEL_DUPLICATED_IN_PATH        IVISWTCH_ERROR_CHANNEL_DUPLICATED_IN_PATH
#define NISWITCH_ERROR_PATH_NOT_FOUND                    IVISWTCH_ERROR_PATH_NOT_FOUND
#define NISWITCH_ERROR_DISCONTINUOUS_PATH                IVISWTCH_ERROR_DISCONTINUOUS_PATH
#define NISWITCH_ERROR_CANNOT_CONNECT_DIRECTLY           IVISWTCH_ERROR_CANNOT_CONNECT_DIRECTLY
#define NISWITCH_ERROR_CHANNELS_ALREADY_CONNECTED        IVISWTCH_ERROR_CHANNELS_ALREADY_CONNECTED
#define NISWITCH_ERROR_CANNOT_CONNECT_TO_ITSELF          IVISWTCH_ERROR_CANNOT_CONNECT_TO_ITSELF

#ifdef IVISWTCH_ERROR_MAX_TIME_EXCEEDED
 #define NISWITCH_ERROR_MAX_TIME_EXCEEDED          IVISWTCH_ERROR_MAX_TIME_EXCEEDED
#else
 #define NISWITCH_ERROR_MAX_TIME_EXCEEDED          (IVI_CLASS_ERROR_BASE + 22L)
#endif

#define NISWITCH_ERROR_TRIGGER_NOT_SOFTWARE        IVISWTCH_ERROR_TRIGGER_NOT_SOFTWARE

    /*- Obsolete Instrument Driver Values, Attributes and functions -*/
    /*- These attributes and functions have been deprecated and may not
        be supported in future versions of this driver. 
    -*/
#define niSwitch_SwitchSwitch                       niSwitch_SingleSwitchControl
#define NISWITCH_ATTR_QUERY_INSTR_STATUS            NISWITCH_ATTR_QUERY_INSTRUMENT_STATUS
    /*- Driver Information -*/
#define NISWITCH_ATTR_SPECIFIC_PREFIX               IVI_ATTR_SPECIFIC_PREFIX
#define NISWITCH_ATTR_SPECIFIC_DRIVER_MAJOR_VERSION IVI_ATTR_SPECIFIC_DRIVER_MAJOR_VERSION
#define NISWITCH_ATTR_SPECIFIC_DRIVER_MINOR_VERSION IVI_ATTR_SPECIFIC_DRIVER_MINOR_VERSION
    /*- IVI Engine Information -*/
#define NISWITCH_ATTR_ENGINE_MAJOR_VERSION          IVI_ATTR_ENGINE_MAJOR_VERSION
#define NISWITCH_ATTR_ENGINE_MINOR_VERSION          IVI_ATTR_ENGINE_MINOR_VERSION
#define NISWITCH_ATTR_ENGINE_REVISION               IVI_ATTR_ENGINE_REVISION
    /*- Error Info -*/
#define NISWITCH_ATTR_PRIMARY_ERROR                 IVI_ATTR_PRIMARY_ERROR
#define NISWITCH_ATTR_SECONDARY_ERROR               IVI_ATTR_SECONDARY_ERROR
#define NISWITCH_ATTR_ERROR_ELABORATION             IVI_ATTR_ERROR_ELABORATION
    /*- Advanced Session Information -*/
#define NISWITCH_ATTR_IO_SESSION_TYPE               IVI_ATTR_IO_SESSION_TYPE
#define NISWITCH_ATTR_IO_SESSION                    IVI_ATTR_IO_SESSION
    /*- Deprecated Attribute Identifiers for Renamed Attributes -*/
#define NISWITCH_ATTR_NUM_CHANNELS                  NISWITCH_ATTR_CHANNEL_COUNT
#define NISWITCH_ATTR_QUERY_INSTR_STATUS            NISWITCH_ATTR_QUERY_INSTRUMENT_STATUS            
#define NISWITCH_ATTR_RESOURCE_DESCRIPTOR           NISWITCH_ATTR_IO_RESOURCE_DESCRIPTOR
    /* Version Info */
#define NISWITCH_ATTR_DRIVER_MAJOR_VERSION          IVI_ATTR_DRIVER_MAJOR_VERSION
#define NISWITCH_ATTR_DRIVER_MINOR_VERSION          IVI_ATTR_DRIVER_MINOR_VERSION
#define NISWITCH_ATTR_DRIVER_REVISION               IVI_ATTR_DRIVER_REVISION
    /* Serial number - ViInt32 version */
#define NISWITCH_ATTR_SERIAL_NUMBER_I32             (IVI_SPECIFIC_PUBLIC_ATTR_BASE + 1L)
    /* Software Trigger */
#define NISWITCH_VAL_SW_TRIG_FUNC                   IVISWTCH_VAL_SOFTWARE_TRIG
    /* Other deprecated values */
#define NISWITCH_VAL_ECL0                           IVISWTCH_VAL_ECL0
#define NISWITCH_VAL_ECL1                           IVISWTCH_VAL_ECL1

#define NISWITCH_ERROR_SCANLIST_NOT_SPECIFIED       (IVI_SPECIFIC_ERROR_BASE + 10)

    /*- Deprecated Send Software Trigger function -*/
ViStatus _VI_FUNC  niSwitch_SendSWTrigger(ViSession vi);

    /*- Deprecated Error Information functions -*/
ViStatus _VI_FUNC  niSwitch_GetErrorInfo(ViSession vi, ViStatus *primaryError, ViStatus *secondaryError, ViChar errorElaboration[256]);
ViStatus _VI_FUNC  niSwitch_ClearErrorInfo(ViSession vi);

    /*- Deprecated Single Switch Control Functions ------------------------------------*/
ViStatus _VI_FUNC  niSwitch_SingleSwitchControl(ViSession vi, ViConstString switchName, ViInt16 switchAction);
ViStatus _VI_FUNC  niSwitch_SingleSwitchQuery(ViSession vi, ViConstString switchName, ViInt16 *switchState);

    /*- Deprecated Calibration Functions ----------------------------------------------*/
ViStatus _VI_FUNC  niSwitch_CalibrationDataWrite(ViSession vi, 
                                                 ViConstString channel,
                                                 ViInt32 field,
                                                 ViReal64 calData);
ViStatus _VI_FUNC  niSwitch_CalibrationDataRead(ViSession vi, 
                                                ViConstString channel,
                                                ViInt32 field,
                                                ViReal64 *calData,
                                                ViInt32 *year,
                                                ViInt32 *month,
                                                ViInt32 *day);


    /* Deprecated defined values for the niSwitch_SingleSwitchControl and */
    /* niSwitch_SingleSwitchQuery operations */
#define NISWITCH_VAL_SWITCH_OPEN                    0
#define NISWITCH_VAL_SWITCH_CLOSE                   1
#define NISWITCH_VAL_SWITCH_CLOSED                  NISWITCH_VAL_SWITCH_CLOSE

    /* Deprecated defined values for the calibration values */
#define NISWITCH_VAL_CALIBRATION_CJS_AMP            0x00000001
#define NISWITCH_VAL_CALIBRATION_CHANNEL_AMP        0x08000001

/**************************************************************************** 
 *---------------------------- End Include File ----------------------------* 
 ****************************************************************************/
#ifdef __cplusplus
    }
#endif

#endif // ___niswitch_h___