qlsdk2 0.4.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

qlsdk/rsc/device/c64s1.py

@@ -0,0 +1,365 @@
+
+from multiprocessing import Queue
+from threading import Thread
+from time import sleep, time_ns
+from typing import Any, Dict, Literal
+
+from loguru import logger
+from qlsdk.persist import RscEDFHandler
+from qlsdk.rsc.interface import IDevice, IParser
+from qlsdk.rsc.command import *
+from qlsdk.rsc.parser.base import TcpMessageParser
+from qlsdk.rsc.device.base import QLBaseDevice
+
+class C64S1(QLBaseDevice):
+    
+    device_type = 0x40  # C64RS设备类型标识符
+    
+    def __init__(self, socket):
+        super().__init__(socket)
+        self.socket = socket
+        
+        self._id = None
+        
+        # 设备信息
+        self.device_id = None
+        self.device_name = None
+        self._device_no = None
+        self.software_version = None
+        self.hardware_version = None
+        self.connect_time = None
+        self.current_time = None
+        # mV
+        self.voltage = None
+        # %
+        self.battery_remain = None
+        # %
+        self.battery_total = None
+        # persist
+        self._recording = False
+        self._storage_path = None
+        self._file_prefix = None
+        
+        # 可设置参数
+        # 采集：采样量程、采样率、采样通道
+        # 刺激：刺激电流、刺激频率、刺激时间、刺激通道
+        # 采样量程（mV）：188、375、563、750、1125、2250、4500
+        self._sample_range:Literal[188, 375, 563, 750, 1125, 2250, 4500] = 188        
+        # 采样率（Hz）：250、500、1000、2000、4000、8000、16000、32000
+        self._sample_rate:Literal[250, 500, 1000, 2000, 4000, 8000, 16000, 32000] = 500
+        self._physical_max = self._sample_range * 1000  # 物理最大值（uV）
+        self._physical_min = -self._sample_range * 1000  # 物理最小值（uV）
+        self._digital_max = 8388607
+        self._digital_min = -8388608
+        self._physical_range = self._physical_max - self._physical_min
+        self._digital_range = 16777215
+        self._acq_channels = None
+        self._acq_param = {
+            "sample_range": 188,
+            "sample_rate": 500,
+            "channels": [],
+        }
+        
+        self._stim_param = {
+            "stim_type": 0,                 # 刺激类型：0-所有通道参数相同, 1: 通道参数不同
+            "channels": [],
+            "param": [{
+                    "channel_id": 0,        #通道号 从0开始                          -- 必填
+                    "waveform": 3,          #波形类型：0-直流，1-交流 2-方波 3-脉冲   -- 必填
+                    "current": 1,           #电流强度(mA)                            -- 必填
+                    "duration": 30,         #平稳阶段持续时间(s)                      -- 必填
+                    "ramp_up": 5,           #上升时间(s) 默认0
+                    "ramp_down": 5,         #下降时间(s) 默认0
+                    "frequency": 500,       #频率(Hz) -- 非直流必填
+                    "phase_position": 0,    #相位 -- 默认0
+                    "duration_delay": "0",  #延迟启动时间(s) -- 默认0
+                    "pulse_width": 0,       #脉冲宽度(us) -- 仅脉冲类型电流有效， 默认100us
+                },
+                {
+                    "channel_id": 1,        #通道号 从0开始                          -- 必填
+                    "waveform": 3,          #波形类型：0-直流，1-交流 2-方波 3-脉冲   -- 必填
+                    "current": 1,           #电流强度(mA)                            -- 必填
+                    "duration": 30,         #平稳阶段持续时间(s)                      -- 必填
+                    "ramp_up": 5,           #上升时间(s) 默认0
+                    "ramp_down": 5,         #下降时间(s) 默认0
+                    "frequency": 500,       #频率(Hz) -- 非直流必填
+                    "phase_position": 0,    #相位 -- 默认0
+                    "duration_delay": "0",  #延迟启动时间(s) -- 默认0
+                    "pulse_width": 0,       #脉冲宽度(us) -- 仅脉冲类型电流有效， 默认100us
+                }
+            ]
+        }
+        
+        self.stim_paradigm = None
+                      
+        signal_info = {
+            "param" : None,
+            "start_time" : None,
+            "finished_time" : None,
+            "packet_total" : None,
+            "last_packet_time" : None,
+            "state" : 0
+        }
+        stim_info = {
+            
+        }
+        Impedance_info = {
+            
+        }
+        # 信号采集状态
+        # 信号数据包总数（一个信号采集周期内）
+        # 信号采集参数
+        # 电刺激状态
+        # 电刺激开始时间（最近一次）
+        # 电刺激结束时间（最近一次）
+        # 电刺激参数
+        # 启动数据解析线程
+        # 数据存储状态
+        # 存储目录
+        
+        # 
+        self.__signal_consumer: Dict[str, Queue[Any]]={}
+        self.__impedance_consumer: Dict[str, Queue[Any]]={}
+        
+        # EDF文件处理器
+        self._edf_handler = None       
+        self.storage_enable = True 
+        
+        self._parser: IParser = TcpMessageParser(self)
+        self._parser.start()
+        
+        # 启动数据接收线程
+        self._accept = Thread(target=self.accept)
+        self._accept.daemon = True
+        self._accept.start()
+        
+    @property
+    def device_no(self):
+        return self._device_no
+    
+    @device_no.setter
+    def device_no(self, value: str):
+        self._device_no = value
+    
+    @classmethod
+    def from_parent(cls, parent:IDevice) -> IDevice:
+        rlt = cls(parent.socket)
+        rlt.device_id = parent.device_id
+        rlt._device_no = parent.device_no
+        return rlt
+        
+        
+    def init_edf_handler(self):
+        self._edf_handler = RscEDFHandler(self.sample_rate,  self.sample_range * 1000 , - self.sample_range * 1000, self.resolution)  
+        self._edf_handler.set_device_type(self.device_type)
+        self._edf_handler.set_device_no(self.device_no)
+        self._edf_handler.set_storage_path(self._storage_path)
+        self._edf_handler.set_file_prefix(self._file_prefix if self._file_prefix else 'C64S1')
+        
+    @property
+    def edf_handler(self):
+        if not self.storage_enable:
+            return None
+        
+        if self._edf_handler is None:
+            self.init_edf_handler() 
+            
+        return self._edf_handler  
+    
+    @property
+    def acq_channels(self):
+        if self._acq_channels is None:
+            self._acq_channels = [i for i in range(1, 63)]
+        return self._acq_channels
+    @property
+    def sample_range(self):
+        return self._sample_range if self._sample_range else 188
+    @property
+    def sample_rate(self):
+        return self._sample_rate if self._sample_rate else 500
+    @property
+    def resolution(self):
+        return 24
+    
+    @property
+    def signal_consumers(self):
+        return self.__signal_consumer
+    
+    @property
+    def impedance_consumers(self):
+        return self.__impedance_consumer
+    
+    # 设置记录文件路径
+    def set_storage_path(self, path):
+        self._storage_path = path
+       
+    # 设置记录文件名称前缀 
+    def set_file_prefix(self, prefix):
+        self._file_prefix = prefix
+        
+    # 接收socket消息
+    def accept(self):
+        while True:
+            # 缓冲去4M
+            data = self.socket.recv(4096*1024)
+            if not data:
+                logger.warning(f"设备{self.device_name}连接结束")
+                break
+            
+            self._parser.append(data)
+            
+       
+    # socket发送数据    
+    def send(self, data):
+        self.socket.sendall(data)
+    
+    # 设置刺激参数
+    def set_stim_param(self, param):
+        self.stim_paradigm = param
+    
+    # 设置采集参数
+    def set_acq_param(self, channels, sample_rate = 500, sample_range = 188):
+        self._acq_param["channels"] = channels 
+        self._acq_param["sample_rate"] = sample_rate
+        self._acq_param["sample_range"] = sample_range
+        self._acq_channels = channels
+        self._sample_rate = sample_rate
+        self._sample_range = sample_range
+    
+    # 通用配置-TODO
+    def set_config(self, key:str, val: str):
+        pass      
+        
+    def start_impedance(self):
+        logger.info("启动阻抗测量")  
+        msg = StartImpedanceCommand.build(self).pack()
+        logger.debug(f"start_impedance message is {msg.hex()}")
+        self.socket.sendall(msg)
+    
+    def stop_impedance(self):
+        logger.info("停止阻抗测量")  
+        msg = StopImpedanceCommand.build(self).pack()
+        logger.debug(f"stop_impedance message is {msg.hex()}")
+        self.socket.sendall(msg)
+    
+    def start_stimulation(self):
+        if self.stim_paradigm is None:
+            logger.warning("刺激参数未设置，请先设置刺激参数")
+            return
+        logger.info("启动电刺激")  
+        msg = StartStimulationCommand.build(self).pack()
+        logger.debug(f"start_stimulation message is {msg.hex()}")
+        self.socket.sendall(msg)
+        t = Thread(target=self._stop_stimulation_trigger, args=(self.stim_paradigm.duration,))
+        t.start()
+        
+    def _stop_stimulation_trigger(self, duration):
+        delay = duration
+        while delay > 0:
+            sleep(1)
+            delay -= 1
+        logger.info(f"_stop_stimulation_trigger duration: {duration}")
+        if self._edf_handler:
+            self._edf_handler.trigger("stimulation should be stopped")
+        else:
+            logger.warning("stop stim trigger fail. no edf writer alive")
+        
+    def stop_stimulation(self):
+        logger.info("停止电刺激")  
+        msg = StopStimulationCommand.pack()
+        logger.debug(f"stop_stimulation message is {msg.hex()}")
+        self.socket.sendall(msg)
+        
+    # 启动采集
+    def start_acquisition(self, recording = True):
+        logger.info("启动信号采集")  
+        self._recording = recording
+        # 设置数据采集参数
+        param_bytes = SetAcquisitionParamCommand.build(self).pack()
+        # 启动数据采集
+        start_bytes = StartAcquisitionCommand.build(self).pack()
+        msg = param_bytes + start_bytes
+        logger.debug(f"start_acquisition message is {msg.hex()}")
+        self.socket.sendall(msg)
+        
+    # 停止采集
+    def stop_acquisition(self):
+        logger.info("停止信号采集")  
+        msg = StopAcquisitionCommand.build(self).pack()
+        logger.debug(f"stop_acquisition message is {msg.hex()}")
+        self.socket.sendall(msg)
+        if self._edf_handler:
+            # 发送结束标识
+            self.edf_handler.write(None)
+        
+    # 订阅实时数据
+    def subscribe(self, topic:str=None, q : Queue=None, type : Literal["signal","impedance"]="signal"):  
+            
+        # 数据队列
+        if q is None:
+            q = Queue(maxsize=1000)
+            
+        # 队列名称     
+        if topic is None:
+            topic = f"{type}_{time_ns()}"
+        
+        # 订阅生理电信号数据
+        if type == "signal":
+            # topic唯一，用来区分不同的订阅队列（下同）
+            if topic in list(self.__signal_consumer.keys()):
+                logger.warning(f"exists {type} subscribe of {topic}")
+            else:
+                self.__signal_consumer[topic] = q
+            
+        # 订阅阻抗数据
+        if type == "impedance":
+            if topic in list(self.__signal_consumer.keys()):
+                logger.warning(f"exists {type} subscribe of {topic}")
+            else:
+                self.__impedance_consumer[topic] = q
+            
+        return topic, q
+    
+    def trigger(self, desc):
+        if self._edf_handler:
+            self.edf_handler.trigger(desc)
+        else:
+            logger.warning("no edf handler, no place to recording trigger")
+        
+    def __str__(self):
+        return f''' 
+            Device: 
+                Name: {self.device_name}, 
+                Type: {hex(self.device_type) if self.device_type else None}, 
+                ID: {self.device_id if self.device_id else None}, 
+                Software: {self.software_version}, 
+                Hardware: {self.hardware_version}, 
+                Connect Time: {self.connect_time},
+                Current Time: {self.current_time},
+                Voltage: {str(self.voltage) + "mV" if self.voltage else None},
+                Battery Remain: {str(self.battery_remain)+ "%" if self.battery_remain else None},
+                Battery Total: {str(self.battery_total) + "%" if self.battery_total else None}
+            '''
+
+    def __repr__(self):
+        return f''' 
+            Device: 
+                Name: {self.device_name}, 
+                Type: {hex(self.device_type)}, 
+                ID: {self.device_id}, 
+                Software: {self.software_version}, 
+                Hardware: {self.hardware_version}, 
+                Connect Time: {self.connect_time},
+                Current Time: {self.current_time},
+                Voltage: {self.voltage}mV,
+                Battery Remain: {self.battery_remain}%,
+                Battery Total: {self.battery_total}%
+            '''
+
+    def __eq__(self, other):
+        return self.device_name == other.device_name and self.device_type == other.device_type and self.device_id == other.device_id
+
+    def __hash__(self):
+        return hash((self.device_name, self.device_type, self.device_id))    
+    
+    

qlsdk/rsc/device/device_factory.py

@@ -2,6 +2,7 @@ from typing import Dict, Type
 from qlsdk.rsc.interface import IDevice
 
 from qlsdk.rsc.device.c64_rs import C64RS
+from qlsdk.rsc.device.arskindling import ARSKindling
 
 from loguru import logger
 
@@ -24,6 +25,10 @@ class DeviceFactory(object):
         return instance.from_parent(device) if hasattr(instance, 'from_parent') else instance(device.socket)
 
 # Register the C64RS device with the DeviceFactory    
-DeviceFactory.register(C64RS.device_type, C64RS) 
+DeviceFactory.register(C64RS.device_type, C64RS)
+# Register the ARSKindling device with the DeviceFactory
+DeviceFactory.register(ARSKindling.device_type, ARSKindling) 
+
+
     
     

qlsdk/rsc/interface/device.py

@@ -15,6 +15,15 @@ class  IDevice(ABC):
     def device_no(self) -> str:
         pass
     
+    def produce(self, data) -> None:
+        pass
+    
+    def start_listening(self):
+        pass
+    
+    def stop_listening(self):
+        pass
+    
     def set_device_no(self, value: str):
         pass
     
@@ -44,9 +53,10 @@ class  IDevice(ABC):
     
     def stop_stimulation(self) -> None:
         pass
+    
+    def gen_set_acquirement_param(self) -> bytes:
+        pass
         
-    def __eq__(self, other):
-        return self.device_id == other.device_id
     
     
 class RscDevice(IDevice):

qlsdk/rsc/interface/parser.py

@@ -6,4 +6,7 @@ class IParser(ABC):
         
     @abstractmethod
     def append(self, buffer):
-        pass 
+        pass 
+    
+    def set_device(self, device):
+        pass

qlsdk/rsc/manager/container.py

@@ -33,15 +33,15 @@ class DeviceContainer(object):
         等待设备连接
     '''
     def connect(self, device_id: str, timeout:int=30) -> Optional[IDevice]:        
-        logger.info(f"Searching for device: {device_id}")
+        logger.info(f"开始搜索设备: {device_id}")
         self.add_search(device_id)
-        for _ in range(timeout):
+        for s in range(timeout):
             device = self.get_device(device_id)
             if device:
-                logger.success(f"Device {device_id} connected")
+                logger.success(f"设备[{device_id}]已连接成功。")
                 return device
             time.sleep(1)
-        logger.error(f"Device {device_id} not found")
+        logger.warning(f"在{timeout}内未搜索到设备：{device_id}")
         return None
             
     def _listening(self):
@@ -55,15 +55,16 @@ class DeviceContainer(object):
 
             while True:
                 client_socket, addr = tcp_socket.accept()
-                logger.info(f"接收到来自 {addr[0]}:{addr[1]} 的连接")
+                logger.info(f"接收到来自[{addr[0]}:{addr[1]}]的连接，待确认设备类型...")
                 
                 
                 # 为每个新连接创建线程处理
                 client_handler = Thread(
                     target=self.client_handler,
-                    args=(client_socket,)
+                    args=(client_socket,),
+                    daemon=True
                 )
-                client_handler.daemon = True
+                
                 client_handler.start()
                 
         except KeyboardInterrupt:
@@ -81,16 +82,19 @@ class DeviceContainer(object):
         else:            
             # 数据监听
             device = QLBaseDevice(client_socket)
+            device.start_listening()
             # GET_DEVICE_INFO
             msg = GetDeviceInfoCommand.build(device).pack()
-            logger.info(f"发送获取设备信息命令: {msg.hex()}")
+            logger.trace(f"发送获取设备信息命令: {msg.hex()}")
             device.send(msg)
             # 添加设备
             while True:
                 if device.device_name:
-                    logger.info(f"设备 {device.device_name} 已连接")
                     real_device = DeviceFactory.create_device(device)
+                    device.stop_listening()
+                    real_device.start_listening()
                     self.add_device(real_device)
+                    logger.info(f"设备[{device.device_name}]已连接，设备类型为：{hex(real_device.device_type)}")
                     break
             
         
@@ -102,20 +106,20 @@ class DeviceContainer(object):
         if device is None or device.device_no is None:
             logger.warning("无效的设备")
             
-        self._devices.update({device.device_no: device})
-        logger.debug(f"add_device {device.device_no} then has devices {self._devices}")
+        self._devices[device.device_no] = device
+        logger.info(f"添加设备[{device.device_no}]到设备列表，已连接设备数量：{len(self._devices)}")
         
-        self._broadcaster.remove_device(device.device_no)
-        logger.debug(f"add_device {device.device_no} then has broadcaster {self._broadcaster}")
+        # 标记设备为已连接
+        self._broadcaster.mark_device_as_connected(device.device_no)
         
-    def get_device(self, device_id=None)->IDevice:
-        logger.trace(f"已连接设备数量:{len(self._devices)}")
+    def get_device(self, device_no:str=None)->IDevice:
+        logger.info(f"已连接设备数量:{len(self._devices)}")
         if len(self._devices) == 0:
             return None
         
         # 未指定device_id，返回第一个设备
-        if device_id is None:
+        if device_no is None:
             return list(self._devices.values())[0]
         
-        return self._devices.get(device_id)
+        return self._devices.get(device_no, None)
             

qlsdk/rsc/network/discover.py

@@ -5,6 +5,11 @@ from loguru import logger
 
 from qlsdk.core.message import UDPMessage
 
+'''
+    广播器类，用于发送和接收设备广播消息
+    主要功能：发送设备搜索消息，接收设备连接消息
+    注意：广播端口需要和ar4sdk做区分，使用54366时不能和x8同时使用
+'''
 class UdpBroadcaster:
     # 广播端口需要和ar4sdk做区分， 使用54366时不能和x8同时使用
     def __init__(self, port=54366):
@@ -18,70 +23,54 @@ class UdpBroadcaster:
         self.sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
         self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
 
+    # 添加设备序列号到待广播列表
     def add_device(self, device_id):
-        """添加设备序列号到待广播列表"""
+        
         with self.lock:
             if device_id not in self.devices_to_broadcast:
                 self.devices_to_broadcast.append(device_id)
-                logger.info(f"Added device {device_id} to broadcast list.")
+                logger.info(f"添加设备[{device_id}]到搜索列表。")
 
+    # 从待广播列表移除设备序列号
     def remove_device(self, device_id):
-        """从待广播列表中移除设备序列号"""
+        
         with self.lock:
             if device_id in self.devices_to_broadcast:
                 self.devices_to_broadcast.remove(device_id)
-                logger.info(f"Removed device {device_id} from broadcast list.")
+                logger.info(f"把设备[{device_id}]从搜索列表中移除。")
 
+    # 把设备标记为已连接
     def mark_device_as_connected(self, device_id):
-        """将设备标记为已连接，并从未广播列表中移除"""
         with self.lock:
+            # 如果设备已连接，则从搜索列表中移除
             if device_id in self.devices_to_broadcast:
                 self.devices_to_broadcast.remove(device_id)
+                
+            # 添加到已连接设备集合
             self.connected_devices.add(device_id)
-            logger.info(f"Device {device_id} is now connected.")
+            
+            logger.info(f"设备[{device_id}]已连接，从搜索列表中移除。")
 
+    # 广播设备信息，寻求配对
     def broadcast_devices(self):
-        """轮询发送广播"""
+        
         while self.running:
             with self.lock:
                 for device_id in self.devices_to_broadcast:
                     message = UDPMessage.search(device_id)
                     self.sock.sendto(message, ('<broadcast>', self.broadcast_port))
-                    logger.info(f"Broadcasting device ID: {device_id}")
-            time.sleep(1)  # 每隔1秒发送一次广播
+                    logger.debug(f"设备[{device_id}]广播消息已发送。")
+                
+            # 每隔1秒发送一次广播    
+            time.sleep(1)  
 
     def start(self):
         """启动广播线程"""
-        self.broadcast_thread = Thread(target=self.broadcast_devices)
-        self.broadcast_thread.setDaemon(True)
+        self.broadcast_thread = Thread(target=self.broadcast_devices, daemon=True)
         self.broadcast_thread.start()
 
     def stop(self):
         """停止广播"""
         self.running = False
         self.broadcast_thread.join()
-        self.sock.close()
-
-# 示例使用
-if __name__ == "__main__":
-    broadcaster = UdpBroadcaster()
-
-    # 添加设备序列号到待广播列表
-    broadcaster.add_device_to_broadcast("390024130032")
-
-    # 启动广播
-    broadcaster.start()
-
-    try:
-        # 模拟运行一段时间
-        time.sleep(10)
-
-        # 标记设备为已连接
-        broadcaster.mark_device_as_connected("390024130032")
-
-        # 继续运行一段时间
-        time.sleep(10)
-
-    finally:
-        # 停止广播
-        broadcaster.stop()
+        self.sock.close()