dglab-controller-python 0.1.0__tar.gz

dglab_controller_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lindog114514
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dglab_controller_python-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: dglab-controller-python
+Version: 0.1.0
+Summary: 用于控制负鼠振动控制器以及读取灵猫和爪印传感器的 Python 库
+Author-email: lindog114514 <kaikaihe467@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/lindog114514/DGLAB-controller-python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bleak>=0.21.0
+Dynamic: license-file
+
+## DGLAB-controller-python
+
+DG-LAB 蓝牙设备的 Python SDK，基于 bleak。
+支持同时连接多个设备、异步事件处理，并通过 async with 自动管理连接。
+
+---
+支持的设备
+---
+
+灵猫边缘控制传感器(47L124000)
+
+负鼠振动控制器 (47L127000)
+
+爪印无线按钮传感器 (47L120300)
+
+
+---
+安装
+---
+```bash
+pip install DGLAB-controller-python
+```
+
+要求 Python 3.10+ 且 bleak ≥ 0.21。
+
+---
+快速开始
+---
+灵猫 – 气压上报
+
+```python
+import asyncio
+from dg_lab_devices import Civec
+
+async def main():
+    async with Civec() as civec:
+        @civec.on_pressure
+        def on_pressure(kpa: float):
+            print(f"气压: {kpa:.2f} kPa")
+
+        await civec.start_pressure_report(color=0x02)
+        await asyncio.sleep(30)
+
+asyncio.run(main())
+```
+
+负鼠 – 按键与强度
+
+```python
+from dg_lab_devices import Controller
+
+async def main():
+    async with Controller() as ctrl:
+        @ctrl.on_button
+        async def on_button(seq, buttons):
+            if buttons.get("A"):
+                await ctrl.set_strength(a=160)
+
+        await ctrl.set_led_and_report(enable_button_report=True)
+        await asyncio.sleep(60)
+
+asyncio.run(main())
+```
+
+爪印 – 触发模式
+
+```python
+from dg_lab_devices import PawPrints
+
+async def main():
+    async with PawPrints() as pp:
+        @pp.on_trigger
+        def on_trigger(color, event_id, param):
+            print(f"触发事件 {event_id}，参数={param}")
+
+        await pp.set_random_trigger(
+            color=0x01, event_id=5,
+            green_min=30, green_max=50,
+            reaction_time=10,
+            param_inc=20, param_speed=40,
+            param_dec=50, param_dec_speed=40
+        )
+        await asyncio.sleep(300)
+
+asyncio.run(main())
+```
+
+---
+主要特性
+---
+· **异步事件驱动** – 装饰器订阅设备通知
+
+· **自动连接管理** – async with 自动连接/断开
+
+· **多设备并发** – 同一事件循环同时运行多个设备
+
+· **完整协议支持** – 实现所有 BLE 指令与回调
+
+---
+开源许可
+---
+本项目使用 MIT 许可证。
+
+---
+联系作者 
+---
+. QQ群:870333220 <del>有香香软软的小南娘和技术大佬<del>
+
+---
+相关链接
+---
+
+. [参考文档](https://github.com/dungeonlab-open/dglab-bluetooth-protocol)
+
+· [PyPI](https://pypi.org/project/DGLAB-controller-python/)
+
+· [API文档](docs/API.md)

dglab_controller_python-0.1.0/README.md

@@ -0,0 +1,117 @@
+## DGLAB-controller-python
+
+DG-LAB 蓝牙设备的 Python SDK，基于 bleak。
+支持同时连接多个设备、异步事件处理，并通过 async with 自动管理连接。
+
+---
+支持的设备
+---
+
+灵猫边缘控制传感器(47L124000)
+
+负鼠振动控制器 (47L127000)
+
+爪印无线按钮传感器 (47L120300)
+
+
+---
+安装
+---
+```bash
+pip install DGLAB-controller-python
+```
+
+要求 Python 3.10+ 且 bleak ≥ 0.21。
+
+---
+快速开始
+---
+灵猫 – 气压上报
+
+```python
+import asyncio
+from dg_lab_devices import Civec
+
+async def main():
+    async with Civec() as civec:
+        @civec.on_pressure
+        def on_pressure(kpa: float):
+            print(f"气压: {kpa:.2f} kPa")
+
+        await civec.start_pressure_report(color=0x02)
+        await asyncio.sleep(30)
+
+asyncio.run(main())
+```
+
+负鼠 – 按键与强度
+
+```python
+from dg_lab_devices import Controller
+
+async def main():
+    async with Controller() as ctrl:
+        @ctrl.on_button
+        async def on_button(seq, buttons):
+            if buttons.get("A"):
+                await ctrl.set_strength(a=160)
+
+        await ctrl.set_led_and_report(enable_button_report=True)
+        await asyncio.sleep(60)
+
+asyncio.run(main())
+```
+
+爪印 – 触发模式
+
+```python
+from dg_lab_devices import PawPrints
+
+async def main():
+    async with PawPrints() as pp:
+        @pp.on_trigger
+        def on_trigger(color, event_id, param):
+            print(f"触发事件 {event_id}，参数={param}")
+
+        await pp.set_random_trigger(
+            color=0x01, event_id=5,
+            green_min=30, green_max=50,
+            reaction_time=10,
+            param_inc=20, param_speed=40,
+            param_dec=50, param_dec_speed=40
+        )
+        await asyncio.sleep(300)
+
+asyncio.run(main())
+```
+
+---
+主要特性
+---
+· **异步事件驱动** – 装饰器订阅设备通知
+
+· **自动连接管理** – async with 自动连接/断开
+
+· **多设备并发** – 同一事件循环同时运行多个设备
+
+· **完整协议支持** – 实现所有 BLE 指令与回调
+
+---
+开源许可
+---
+本项目使用 MIT 许可证。
+
+---
+联系作者 
+---
+. QQ群:870333220 <del>有香香软软的小南娘和技术大佬<del>
+
+---
+相关链接
+---
+
+. [参考文档](https://github.com/dungeonlab-open/dglab-bluetooth-protocol)
+
+· [PyPI](https://pypi.org/project/DGLAB-controller-python/)
+
+· [API文档](docs/API.md)

dglab_controller_python-0.1.0/dg_lab_devices/__init__.py

@@ -0,0 +1,8 @@
+"""DG-LAB BLE 设备 Python SDK"""
+
+from .civec import Civec
+from .controller import Controller
+from .pawprints import PawPrints
+
+__version__ = "1.0.0"
+__all__ = ["Civec", "Controller", "PawPrints"]

dglab_controller_python-0.1.0/dg_lab_devices/base.py

@@ -0,0 +1,94 @@
+"""设备基类：BLE连接、事件注册/发射、通用命令"""
+import asyncio
+import logging
+from abc import ABC, abstractmethod
+from bleak import BleakClient, BleakScanner
+from bleak.exc import BleakError  # 新增
+from .common import CHAR_WRITE, CHAR_NOTIFY, CHAR_BATTERY, DeviceError
+
+logger = logging.getLogger(__name__)
+
+class BaseDevice(ABC):
+    """所有DG-LAB蓝牙设备的抽象基类"""
+
+    def __init__(self, address: str | None = None, name: str = ""):
+        self.address = address
+        self.name = name
+        self.client: BleakClient | None = None
+        self._event_handlers: dict[str, list] = {}
+
+    # ---------- 异步上下文管理器 ----------
+    async def __aenter__(self):
+        await self.connect()
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.disconnect()
+        return False
+
+    # ---------- 事件装饰器注册 ----------
+    def _register_event(self, event_name: str, func):
+        self._event_handlers.setdefault(event_name, []).append(func)
+        return func
+
+    async def _emit_event(self, event_name: str, *args):
+        for handler in self._event_handlers.get(event_name, []):
+            try:
+                if asyncio.iscoroutinefunction(handler):
+                    await handler(*args)
+                else:
+                    handler(*args)
+            except Exception as e:
+                logger.error(f"事件 {event_name} 回调异常: {e}")
+
+    # ---------- 连接管理 ----------
+    async def connect(self) -> None:
+        try:
+            if self.address is None:
+                device = await BleakScanner.find_device_by_name(self.name, timeout=5.0)
+                if device is None:
+                    raise DeviceError(f"未找到设备: {self.name}")
+                self.address = device.address
+            self.client = BleakClient(self.address)
+            await self.client.connect()
+        except BleakError as e:
+            msg = str(e).lower()
+            if any(keyword in msg for keyword in ("bluetooth", "adapter")) and \
+               any(keyword in msg for keyword in ("off", "disabled", "not available", "not found")):
+                raise DeviceError("蓝牙未开启，请打开蓝牙后重试") from e
+            raise DeviceError(f"连接失败: {e}") from e
+        except Exception as e:
+            raise DeviceError(f"设备连接异常: {e}") from e
+
+        # 连接成功后启动通知
+        await self.client.start_notify(CHAR_NOTIFY, self._on_main_notify)
+        try:
+            await self.client.start_notify(CHAR_BATTERY, self._on_battery_notify)
+        except Exception:
+            logger.debug("设备不支持电量通知，使用主动读取")
+        logger.info(f"已连接 {self.name} [{self.address}]")
+
+    async def disconnect(self) -> None:
+        if self.client and self.client.is_connected:
+            await self.client.disconnect()
+            logger.info(f"已断开 {self.name}")
+        self.client = None
+
+    @abstractmethod
+    async def _on_main_notify(self, sender, data: bytearray):
+        ...
+
+    async def _on_battery_notify(self, sender, data: bytearray):
+        if data:
+            await self._emit_event("battery", data[0])
+
+    async def _write_command(self, cmd: bytes):
+        if not self.client or not self.client.is_connected:
+            raise DeviceError("设备未连接")
+        await self.client.write_gatt_char(CHAR_WRITE, cmd, response=False)
+
+    async def get_battery(self) -> int:
+        if not self.client:
+            raise DeviceError("未连接")
+        data = await self.client.read_gatt_char(CHAR_BATTERY)
+        return data[0] if data else 0

dglab_controller_python-0.1.0/dg_lab_devices/civec.py

@@ -0,0 +1,33 @@
+"""灵猫边缘控制传感器 (Civec)"""
+from .base import BaseDevice
+import struct
+
+class Civec(BaseDevice):
+    def __init__(self, address: str = None, name: str = "47L124000"):
+        super().__init__(address, name)
+
+    def on_pressure(self, func):
+        return self._register_event("pressure", func)
+
+    def on_battery(self, func):
+        return self._register_event("battery", func)
+
+    async def _on_main_notify(self, sender, data: bytearray):
+        if len(data) >= 17 and data[0] == 0xD0:
+            raw = struct.unpack_from('<h', data, 8)[0]
+            await self._emit_event("pressure", raw / 100.0)
+
+    async def start_pressure_report(self, color: int = 0x01):
+        await self._write_command(bytes([0x50, color, 0xD0]) + b'\x00' * 14)
+
+    async def stop_pressure_report(self, color: int = 0x01):
+        await self._write_command(bytes([0x50, color, 0x00]) + b'\x00' * 14)
+
+    async def reset_pressure(self):
+        await self._write_command(bytes([0x66]) + b'\x00' * 9 + b'\x00\x02\x00')
+
+    async def flip_screen(self, current_rotate: int = 1) -> int:
+        new_rotate = 0x03 if current_rotate == 1 else 0x01
+        cmd = bytes([0x66]) + b'\x00' * 9 + bytes([new_rotate, 0x00, 0x00])
+        await self._write_command(cmd)
+        return new_rotate

dglab_controller_python-0.1.0/dg_lab_devices/common.py

@@ -0,0 +1,31 @@
+"""公共常量与工具"""
+import uuid
+
+_BASE_UUID_SUFFIX = "-0000-1000-8000-00805f9b34fb"
+
+def uuid16(short_id: int) -> uuid.UUID:
+    """将16位短ID转换为完整的128位蓝牙UUID"""
+    return uuid.UUID(f"0000{short_id:04x}{_BASE_UUID_SUFFIX}")
+
+# 标准蓝牙服务/特征
+SERVICE_DEVICE_INFO = uuid16(0x180A)
+CHAR_BATTERY = uuid16(0x1500)
+SERVICE_MAIN = uuid16(0x180C)
+CHAR_WRITE = uuid16(0x150A)
+CHAR_NOTIFY = uuid16(0x150B)
+
+# 颜色常量
+COLORS = {
+    0x00: "熄灭",
+    0x01: "黄色",
+    0x02: "红色",
+    0x03: "紫色",
+    0x04: "蓝色",
+    0x05: "青色",
+    0x06: "绿色",
+    0x07: "白色",
+}
+
+class DeviceError(Exception):
+    """设备相关异常"""
+    pass

dglab_controller_python-0.1.0/dg_lab_devices/controller.py

@@ -0,0 +1,59 @@
+"""负鼠振动控制器 (Controller)"""
+from .base import BaseDevice
+
+class Controller(BaseDevice):
+    def __init__(self, address: str = None, name: str = "47L127000"):
+        super().__init__(address, name)
+        self._button_map = [
+            "SEL_1", "SEL_2", "HOME", None, None, None, None, None,
+            "Up", "Down", "Left", "Right", "B", "A", "G", "D"
+        ]
+
+    def on_button(self, func):
+        return self._register_event("button", func)
+
+    def on_strength_change(self, func):
+        return self._register_event("strength", func)
+
+    def on_battery(self, func):
+        return self._register_event("battery", func)
+
+    async def _on_main_notify(self, sender, data: bytearray):
+        if len(data) >= 3 and data[0] == 0xB3:
+            await self._emit_event("strength", data[1], data[2])
+        elif len(data) >= 4 and data[0] == 0xD0:
+            seq = data[1]
+            state = (data[2] << 8) | data[3]
+            buttons = {}
+            for i, name in enumerate(self._button_map):
+                if name:
+                    buttons[name] = bool(state & (1 << (15 - i)))
+            await self._emit_event("button", seq, buttons)
+
+    async def set_led_and_report(self, color: int = 0x01, enable_button_report: bool = True):
+        mode = 0x01 if enable_button_report else 0x00
+        await self._write_command(bytes([0x50, color, mode]))
+
+    async def set_waveform(self, a_wave: list[int], b_wave: list[int]):
+        if len(a_wave) != 4 or len(b_wave) != 4:
+            raise ValueError("波形数据必须为4字节")
+        for v in a_wave + b_wave:
+            if not (0 <= v <= 100):
+                raise ValueError("波形强度超出0-100")
+        cmd = bytes([0xB0]) + b'\x00' * 7 + bytes(a_wave) + b'\x00' * 4 + bytes(b_wave)
+        await self._write_command(cmd)
+
+    async def set_strength(self, a: int | None = None, b: int | None = None):
+        def _byte(v):
+            return 0xFF if v is None else v
+        cmd = bytes([0xB3, _byte(a), _byte(b)])
+        await self._write_command(cmd)
+        # 同步屏幕显示
+        await self._sync_screen(a, b)
+
+    async def _sync_screen(self, a: int | None, b: int | None):
+        prefix = bytes.fromhex("FFFF00FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF0809")
+        a_byte = a if a is not None else 0xFF
+        b_byte = b if b is not None else 0xFF
+        cmd = bytes([0xB2]) + prefix + bytes([a_byte, b_byte])
+        await self._write_command(cmd)

dglab_controller_python-0.1.0/dg_lab_devices/pawprints.py

@@ -0,0 +1,101 @@
+"""爪印无线按钮传感器 V1.1 (PawPrints)"""
+import struct
+from .base import BaseDevice
+
+class PawPrints(BaseDevice):
+    def __init__(self, address: str = None, name: str = "47L120300"):
+        super().__init__(address, name)
+
+    def on_status(self, func):
+        return self._register_event("status", func)
+
+    def on_trigger(self, func):
+        return self._register_event("trigger", func)
+
+    def on_untrack(self, func):
+        return self._register_event("untrack", func)
+
+    def on_param_change(self, func):
+        return self._register_event("param_change", func)
+
+    def on_physical(self, func):
+        return self._register_event("physical", func)
+
+    def on_auto_detect(self, func):
+        return self._register_event("auto_detect", func)
+
+    async def _on_main_notify(self, sender, data: bytearray):
+        head = data[0]
+        if head == 0x51 and len(data) >= 4:
+            await self._emit_event("status", data[1], data[2], data[3])
+        elif head == 0x5A and len(data) >= 4:
+            await self._emit_event("trigger", data[1], data[2], data[3])
+        elif head == 0x5B and len(data) >= 3:
+            await self._emit_event("untrack", data[1], data[2])
+        elif head == 0x5C and len(data) >= 4:
+            await self._emit_event("param_change", data[1], data[2], data[3])
+        elif head == 0xD0 and len(data) >= 9:
+            await self._emit_event("physical", data[1], data[2], data[3],
+                                   data[4], data[5], data[6], data[7], data[8])
+        elif head == 0xF1 and len(data) >= 14:
+            x_range = struct.unpack_from('<hh', data, 2)
+            y_range = struct.unpack_from('<hh', data, 6)
+            z_range = struct.unpack_from('<hh', data, 10)
+            await self._emit_event("auto_detect", x_range, y_range, z_range)
+
+    async def _write_50(self, payload: bytes):
+        await self._write_command(bytes([0x50]) + payload)
+
+    async def set_trigger_mode_none(self, color: int = 0x01):
+        await self._write_50(bytes([color, 0x00]) + b'\x00' * 14)
+
+    async def set_random_trigger(self, color: int, event_id: int,
+                                 green_min: int, green_max: int,
+                                 reaction_time: int,
+                                 param_inc: int, param_speed: int,
+                                 param_dec: int, param_dec_speed: int):
+        payload = struct.pack('<BBHHHHBBB', color, 0x03, event_id,
+                              green_min, green_max, reaction_time,
+                              param_inc, param_speed, param_dec, param_dec_speed)
+        payload += b'\x00' * 3
+        await self._write_command(bytes([0x50]) + payload)
+
+    async def set_probability_trigger(self, color: int, events_probs: list[tuple[int, int]], cooldown: int):
+        data = bytearray([0x50, color, 0x04])
+        for i in range(6):
+            eid, prob = events_probs[i] if i < len(events_probs) else (0, 0)
+            data.append(eid)
+            data.append(prob)
+        data.append((cooldown >> 8) & 0xFF)
+        data.append(cooldown & 0xFF)
+        await self._write_command(bytes(data))
+
+    async def set_external_voltage_trigger(self, color: int, event_id: int,
+                                           pull_up: int, vol_min: int, vol_max: int, map_range: int):
+        payload = bytes([color, 0x0F, event_id, pull_up, vol_min, vol_max, map_range]) + b'\x00' * 9
+        await self._write_50(payload)
+
+    async def set_press_motion_trigger(self, color: int, press_event_id: int,
+                                       settings_byte: int, press_inc_speed: int,
+                                       press_dec_val: int, press_dec_speed: int,
+                                       press_inc_val: int, motion_event_id: int,
+                                       motion_config: bytes, map_range: int):
+        payload = bytes([color, 0x05, press_event_id, settings_byte,
+                         press_inc_speed, press_dec_val, press_dec_speed, press_inc_val,
+                         motion_event_id]) + motion_config + bytes([map_range])
+        await self._write_50(payload)
+
+    async def set_physical_data_mode(self, color: int = 0x01):
+        await self._write_50(bytes([color, 0xD0]) + b'\x00' * 14)
+
+    async def reset_param(self):
+        await self._write_command(b'\x5F')
+
+    async def auto_detect_angle(self):
+        await self._write_command(b'\x60')
+
+    async def set_led(self, color: int):
+        await self._write_command(bytes([0x70, color]))
+
+    async def set_led_blink(self, color1: int, color2: int, speed: int):
+        await self._write_command(bytes([0x70, color1, color2, speed]))

dglab_controller_python-0.1.0/dglab_controller_python.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: dglab-controller-python
+Version: 0.1.0
+Summary: 用于控制负鼠振动控制器以及读取灵猫和爪印传感器的 Python 库
+Author-email: lindog114514 <kaikaihe467@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/lindog114514/DGLAB-controller-python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bleak>=0.21.0
+Dynamic: license-file
+
+## DGLAB-controller-python
+
+DG-LAB 蓝牙设备的 Python SDK，基于 bleak。
+支持同时连接多个设备、异步事件处理，并通过 async with 自动管理连接。
+
+---
+支持的设备
+---
+
+灵猫边缘控制传感器(47L124000)
+
+负鼠振动控制器 (47L127000)
+
+爪印无线按钮传感器 (47L120300)
+
+
+---
+安装
+---
+```bash
+pip install DGLAB-controller-python
+```
+
+要求 Python 3.10+ 且 bleak ≥ 0.21。
+
+---
+快速开始
+---
+灵猫 – 气压上报
+
+```python
+import asyncio
+from dg_lab_devices import Civec
+
+async def main():
+    async with Civec() as civec:
+        @civec.on_pressure
+        def on_pressure(kpa: float):
+            print(f"气压: {kpa:.2f} kPa")
+
+        await civec.start_pressure_report(color=0x02)
+        await asyncio.sleep(30)
+
+asyncio.run(main())
+```
+
+负鼠 – 按键与强度
+
+```python
+from dg_lab_devices import Controller
+
+async def main():
+    async with Controller() as ctrl:
+        @ctrl.on_button
+        async def on_button(seq, buttons):
+            if buttons.get("A"):
+                await ctrl.set_strength(a=160)
+
+        await ctrl.set_led_and_report(enable_button_report=True)
+        await asyncio.sleep(60)
+
+asyncio.run(main())
+```
+
+爪印 – 触发模式
+
+```python
+from dg_lab_devices import PawPrints
+
+async def main():
+    async with PawPrints() as pp:
+        @pp.on_trigger
+        def on_trigger(color, event_id, param):
+            print(f"触发事件 {event_id}，参数={param}")
+
+        await pp.set_random_trigger(
+            color=0x01, event_id=5,
+            green_min=30, green_max=50,
+            reaction_time=10,
+            param_inc=20, param_speed=40,
+            param_dec=50, param_dec_speed=40
+        )
+        await asyncio.sleep(300)
+
+asyncio.run(main())
+```
+
+---
+主要特性
+---
+· **异步事件驱动** – 装饰器订阅设备通知
+
+· **自动连接管理** – async with 自动连接/断开
+
+· **多设备并发** – 同一事件循环同时运行多个设备
+
+· **完整协议支持** – 实现所有 BLE 指令与回调
+
+---
+开源许可
+---
+本项目使用 MIT 许可证。
+
+---
+联系作者 
+---
+. QQ群:870333220 <del>有香香软软的小南娘和技术大佬<del>
+
+---
+相关链接
+---
+
+. [参考文档](https://github.com/dungeonlab-open/dglab-bluetooth-protocol)
+
+· [PyPI](https://pypi.org/project/DGLAB-controller-python/)
+
+· [API文档](docs/API.md)

dglab_controller_python-0.1.0/dglab_controller_python.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+dg_lab_devices/__init__.py
+dg_lab_devices/base.py
+dg_lab_devices/civec.py
+dg_lab_devices/common.py
+dg_lab_devices/controller.py
+dg_lab_devices/pawprints.py
+dglab_controller_python.egg-info/PKG-INFO
+dglab_controller_python.egg-info/SOURCES.txt
+dglab_controller_python.egg-info/dependency_links.txt
+dglab_controller_python.egg-info/requires.txt
+dglab_controller_python.egg-info/top_level.txt

dglab_controller_python-0.1.0/dglab_controller_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dglab_controller_python-0.1.0/dglab_controller_python.egg-info/requires.txt

@@ -0,0 +1 @@
+bleak>=0.21.0

dglab_controller_python-0.1.0/dglab_controller_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+dg_lab_devices

dglab_controller_python-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dglab-controller-python"
+version = "0.1.0"
+description = "用于控制负鼠振动控制器以及读取灵猫和爪印传感器的 Python 库"
+readme = "README.md"
+authors = [{name = "lindog114514", email = "kaikaihe467@gmail.com"}]
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = [
+    "bleak>=0.21.0",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/lindog114514/DGLAB-controller-python"
+
+[tool.setuptools.packages.find]
+include = ["dg_lab_devices*"]

dglab_controller_python-0.1.0/setup.cfg

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