dm6430lib.h

rt 6430 采集卡 linux下驱动源代码

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EOPNOTSUPP
                    The digital table is to be enabled but the A/D table is to
                    be disabled.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int EnableTables6430(
    int descriptor,
    int Enable_AD_Table,
    int Enable_Digital_Table
);


/******************************************************************************
ChannelGainDataStore6430()

    Purpose:
        Enable or disable a board's channel/gain data store.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Enable =====> Flag to indicate whether the channel/gain data store
                      should be enabled.  A value of 0 means disable the data
                      store.  A nonzero value means enable the data store.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int ChannelGainDataStore6430(int descriptor, int Enable);


/******************************************************************************
SelectTimerCounter6430()

    Purpose:
        Select which timer/counter on a board will be accessed when a
        subsequent operation is performed on the registers located at base I/O
        address + 16 through base I/O address + 22.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Select =====> Indicate which timer/counter will be accessed.  Valid
                      values are DM6430HR_CLOCK_TC and DM6430HR_USER_TC.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EINVAL
                    Select is not valid.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int SelectTimerCounter6430(int descriptor, enum DM6430HR_CLK_SEL Select);


/******************************************************************************
SetSampleCounterStop6430()

    Purpose:
        Enable or disable a board's A/D Sample Counter Stop.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Disable ====> Flag to indicate whether the A/D sample counter should
                      stop the pacer clock.  A value of 0 means enable sample
                      counter stop.  A nonzero value means disable sample
                      counter stop.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int SetSampleCounterStop6430(int descriptor, int Disable);


/******************************************************************************
SetPauseEnable6430()

    Purpose:
        Enable or disable a board's A/D table pause bit.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Enable =====> Flag to indicate whether the A/D table pause bit should
                      set.  A value of 0 means enable the pause bit.  A
                      nonzero value means disable the pause bit.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int SetPauseEnable6430(int descriptor, int Enable);


/******************************************************************************
ReadADData6430()

    Purpose:
        Read 16 bits from a board's analog to digital FIFO.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        ad_data_p ==> Address where data read should be stored.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for read
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int ReadADData6430(int descriptor, int16_t *ad_data_p);


/******************************************************************************
ReadChannelGainDataStore6430()

    Purpose:
        Read a board's channel gain data word.  This function assumes the
        caller knows whether or not the channel gain data store has been
        enabled since there is no way to query the board for this status.

    Parameters:
        descriptor ===> File descriptor from OpenBoard6430() call.
        cgds_data_p ==> Address where data read should be stored.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for read
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int ReadChannelGainDataStore6430(int descriptor, u_int16_t *cgds_data_p);


/******************************************************************************
SetChannelGain6430()

    Purpose:
        Load a board's channel/gain latch.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Channel ====> A/D channel.  Valid values are DM6430HR_AIN1,
                      DM6430HR_AIN2, DM6430HR_AIN3, DM6430HR_AIN4,
                      DM6430HR_AIN5, DM6430HR_AIN6, DM6430HR_AIN7,
                      DM6430HR_AIN8, DM6430HR_AIN9, DM6430HR_AIN10,
                      DM6430HR_AIN11, DM6430HR_AIN12, DM6430HR_AIN13,
                      DM6430HR_AIN14, DM6430HR_AIN15, and DM6430HR_AIN16.
        Gain =======> A/D gain.  Valid values are DM6430HR_GAINx1,
                      DM6430HR_GAINx2, DM6430HR_GAINx4, and
                      DM6430HR_GAINx8.
        Se_Diff ====> Select single-ended or differential mode.  Valid values
                      are DM6430HR_SE_SE and DM6430HR_SE_DIFF.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EINVAL
                    Channel is not valid.

                EINVAL
                    Gain is not valid.

                EINVAL
                    Se_Diff is not valid.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int SetChannelGain6430(
    int descriptor,
    enum DM6430HR_AIN Channel,
    enum DM6430HR_GAIN Gain,
    enum DM6430HR_SE Se_Diff
);


/******************************************************************************
LoadADTable6430()

    Purpose:
        Load a board's A/D table with the given number of entries.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        ADEntries ==> Number of entries in A/D table.
	ADTable_p ==> Address of memory containing A/D table to send to board.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EINVAL
                    ADEntries is 0.

                EINVAL
                    ADEntries is greater than 1024.

	    Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int LoadADTable6430(
    int descriptor,
    u_int16_t ADEntries,
    ADTableRow *ADTable_p
);


/******************************************************************************
LoadDigitalTable6430()

    Purpose:
        Load a board's digital table with the given number of entries.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        entries ====> Number of entries in digital table.
	table_p ====> Address of memory containing digital table to send to
                      board.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EINVAL
                    entries is 0.

                EINVAL
                    entries is greater than 1024.

	    Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int LoadDigitalTable6430(int descriptor, u_int16_t entries, u_int16_t *table_p);


/******************************************************************************
StartConversion6430()

    Purpose:
        Issue a Start Convert (software trigger) command to a board.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for read
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int StartConversion6430(int descriptor);


/******************************************************************************
LoadTriggerRegister6430()

    Purpose:
        Load a 16 bit value into a board's Trigger Mode Register.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
	value ======> Value to write into Trigger Mode Register.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int LoadTriggerRegister6430(int descriptor, u_int16_t value);


/******************************************************************************
SetConversionSelect6430()

    Purpose:
        Configure how a board's A/D conversion is done.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
	Select =====> Indicates how A/D conversions are controlled.  Valid
                      values are DM6430HR_CONV_SOFT_TRIGGER,
                      DM6430HR_CONV_PACER_CLOCK,
                      DM6430HR_CONV_BURST_CLOCK, and
                      DM6430HR_CONV_DIGITAL_INT.

    Return Value:
        0
            Success.

        -1
            Failure with errno set as follows:
                EACCES
                    descriptor refers to a file that is open but not for write
                    access.

                EINVAL
                    Select is not valid.

            Please see the ioctl(2) man page for information on other possible
            values errno may have in this case.
 ******************************************************************************/

int SetConversionSelect6430(int descriptor, enum DM6430HR_CONV Select);