Ecan动态库使用手册版本3.4.docx

沈阳广成科技有限公司

USBCAN

Ecan(ECAN.dll)接口函数库

使用手册

V3.4

沈阳市皇姑区蒲河街109号024

沈阳广成科技有限公司

沈阳市皇姑区蒲河街109号024

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

1.1.接口卡设备类型定义

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

设备名称

设备类型号

USBCAN1

1

USBCAN2

2

1.2.错误码定义

名称

值

描述

ERR_CAN_OVERFLOW

0CAN控制器内部FIFO溢出

ERR_CAN_ERRALARM

0CAN控制器错误报警

ERR_CAN_PASSIVE

0CAN控制器消极错误

ERR_CAN_LOSE

0CAN控制器仲裁丢失

ERR_CAN_BUSERR

0CAN控制器总线错误

ERR_CAN_REG_FULL

0CAN接收寄存器满

ERR_CAN_REC_OVER

0CAN接收寄存器溢出

ERR_CAN_ACTIVE

0CAN控制器主动错误

ERR_DEVICEOPENED

0设备已经打开

ERR_DEVICEOPEN

0打开设备错误

ERR_DEVICENOTOPEN

0设备没有打开

ERR_BUFFEROVERFLOW

0缓冲区溢出

ERR_DEVICENOTEXIST

0此设备不存在

ERR_LOADKERNELDLL

0装载动态库失败

ERR_CMDFAILED

0执行命令失败错误码

ERR_BUFFERCREATE

0内存不足

ERR_CANETE_PORTOPENED

0端口已经被打开

ERR_CANETE_INDEXUSED

0设备索引号已经被占用

沈阳广成科技有限公司

沈阳市皇姑区蒲河街109号024

1.3.接口库函数结构体

1.3.1.CAN_OBJ

描述

CAN_OBJ结构体在Transmit和Receive函数中被用来传送CAN信息帧。

typedefstruct_CAN_OBJ{UINTID;

UINTTimeStamp;

BYTETimeFlag;

BYTERemoteFlag;

BYTEExternFlag;

BYTEDataLen;

BYTEData[8];

BYTEReserved[2];

}CAN_0BJ,*PCAN_OBJ;成员

ID

报文ID。

TimeStamp

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

TimeFlag

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

RemoteFlag

是否是远程帧。

ExternFlag

是否是扩展帧。

DataLen

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

Data

报文的数据。

Reserved

系统保留。

沈阳广成科技有限公司

1.3.2.INIT_CONFIG

描述

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

typedefstruct_INIT_CONFIG{DWORDFilterStart;

DWORDFilterEnd;

UCHARFilter;

DWORDReserved;

UCHARBaud;

UCHARMode;

}INIT_CONFIG,*P_INIT_CONFIG;成员

FilterStart

滤波范围开始id。

FilterEnd

滤波范围结束id。

Reserved

保留。

Filter

滤波使能。

Baud

波特率。

Mode

模式。

备注

Baud几种常见的波特率设置如下：CAN波特率

Baud值

5Kbps

0xOE

10Kbps

0xOD

20Kbps

0x0C

40Kbps