USB0816I多功能数据采集卡文档LabWindowscvi.doc

USB0816多功能数据采集卡文档一，参数说明：USB0816是CPUBBS论坛()开发的多功能采集卡；其参数如下：1，配置有2个DIO（均可以配置成DI，DO，其中DIO1还可以配置成外部触发采集功能，DIO2可以配置成计数器功能）；(通用版本可以将脱机版本使用的液晶接口CS，SID，SCLK配置成普通IO用，所以作为通用版本，可以达到5个DIO；脱机版本只有2个DIO)2，16位AD转换器；10V的量程；8路差分输入；3，程控增益有：1，10，100，1000倍；4，可软件触发采集，也可以外问DIO1脉冲触发采集；5，其他功能（比如液晶，SD卡存储系统，脱机自成一套系统功能，等均需要用CPUVIEW进行再编程实现，并且需要烧录器，通用版本用户不配备这些功能；每年用量超过100套的用户，改动不大的功能前提下，可以向我们要求免费定制，定制门槛极低）；二，接线方法：由左到右分别为：CH1CH16，DIO_1,DIO_2,GND,AGND接线方法为：本采集卡有8路差分输入，CH1和CH9组成差分输入通道1，CH2和CH10组成差分输入通道2，依此类推；三，驱动程序安装方法：请查看文件驱动安装方法.doc里面的图文说明；四，USB0816配套控制子DLL使用说明：用户使用时请将上述几个文件拷贝到工程目录下面，然后即可方便使用里面的各函数；程序发布时需要将文件夹内的DLL添加到资源文件中即可；详细打包方法可以查看CPUBBS论坛第一版本USB20多功能采集卡的文档，里面有非常详细的说明，地址如下：/bbs/viewthread.php?tid=18024&extra=page%3D1里面有压缩包下载；现在我们来详细说明USB0816.dll内各子函数的使用方法（如果熟悉LabWindows/cvi的朋友也可以通过打开演示程序，里面有直接的使用方法，很详细，全部功能函数均使用到了。此卡使用到的所有子函数共有如下所示几个，并且很多使用上是很类似的：1),extern char _declspec(dllexport) cpubbs_DIO2_Exint2(int *cpubbs_write_statue);2),extern char _declspec(dllexport) cpubbs_Get_Exint2_State(char *Cpubbs_Exint2_CurrentState,unsigned int *Cpubbs_GetFrequency, int *cpubbs_write_statue, int *cpubbs_read_statue);3),extern char _declspec(dllexport) cpubbs_DIO2_DO2(int *cpubbs_write_statue);4),extern char _declspec(dllexport) cpubbs_Set_DO2(char Cpubbs_DO2_State,int *cpubbs_write_statue);5),extern char _declspec(dllexport) cpubbs_DIO2_DI2(int *cpubbs_write_statue);6),extern char _declspec(dllexport) cpubbs_Get_DI2(char *Cpubbs_DI2_State, int *cpubbs_write_statue, int *cpubbs_read_statue);7),extern char _declspec(dllexport) cpubbs_DIO1_Exint1(unsigned int Cpubbs_SampleRate, int *cpubbs_write_statue);8),extern char _declspec(dllexport) cpubbs_Get_Exint1_State(unsigned int *Cpubbs_SampledPoints, int *cpubbs_write_statue, int *cpubbs_read_statue);9),extern char _declspec(dllexport) cpubbs_DIO1_DO1(int *cpubbs_write_statue);10),extern char _declspec(dllexport) cpubbs_Set_DO1(char Cpubbs_DO1_State, int *cpubbs_write_statue);11),extern char _declspec(dllexport) cpubbs_DIO1_DI1(int *cpubbs_write_statue);12),extern char _declspec(dllexport) cpubbs_Get_DI1(char *Cpubbs_DI1_State, int *cpubbs_write_statue, int *cpubbs_read_statue);13),extern char _declspec(dllexport) cpubbs_Set_GainAndChannel(unsigned int Cpubbs_Gain, unsigned char Cpubbs_Channel, int *cpubbs_write_statue);14),extern char _declspec(dllexport) Cpubbs_ReadAllChannelAdValue1Point(double *cpubbs_ad_result, int *cpubbs_write_statue, int *cpubbs_read_statue);15), extern char _declspec(dllexport) Cpubbs_SoftWareTriggerHighRateSample(unsigned int Cpubbs_SampleRate,unsigned char Cpubbs_ChannelsToSample, int *cpubbs_write_statue);16),extern char _declspec(dllexport) Cpubbs_GetHighRateSamleData(double *cpubbs_HightRateSampleData, int *cpubbs_write_statue, int *cpubbs_read_statue);17), extern char _declspec(dllexport) Cpubbs_Read1ChannelAdValue1Point(double *cpubbs_ad_result, int *cpubbs_write_statue, int *cpubbs_read_statue);18),extern char _declspec(dllexport) cpubbs_CS_DO(char Cpubbs_CS_DO_State, int *cpubbs_write_statue);19),extern char _declspec(dllexport) cpubbs_CS_DI_State(char *Cpubbs_CS_DI_State, int *cpubbs_write_statue, int *cpubbs_read_statue);20),extern char _declspec(dllexport) cpubbs_SID_DO(char Cpubbs_SID_DO_State, int *cpubbs_write_statue);21),extern char _declspec(dllexport) cpubbs_SID_DI_State(char *Cpubbs_SID_DI_State, int *cpubbs_write_statue, int *cpubbs_read_statue);22),extern char _declspec(dllexport) cpubbs_SCLK_DO(char Cpubbs_SCLK_DO_State, int *cpubbs_write_statue);23),extern char _declspec(dllexport) cpubbs_SCLK_DI_State(char *Cpubbs_SCLK_DI_State, int *cpubbs_write_statue, int *cpubbs_read_statue);现在逐个函数说明：1),char cpubbs_DIO1_DI1(int *cpubbs_write_statue):将DIO1配置成DI1，即是配置为DI数字输入功能；要用它读入一个DI数字量，则需要先调用此VI将其设定为DI以后才可操作读取；运行后有一个输出int *cpubbs_write_statue，代表配置的状态，如果配置成功，则输出为1，如果配置失败则为-1；其他后面的其他函数的这个参数同样代表相同的意思，将不再重复叙述；此函数返回一个char型的变量，为1也代表此函数调用成功，为-1代表失败；2),char cpubbs_DIO1_DO1(int *cpubbs_write_statue):将DIO1配置成DO1，即是配置成DO数字输出功能；要用它输出一个DO数字量，则需要先调用此函数将其设定为DO以后才可操作输出；3),char cpubbs_DIO1_Exint1(unsigned int Cpubbs_SampleRate, int *cpubbs_write_statue):将DIO1配置成外部触发采集功能，由它触发开始按照指定的采样率进行采集，此节点就是将DIO1配置成这样的功能，配置完成后，如果有脉冲送到DIO1口上面，脉冲的上升沿将触发开始按指定的采样率采集10240个点；然后等待上位机读取数据；此控件有一个输入一个输出，输入即是采样率；4),char cpubbs_DIO2_DI2(int *cpubbs_write_statue):和前面的DIO1的用法完全一致，即是将DIO2配置成DI的功能；5),char cpubbs_DIO2_DO2(int *cpubbs_write_statue):和前面DIO1的用法完全一致，即是将DIO2配置成DO的功能；6),char cpubbs_DIO2_Exint2(int *cpubbs_write_statue):将DIO2配置成计数器的功能，当配置好以后，它将自动启动，累计一秒内发生的脉冲个数；并存储起来，等待上位机读取；每次要读取前请先调用此节点一次，此节点相当于有清零计数器，并且重新启动计数的功能，计数满一秒后，将停止计数，等待用户读取；下次要再读则再次配置； 7),char cpubbs_Get_DI1(char *Cpubbs_DI1_State, int *cpubbs_write_statue, int *cpubbs_read_statue):当DIO1被配置成DI1的时候，使用此节点来读取DI1当前的状态；其中cpubbs_DI1_State为一布尔量，指法当前的DI1的状态；返回值为一个char型的，代表此节点调用的状态指示，成功则为1，失败为-1；cpubbs_read_statue是指示读取状态，如果成功则为1，失败则为-1，和cpubbs_write_statue同理，cpubbs_write_statue是写指令成功则为1，失败则为-1，此几个节点调用状态指示变量，主要方法用户需要处理一些信息，比如如果遇到失败的情况，则提示操作人员需要进行什么样的处理，比如重上电等操作，使系统更加具备纠错功能；8),char cpubbs_Get_DI2(char *Cpubbs_DI2_State, int *cpubbs_write_statue, int *cpubbs_read_statue):当DIO2被配置成DI2的时候，使用此节点来读取DI2当前的状态；使用方法同上；9),char cpubbs_Get_Exint2_State(char *Cpubbs_Exint2_CurrentState, unsigned int *Cpubbs_GetFrequency, int *cpubbs_write_statue, int *cpubbs_read_statue):当DIO2被设定为计数器/测频器时，读取当前的状态，当Cpubbs_Exint2_CurrentState为1时，表示完成了一秒的测试计数/测频工作，此时的Cpubbs_GetFrequency的值，即是信号脉冲的频率/计数值；如果Cpubbs_Exint2_CurrentState为0，则代表还没有完成1秒的计数功能，用户需要再次继续读取，直到为1为止；详细可以查看我们的示例程序Main.vi中有使用到;10),char cpubbs_Set_DO1(char Cpubbs_DO1_State, int *cpubbs_write_statue):当DIO1被配置为DO1的时候，我们如果要往这个DO输出一个高或低的电平，就要使用到这个节点来控制；当我们给char Cpubbs_DO1_State设为1时，它就输出一个高电平，输入一个0时，它就输出一个低电平；11),char cpubbs_Set_DO2(char Cpubbs_DO2_State, int *cpubbs_write_statue)：用法同上；12),char cpubbs_Set_GainAndChannel(unsigned int Cpubbs_Gain, unsigned char Cpubbs_Channel, int *cpubbs_write_statue):设定采集卡的增益及要切换到的通道号；Cpubbs_Gain是增益，允许值有1,10,100,1000；Cpubbs_Channel是通道号，允许值有18;当为高速采集前，需要先设定增益和通道号，默认均为1；对于单点采集，因为它是所有通道扫描一次，所以使用此节点时可以无须关注通道号，可以随便填写，比如填入1即可；13),char Cpubbs_GetHighRateSamleData(double *cpubbs_HightRateSampleData, int *cpubbs_write_statue, int *cpubbs_read_statue):读取由软件或硬件触发采集所得到的数据；Cpubbs_HightRateSampleData是一个double型的数组，包含了10240个采集数据；一般的操作流程为：配置采集卡为软件触发或是外部硬件触发，然后再读取当前的完成状态（后面我们会说到有这样的一个函数），当完成了以后，则调用此函数来读取数据；14),char cpubbs_Get_Exint1_State(unsigned int *Cpubbs_SampledPoints, int *cpubbs_write_statue, int *cpubbs_read_statue):读取当前采集是否完成了的状态；当Cpubbs_SampledPoints为20480时则代表完成了采集；就可以调用数据读取节点来读取采集到的数据了；15),char Cpubbs_ReadAllChannelAdValue1Point(double *cpubbs_ad_result, int *cpubbs_write_statue, int *cpubbs_read_statue):单点采集的函数，调用此函数将会将8个通道的信号全部采集一次，并以一个double型的数组cpubbs_ad_result输出，里面有8个元素，一个元素代表一个通道的值；元素0代表通道1，元素1代表通道2，依此类推；16),char Cpubbs_SoftWareTriggerHighRateSample(unsigned int Cpubbs_SampleRate, int *cpubbs_write_statue):软件触发采集配置节点，此节点需要配置采样率，当此节点一调用完成，采集卡即开始以指定的采样率进行采集，用户可以调用我们上面讲到的cpubbs_Get_Exint1_State(unsigned int *Cpubbs_SampledPoints, int *cpubbs_write_statue, int *cpubbs_read_statue)来读取当前采集是否完成了的状态，完成了以后再调用Cpubbs_GetHighRateSamleData(double *cpubbs_HightRateSampleData, int *cpubbs_write_statue, int *cpubbs_read_statue)来读取采集的数据；17), char Cpubbs_Read1ChannelAdValue1Point(double *cpubbs_ad_result, long *cpubbs_write_statue, long *cpubbs_read_statue);：采集当前通道的AD值；通道和增益可以用”设定采集卡的增益及要切换到的通道号”节点来配置，然后再调用此节点来采集；所以，通过这二个节点的配合，可以做到不同通道为不同的增益，并且通道号可以不按顺序，随意选择，非常方便采集；18), char cpubbs_CS_DI_State(char *Cpubbs_CS_DI_State,int *cpubbs_write_statue, int *cpubbs_read_statue);将CS设为DI，并且读入DI的值， char *Cpubbs_CS_DI_St