python-can-canpal 0.1.0rc1__tar.gz

python_can_canpal-0.1.0rc1/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Python CANPAL contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This license applies to the newly developed PythonCAN plugin, test harness,
+and documentation. The separately supplied CANPAL SDK, its headers, firmware,
+Qt, and other third-party components retain their respective licenses.

python_can_canpal-0.1.0rc1/MANIFEST.in

@@ -0,0 +1,10 @@
+include LICENSE README.md pyproject.toml
+include docs/INSTALL.md docs/TESTING.md docs/RELEASE.md docs/hardware-lab.example.json
+recursive-include native/fake *.cpp *.pro
+include native/sdk-revision.txt
+include tools/sdk_source.py tools/build_fake.py tools/build_sdk.py tools/inspect_devices.py tools/release_check.py
+recursive-include tests *.py
+prune build
+prune dist
+prune artifacts
+exclude PLAN.zh-CN.md

python_can_canpal-0.1.0rc1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: python-can-canpal
+Version: 0.1.0rc1
+Summary: CANPAL USB and TCP backend for python-can
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-can==4.6.1
+Requires-Dist: pyserial==3.5
+Provides-Extra: test
+Requires-Dist: pytest<10,>=8; extra == "test"
+Requires-Dist: build<2,>=1; extra == "test"
+Requires-Dist: twine<8,>=6; extra == "test"
+Dynamic: license-file
+
+# python-can-canpal
+
+CANPAL USB and TCP client backend for [python-can](https://python-can.readthedocs.io/).
+
+**0.1.0rc1 is an experimental preview. Full hardware release acceptance is incomplete.**
+Use it for evaluation on an isolated test bench. It is not the qualified 0.1.0 release.
+
+## Install
+
+Requires Python 3.12, python-can 4.6.1, pySerial 3.5, and a separately supplied
+64-bit CANPAL native SDK with the fixes described below.
+
+```text
+python -m pip install python-can-canpal==0.1.0rc1
+```
+
+The Python package does **not** include the CANPAL SDK, firmware, device drivers,
+Qt/MinGW runtime, or fake binaries. Obtain compatible native components from your
+CANPAL supplier before attempting hardware access. The MIT license applies to
+the new Python plugin, tests and documentation; native components have separate licenses.
+
+## What has been verified
+
+| Environment | Preview evidence |
+| --- | --- |
+| Windows 11 x64 | X5 classic CAN/RTR and X6 classic CAN/RTR/ISO FD over USB and explicit-IP WLAN TCP |
+| Windows, multiple devices | Short concurrent checks: two USB devices, X5 USB + X6 WLAN, X5 WLAN + X6 USB |
+| Ubuntu 24.04 x86_64 in Hyper-V | Software, ABI and real SDK regressions; X5/X6 hardware checks through temporary SSH TCP forwarding via a Windows WLAN connection |
+
+Both devices had CAN1 wired to their own CAN2 on separate physical buses.
+These checks do not use an independent reference CAN interface. Classic checks
+covered standard/extended frames and RTR DLC 0–8 in both directions. X6 FD checks
+covered lengths 0–64 and BRS off/on. The post-fix checks verified 5,280 frames in total.
+
+**Not yet qualified:** independent-reference CAN/CAN FD interoperability, native
+Linux USB or direct Linux WLAN, two simultaneous WLAN devices, controlled physical
+port renumbering/disconnection, rated-load/endurance runs, and native resource
+stability. Fake tests cover additional error paths but do not establish those hardware claims.
+Formal 0.1.0 retains the complete release acceptance requirements.
+
+## Native SDK and firmware requirements
+
+The tested SDK source revision is `e222ccf48f29c530fd09617df6e3a83a8095d25f`.
+It includes command ACK matching, cooperative worker shutdown and a Qt serial
+buffered-read fix. Matching exported function names alone does not establish compatibility.
+
+Classic RTR also requires firmware that preserves the received DLC. The original
+X5 firmware reporting `0x0332` and X6 firmware reporting `0x0127` cleared RTR DLC
+to zero. Supplier-signed diagnostic builds fixed this on the two test devices.
+Those builds still report the same version numbers: ask your supplier to identify
+the actual fixed build. The plugin cannot recover DLC that firmware has discarded.
+
+Set `CANPAL_LIBRARY` to the absolute DLL/SO path, or pass `library_path`.
+On Windows, `CANPAL_DEPENDENCY_DIRS` may list Qt/MinGW runtime directories,
+separated by semicolons. On Linux, install the matching Qt 5 runtime and grant
+serial-port access through udev or the dialout group.
+
+## Connect by UID or IP
+
+```python
+import can
+
+with can.Bus(interface="canpal", ignore_config=True,
+             transport="usb", device_id="YOUR_24_HEX_DIGIT_UID",
+             channel=0, bitrate=500_000) as bus:
+    message = bus.recv(timeout=1)
+```
+
+The device UID remains the selector when a COM/ttyACM number changes. After a
+reconnection, close and recreate the Bus using the same UID; automatic reconnect
+is not implemented. Physical port renumbering acceptance is still pending.
+
+Use `transport="wlan", host="192.0.2.10", port=8000` for TCP direct connection.
+The IP and port must match the actual device; no network discovery is attempted.
+Keep `device_id` to verify identity at that endpoint. X6 CAN FD additionally uses
+`fd=True, data_bitrate=2_000_000`.
+
+Different physical devices use independent Bus objects. A device can have one
+Bus and one selected CAN channel at a time. Use one Notifier per device for
+independent fault handling. UDP, server mode, transmit echo and concurrent
+channels on one device are not implemented.
+
+A successful `send()` means the native queue accepted the frame, not that the
+CAN bus acknowledged it. Use a single receiver per Bus, stop its Notifier before
+shutdown, and handle python-can exceptions. Timestamp alignment is approximate
+per device and does not provide precise synchronization between devices.
+
+The source distribution includes Chinese installation, testing and release notes.

python_can_canpal-0.1.0rc1/README.md

@@ -0,0 +1,88 @@
+# python-can-canpal
+
+CANPAL USB and TCP client backend for [python-can](https://python-can.readthedocs.io/).
+
+**0.1.0rc1 is an experimental preview. Full hardware release acceptance is incomplete.**
+Use it for evaluation on an isolated test bench. It is not the qualified 0.1.0 release.
+
+## Install
+
+Requires Python 3.12, python-can 4.6.1, pySerial 3.5, and a separately supplied
+64-bit CANPAL native SDK with the fixes described below.
+
+```text
+python -m pip install python-can-canpal==0.1.0rc1
+```
+
+The Python package does **not** include the CANPAL SDK, firmware, device drivers,
+Qt/MinGW runtime, or fake binaries. Obtain compatible native components from your
+CANPAL supplier before attempting hardware access. The MIT license applies to
+the new Python plugin, tests and documentation; native components have separate licenses.
+
+## What has been verified
+
+| Environment | Preview evidence |
+| --- | --- |
+| Windows 11 x64 | X5 classic CAN/RTR and X6 classic CAN/RTR/ISO FD over USB and explicit-IP WLAN TCP |
+| Windows, multiple devices | Short concurrent checks: two USB devices, X5 USB + X6 WLAN, X5 WLAN + X6 USB |
+| Ubuntu 24.04 x86_64 in Hyper-V | Software, ABI and real SDK regressions; X5/X6 hardware checks through temporary SSH TCP forwarding via a Windows WLAN connection |
+
+Both devices had CAN1 wired to their own CAN2 on separate physical buses.
+These checks do not use an independent reference CAN interface. Classic checks
+covered standard/extended frames and RTR DLC 0–8 in both directions. X6 FD checks
+covered lengths 0–64 and BRS off/on. The post-fix checks verified 5,280 frames in total.
+
+**Not yet qualified:** independent-reference CAN/CAN FD interoperability, native
+Linux USB or direct Linux WLAN, two simultaneous WLAN devices, controlled physical
+port renumbering/disconnection, rated-load/endurance runs, and native resource
+stability. Fake tests cover additional error paths but do not establish those hardware claims.
+Formal 0.1.0 retains the complete release acceptance requirements.
+
+## Native SDK and firmware requirements
+
+The tested SDK source revision is `e222ccf48f29c530fd09617df6e3a83a8095d25f`.
+It includes command ACK matching, cooperative worker shutdown and a Qt serial
+buffered-read fix. Matching exported function names alone does not establish compatibility.
+
+Classic RTR also requires firmware that preserves the received DLC. The original
+X5 firmware reporting `0x0332` and X6 firmware reporting `0x0127` cleared RTR DLC
+to zero. Supplier-signed diagnostic builds fixed this on the two test devices.
+Those builds still report the same version numbers: ask your supplier to identify
+the actual fixed build. The plugin cannot recover DLC that firmware has discarded.
+
+Set `CANPAL_LIBRARY` to the absolute DLL/SO path, or pass `library_path`.
+On Windows, `CANPAL_DEPENDENCY_DIRS` may list Qt/MinGW runtime directories,
+separated by semicolons. On Linux, install the matching Qt 5 runtime and grant
+serial-port access through udev or the dialout group.
+
+## Connect by UID or IP
+
+```python
+import can
+
+with can.Bus(interface="canpal", ignore_config=True,
+             transport="usb", device_id="YOUR_24_HEX_DIGIT_UID",
+             channel=0, bitrate=500_000) as bus:
+    message = bus.recv(timeout=1)
+```
+
+The device UID remains the selector when a COM/ttyACM number changes. After a
+reconnection, close and recreate the Bus using the same UID; automatic reconnect
+is not implemented. Physical port renumbering acceptance is still pending.
+
+Use `transport="wlan", host="192.0.2.10", port=8000` for TCP direct connection.
+The IP and port must match the actual device; no network discovery is attempted.
+Keep `device_id` to verify identity at that endpoint. X6 CAN FD additionally uses
+`fd=True, data_bitrate=2_000_000`.
+
+Different physical devices use independent Bus objects. A device can have one
+Bus and one selected CAN channel at a time. Use one Notifier per device for
+independent fault handling. UDP, server mode, transmit echo and concurrent
+channels on one device are not implemented.
+
+A successful `send()` means the native queue accepted the frame, not that the
+CAN bus acknowledged it. Use a single receiver per Bus, stop its Notifier before
+shutdown, and handle python-can exceptions. Timestamp alignment is approximate
+per device and does not provide precise synchronization between devices.
+
+The source distribution includes Chinese installation, testing and release notes.

python_can_canpal-0.1.0rc1/docs/INSTALL.md

@@ -0,0 +1,101 @@
+# 安装与连接
+
+当前 0.1.0rc1 为实验性预览版。正式发布资格以 RELEASE.md 和验收报告为准，构建成功不表示硬件验收完成。
+
+## 环境
+
+首版目标是 Python 3.12、Windows 11 x64 和 Ubuntu 24.04 x86_64。
+python-can 固定 4.6.1，pySerial 固定 3.5。WSL 可用于开发，但不能代替原生 Linux 硬件验收。
+
+安装 Python 包后，还需要单独安装兼容的 CANPAL 原生 SDK、设备驱动和 Qt/编译器运行库。
+开发基线为 SDK 提交 e222ccf48f29c530fd09617df6e3a83a8095d25f，包含命令 ACK 匹配、协作退出及 Qt 串口已缓冲数据读取修复。
+旧版 SDK 仅凭导出函数相同不能认定兼容；应使用供应方提供并经过本插件验收的修复版本。
+原生 SDK、固件和第三方库不包含在 PyPI 包内，也不适用本插件的 MIT 许可证。
+
+RTR 接收还需要设备固件保留远程帧 DLC 的修复。已发现的原 X5 0x0332、X6 0x0127
+会把收到的 RTR DLC 清零；插件不能从接收记录中恢复丢失的值。两台测试设备已刷入
+修复构建，并通过 USB/WLAN 双向 RTR DLC 0–8 检查。诊断构建仍报告原版本号，
+因此只比较 SWVer 不足以判断已修复；应向设备供应方确认具体固件构建包含该修复。
+
+
+```text
+python -m pip install python-can-canpal==0.1.0rc1
+```
+
+实际支持范围与未验收项见包首页 README。开发时从源码执行：
+
+```text
+python -m pip install -e ".[test]"
+```
+
+Windows 设置 CANPAL_LIBRARY 为 DLL 绝对路径；若依赖不在 DLL 同目录，
+可设置 CANPAL_DEPENDENCY_DIRS，多个目录使用分号分隔。
+Linux 设置 CANPAL_LIBRARY 为 SO 绝对路径，通过系统链接器安装 Qt 依赖。
+也可在 can.Bus 中传 library_path。导入模块不会加载库或打开设备。
+
+Linux 串口为 /dev/ttyACM数字；通过 udev 或 dialout 组授予当前用户权限，正常运行不要求 root。
+首版不接受任意 ttyUSB 路径。WSL 下调用 Windows python.exe 仍属于 Windows 测试。
+
+## USB 与 UID
+
+```python
+import can
+
+bus = can.Bus(interface="canpal", ignore_config=True,
+              transport="usb", device_id="0123456789abcdef01234567",
+              channel=0, bitrate=500_000)
+try:
+    print(bus.recv(1))
+finally:
+    bus.shutdown()
+```
+
+UID 为实际设备的 12 字节标识，用 24 位十六进制表示。不要把 USB 描述符序列号直接当 UID。
+插件先枚举 CANPAL VID/PID 端口，再读取原生设备身份；不会发送网络广播。
+端口改号后关闭并重新创建 Bus，仍使用相同 UID。
+
+可以同时提供 usb_port="COM9" 作为优先探测提示。
+有 UID 时旧端口不匹配会继续寻找其他候选；仅传 usb_port 则不保证拔插后的设备身份。
+COM1000 等完整编号会被解析，不截取末三位。
+
+## WLAN
+
+```python
+bus = can.Bus(interface="canpal", ignore_config=True,
+              transport="wlan", host="192.0.2.10", port=8000,
+              channel=0, bitrate=500_000,
+              device_id="0123456789abcdef01234567")
+```
+
+IP 与端口必须来自设备实际配置。只支持 PC 为 TCP 客户端、设备为 TCP 服务端的模式。
+可不传 device_id，但仍会读取真实 UID 并检查本进程是否已经占用。
+IP 直连完全不依赖 UDP/广播发现；无自动重连、监听或 UDP 回退。
+
+## 多设备和 CAN FD
+
+为每台不同 UID 设备创建一个 Bus。每台只能选择一个 CAN 通道。
+不同设备可使用相同 channel=0 和相同 CAN ID；应用应在监听器或日志中带上来源 UID。
+每台使用独立 Notifier，避免应用自己把多台设备合并成共享故障处理单元。
+
+X6 开启 FD 时提供 fd=True、data_bitrate=2_000_000。
+fd=False 时仍使用 X6 的原生 FD API承载经典帧。
+完整位时序取自 SDK 的 80/100 MHz 表，由型号和固件版本选择；不支持的速率明确拒绝。
+FD 的非标准物理长度（如 9 字节）会补零到下一合法长度（12），不修改调用者的 Message。
+
+同一个 Bus 只使用一个接收者：直接 recv 或一个 Notifier。
+需要多个消费者时在该 Notifier 上增加监听器，不要并发调用 recv。
+
+## 行为与排错
+
+- send 成功表示原生队列接受，不表示线缆 ACK 或对端收到；Python 不自动重发。
+- send 的 timeout 只约束进入原生调用之前的本地等待；不能取消在途 DLL 调用。
+- recv(None) 等待至收到消息、关闭或离线；软件过滤使用 python-can 基类。
+- 收发时的故障转换为标准 python-can 异常。关闭应用前先停止 Notifier。
+- 设备配置会临时关闭硬件过滤、自动发送、桥接和 spy 功能；不调用保存设置，不写非易失存储。
+- termination=None 保留读取到的终端电阻；True/False 显式设置，listen_only=True 禁止发送。
+- 周期发送使用上游实现，停止后睡眠线程可能在当前周期结束时才退出；关闭后不会再次进入原生发送。
+- 时间戳是每设备初始化采样后的相对换算，含连接采样误差，不提供多设备精确时间同步。
+- 配置失败后关闭本次连接；不在不确定的命令流上继续发送配置或回滚命令。
+- “找不到库”检查绝对路径、64 位架构和 Qt/运行库依赖；禁止用 fake 库处理真实设备。
+- “未找到或不可访问”检查 UID、串口权限、其他进程占用和实际 USB 型号。
+- 本进程 UID 去重不能协调其他应用；同一物理设备应由一个应用独占。

python_can_canpal-0.1.0rc1/docs/RELEASE.md

@@ -0,0 +1,39 @@
+# PyPI 发布流程
+
+用户已指定公开 PyPI，包名 python-can-canpal，新插件代码使用 MIT。
+原生 SDK、头文件、固件与 Qt 不纳入 Python 发布包；其许可独立。
+
+用户已批准先公开发布明确限界的 0.1.0rc1 预览版。版本号本身不代表上传成功或正式验收完成。
+正式 0.1.0 必须完成既定双平台硬件矩阵；没有硬件证据时停止在候选产物阶段。
+
+1. 完成 Windows/Python 3.12 和 Linux/Python 3.12 无硬件回归、三方 ABI、真实 SDK 回归。
+2. 在 Windows 11 x64 与原生 Ubuntu 24.04 x86_64 运行完整硬件 release profile。
+3. 核对 26 组验收、资源计数、实际设备能力、失败记录及支持矩阵。未运行、skip、xfail 均未完成。
+4. 冻结最终代码、SDK 构建哈希、包版本；清洁环境从 sdist 重建 wheel 并安装验证。
+5. 运行 python -m twine check dist/*，审计包内文件，不包含 fake 二进制、私有端点、凭据或 SDK。
+6. 用 tools/release_check.py 检查最终产物和全部证据。任何缺项返回非零。
+7. 通过已有 PyPI 账号的安全凭据或可信发布完成上传；不要把 token 写进源码、日志或聊天。
+8. 从 PyPI JSON 核对版本和 SHA256，并在干净环境从 PyPI 安装该精确版本验证入口和依赖。
+
+发布授权已经给出，不再额外要求一次重复批准。凭据或硬件信息缺失时需要用户补充；
+未通过验收不能将候选包上传后称为正式完成。
+新建公网仓库、上传原生 SDK 或更改 SDK 许可不包含在此发布动作中。
+
+环境及原始报告位于本地 artifacts，默认不随 PyPI 包发布。内部 release-evidence.json
+必须列出最终产物 SHA256、四份无跳过的测试报告（两平台 unit/hardware）、两平台 SDK 回归，
+以及 26 项验收的证据文件。模板允许完整保留 pending 状态。
+
+## 0.1.0rc1 预览版例外
+
+本次例外来自用户明确选择“先发布明确限界的预览版 0.1.0rc1”。
+只允许该预发布版本：README/PyPI 必须列出已验证平台/组合、未验收项目及修复版 SDK/固件要求。
+两平台软件、ABI、真实 SDK 回归和干净安装必须通过；两台刷写后的 12 组补充实机报告必须通过且哈希匹配。
+包内禁止分发原生库、固件、凭据和内部验收资料。正式版检查器默认行为保持完整门槛。
+
+```text
+python tools/release_check.py --profile preview --evidence artifacts/release-evidence.json --dist dist
+```
+
+预览版检查只对本次明确授权的 0.1.0rc1 生效；不将未运行的正式硬件测试标为通过。
+上传后须核对 PyPI 的两份分发文件哈希，并从公共索引在干净环境安装精确版本。
+正式版继续使用默认 release profile，仍需完整双平台矩阵、独立参考设备和额定/长时间验收。

python_can_canpal-0.1.0rc1/docs/TESTING.md

@@ -0,0 +1,82 @@
+# 自动化测试与真实验收
+
+## 本地回归
+
+从独立安装的、记录提交版本的 CANPALAPI 源码构建 fake：
+
+```text
+python tools/build_fake.py --sdk /path/to/CANPALAPI --compiler /path/to/g++
+python -m pip install -e ".[test]"
+python -m pytest -m "not hardware" --junitxml=artifacts/unit.xml
+```
+
+Windows 的 MinGW 线程运行库目录应加入 CANPAL_DEPENDENCY_DIRS。
+同一份 C++ fake 导出真实 ABI，模拟四个设备、独立句柄/队列、断线、调用失败及发送阻塞。
+fake 不进入生产 wheel；测试只通过显式路径加载它。
+
+构建脚本生成 abi.json 与 abi-internal.json，分别来自公开头文件与 SDK 实际内部定义；
+两者必须一致，pytest 再与 ctypes 的所有字段逐一对照。
+SDK 源码不复制进本项目，运行环境和头文件哈希进入内部验收记录。
+
+## 真实 SDK 回归
+
+执行以下命令可复现构建并保存原生 JUnit、二进制哈希及构建日志：
+
+```text
+python tools/build_sdk.py --sdk /path/to/CANPALAPI --qmake /path/to/qmake --make /path/to/make
+```
+
+Windows 使用 MinGW 配套 qmake/mingw32-make，Linux 使用系统 Qt 5 工具。
+两个构建脚本强制核对 native/sdk-revision.txt 中的 SDK 提交，并拒绝修改过的 SDK 源文件。
+CI 在两平台依次运行上述构建、pytest 和包构建命令，SDK 源码须由其授权渠道提供。
+再次运行会将旧报告保存到 artifacts/history，保留失败与重跑记录。
+
+native/fake/sdk_smoke.pro 是真实库回归工程，名称所在目录不表示它链接 fake。
+qmake 参数 SDK_ROOT 指向 SDK 源码，SDK_BUILD 指向真实 DLL/SO 和导入库目录。
+测试包括命令/通道/条目不匹配的 ACK，以及两台设备对象同时存在时 200 次线程协作回收。
+Linux 还使用真实 Qt 串口与伪终端：先缓冲 128 字节，再停止输入，分批读完，防止等待新数据时遗漏已缓冲数据。
+这项测试已验证修复前失败、修复后通过。以上回归不打开真实 CAN 设备，不能替代连接故障和硬件验收。
+
+## 硬件配置
+
+复制 hardware-lab.example.json 到不纳入版本管理的内部位置，并填写：
+
+- 独立且已隔离的测试总线确认、真实 SDK 路径、至少两台设备 UID 和网络端点；
+- 每台的独立参考 CAN 接口，不能用 canpal 或 virtual 作为参考；
+- 两条隔离物理 CAN 网络及各自终端电阻/位时序；
+- 控制 USB 断开/连接/改号与网络断开的命令数组；
+- 阻断和恢复发现广播的命令数组。
+
+控制脚本由测试台提供，pytest 通过 subprocess 参数数组调用，不使用 shell 展开。
+命令须同步完成对应动作后返回；不支持的控制不能填写一个空操作来冒充。
+系统实际 COM/ttyACM 编号必须发生变化，否则不计入改号次数。
+
+```text
+python -m pytest -m hardware --hardware-config /path/to/lab.json --junitxml=artifacts/hardware.xml
+```
+
+profile=smoke 用于短联调，不能放行正式版；profile=release 启用每组合 30 分钟和混合连接两小时运行，
+以及 10 次改号、每拓扑 5 次断线、USB/TCP 各 20 次重新打开。
+实际平均发送率至少达到预设 500 fps 的 98%，不在失败后降低目标。
+硬件套件会验证数据序号、载荷、丢失/重复、跨设备隔离、监听和关闭清理。
+线缆矩阵逐向校验标准/扩展 ID 的零值和最大值、经典 CAN 的 0–8 字节及 RTR DLC、
+FD 的 0–64 字节和 BRS 开关，并检查完整标志位、DLC、补零和原消息不变。
+参考接口发送 FD 时使用合法线缆长度；任意长度补零由 CANPAL 发送路径负责验证。
+RTR 没有数据不代表 DLC 必须为零，接收 DLC 与请求不符必须判失败。
+没有配置时硬件用例明确 skip，完整验收仍未完成。
+
+Windows 与原生 Linux 分别执行；WSL 的 release profile 被拒绝。
+还须保存原生句柄/线程/端口资源计数、广播阻断抓包、型号/固件矩阵及实际重试/时间戳行为记录。
+这些设备和系统级证据不能由 fake 或 Python 对象数量替代。
+
+## 与方案对应
+
+测试名称中的 T 编号对应 PLAN.zh-CN.md 的 26 组要求。
+一个用例可能覆盖多组要求，同一组也可能需要 fake、真实库和硬件三种证据。
+自动化套件成功不是整个需求组自动关闭：尚未实测的型号、固件行为、
+故障清理和资源观察必须留在发布验收记录中，不允许补填“通过”。
+
+发布前从最终 sdist 构建 wheel，并在干净环境安装、检查 can.interface 入口、运行消息与 fake 回归。
+最终 SDK 二进制、wheel、sdist、代码提交及报告必须匹配。
+
+0.1.0rc1 经用户明确授权采用独立预览版门槛，见 RELEASE.md。预览版补充检查不关闭上述正式硬件验收缺项。

python_can_canpal-0.1.0rc1/docs/hardware-lab.example.json

@@ -0,0 +1,47 @@
+{
+  "isolated_test_bench": false,
+  "profile": "smoke",
+  "library_path": "/absolute/path/to/real/CANPAL/library",
+  "devices": [
+    {
+      "device_id": "REPLACE_WITH_24_HEX_UID",
+      "channel": 0,
+      "fd": false,
+      "host": "192.0.2.1",
+      "port": 8001,
+      "reference": {
+        "interface": "pcan",
+        "channel": "PCAN_USBBUS1"
+      },
+      "controls": {
+        "disconnect_usb": [],
+        "connect_usb": [],
+        "remap_usb": [],
+        "disconnect_wlan": [],
+        "connect_wlan": []
+      }
+    },
+    {
+      "device_id": "REPLACE_WITH_24_HEX_UID",
+      "channel": 0,
+      "fd": true,
+      "host": "192.0.2.2",
+      "port": 8002,
+      "reference": {
+        "interface": "pcan",
+        "channel": "PCAN_USBBUS2"
+      },
+      "controls": {
+        "disconnect_usb": [],
+        "connect_usb": [],
+        "remap_usb": [],
+        "disconnect_wlan": [],
+        "connect_wlan": []
+      }
+    }
+  ],
+  "controls": {
+    "block_discovery": [],
+    "restore_discovery": []
+  }
+}

python_can_canpal-0.1.0rc1/native/fake/abi_internal.cpp

@@ -0,0 +1,113 @@
+#include <cstdint>
+#include <list>
+#include "canpal_driver2.h"
+using YXConnection = YXConection;
+using YXCANMsgTxControl = decltype(YXCANMsg::tx);
+#include <cstddef>
+#include <iostream>
+int main() {
+  std::cout << "{";
+  std::cout << "\"YXConnection\":{\"size\":" << sizeof(YXConnection) << ",\"offsets\":{";
+  std::cout << "\"CommType\":" << offsetof(YXConnection, type);
+  std::cout << ",\"DestHost\":" << offsetof(YXConnection, dest_host);
+  std::cout << ",\"DestPort\":" << offsetof(YXConnection, dest_port);
+  std::cout << ",\"LocalHost\":" << offsetof(YXConnection, local_host);
+  std::cout << ",\"LocalPort\":" << offsetof(YXConnection, local_port);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXDeviceInfo\":{\"size\":" << sizeof(YXDeviceInfo) << ",\"offsets\":{";
+  std::cout << "\"DeviceName\":" << offsetof(YXDeviceInfo, name);
+  std::cout << ",\"DeviceModel\":" << offsetof(YXDeviceInfo, type);
+  std::cout << ",\"HWVer\":" << offsetof(YXDeviceInfo, hw_ver);
+  std::cout << ",\"SWVer\":" << offsetof(YXDeviceInfo, sw_ver);
+  std::cout << ",\"UniqueID\":" << offsetof(YXDeviceInfo, unique_id);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCapacity\":{\"size\":" << sizeof(YXCapacity) << ",\"offsets\":{";
+  std::cout << "\"CAN_Classic_supported\":" << offsetof(YXCapacity, CAN_Classic_supported);
+  std::cout << ",\"CAN_FD_supported\":" << offsetof(YXCapacity, CAN_FD_supported);
+  std::cout << ",\"LIN_supported\":" << offsetof(YXCapacity, LIN_supported);
+  std::cout << ",\"KLine_supported\":" << offsetof(YXCapacity, KLIne_supported);
+  std::cout << ",\"ISO_TP_supported\":" << offsetof(YXCapacity, ISO_TP_supported);
+  std::cout << ",\"Wifi_supported\":" << offsetof(YXCapacity, Wifi_supported);
+  std::cout << ",\"Ethernet_supported\":" << offsetof(YXCapacity, Ethernet_supported);
+  std::cout << ",\"USB_supported\":" << offsetof(YXCapacity, USB_supported);
+  std::cout << ",\"CAN_channel_num\":" << offsetof(YXCapacity, CAN_channel_num);
+  std::cout << ",\"LIN_channel_num\":" << offsetof(YXCapacity, LIN_channel_num);
+  std::cout << ",\"KLine_channel_num\":" << offsetof(YXCapacity, KLine_channel_num);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXParameter\":{\"size\":" << sizeof(YXParameter) << ",\"offsets\":{";
+  std::cout << "\"ID\":" << offsetof(YXParameter, id);
+  std::cout << ",\"Data\":" << offsetof(YXParameter, data);
+  std::cout << ",\"Len\":" << offsetof(YXParameter, len);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANMsgTxControl\":{\"size\":" << sizeof(YXCANMsgTxControl) << ",\"offsets\":{";
+  std::cout << "\"TxHandle\":" << offsetof(YXCANMsgTxControl, handle);
+  std::cout << ",\"MaxTry\":" << offsetof(YXCANMsgTxControl, max_try);
+  std::cout << ",\"MinGap\":" << offsetof(YXCANMsgTxControl, min_gap);
+  std::cout << ",\"Result\":" << offsetof(YXCANMsgTxControl, result);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANMsg\":{\"size\":" << sizeof(YXCANMsg) << ",\"offsets\":{";
+  std::cout << "\"MsgType\":" << offsetof(YXCANMsg, type);
+  std::cout << ",\"MsgFlag\":" << offsetof(YXCANMsg, flag);
+  std::cout << ",\"Bus\":" << offsetof(YXCANMsg, bus);
+  std::cout << ",\"ID\":" << offsetof(YXCANMsg, id);
+  std::cout << ",\"DLC\":" << offsetof(YXCANMsg, dlc);
+  std::cout << ",\"Data\":" << offsetof(YXCANMsg, data);
+  std::cout << ",\"Timestamp\":" << offsetof(YXCANMsg, timestamp);
+  std::cout << ",\"TXCtrl\":" << offsetof(YXCANMsg, tx);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANFDMsg\":{\"size\":" << sizeof(YXCANFDMsg) << ",\"offsets\":{";
+  std::cout << "\"MsgType\":" << offsetof(YXCANFDMsg, type);
+  std::cout << ",\"MsgFlag\":" << offsetof(YXCANFDMsg, flag);
+  std::cout << ",\"Bus\":" << offsetof(YXCANFDMsg, bus);
+  std::cout << ",\"ID\":" << offsetof(YXCANFDMsg, id);
+  std::cout << ",\"DLC\":" << offsetof(YXCANFDMsg, dlc);
+  std::cout << ",\"Timestamp\":" << offsetof(YXCANFDMsg, timestamp);
+  std::cout << ",\"TXCtrl\":" << offsetof(YXCANFDMsg, tx);
+  std::cout << ",\"Data\":" << offsetof(YXCANFDMsg, data);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANController\":{\"size\":" << sizeof(YXCANController) << ",\"offsets\":{";
+  std::cout << "\"CANMode\":" << offsetof(YXCANController, mode);
+  std::cout << ",\"Baudrate\":" << offsetof(YXCANController, baud_rate);
+  std::cout << ",\"SJW\":" << offsetof(YXCANController, SJW);
+  std::cout << ",\"BS1\":" << offsetof(YXCANController, BS1);
+  std::cout << ",\"BS2\":" << offsetof(YXCANController, BS2);
+  std::cout << ",\"Option\":" << offsetof(YXCANController, option);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANFDController\":{\"size\":" << sizeof(YXCANFDController) << ",\"offsets\":{";
+  std::cout << "\"CANMode\":" << offsetof(YXCANFDController, mode);
+  std::cout << ",\"NomBaudrate\":" << offsetof(YXCANFDController, nom_baud_rate);
+  std::cout << ",\"NomSJW\":" << offsetof(YXCANFDController, nom_SJW);
+  std::cout << ",\"NomBS1\":" << offsetof(YXCANFDController, nom_BS1);
+  std::cout << ",\"NomBS2\":" << offsetof(YXCANFDController, nom_BS2);
+  std::cout << ",\"DataBaudrate\":" << offsetof(YXCANFDController, data_baud_rate);
+  std::cout << ",\"DataSJW\":" << offsetof(YXCANFDController, data_SJW);
+  std::cout << ",\"DataBS1\":" << offsetof(YXCANFDController, data_BS1);
+  std::cout << ",\"DataBS2\":" << offsetof(YXCANFDController, data_BS2);
+  std::cout << ",\"FrameMode\":" << offsetof(YXCANFDController, frame_mode);
+  std::cout << ",\"ResistorEnable\":" << offsetof(YXCANFDController, resistor_enable);
+  std::cout << ",\"ISOModeEnable\":" << offsetof(YXCANFDController, ISO_mode_enable);
+  std::cout << ",\"CANTPEnable\":" << offsetof(YXCANFDController, CAN_TP_enable);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANInitHW\":{\"size\":" << sizeof(YXCANInitHW) << ",\"offsets\":{";
+  std::cout << "\"Inited\":" << offsetof(YXCANInitHW, inited);
+  std::cout << ",\"Timestamp\":" << offsetof(YXCANInitHW, timestamp);
+  std::cout << "}}";
+  std::cout << ",";
+  std::cout << "\"YXCANFilter\":{\"size\":" << sizeof(YXCANFilter) << ",\"offsets\":{";
+  std::cout << "\"Index\":" << offsetof(YXCANFilter, index);
+  std::cout << ",\"Active\":" << offsetof(YXCANFilter, active);
+  std::cout << ",\"FilterType\":" << offsetof(YXCANFilter, type);
+  std::cout << ",\"ID\":" << offsetof(YXCANFilter, id);
+  std::cout << ",\"Mask\":" << offsetof(YXCANFilter, mask);
+  std::cout << "}}";
+  std::cout << "}\n";
+}