# CAN 协议库文件目录

本目录用于存放 USB-CAN 接口函数库相关文件。

## 应包含的文件

### 必需文件
- `ControlCAN.dll` - USB-CAN 接口主库文件
- `ControlCAN.lib` - 静态链接库（用于 C/C++ 链接）

### 可选头文件和声明
- `ControlCAN.h` - C/C++ 头文件
- `ControlCAN.bas` - VB 函数声明文件
- `ControlCAN.pas` - Delphi 函数声明文件
- `ControlCAN.llb` - LabVIEW 模块

## 支持的设备

- USBCAN-2A
- USBCAN-2C
- CANalyst-II
- MiniPCIe-CAN

## 版本信息

- **接口库版本：** v2.10
- **更新日期：** 2023.12.14
- **兼容性：** ZLG（周立功）函数库兼容

## 使用说明

1. 将 `ControlCAN.dll` 放置在以下位置之一：
   - 与可执行文件同目录
   - 系统 PATH 环境变量包含的目录
   - Windows\System32 目录（不推荐）

2. 在 C/C++ 项目中：
   ```c
   #include "ControlCAN.h"
   #pragma comment(lib, "ControlCAN.lib")
   ```

3. 在 Python 项目中：
   ```python
   import ctypes
   can_dll = ctypes.WinDLL('./lib/ControlCAN.dll')
   ```

## 注意事项

⚠️ **请勿将 DLL 文件提交到版本控制系统**

- 这些是第三方二进制文件，应从官方源获取
- 建议在 `.gitignore` 中忽略 `*.dll` 和 `*.lib` 文件

## 获取方式

请从以下途径获取原始库文件：
1. USB-CAN 设备官方驱动光盘
2. 厂商官网下载（珠海创芯科技有限公司）
3. 技术支持邮箱：zhcxgd@163.com

## 参考文档

完整的 API 文档请参阅：
- `.claude/skills/can-protocol.md` - CAN 协议接口函数库参考手册（中文）
- `docs/protocol/CAN_Protocol.pdf` - 官方使用说明书

---

**最后更新：** 2025-11-14