usbbluetooth 0.0.6__tar.gz

usbbluetooth-0.0.6/.gitignore

@@ -0,0 +1,8 @@
+# Python
+*.egg-info
+__pycache__
+
+# Project files
+usbbluetooth/lib/*.dll
+usbbluetooth/lib/*.so
+usbbluetooth/lib/*.dylib

usbbluetooth-0.0.6/MANIFEST.in

@@ -0,0 +1 @@
+include usbbluetooth/lib/*.dll usbbluetooth/lib/*.so usbbluetooth/lib/*.dylib

usbbluetooth-0.0.6/PKG-INFO

@@ -0,0 +1,3 @@
+Metadata-Version: 2.2
+Name: usbbluetooth
+Version: 0.0.6

usbbluetooth-0.0.6/meson.build

@@ -0,0 +1,11 @@
+python3 = import('python').find_installation('python3', required: false)
+
+if not python3.found()
+    warning('Python bindings are disabled because Python 3 could not be found')
+else
+    custom_target('usbbluetooth_python',
+        build_by_default: false,
+        install: false,
+        command: [python3, '-m', 'build', meson.current_source_dir(), '-o', meson.current_build_dir()],
+        output: ['usbbluetooth-'+meson.project_version()+'.tar.gz', 'usbbluetooth-'+meson.project_version()+'-py3-none-any.whl'])
+endif

usbbluetooth-0.0.6/pyproject.toml

@@ -0,0 +1,11 @@
+[build-system]
+requires = ["setuptools>=64", "setuptools_scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "usbbluetooth"
+dynamic = ["version"]
+dependencies = []
+
+[tool.setuptools_scm]
+root = "../../../"

usbbluetooth-0.0.6/setup.cfg

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

usbbluetooth-0.0.6/usbbluetooth/__init__.py

@@ -0,0 +1,4 @@
+#!/usr/bin/env python
+
+from usbbluetooth.core import UsbBluetoothDevice, list_devices, set_log_level
+from usbbluetooth.log import LogLevel

usbbluetooth-0.0.6/usbbluetooth/_c_library.py

@@ -0,0 +1,97 @@
+#!/usr/bin/env python
+
+import sys
+import ctypes
+from enum import IntEnum
+from importlib.resources import files
+
+
+def _lib_name() -> str:
+    '''
+    Returns an string with the expected library name for the current platform.
+    '''
+    lib_names = {
+        'darwin': 'libusbbluetooth.dylib',
+        'win32': 'libusbbluetooth.dll',
+        'linux': 'libusbbluetooth.so'
+    }
+    return lib_names.get(sys.platform, 'libusbbluetooth.so')
+
+
+def _load_lib():
+    '''
+    Attempt to load a library from package resources.
+    '''
+    library_path = files('usbbluetooth.lib').joinpath(_lib_name())
+    try:
+        return ctypes.cdll.LoadLibrary(str(library_path))
+    except OSError as e:
+        print(e)
+        return None
+
+
+# Attempt to load the corresponding C library...
+_lib = _load_lib()
+if _lib is None:
+    raise ImportError(
+        "ERROR: Failed to load the dynamic library for usbbluetooth.")
+
+
+class _CStatus(IntEnum):
+    OK = 0
+    ERR_UNK = -1,
+    ERR_NOMEM = -2,
+    ERR_DEVICE_CLOSED = -3,
+
+
+class _CDevice(ctypes.Structure):
+    _fields_ = (("ref_count", ctypes.c_uint8),
+                ("type", ctypes.c_int),
+                ("device", ctypes.c_voidp),
+                ("context", ctypes.c_voidp))
+
+
+def _setup_func(lib, fname, restype, argtypes) -> None:
+    '''
+    Setup function type info. Export as global.
+    '''
+    try:
+        method = getattr(lib, fname)
+        method.restype = restype
+        method.argtypes = argtypes
+        globals()[fname] = method
+    except AttributeError:
+        raise ImportError(
+            f"ERROR: Fail to setup '{fname}' function prototype. Make sure you are loading the correct library version.")
+
+
+# Actual function prototypes...
+_setup_func(_lib, "usbbluetooth_init", _CStatus, None)
+_setup_func(_lib, "usbbluetooth_exit", None, None)
+_setup_func(_lib, "usbbluetooth_get_device_list", _CStatus,
+            [ctypes.POINTER(ctypes.POINTER(ctypes.POINTER(_CDevice)))])
+_setup_func(_lib, "usbbluetooth_free_device_list", None,
+            [ctypes.POINTER(ctypes.POINTER(ctypes.POINTER(_CDevice)))])
+_setup_func(_lib, "usbbluetooth_reference_device", ctypes.POINTER(_CDevice),
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_unreference_device", None,
+            [ctypes.POINTER(ctypes.POINTER(_CDevice))])
+_setup_func(_lib, "usbbluetooth_device_vid_pid", None,
+            [ctypes.POINTER(_CDevice), ctypes.POINTER(ctypes.c_uint16), ctypes.POINTER(ctypes.c_uint16)])
+_setup_func(_lib, "usbbluetooth_device_manufacturer", ctypes.c_char_p,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_device_product", ctypes.c_char_p,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_device_serial_num", ctypes.c_char_p,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_device_description", ctypes.c_char_p,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_open", _CStatus,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_close", None,
+            [ctypes.POINTER(_CDevice)])
+_setup_func(_lib, "usbbluetooth_write", _CStatus,
+            [ctypes.POINTER(_CDevice), ctypes.POINTER(ctypes.c_uint8), ctypes.c_uint16])
+_setup_func(_lib, "usbbluetooth_read", _CStatus,
+            [ctypes.POINTER(_CDevice), ctypes.POINTER(ctypes.c_uint8), ctypes.POINTER(ctypes.c_uint16)])
+_setup_func(_lib, "usbbluetooth_log_set_level", None, [ctypes.c_int])

usbbluetooth-0.0.6/usbbluetooth/core.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python
+
+import ctypes
+from usbbluetooth import _c_library
+from usbbluetooth.log import LogLevel
+
+
+def _check_status(status: _c_library._CStatus):
+    '''
+    Check an status and raise error if needed
+    '''
+    if status == _c_library._CStatus.OK:
+        return
+    elif status == _c_library._CStatus.ERR_UNK:
+        raise Exception("Unknown error!")
+    elif status == _c_library._CStatus.ERR_NOMEM:
+        raise Exception("Out of memory error!")
+    elif status == _c_library._CStatus.ERR_DEVICE_CLOSED:
+        raise Exception("Device closed!")
+    else:
+        raise Exception("Undocumented error!")
+
+
+class _UsbBluetoothContext():
+    '''
+    Handle USB context creation and destruction.
+    '''
+
+    def __init__(self):
+        _check_status(_c_library.usbbluetooth_init())
+
+    def __del__(self):
+        _c_library.usbbluetooth_exit()
+
+
+class UsbBluetoothDevice():
+    '''
+    USB Bluetooth device.
+    '''
+
+    def __init__(self, ctx: _UsbBluetoothContext, dev: ctypes.POINTER(_c_library._CDevice)):
+        self._ctx = ctx
+        self._dev = _c_library.usbbluetooth_reference_device(dev)
+
+    def __del__(self):
+        _c_library.usbbluetooth_unreference_device(ctypes.byref(self._dev))
+
+    def open(self):
+        _check_status(_c_library.usbbluetooth_open(self._dev))
+
+    def close(self):
+        _c_library.usbbluetooth_close(self._dev)
+
+    def __enter__(self):
+        self.open()
+        return self
+
+    def __exit__(self, type, value, tb):
+        self.close()
+
+    def __repr__(self):
+        return f"UsbBluetoothDevice[{self.get_description()}]"
+
+    def write(self, data: bytearray):
+        _check_status(_c_library.usbbluetooth_write(
+            self._dev, ctypes.cast(ctypes.c_char_p(data), ctypes.POINTER(ctypes.c_uint8)), len(data)))
+
+    def read(self, bufsize=64):
+        data = (ctypes.c_uint8 * bufsize)()
+        datalen = ctypes.c_uint16(bufsize)
+        _check_status(_c_library.usbbluetooth_read(self._dev, data, datalen))
+        return bytearray(data[0:datalen.value])
+
+    def get_vid_pid(self) -> tuple[int, int]:
+        vid = ctypes.c_uint16()
+        pid = ctypes.c_uint16()
+        _c_library.usbbluetooth_device_vid_pid(
+            self._dev, ctypes.byref(vid), ctypes.byref(pid))
+        return (vid.value, pid.value)
+
+    def get_manufacturer(self) -> str:
+        manuf_c = _c_library.usbbluetooth_device_manufacturer(self._dev)
+        ret = manuf_c.decode() if manuf_c else None
+        return ret
+
+    def get_product(self) -> str:
+        prod_c = _c_library.usbbluetooth_device_product(self._dev)
+        ret = prod_c.decode() if prod_c else None
+        return ret
+
+    def get_serial_num(self) -> str:
+        sn_c = _c_library.usbbluetooth_device_serial_num(self._dev)
+        ret = sn_c.decode() if sn_c else None
+        return ret
+
+    def get_description(self) -> str:
+        desc_c = _c_library.usbbluetooth_device_description(self._dev)
+        ret = desc_c.decode() if desc_c else None
+        return ret
+
+
+def list_devices() -> list[UsbBluetoothDevice]:
+    '''
+    List all available Bluetooth devices.
+    '''
+    ctx = _UsbBluetoothContext()
+    c_list = ctypes.POINTER(ctypes.POINTER(_c_library._CDevice))()
+    dev_list = []
+    _check_status(_c_library.usbbluetooth_get_device_list(
+        ctypes.byref(c_list)))
+    i = 0
+    while True:
+        dev_ref = c_list[i]
+        i += 1
+        if not dev_ref:
+            break
+        dev_list.append(UsbBluetoothDevice(ctx, dev_ref))
+    _c_library.usbbluetooth_free_device_list(ctypes.byref(c_list))
+    return dev_list
+
+
+def set_log_level(level: LogLevel):
+    _c_library.usbbluetooth_log_set_level(level.value)

usbbluetooth-0.0.6/usbbluetooth/log.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python
+
+from enum import IntEnum
+
+
+class LogLevel(IntEnum):
+    NONE = 0
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4

usbbluetooth-0.0.6/usbbluetooth.egg-info/PKG-INFO

@@ -0,0 +1,3 @@
+Metadata-Version: 2.2
+Name: usbbluetooth
+Version: 0.0.6

usbbluetooth-0.0.6/usbbluetooth.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+.gitignore
+MANIFEST.in
+meson.build
+pyproject.toml
+usbbluetooth/__init__.py
+usbbluetooth/_c_library.py
+usbbluetooth/core.py
+usbbluetooth/log.py
+usbbluetooth.egg-info/PKG-INFO
+usbbluetooth.egg-info/SOURCES.txt
+usbbluetooth.egg-info/dependency_links.txt
+usbbluetooth.egg-info/top_level.txt
+usbbluetooth/lib/__init__.py
+usbbluetooth/lib/libusbbluetooth.dll
+usbbluetooth/lib/libusbbluetooth.dylib
+usbbluetooth/lib/libusbbluetooth.so

usbbluetooth-0.0.6/usbbluetooth.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

usbbluetooth-0.0.6/usbbluetooth.egg-info/top_level.txt

@@ -0,0 +1 @@
+usbbluetooth