initial

lib/README.md

@@ -0,0 +1,71 @@
+# 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