yostlabs 2025.10.29.1__py3-none-any.whl → 2025.10.29.2__py3-none-any.whl

yostlabs/communication/bluetooth.py

@@ -2,6 +2,8 @@ from yostlabs.communication.socket import ThreespaceSocketComClass
 import bluetooth
 import time
 import threading
+import sys
+import math
 
 from dataclasses import dataclass
 from typing import Callable, Generator
@@ -94,17 +96,21 @@ class ScannerResult:
 
 class Scanner:
 
-    def __init__(self, interval=5):
+    def __init__(self, desired_scan_time=5):
         self.enabled = False
         self.done = True
 
-        self.nearby = None
-        self.thread = None
-        self.updated = False
-        self.duration = int(interval / 1.2)
+        self.continous = False      #If true, will constantly update the nearby devices
+        self.execute = False        #Set to true to trigger a read when not in continous mode
+        self.nearby = None          #The list of nearby devices
+        self.thread = None          #The thread running the asynchronous scanner
+        self.updated = False        #Set to true when self.nearby has been updated
+        self.duration = math.ceil(desired_scan_time / 1.28) * 1.28  #The time, in second, each scan lasts. Scanning is in 1.28 second intervals, so this may differ from the desired scan time
 
     def start(self):
-        if not self.done: return
+        if not self.done:
+            self.execute = True
+            return
         self.thread = threading.Thread(target=self.process, daemon=True)
         self.enabled = True
         self.done = False
@@ -114,6 +120,9 @@ class Scanner:
     def stop(self):
         self.enabled = False
 
+    def set_continous(self, continous: bool):
+        self.continous = continous
+
     def get_most_recent(self):
         if not self.updated: return None
         self.updated = False
@@ -125,20 +134,57 @@ class Scanner:
 
     def process(self):
         while self.enabled:
-            nearby = bluetooth.discover_devices(duration=self.duration, lookup_names=True, lookup_class=True)
+            if not self.continous and not self.execute: continue
+            nearby = bluetooth.discover_devices(duration=math.ceil(self.duration/1.28), lookup_names=True, lookup_class=True)
             self.nearby = [ScannerResult(addr, name, decode_class_of_device(cod)) for addr, name, cod in nearby]
+            self.execute = False
             self.updated = True
         self.done = True
 
+if sys.platform == "win32":
+    import ctypes
+    from ctypes import wintypes
+
+    # Define BLUETOOTH_ADDRESS structure
+    class BLUETOOTH_ADDRESS(ctypes.Structure):
+        _fields_ = [("rgBytes", ctypes.c_byte * 6)]
+
+    # Load Bluetooth API
+    win_bluetooth = ctypes.WinDLL("BluetoothAPIs.dll")
+
+    # Define function prototype
+    BluetoothRemoveDevice = win_bluetooth.BluetoothRemoveDevice
+    BluetoothRemoveDevice.argtypes = [ctypes.POINTER(BLUETOOTH_ADDRESS)]
+    BluetoothRemoveDevice.restype = wintypes.BOOL
+
+    def remove_device(mac_address: str):
+        # Convert MAC string "XX:XX:XX:XX:XX:XX" -> bytes reversed
+        addr_bytes = bytes.fromhex(mac_address.replace(":", ""))[::-1]
+        addr = BLUETOOTH_ADDRESS()
+        ctypes.memmove(addr.rgBytes, addr_bytes, 6)
+
+        err = BluetoothRemoveDevice(ctypes.byref(addr))
+        print("Remove device status:", err)
+        if not err:
+            print(f"Successfully removed device {mac_address}")
+        else:
+            if err == 1168:  # ERROR_NOT_FOUND
+                print(f"Device {mac_address} not found or already unpaired.")
+            else:
+                print(f"Failed to remove device {mac_address}. Error code: {err}")
+else:
+    def remove_device(mac_address: str):
+        raise NotImplementedError("Only implemented on windows")
+
 class ThreespaceBluetoothComClass(ThreespaceSocketComClass):
 
-    SCANNER = None
+    SCANNER: Scanner = None
 
     def __init__(self, addr: str, name: str = None, connection_timeout=None):
         super().__init__(bluetooth.BluetoothSocket(bluetooth.Protocols.RFCOMM), (addr, 1), connection_timeout=connection_timeout)
         self.address = addr
         self.__name = name or addr
-    
+
     @property
     def name(self) -> str:
         return self.__name
@@ -149,6 +195,11 @@ class ThreespaceBluetoothComClass(ThreespaceSocketComClass):
             cls.SCANNER = Scanner()
             cls.SCANNER.start()
 
+    @classmethod
+    def set_scanner_continous(cls, continous: bool):
+        cls.__lazy_init_scanner()
+        cls.SCANNER.set_continous(continous)
+
     @staticmethod
     def __default_filter(result: ScannerResult):
         return result.class_of_device.major_class == "Wearable" and result.class_of_device.minor_class == "Minor code 0"
@@ -162,6 +213,7 @@ class ThreespaceBluetoothComClass(ThreespaceSocketComClass):
         cls.__lazy_init_scanner()
         if filter is None: 
             filter = cls.__default_filter
+        cls.SCANNER.start()
         if wait_for_update:
             cls.SCANNER.updated = False
             while not cls.SCANNER.updated: time.sleep(0.1)
@@ -171,6 +223,18 @@ class ThreespaceBluetoothComClass(ThreespaceSocketComClass):
             name = device_info.name or None
             yield ThreespaceBluetoothComClass(device_info.address, name)
 
+    @staticmethod
+    def unpair(address: str):
+        """
+        It is recommended to call this after done with a ThreespaceBluetoothComClass object
+        so that windows will not report the device as still being available when powered off.
+        This occurs because windows Bluetooth detect functions report nearby devices & paired devices,
+        regardless of their power status. By removing the device from the list of paired devices, auto detect
+        will only report actual nearby and powered devices.
+        EX: ThreespaceBluetoothComClass.unpair(com.address)
+        """
+        remove_device(address)
+
 
 if __name__ == "__main__":
     from yostlabs.tss3.api import ThreespaceSensor

{yostlabs-2025.10.29.1.dist-info → yostlabs-2025.10.29.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yostlabs
-Version: 2025.10.29.1
+Version: 2025.10.29.2
 Summary: Python resources and API for 3Space sensors from Yost Labs Inc.
 Project-URL: Homepage, https://yostlabs.com/
 Project-URL: Repository, https://github.com/YostLabs/3SpacePythonPackage/tree/main

{yostlabs-2025.10.29.1.dist-info → yostlabs-2025.10.29.2.dist-info}/RECORD

@@ -2,7 +2,7 @@ yostlabs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 yostlabs/communication/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 yostlabs/communication/base.py,sha256=ahAIQndfo9ifX6Lf2NeEaHpIhRJ_uBv6jv9P7N3Rbhg,2884
 yostlabs/communication/ble.py,sha256=3hMnIbmKU0srpFmZyhzkXjHlRb3yX1D9aOO1uKKAhFA,19794
-yostlabs/communication/bluetooth.py,sha256=xuENquGbc28QIfvHejSs_DwIeAZCIKxL2t9ba-aZOlU,6271
+yostlabs/communication/bluetooth.py,sha256=GuqCRauGxOt0smh9qLA1NCfs7s5onZJjngXZsVuq5pc,9212
 yostlabs/communication/serial.py,sha256=Ex41l3ePXWrZDF8ZGxWoQs1tR0yfwZaSdG7a597zBsA,6505
 yostlabs/communication/socket.py,sha256=mZw_9-5teIPUMxLXQh7kVLu6CJxCNFC7a9CnhSAI2Og,3822
 yostlabs/math/__init__.py,sha256=JFzsPQ4AbsX1AH1brBpn1c_Pa_ItF43__D3mlPvA2a4,34
@@ -17,7 +17,7 @@ yostlabs/tss3/utils/calibration.py,sha256=J7RnY23MUUo4lmfapHavUqrTArFo4PxGKw68sL
 yostlabs/tss3/utils/parser.py,sha256=ij_kQpB3EukOq3O8wQTYhkqBP-OneiHMUcsHLuL6m-8,11347
 yostlabs/tss3/utils/streaming.py,sha256=G2OjSIL9zub0EbkgDGDWaqSXoRY6MJzMD4mazWOCUOA,22419
 yostlabs/tss3/utils/version.py,sha256=NT2H9l-oIRCYhV_yjf5UjkadoJQ0IN4eLl8y__pyTPc,3001
-yostlabs-2025.10.29.1.dist-info/METADATA,sha256=iOLa5qTNbhgUe5wLumLKPw4UBtJUIcc1Jwb8un9LLcs,2778
-yostlabs-2025.10.29.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-yostlabs-2025.10.29.1.dist-info/licenses/LICENSE,sha256=PtF8EXRlVhm1_ve52_3GHixSPwMn0tGajFxF3xKS-j0,1090
-yostlabs-2025.10.29.1.dist-info/RECORD,,
+yostlabs-2025.10.29.2.dist-info/METADATA,sha256=PYSyY8PEl5MCKO8oifmd2GHPjyzpNtwn8OW5z9gyD8Y,2778
+yostlabs-2025.10.29.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+yostlabs-2025.10.29.2.dist-info/licenses/LICENSE,sha256=PtF8EXRlVhm1_ve52_3GHixSPwMn0tGajFxF3xKS-j0,1090
+yostlabs-2025.10.29.2.dist-info/RECORD,,