device-protocol-sdk 1.2.2__tar.gz → 1.2.3__tar.gz

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/PKG-INFO

@@ -1,31 +1,32 @@
-Metadata-Version: 2.1
-Name: device_protocol_sdk
-Version: 1.2.2
-Summary: 无人设备协议开发SDK
-Author: fuhl
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: grpcio>=1.48.2
-Requires-Dist: grpcio-tools>=1.48.2
-Requires-Dist: paho-mqtt>=1.6.1
-Requires-Dist: pydantic>=1.9.0
-Requires-Dist: websockets>=10.0
-
-# Device Protocol SDK
-
-无人机设备协议开发工具包，提供标准化接口实现多类型无人机设备的快速接入。
-
-[![PyPI Version](https://img.shields.io/pypi/v/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
-
-## 功能特性
-
-- 🛠️ **协议无关抽象**：统一各类无人机设备的控制接口
-- 🔌 **连接池管理**：自动维护设备连接，支持多设备并行控制
-- 🚀 **实时状态推送**：内置WebSocket状态推送工具
-- 🔍 **动态协议发现**：运行时自动加载用户协议实现
-
-## 安装
-
-```bash
-pip install device-protocol-sdk
+Metadata-Version: 2.1
+Name: device_protocol_sdk
+Version: 1.2.3
+Summary: 无人设备协议开发SDK
+Author: fuhl
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.48.2
+Requires-Dist: grpcio-tools>=1.48.2
+Requires-Dist: paho-mqtt>=1.6.1
+Requires-Dist: pydantic>=1.9.0
+Requires-Dist: websockets>=10.0
+Requires-Dist: coord-convert>=0.2.1
+
+# Device Protocol SDK
+
+无人机设备协议开发工具包，提供标准化接口实现多类型无人机设备的快速接入。
+
+[![PyPI Version](https://img.shields.io/pypi/v/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
+
+## 功能特性
+
+- 🛠️ **协议无关抽象**：统一各类无人机设备的控制接口
+- 🔌 **连接池管理**：自动维护设备连接，支持多设备并行控制
+- 🚀 **实时状态推送**：内置WebSocket状态推送工具
+- 🔍 **动态协议发现**：运行时自动加载用户协议实现
+
+## 安装
+
+```bash
+pip install device-protocol-sdk

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/README.md

@@ -1,18 +1,18 @@
-# Device Protocol SDK
-
-无人机设备协议开发工具包，提供标准化接口实现多类型无人机设备的快速接入。
-
-[![PyPI Version](https://img.shields.io/pypi/v/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
-
-## 功能特性
-
-- 🛠️ **协议无关抽象**：统一各类无人机设备的控制接口
-- 🔌 **连接池管理**：自动维护设备连接，支持多设备并行控制
-- 🚀 **实时状态推送**：内置WebSocket状态推送工具
-- 🔍 **动态协议发现**：运行时自动加载用户协议实现
-
-## 安装
-
-```bash
+# Device Protocol SDK
+
+无人机设备协议开发工具包，提供标准化接口实现多类型无人机设备的快速接入。
+
+[![PyPI Version](https://img.shields.io/pypi/v/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/device-protocol-sdk)](https://pypi.org/project/device-protocol-sdk/)
+
+## 功能特性
+
+- 🛠️ **协议无关抽象**：统一各类无人机设备的控制接口
+- 🔌 **连接池管理**：自动维护设备连接，支持多设备并行控制
+- 🚀 **实时状态推送**：内置WebSocket状态推送工具
+- 🔍 **动态协议发现**：运行时自动加载用户协议实现
+
+## 安装
+
+```bash
 pip install device-protocol-sdk

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/device_protocol_sdk/abstract_device.py

@@ -1,217 +1,217 @@
-from abc import ABC, abstractmethod
-import threading
-import json,uuid,time
-from typing import List
-from collections import defaultdict
-from .model.device_key import DeviceKey
-from .model.action_item import ActionItem
-from .model.device_status import DeviceStatus,MessageType,MessageLevel
-from typing import Dict, Any, Optional
-import grpc
-from . import device_pb2
-
-from contextlib import contextmanager
-from typing import Generator
-import logging
-logger = logging.getLogger(__name__)
-
-
-
-
-
-class AbstractDevice(ABC):
-    _status_cache: Dict[DeviceKey, dict] = {}
-    _connection_pool: Dict[DeviceKey, Any] = {}  # 类级连接池
-    _lock = threading.RLock()
-
-    _monitor_flags = defaultdict(bool)  # 状态监控标志
-    _monitor_futures = {}
-    _lock = threading.Lock()  # 线程安全锁
-    _status_lock = threading.RLock()  # 新增：状态读取可重入锁
-
-    def __init__(self):
-        self._grpc_stub = None
-        self._current_mission_id = None
-
-    def set_grpc_stub(self, grpc_stub):
-        """设置gRPC stub用于发送消息"""
-        self._grpc_stub = grpc_stub
-
-    def set_current_mission_id(self, mission_id: str):
-        """设置当前任务的mission_id"""
-        self._current_mission_id = mission_id
-
-    @contextmanager
-    def mission_context(self, mission_id: str) -> Generator[None, None, None]:
-        """为任务提供独立的上下文"""
-        original_mission_id = getattr(self, '_current_mission_id', None)
-        try:
-            self._current_mission_id = mission_id
-            yield
-        finally:
-            self._current_mission_id = original_mission_id
-    def send_message(self, device_id: int, message_type: MessageType, content: str,level:MessageLevel,
-                    metadata: Optional[Dict[str, Any]] = None,
-                    mission_id: Optional[str] = None) -> bool:
-        """
-        通过gRPC向服务端发送消息
-
-        Args:
-            message_type: 消息类型
-            content: 消息内容
-            metadata: 附加元数据
-            mission_id: 任务ID，如果为None则使用当前任务ID
-
-        Returns:
-            bool: 发送是否成功
-        """
-        target_mission_id = mission_id or self._current_mission_id
-        if not target_mission_id:
-            logger.warning("未提供mission_id且当前无任务上下文")
-            return False
-
-        if not self._grpc_stub:
-            logger.warning("gRPC stub未设置，无法发送消息")
-            return False
-
-        # 确定mission_id
-        target_mission_id = mission_id or self._current_mission_id
-        if not target_mission_id:
-            logger.warning("未提供mission_id且当前无任务ID，无法发送消息")
-            return False
-
-        try:
-            # 构建gRPC消息
-            device_message = device_pb2.DeviceMessage(
-                mission_id=target_mission_id,
-                message_type=message_type.value,
-                message_level=level.value,
-                content=content,
-                timestamp=int(time.time()),
-                metadata=json.dumps(metadata) if metadata else "",
-                device_id=int(device_id)
-            )
-
-            # 发送消息（假设服务端有ReceiveDeviceMessage方法）
-            self._grpc_stub.ReceiveDeviceMessage(device_message)
-
-        except grpc.RpcError as e:
-            logger.error(f"gRPC消息发送失败: {e}")
-            return False
-        except Exception as e:
-            logger.error(f"发送消息时发生异常: {e}")
-            return False
-
-    def send_text_message(self, device_id: int, text: str,level:MessageLevel, **kwargs) -> bool:
-        """发送纯文本消息的快捷方法"""
-        return self.send_message(device_id,MessageType.TEXT, text,level, **kwargs)
-
-    def send_image_message(self, device_id: int, image_data_or_url: str,level:MessageLevel, **kwargs) -> bool:
-        """发送图像消息的快捷方法"""
-        metadata = kwargs.pop('metadata', {})
-        if 'description' not in metadata:
-            metadata['description'] = '设备上传的图像'
-        return self.send_message(device_id,MessageType.IMAGE, image_data_or_url,level, metadata, **kwargs)
-
-    def send_video_url_message(self, device_id: int, video_url: str,level:MessageLevel, **kwargs) -> bool:
-        """发送视频URL消息的快捷方法"""
-        metadata = kwargs.pop('metadata', {})
-        if 'description' not in metadata:
-            metadata['description'] = '设备视频流地址'
-        return self.send_message(device_id,MessageType.VIDEO_URL, video_url,level, metadata, **kwargs)
-
-    @property
-    @abstractmethod
-    def protocol_name(self) -> str:
-        pass
-    
-    def is_cluster(self):
-        return 0
-    
-    @abstractmethod
-    def get_action_list(self) -> List[ActionItem]:
-        pass
-    def connect(self, device_key: DeviceKey) -> Any:
-        """带设备ID的连接池实现"""
-        with self._lock:
-            if device_key not in self._connection_pool:
-                is_connect,client = self._create_client(device_key.device_id,device_key.connection_str)
-                if is_connect:
-                    self._connection_pool[device_key] = client
-
-    def disconnect(self, device_key: DeviceKey):
-        with self._lock:
-            if device_key in self._connection_pool:
-                self._close_client(self._connection_pool[device_key],device_key.device_id,device_key.connection_str)
-                # 清空连接池中对应device_key的数据
-                del self._connection_pool[device_key]
-                logger.info(f"已从连接池中移除设备 {device_key}")
-
-
-    def is_connected(self, device_key: DeviceKey) -> bool:
-        with self._lock:
-            if conn := self._connection_pool.get(device_key):
-                return True
-        return False
-
-    @abstractmethod
-    def _create_client(self,device_id:int, connection_str: str) -> tuple[bool, Any]:
-        pass
-
-    @abstractmethod
-    def _close_client(self,client, device_id: int, connection_str: str) -> Any:
-        pass
-
-    def get_device_status(self,client,device_id:str,connection_str:str) -> DeviceStatus:
-        pass
-    
-    def get_device_status_list(self,client,device_id:str,connection_str:str) -> List[DeviceStatus]:
-        pass
-
-    def _ensure_connection(self, device_key: DeviceKey) -> Any:
-        """确保设备连接存在，如果不存在则创建"""
-        client = self._connection_pool.get(device_key)
-        if client is not None:
-            return client
-
-        # 尝试连接
-        success, result = self.connect(device_key)
-        if not success:
-            raise ConnectionError(f"无法连接设备 {device_key.device_id}: {result}")
-
-        client = self._connection_pool.get(device_key)
-        if client is None:
-            raise ConnectionError(f"连接已建立但客户端对象缺失: {device_key.device_id}")
-
-        return client
-
-    def get_status(self, device_id: str, connection_str: str) -> DeviceStatus:
-        my_device = DeviceKey(device_id=device_id, connection_str=connection_str)
-
-        # 确保连接存在
-        client = self._ensure_connection(my_device)
-        is_cluster = self.is_cluster()
-        if is_cluster == 0:
-            return [self.get_device_status(client, device_id, connection_str)]
-        else:
-            return self.get_device_status_list(client, device_id, connection_str)
-
-    def excute_command(self,device_id:str,connection_str:str, command: str, params: Dict[str, Any],
-                      mission_id: str):
-        my_device = DeviceKey(device_id=device_id, connection_str=connection_str)
-        this_client = self._ensure_connection(my_device)
-        with self.mission_context(mission_id):
-            self.execute(this_client,device_id,connection_str,command,params)
-
-    @abstractmethod
-    def execute(self,client,device_id:int,connection_str:str, command: str, params: Dict[str, Any]) -> Dict[str, Any]:
-        """执行控制指令"""
-
-    def to_json(self):
-        """序列化设备信息"""
-        actions = [item.dict() for item in self.get_action_list()]
-        return json.dumps({
-            "protocol": self.protocol_name,
-            "action_list": actions,
-            "is_cluster": self.is_cluster()
+from abc import ABC, abstractmethod
+import threading
+import json,uuid,time
+from typing import List
+from collections import defaultdict
+from .model.device_key import DeviceKey
+from .model.action_item import ActionItem
+from .model.device_status import DeviceStatus,MessageType,MessageLevel
+from typing import Dict, Any, Optional
+import grpc
+from . import device_pb2
+
+from contextlib import contextmanager
+from typing import Generator
+import logging
+logger = logging.getLogger(__name__)
+
+
+
+
+
+class AbstractDevice(ABC):
+    _status_cache: Dict[DeviceKey, dict] = {}
+    _connection_pool: Dict[DeviceKey, Any] = {}  # 类级连接池
+    _lock = threading.RLock()
+
+    _monitor_flags = defaultdict(bool)  # 状态监控标志
+    _monitor_futures = {}
+    _lock = threading.Lock()  # 线程安全锁
+    _status_lock = threading.RLock()  # 新增：状态读取可重入锁
+
+    def __init__(self):
+        self._grpc_stub = None
+        self._current_mission_id = None
+
+    def set_grpc_stub(self, grpc_stub):
+        """设置gRPC stub用于发送消息"""
+        self._grpc_stub = grpc_stub
+
+    def set_current_mission_id(self, mission_id: str):
+        """设置当前任务的mission_id"""
+        self._current_mission_id = mission_id
+
+    @contextmanager
+    def mission_context(self, mission_id: str) -> Generator[None, None, None]:
+        """为任务提供独立的上下文"""
+        original_mission_id = getattr(self, '_current_mission_id', None)
+        try:
+            self._current_mission_id = mission_id
+            yield
+        finally:
+            self._current_mission_id = original_mission_id
+    def send_message(self, device_id: int, message_type: MessageType, content: str,level:MessageLevel,
+                    metadata: Optional[Dict[str, Any]] = None,
+                    mission_id: Optional[str] = None) -> bool:
+        """
+        通过gRPC向服务端发送消息
+
+        Args:
+            message_type: 消息类型
+            content: 消息内容
+            metadata: 附加元数据
+            mission_id: 任务ID，如果为None则使用当前任务ID
+
+        Returns:
+            bool: 发送是否成功
+        """
+        target_mission_id = mission_id or self._current_mission_id
+        if not target_mission_id:
+            logger.warning("未提供mission_id且当前无任务上下文")
+            return False
+
+        if not self._grpc_stub:
+            logger.warning("gRPC stub未设置，无法发送消息")
+            return False
+
+        # 确定mission_id
+        target_mission_id = mission_id or self._current_mission_id
+        if not target_mission_id:
+            logger.warning("未提供mission_id且当前无任务ID，无法发送消息")
+            return False
+
+        try:
+            # 构建gRPC消息
+            device_message = device_pb2.DeviceMessage(
+                mission_id=target_mission_id,
+                message_type=message_type.value,
+                message_level=level.value,
+                content=content,
+                timestamp=int(time.time()),
+                metadata=json.dumps(metadata) if metadata else "",
+                device_id=int(device_id)
+            )
+
+            # 发送消息（假设服务端有ReceiveDeviceMessage方法）
+            self._grpc_stub.ReceiveDeviceMessage(device_message)
+
+        except grpc.RpcError as e:
+            logger.error(f"gRPC消息发送失败: {e}")
+            return False
+        except Exception as e:
+            logger.error(f"发送消息时发生异常: {e}")
+            return False
+
+    def send_text_message(self, device_id: int, text: str,level:MessageLevel, **kwargs) -> bool:
+        """发送纯文本消息的快捷方法"""
+        return self.send_message(device_id,MessageType.TEXT, text,level, **kwargs)
+
+    def send_image_message(self, device_id: int, image_data_or_url: str,level:MessageLevel, **kwargs) -> bool:
+        """发送图像消息的快捷方法"""
+        metadata = kwargs.pop('metadata', {})
+        if 'description' not in metadata:
+            metadata['description'] = '设备上传的图像'
+        return self.send_message(device_id,MessageType.IMAGE, image_data_or_url,level, metadata, **kwargs)
+
+    def send_video_url_message(self, device_id: int, video_url: str,level:MessageLevel, **kwargs) -> bool:
+        """发送视频URL消息的快捷方法"""
+        metadata = kwargs.pop('metadata', {})
+        if 'description' not in metadata:
+            metadata['description'] = '设备视频流地址'
+        return self.send_message(device_id,MessageType.VIDEO_URL, video_url,level, metadata, **kwargs)
+
+    @property
+    @abstractmethod
+    def protocol_name(self) -> str:
+        pass
+    
+    def is_cluster(self):
+        return 0
+    
+    @abstractmethod
+    def get_action_list(self) -> List[ActionItem]:
+        pass
+    def connect(self, device_key: DeviceKey) -> Any:
+        """带设备ID的连接池实现"""
+        with self._lock:
+            if device_key not in self._connection_pool:
+                is_connect,client = self._create_client(device_key.device_id,device_key.connection_str)
+                if is_connect:
+                    self._connection_pool[device_key] = client
+
+    def disconnect(self, device_key: DeviceKey):
+        with self._lock:
+            if device_key in self._connection_pool:
+                self._close_client(self._connection_pool[device_key],device_key.device_id,device_key.connection_str)
+                # 清空连接池中对应device_key的数据
+                del self._connection_pool[device_key]
+                logger.info(f"已从连接池中移除设备 {device_key}")
+
+
+    def is_connected(self, device_key: DeviceKey) -> bool:
+        with self._lock:
+            if conn := self._connection_pool.get(device_key):
+                return True
+        return False
+
+    @abstractmethod
+    def _create_client(self,device_id:int, connection_str: str) -> tuple[bool, Any]:
+        pass
+
+    @abstractmethod
+    def _close_client(self,client, device_id: int, connection_str: str) -> Any:
+        pass
+
+    def get_device_status(self,client,device_id:str,connection_str:str) -> DeviceStatus:
+        pass
+    
+    def get_device_status_list(self,client,device_id:str,connection_str:str) -> List[DeviceStatus]:
+        pass
+
+    def _ensure_connection(self, device_key: DeviceKey) -> Any:
+        """确保设备连接存在，如果不存在则创建"""
+        client = self._connection_pool.get(device_key)
+        if client is not None:
+            return client
+
+        # 尝试连接
+        success, result = self.connect(device_key)
+        if not success:
+            raise ConnectionError(f"无法连接设备 {device_key.device_id}: {result}")
+
+        client = self._connection_pool.get(device_key)
+        if client is None:
+            raise ConnectionError(f"连接已建立但客户端对象缺失: {device_key.device_id}")
+
+        return client
+
+    def get_status(self, device_id: str, connection_str: str) -> DeviceStatus:
+        my_device = DeviceKey(device_id=device_id, connection_str=connection_str)
+
+        # 确保连接存在
+        client = self._ensure_connection(my_device)
+        is_cluster = self.is_cluster()
+        if is_cluster == 0:
+            return [self.get_device_status(client, device_id, connection_str)]
+        else:
+            return self.get_device_status_list(client, device_id, connection_str)
+
+    def excute_command(self,device_id:str,connection_str:str, command: str, params: Dict[str, Any],
+                      mission_id: str):
+        my_device = DeviceKey(device_id=device_id, connection_str=connection_str)
+        this_client = self._ensure_connection(my_device)
+        with self.mission_context(mission_id):
+            self.execute(this_client,device_id,connection_str,command,params)
+
+    @abstractmethod
+    def execute(self,client,device_id:int,connection_str:str, command: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        """执行控制指令"""
+
+    def to_json(self):
+        """序列化设备信息"""
+        actions = [item.dict() for item in self.get_action_list()]
+        return json.dumps({
+            "protocol": self.protocol_name,
+            "action_list": actions,
+            "is_cluster": self.is_cluster()
         }, ensure_ascii=False)

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/device_protocol_sdk/model/action_item.py

@@ -1,12 +1,12 @@
-# action_item.py
-from dataclasses import dataclass, asdict
-from typing import Dict, Any
-@dataclass
-class ActionItem:
-    name: str  # 动作名称
-    command_type: str  # 动作唯一标识
-    description: str  # 描述
-    params: Dict[str, Any]  # JSON Schema 或简单 dict 描述
-
-    def dict(self) -> Dict[str, Any]:
+# action_item.py
+from dataclasses import dataclass, asdict
+from typing import Dict, Any
+@dataclass
+class ActionItem:
+    name: str  # 动作名称
+    command_type: str  # 动作唯一标识
+    description: str  # 描述
+    params: Dict[str, Any]  # JSON Schema 或简单 dict 描述
+
+    def dict(self) -> Dict[str, Any]:
         return asdict(self)

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/device_protocol_sdk/model/device_key.py

@@ -1,8 +1,8 @@
-# device_key.py
-from dataclasses import dataclass
-
-@dataclass(frozen=True)
-class DeviceKey:
-    """不可变的设备唯一标识"""
-    device_id: str  # 业务唯一字符串
+# device_key.py
+from dataclasses import dataclass
+
+@dataclass(frozen=True)
+class DeviceKey:
+    """不可变的设备唯一标识"""
+    device_id: str  # 业务唯一字符串
     connection_str: str  # 连接参数（如IP/串口号）

{device_protocol_sdk-1.2.2 → device_protocol_sdk-1.2.3}/device_protocol_sdk/model/device_status.py

@@ -1,35 +1,35 @@
-# device_status.py
-from typing import TypedDict, Optional
-from enum import Enum
-
-class DeviceStatus(TypedDict, total=False):
-    """设备状态固定格式"""
-    is_lock: Optional[int]  # 必填
-    heartbeat: Optional[int]  # 必填
-    battery: Optional[float]  # 必填
-    airspeed: Optional[float]  # 必填
-    groundspeed: Optional[float]  # 必填
-    yaw_degrees: Optional[float]  # 必填
-    roll: Optional[float]  # 必填
-    pitch: Optional[float]  # 必填
-    yaw: Optional[float]  # 必填
-    lat: Optional[float]  # 必填
-    lon: Optional[float]  # 必填
-    alt: Optional[float]  # 必填
-    vzspeed: Optional[float]  # 必填
-    height: Optional[float]  # 必填
-
-
-class MessageType(Enum):
-    TEXT = "text"  # 纯文本消息
-    IMAGE = "image"  # 图像消息
-    VIDEO_URL = "video_url"  # 视频流URL
-    PROGRESS = "progress"  # 进度更新
-    STATUS = "status"  # 状态更新
-
-#消息级别: failed, warning, info, success
-class MessageLevel(Enum):
-    FAILED = "failed"
-    WARNING = "warning"
-    INFO = "info"
-    SUCCESS = "success"
+# device_status.py
+from typing import TypedDict, Optional
+from enum import Enum
+
+class DeviceStatus(TypedDict, total=False):
+    """设备状态固定格式"""
+    is_lock: Optional[int]  # 必填
+    heartbeat: Optional[int]  # 必填
+    battery: Optional[float]  # 必填
+    airspeed: Optional[float]  # 必填
+    groundspeed: Optional[float]  # 必填
+    yaw_degrees: Optional[float]  # 必填
+    roll: Optional[float]  # 必填
+    pitch: Optional[float]  # 必填
+    yaw: Optional[float]  # 必填
+    lat: Optional[float]  # 必填
+    lon: Optional[float]  # 必填
+    alt: Optional[float]  # 必填
+    vzspeed: Optional[float]  # 必填
+    height: Optional[float]  # 必填
+
+
+class MessageType(Enum):
+    TEXT = "text"  # 纯文本消息
+    IMAGE = "image"  # 图像消息
+    VIDEO_URL = "video_url"  # 视频流URL
+    PROGRESS = "progress"  # 进度更新
+    STATUS = "status"  # 状态更新
+
+#消息级别: failed, warning, info, success
+class MessageLevel(Enum):
+    FAILED = "failed"
+    WARNING = "warning"
+    INFO = "info"
+    SUCCESS = "success"