CAN-bus通用测试软件及接口函数库使用手册-USB迷|专注于互联网分享

2024年7月22日发(作者：益沛凝)

CAN-bus 通用测试软件及接口函数

库使用手册

V1.7

测试软件使用说明..........................................................................................................................................1

1.1.

设备操作............................................................................................................................................1

1.1.1.

1.1.2.

1.1.3.

1.1.4.

1.1.5.

1.1.6.

1.2.

1.2.1.

1.2.2.

1.2.3.

1.2.4.

1.2.5.

1.2.6.

1.2.7.

2.1.

2.2.

2.3.

设备类型选择...........................................................................................................................1

打开设备...................................................................................................................................1

设置参数...................................................................................................................................2

获取设备信息...........................................................................................................................3

启动CAN和复位4

发送数据...................................................................................................................................4

设置数据列表缓冲帧数...........................................................................................................5

定位到指定帧...........................................................................................................................5

保存数据到文件.......................................................................................................................6

刷新数据列表...........................................................................................................................6

暂停显示发送和接收的数据...................................................................................................6

继续显示发送和接收的数据...................................................................................................6

总是显示最后一行数据...........................................................................................................6

辅助操作............................................................................................................................................5

接口函数库说明及其使用..............................................................................................................................7

接口卡设备类型定义........................................................................................................................7

错误码定义........................................................................................................................................7

函数库中的数据结构定义.................................................................................................................8

2.3.1.

2.3.2.

2.3.3.

2.3.4.

2.3.5.

2.3.6.

2.4.

2.4.1.

2.4.2.

2.4.3.

2.4.4.

2.4.5.

2.4.6.

2.4.7.

2.4.8.

2.4.9.

2.4.10.

2.4.11.

2.4.12.

2.4.13.

2.4.14.

2.5.

VCI_8

VCI_.8

VCI_.9

VCI_10

.11

.25

.35

接口库函数说明..............................................................................................................................13

接口库函数使用方法......................................................................................................................38

2.5.1.

2.5.2.

2.6.

3.1.

VC调用动态库的方法............................................................................................................38

VB调用动态库的方法............................................................................................................38

接口库函数使用流程......................................................................................................................39

驱动程序的安装..............................................................................................................................40

3.1.1.

3.1.2.

USBCAN驱动的安装.............................................................................................................40

PCI5121驱动的安装..............................................................................................................40

Linux下动态库的使用...................................................................................................................................40

3.2.

3.3.

动态库的安装..................................................................................................................................40

动态库的调用及编译......................................................................................................................40

1. 测试软件使用说明

CAN-bus 通用测试软件是一个专门用来对所有的ZLGCAN系列板卡进行测试的软件工具，此软件操

作简单，容易上手，通过运用此软件可以非常方便的对板卡进行测试，从而熟悉板卡的性能，其主界面如

下：

1.1. 设备操作

1.1.1. 设备类型选择

在进行操作之前,首先得从“类型”菜单中选择您想要操作的设备类型，如下图所示：

1.1.2. 打开设备

接着，从“设备操作”菜单中选择“打开设备”选项来打开设备：

(1) 这时，如果您选择要操作的设备是CAN232的话，就会弹出下面这个对话框：

(2) 而如果您选择的是其它设备的话，则会弹出下面这个对话框：

在对话框中选择您想要打开的端口和用以打开端口的波特率，然后点“确定”按钮来打开设备。

1.1.3. 设置参数

当您打开设备成功后，您可以从“设备操作”菜单中选择“参数设置”选项来进行一些参数设置（如果您

想采用默认设置的话，可以略过此步骤）：

在这个对话框中您可以选择您要打开的设备索引号和第几路CAN，以及设置CAN的初始化参数，然

后点“确定”按钮来打开设备。

(1) 如果您操作的设备是CAN232的话，将会弹出以下对话框：

在此对话框中可以读取和更改CAN控制器的一些参数设置。在设置滤波器时，需要输入的参数长度

为12个字节，输入格式类似于“FF FF FF FF FF FF FF FF FF FF FF FF ”（为16进制），具体参数怎么设置

请参阅后面的接口函数库说明中的VCI_SetReference函数中的参数说明。

(2) 而如果您操作的是其它设备的话，则会弹出以下对话框：

1.1.4. 获取设备信息

此时你可以读取CAN控制器的状态和当前的错误信息。由于在初始化的时候已经把CAN控制器的参

数都设置好了，所以在这里就没有设置参数的选项。

在打开设备后，您可以选择“设备操作”菜单中的“设备信息”选项来获得当前设备的详细信息：

1.1.5. 启动CAN和复位CAN

在打开设备后，要想能够发送和接收数据，则必须点击下图中的“启动CAN”按钮（注：在CANET-E

中无需启动CAN就可以收发数据，只有这个设备比较特殊）：

1.1.6. 发送数据

当您启动CAN成功后，在下图中设置好您要发送的CAN帧的各项参数，然后点击“发送”按钮就可

以发送数据了（其中发送格式下拉框中的自发自收选项表示发送出去的CAN帧自己也能收到，这个选项在

测试的时候才需用到，在实际的应用中请选用正常发送）：

下图为正在发送数据中的画面：

1.2. 辅助操作

本软件中还设置了一些辅助操作，以方便您能够更好的观察和分析CAN数据，在“编辑”菜单中的

各项操作即为辅助操作：

1.2.1. 设置数据列表缓冲帧数

通过设置缓冲区大小来改变当前屏幕所能缓冲显示的最大帧数，如下图：

1.2.2. 定位到指定帧

在下面这个对话框中输入您想要观察的数据行，就可以跳转到指定行：

1.2.3. 保存数据到文件

通过选择此选项来把当前屏幕列表中的数据存储到文件中。

1.2.4. 刷新数据列表

选择此选项清空屏幕列表中的数据。

1.2.5. 暂停显示发送和接收的数据

选择此选项后，接收和发送都在后台进行，其数据不在屏幕上显示出来。

1.2.6. 继续显示发送和接收的数据

选择此选项后，接收和发送都在前台进行，其数据在屏幕上显示出来。

1.2.7. 总是显示最后一行数据

选择此选项后，当前数据列表中的最后一行总是可见。

2. 接口函数库说明及其使用

2.1. 接口卡设备类型定义

各个接口卡的类型定义如下：

设备名称设备类型号

PCI5121 1

PCI9810 2

USBCAN1 3

USBCAN2 4

PCI9820 5

CAN232 6

PCI5110 7

CANlite(CANmini) 8

ISA9620 9

ISA5420 10

PC104-CAN 11

CANET-E 12

DNP9810 13

PCI9840 14

PC104-CAN2 15

PCI9820I 16

2.2. 错误码定义

名称值描述

ERR_CAN_OVERFLOW 0x00000001

CAN控制器内部FIFO溢出

ERR_CAN_ERRALARM 0x00000002

CAN控制器错误报警

ERR_CAN_PASSIVE 0x00000004

CAN控制器消极错误

ERR_CAN_LOSE 0x00000008

CAN控制器仲裁丢失

ERR_CAN_BUSERR 0x00000010

CAN控制器总线错误

ERR_DEVICEOPENED 0x00000100

设备已经打开

ERR_DEVICEOPEN 0x00000200

打开设备错误

ERR_DEVICENOTOPEN 0x00000400

设备没有打开

ERR_BUFFEROVERFLOW 0x00000800

缓冲区溢出

ERR_DEVICENOTEXIST 0x00001000

此设备不存在

ERR_LOADKERNELDLL 0x00002000

装载动态库失败

ERR_CMDFAILED 0x00004000

执行命令失败错误码

ERR_BUFFERCREATE 0x00008000

内存不足

ERR_CANETE_PORTOPENED0x00010000

端口已经被打开

ERR_CANETE_INDEXUSED 0x00020000

设备索引号已经被占用

2.3. 函数库中的数据结构定义

2.3.1.

描述

VCI_BOARD_INFO结构体包含ZLGCAN系列接口卡的设备信息。结构体将在VCI_ReadBoardInfo

函数中被填充。

typedef struct _VCI_BOARD_INFO {

USHORT hw_Version;

USHORT fw_Version;

USHORT dr_Version;

USHORT in_Version;

USHORT irq_Num;

BYTE can_Num;

CHAR str_Serial_Num[20];

CHAR str_hw_Type[40];

USHORT Reserved[4];

} VCI_BOARD_INFO, *PVCI_BOARD_INFO;

成员

hw_Version

硬件版本号，用16进制表示。比如0x0100表示V1.00。

fw_Version

固件版本号，用16进制表示。

dr_Version

驱动程序版本号，用16进制表示。

in_Version

接口库版本号，用16进制表示。

irq_Num

板卡所使用的中断号。

can_Num

表示有几路CAN通道。

str_Serial_Num

此板卡的序列号。

str_hw_Type

Reserved

系统保留。

2.3.2.

描述

VCI_CAN_OBJ结构体在VCI_Transmit和VCI_Receive函数中被用来传送CAN信息帧。

typedef struct _VCI_CAN_OBJ {

UINT ID;

UINT TimeStamp;

BYTE TimeFlag;

BYTE SendType;

VCI_CAN_OBJ

硬件类型，比如“USBCAN V1.00”（注意：包括字符串结束符’0’）。

VCI_BOARD_INFO

BYTE RemoteFlag;

BYTE ExternFlag;

BYTE DataLen;

BYTE Data[8];

BYTE Reserved[3];

} VCI_CAN_OBJ, *PVCI_CAN_OBJ;

成员

报文ID。

TimeStamp

接收到信息帧时的时间标识，从CAN控制器初始化开始计时。

TimeFlag

是否使用时间标识，为1时TimeStamp有效，TimeFlag和TimeStamp只在此帧为接收帧时有意义。

SendType

发送帧类型，=0时为正常发送，=1时为单次发送，=2时为自发自收，=3时为单次自发自收，只在此

帧为发送帧时有意义。

RemoteFlag

是否是远程帧。

ExternFlag

是否是扩展帧。

DataLen

数据长度(<=8)，即Data的长度。

Data

报文的数据。

Reserved

系统保留。

2.3.3.

描述

VCI_CAN_STATUS结构体包含CAN控制器状态信息。结构体将在VCI_ReadCanStatus函数中被填充。

typedef struct _VCI_CAN_STATUS {

UCHAR ErrInterrupt;

UCHAR regMode;

UCHAR regStatus;

UCHAR regALCapture;

UCHAR regECCapture;

UCHAR regEWLimit;

UCHAR regRECounter;

UCHAR regTECounter;

DWORD Reserved;

} VCI_CAN_STATUS, *PVCI_CAN_STATUS;

成员

ErrInterrupt

中断记录，读操作会清除。

VCI_CAN_STATUS

regMode

CAN控制器模式寄存器。

regStatus

CAN控制器状态寄存器。

regALCapture

CAN控制器仲裁丢失寄存器。

regECCapture

CAN控制器错误寄存器。

regEWLimit

CAN控制器错误警告限制寄存器。

regRECounter

CAN控制器接收错误寄存器。

regTECounter

CAN控制器发送错误寄存器。

Reserved

系统保留。

2.3.4.

描述

VCI_ERR_INFO结构体用于装载VCI库运行时产生的错误信息。结构体将在VCI_ReadErrInfo函数中

被填充。

typedef struct _ERR_INFO {

UINT ErrCode;

BYTE Passive_ErrData[3];

BYTE ArLost_ErrData;

} VCI_ERR_INFO, *PVCI_ERR_INFO;

成员

ErrCode

错误码。

Passive_ErrData

当产生的错误中有消极错误时表示为消极错误的错误标识数据。

ArLost_ErrData

当产生的错误中有仲裁丢失错误时表示为仲裁丢失错误的错误标识数据。

2.3.5.

描述

VCI_INIT_CONFIG结构体定义了初始化CAN的配置。结构体将在VCI_InitCan函数中被填充。

typedef struct _INIT_CONFIG {

DWORD AccCode;

DWORD AccMask;

DWORD Reserved;

UCHAR Filter;

UCHAR Timing0;

UCHAR Timing1;

VCI_INIT_CONFIG

VCI_ERR_INFO

UCHAR Mode;

} VCI_INIT_CONFIG, *PVCI_INIT_CONFIG;

成员

AccCode

验收码。

AccMask

屏蔽码。

Reserved

保留。

Filter

滤波方式。

Timing0

定时器0（BTR0）。

Timing1

定时器1（BTR1）。

Mode

模式。

备注

Timing0和Timing1用来设置CAN波特率，几种常见的波特率设置如下：

CAN波特率定时器0 定时器1

0xFF

0x1C

0xFF

0x1C

0Xff

0x1C

0xFA

0x1C

0xFA

0x1C

0xB6

0x16

0x14

5Kbps 0xBF

10Kbps 0x31

20Kbps 0x18

40Kbps 0x87

50Kbps 0x09

80Kbps 0x83

100Kbps 0x04

125Kbps 0x03

200Kbps 0x81

250Kbps 0x01

400Kbps 0x80

500Kbps 0x00

666Kbps 0x80

800Kbps 0x00

1000Kbps 0x00

2.3.6.

描述

CHGDESIPANDPORT结构体用于装载更改CANET-E的目标IP和端口的必要信息。此结构体在

CANETE-E中使用。

typedef struct _tagChgDesIPAndPort {

char szpwd[10];

char szdesip[20];

int desport;

CHGDESIPANDPORT

BYTE blisten;

} CHGDESIPANDPORT;

成员

szpwd[10]

更改目标IP和端口所需要的密码，长度小于10，比如为“11223344”。

szdesip[20]

所要更改的目标IP，比如为“192.168.0.111”。

desport

所要更改的目标端口，比如为4000。

blisten

所要更改的工作模式，0表示正常模式，1表示只听模式。

2.4. 接口库函数说明

2.4.1.

描述

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

Reserved

当设备为CAN232时，此参数表示为用以打开串口的波特率，可以为2400，4800，9600，14400，19200，

28800，57600。当设备为CANETE-E时，此参数表示要打开的本地端口号，建议在5000到40000范

围内取值。当为其他设备时此参数无意义。

返回值

为1表示操作成功，0表示操作失败。

示例

#include "ControlCan.h"

int nDeviceType = 6; /* CAN232 */

int nDeviceInd = 0; /* COM1 */

int nReserved = 9600; /* Baudrate */

DWORD dwRel;

dwRel = VCI_OpenDevice(nDeviceType, nDeviceInd, nReserved);

if (dwRel != STATUS_OK)

{

MessageBox(_T("打开设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

}

此函数用以打开设备。

DWORD __stdcall VCI_OpenDevice(DWORD DevType, DWORD DevIndex, DWORD Reserved);

VCI_OpenDevice

2.4.2.

描述

此函数用以关闭设备。

DWORD __stdcall VCI_CloseDevice(DWORD DevType, DWORD DevIndex);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

返回值

为1表示操作成功，0表示操作失败。

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

BOOL bRel;

bRel = VCI_CloseDevice(nDeviceType, nDeviceInd);

VCI_CloseDevice

2.4.3.

描述

此函数用以初始化指定的CAN。

DWORD __stdcall VCI_InitCan(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_INIT_CONFIG

pInitConfig);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

pInitConfig

初始化参数结构（注：当为CAN232时，忽略此参数，其值设为NULL）。

成员

pInitConfig->AccCode

pInitConfig->AccMask

功能描述

AccCode对应SJA1000中的四个寄存器ACR0，ACR1，ACR2，ACR3，

其中高字节对应ACR0，低字节对应ACR3；AccMask对应SJA1000中

的四个寄存器AMR0，AMR1，AMR2，AMR3，其中高字节对应AMR0，

低字节对应AMR3。（请看表后说明）

pInitConfig->Reserved

pInitConfig->Filter

pInitConfig->Timing0

pInitConfig->Timing1

pInitConfig->Mode

保留

滤波方式，1表示单滤波，0表示双滤波

定时器0

定时器1

模式，0表示正常模式，1表示只听模式

VCI_InitCan

当滤波方式为单滤波，接收帧为标准帧时：

RTR对应VCI_CAN_OBJ中的RemoteFlag

当滤波方式为单滤波，接收帧为扩展帧时：

当滤波方式为双滤波，接收帧为标准帧时：

当滤波方式为双滤波，接收帧为扩展帧时：

返回值

为1表示操作成功，0表示操作失败。（注：在CANET-E中无此函数）

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

int nReserved = 9600; // Baudrate

VCI_INIT_CONFIG vic;

DWORD dwRel;

dwRel = VCI_OpenDevice(nDeviceType, nDeviceInd, nReserved);

if (dwRel != STATUS_OK)

{

MessageBox(_T("打开设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

}

dwRel = VCI_InitCAN(nDeviceType, nDeviceInd, nCANInd, &vic);

if (dwRel == STATUS_ERR)

{

VCI_CloseDevice(nDeviceType, nDeviceInd);

MessageBox(_T("初始化设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

}

2.4.4.

描述

此函数用以获取设备信息。

DWORD __stdcall VCI_ReadBoardInfo(DWORD DevType, DWORD DevIndex, PVCI_BOARD_INFO pInfo);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

pInfo

用来存储设备信息的VCI_BOARD_INFO结构指针。

返回值

为1表示操作成功，0表示操作失败。（注：在CANET-E中无此函数）

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

VCI_INIT_CONFIG vic;

VCI_BOARD_INFO vbi;

DWORD dwRel;

bRel = VCI_ReadBoardInfo(nDeviceType, nDeviceInd, nCANInd, &vbi);

VCI_ReadBoardInfo

2.4.5.

描述

此函数用以获取最后一次错误信息。

DWORD __stdcall VCI_ReadErrInfo(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_ERR_INFO

pErrInfo);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。（注：当要读取设备错误的时候，此参数应该设为－1。比如当调用VCI_OpenDevice，

VCI_CloseDevice和VCI_ReadBoardInfo这些与特定的第几路CAN操作无关的操作函数失败后，调用

此函数来获取失败错误码的时候应该把CANIndex设为－1。）

pErrInfo

用来存储错误信息的VCI_ERR_INFO结构指针。pErrInfo->ErrCode可能为下列各个错误码的多种组

合之一：

ErrCode

0x0100

0x0200

0x0400

0x0800

0x1000

0x2000

0x4000

Passive_ErrData

无

ArLost_ErrData

无

错误描述

设备已经打开

打开设备错误

设备没有打开

缓冲区溢出

此设备不存在

装载动态库失败

表示为执行命令失败错误

内存不足

VCI_ReadErrInfo

0x8000

0x0001

0x0002

0x0004

0x0008

0x0010

返回值

为1表示操作成功，0表示操作失败。

备注

无

有，具体值见表后

无

无 CAN控制器内部FIFO溢出

无 CAN控制器错误报警

无 CAN控制器消极错误

有，具体值见表后 CAN控制器仲裁丢失

无 CAN控制器总线错误

当(PErrInfo->ErrCode&0x0004)==0x0004时，存在CAN控制器消极错误。

PErrInfo->Passive_ErrData[0]错误代码捕捉位功能表示

Bit7 Bit6 Bit5

错误属性

Bit4 Bit3 Bit2

错误段表示

Bit1 Bit0

错误代码类型

错误代码类型功能说明

位ECC.7

位ECC.6 功能

0 0

位错

0 1

格式错

1 0

填充错

1 1

其它错误

错误属性

bit5 =0；表示发送时发生的错误。

错误段表示功能说明

bit4 bit 3 bit 2 bit 1 bit 0

功能

=1；表示接收时发生的错误。

0 0 0 1 1

帧开始

0 0 0 1 0 ID.28-ID.21

0 0 1 1 0 ID.20-ID.18

0 0 1 0 0

SRTR位

0 0 1 0 1

IDE位

0 0 1 1 1 ID.17-ID.13

0 1 1 1 1 ID.12-ID.5

0 1 1 1 0 ID.4-ID.0

0 1 1 0 0

RTR位

0 1 1 0 1

保留位1

0 1 0 0 1

保留位0

0 1 0 1 1

数据长度代码

0 1 0 1 0

数据区

0 1 0 0 0

CRC序列

1 1 0 0 0

CRC定义符

1 1 0 0 1

应答通道

1 1 0 1 1

应答定义符

1 1 0 1 0

帧结束

1 0 0 1 0

中止

1 0 0 0 1

活动错误标志

1 0 1 1 0

消极错误标志

1 0 0 1 1

支配（控制）位误差

1 0 1 1 1

错误定义符

1 1 1 0 0

溢出标志

PErrInfo->Passive_ErrData[1] 表示接收错误计数器

PErrInfo->Passive_ErrData[2] 表示发送错误计数器

当(PErrInfo->ErrCode&0x0008)==0x0008时，存在CAN控制器仲裁丢失错误。

PErrInfo->ArLost_ErrData 仲裁丢失代码捕捉位功能表示

Bit7 Bit6 Bit5 Bit4 Bit3 Bit2

错误段表示

Bit1 Bit0

——— ——— ———

错误段表示功能表示

位

ALC.4 ALC.3 ALC.2 ALC.1 ALC.0

0 0 0 0 0

0 0 0 0 1

0 0 0 1 0

0 0 0 1 1

0 0 1 0 0

0 0 1 0 1

0 0 1 1 0

0 0 1 1 1

0 1 0 0 0

0 1 0 0 1

0 1 0 1 0

0 1 0 1 1

0 1 1 0 0

0 1 1 0 1

0 1 1 1 0

0 1 1 1 1

1 0 0 0 0

1 0 0 0 1

1 0 0 1 0

1 0 0 1 1

1 0 1 0 0

1 0 1 0 1

1 0 1 1 0

1 0 1 1 1

1 1 0 0 0

1 1 0 0 1

1 1 0 1 0

1 1 0 1 1

1 1 1 0 0

1 1 1 0 1

1 1 1 1 0

1 1 1 1 1

十进制值功能

仲裁丢失在识别码的bit1

仲裁丢失在识别码的bit2

仲裁丢失在识别码的bit3

仲裁丢失在识别码的bit4

仲裁丢失在识别码的bit5

仲裁丢失在识别码的bit6

仲裁丢失在识别码的bit7

仲裁丢失在识别码的bit8

仲裁丢失在识别码的bit9

仲裁丢失在识别码的bit10

仲裁丢失在识别码的bit11

仲裁丢失在SRTR位

仲裁丢失在IDE位

仲裁丢失在识别码的bit12

仲裁丢失在识别码的bit13

仲裁丢失在识别码的bit14

仲裁丢失在识别码的bit15

仲裁丢失在识别码的bit16

仲裁丢失在识别码的bit17

仲裁丢失在识别码的bit18

仲裁丢失在识别码的bit19

仲裁丢失在识别码的bit20

仲裁丢失在识别码的bit21

仲裁丢失在识别码的bit22

仲裁丢失在识别码的bit23

仲裁丢失在识别码的bit24

仲裁丢失在识别码的bit25

仲裁丢失在识别码的bit26

仲裁丢失在识别码的bit27

仲裁丢失在识别码的bit28

仲裁丢失在识别码的bit29

仲裁丢失在ERTR位

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

VCI_ERR_INFO vei;

DWORD dwRel;

bRel = VCI_ReadErrInfo(nDeviceType, nDeviceInd, nCANInd, &vei);

2.4.6.

描述

此函数用以获取CAN状态。

DWORD __stdcall VCI_ReadCanStatus(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_STATUS

pCANStatus);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

pCANStatus

用来存储CAN状态的VCI_CAN_STATUS结构指针。

返回值

为1表示操作成功，0表示操作失败。（注：在CANET-E中无此函数）

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

VCI_INIT_CONFIG vic;

VCI_CAN_STATUS vcs;

DWORD dwRel;

bRel = VCI_ReadCANStatus(nDeviceType, nDeviceInd, nCANInd, &vcs);

VCI_ReadCanStatus

2.4.7.

描述

此函数用以获取设备的相应参数。

DWORD __stdcall VCI_GetReference(DWORD DevType, DWORD DevIndex, DWORD CANIndex, DWORD RefType,

PVOID pData);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

RefType

参数类型。

pData

用来存储参数有关数据缓冲区地址首指针。

返回值

为1表示操作成功，0表示操作失败。

备注

(1) 当设备类型为PCI5121，PCI5110或ISA5420时：

RefType

pData

总长度为2个字节，

pData[0] 表示CAN控制器

的控制寄存器的地址，

pData[1]表示要读出CAN

功能描述

读取CAN芯片某个寄存器的值。

例如要读取地址为9的寄存器值：

UCHAR pData[2] = {9,0};

VCI_GetReference(DeviceType,DeviceInd,CANInd,1,pD

如果调用成功，pData[1]将存放读出的值。

(2) 当设备类型为USBCAN1，USBCAN2时：

RefType pData

总长度1个字节，当作为输

入参数时，表示为所要读取

的CAN控制器的控制寄存

器的地址。

当作为输出参数时，表示为

CAN控制器的控制寄存器

的值。

(3) 当设备类型为CANET-E时：

RefType pData

字符串首指针，用来存储所

读取出来的CANETE-E的IP

功能描述

读取CANET-E的IP地址。

例如：

功能描述

读CAN控制器的指定控制寄存器的值。

例如对USBCAN1：

BYTE val=0;

VCI_GetReference(VCI_USBCAN1,0,0,1,(PVOID)&val);

如果此函数调用成功,则在val中返回寄存器的值。

VCI_GetReference

控制器的控制寄存器的值。

ata);

地址。

char szip[20];

VCI_GetReference(VCI_CANETE,0,0,0,(PVOID)szip);

如果此函数调用成功,则在szip中返回CANET-E的地址。

长度为4个字节，存储读取

出来的CANET-E的工作端

口。

读取CANET-E的工作端口。

例如：

int port;

VCI_GetReference(VCI_CANETE,0,0,1,(PVOID)&port);

如果此函数调用成功,则在port中返回CANET-E的工作

端口。

(4) 当设备类型为CAN232时：

RefType

pData

总长度14个字节，当作为输

入参数时，只有第一个字节

有效，值为所读取的滤波器

的序号，以为1，2，3，4。

当作为输出参数时，具体各

个字节所代表的意义见表

后。

总长度1个字节，当作为输

入参数时，表示为所要读取

的CAN控制器的控制寄存

器的地址。

当作为输出参数时，表示为

CAN控制器的控制寄存器

的值。

当RefType=1时,此时返回的pData各个字节所代表的意义如下：

pData[0]信息保留

pData[1]表示CAN控制器BTR0的值；

pData[2]表示CAN控制器BTR1的值；

pData[3]读取该组验收滤波器模式,位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

——— MFORMATB AMODEB

MFORMATB =1; 验收滤波器该组仅用于扩展帧信息。标准帧信息被忽略。

=0; 验收滤波器该组仅用于标准帧信息。扩展帧信息被忽略。

=0; 双验收滤波器选项使能－短滤波器有效。

pData[4]读取该组验收滤波器的使能,位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

——— BF2EN BF1EN

BF2EN =1; 该组滤波器2使能，不能对相应的屏蔽和代码寄存器进行写操作。

=0; 该组滤波器2 禁止，可以改变相应的屏蔽和代码寄存器。

BF1EN =1; 该组滤波器1使能，不能对相应的屏蔽和代码寄存器进行写操作。

AMODEB =1; 单验收滤波器选项使能－长滤波器有效。

数，可以这样：

BYTE info[14];

info[0]=1;

VCI_GetReference(VCI_CAN232,0,0,1,(PVOID)info);

如果此函数调用成功，则在info中返回14个字节的第一

个滤波器的参数。

读CAN控制器的指定控制寄存器的值，例如：

BYTE val=0;

VCI_GetReference(VCI_CAN232,0,0,2,(PVOID)&val);

如果此函数调用成功,则在val中返回寄存器的值。

功能描述

取得指定的滤波器参数，例如要读取第一个滤波器的参

=0; 该组滤波器1禁止，可以改变相应的屏蔽和代码寄存器。

注：如果选择单滤波器模式，该单滤波器与对应的滤波器1 使能位相关。滤波器2 使能位在单滤波

器模式中不起作用。

pData[5]读取该组验收滤波器的优先级,位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

——— BF2PRIO BF1PRIO

BF2PRIO =1; 该组滤波器2优先级高，如果信息通过该组滤波器2，立即产生接收中断。

=0；该组滤波器2优先级低，如果FIFO 级超过接收中断级滤波器，产生接收中断。

BF1PRIO =1; 该组滤波器1优先级高，如果信息通过该组滤波器1，立即产生接收中断。

=0；该组滤波器1优先级低，如果FIFO 级超过接收中断级滤波器，产生接收中断。

pData[6—9]表示该组滤波器ACR的值。

pData[a—d]表示该组滤波器AMR的值。

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

BYTE info[14];

DWORD dwRel;

info[0] = 1;

bRel = VCI_GetReference(nDeviceType, nDeviceInd, nCANInd, 1, (PVOID)info);

2.4.8.

描述

此函数用以设置设备的相应参数，主要处理不同设备的特定操作。

DWORD __stdcall VCI_SetReference(DWORD DevType, DWORD DevIndex, DWORD CANIndex, DWORD RefType,

PVOID pData);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

RefType

参数类型。

pData

用来存储参数有关数据缓冲区地址首指针。

返回值

为1表示操作成功，0表示操作失败。

备注

VCI_SetReference和VCI_GetReference这两个函数是用来针对各个不同设备的一些特定操作的。比如

CAN232的更改波特率，设置报文滤波等等。函数中的PVOID型参数pData随不同设备的不同操作而

具有不同的意义。

(1) 当设备类型为PCI5121，PCI5110或ISA5420时：

RefType pData

表示CAN控制器的控制寄

存器的地址，pData[1] 表示

要写入的数值。

(2) 当设备类型为USBCAN1，USBCAN2时：

RefType pData

表示CAN控制器的控制寄

存器的地址，pData[1] 表示

要写入的数值。

(3) 当设备类型为CANETE-E时：

RefType pData

字符串首指针，用来存储所

指定操作的CANETE-E的

IP地址。

功能描述

设置所要操作的CANET-E的IP地址

功能描述

总长度为2个字节，pData[0]

写CAN控制器的指定控制寄存器

功能描述

总长度为2个字节，pData[0]

写CAN控制器的指定控制寄存器

VCI_SetReference

长度为4个字节，存储所指

定操作的CANET-E的工作

端口。

设置所要操作的CANET-E的工作端口

为CHGDESIPANDPORT结

构指针，存储更改的

CANET-E的目标IP和端口

所需要的信息以及工作模

式。

更改CANET-E的目标IP和端口。

例如：

CHGDESIPANDPORT info;

strcpy(,”112233”); //验证密码

strcpy(p,”192.168.0.100”); 目标IP

t=6000; //目标端口

n=0;//工作在正常模式

VCI_SetReference(VCI_CANETE,0,0,2,(PVOID)&info);

(4) 当设备类型为CAN232时：

RefType pData

总长度为1个字节

＝0； 10Kbps

＝1； 20Kbps

＝2； 50Kbps

＝3； 125Kbps

＝4； 250Kbps

＝5； 500Kbps

＝6； 800Kbps

＝7； 1000Kbps

总长度为12个字节，其各个

字节所代表的意义见表后。

总长度为1个字节

＝1； 2.4Kbps

＝2； 4.8Kbps

＝3； 9.6Kbps

＝4； 14.4Kbps

＝5； 19.2Kbps

＝6； 28.8Kbps

＝7； 57.6Kbps

总长度为2个字节，pData[0]

写CAN控制器的指定控制寄存器

表示CAN控制器的控制寄

存器的地址，pData[1] 表示

要写入的数值。

总长度为1个字节，

＝0xAA；使用时间标识

＝其他；不使用时间标识

当RefType=2时，此时的pData各个字节所代表的意义如下：

pData[0]设置哪一组验收滤波器；共有4组：

=1 设置第1组

设置时间标识

更改232波特率

设置滤波器参数

功能描述

更改CAN波特率，例如要设置CAN的波特率为10Kbps：

BYTE baud=0;

VCI_SetReference(VCI_CAN232,0,0,1,(PVOID)&baud);

=2 设置第2组

=3 设置第3组

=4 设置第4组

pData[1]设置该组验收滤波器模式,位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

——— MFORMATB AMODEB

MFORMATB =1 验收滤波器该组仅用于扩展帧信息。标准帧信息被忽略。

pData[2]设置该组验收滤波器的使能,位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

=0 验收滤波器该组仅用于标准帧信息。扩展帧信息被忽略。

=0 双验收滤波器选项使能－短滤波器有效。

AMODEB =1 单验收滤波器选项使能－长滤波器有效。

——— BF2EN BF1EN

BF2EN =1 该组滤波器2使能，不能对相应的屏蔽和代码寄存器进行写操作。

=0 该组滤波器2 禁止，可以改变相应的屏蔽和代码寄存器。

=0 该组滤波器1禁止，可以改变相应的屏蔽和代码寄存器。

BF1EN =1 该组滤波器1使能，不能对相应的屏蔽和代码寄存器进行写操作。

注：如果选择单滤波器模式，该单滤波器与对应的滤波器1 使能位相关。滤波器2 使能位在单滤波

器模式中不起作用。

pData[3]设置该组验收滤波器的优先级，位功能

STATUS.7 STATUS.6STATUS.5 STATUS.4STATUS.3STATUS.2STATUS.1 STATUS.0

——— BF2PRIO BF1PRIO

BF2PRIO =1 该组滤波器2优先级高，如果信息通过该组滤波器2 ，立即产生接收中断。

=0 该组滤波器2优先级低，如果FIFO 级超过接收中断级滤波器，产生接收中断。

BF1PRIO =1 该组滤波器1优先级高，如果信息通过该组滤波器1 ，立即产生接收中断。

=0 该组滤波器1优先级低，如果FIFO 级超过接收中断级滤波器，产生接收中断。

pData[4---7] 分别对应要设置的SJA1000的ACR0---ACR3的值；

pData[8---b] 分别对应要设置的SJA1000的AMR0---AMR3的值；

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

BYTE baud;

DWORD dwRel;

baud = 0;

bRel = VCI_SetReference(nDeviceType, nDeviceInd, nCANInd, 1, (PVOID)baud);

2.4.9.

描述

此函数用以获取指定接收缓冲区中接收到但尚未被读取的帧数。

ULONG __stdcall VCI_GetReceiveNum(DWORD DevType, DWORD DevIndex, DWORD CANIndex);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

返回值

返回尚未被读取的帧数。

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

DWORD dwRel;

bRel = VCI_GetReceiveNum(nDeviceType, nDeviceInd, nCANInd);

VCI_GetReceiveNum

2.4.10. VCI_ClearBuffer

描述

此函数用以清空指定缓冲区。

DWORD __stdcall VCI_ClearBuffer(DWORD DevType, DWORD DevIndex, DWORD CANIndex);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

返回值

为1表示操作成功，0表示操作失败。

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

DWORD dwRel;

bRel = VCI_ClearBuffer(nDeviceType, nDeviceInd, nCANInd);

2.4.11. VCI_StartCAN

描述

此函数用以启动CAN。

DWORD __stdcall VCI_StartCAN(DWORD DevType, DWORD DevIndex, DWORD CANIndex);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

返回值

为1表示操作成功，0表示操作失败。（注：在CANET-E中无此函数）

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

int nReserved = 9600; // Baudrate

VCI_INIT_CONFIG vic;

DWORD dwRel;

dwRel = VCI_OpenDevice(nDeviceType, nDeviceInd, nReserved);

if (dwRel != STATUS_OK)

{

}

dwRel = VCI_InitCAN(nDeviceType, nDeviceInd, nCANInd, &vic);

if (dwRel == STATUS_ERR)

{

}

dwRel = VCI_StartCAN(nDeviceType, nDeviceInd, nCANInd);

if (dwRel == STATUS_ERR)

{

VCI_CloseDevice(nDeviceType, nDeviceInd);

MessageBox(_T("启动设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

VCI_CloseDevice(nDeviceType, nDeviceInd);

MessageBox(_T("初始化设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

MessageBox(_T("打开设备失败!"), _T("警告"), MB_OK|MB_ICONQUESTION);

return FALSE;

}

2.4.12. VCI_ResetCAN

描述

此函数用以复位CAN。

DWORD __stdcall VCI_ResetCAN(DWORD DevType, DWORD DevIndex, DWORD CANIndex);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

返回值

为1表示操作成功，0表示操作失败。（注：在CANET-E中无此函数）

示例

#include "ControlCan.h"

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

DWORD dwRel;

bRel = VCI_ResetCAN(nDeviceType, nDeviceInd, nCANInd);

2.4.13. VCI_Transmit

描述

返回实际发送的帧数。

ULONG __stdcall VCI_Transmit(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_OBJ pSend,

ULONG Len);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

pSend

要发送的数据帧数组的首指针。

Len

要发送的数据帧数组的长度。

返回值

返回实际发送的帧数。

示例

#include "ControlCan.h"

#include

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

DWORD dwRel;

VCI_CAN_OBJ vco;

ZeroMemory(&vco, sizeof (VCI_CAN_OBJ));

= 0x00000000;

pe = 0;

Flag = 0;

n = 8;

lRet = VCI_Transmit(nDeviceType, nDeviceInd, nCANInd, &vco, i);

2.4.14. VCI_Receive

描述

此函数从指定的设备读取数据。

ULONG __stdcall VCI_Receive(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_OBJ pReceive,

ULONG Len, INT WaitTime=－1);

参数

DevType

设备类型号。

DevIndex

设备索引号，比如当只有一个PCI5121时，索引号为0，有两个时可以为0或1。（注：当为CAN232

时，0表示要打开的是COM1，1表示要打开的是COM2。）

CANIndex

第几路CAN。

pReceive

用来接收的数据帧数组的首指针。

Len

用来接收的数据帧数组的长度。

WaitTime

等待超时时间，以毫秒为单位。

返回值

返回实际读取到的帧数。如果返回值为0xFFFFFFFF，则表示读取数据失败，有错误发生，请调用

VCI_ReadErrInfo函数来获取错误码。

示例

#include "ControlCan.h"

#include

int nDeviceType = 6; // CAN232

int nDeviceInd = 0; // COM1

int nCANInd = 0;

DWORD dwRel;

VCI_CAN_OBJ vco[100];

lRet = VCI_Receive(nDeviceType, nDeviceInd, nCANInd, vco, 100, 400);

2.5. 接口库函数使用方法

首先，把库函数文件都放在工作目录下。库函数文件总共有三个文件：ControlCAN.h、、

和一个文件夹kerneldlls。

2.5.1. VC调用动态库的方法

如：#include “ControlCAN.h”

(2) 在工程的连接器设置中连接到文件。

如：在VC7环境下，在项目属性页里的配置属性→连接器→输入→附加依赖项中添加

2.5.2.

语法:

[Public | Private] Declare Function name Lib "libname" [Alias "aliasname"] [([arglist])] [As type]

Declare 语句的语法包含下面部分：

Public（可选）

用于声明在所有模块中的所有过程都可以使用的函数。

Private（可选）

用于声明只能在包含该声明的模块中使用的函数。

Name（必选）

任何合法的函数名。动态链接库的入口处（entry points）区分大小写。

Libname（必选）

包含所声明的函数动态链接库名或代码资源名。

Alias（可选）

表示将被调用的函数在动态链接库 (DLL) 中还有另外的名称。当外部函数名与某个函数重名时，就

可以使用这个参数。当动态链接库的函数与同一范围内的公用变量、常数或任何其它过程的名称相同

时，也可以使用 Alias。如果该动态链接库函数中的某个字符不符合动态链接库的命名约定时，也可

以使用

Alias。

Aliasname（可选）

动态链接库。如果首字符不是数字符号 (#)，则 aliasname 是动态链接库中该函数入口处的名称。如

果首字符是 (#)，则随后的字符必须指定该函数入口处的顺序号。

Arglist（可选）

代表调用该函数时需要传递参数的变量表。

Type（可选）

Function返回值的数据类型；可以是 Byte、Boolean、Integer、Long、Currency、Single、Double、Decimal

（目前尚不支持）、Date、String（只支持变长）或 Variant，用户定义类型，或对象类型。

arglist 参数的语法如下：

[Optional] [ByVal | ByRef] [ParamArray] varname[( )] [As type]

部分描述：

Optional（可选）

VB调用动态库的方法

通过以下方法进行声明后就可以调用了。

(1) 在扩展名为.CPP的文件中包含ControlCAN.h头文件。

表示参数不是必需的。如果使用该选项，则 arglist 中的后续参数都必需是可选的，而且必须都使用

Optional 关键字声明。如果使用了 ParamArray，则任何参数都不能使用 Optional。

ByVal（可选）

表示该参数按值传递。

ByRef（可选）

表示该参数按地址传递。

例如：

Public Declare Function VCI_OpenDevice Lib "ControlCAN" (ByVal devicetype As Long, ByVal

deviceind As Long, ByVal reserved As Long) As Long

2.6. 接口库函数使用流程

VCI_OpenDevice

VCI_InitCan

VCI_ReadBoardInfo

VCI_ReadErrInfo VCI_ReadCanStatus

VCI_GetReceiveNum VCI_ClearBuffer

VCI_GetReference VCI_SetReference

VCI_StartCAN

VCI_ResetCAN

VCI_Transmit VCI_Receive

VCI_CloseDevice

3. Linux下动态库的使用

3.1. 驱动程序的安装

所有驱动都在Linux 2.4.20-8下测试通过。

3.1.1. USBCAN驱动的安装

把driver目录下的usbcan.o文件拷贝到/lib/modules/(*)/kernel/drivers/usb目录下，就完成了

驱动的安装（其中(*)根据Linux版本的不同而不同，比如Linux版本为2.4.20-8，则此目录的名称也为

“2.4.20-8”，即跟Linux内核版本号相同）。

3.1.2. PCI5121驱动的安装

把driver目录下的pci51xx.o文件拷贝到/lib/modules/(*)/kernel/drivers/char目录下，就完成

了驱动的安装（其中(*)根据Linux版本的不同而不同，比如Linux版本为2.4.20-8，则此目录的名称也

为“2.4.20-8”，即跟Linux内核版本号相同）。

3.2. 动态库的安装

把dll文件夹中的文件和kerneldlls文件夹一起拷贝到/lib目录，然后运行

ldconfig /lib命令，就可以完成动态库的安装。

3.3. 动态库的调用及编译

动态库的调用是非常简单的，只需要把dll文件夹中的controlcan.h文件拷贝到你的当前工程目录

下，然后用#include “controlcan.h”把controlcan.h文件包含到你的源代码文件中，就可以使用动态

库中的函数了。

在用GCC编译的时候只需要添加 –lcontrolcan 选项就可以了，比如：

gcc –lcontrolcan –g –o test test.c