本文档提供将 TestBaseVCI 硬件设备适配到python-can 库的详细操作指南。
环境依赖
使用前请确保满足以下环境要求:
- 操作系统:Windows 7/8/10/11, Ubuntu 20/22
- 硬件驱动:TestBaseVCI 驱动程序 2.4.1 及以上版本(该驱动通常随 VBA 工具版本 2.2.0 及以上一同安装)
- Python 环境 :64 位 Python
- 第三方库: python-can
安装适配模块
1. 下载 SDK
访问以下链接,下载 [TestBaseVCI硬件驱动接口二次开发SDK]https://intework.hirain.com/docs/VBA-ruan-jian-API-jie-kou-wen-dang-xia-zai。
本代码路径:/TestBaseVCI硬件驱动接口二次开发SDK/Examples/SpecialDemos/TestBaseVCI_Py_PythonCAN。
2. 手动集成适配模块到现有 python-can
- 复制适配模块
-
- 将 `hrcan` 目录复制到 Python 的 `Lib/site-packages/` 目录下
- 将 `hrcan.py` 文件复制到 Python 的 `Lib/site-packages/can/interfaces/` 目录下
- 注册适配接口
-
- 打开文件 `Lib/site-packages/can/interfaces/__init__.py`
-
- 在 `BACKENDS` 字典中添加如下条目:
```python
"hrcan": ("can.interfaces.hrcan", "HRCANBus")
```
使用示例
本指南提供以下示例代码,演示如何使用适配后的接口操作 TestBaseVCI 硬件:
1. Test_can.py (经典 CAN 示例):
* 不同总线参数下 CAN 通道的启动方法
* 单帧 CAN 报文的发送与接收方法
* 周期 CAN 报文的发送方法
* 手动接收 CAN 报文的方法

2. Test_canFD.py (CAN FD 示例):
* 不同总线参数下 CAN FD 通道的启动方法
* 单帧 CAN FD 报文的发送与接收方法
* 周期 CAN FD 报文的发送方法
* 开启报文接收监听接口的方法

通过这些示例,您可以快速掌握使用 python-can 通用接口操作 TestBaseVCI 硬件进行 CAN/CAN FD 通信的基本流程。
注意事项
- 请确保 TestBaseVCI 驱动程序已正确安装,且设备能被系统识别
- Linux系统上以sudo身份启动Demo程序时,可能由于安装路径问题找不到hrcan目录,请在sudo python3后添加-E参数