PCAN 兼容层ControlCAN_PCAN使用说明文档版本v1.0适用文件ControlCAN.dll兼容层PCANBasic.dllPEAK 官方 API32 位适用硬件PEAK-System PCAN 系列经典 CAN 卡 / USB 适配器PCAN-USB 等1. 产品简介本兼容层是一个原生 DLLControlCAN.dll完整复刻周立功ZLGControlCAN.dll的VCI 接口24 个VCI_*导出函数名称、参数、调用约定、导出序号均一致底层通过 PEAK 官方PCANBasic.dll驱动 PCAN 硬件。效果所有认 VCI 接口的工具与程序无需任何代码改动即可直接使用 PCAN 设备。2. 适用场景场景说明周立功 CANTest 测试工具用 CANTest 直接调试 PCAN 硬件报文收发、时间戳、帧格式查看既有 VCI 二次开发项目基于VCI_OpenDevice / StartCAN / Transmit / Receive等 API 的应用增配或切换 PCAN 硬件业务代码零修改国产工具链兼容ZLG / 广成GCAN/ 晨兴CX等 VCI 生态无缝接入 PEAK 生态3. 文件与运行环境3.1 文件清单共 2 个文件说明SHA-256ControlCAN.dll本兼容层32 位仅依赖系统自带 KERNEL32/msvcrt零额外运行库1208B6C1D5CC982BA3586B3F7AB371BDF32118E18AD94EDF49882004EEFB0167PCANBasic.dllPEAK 官方 API32 位v5.0.1.1131版权归 PEAK-System按其许可条款使用与分发F9207F2826F9864B3A798E5954181002ABEA6474741FD8B0AB958AE8CC34EBC164 位工具请另行获取 x64 版本并配套 64 位PCANBasic.dll二者位宽必须一致。3.2 运行环境Windows32/64 位系统均可运行 32 位程序已安装PEAK USB 驱动PEAK-Drivers 5 及以上PCAN 硬件已连接设备管理器可见4. 工作原理简述接口面完整导出真 ZLGControlCAN.dll的 24 个VCI_*函数14 个核心 10 个扩展含设备枚举/连接/复位等__stdcall调用约定导出序号与官方一致按名称或序号导入均可。驱动加载运行时动态加载PCANBasic.dll查找顺序为同目录 → 系统目录/PATH → PEAK 安装目录缺失时优雅失败VCI_OpenDevice返回 0程序不会崩溃。接收语义每通道内部 FIFO 后台读线程与 VCI 语义完全对齐——VCI_GetReceiveNum只计数不消费、VCI_Receive支持 WaitTime 阻塞、VCI_ClearBuffer排空。通道映射VCI 设备索引DevInd→PCAN_USBBUS(DevInd1)索引 0 USBBUS1。波特率支持 VCI 标准波特率码与 SJA1000 定时寄存器Timing0/1两种设置方式映射到 PCAN 波特率1M ~ 5K默认 500K。5. 使用流程以 CANTest 为例安装驱动安装 PEAK USB 驱动并连接 PCAN 硬件。退出 CANTest完全退出正在运行的 CANTest运行中的实例加载的是旧 DLL替换文件后必须重启否则不生效。备份原件备份 CANTest 安装目录下的原ControlCAN.dll。复制文件将ControlCAN.dll、PCANBasic.dll两个文件复制到 CANTest 安装目录。启动连接启动 CANTest → 设备类型选USBCAN1、设备索引0、波特率选250K / 500K→ 打开设备。收发报文即可收发标准帧/扩展帧/远程帧查看时间戳。6. 二次开发项目接入C#P/Invoke声明与 ZLG 完全相同的VCI_*函数签名DllImport 指向ControlCAN.dll调用VCI_OpenDevice → VCI_InitCAN → VCI_StartCAN → VCI_Transmit / VCI_Receive → VCI_CloseDevice。C/CGetProcAddress动态调用或链接官方导入库。部署ControlCAN.dll与PCANBasic.dll需同时存在于程序目录或系统可找到PCANBasic.dll位宽必须一致。7. 限制与注意事项仅经典 CAN不支持 CAN FDFD 通道为另一套接口不在本版本范围。单通道独占PCAN 每端口对应一个通道同一通道同一时刻仅允许一个程序占用被占用时VCI_OpenDevice返回 0。波特率基于标准映射表任意自定义 Timing 组合非标准波特率不支持。驱动依赖未安装 PEAK 驱动时无法打开设备程序应给出明确提示。免责声明本软件为独立开发的兼容实现与周立功ZLG、PEAK-System 无任何隶属或授权关系PCANBasic.dll版权归 PEAK-System请按其许可条款使用与分发。8. 常见问题FAQ现象原因与处理CANTest 无法启动 / 闪退确认使用的是 32 位ControlCAN.dll目标机需有 VC 运行库本版本已静态链接正常情况下无此依赖能启动但打不开设备确认已装 PEAK 驱动、硬件已连接、PCANBasic.dll与ControlCAN.dll同目录完全退出 CANTest 后重试提示设备被占用PcanView 等其他程序正在占用该通道关闭后重试需要换通道设备索引DevInd选择0 → USBBUS11 → USBBUS2……或使用可选配置ControlCAN_PCAN.ini[Channel] IndexN全局指定文件下载路径亲测可用https://download.csdn.net/download/qq_26351861/93309649
)
