CAN-bus 通用测试软件及接口函数库使用手册

｝ＶＣＩ＿ＣＡＮ＿ＳＴＡＴＵＳ，＊ＰＶＣＩ＿ＣＡＮ＿ＳＴＡＴＵＳ；
参数：
ＥｒｒＩｎｔｅｒｒｕｐｔ 中断记录，读操作会清除；
ｒｅｇＭｏｄｅ ＣＡＮ 控制器模式寄存器；
ｒｅｇＳｔａｔｕｓ ＣＡＮ 控制器状态寄存器；
ｒｅｇＡＬＣａｐｔｕｒｅ ＣＡＮ 控制器仲裁丢失寄存器；
ｒｅｇＥＣＣａｐｔｕｒｅ ＣＡＮ 控制器错误寄存器；
当您打开设备成功后，您可以从“设备操作”菜单中选择“参数设置”选项来进行一些参数设置（如 果您想采用默认设置的话，可以略过此步骤）：
（１）如果您操作的设备是 ＣＡＮ２３２ 的话，将会弹出以下对话框：
－2－
广州周立功单片机发展有限公司

在此对话框中可以读取和更改 ＣＡＮ 控制器的一些参数设置。在设置滤波器时，需要输入的参数长度为 １２ 个字节，输入格式类似于“ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ＦＦ ”（为 １６ 进制），具体参数怎么设 置请参阅后面的接口函数库说明中的 ＶＣＩ＿ＳｅｔＲｅｆｅｒｅｎｃｅ 函数中的参数说明。 （２）而如果您操作的是其它设备的话，则会弹出以下对话框：
ERR_BUFFERCREATE
０ｘ００００８０００
内存不足
２．３．函数库中的数据结构定义
２．３．１． 存储 ＺＬＧＣＡＮ 系列接口卡信息的数据结构
定义：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＿ＶＣＩ＿ＢＯＡＲＤ＿ＩＮＦＯ｛
ＵＳＨＯＲＴ ｈｗ＿Ｖｅｒｓｉｏｎ；
ＵＳＨＯＲＴ ｆｗ＿Ｖｅｒｓｉｏｎ；
ｒｅｇＥＷＬｉｍｉｔ ＣＡＮ 控制器错误警告限制寄存器；
ｒｅｇＲＥＣｏｕｎｔｅｒ ＣＡＮ 控制器接收错误寄存器；
ｒｅｇＴＥＣｏｕｎｔｅｒ ＣＡＮ 控制器发送错误寄存器；
Ｒｅｓｅｒｖｅｄ 系统保留。
２．３．４． 存储错误信息的数据结构
定义：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＿ＥＲＲ＿ＩＮＦＯ｛

１．１．５． 启动 ＣＡＮ 和复位 ＣＡＮ
在打开设备后，要想能够发送和接收数据，则必须点击下图中的“启动 ＣＡＮ”按钮：
１．１．６． 发送数据
当您启动 ＣＡＮ 成功后，在下图中设置好您要发送的 ＣＡＮ 帧的各项参数，然后点击“发送”按钮就可以 发送数据了：
错误码；
Ｐａｓｓｉｖｅ＿ＥｒｒＤａｔａ
当产生的错误中有消极错误时表示为消极错误的错误标识数据；
ＡｒＬｏｓｔ＿ＥｒｒＤａｔａ
当产生的错误中有仲裁丢失错误时表示为仲裁丢失错误的错误标识数据。
２．３．５． 定义初始化 ＣＡＮ 的数据结构
定义：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＿ＩＮＩＴ＿ＣＯＮＦＩＧ｛
ＩＤ
报文 ＩＤ；
ＤａｔａＬｅｎ
数据长度（＜＝８），即 Ｄａｔａ 的长度；
Ｄａｔａ
报文的数据；
Ｒｅｓｅｒｖｅｄ 系统保留。
２．３．３． 存储 ＣＡＮ 控制器状态的数据结构
定义：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＿ＶＣＩ＿ＣＡＮ＿ＳＴＡＴＵＳ｛
ＵＣＨＡＲ ＥｒｒＩｎｔｅｒｒｕｐｔ；
ＤＷＯＲＤ ＡｃｃＣｏｄｅ；
ＤＷＯＲＤ ＡｃｃＭａｓｋ；
ＤＷＯＲＤ Ｒｅｓｅｒｖｅｄ；
ＵＣＨＡＲ Ｆｉｌｔｅｒ；
ＵＣＨＡＲ Ｔｉｍｉｎｇ０；
ＵＣＨＡＲ Ｔｉｍｉｎｇ１；
ＵＣＨＡＲ Ｍｏｄｅ；
｝ＶＣＩ＿ＩＮＩＴ＿ＣＯＮＦＩＧ，＊ＰＶＣＩ＿ＩＮＩＴ＿ＣＯＮＦＩＧ；
０ｘ０００００００４ ０ｘ０００００００８
设备类型号 １ ２ ３ ４ ５ ６ ７ ８ ９ １０
描述 CAN 控制器内部 FIFO 溢出
CAN 控制器错误报警 CAN 控制器消极错误 CAN 控制器仲裁丢失
－6－
广州周立功单片机发展有限公司
ห้องสมุดไป่ตู้

DevType： 设备类型号。
DevIndex：
设备索引号，比如当只有一个 PCI5121 时，索引号为 0，有两个时可以为 0 或 1。 （注：当为
CAN232 时，0 表示要打开的是 COM1，1 表示要打开的是 COM2。） Reserved：
当设备为 CAN232 时，此参数表示为用以打开串口的波特率，可以为 2400，4800，9600，14400， 19200，28800，57600。当为其他设备时此参数无意义。 函数功能：
１．１．设备操作 １．１．１． 设备类型选择
在进行操作之前，首先得从“类型”菜单中选择您想要操作的设备类型，如下图所示：
１．１．２． 打开设备
接着，从“设备操作”菜单中选择“打开设备”选项来打开设备：
－1－
广州周立功单片机发展有限公司

（１）这时，如果您选择要操作的设备是 ＣＡＮ２３２ 的话，就会弹出下面这个对话框：
在对话框中选择您想要打开的端口和用以打开端口的波特率，然后点“确定”按钮来打开设备。 （２）而如果您选择的是其它设备的话，则会弹出下面这个对话框：
在这个对话框中您可以选择您要打开的设备索引号和第几路 ＣＡＮ，以及设置 ＣＡＮ 的初始化参数，然后 点“确定”按钮来打开设备。 １．１．３． 设置参数
ERR_CAN_BUSERR ERR_DEVICEOPENED
０ｘ００００００１０ ０ｘ０００００１００
CAN 控制器总线错误 设备已经打开
ERR_DEVICEOPEN ERR_DEVICENOTOPEN
０ｘ０００００２００ ０ｘ０００００４００
打开设备错误 设备没有打开
广州周立功单片机发展有限公司

ＣＡＮ－ｂｕｓ 通用测试软件及接口函数库使用手册
一．测试软件使用说明
CAN-bus 通用测试软件是一个专门用来对所有的 ＺＬＧＣＡＮ 系列板卡进行测试的软件工具，此软件操 作简单，容易上手，通过运用此软件可以非常方便的对板卡进行测试，从而熟悉板卡的性能，其主界面如 下：
参数：
ＡｃｃＣｏｄｅ
验收码；
ＡｃｃＭａｓｋ
屏蔽码；
Ｒｅｓｅｒｖｅｄ
保留；
Ｆｉｌｔｅｒ
滤波方式；
Ｔｉｍｉｎｇ０
定时器 ０；
Ｔｉｍｉｎｇ１
定时器 １；
Ｍｏｄｅ
模式。
２．４．接口库函数说明
２．４．１． DWORD __stdcall VCI_OpenDevice(DWORD DevType,DWORD DevIndex, DWORD Reserved); 入口参数：
板卡所使用的中断号；
ｃａｎ＿Ｎｕｍ
表示有几路 ＣＡＮ 通道；
ｓｔｒ＿Ｓｅｒｉａｌ＿Ｎｕｍ
此板卡的序列号；
ｓｔｒ＿ｈｗ＿Ｔｙｐｅ
硬件类型，比如“ＵＳＢＣＡＮ Ｖ１．００”（注意：包括字符串结束符’＼０’）；
Ｒｅｓｅｒｖｅｄ 系统保留。
２．３．２． 定义 ＣＡＮ 信息帧的数据结构
定义：
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ ＿ＶＣＩ＿ＣＡＮ＿ＯＢＪ｛
ＵＩＮＴ ＩＤ；
ＵＩＮＴ ＴｉｍｅＳｔａｍｐ；
ＢＹＴＥ ＴｉｍｅＦｌａｇ；
ＢＹＴＥ ＳｅｎｄＴｙｐｅ；
ＢＹＴＥ ＲｅｍｏｔｅＦｌａｇ；
ＢＹＴＥ ＥｘｔｅｒｎＦｌａｇ；
－7－
广州周立功单片机发展有限公司
下图为正在发送数据中的画面：
－4－
广州周立功单片机发展有限公司

１．２．辅助操作
本软件中还设置了一些辅助操作，以方便您能够更好的观察和分析 ＣＡＮ 数据，在“编辑”菜单中的各 项操作即为辅助操作：
１．２．１． 设置数据列表缓冲帧数
通过设置缓冲区大小来改变当前屏幕所能缓冲显示的最大帧数，如下图：
此时你可以读取 ＣＡＮ 控制器的状态和当前的错误信息。由于在初始化的时候已经把 ＣＡＮ 控制器的参数
都设置好了，所以在这里就没有设置参数的选项。
１．１．４． 获取设备信息
在打开设备后，您可以选择“设备操作”菜单中的“设备信息”选项来获得当前设备的详细信息：
－3－
广州周立功单片机发展有限公司
时有意义；
ＴｉｍｅＳｔａｍｐ 接收到信息帧时的时间标识，从ＣＡＮ控制器初始化开始计时；
ＳｅｎｄＴｙｐｅ 发送帧类型，＝０时为正常发送，＝１时为单次发送，＝２时为自发自收，＝３时为单次自
发自收，只在此帧为发送帧时有意义。
ＲｅｍｏｔｅＦｌａｇ 是否是远程帧；
ＥｘｔｅｒｎＦｌａｇ 是否是扩展帧；
ＵＳＨＯＲＴ ｄｒ＿Ｖｅｒｓｉｏｎ；
ＵＳＨＯＲＴ ｉｎ＿Ｖｅｒｓｉｏｎ；
ＵＳＨＯＲＴ ｉｒｑ＿Ｎｕｍ；
ＢＹＴＥ ｃａｎ＿Ｎｕｍ；
ＣＨＡＲ ｓｔｒ＿Ｓｅｒｉａｌ＿Ｎｕｍ［２０］；
ＣＨＡＲ ｓｔｒ＿ｈｗ＿Ｔｙｐｅ［４０］；
ＵＳＨＯＲＴ Ｒｅｓｅｒｖｅｄ［４］；
｝ ＶＣＩ＿ＢＯＡＲＤ＿ＩＮＦＯ，＊ＰＶＣＩ＿ＢＯＡＲＤ＿ＩＮＦＯ；
－8－
广州周立功单片机发展有限公司

ＵＩＮＴ ＥｒｒＣｏｄｅ；
ＢＹＴＥ Ｐａｓｓｉｖｅ＿ＥｒｒＤａｔａ［３］；
ＢＹＴＥ ＡｒＬｏｓｔ＿ＥｒｒＤａｔａ；
｝ ＶＣＩ＿ＥＲＲ＿ＩＮＦＯ，＊ＰＶＣＩ＿ＥＲＲ＿ＩＮＦＯ；
参数：
ＥｒｒＣｏｄｅ
１．２．２． 定位到指定帧 在下面这个对话框中输入您想要观察的数据行，就可以跳转到指定行：
－5－
广州周立功单片机发展有限公司

１．２．３． 保存数据到文件 通过选择此选项来把当前屏幕列表中的数据存储到文件中。
１．２．４． 刷新数据列表 选择此选项清空屏幕列表中的数据。
１．２．５． 暂停显示发送和接收的数据 选择此选项后，接收和发送都在后台进行，其数据不在屏幕上显示出来。