dm6430lib.h

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

/******************************************************************************
SetStartTrigger6430()

    Purpose:
        Configure how a board's pacer clock is started during A/D conversion.

    Parameters:
        descriptor ====> File descriptor from OpenBoard6430() call.
        Start_Trigger => What starts the pacer clock.  Valid values are
                         DM6430HR_START_TRIG_SOFTWARE,
                         DM6430HR_START_TRIG_EXTERNAL,
                         DM6430HR_START_TRIG_DIGITAL_INT,
                         DM6430HR_START_TRIG_USER_TC1, and
                         DM6430HR_START_TRIG_GATE.

    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
                    Start_Trigger is not valid.

                EOPNOTSUPP
                    Start_Trigger is one of the three reserved bit patterns
                    as defined in the hardware manual.

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

int SetStartTrigger6430(int descriptor, enum DM6430HR_START_TRIG Start_Trigger);


/******************************************************************************
SetStopTrigger6430()

    Purpose:
        Configure how a board's pacer clock is stopped during A/D conversion.

    Parameters:
        descriptor ===> File descriptor from OpenBoard6430() call.
        Stop_Trigger => What stops the pacer clock.  Valid values are
                        DM6430HR_STOP_TRIG_SOFTWARE,
                        DM6430HR_STOP_TRIG_EXTERNAL,
                        DM6430HR_STOP_TRIG_DIGITAL_INT,
                        DM6430HR_STOP_TRIG_SAMPLE_CNT,
                        DM6430HR_STOP_TRIG_ABOUT_SOFTWARE,
                        DM6430HR_STOP_TRIG_ABOUT_EXTERNAL,
                        DM6430HR_STOP_TRIG_ABOUT_DIGITAL, and
                        DM6430HR_STOP_TRIG_ABOUT_USER_TC1.

    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
                    Stop_Trigger is not valid.

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

int SetStopTrigger6430(int descriptor, enum DM6430HR_STOP_TRIG Stop_Trigger);


/******************************************************************************
SetPacerClockSource6430()

    Purpose:
        Select the source of a board's pacer clock.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Source =====> Pacer clock source.  Valid values are
                      DM6430HR_PACER_CLK_INTERNAL and
                      DM6430HR_PACER_CLK_EXTERNAL.

    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
                    Source is not valid.

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

int SetPacerClockSource6430(int descriptor, enum DM6430HR_PACER_CLK Source);


/******************************************************************************
SetBurstTrigger6430()

    Purpose:
        Select a board's burst mode trigger.

    Parameters:
        descriptor ====> File descriptor from OpenBoard6430() call.
        Burst_Trigger => What triggers a burst.  Valid values are
                         DM6430HR_BURST_TRIG_SOFTWARE,
                         DM6430HR_BURST_TRIG_PACER,
                         DM6430HR_BURST_TRIG_EXTERNAL, and
                         DM6430HR_BURST_TRIG_DIGITAL.


    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
                    Burst_Trigger is not valid.

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

int SetBurstTrigger6430(int descriptor, enum DM6430HR_BURST_TRIG Burst_Trigger);


/******************************************************************************
SetTriggerPolarity6430()

    Purpose:
        Select which edge of an external pacer clock triggers a board's burst
        mode.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Polarity ===> Which external pacer clock edge triggers burst mode.
                      Valid values are DM6430HR_POLAR_POSITIVE and
                      DM6430HR_POLAR_NEGATIVE.

    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
                    Polarity is not valid.

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

int SetTriggerPolarity6430(int descriptor, enum DM6430HR_POLAR Polarity);


/******************************************************************************
SetTriggerRepeat6430()

    Purpose:
        Select whether or not a trigger initiates multiple A/D conversion
        cycles.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        Repeat =====> Indicates whether or not A/D conversion cycles repeat.
                      Valid values are DM6430HR_REPEAT_SINGLE and
                      DM6430HR_REPEAT_REPEAT.

    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
                    Repeat is not valid.

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

int SetTriggerRepeat6430(int descriptor, enum DM6430HR_REPEAT Repeat);


/******************************************************************************
LoadIRQRegister6430()

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

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
	value ======> Value to load into Interrupt 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 LoadIRQRegister6430(int descriptor, u_int16_t value);


/******************************************************************************
SetIRQ0Source6430()

    Purpose:
        Select the interrupt source of the first interrupt circuit on a board.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
	IRQSource ==> Source of interrupt on first circuit.  Valid values are
                      IRQS_AD_SAMPLE_CNT_6430,
                      IRQS_AD_START_CONVERT_6430,
                      IRQS_AD_END_CONVERT_6430,
                      IRQS_AD_WRITE_FIFO_6430,
                      IRQS_AD_FIFO_HALF_6430,
                      IRQS_AD_DMA_DONE_6430,
                      IRQS_RESET_GAIN_TABLE_6430,
                      IRQS_PAUSE_GAIN_TABLE_6430,
                      IRQS_EXT_PACER_CLOCK_6430,
                      IRQS_EXT_TRIGGER_6430,
                      IRQS_DIGITAL_6430,
                      IRQS_TC_COUNTER0_6430,
                      IRQS_TC_COUNTER0_INVERTED_6430,
                      IRQS_TC_COUNTER1_6430,
                      IRQS_DIO_FIFO_HALF_6430, and
                      IRQS_DIO_WRITE_FIFO_6430.

    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
                    IRQSource is not valid.

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

int SetIRQ0Source6430(int descriptor, enum DM6430HR_INTSRC IRQSource);


/******************************************************************************
SetIRQ1Source6430()

    Purpose:
        Select the interrupt source of the second interrupt circuit on a board.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
	IRQSource ==> Source of interrupt on second circuit.  Valid values are
                      IRQS_AD_SAMPLE_CNT_6430,
                      IRQS_AD_START_CONVERT_6430,
                      IRQS_AD_END_CONVERT_6430,
                      IRQS_AD_WRITE_FIFO_6430,
                      IRQS_AD_FIFO_HALF_6430,
                      IRQS_AD_DMA_DONE_6430,
                      IRQS_RESET_GAIN_TABLE_6430,
                      IRQS_PAUSE_GAIN_TABLE_6430,
                      IRQS_EXT_PACER_CLOCK_6430,
                      IRQS_EXT_TRIGGER_6430,
                      IRQS_DIGITAL_6430,
                      IRQS_TC_COUNTER0_6430,
                      IRQS_TC_COUNTER0_INVERTED_6430,
                      IRQS_TC_COUNTER1_6430,
                      IRQS_DIO_FIFO_HALF_6430, and
                      IRQS_DIO_WRITE_FIFO_6430.

    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
                    IRQSource is not valid.

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

int SetIRQ1Source6430(int descriptor, enum DM6430HR_INTSRC IRQSource);


/******************************************************************************
ReadDINFIFO6430()

    Purpose:
        Read 8 bits of data from the digital input FIFO.

    Parameters:
        descriptor =====> File descriptor from OpenBoard6430() call.
        digital_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 ReadDINFIFO6430(int descriptor, u_int8_t *digital_data_p);


/******************************************************************************
LoadDINConfigRegister6430()

    Purpose:
        Load a 16 bit value into a board's Digital Input FIFO Configuration
        Register.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        value ======> Value to write into 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 LoadDINConfigRegister6430(int descriptor, u_int16_t value);


/******************************************************************************
ConfigDINClock6430()

    Purpose:
        Set the source for a board's digital input FIFO clock.

    Parameters:
        descriptor => File descriptor from OpenBoard6430() call.
        DIN_Clock ==> Source of digital input FIFO clock.  Valid values are
                      DM6430HR_DI_FIFO_CLK_USER_TC0,
                      DM6430HR_DI_FIFO_CLK_USER_TC1,
                      DM6430HR_DI_FIFO_CLK_AD_WRITE_FIFO,
                      DM6430HR_DI_FIFO_CLK_EXTERNAL_PACER, and
                      DM6430HR_DI_FIFO_CLK_EXTERNAL_TRIG.

    Return Value:
        0
            Success.

        -1