python-can-hirain-test 0.1.1__py3-none-any.whl

demo/Test_Canfd.py

@@ -0,0 +1,112 @@
+import can
+import time
+from can_hirain.config import TestBaseVCI_ChlMode, TestBaseVCI_SAMPLEPOINT # 导入枚举值
+from can_hirain.hrcan import get_hr_hw_devices_info # 导入获取全部设备信息函数
+
+
+def multi_channel():
+
+    # 初始化通道0（发送端）和通道1（接收端）
+    with can.Bus(interface="hrcan", channel=0, # 激活通道0为CANFD通道
+                 configs = [{
+                     'resistance': 1, # 启用终端电阻
+                     'mode' : TestBaseVCI_ChlMode.CANFD, # 设置CANFD通道
+                     'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+                     'abrBaudrate': 500_000,
+                     'dbrBaudrate': 2000_000,
+                     'abrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,
+                     'dbrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,}]) as bus_tx, \
+    can.Bus(interface="hrcan", channel=1, # 激活通道1为CANFD通道
+            configs=[{
+                'resistance': 1,  # 启用终端电阻
+                'mode': TestBaseVCI_ChlMode.CANFD,  # 设置CANFD通道
+                'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+                'abrBaudrate': 500_000,
+                'dbrBaudrate': 2000_000,
+                'abrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,
+                'dbrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80}]) as bus_rx:
+    # with can.Bus(
+    #         interface="hrcan",
+    #         channel=0,
+    #         rate_baudrate=500,
+    #         data_baudrate=2000,
+    #         enable_120hm=True,
+    #         is_fd=True,
+    #         is_include_tx=True,
+    #         hwserial=b"HRA000020000"  # 使用设备SN作为硬件序列号
+    #     ) as bus_tx,\
+    # can.Bus(
+    #         interface="hrcan",
+    #         channel=1,
+    #         rate_baudrate=500,
+    #         data_baudrate=2000,
+    #         enable_120hm=True,
+    #         is_fd=True,
+    #         is_include_tx=True,
+    #         hwserial=b"HRA000020000"  # 使用设备SN作为硬件序列号
+    #     ) as bus_rx:
+
+        # # 配置接收端监听器（打印+日志）
+        # listeners_rx = [can.Printer(), can.Logger("rx_channel.asc")]
+        # notifier_rx = can.Notifier(bus_rx, listeners_rx)
+        # time.sleep(0.1)  # 确保监听器就绪
+        #
+        # # 配置发送端监听器（打印+日志）
+        # listeners_tx = [can.Printer(), can.Logger("tx_channel.asc")]
+        # notifier_tx = can.Notifier(bus_tx, listeners_tx)
+        # time.sleep(0.1)  # 确保监听器就绪
+
+        # 配置总计监听器（日志）(不配置Printer以降低IO资源占用)
+        listeners = [can.Printer(), can.Logger("rxtx_channel_test.blf")]
+        notifier = can.Notifier([bus_tx,bus_rx], listeners)
+        time.sleep(0.1)  # 确保监听器就绪
+
+        # 发送测试消息（从通道0发送到通道1）
+        test_msg_1 = can.Message(
+            arbitration_id=0x123,
+            data=[0xAA, 0xBB, 0xCC],
+            dlc=3,
+            is_extended_id=True,
+            is_fd=True,
+            bitrate_switch=True
+        )
+
+        # 发送测试消息（从通道0发送到通道1）
+        test_msg_2 = can.Message(
+            arbitration_id=0x1FFFFFFE,
+            data=[i for i in range(8)],
+            dlc=8,
+            is_extended_id=True,
+            is_fd=True,
+            bitrate_switch=True
+        )
+        print(f"发送消息: ID=0x{test_msg_1.arbitration_id:X}, Data={','.join(str(_) for _ in test_msg_1.data)}")
+        bus_tx.send(test_msg_1)
+        print(f"发送消息: ID=0x{test_msg_2.arbitration_id:X}, Data={','.join(str(_) for _ in test_msg_2.data)}")
+        bus_tx.send(test_msg_2)
+
+        time.sleep(2)
+        # canfd_id = [0x85, 0xE0, 0x100, 0x103, 0x122, 0x123, 0x124, 0x125, 0x162, 0x165, 0x1A5, 0x218, 0x220, 0x228, 0x256, 0x26D, 0x288, 0x292, 0x2A1, 0x2A5, 0x2A7, 0x2AC, 0x2E0, 0x2F7, 0x360, 0x380, 0x3D0, 0x3F1, 0x405, 0x744, 0x783, 0x795, 0x7C6, 0x7DF, 0x7E2, 0x1F0, 0x1F1, 0x1F2, 0x283, 0x284]
+        canfd_id = [0x7E2, 0x1F0, 0x1F1, 0x1F2, 0x283, 0x284]
+        # test_msg_2.arbitration_id = 0x1FFFEEEE
+        num = 0
+        test_msg_2.is_extended_id = False
+        for i in canfd_id:
+            test_msg_2.arbitration_id = i
+            bus_tx.send_periodic(test_msg_2, 0.01)
+            print(f"发送周期消息: ID=0x{test_msg_2.arbitration_id:X}")
+            num += 1
+        print(f"共有{num}条周期报文")
+
+        print("等待100s...")
+        time.sleep(100)
+
+        bus_tx.stop_all_periodic_tasks()
+        time.sleep(10)
+        notifier.stop()
+
+if __name__ == "__main__":
+    devices = get_hr_hw_devices_info()
+    print(devices)
+    time.sleep(2)
+    multi_channel()

demo/Test_can.py

@@ -0,0 +1,81 @@
+import can
+import time
+from can_hirain.config import *
+
+def multi_channel():
+
+    # 初始化通道0（发送端）和通道1（接收端）
+    with can.Bus(interface="hrcan", channel=0, # 激活通道0为CANFD通道
+                 configs = [{
+                     'resistance': 1, # 启用终端电阻
+                     'mode' : TestBaseVCI_ChlMode.CAN, # 设置CAN通道
+                     'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+                     'baudrate': 500_000,
+                     'samplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_75}]) as bus_tx, \
+        can.Bus(interface="hrcan", channel=1, # 激活通道1为CANFD通道
+                configs=[{
+                    'resistance': 1,  # 启用终端电阻
+                    'mode': TestBaseVCI_ChlMode.CAN,  # 设置CAN通道
+                    'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+                    'baudrate': 500_000,
+                    'samplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_75}]) as bus_rx:
+
+        time.sleep(0.1)  # 确保监听器就绪
+
+        # 发送测试消息（从通道0发送到通道1）
+        test_msg_1 = can.Message(
+            arbitration_id=0x123,
+            dlc=3,
+            data=[0xAA, 0xBB, 0xCC],
+            is_extended_id=False,
+            is_fd=False,
+            bitrate_switch=True
+        )
+
+        # 发送测试消息（从通道0发送到通道1）
+        test_msg_2 = can.Message(
+            arbitration_id=0x1FFFFFFE,
+            data=[i for i in range(8)],
+            dlc=8,
+            is_extended_id=True,
+            is_fd=False,
+            bitrate_switch=True
+        )
+
+        print(f"发送消息: ID=0x{test_msg_1.arbitration_id:X}, Data={','.join(str(_) for _ in test_msg_1.data)}")
+        bus_tx.send(test_msg_1)
+        print(f"发送消息: ID=0x{test_msg_2.arbitration_id:X}, Data={','.join(str(_) for _ in test_msg_2.data)}")
+        bus_tx.send(test_msg_2)
+        # time.sleep(2)
+
+        # ==== 接收阶段1：接收单次发送的消息 ====
+        received_count = 0
+        start_time = time.time()
+        while time.time() - start_time < 2 and received_count <=2 :
+            msg = bus_rx.recv(timeout=0.5)  # 设置接收超时
+            if msg is not None:
+                received_count += 1
+                print(f"接收到消息[{received_count}]: ID=0x{msg.arbitration_id:X}, DLC={msg.dlc}, Data={','.join(str(_) for _ in msg.data)}")
+
+ 
+        # ==== 周期消息处理 ====
+        bus_tx.send_periodic(test_msg_2, 0.1)
+        print(f"开始周期发送: ID=0x{test_msg_2.arbitration_id:X} 周期: 100ms")
+
+        # ==== 接收阶段2：接收周期消息 ====
+        period_start = time.time()
+        period_msgs = []
+        while time.time() - period_start < 5:
+            msg = bus_rx.recv(timeout=0.1)
+            if msg is not None:
+                period_msgs.append(msg)
+                # 实时打印接收到的消息摘要
+                print(f"[周期消息] ID=0x{msg.arbitration_id:X} chl={msg.channel} Dir={msg.is_rx} DLC={msg.dlc} TimeStamp={msg.timestamp}")
+
+
+        # 停止周期发送并关闭
+        bus_rx.stop_all_periodic_tasks()
+        print(f"已停止周期发送, 共接收到 {len(period_msgs)} 条周期消息")
+
+if __name__ == "__main__":
+    multi_channel()

demo/Test_diag.py

@@ -0,0 +1,87 @@
+import can
+import time
+from can_hirain.config import TestBaseVCI_ChlMode, TestBaseVCI_SAMPLEPOINT, N_Parameter  # 导入枚举值
+from can_hirain.hrcan import get_hr_hw_devices_info # 导入获取全部设备信息函数
+
+
+def multi_channel():
+
+    # 初始化通道0（发送端）和通道1（接收端）
+    # with can.Bus(interface="hrcan", channel=0, # 激活通道0为CANFD通道
+    #              configs = [{
+    #                  'resistance': 1, # 启用终端电阻
+    #                  'mode' : TestBaseVCI_ChlMode.CANFD, # 设置CANFD通道
+    #                  'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+    #                  'abrBaudrate': 500_000,
+    #                  'dbrBaudrate': 2000_000,
+    #                  'abrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,
+    #                  'dbrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,}]) as bus_tx, \
+    # can.Bus(interface="hrcan", channel=4, # 激活通道1为CANFD通道
+    #         configs=[{
+    #             'resistance': 1,  # 启用终端电阻
+    #             'mode': TestBaseVCI_ChlMode.CANFD,  # 设置CANFD通道
+    #             'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+    #             'abrBaudrate': 500_000,
+    #             'dbrBaudrate': 2000_000,
+    #             'abrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,
+    #             'dbrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80}]) as bus_rx:
+    with can.Bus(
+            interface="hrcan",
+            channel=0,
+            rate_baudrate=500,
+            data_baudrate=2000,
+            enable_120hm=True,
+            is_fd=True,
+            is_include_tx=True,
+            hwserial=b"HR3210700241",  # 使用设备SN作为硬件序列号
+            # filters=[{"min":0x600, "max": 0x7FF, "extend": False}] # 仅保留诊断报文
+        ) as bus_tx,\
+    can.Bus(
+            interface="hrcan",
+            channel=1,
+            rate_baudrate=500,
+            data_baudrate=2000,
+            enable_120hm=True,
+            is_fd=True,
+            is_include_tx=True,
+            hwserial=b"HR3210700241"  # 使用设备SN作为硬件序列号
+        ) as bus_rx:
+
+        # 配置接收端监听器（打印+日志）
+        # listeners_rx = [can.Printer(), can.Logger("rx_channel.asc")]
+        # notifier_rx = can.Notifier(bus_rx, listeners_rx)
+        # time.sleep(0.1)  # 确保监听器就绪
+
+        # 配置发送端监听器（打印+日志）
+        listeners_tx = [can.Printer(), can.Logger("tx_channel.asc")]
+        notifier_tx = can.Notifier(bus_tx, listeners_tx)
+        time.sleep(0.1)  # 确保监听器就绪
+
+        n_rst = bus_tx.can_set_diagnostic_config(ReqId=0x7B6, FuncReqID=0x7DF, RespId=0x7BE, DataPadding = 0xCC)
+        if n_rst == 0:
+            print(f"诊断配置下发成功")
+        else:
+            print(f"诊断配置下发失败，错误码{n_rst}")
+
+        # 配置启动填充位
+        n_rst = bus_tx.can_set_param_15765_2(True, Parameter=N_Parameter.N_Opt)
+        if n_rst == 0:
+            print(f"诊断填充位配置下发成功")
+        else:
+            print(f"诊断填充位配置下发失败，错误码{n_rst}")
+
+        n_rst, resp = bus_tx.can_forward_15765_2(ReqId=0x7B6, DataLen=3, data=(0x22, 0xF1, 0x92), WaitResp = True)
+        if n_rst == 0:
+            print(f"诊断成功, 响应数据{resp}")
+        else:
+            print(f"诊断失败，错误码{n_rst}")
+
+        time.sleep(10)
+
+
+import threading
+if __name__ == "__main__":
+    devices = get_hr_hw_devices_info()
+    print(devices)
+    time.sleep(2)
+    multi_channel()

demo/Test_env.py

@@ -0,0 +1,2 @@
+import importlib.metadata as m; 
+print([e for e in m.entry_points(group='can.interface') if e.name=='hrcan'])

python_can_hirain_test-0.1.1.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: python-can-hirain-test
+Version: 0.1.1
+Summary: python-can interface plugin for Hirain
+Author-email: Jingwei Hirain <yalong.ding@hirain.com>
+License: MIT
+Keywords: python-can,CAN,Hirain
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-can>=4.0.0
+Dynamic: license-file
+
+# python-can-hirain
+
+Python CAN 接口适配器，用于通过 **python-can** 库操作 **HIRAIN TestBaseVCI** 硬件设备。
+
+## 安装
+
+使用 pip 安装：
+
+```bash
+pip install python-can-hirain
+```
+
+安装后，`hrcan` 接口会自动注册到 python-can 中，无需手动复制文件或修改 `__init__.py`。
+
+## 快速开始
+
+### CAN 通信示例
+
+```python
+import can
+import time
+
+# 初始化 CAN 通道
+with can.Bus(interface="hrcan", channel=0, # 激活通道0为CANFD通道
+    configs = [{
+        'resistance': 1, # 启用终端电阻
+        'mode' : TestBaseVCI_ChlMode.CAN, # 设置CAN通道
+        'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+        'baudrate': 500_000,
+        'samplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_75}]) as bus:
+    pass
+# 初始化 CANFD 通道
+with can.Bus(interface="hrcan", channel=0, # 激活通道0为CANFD通道
+        configs = [{
+            'resistance': 1, # 启用终端电阻
+            'mode' : TestBaseVCI_ChlMode.CANFD, # 设置CANFD通道
+            'listenFlag' : 0, # 0-正常状态，1-通道为仅监听状态，不给ACK响应
+            'abrBaudrate': 500_000,
+            'dbrBaudrate': 2000_000,
+            'abrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,
+            'dbrSamplePoint': TestBaseVCI_SAMPLEPOINT.SAMPLE_80,}]) as bus:
+    pass
+```
+
+
+## 环境要求
+
+- **操作系统**: Windows 10/11, Ubuntu 20/22
+- **硬件驱动**: TestBaseVCI 驱动程序 2.4.1+
+- **Python**: 64 位 Python 3.7+
+- **依赖库**: python-can
+
+## 更多示例
+
+查看 `demo/` 目录获取完整示例：
+- `Test_can.py` - 经典 CAN 操作示例
+- `Test_Canfd.py` - CAN FD 操作示例  
+- `Test_diag.py` - 诊断功能示例
+
+## 注意事项
+
+- 确保 TestBaseVCI 驱动程序已正确安装
+- Linux 系统上使用 sudo 时，可能需要添加 `-E` 参数保留环境变量
+- 使用前请确认设备能被系统识别
+
+## 支持
+
+有关详细配置参数和高级用法，请参考 python-can 官方文档和 HIRAIN 二次开发SDK手册。

python_can_hirain_test-0.1.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+can_hirain/BasicStructure.py,sha256=mxKqAv7OOPC4faRSgUaNFS7_mxdNuF6nobS7LYNE4Lo,59440
+can_hirain/TestBaseVCI.py,sha256=l81JPbnlHmgBl1gZVKMTQhVDEAfl9h0mOH3LglMKNBo,35484
+can_hirain/__init__.py,sha256=jgtBbPhWvHOT7cuiNaKeuGLGU2_5Sb_BUCqCwSysqFs,53
+can_hirain/hrcan.py,sha256=cBRlkzFSzLrfjdjylf6qwQS9kZYhi2hjaLu60yJcUus,28243
+demo/Test_Canfd.py,sha256=RS2yC9Q_hKQh8Xp4_8_qiRfu1doQrkRAG5hXouenH80,4884
+demo/Test_can.py,sha256=XMnJ4kPwxoauELB1jObQbbkTVHJZC4CtxkwdUlB3wfA,3445
+demo/Test_diag.py,sha256=SqI0vYlrg7Fho6HEhB1twFSeAdb615WGZDzSSYFjWy8,3751
+demo/Test_env.py,sha256=0zn0fDvvIQvs4hi7lKIFklgsFoAU26pE31RLphzb8xM,110
+python_can_hirain_test-0.1.1.dist-info/licenses/LICENSE,sha256=5fhq4o78k6EnY_DJPRU-Yz_4J_2cSDF4Bp_RXcnxE3Y,1299
+python_can_hirain_test-0.1.1.dist-info/METADATA,sha256=4_WT9h8huwgyB3PJNRGBSJv99PS7Pju9S_ORTMVk_7g,2578
+python_can_hirain_test-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+python_can_hirain_test-0.1.1.dist-info/entry_points.txt,sha256=n23mUs8tYXL-P6523j0rPoU1Ja3ew6RycevbBY4IqbU,50
+python_can_hirain_test-0.1.1.dist-info/top_level.txt,sha256=dRUhv5FHQAfYpdFLEvu9YG5cxGqM-DnoTzgssJqRVHs,16
+python_can_hirain_test-0.1.1.dist-info/RECORD,,

python_can_hirain_test-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

python_can_hirain_test-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[can.interface]
+hrcan = can_hirain.hrcan:HRCANBus

python_can_hirain_test-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 JINGWEI HIRAIN
+
+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.
+
+Third-party libraries imported in the code are subject to the proprietary rights 
+notices of their respective authors. Users must comply with the copyright 
+requirements specified by the authors of such third-party libraries.
+
+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.
+

python_can_hirain_test-0.1.1.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+can_hirain
+demo