xusbcan-cli 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. xusbcan_cli-0.1.1/LICENSE +21 -0
  2. xusbcan_cli-0.1.1/PKG-INFO +325 -0
  3. xusbcan_cli-0.1.1/README.md +304 -0
  4. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/pyproject.toml +51 -42
  5. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/__init__.py +7 -7
  6. xusbcan_cli-0.1.1/src/xusbcan/adapters/__init__.py +4 -0
  7. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/__init__.py +4 -0
  8. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/backend.py +12 -0
  9. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/bus.py +208 -0
  10. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/device_pool.py +80 -0
  11. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/dll.py +172 -0
  12. xusbcan_cli-0.1.1/src/xusbcan/adapters/chuangxin/profiles.py +27 -0
  13. xusbcan_cli-0.1.1/src/xusbcan/adapters/peak/__init__.py +1 -0
  14. xusbcan_cli-0.1.1/src/xusbcan/adapters/peak/profiles.py +14 -0
  15. xusbcan_cli-0.1.1/src/xusbcan/adapters/profile.py +25 -0
  16. xusbcan_cli-0.1.1/src/xusbcan/adapters/registry.py +139 -0
  17. xusbcan_cli-0.1.1/src/xusbcan/adapters/vector/__init__.py +1 -0
  18. xusbcan_cli-0.1.1/src/xusbcan/adapters/vector/profiles.py +17 -0
  19. xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/__init__.py +4 -0
  20. xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/backend.py +31 -0
  21. xusbcan_cli-0.1.0/src/xusbcan/adapters/zlg/backend.py → xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/common.py +33 -57
  22. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/adapters/zlg/dll.py +70 -4
  23. xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/profiles.py +21 -0
  24. xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/usbcan2.py +22 -0
  25. xusbcan_cli-0.1.1/src/xusbcan/adapters/zlg/usbcan_2e_u.py +209 -0
  26. xusbcan_cli-0.1.1/src/xusbcan/cli/app.py +247 -0
  27. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/config/loader.py +43 -5
  28. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/core/__init__.py +6 -1
  29. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/core/commands.py +140 -17
  30. xusbcan_cli-0.1.1/src/xusbcan/core/filters.py +30 -0
  31. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/core/monitor.py +7 -1
  32. xusbcan_cli-0.1.1/src/xusbcan/core/periodic.py +230 -0
  33. xusbcan_cli-0.1.1/src/xusbcan/core/session.py +500 -0
  34. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/mcp/server.py +10 -2
  35. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/mcp/tools.py +47 -2
  36. xusbcan_cli-0.1.1/src/xusbcan/mcp/transport.py +21 -0
  37. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/models/device.py +5 -4
  38. xusbcan_cli-0.1.1/src/xusbcan/scenario/__init__.py +9 -0
  39. xusbcan_cli-0.1.1/src/xusbcan/scenario/loader.py +24 -0
  40. xusbcan_cli-0.1.1/src/xusbcan/scenario/runner.py +945 -0
  41. xusbcan_cli-0.1.1/src/xusbcan_cli.egg-info/PKG-INFO +325 -0
  42. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan_cli.egg-info/SOURCES.txt +32 -1
  43. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan_cli.egg-info/entry_points.txt +1 -0
  44. xusbcan_cli-0.1.1/tests/test_chuangxin_usb_can_2c.py +67 -0
  45. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/tests/test_config.py +47 -0
  46. xusbcan_cli-0.1.1/tests/test_core.py +752 -0
  47. xusbcan_cli-0.1.1/tests/test_dual_session_virtual.py +49 -0
  48. xusbcan_cli-0.1.1/tests/test_error_code_mapping.py +155 -0
  49. xusbcan_cli-0.1.1/tests/test_filters.py +53 -0
  50. xusbcan_cli-0.1.1/tests/test_registry.py +119 -0
  51. xusbcan_cli-0.1.1/tests/test_scenario.py +166 -0
  52. xusbcan_cli-0.1.1/tests/test_scenario_advanced.py +472 -0
  53. xusbcan_cli-0.1.1/tests/test_scenario_store.py +41 -0
  54. xusbcan_cli-0.1.1/tests/test_scenario_vars.py +67 -0
  55. xusbcan_cli-0.1.1/tests/test_session_capabilities.py +165 -0
  56. xusbcan_cli-0.1.1/tests/test_zlg_usbcan2.py +96 -0
  57. xusbcan_cli-0.1.0/PKG-INFO +0 -152
  58. xusbcan_cli-0.1.0/README.md +0 -138
  59. xusbcan_cli-0.1.0/src/xusbcan/adapters/__init__.py +0 -1
  60. xusbcan_cli-0.1.0/src/xusbcan/adapters/registry.py +0 -88
  61. xusbcan_cli-0.1.0/src/xusbcan/adapters/zlg/__init__.py +0 -23
  62. xusbcan_cli-0.1.0/src/xusbcan/cli/app.py +0 -106
  63. xusbcan_cli-0.1.0/src/xusbcan/core/periodic.py +0 -72
  64. xusbcan_cli-0.1.0/src/xusbcan/core/session.py +0 -282
  65. xusbcan_cli-0.1.0/src/xusbcan_cli.egg-info/PKG-INFO +0 -152
  66. xusbcan_cli-0.1.0/tests/test_core.py +0 -146
  67. xusbcan_cli-0.1.0/tests/test_registry.py +0 -52
  68. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/setup.cfg +0 -0
  69. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/adapters/zlg/device_pool.py +0 -0
  70. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/cli/__init__.py +0 -0
  71. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/cli/__main__.py +0 -0
  72. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/config/__init__.py +0 -0
  73. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/mcp/__init__.py +0 -0
  74. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/models/__init__.py +0 -0
  75. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/models/frame.py +0 -0
  76. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan/models/result.py +0 -0
  77. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan_cli.egg-info/dependency_links.txt +0 -0
  78. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan_cli.egg-info/requires.txt +0 -0
  79. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/src/xusbcan_cli.egg-info/top_level.txt +0 -0
  80. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/tests/test_mcp_smoke.py +0 -0
  81. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/tests/test_mcp_stdio.py +0 -0
  82. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/tests/test_models.py +0 -0
  83. {xusbcan_cli-0.1.0 → xusbcan_cli-0.1.1}/tests/test_result.py +0 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 chaofan
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,325 @@
1
+ Metadata-Version: 2.4
2
+ Name: xusbcan-cli
3
+ Version: 0.1.1
4
+ Summary: 面向 AI Agent 的 CAN 总线调试工具(CLI + MCP)
5
+ Author: Archaofan
6
+ License-Expression: MIT
7
+ Classifier: Programming Language :: Python :: 3
8
+ Classifier: Programming Language :: Python :: 3.11
9
+ Classifier: Programming Language :: Python :: 3.12
10
+ Requires-Python: >=3.11
11
+ Description-Content-Type: text/markdown
12
+ License-File: LICENSE
13
+ Requires-Dist: python-can>=4.4
14
+ Provides-Extra: mcp
15
+ Requires-Dist: mcp>=2.0; extra == "mcp"
16
+ Provides-Extra: dev
17
+ Requires-Dist: pytest; extra == "dev"
18
+ Requires-Dist: ruff; extra == "dev"
19
+ Requires-Dist: mypy; extra == "dev"
20
+ Dynamic: license-file
21
+
22
+ # xusbcan-cli
23
+
24
+ 面向 AI Agent 的多厂商 CAN 总线调试工具。
25
+
26
+ 以后端服务形态运行,同时提供标准 **CLI** 与 **MCP(Model Context Protocol)** 接口,让 AI Agent 能直接完成 CAN 报文的收发、监听、周期发送等调试操作——无需人工操作上位机软件,即可实现 **Agent 自动化联合调试**。
27
+
28
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
29
+ [![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://www.python.org/)
30
+ [![PyPI](https://img.shields.io/pypi/v/xusbcan-cli.svg)](https://pypi.org/project/xusbcan-cli/)
31
+
32
+ 中文 | [English](README.en.md)
33
+
34
+ ## 目标与展望
35
+
36
+ 在 AI 时代,让 Agent 能像使用普通工具一样操作 CAN 总线:结构化输出、稳定契约、可被程序化调用。
37
+
38
+ 我们的**目标**是让 xusbcan-cli 成为 AI 与车载 / 工业 CAN 总线之间的可靠桥梁,使「用 Agent 自动完成台架上的联调、诊断、验证」更常见。本项目以 [python-can](https://github.com/hardbyte/python-can) 为底座,在其上提供统一命令与会话。当前仍是早期版本:先把已确认的厂商与型号跑通,再按型号扩展,而不是宣称已经覆盖所有厂商或成为行业标准。
39
+
40
+ ## 特性
41
+
42
+ - **同一套命令**:CLI / MCP 命令名不随厂商变化;驱动、环境变量与配置随卡变化
43
+ - **CLI 与 MCP 同源**:结构化 JSON 输出,便于 Agent 分支处理
44
+ - **python-can 优先**:已有后端可直接写 `interface`;需要通道映射或专有参数时再登记型号
45
+ - **可安装 Agent Skill**:先确认型号,再调用;厂商踩坑按型号分文件
46
+
47
+ ## 会话层做什么
48
+
49
+ 本项目在 python-can(或自研后端给出的 `can.Bus`)之上提供**统一会话与命令层**,而不是再实现一套总线协议栈。大致包括:
50
+
51
+ - **配置与别名**:`xusbcan.toml` 里用逻辑名引用设备,打开参数集中管理
52
+ - **会话生命周期**:按别名 `open` / `close`,多卡并存;关闭时收回周期任务与有界监听
53
+ - **统一结果契约**:`Result` + `error.code` 枚举,超时收帧等可程序化分支(不必解析人类日志)
54
+ - **常用调试原语**:有界 `monitor`、带时长的周期发送、ID 范围滤波、毫秒级 `scenario` 编排
55
+ - **双入口同源**:同一套 core 同时服务 CLI 与 MCP,避免「脚本一套、Agent 又一套」
56
+ - **应用层预算**:周期发送 / Scenario 的时长与发送次数等限制(非硬件失效保护)
57
+
58
+ 底层怎么打开卡,仍由对应 `interface` 或本仓库登记的后端决定。
59
+
60
+ ### 相对「已经直接用 python-can + AI」的意义
61
+
62
+ 若团队已经让 Agent 写临时 `can.Bus` 脚本调卡,本项目**不替代** python-can,而是补一层**可复用的工具契约**:
63
+
64
+ | 直接 python-can + AI | 使用本项目 |
65
+ |----------------------|------------|
66
+ | 每次由模型拼后端参数与样板代码 | 配置一次,用稳定 CLI / MCP 工具名调用 |
67
+ | 输出形状随提示词变化 | 固定 JSON / `error.code`,便于 Agent 分支 |
68
+ | 会话、周期、监听、编排各自手写 | 会话层与 `scenario` 已提供 |
69
+ | 型号踩坑靠聊天上下文 | Skill 按型号分文件,先确认再调用 |
70
+ | python-can 没有的卡需自写封装 | 本仓库可提供/登记后端(如部分国产卡) |
71
+
72
+ 已经精通 python-can、且只想本机写死脚本时,不必强行迁移。面向 **Agent 联调、多卡别名、MCP 工具化、结构化结果** 时,本项目更省事。安装本项目**不会**拦截或屏蔽 python-can 其它后端。
73
+
74
+ ## 安装
75
+
76
+ ```bash
77
+ pip install xusbcan-cli # CLI + 核心
78
+ pip install xusbcan-cli[mcp] # 追加 MCP
79
+ ```
80
+
81
+ 从源码:
82
+
83
+ ```bash
84
+ git clone https://github.com/Archaofan/xusbcan-cli.git
85
+ cd xusbcan-cli
86
+ pip install -e ".[mcp]"
87
+ ```
88
+
89
+ ## 快速开始
90
+
91
+ 1. 确认手上的**厂商与型号**,安装该卡要求的驱动 / SDK
92
+ 2. 编写 `xusbcan.toml`(或设置 `XUSBCAN_CONFIG`)
93
+ 3. 用别名调用 CLI / MCP
94
+
95
+ ### 通用配置
96
+
97
+ ```toml
98
+ [[devices]]
99
+ name = "bus0"
100
+ interface = "socketcan" # 任意 python-can 已声明的后端名
101
+ channel = "can0"
102
+ nominal = 500000
103
+ # data = 2000000 # 可选,CAN FD 数据段
104
+ ```
105
+
106
+ - Python 3.11+(64 位)
107
+ - `name` 为逻辑别名;命令与 MCP 都用它
108
+ - 写了 `interface` 时按该后端打开;`vendor` / `model` 用于需要快捷映射的型号
109
+ - MCP 默认 stdio;`http` 仅绑定 `127.0.0.1`
110
+
111
+ ### CLI
112
+
113
+ ```bash
114
+ xusbcan list
115
+ xusbcan send bus0 --id 0x123 --data "01 02 03"
116
+ xusbcan receive bus0 --timeout 1
117
+ xusbcan monitor bus0 --duration 5
118
+ xusbcan status bus0
119
+ xusbcan receive bus0 --timeout 1 --from-id 0x100 --to-id 0x1FF
120
+ xusbcan periodic bus0 --name hb --id 0x123 --data "01" --period 0.1 --duration 5
121
+ xusbcan scenario --file steps.json
122
+ xusbcan scenario --dir scenarios/
123
+ ```
124
+
125
+ `periodic` 在本进程发满 `--duration` 后停止。`scenario` 在同进程编排发→等→再发;`--dir` 按文件名批跑。跨多次调用保持会话时用 MCP。
126
+
127
+ ### MCP
128
+
129
+ ```bash
130
+ xusbcan-mcp
131
+ ```
132
+
133
+ Agent 使用 `open_device`、`send_frame`、`receive_frame`、`monitor`、`periodic_start` 等工具。`periodic_start` **必须**带 `duration_s`(上限 300 秒)。更长任务请用本机常驻进程,并明确授权台架环境。
134
+
135
+ 注册时按所用适配器设置对应环境变量与 `XUSBCAN_CONFIG`(见下方各厂商小节)。
136
+
137
+ ## 适配器准备
138
+
139
+ 按厂商阅读对应小节。每家使用**自己的**驱动与环境变量;配置里写明该卡的 `vendor` / `model` 或 `interface`。
140
+
141
+ ### 周立功(ZLG)
142
+
143
+ 适用于已确认的 **USBCAN-2E-U**、**USBCAN-II**。
144
+
145
+ 需要:
146
+
147
+ - 周立功 USB 驱动
148
+ - 二次开发 SDK(`zlgcan.dll` 与同目录 `kerneldlls/`)
149
+ - `ZLG_SDK_DIR` 指向该 SDK 目录
150
+
151
+ 资料:https://manual.zlg.cn/web/#/152?page_id=5332
152
+
153
+ ```bash
154
+ # 当前终端
155
+ set ZLG_SDK_DIR=D:\path\to\zlg-sdk-dir
156
+ ```
157
+
158
+ ```toml
159
+ [[devices]]
160
+ name = "bus0"
161
+ vendor = "zlg"
162
+ model = "USBCAN-2E-U" # 或 "USBCAN-II"
163
+ channel = 1
164
+ nominal = 250000
165
+ ```
166
+
167
+ 滤波与周期发送在两种型号上的路径不同,见 Agent Skill 中对应参考页。
168
+
169
+ ```json
170
+ {
171
+ "mcpServers": {
172
+ "xusbcan": {
173
+ "command": "xusbcan-mcp",
174
+ "env": {
175
+ "ZLG_SDK_DIR": "D:\\path\\to\\zlg-sdk-dir",
176
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
177
+ }
178
+ }
179
+ }
180
+ }
181
+ ```
182
+
183
+ ### Vector
184
+
185
+ 适用于已确认的 **VN1640A**(**VN1630** 已登记,本仓库未做真机确认)。
186
+
187
+ 需要:
188
+
189
+ - Vector 驱动 / XL Driver(从官方渠道取得授权)
190
+ - `channel` 使用与 python-can / XL Driver **相同的全局通道索引**(无逻辑重映射)。硬件 Channel *N* 通常对应索引 `N - 1`,以本机枚举为准
191
+
192
+ 打开时交给 **python-can 已有的 `vector` 后端**。本仓库**不**封装 XL Driver ABI,只提供型号快捷方式(通道数、`app_name=None` 等)以及 CLI / MCP / Skill 的统一用法与真机说明。
193
+
194
+ ```toml
195
+ [[devices]]
196
+ name = "vn0"
197
+ vendor = "vector"
198
+ model = "VN1640A"
199
+ channel = 2
200
+ nominal = 250000
201
+ # data = 2000000 # 该通道支持 CAN FD 时可选
202
+ ```
203
+
204
+ 也可直接写 `interface = "vector"`。
205
+
206
+ ```json
207
+ {
208
+ "mcpServers": {
209
+ "xusbcan": {
210
+ "command": "xusbcan-mcp",
211
+ "env": {
212
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
213
+ }
214
+ }
215
+ }
216
+ }
217
+ ```
218
+
219
+ ### 创芯(Chuangxin)
220
+
221
+ 适用于已确认的 **USB_CAN-2C**(**USB_CAN-2A-GD** 已登记为同后端族,**真机验证暂挂起**,勿标为已确认)。
222
+
223
+ 需要:
224
+
225
+ - 创芯 USB 驱动
226
+ - 与 Python 位数匹配的 `ControlCAN.dll`
227
+ - `CHUANGXIN_SDK_DIR` 指向含该 DLL 的目录(本工具按绝对路径加载)
228
+
229
+ ```bash
230
+ set CHUANGXIN_SDK_DIR=D:\path\to\chuangxin-controlcan-dir
231
+ ```
232
+
233
+ ```toml
234
+ [[devices]]
235
+ name = "cx0"
236
+ vendor = "chuangxin"
237
+ model = "USB_CAN-2C"
238
+ channel = 0
239
+ nominal = 250000
240
+ ```
241
+
242
+ 同一进程中请只加载一份你选用的 `ControlCAN.dll`;若其它软件也依赖各自的同名 DLL,请分目录或分进程使用。
243
+
244
+ ```json
245
+ {
246
+ "mcpServers": {
247
+ "xusbcan": {
248
+ "command": "xusbcan-mcp",
249
+ "env": {
250
+ "CHUANGXIN_SDK_DIR": "D:\\path\\to\\chuangxin-controlcan-dir",
251
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
252
+ }
253
+ }
254
+ }
255
+ }
256
+ ```
257
+
258
+ ### 其它后端(python-can 直通)
259
+
260
+ 以 Vector 等型号为证:**python-can 已有后端 + 本项目会话层** 这条路径已经走通。因此,凡在当前环境中 python-can 已声明且本机能打开的后端(如 socketcan、slcan、Kvaser、`pcan` 等),**大概率**只需配置 `interface` / `channel` / `extra` 即可用同一套 CLI / MCP;**不保证**每张卡都已在本仓库真机确认,驱动安装、通道写法、FD/滤波/无 ACK 等行为仍随后端而异,可能踩坑。
261
+
262
+ 本仓库对 **PEAK PCAN-USB** 另有型号登记(通道映射),状态为「已登记,未在本仓库真机确认」。写了 `interface` 时不会改走别的后端,也不会阻止你继续在别的程序里直接使用 python-can。
263
+
264
+ ## 支持范围
265
+
266
+ | 厂商 | 型号 | 状态 | 说明 |
267
+ |------|------|------|------|
268
+ | 周立功 | USBCAN-2E-U | 真机已确认 | 本仓库 `zlg` 后端;需 `ZLG_SDK_DIR` |
269
+ | 周立功 | USBCAN-II | 真机已确认 | 同上,按型号分发 |
270
+ | Vector | VN1640A | 真机已确认 | python-can `vector`;通道为 XL 全局索引 |
271
+ | Vector | VN1630 | 已登记 | python-can `vector` |
272
+ | 创芯 | USB_CAN-2C | 真机已确认 | 本仓库 ControlCAN 后端;需 `CHUANGXIN_SDK_DIR` |
273
+ | 创芯 | USB_CAN-2A-GD | 已登记(真机验证挂起) | 与 2C 同后端族;验证暂挂起 |
274
+ | PEAK | PCAN-USB | 已登记 | python-can `pcan` |
275
+
276
+ 上表是带登记或真机说明的型号,不是准入白名单。其它 python-can 后端见上文「其它后端(python-can 直通)」:可打开 ≠ 本仓库已逐型号真机确认。python-can 无法打开的卡才需要新后端;若新后端要求用户自备 SDK,请在免责声明中追加该厂商。
277
+
278
+ ### 真机验证说明
279
+
280
+ 「真机已确认」表示:在**已获授权的台架**上,对本仓库公开的 CLI / 核心路径做过有限验证(打开与重开、收发、滤波、多开、`monitor` / `periodic`、`scenario` 等,视该型号当时测试范围而定)。
281
+
282
+ **该说明适用于本仓库标为真机已确认的全部型号**:验证仅覆盖对应测试台架与当时范围,**不构成**对任一厂商产品的性能、兼容性或适销性担保,也不保证每一台设备、每一种子卡 / 主机环境均已覆盖。未覆盖项通常包括主动构造错误帧、长时间 soak、实车网络等。细节与踩坑见 Agent Skill 中该型号参考页。
283
+
284
+ ## Agent Skill
285
+
286
+ ```bash
287
+ npx skills add Archaofan/xusbcan-cli --skill xusbcan
288
+ ```
289
+
290
+ 在项目目录执行可装到当前工程;`-g` 装到用户目录;`-a` 指定客户端(如 `cursor`)。Skill 先读通用契约,再按 `references/catalog.md` 只打开当前配置对应的型号页,避免把全部厂商知识塞进上下文。
291
+
292
+ ## 参与
293
+
294
+ 欢迎报告问题、提交 PR、贡献新的厂商或型号登记。公开约定摘要如下(细节见 [`CLAUDE.md`](CLAUDE.md)、[`skills/xusbcan/`](skills/xusbcan/)、[`third_party/ABI_PROVENANCE.md`](third_party/ABI_PROVENANCE.md)):
295
+
296
+ - **去耦合**:厂商差异只进 `src/xusbcan/adapters/<厂商>/`;`core` / `cli` / `mcp` 不出现厂商概念,只调用 python-can 通用接口(如 `set_filters` / `send_periodic`)。适配器可在后端钩子内使用厂商专有 API。配置里已有 `interface` 即可打开,不必先为每个型号改会话层。
297
+ - **可持续扩展**:python-can 已有后端 → 只加 `profiles.py`(及可选型号快捷方式);没有后端才加自研绑定并注册 `can.interface`。新增卡时改适配层 + Skill 的 `references/catalog.md` 一行 + 一份型号页;**不要**把各型号症状写进 Skill 根 `description`,也**不要**把全部厂商页塞进一次上下文。
298
+ - **Skill 契约**:根页写通用怎么用;型号页顺序为 Quick start → How this backend behaves → Field notes。Field notes 须标明是前人台架/开发中的现场报告,**未必可复现**,不作正式「不支持」清单,也不据此断言整型号缺陷。
299
+ - **真机与公开表述**:通用配置与该型号的驱动 / 环境变量分开写;真机确认前不要标成「已验证」。需用户自备 SDK 的新厂商,在 README 免责声明追加一条商标与交付边界。
300
+ - **合规**:不提交厂商 DLL / SDK 原文、本机绝对路径、客户/ECU 名等;提交前按 `CLAUDE.md` 脱敏清单自检。
301
+
302
+ ## 安全使用
303
+
304
+ - 仅在**已获授权的台架 / 实验室**使用;不要在实车控制网或未授权产线上让 Agent 无人值守发报文
305
+ - 发送与周期发送前确认接线、波特率与 ID;长时任务请设明确时长或改用本机常驻进程
306
+ - MCP 默认本机使用;HTTP 仅 `127.0.0.1`,勿暴露公网
307
+ - **应用层预算(非硬件失效保护)**:MCP / Scenario 周期发送须带时长(上限 300 秒);Scenario 另有墙钟、单步与累计发送次数等限制。周期停止或关闭失败时返回结构化错误并尽量保留可查询任务/会话,便于重试——这不等于硬件失效保护,驱动或硬件异常时仍不能保证一定停止发送
308
+
309
+ ## 免责声明
310
+
311
+ 本项目是独立的第三方工具,与下列厂商及其产品没有关联、赞助、背书或利益关系。厂商名称、产品名称均为其各自权利人的商标。驱动与 SDK 的版权归权利人所有,由使用者从官方渠道自行获取。
312
+
313
+ 本项目按 MIT 提供**自有代码**,不提供任何担保。`python-can` 等依赖与用户自备 SDK 各有其许可,详见 [`third_party/NOTICES`](third_party/NOTICES)。
314
+
315
+ **真机确认仅覆盖上文「真机验证说明」中的台架范围,不构成对任何已确认型号的性能、兼容性或适销性担保。**
316
+
317
+ 每支持一家需要使用者自备 SDK 或专有驱动的厂商,在此追加商标与交付边界说明:
318
+
319
+ - **广州致远电子股份有限公司(周立功 / ZLG)**:经公开二次开发接口对接的型号包括 USBCAN-2E-U、USBCAN-II。"周立功"、"ZLG"、"zlgcan" 等为其商标。本项目不随附其驱动或 `zlgcan.dll`。
320
+ - **Vector Informatik GmbH(Vector)**:经 python-can `vector` 打开的型号包括 VN1640A。"Vector"、"VN1640A"、"XL Driver" 等为其商标。本项目不随附 Vector 驱动、XL Driver、CANoe/CANalyzer 或其它专有软件。
321
+ - **珠海创芯科技有限公司(创芯)**:经本仓库 ControlCAN(`VCI_*`)薄封装打开的型号包括 USB_CAN-2C。"创芯"、"USB_CAN-2C"、"CANalyst" 等为其商标。本项目不随附创芯驱动或 `ControlCAN.dll`。
322
+
323
+ ## License
324
+
325
+ [MIT License](LICENSE)。第三方条款见 [`third_party/NOTICES`](third_party/NOTICES)。各厂商是「自研 ctypes 后端」还是「仅 python-can 快捷方式」,见 [`third_party/ABI_PROVENANCE.md`](third_party/ABI_PROVENANCE.md)。
@@ -0,0 +1,304 @@
1
+ # xusbcan-cli
2
+
3
+ 面向 AI Agent 的多厂商 CAN 总线调试工具。
4
+
5
+ 以后端服务形态运行,同时提供标准 **CLI** 与 **MCP(Model Context Protocol)** 接口,让 AI Agent 能直接完成 CAN 报文的收发、监听、周期发送等调试操作——无需人工操作上位机软件,即可实现 **Agent 自动化联合调试**。
6
+
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
8
+ [![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://www.python.org/)
9
+ [![PyPI](https://img.shields.io/pypi/v/xusbcan-cli.svg)](https://pypi.org/project/xusbcan-cli/)
10
+
11
+ 中文 | [English](README.en.md)
12
+
13
+ ## 目标与展望
14
+
15
+ 在 AI 时代,让 Agent 能像使用普通工具一样操作 CAN 总线:结构化输出、稳定契约、可被程序化调用。
16
+
17
+ 我们的**目标**是让 xusbcan-cli 成为 AI 与车载 / 工业 CAN 总线之间的可靠桥梁,使「用 Agent 自动完成台架上的联调、诊断、验证」更常见。本项目以 [python-can](https://github.com/hardbyte/python-can) 为底座,在其上提供统一命令与会话。当前仍是早期版本:先把已确认的厂商与型号跑通,再按型号扩展,而不是宣称已经覆盖所有厂商或成为行业标准。
18
+
19
+ ## 特性
20
+
21
+ - **同一套命令**:CLI / MCP 命令名不随厂商变化;驱动、环境变量与配置随卡变化
22
+ - **CLI 与 MCP 同源**:结构化 JSON 输出,便于 Agent 分支处理
23
+ - **python-can 优先**:已有后端可直接写 `interface`;需要通道映射或专有参数时再登记型号
24
+ - **可安装 Agent Skill**:先确认型号,再调用;厂商踩坑按型号分文件
25
+
26
+ ## 会话层做什么
27
+
28
+ 本项目在 python-can(或自研后端给出的 `can.Bus`)之上提供**统一会话与命令层**,而不是再实现一套总线协议栈。大致包括:
29
+
30
+ - **配置与别名**:`xusbcan.toml` 里用逻辑名引用设备,打开参数集中管理
31
+ - **会话生命周期**:按别名 `open` / `close`,多卡并存;关闭时收回周期任务与有界监听
32
+ - **统一结果契约**:`Result` + `error.code` 枚举,超时收帧等可程序化分支(不必解析人类日志)
33
+ - **常用调试原语**:有界 `monitor`、带时长的周期发送、ID 范围滤波、毫秒级 `scenario` 编排
34
+ - **双入口同源**:同一套 core 同时服务 CLI 与 MCP,避免「脚本一套、Agent 又一套」
35
+ - **应用层预算**:周期发送 / Scenario 的时长与发送次数等限制(非硬件失效保护)
36
+
37
+ 底层怎么打开卡,仍由对应 `interface` 或本仓库登记的后端决定。
38
+
39
+ ### 相对「已经直接用 python-can + AI」的意义
40
+
41
+ 若团队已经让 Agent 写临时 `can.Bus` 脚本调卡,本项目**不替代** python-can,而是补一层**可复用的工具契约**:
42
+
43
+ | 直接 python-can + AI | 使用本项目 |
44
+ |----------------------|------------|
45
+ | 每次由模型拼后端参数与样板代码 | 配置一次,用稳定 CLI / MCP 工具名调用 |
46
+ | 输出形状随提示词变化 | 固定 JSON / `error.code`,便于 Agent 分支 |
47
+ | 会话、周期、监听、编排各自手写 | 会话层与 `scenario` 已提供 |
48
+ | 型号踩坑靠聊天上下文 | Skill 按型号分文件,先确认再调用 |
49
+ | python-can 没有的卡需自写封装 | 本仓库可提供/登记后端(如部分国产卡) |
50
+
51
+ 已经精通 python-can、且只想本机写死脚本时,不必强行迁移。面向 **Agent 联调、多卡别名、MCP 工具化、结构化结果** 时,本项目更省事。安装本项目**不会**拦截或屏蔽 python-can 其它后端。
52
+
53
+ ## 安装
54
+
55
+ ```bash
56
+ pip install xusbcan-cli # CLI + 核心
57
+ pip install xusbcan-cli[mcp] # 追加 MCP
58
+ ```
59
+
60
+ 从源码:
61
+
62
+ ```bash
63
+ git clone https://github.com/Archaofan/xusbcan-cli.git
64
+ cd xusbcan-cli
65
+ pip install -e ".[mcp]"
66
+ ```
67
+
68
+ ## 快速开始
69
+
70
+ 1. 确认手上的**厂商与型号**,安装该卡要求的驱动 / SDK
71
+ 2. 编写 `xusbcan.toml`(或设置 `XUSBCAN_CONFIG`)
72
+ 3. 用别名调用 CLI / MCP
73
+
74
+ ### 通用配置
75
+
76
+ ```toml
77
+ [[devices]]
78
+ name = "bus0"
79
+ interface = "socketcan" # 任意 python-can 已声明的后端名
80
+ channel = "can0"
81
+ nominal = 500000
82
+ # data = 2000000 # 可选,CAN FD 数据段
83
+ ```
84
+
85
+ - Python 3.11+(64 位)
86
+ - `name` 为逻辑别名;命令与 MCP 都用它
87
+ - 写了 `interface` 时按该后端打开;`vendor` / `model` 用于需要快捷映射的型号
88
+ - MCP 默认 stdio;`http` 仅绑定 `127.0.0.1`
89
+
90
+ ### CLI
91
+
92
+ ```bash
93
+ xusbcan list
94
+ xusbcan send bus0 --id 0x123 --data "01 02 03"
95
+ xusbcan receive bus0 --timeout 1
96
+ xusbcan monitor bus0 --duration 5
97
+ xusbcan status bus0
98
+ xusbcan receive bus0 --timeout 1 --from-id 0x100 --to-id 0x1FF
99
+ xusbcan periodic bus0 --name hb --id 0x123 --data "01" --period 0.1 --duration 5
100
+ xusbcan scenario --file steps.json
101
+ xusbcan scenario --dir scenarios/
102
+ ```
103
+
104
+ `periodic` 在本进程发满 `--duration` 后停止。`scenario` 在同进程编排发→等→再发;`--dir` 按文件名批跑。跨多次调用保持会话时用 MCP。
105
+
106
+ ### MCP
107
+
108
+ ```bash
109
+ xusbcan-mcp
110
+ ```
111
+
112
+ Agent 使用 `open_device`、`send_frame`、`receive_frame`、`monitor`、`periodic_start` 等工具。`periodic_start` **必须**带 `duration_s`(上限 300 秒)。更长任务请用本机常驻进程,并明确授权台架环境。
113
+
114
+ 注册时按所用适配器设置对应环境变量与 `XUSBCAN_CONFIG`(见下方各厂商小节)。
115
+
116
+ ## 适配器准备
117
+
118
+ 按厂商阅读对应小节。每家使用**自己的**驱动与环境变量;配置里写明该卡的 `vendor` / `model` 或 `interface`。
119
+
120
+ ### 周立功(ZLG)
121
+
122
+ 适用于已确认的 **USBCAN-2E-U**、**USBCAN-II**。
123
+
124
+ 需要:
125
+
126
+ - 周立功 USB 驱动
127
+ - 二次开发 SDK(`zlgcan.dll` 与同目录 `kerneldlls/`)
128
+ - `ZLG_SDK_DIR` 指向该 SDK 目录
129
+
130
+ 资料:https://manual.zlg.cn/web/#/152?page_id=5332
131
+
132
+ ```bash
133
+ # 当前终端
134
+ set ZLG_SDK_DIR=D:\path\to\zlg-sdk-dir
135
+ ```
136
+
137
+ ```toml
138
+ [[devices]]
139
+ name = "bus0"
140
+ vendor = "zlg"
141
+ model = "USBCAN-2E-U" # 或 "USBCAN-II"
142
+ channel = 1
143
+ nominal = 250000
144
+ ```
145
+
146
+ 滤波与周期发送在两种型号上的路径不同,见 Agent Skill 中对应参考页。
147
+
148
+ ```json
149
+ {
150
+ "mcpServers": {
151
+ "xusbcan": {
152
+ "command": "xusbcan-mcp",
153
+ "env": {
154
+ "ZLG_SDK_DIR": "D:\\path\\to\\zlg-sdk-dir",
155
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
156
+ }
157
+ }
158
+ }
159
+ }
160
+ ```
161
+
162
+ ### Vector
163
+
164
+ 适用于已确认的 **VN1640A**(**VN1630** 已登记,本仓库未做真机确认)。
165
+
166
+ 需要:
167
+
168
+ - Vector 驱动 / XL Driver(从官方渠道取得授权)
169
+ - `channel` 使用与 python-can / XL Driver **相同的全局通道索引**(无逻辑重映射)。硬件 Channel *N* 通常对应索引 `N - 1`,以本机枚举为准
170
+
171
+ 打开时交给 **python-can 已有的 `vector` 后端**。本仓库**不**封装 XL Driver ABI,只提供型号快捷方式(通道数、`app_name=None` 等)以及 CLI / MCP / Skill 的统一用法与真机说明。
172
+
173
+ ```toml
174
+ [[devices]]
175
+ name = "vn0"
176
+ vendor = "vector"
177
+ model = "VN1640A"
178
+ channel = 2
179
+ nominal = 250000
180
+ # data = 2000000 # 该通道支持 CAN FD 时可选
181
+ ```
182
+
183
+ 也可直接写 `interface = "vector"`。
184
+
185
+ ```json
186
+ {
187
+ "mcpServers": {
188
+ "xusbcan": {
189
+ "command": "xusbcan-mcp",
190
+ "env": {
191
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
192
+ }
193
+ }
194
+ }
195
+ }
196
+ ```
197
+
198
+ ### 创芯(Chuangxin)
199
+
200
+ 适用于已确认的 **USB_CAN-2C**(**USB_CAN-2A-GD** 已登记为同后端族,**真机验证暂挂起**,勿标为已确认)。
201
+
202
+ 需要:
203
+
204
+ - 创芯 USB 驱动
205
+ - 与 Python 位数匹配的 `ControlCAN.dll`
206
+ - `CHUANGXIN_SDK_DIR` 指向含该 DLL 的目录(本工具按绝对路径加载)
207
+
208
+ ```bash
209
+ set CHUANGXIN_SDK_DIR=D:\path\to\chuangxin-controlcan-dir
210
+ ```
211
+
212
+ ```toml
213
+ [[devices]]
214
+ name = "cx0"
215
+ vendor = "chuangxin"
216
+ model = "USB_CAN-2C"
217
+ channel = 0
218
+ nominal = 250000
219
+ ```
220
+
221
+ 同一进程中请只加载一份你选用的 `ControlCAN.dll`;若其它软件也依赖各自的同名 DLL,请分目录或分进程使用。
222
+
223
+ ```json
224
+ {
225
+ "mcpServers": {
226
+ "xusbcan": {
227
+ "command": "xusbcan-mcp",
228
+ "env": {
229
+ "CHUANGXIN_SDK_DIR": "D:\\path\\to\\chuangxin-controlcan-dir",
230
+ "XUSBCAN_CONFIG": "D:\\path\\to\\xusbcan.toml"
231
+ }
232
+ }
233
+ }
234
+ }
235
+ ```
236
+
237
+ ### 其它后端(python-can 直通)
238
+
239
+ 以 Vector 等型号为证:**python-can 已有后端 + 本项目会话层** 这条路径已经走通。因此,凡在当前环境中 python-can 已声明且本机能打开的后端(如 socketcan、slcan、Kvaser、`pcan` 等),**大概率**只需配置 `interface` / `channel` / `extra` 即可用同一套 CLI / MCP;**不保证**每张卡都已在本仓库真机确认,驱动安装、通道写法、FD/滤波/无 ACK 等行为仍随后端而异,可能踩坑。
240
+
241
+ 本仓库对 **PEAK PCAN-USB** 另有型号登记(通道映射),状态为「已登记,未在本仓库真机确认」。写了 `interface` 时不会改走别的后端,也不会阻止你继续在别的程序里直接使用 python-can。
242
+
243
+ ## 支持范围
244
+
245
+ | 厂商 | 型号 | 状态 | 说明 |
246
+ |------|------|------|------|
247
+ | 周立功 | USBCAN-2E-U | 真机已确认 | 本仓库 `zlg` 后端;需 `ZLG_SDK_DIR` |
248
+ | 周立功 | USBCAN-II | 真机已确认 | 同上,按型号分发 |
249
+ | Vector | VN1640A | 真机已确认 | python-can `vector`;通道为 XL 全局索引 |
250
+ | Vector | VN1630 | 已登记 | python-can `vector` |
251
+ | 创芯 | USB_CAN-2C | 真机已确认 | 本仓库 ControlCAN 后端;需 `CHUANGXIN_SDK_DIR` |
252
+ | 创芯 | USB_CAN-2A-GD | 已登记(真机验证挂起) | 与 2C 同后端族;验证暂挂起 |
253
+ | PEAK | PCAN-USB | 已登记 | python-can `pcan` |
254
+
255
+ 上表是带登记或真机说明的型号,不是准入白名单。其它 python-can 后端见上文「其它后端(python-can 直通)」:可打开 ≠ 本仓库已逐型号真机确认。python-can 无法打开的卡才需要新后端;若新后端要求用户自备 SDK,请在免责声明中追加该厂商。
256
+
257
+ ### 真机验证说明
258
+
259
+ 「真机已确认」表示:在**已获授权的台架**上,对本仓库公开的 CLI / 核心路径做过有限验证(打开与重开、收发、滤波、多开、`monitor` / `periodic`、`scenario` 等,视该型号当时测试范围而定)。
260
+
261
+ **该说明适用于本仓库标为真机已确认的全部型号**:验证仅覆盖对应测试台架与当时范围,**不构成**对任一厂商产品的性能、兼容性或适销性担保,也不保证每一台设备、每一种子卡 / 主机环境均已覆盖。未覆盖项通常包括主动构造错误帧、长时间 soak、实车网络等。细节与踩坑见 Agent Skill 中该型号参考页。
262
+
263
+ ## Agent Skill
264
+
265
+ ```bash
266
+ npx skills add Archaofan/xusbcan-cli --skill xusbcan
267
+ ```
268
+
269
+ 在项目目录执行可装到当前工程;`-g` 装到用户目录;`-a` 指定客户端(如 `cursor`)。Skill 先读通用契约,再按 `references/catalog.md` 只打开当前配置对应的型号页,避免把全部厂商知识塞进上下文。
270
+
271
+ ## 参与
272
+
273
+ 欢迎报告问题、提交 PR、贡献新的厂商或型号登记。公开约定摘要如下(细节见 [`CLAUDE.md`](CLAUDE.md)、[`skills/xusbcan/`](skills/xusbcan/)、[`third_party/ABI_PROVENANCE.md`](third_party/ABI_PROVENANCE.md)):
274
+
275
+ - **去耦合**:厂商差异只进 `src/xusbcan/adapters/<厂商>/`;`core` / `cli` / `mcp` 不出现厂商概念,只调用 python-can 通用接口(如 `set_filters` / `send_periodic`)。适配器可在后端钩子内使用厂商专有 API。配置里已有 `interface` 即可打开,不必先为每个型号改会话层。
276
+ - **可持续扩展**:python-can 已有后端 → 只加 `profiles.py`(及可选型号快捷方式);没有后端才加自研绑定并注册 `can.interface`。新增卡时改适配层 + Skill 的 `references/catalog.md` 一行 + 一份型号页;**不要**把各型号症状写进 Skill 根 `description`,也**不要**把全部厂商页塞进一次上下文。
277
+ - **Skill 契约**:根页写通用怎么用;型号页顺序为 Quick start → How this backend behaves → Field notes。Field notes 须标明是前人台架/开发中的现场报告,**未必可复现**,不作正式「不支持」清单,也不据此断言整型号缺陷。
278
+ - **真机与公开表述**:通用配置与该型号的驱动 / 环境变量分开写;真机确认前不要标成「已验证」。需用户自备 SDK 的新厂商,在 README 免责声明追加一条商标与交付边界。
279
+ - **合规**:不提交厂商 DLL / SDK 原文、本机绝对路径、客户/ECU 名等;提交前按 `CLAUDE.md` 脱敏清单自检。
280
+
281
+ ## 安全使用
282
+
283
+ - 仅在**已获授权的台架 / 实验室**使用;不要在实车控制网或未授权产线上让 Agent 无人值守发报文
284
+ - 发送与周期发送前确认接线、波特率与 ID;长时任务请设明确时长或改用本机常驻进程
285
+ - MCP 默认本机使用;HTTP 仅 `127.0.0.1`,勿暴露公网
286
+ - **应用层预算(非硬件失效保护)**:MCP / Scenario 周期发送须带时长(上限 300 秒);Scenario 另有墙钟、单步与累计发送次数等限制。周期停止或关闭失败时返回结构化错误并尽量保留可查询任务/会话,便于重试——这不等于硬件失效保护,驱动或硬件异常时仍不能保证一定停止发送
287
+
288
+ ## 免责声明
289
+
290
+ 本项目是独立的第三方工具,与下列厂商及其产品没有关联、赞助、背书或利益关系。厂商名称、产品名称均为其各自权利人的商标。驱动与 SDK 的版权归权利人所有,由使用者从官方渠道自行获取。
291
+
292
+ 本项目按 MIT 提供**自有代码**,不提供任何担保。`python-can` 等依赖与用户自备 SDK 各有其许可,详见 [`third_party/NOTICES`](third_party/NOTICES)。
293
+
294
+ **真机确认仅覆盖上文「真机验证说明」中的台架范围,不构成对任何已确认型号的性能、兼容性或适销性担保。**
295
+
296
+ 每支持一家需要使用者自备 SDK 或专有驱动的厂商,在此追加商标与交付边界说明:
297
+
298
+ - **广州致远电子股份有限公司(周立功 / ZLG)**:经公开二次开发接口对接的型号包括 USBCAN-2E-U、USBCAN-II。"周立功"、"ZLG"、"zlgcan" 等为其商标。本项目不随附其驱动或 `zlgcan.dll`。
299
+ - **Vector Informatik GmbH(Vector)**:经 python-can `vector` 打开的型号包括 VN1640A。"Vector"、"VN1640A"、"XL Driver" 等为其商标。本项目不随附 Vector 驱动、XL Driver、CANoe/CANalyzer 或其它专有软件。
300
+ - **珠海创芯科技有限公司(创芯)**:经本仓库 ControlCAN(`VCI_*`)薄封装打开的型号包括 USB_CAN-2C。"创芯"、"USB_CAN-2C"、"CANalyst" 等为其商标。本项目不随附创芯驱动或 `ControlCAN.dll`。
301
+
302
+ ## License
303
+
304
+ [MIT License](LICENSE)。第三方条款见 [`third_party/NOTICES`](third_party/NOTICES)。各厂商是「自研 ctypes 后端」还是「仅 python-can 快捷方式」,见 [`third_party/ABI_PROVENANCE.md`](third_party/ABI_PROVENANCE.md)。