sensor-sdk 0.0.69__tar.gz → 0.0.71__tar.gz

{sensor_sdk-0.0.69/sensor_sdk.egg-info → sensor_sdk-0.0.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sensor-sdk
-Version: 0.0.69
+Version: 0.0.71
 Summary: Python sdk for Synchroni
 Home-page: https://github.com/oymotion/SynchroniSDKPython
 Author: Martin Ye

{sensor_sdk-0.0.69 → sensor_sdk-0.0.71}/sensor/bleak_process.py

@@ -96,7 +96,7 @@ class BleakProcess(multiprocessing.Process):
         self._gforce_event_loop = None
         self._gforce_event_thread = None
 
-    # 可被丢弃的消息类型：这些消息高频且允许丢失，队列满时直接丢弃最新的一条
+    # Message types that can be dropped when the result queue is full.
     _DROPABLE_MSG_TYPES = ("sensor_data", "devices", "scan_once_result", "error")
 
     def _publish(self, msg_type: str, **kwargs):
@@ -104,16 +104,16 @@ class BleakProcess(multiprocessing.Process):
         try:
             msg = {"type": msg_type, **kwargs}
 
-            # 对所有消息类型都做一层内存保护，防止子进程内部队列无限增长导致内存耗尽
+            # Memory guard: prevent the internal message queue from growing without bound.
             if self._msg_queue.qsize() > sensor_utils.BLEAK_RESULT_QUEUE_MAXSIZE:
                 if msg_type in self._DROPABLE_MSG_TYPES:
                     return
-                # 对于不可丢弃的消息，尝试丢弃一条最旧的可丢弃消息以腾出空间
+                # For non-droppable messages, try to evict one old droppable message.
                 try:
                     old_msg = self._msg_queue.get_nowait()
                     old_type = old_msg.get("type")
                     if old_type not in self._DROPABLE_MSG_TYPES:
-                        # 如果最旧的消息也不可丢弃，把它放回去
+                        # If the oldest message is also non-droppable, put it back.
                         self._msg_queue.put_nowait(old_msg)
                 except queue.Empty:
                     pass
@@ -123,7 +123,7 @@ class BleakProcess(multiprocessing.Process):
             try:
                 self._msg_queue.put_nowait(msg)
             except queue.Full:
-                # 如果队列仍是满的，对不可丢弃的消息使用短时阻塞 put，避免重要消息丢失
+                # If still full, use a short blocking put for important messages.
                 if msg_type not in self._DROPABLE_MSG_TYPES:
                     try:
                         self._msg_queue.put(msg, timeout=1.0)
@@ -142,12 +142,12 @@ class BleakProcess(multiprocessing.Process):
                 if msg_type in self._DROPABLE_MSG_TYPES:
                     self.result_queue.put_nowait(msg)
                 else:
-                    # 退出时重要消息只等待较短时间，避免子进程无法正常结束
+                    # Use a short timeout during shutdown so the child process can exit cleanly.
                     self.result_queue.put(msg, timeout=2.0)
             except queue.Empty:
                 break
             except queue.Full:
-                # 队列满时丢弃一条最旧的可丢弃消息，给重要消息腾出空间
+                # Drop one old droppable message to make room for important messages.
                 try:
                     old_msg = self._msg_queue.get_nowait()
                     old_type = old_msg.get("type")
@@ -161,7 +161,7 @@ class BleakProcess(multiprocessing.Process):
                 break
 
     async def _publisher_task(self):
-        # 用于限制 "Result queue is full" 的打印频率，避免在 Windows 上大量输出阻塞 stdout
+        # Throttle queue-full logs to avoid blocking stdout on Windows.
         _last_queue_full_log = 0.0
 
         while True:
@@ -173,7 +173,7 @@ class BleakProcess(multiprocessing.Process):
                 if msg_type in self._DROPABLE_MSG_TYPES:
                     self.result_queue.put_nowait(msg)
                 else:
-                    # 重要消息使用较短 timeout，避免 publisher_task 长期阻塞
+                    # Use a short timeout for important messages so the publisher does not stall.
                     self.result_queue.put(msg, timeout=2.0)
             except queue.Empty:
                 if self._should_exit:
@@ -182,15 +182,15 @@ class BleakProcess(multiprocessing.Process):
             except queue.Full as e:
                 if msg is not None:
                     if msg_type not in self._DROPABLE_MSG_TYPES:
-                        # 重要消息重新放回队列头部，稍后重试
+                        # Put important messages back so they can be retried later.
                         try:
                             self._msg_queue.put_nowait(msg)
                         except queue.Full:
                             pass
                     else:
-                        # 可丢弃消息直接丢弃，避免内存无限增长
+                        # Droppable messages are discarded to avoid unbounded memory growth.
                         pass
-                # 每 2 秒最多打印一次，避免队列满时刷屏阻塞 stdout
+                # Log at most once every 2 seconds to prevent stdout flooding.
                 now = time.time()
                 if now - _last_queue_full_log >= 2.0:
                     _last_queue_full_log = now

{sensor_sdk-0.0.69 → sensor_sdk-0.0.71}/sensor/gforce.py

@@ -157,6 +157,8 @@ class DataSubscription(IntEnum):
     # Device Log On
     LOG = (0x00000800,)
 
+    DNF_TYPE_GEST_EXT = (0x00001000,)
+
     DNF_MAG_ANGLE_EXT = (0x00002000,)
     
     DNF_EEG = (0x00010000,)
@@ -505,8 +507,8 @@ class GForce:
         try:
             q.put_nowait(bytes(bs))
         except queue.Full:
-            # 队列满时只丢弃最旧的一部分数据，而不是全部清空，
-            # 避免一次性丢失过多原始数据包
+            # Drop only a few oldest items instead of clearing the whole queue
+            # to avoid losing too many raw data packets at once.
             dropped = 0
             while dropped < 16 and not q.empty():
                 try:
@@ -579,7 +581,7 @@ class GForce:
         try:
             q.put_nowait(bytes(bs))
         except queue.Full:
-            # 队列满时只丢弃最旧的一部分数据，而不是全部清空
+            # Drop only a few oldest items instead of clearing the whole queue.
             dropped = 0
             while dropped < 16 and not q.empty():
                 try:

{sensor_sdk-0.0.69 → sensor_sdk-0.0.71}/sensor/sensor_data.py

@@ -1,105 +1,103 @@
-from enum import Enum, IntEnum
-from typing import Dict, List
-
-
-
-
-class Sample:
-    # """
-    # Initialize a Sample instance.
-
-
-
-
-
-
-    # """
-    # def __init__(self, data: int, impedance: int, saturation: int, sample_index: int, is_lost: bool):
-    #     self.data = data
-    #     self.impedance = impedance
-    #     self.saturation = saturation
-    #     self.sampleIndex = sample_index
-    #     self.isLost = is_lost
-
-    def __init__(self):
-        self.rawData = 0
-        self.data = 0
-        self.impedance = 0
-        self.saturation = 0
-        self.sampleIndex = 0
-        self.isLost = False
-        self.timeStampInMs = 0
-        self.channelIndex = 0
-
-
-
-
-class DataType(IntEnum):
-    NTF_ACC = 0x1
-    NTF_GYRO = 0x2
-    NTF_EULER_DATA = 0x4
-    NTF_QUATERNION = 0x5
-    NTF_EMG = 0x8
-    NTF_MAG_ANGLE_DATA = 0x0D
-    NTF_EEG = 0x10
-    NTF_ECG = 0x11
-    NTF_IMPEDANCE = 0x12
-    NTF_IMU = 0x13
-    NTF_ADS = 0x14
-    NTF_BRTH = 0x15
-    NTF_IMPEDANCE_EXT = 0x16
-    NTF_PPG = 0x18
-    NTF_SPO2 = 0x17
-
-
-
-
-
-class SensorData:
-    # """
-    # Initialize a SensorData instance.
-
-    # :param device_mac: The MAC address of the device.
-    # :param data_type: The type of data being collected.
-    # :param sample_rate: The rate at which samples are collected.
-    # :param channel_count: The number of channels in the data.
-    # :param package_sample_count: The number of samples in the package.
-    # :param channel_samples: A list of lists containing the sample data for each channel.
-    # """
-    # def __init__(self, device_mac: str, data_type: DataType, sample_rate: int, channel_count: int,
-    #              package_sample_count: int, channel_samples: List[List[Sample]]):
-    #     self.deviceMac = device_mac
-    #     self.dataType = data_type
-    #     self.sampleRate = sample_rate
-    #     self.channelCount = channel_count
-    #     self.packageSampleCount = package_sample_count
-    #     self.channelSamples = channel_samples
-    #     self.lastPackageCounter = 0
-    #     self.lastPackageIndex = 0
-    #     self.resolutionBits = 0
-    #     self.channelMask = 0
-    #     self.minPackageSampleCount = 0
-    #     self.K = 0
-
-    def __init__(self):
-        self.deviceMac = ""
-        self.dataType = DataType.NTF_EEG
-        self.sampleRate = 0
-        self.channelCount = 0
-        self.packageSampleCount = 0
-        self.packageIndexLength = 2
-        self.channelSamples: List[List[Sample]] = list()
-        self.lastPackageCounter = 0
-        self.lastPackageIndex = 0
-        self.lostPackageCount = 0
-        self.resolutionBits = 0
-        self.resolutionSigned = 0
-        self.channelMask = 0
-        self.minPackageSampleCount = 0
-        self.K = 0
-
-    def clear(self):
-        self.channelSamples.clear()
-        self.lastPackageCounter = -1
-        self.lastPackageIndex = 0
-        self.lostPackageCount = 0
+from enum import Enum, IntEnum
+from typing import Dict, List
+
+
+
+
+class Sample:
+    # """
+    # Initialize a Sample instance.
+
+
+
+
+
+
+    # """
+    # def __init__(self, data: int, impedance: int, saturation: int, sample_index: int, is_lost: bool):
+    #     self.data = data
+    #     self.impedance = impedance
+    #     self.saturation = saturation
+    #     self.sampleIndex = sample_index
+    #     self.isLost = is_lost
+
+    def __init__(self):
+        self.rawData = 0
+        self.data = 0
+        self.impedance = 0
+        self.saturation = 0
+        self.sampleIndex = 0
+        self.isLost = False
+        self.timeStampInMs = 0
+        self.channelIndex = 0
+
+
+
+
+class DataType(IntEnum):
+    NTF_ACC = 0x1
+    NTF_GYRO = 0x2
+    NTF_EULER_DATA = 0x4
+    NTF_QUATERNION = 0x5
+    NTF_GEST = 0x07
+    NTF_EMG = 0x8
+    NTF_MAG_ANGLE_DATA = 0x0D
+    NTF_EEG = 0x10
+    NTF_ECG = 0x11
+    NTF_IMPEDANCE = 0x12
+    NTF_IMU = 0x13
+    NTF_ADS = 0x14
+    NTF_BRTH = 0x15
+    NTF_IMPEDANCE_EXT = 0x16
+    NTF_SPO2 = 0x17
+    NTF_PPG = 0x18
+
+
+class SensorData:
+    # """
+    # Initialize a SensorData instance.
+
+    # :param device_mac: The MAC address of the device.
+    # :param data_type: The type of data being collected.
+    # :param sample_rate: The rate at which samples are collected.
+    # :param channel_count: The number of channels in the data.
+    # :param package_sample_count: The number of samples in the package.
+    # :param channel_samples: A list of lists containing the sample data for each channel.
+    # """
+    # def __init__(self, device_mac: str, data_type: DataType, sample_rate: int, channel_count: int,
+    #              package_sample_count: int, channel_samples: List[List[Sample]]):
+    #     self.deviceMac = device_mac
+    #     self.dataType = data_type
+    #     self.sampleRate = sample_rate
+    #     self.channelCount = channel_count
+    #     self.packageSampleCount = package_sample_count
+    #     self.channelSamples = channel_samples
+    #     self.lastPackageCounter = 0
+    #     self.lastPackageIndex = 0
+    #     self.resolutionBits = 0
+    #     self.channelMask = 0
+    #     self.minPackageSampleCount = 0
+    #     self.K = 0
+
+    def __init__(self):
+        self.deviceMac = ""
+        self.dataType = DataType.NTF_EEG
+        self.sampleRate = 0
+        self.channelCount = 0
+        self.packageSampleCount = 0
+        self.packageIndexLength = 2
+        self.channelSamples: List[List[Sample]] = list()
+        self.lastPackageCounter = 0
+        self.lastPackageIndex = 0
+        self.lostPackageCount = 0
+        self.resolutionBits = 0
+        self.resolutionSigned = 0
+        self.channelMask = 0
+        self.minPackageSampleCount = 0
+        self.K = 0
+
+    def clear(self):
+        self.channelSamples.clear()
+        self.lastPackageCounter = -1
+        self.lastPackageIndex = 0
+        self.lostPackageCount = 0