最新iCAN主站函数库及其使用.docVIP

第4章 iCAN主站函数库及其使用 4.1 主站卡类型 可作为 iCAN 网络主站卡的 ZLGCAN系列接口卡类型如下： 设备名称 设备类型号 PCI5121 1 PCI9810 2 USBCAN1 3 USBCAN2 4 PCI9820 5 PCI5110 7 CANlite(CANmini) 8 ISA9620 9 ISA5420 10 PC104-CAN 11 DNP9810 13 PCI9840 14 PC104-CAN2 15 4.2 函数调用错误码 名称 值 描述 ICANOK 0操作正确 ICANERR_FUNCNOTEXIST 0功能码不存在 ICANERR_SRCNOTEXIST 0资源不存在 ICANERR_CMDNOTSUPPORT 0命令不支持 ICANERR_CMDILLEGAL 0x0000004 参数非法 ICANERR_CONNECTNOTEXIST 0连接不存在 ICANERR 0x000000f1 不确定的错误 ICANERR_USING 0x000000f3 资源被占用 ICANERR_SETCAN 0x000000f4 打开设备失败或初始化 CAN 失败 ICANERR_SRVSTARTED 0x000000f5 服务已启动，无法进行此项操作 ICANERR_TIMEOUT 0x000000f6 操作超时 ICANERR_ITEMEXIST 0x000000f7 目标已经存在 4.3 数据结构说明 4.3.1 ROUTECFG 此数据结构用来设置初始化 iCAN 网络所需要的一些必要参数，声明如下： typedef struct _tagRouteCfg { int iCardType;//CAN 接口卡类型 int iCardInd;//CAN 接口卡序号 int iCANInd;//CAN 路数 WORD wCANBaud;//0x311c - 10K,0x041c - 100K,0x001c - 500K WORD wMasterID;//iCAN 网络主站 ID int iMasterCycle;//iCAN 网络主站定时循环参数，范围 1 到 255，单位为 10ms }ROUTECFG; 4.4 iCAN 网络控制函数说明 4.4.1 Mgr_AddRoute 描述 调用此函数添加一个新的 iCAN 网络到 iCAN 系统中。 DWORD __stdcall Mgr_AddRoute(ROUTECFG cfg,HANDLE* phRoute); 参数 cfg 所要添加的 iCAN 网络初始化参数。 phRoute 新 iCAN 网络句柄指针，用以存储返回的新 iCAN 网络句柄。 返回值 正确为 ICANOK，否则为错误码。 4.4.2 Mgr_DelRoute 描述 调用此函数从 iCAN 系统中删除一个 iCAN 网络。 DWORD __stdcall Mgr_DelRoute(HANDLE hRoute); 参数 hRoute 所要删除的 iCAN 网络句柄。 返回值 正确为 ICANOK，否则为错误码。 4.4.3 Mgr_DelAllRoute 描述 调用此函数删除 iCAN系统中所有 iCAN 网络。 DWORD __stdcall Mgr_DelAllRoute(); 参数 无。 返回值 正确为 ICANOK，否则为错误码。 4.4.4 Mgr_StartSys 描述 调用此函数启动 iCAN系统。 DWORD __stdcall Mgr_StartSys(); 参数 无。 返回值 正确为 ICANOK，否则为错误码。 4.4.5 Mgr_StopSys 描述 调用此函数停止 iCAN系统。 DWORD __stdcall Mgr_StopSys(); 参数 无。 返回值 正确为 ICANOK，否则为错误码。 4.4.6 Mgr_IsStarted 描述 调用此函数判断 iCAN 系统是否已经启动。 DWORD __stdcall Mgr_StopSys(); 参数 无。 返回值 已经启动为 1，否则为 0。 4.5 iCAN 网络函数说明 4.5.1 Route_AddSlave 描述 调用此函数往指定 iCAN 网络中添加一个从站。 DWORD __stdcall Route_AddSlave(HANDLE hRoute,DWORD SlaveID,HANDLE* phSlave); 参数 hRoute 指定要添加从站的 iCAN 网络句柄。 SlaveID 要添加的从站 ID。