dmcan-sdk 1.0.1__tar.gz

dmcan_sdk-1.0.1/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: dmcan_sdk
+Version: 1.0.1
+Summary: DM USB CAN Device SDK
+Requires-Python: >=3.12
+Dynamic: requires-python
+Dynamic: summary

dmcan_sdk-1.0.1/dmcan/__init__.py

@@ -0,0 +1,10 @@
+
+
+__name__ = 'dmcan'
+__version__ = '1.0.1'
+
+
+from dmcan import *
+from dmcan.dmcan_def import *
+from dmcan.dmcan_device import *
+from dmcan.dmcan_context import *

dmcan_sdk-1.0.1/dmcan/dmcan_context.py

@@ -0,0 +1,145 @@
+import sys
+
+from ctypes import *
+from pathlib import Path
+from typing import Optional, List
+from dmcan.dmcan_def import dmcan_device_handle, dmcan_context
+from dmcan.dmcan_device import DmCanDevice
+
+
+def find_backend_dll_path():
+    """
+    查找后端 DLL 路径
+
+    Returns:
+        str: DLL 的绝对路径，找不到返回 None
+    """
+    # 获取平台对应的文件名
+    if sys.platform == "win32":
+        dll_name = "libdm_device.dll"
+    elif sys.platform == "darwin":
+        dll_name = "libdm_device.dylib"
+    elif sys.platform == "linux":
+        dll_name = "libdm_device.so"
+    else:
+        return None
+
+    # 获取项目根目录（假设当前文件在 core/ 或项目根目录）
+    current_file = Path(__file__).resolve()
+
+    # 尝试多个可能的位置
+    possible_paths = [
+        # 相对于当前文件
+        current_file.parent / "dlls" / dll_name,
+        current_file.parent.parent / "dlls" / dll_name,
+        # 相对于当前工作目录
+        Path.cwd() / "dlls" / dll_name,
+        Path.cwd() / dll_name,
+        # 系统路径（直接使用文件名）
+        Path(dll_name),
+    ]
+
+    # 返回第一个存在的路径
+    for path in possible_paths:
+        if path.exists():
+            return str(path)
+
+    # 找不到，返回默认相对路径（让调用者处理错误）
+    return f"./dlls/{dll_name}"
+
+class DmCanContext:
+
+    def __init__(self):
+
+        self.dll_path=find_backend_dll_path()
+        self.dll=CDLL(self.dll_path,winmode=0)
+        self._ctx=POINTER(dmcan_context)()
+        self._devices:List[dmcan_device_handle]=[]
+
+        self._init_funcs()
+
+        self.dll.dmcan_context_create(self._ctx)
+
+    def _init_funcs(self):
+
+        self.dll.dmcan_context_create.argtypes=[POINTER(POINTER(dmcan_context))]
+        self.dll.dmcan_context_create.restype=None
+
+        self.dll.dmcan_context_destroy.argtypes=[POINTER(dmcan_context)]
+        self.dll.dmcan_context_destroy.restype=None
+
+        self.dll.dmcan_print_version.argtypes=[POINTER(dmcan_context)]
+        self.dll.dmcan_print_version.restype=None
+
+        self.dll.dmcan_find_devices.argtypes=[POINTER(dmcan_context)]
+        self.dll.dmcan_find_devices.restype=c_int
+
+        self.dll.dmcan_find_devices_with_type.argtypes=[POINTER(dmcan_context),c_int]
+        self.dll.dmcan_find_devices_with_type.restype=c_int
+
+        self.dll.dmcan_show_all_devices.argtypes=[POINTER(dmcan_context)]
+        self.dll.dmcan_show_all_devices.restype=None
+
+        self.dll.dmcan_device_get.argtypes=[POINTER(dmcan_context),POINTER(POINTER(dmcan_device_handle)),c_int]
+        self.dll.dmcan_device_get.restype=c_bool
+
+    def destroy(self):
+        if self._ctx:
+            self.dll.dmcan_context_destroy(self._ctx)
+            self._ctx=None
+
+    def print_version(self):
+        if self._ctx:
+            self.dll.dmcan_print_version(self._ctx)
+
+    def find_devices(self, dmcan_device_type:Optional[int]=None) -> int:
+        if self._ctx is None:
+            return 0
+
+        device_cnt=0
+        if dmcan_device_type is None:
+            device_cnt= self.dll.dmcan_find_devices(self._ctx)
+        else:
+            device_cnt= self.dll.dmcan_find_devices_with_type(self._ctx, dmcan_device_type)
+
+
+
+        self._devices.clear()
+
+        for i in range(device_cnt):
+
+            dev_handle = POINTER(dmcan_device_handle)()
+
+            ret=self.dll.dmcan_device_get(self._ctx,byref(dev_handle),i)
+
+            if not ret:
+                continue
+
+            if not dev_handle:
+                continue
+            device=DmCanDevice(self.dll,dev_handle,i)
+            self._devices.append(device)
+
+        return device_cnt
+
+
+    def show_all_devices(self):
+        if self._ctx is None:
+            return
+        self.dll.dmcan_show_all_devices(self._ctx)
+
+    def get_device(self,index:int)->DmCanDevice:
+        return self._devices[index]
+
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self,exc_type,exc_value,traceback):
+        for device in self._devices:
+            device.close()
+        self.destroy()
+
+    def __del__(self):
+        if hasattr(self, '_ctx'):
+            self.destroy()

dmcan_sdk-1.0.1/dmcan/dmcan_def.py

@@ -0,0 +1,97 @@
+import ctypes
+from ctypes import *
+from enum import Enum, IntEnum
+
+
+
+class dmcan_device_type(IntEnum):
+    USB2CANFD = 0
+    USB2CANFD_DUAL=1
+    LinkX4C=2
+
+class dmcan_channel_can_info(Structure):
+    _pack_ = 1
+    _fields_ = [
+
+        ("channel",c_uint8),
+        ("canfd",c_bool),
+        ("can_baudrate",c_uint32),
+        ("canfd_baudrate",c_uint32),
+        ("can_sp",c_float),
+        ("canfd_sp",c_float)
+    ]
+
+class dmcan_channel_can_config(Structure):
+    _pack_ = 1
+    _fields_ = [
+        ("channel",c_uint8),
+        ("can_fd",c_uint8),
+        ("can_seg1",c_uint8),
+        ("can_seg2", c_uint8),
+        ("can_sjw", c_uint8),
+        ("can_prescaler", c_uint8),
+        ("canfd_seg1", c_uint8),
+        ("canfd_seg2", c_uint8),
+        ("canfd_sjw", c_uint8),
+        ("canfd_prescaler", c_uint8)
+    ]
+
+class usb_rx_frame_head(Structure):
+    _pack_ = 1
+    _fields_ = [
+
+        ("can_id",c_uint32,29),
+        ("esi",c_uint32,1),
+        ("ext", c_uint32, 1),
+        ("rtr", c_uint32, 1),
+        ("timestamp", c_uint64),
+        ("channel",c_uint8),
+        ("canfd",c_uint8,1),
+        ("dir",c_uint8,1),
+        ("brs",c_uint8,1),
+        ("ack",c_uint8,1),
+        ("dlc",c_uint8,4),
+        ("reserved",c_uint16),
+    ]
+
+    def get_can_id_string(self) -> str:
+        """获取格式化的 CAN ID 字符串"""
+        if self.ext:
+            return f"0x{self.can_id:08X}"  # 扩展帧 29位
+        else:
+            return f"0x{self.can_id:03X}"  # 标准帧 11位
+    def get_data_length(self):
+        """根据 DLC 获取实际数据长度"""
+        dlc_map = {0:0, 1:1, 2:2, 3:3, 4:4, 5:5, 6:6, 7:7, 8:8,
+                   9:12, 10:16, 11:20, 12:24, 13:32, 14:48, 15:64}
+        return dlc_map.get(self.dlc, 0)
+
+class usb_rx_frame(Structure):
+    _pack_ = 1
+    _fields_ = [
+        ("head",usb_rx_frame_head),
+        ("payload",c_uint8*64),
+    ]
+
+    def get_payload_bytes(self, length=None):
+        """获取 payload 数据字节"""
+        if length is None:
+            length = self.head.get_data_length()
+        length = min(length, 64)
+        return bytes(self.payload[:length])
+
+    def get_payload_hex(self, length=None):
+        """获取十六进制格式的 payload"""
+        data = self.get_payload_bytes(length)
+        return ' '.join(f'{b:02X}' for b in data)
+
+class dmcan_context(Structure):
+    pass
+
+class dmcan_device_handle(Structure):
+    pass
+
+
+DEV_RECV_CALLBACK=CFUNCTYPE(None,POINTER(dmcan_device_handle),POINTER(usb_rx_frame))
+DEV_SENT_CALLBACK=CFUNCTYPE(None,POINTER(dmcan_device_handle),POINTER(usb_rx_frame))
+DEV_ERR_CALLBACK=CFUNCTYPE(None,POINTER(dmcan_device_handle),POINTER(usb_rx_frame))

dmcan_sdk-1.0.1/dmcan/dmcan_device.py

@@ -0,0 +1,173 @@
+import ctypes
+from collections.abc import Callable
+from ctypes import *
+from typing import Optional, Any
+
+from dmcan.dmcan_def import dmcan_device_handle, dmcan_channel_can_config, dmcan_channel_can_info, DEV_RECV_CALLBACK, \
+    DEV_SENT_CALLBACK, DEV_ERR_CALLBACK, usb_rx_frame
+
+
+class DmCanDevice:
+
+
+    def __init__(self, dll: ctypes.CDLL,handle:POINTER(dmcan_device_handle),index:int):
+        self.index = index
+        self.dll = dll
+        self._handle = handle
+        self._recv_callback:Optional[Callable]=None
+        self._sent_callback:Optional[Callable]=None
+        self._error_callback:Optional[Callable]=None
+
+        self._recv_cb_wrapper:Optional[Callable]=None
+        self._sent_cb_wrapper:Optional[Callable]=None
+        self._error_cb_wrapper:Optional[Callable]=None
+
+        self._init_funcs()
+
+
+    def _init_funcs(self):
+
+        self.dll.dmcan_device_open.argtypes=[POINTER(dmcan_device_handle)]
+        self.dll.dmcan_device_open.restype=c_bool
+
+        self.dll.dmcan_device_close.argtypes=[POINTER(dmcan_device_handle)]
+        self.dll.dmcan_device_close.restype=None
+
+        self.dll.dmcan_device_get_version.argtypes = [POINTER(dmcan_device_handle),c_char_p, c_size_t]
+        self.dll.dmcan_device_get_version.restype = None
+
+        self.dll.dmcan_device_print_version.argtypes=[POINTER(dmcan_device_handle)]
+        self.dll.dmcan_device_print_version.restype=None
+
+        self.dll.dmcan_device_enable_channel.argtypes=[POINTER(dmcan_device_handle),c_uint8]
+        self.dll.dmcan_device_enable_channel.restype=None
+
+        self.dll.dmcan_device_disable_channel.argtypes=[POINTER(dmcan_device_handle),c_uint8]
+        self.dll.dmcan_device_disable_channel.restype=None
+
+        self.dll.dmcan_device_get_channel_baudrate.argtypes=[POINTER(dmcan_device_handle),c_uint8,POINTER(dmcan_channel_can_info)]
+        self.dll.dmcan_device_get_channel_baudrate.restype=c_bool
+
+        self.dll.dmcan_device_get_channel_baudrate_details.argtypes = [POINTER(dmcan_device_handle), c_uint8,POINTER(dmcan_channel_can_config)]
+        self.dll.dmcan_device_get_channel_baudrate_details.restype = c_bool
+
+        self.dll.dmcan_device_set_channel_baudrate.argtypes=[POINTER(dmcan_device_handle),c_uint8,dmcan_channel_can_info]
+        self.dll.dmcan_device_set_channel_baudrate.restype=c_bool
+
+        self.dll.dmcan_device_set_channel_baudrate_details.argtypes = [POINTER(dmcan_device_handle), c_uint8,dmcan_channel_can_config]
+        self.dll.dmcan_device_set_channel_baudrate_details.restype = c_bool
+
+        self.dll.dmcan_device_hook_recv_callback.argtypes=[POINTER(dmcan_device_handle),DEV_RECV_CALLBACK]
+        self.dll.dmcan_device_hook_recv_callback.restype=None
+
+        self.dll.dmcan_device_hook_sent_callback.argtypes = [POINTER(dmcan_device_handle), DEV_SENT_CALLBACK]
+        self.dll.dmcan_device_hook_sent_callback.restype = None
+
+        self.dll.dmcan_device_hook_err_callback.argtypes = [POINTER(dmcan_device_handle), DEV_ERR_CALLBACK]
+        self.dll.dmcan_device_hook_err_callback.restype = None
+
+        self.dll.dmcan_device_send_can.argtypes=[POINTER(dmcan_device_handle),c_uint8,c_uint32,c_bool,c_bool,c_bool,c_bool,c_uint8,POINTER(c_uint8)]
+        self.dll.dmcan_device_send_can.restype=c_bool
+
+        self.dll.dmcan_device_send_can_details.argtypes=[POINTER(dmcan_device_handle),c_uint8,c_uint32,c_uint16,c_uint32,c_int,c_uint32,c_bool,c_bool,c_bool,c_bool,c_bool,c_bool,c_uint8,POINTER(c_uint8)]
+        self.dll.dmcan_device_send_can_details.restype=c_bool
+
+    def open(self)->bool:
+        if not self._handle:
+            return False
+        return self.dll.dmcan_device_open(self._handle)
+
+    def close(self):
+        if not self._handle:
+            return None
+        return self.dll.dmcan_device_close(self._handle)
+
+    def get_version(self)->str:
+        if not self._handle:
+            return None
+        buf=create_string_buffer(256)
+        self.dll.dmcan_device_get_version(self._handle,buf,len(buf))
+        return buf.value.decode('utf-8')
+
+    def print_version(self):
+        if not self._handle:
+            return None
+        return self.dll.dmcan_device_print_version(self._handle)
+
+    def enable_channel(self,channel:int,enable:bool)->bool:
+        if not self._handle:
+            return False
+        if enable:
+            return self.dll.dmcan_device_enable_channel(self._handle,channel)
+        else:
+            return self.dll.dmcan_device_disable_channel(self._handle,channel)
+
+    def get_channel_baudrate(self,channel:int)->dmcan_channel_can_info:
+        if not self._handle:
+            return None
+
+        info=dmcan_channel_can_info()
+        if self.dll.dmcan_device_get_channel_baudrate(self._handle,channel,info):
+            return info
+        else:
+            return None
+
+    def set_channel_baudrate(self,channel:int,info:dmcan_channel_can_info)->bool:
+        if not self._handle:
+            return False
+        if info:
+            return self.dll.dmcan_device_set_channel_baudrate(self._handle,channel,info)
+        else:
+            return False
+
+    def send_can(self,channel:int,can_id:int,dlen:int,payload:bytes,canfd:bool=False,ext:bool=False,rtr:bool=False,brs:bool=False)->bool:
+        if rtr:
+            dlen = 0
+
+        if len(payload) < dlen:
+            raise ValueError(f"Payload length {len(payload)} < {dlen}")
+
+            # 转换 payload 为 c_uint8 数组
+        data = (c_uint8 * dlen)(*payload[:dlen])
+
+        return self.dll.dmcan_device_send_can(
+            self._handle, channel, can_id, canfd, ext, rtr, brs, dlen, data)
+
+    def hook_recv_callback(self, callback: Callable[[Any, usb_rx_frame], None]):
+
+        self._recv_callback = callback
+
+        @DEV_RECV_CALLBACK
+        def wrapper(handle_ptr, frame_ptr):
+            if frame_ptr:
+                frame = frame_ptr.contents
+                self._recv_callback(self, frame)
+
+        self._recv_cb_wrapper = wrapper
+        self.dll.dmcan_device_hook_recv_callback(self._handle, wrapper)
+
+    def hook_sent_callback(self, callback: Callable[[Any, usb_rx_frame], None]):
+
+        self._sent_callback = callback
+
+        @DEV_SENT_CALLBACK
+        def wrapper(handle_ptr, frame_ptr):
+            if frame_ptr:
+                frame = frame_ptr.contents
+                self._sent_callback(self, frame)
+
+        self._sent_cb_wrapper = wrapper
+        self.dll.dmcan_device_hook_sent_callback(self._handle, wrapper)
+
+    def hook_err_callback(self, callback: Callable[[Any, usb_rx_frame], None]):
+
+        self._error_callback = callback
+
+        @DEV_ERR_CALLBACK
+        def wrapper(handle_ptr, frame_ptr):
+            if frame_ptr:
+                frame = frame_ptr.contents
+                self._error_callback(self, frame)
+
+        self._error_cb_wrapper = wrapper
+        self.dll.dmcan_device_hook_err_callback(self._handle, wrapper)

dmcan_sdk-1.0.1/dmcan_sdk.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: dmcan_sdk
+Version: 1.0.1
+Summary: DM USB CAN Device SDK
+Requires-Python: >=3.12
+Dynamic: requires-python
+Dynamic: summary

dmcan_sdk-1.0.1/dmcan_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+setup.py
+dmcan/__init__.py
+dmcan/dmcan_context.py
+dmcan/dmcan_def.py
+dmcan/dmcan_device.py
+dmcan_sdk.egg-info/PKG-INFO
+dmcan_sdk.egg-info/SOURCES.txt
+dmcan_sdk.egg-info/dependency_links.txt
+dmcan_sdk.egg-info/top_level.txt

dmcan_sdk-1.0.1/dmcan_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dmcan_sdk-1.0.1/dmcan_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+dmcan

dmcan_sdk-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dmcan_sdk-1.0.1/setup.py

@@ -0,0 +1,9 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='dmcan_sdk',
+    version = '1.0.1',
+    description="DM USB CAN Device SDK",
+    python_requires=">=3.12",
+    packages=find_packages()
+)