sdev 0.4.0__tar.gz → 0.4.2__tar.gz

sdev-0.4.2/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: sdev
+Version: 0.4.2
+Summary: 串口控制器工具包
+Home-page: https://github.com/klrc/sdev
+Author: klrc
+Author-email: klrc <144069824@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/klrc/sdev
+Project-URL: Repository, https://github.com/klrc/sdev
+Project-URL: Bug Tracker, https://github.com/klrc/sdev/issues
+Keywords: serial,controller,hardware,embedded
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyserial>=3.5
+Requires-Dist: loguru>=0.6.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SDEV
+
+串口开发板控制器：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
+
+**注意**：同一串口同一时间只能被一个 sdev 进程使用。请勿并行执行多条 `sdev shell ...` 或快速连续执行，否则可能报「串口已被其他 sdev 进程占用」或挂死；需等前一条命令结束后再执行下一条。
+
+## 安装
+
+```bash
+pip install sdev
+```
+
+## 命令行
+
+安装后可使用 `sdev` 命令，在默认串口上执行单条命令并回显：
+
+```bash
+sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
+sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
+sdev --no-check-alive shell "echo hello"
+```
+
+- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
+- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
+- `--flag`：提示符结束标志（默认 `" #"`）
+- `--timeout`：等待输出超时秒数
+- `--no-check-alive`：连接后不执行存活检测
+
+## 快速使用 (Python)
+
+推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层、更易用的接口：
+
+```python
+from sdev import sdev
+
+# 使用 context manager 自动连接/断开
+with sdev("/dev/ttyUSB0", 115200) as board:
+    # connect 时默认会执行 check_alive()，确保板子已就绪
+    out = board.shell("ls")  # 执行命令并返回输出行列表
+    print(out)
+```
+
+手动控制连接与存活检测：
+
+```python
+from sdev import Demoboard
+
+board = Demoboard("/dev/ttyUSB0", 115200)
+board.connect()
+board.check_alive()  # 检查并确保进入 shell 提示符
+board.shell("echo hello")
+board.disconnect()
+```
+
+## 主要接口
+
+### Demoboard (推荐)
+
+继承自 `SerialDevice`，提供针对开发板的高层封装。
+
+| 方法 | 说明 |
+|------|------|
+| `shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 清缓冲 -> 发送命令 -> 等待命令回显 -> 等待提示符。返回输出列表或生成器。 |
+| `check_alive(uboot_flag="uboot#", prompt_flag=" #", response_timeout=3)` | 存活检测：处理 U-Boot 挂起、发送 Ctrl-C 唤醒并等待提示符。 |
+
+### SerialDevice (底层)
+
+| 方法 / 属性 | 说明 |
+|-------------|------|
+| `STABLE_FLAG` | 类常量 `" #"`，常用作默认提示符。 |
+| `connect()` / `disconnect()` | 打开/关闭串口并启停后台读线程。 |
+| `send(text)` | 发送一行（自动加换行）。 |
+| `scan(end_flag, timeout=None)` | 从缓存中持续读取直到目标 flag，或读到 timeout 结束。 |
+| `display(lines, flag=None, flag_type=None)` | 对传入的行按 flag 类型回显（着色）并 yield 原始行。 |
+| `clear()` | 清空读缓冲。 |
+
+- **回显着色**：匹配到 `flag` 的行为绿色，命令回显行为青色，其余灰色；支持设备折行后的跨行匹配。
+
+## 依赖
+
+- Python >= 3.7
+- pyserial >= 3.5
+- loguru >= 0.6.0

sdev-0.4.2/README.md

@@ -0,0 +1,83 @@
+# SDEV
+
+串口开发板控制器：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
+
+**注意**：同一串口同一时间只能被一个 sdev 进程使用。请勿并行执行多条 `sdev shell ...` 或快速连续执行，否则可能报「串口已被其他 sdev 进程占用」或挂死；需等前一条命令结束后再执行下一条。
+
+## 安装
+
+```bash
+pip install sdev
+```
+
+## 命令行
+
+安装后可使用 `sdev` 命令，在默认串口上执行单条命令并回显：
+
+```bash
+sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
+sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
+sdev --no-check-alive shell "echo hello"
+```
+
+- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
+- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
+- `--flag`：提示符结束标志（默认 `" #"`）
+- `--timeout`：等待输出超时秒数
+- `--no-check-alive`：连接后不执行存活检测
+
+## 快速使用 (Python)
+
+推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层、更易用的接口：
+
+```python
+from sdev import sdev
+
+# 使用 context manager 自动连接/断开
+with sdev("/dev/ttyUSB0", 115200) as board:
+    # connect 时默认会执行 check_alive()，确保板子已就绪
+    out = board.shell("ls")  # 执行命令并返回输出行列表
+    print(out)
+```
+
+手动控制连接与存活检测：
+
+```python
+from sdev import Demoboard
+
+board = Demoboard("/dev/ttyUSB0", 115200)
+board.connect()
+board.check_alive()  # 检查并确保进入 shell 提示符
+board.shell("echo hello")
+board.disconnect()
+```
+
+## 主要接口
+
+### Demoboard (推荐)
+
+继承自 `SerialDevice`，提供针对开发板的高层封装。
+
+| 方法 | 说明 |
+|------|------|
+| `shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 清缓冲 -> 发送命令 -> 等待命令回显 -> 等待提示符。返回输出列表或生成器。 |
+| `check_alive(uboot_flag="uboot#", prompt_flag=" #", response_timeout=3)` | 存活检测：处理 U-Boot 挂起、发送 Ctrl-C 唤醒并等待提示符。 |
+
+### SerialDevice (底层)
+
+| 方法 / 属性 | 说明 |
+|-------------|------|
+| `STABLE_FLAG` | 类常量 `" #"`，常用作默认提示符。 |
+| `connect()` / `disconnect()` | 打开/关闭串口并启停后台读线程。 |
+| `send(text)` | 发送一行（自动加换行）。 |
+| `scan(end_flag, timeout=None)` | 从缓存中持续读取直到目标 flag，或读到 timeout 结束。 |
+| `display(lines, flag=None, flag_type=None)` | 对传入的行按 flag 类型回显（着色）并 yield 原始行。 |
+| `clear()` | 清空读缓冲。 |
+
+- **回显着色**：匹配到 `flag` 的行为绿色，命令回显行为青色，其余灰色；支持设备折行后的跨行匹配。
+
+## 依赖
+
+- Python >= 3.7
+- pyserial >= 3.5
+- loguru >= 0.6.0

{sdev-0.4.0 → sdev-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sdev"
-version = "0.4.0"
+version = "0.4.2"
 description = "串口控制器工具包"
 readme = "README.md"
 license = {text = "MIT"}

{sdev-0.4.0 → sdev-0.4.2}/sdev/__init__.py

@@ -14,7 +14,7 @@ from typing import Literal
 from .core import SerialDevice
 from .class_wrapper import Demoboard, Relay
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"
 __author__ = "klrc"
 __email__ = "1440698245@qq.com"
 

{sdev-0.4.0 → sdev-0.4.2}/sdev/class_wrapper.py

@@ -7,7 +7,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Generator, List, Optional, Union
 
 from .core import SerialDevice
 from .demoboard import check_alive as _check_alive_func
@@ -21,6 +21,10 @@ class Demoboard(SerialDevice):
     - 提供 shell() / check_alive() 等高层方法。
     """
 
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.check_alive()
+
     def shell(
         self,
         cmd: str,
@@ -28,27 +32,21 @@ class Demoboard(SerialDevice):
         prompt_flag: str = " #",
         timeout: Optional[float] = None,
         stream: bool = False,
-    ):
+    ) -> Union[List[str], Generator[str, None, None]]:
         return _shell_func(self, cmd, prompt_flag=prompt_flag, timeout=timeout, stream=stream)
 
     def check_alive(
         self,
         *,
         uboot_flag: str = "uboot#",
-        awaken_flag: str = "Process",
         prompt_flag: str = " #",
-        ctrl_c_timeout: float = 5.0,
-        reboot_timeout: float = 120.0,
-        prompt_timeout: float = 60.0,
+        response_timeout: float = 3,
     ) -> None:
         _check_alive_func(
             self,
             uboot_flag=uboot_flag,
-            awaken_flag=awaken_flag,
             prompt_flag=prompt_flag,
-            ctrl_c_timeout=ctrl_c_timeout,
-            reboot_timeout=reboot_timeout,
-            prompt_timeout=prompt_timeout,
+            response_timeout=response_timeout,
         )
 
 

{sdev-0.4.0 → sdev-0.4.2}/sdev/cli_wrapper.py

@@ -1,8 +1,7 @@
 """
 命令行入口：
 
-- sdev shell "cmd"：在串口设备上执行单条命令并回显输出；
-- sdev demoboard status：枚举本机串口并通过 check_alive 检查是否存活。
+- sdev shell "cmd"：在串口设备上执行单条命令并回显输出。
 """
 
 from __future__ import annotations
@@ -10,13 +9,8 @@ from __future__ import annotations
 import argparse
 import os
 import sys
-from typing import List
-
-from serial.tools import list_ports
 
 from .class_wrapper import Demoboard
-from .demoboard.functional import check_alive as demoboard_check_alive
-from .demoboard.functional import shell as demoboard_shell
 
 
 def _get_default_port() -> str:
@@ -30,62 +24,24 @@ def _get_default_baudrate() -> int:
         return 115200
 
 
-def _list_serial_ports() -> List[str]:
-    """跨平台列出本机可用串口设备路径。"""
-    ports = [info.device for info in list_ports.comports()]
-    return sorted(ports)
-
-
 def cmd_shell(args: argparse.Namespace) -> int:
     port = args.port or _get_default_port()
     baudrate = args.baudrate or _get_default_baudrate()
     with Demoboard(port, baudrate) as board:
         try:
             if not args.no_check_alive:
-                demoboard_check_alive(board)
-            demoboard_shell(board, args.command, prompt_flag=args.flag, timeout=args.timeout)
+                board.check_alive()
+            board.shell(args.command, prompt_flag=args.flag, timeout=args.timeout)
         except TimeoutError as e:
             print(e, file=sys.stderr)
             return 1
     return 0
 
 
-def cmd_demoboard_status(args: argparse.Namespace) -> int:  # noqa: ARG001
-    """
-    sdev demoboard status
-
-    通过 check_alive 检查本机所有串口是否「alive」。
-    """
-    GREEN = "\033[32m"
-    RED = "\033[31m"
-    RESET = "\033[0m"
-
-    baudrate = _get_default_baudrate()
-    ports = _list_serial_ports()
-    if not ports:
-        print("no serial ports found")
-        return 0
-
-    for port in ports:
-        try:
-            with Demoboard(port, baudrate) as board:
-                # 使用较短的超时时间，避免 status 长时间卡死
-                demoboard_check_alive(
-                    board,
-                    ctrl_c_timeout=2.0,
-                    reboot_timeout=30.0,
-                    prompt_timeout=10.0,
-                )
-            print(f"{GREEN}{port} alive{RESET}")
-        except Exception:  # noqa: BLE001
-            print(f"{RED}{port} not connected{RESET}")
-    return 0
-
-
 def main() -> int:
     parser = argparse.ArgumentParser(
         prog="sdev",
-        description="串口开发板控制器：在串口设备上执行命令或检查状态。",
+        description="串口开发板控制器：在串口设备上执行命令。",
     )
     parser.add_argument(
         "-p",
@@ -126,13 +82,6 @@ def main() -> int:
     )
     shell_parser.set_defaults(func=cmd_shell)
 
-    # sdev demoboard status
-    demoboard_parser = subparsers.add_parser("demoboard", help="Demoboard 相关操作")
-    demoboard_subparsers = demoboard_parser.add_subparsers(dest="demoboard_subcommand", required=True)
-
-    status_parser = demoboard_subparsers.add_parser("status", help="检查本机关联的 Demoboard 串口状态")
-    status_parser.set_defaults(func=cmd_demoboard_status)
-
     parsed = parser.parse_args()
     return parsed.func(parsed)
 

{sdev-0.4.0 → sdev-0.4.2}/sdev/demoboard/functional.py

@@ -85,13 +85,9 @@ def shell(
 
 def check_alive(
     device: SerialDevice,
-    *,
     uboot_flag: str = "uboot#",
-    awaken_flag: str = "Process",
     prompt_flag: str = " #",
-    ctrl_c_timeout: float = 5.0,
-    reboot_timeout: float = 120.0,
-    prompt_timeout: float = 60.0,
+    response_timeout: float = 3,    
 ) -> None:
     """
     检查 demoboard 是否「醒着」且有 shell 提示符。
@@ -102,33 +98,41 @@ def check_alive(
     2. 若在 U-Boot：
        - 发送 "reboot"；
        - 等待 awaken_flag（如 "Process ... done" 中的 "Process"）出现，超时则抛 TimeoutError；
-    3. 最后，无论是否经过 reboot，统一等待 shell 提示符 prompt_flag（如 " #"），超时抛 TimeoutError。
+    3. 最后，无论是否经过 reboot，统一等待 shell 提示符 prompt_flag（如 "#"），超时抛 TimeoutError。
     """
-    # 1. 发送 Ctrl-C 探测状态
-    try:
-        # 尝试通过 Ctrl-C 获取响应
-        lines = shell(device, CTRL_C, prompt_flag=prompt_flag, timeout=ctrl_c_timeout)
-    except TimeoutError:
-        # 如果超时，说明可能正在启动或者完全没响应，尝试盲发 Ctrl-C 并等待
-        device.send(CTRL_C)
-        lines = list(device.scan(end_flag=None, timeout=ctrl_c_timeout))
-
-    # 2. 检查是否在 U-Boot
-    is_uboot = any(uboot_flag in line for line in lines)
-    if is_uboot:
-        logger.warning(f"Device is in U-Boot (matched {uboot_flag!r}), rebooting...")
-        device.send("reboot")
-        # 等待系统开始启动（出现 awaken_flag）
-        list(device.scan(end_flag=awaken_flag, timeout=reboot_timeout))
-        logger.info("Reboot signal detected, waiting for system to boot...")
-
-    # 3. 统一等待最终提示符
+
+    # 1. Ctrl-C，判定控制台是否响应
+    under_reboot = False
     try:
-        list(device.scan(end_flag=prompt_flag, timeout=prompt_timeout))
-        logger.info(f"Device is alive (matched prompt {prompt_flag!r})")
+        lines = shell(device, CTRL_C, prompt_flag, timeout=response_timeout)
     except TimeoutError:
-        logger.error(f"Timed out waiting for prompt {prompt_flag!r}")
-        raise
+        wait_iter = 0
+        while True:
+            device.send(CTRL_C)
+            lines = shell(device, None, None, timeout=response_timeout, clear=False)
+            if len(lines) > 0:
+                under_reboot = True
+                break
+            wait_iter += 1
+            if wait_iter > 5:
+                logger.warning("CTRL-C test failed, please check the connection")
+                break
+
+    # 2. 检查是否被中止进入uboot
+    for line in lines:
+        if uboot_flag in line:
+            logger.warning("uboot flag found, rebooting")
+            device.send("reboot")
+            under_reboot = True
+            break
+
+    # 3. 进入启动流程
+    if under_reboot:
+        try:
+            lines = shell(device, None, None, timeout=response_timeout)
+        except TimeoutError:
+            pass  # 等待启动彻底完成
+        return check_alive(device, uboot_flag, prompt_flag, response_timeout)
 
 
 if __name__ == "__main__":

sdev-0.4.2/sdev.egg-info/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: sdev
+Version: 0.4.2
+Summary: 串口控制器工具包
+Home-page: https://github.com/klrc/sdev
+Author: klrc
+Author-email: klrc <144069824@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/klrc/sdev
+Project-URL: Repository, https://github.com/klrc/sdev
+Project-URL: Bug Tracker, https://github.com/klrc/sdev/issues
+Keywords: serial,controller,hardware,embedded
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyserial>=3.5
+Requires-Dist: loguru>=0.6.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SDEV
+
+串口开发板控制器：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
+
+**注意**：同一串口同一时间只能被一个 sdev 进程使用。请勿并行执行多条 `sdev shell ...` 或快速连续执行，否则可能报「串口已被其他 sdev 进程占用」或挂死；需等前一条命令结束后再执行下一条。
+
+## 安装
+
+```bash
+pip install sdev
+```
+
+## 命令行
+
+安装后可使用 `sdev` 命令，在默认串口上执行单条命令并回显：
+
+```bash
+sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
+sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
+sdev --no-check-alive shell "echo hello"
+```
+
+- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
+- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
+- `--flag`：提示符结束标志（默认 `" #"`）
+- `--timeout`：等待输出超时秒数
+- `--no-check-alive`：连接后不执行存活检测
+
+## 快速使用 (Python)
+
+推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层、更易用的接口：
+
+```python
+from sdev import sdev
+
+# 使用 context manager 自动连接/断开
+with sdev("/dev/ttyUSB0", 115200) as board:
+    # connect 时默认会执行 check_alive()，确保板子已就绪
+    out = board.shell("ls")  # 执行命令并返回输出行列表
+    print(out)
+```
+
+手动控制连接与存活检测：
+
+```python
+from sdev import Demoboard
+
+board = Demoboard("/dev/ttyUSB0", 115200)
+board.connect()
+board.check_alive()  # 检查并确保进入 shell 提示符
+board.shell("echo hello")
+board.disconnect()
+```
+
+## 主要接口
+
+### Demoboard (推荐)
+
+继承自 `SerialDevice`，提供针对开发板的高层封装。
+
+| 方法 | 说明 |
+|------|------|
+| `shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 清缓冲 -> 发送命令 -> 等待命令回显 -> 等待提示符。返回输出列表或生成器。 |
+| `check_alive(uboot_flag="uboot#", prompt_flag=" #", response_timeout=3)` | 存活检测：处理 U-Boot 挂起、发送 Ctrl-C 唤醒并等待提示符。 |
+
+### SerialDevice (底层)
+
+| 方法 / 属性 | 说明 |
+|-------------|------|
+| `STABLE_FLAG` | 类常量 `" #"`，常用作默认提示符。 |
+| `connect()` / `disconnect()` | 打开/关闭串口并启停后台读线程。 |
+| `send(text)` | 发送一行（自动加换行）。 |
+| `scan(end_flag, timeout=None)` | 从缓存中持续读取直到目标 flag，或读到 timeout 结束。 |
+| `display(lines, flag=None, flag_type=None)` | 对传入的行按 flag 类型回显（着色）并 yield 原始行。 |
+| `clear()` | 清空读缓冲。 |
+
+- **回显着色**：匹配到 `flag` 的行为绿色，命令回显行为青色，其余灰色；支持设备折行后的跨行匹配。
+
+## 依赖
+
+- Python >= 3.7
+- pyserial >= 3.5
+- loguru >= 0.6.0

{sdev-0.4.0 → sdev-0.4.2}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="sdev",
-    version="0.4.0",
+    version="0.4.2",
     author="klrc",
     author_email="144069824@qq.com",
     description="串口控制器工具包",

sdev-0.4.0/PKG-INFO

@@ -1,119 +0,0 @@
-Metadata-Version: 2.4
-Name: sdev
-Version: 0.4.0
-Summary: 串口控制器工具包
-Home-page: https://github.com/klrc/sdev
-Author: klrc
-Author-email: klrc <144069824@qq.com>
-License: MIT
-Project-URL: Homepage, https://github.com/klrc/sdev
-Project-URL: Repository, https://github.com/klrc/sdev
-Project-URL: Bug Tracker, https://github.com/klrc/sdev/issues
-Keywords: serial,controller,hardware,embedded
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Hardware
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyserial>=3.5
-Requires-Dist: loguru>=0.6.0
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# SDEV
-
-串口控制器工具包：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
-
-**注意**：同一串口同一时间只能被一个 sdev 进程使用。系统会自动处理跨进程锁，后来的进程会阻塞等待。
-
-## 安装
-
-```bash
-pip install sdev
-```
-
-## 命令行用法
-
-安装后可使用 `sdev` 命令。默认会执行存活检测（check_alive）。
-
-```bash
-# 执行单条命令并回显
-sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
-
-# 指定串口和波特率
-sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
-
-# 跳过存活检测执行命令
-sdev --no-check-alive shell "echo hello"
-
-# 检查本机所有串口状态
-sdev demoboard status
-```
-
-- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
-- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
-- `--flag`：提示符结束标志（默认 `" #"`）
-- `--timeout`：等待输出超时秒数
-
-## Python API 使用
-
-推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层的封装。
-
-### 推荐做法
-
-```python
-from sdev import sdev
-
-# 使用上下文管理器，自动处理 connect() / disconnect()
-with sdev("/dev/ttyUSB0", 115200) as board:
-    # 默认 connect 时会阻塞直到拿到串口锁
-    # 执行命令，返回输出行列表
-    output = board.shell("ls")
-    print(output)
-```
-
-### 存活检测
-
-`Demoboard.check_alive()` 能够处理设备处于 U-Boot、内核启动中或已进入 Shell 的各种状态：
-
-```python
-with sdev("/dev/ttyUSB0") as board:
-    # 自动识别 U-Boot 并执行 reboot，直到进入 Shell
-    board.check_alive() 
-    board.shell("cat /proc/version")
-```
-
-### 核心 API 说明
-
-| 类/方法 | 说明 |
-|-------------|------|
-| `sdev(port, baudrate, device_type="demoboard")` | 工厂函数，返回设备实例（Demoboard 或 Relay） |
-| `Demoboard.shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 执行命令。`stream=True` 时返回 generator |
-| `Demoboard.check_alive(...)` | 综合检查存活状态，支持 U-Boot 自动重启和等待唤醒 |
-| `SerialDevice.send(text)` | 底层接口：发送一行（自动加换行） |
-| `SerialDevice.scan(end_flag, timeout)` | 底层接口：从缓冲中读取直到匹配 flag |
-
-## 特色
-
-- **回显着色**：匹配到 flag 的行为绿色，命令回显行为青色，其余灰色。
-- **拼行匹配**：设备折行时会自动拼接多行进行 flag 匹配，提高成功率。
-- **跨进程互斥**：基于文件锁，确保多进程安全访问串口。
-- **异步读取**：后台线程实时消费串口数据，避免缓冲区溢出丢失数据。
-
-## 依赖
-
-- Python >= 3.7
-- pyserial >= 3.5
-- loguru >= 0.6.0

sdev-0.4.0/README.md

@@ -1,85 +0,0 @@
-# SDEV
-
-串口控制器工具包：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
-
-**注意**：同一串口同一时间只能被一个 sdev 进程使用。系统会自动处理跨进程锁，后来的进程会阻塞等待。
-
-## 安装
-
-```bash
-pip install sdev
-```
-
-## 命令行用法
-
-安装后可使用 `sdev` 命令。默认会执行存活检测（check_alive）。
-
-```bash
-# 执行单条命令并回显
-sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
-
-# 指定串口和波特率
-sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
-
-# 跳过存活检测执行命令
-sdev --no-check-alive shell "echo hello"
-
-# 检查本机所有串口状态
-sdev demoboard status
-```
-
-- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
-- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
-- `--flag`：提示符结束标志（默认 `" #"`）
-- `--timeout`：等待输出超时秒数
-
-## Python API 使用
-
-推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层的封装。
-
-### 推荐做法
-
-```python
-from sdev import sdev
-
-# 使用上下文管理器，自动处理 connect() / disconnect()
-with sdev("/dev/ttyUSB0", 115200) as board:
-    # 默认 connect 时会阻塞直到拿到串口锁
-    # 执行命令，返回输出行列表
-    output = board.shell("ls")
-    print(output)
-```
-
-### 存活检测
-
-`Demoboard.check_alive()` 能够处理设备处于 U-Boot、内核启动中或已进入 Shell 的各种状态：
-
-```python
-with sdev("/dev/ttyUSB0") as board:
-    # 自动识别 U-Boot 并执行 reboot，直到进入 Shell
-    board.check_alive() 
-    board.shell("cat /proc/version")
-```
-
-### 核心 API 说明
-
-| 类/方法 | 说明 |
-|-------------|------|
-| `sdev(port, baudrate, device_type="demoboard")` | 工厂函数，返回设备实例（Demoboard 或 Relay） |
-| `Demoboard.shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 执行命令。`stream=True` 时返回 generator |
-| `Demoboard.check_alive(...)` | 综合检查存活状态，支持 U-Boot 自动重启和等待唤醒 |
-| `SerialDevice.send(text)` | 底层接口：发送一行（自动加换行） |
-| `SerialDevice.scan(end_flag, timeout)` | 底层接口：从缓冲中读取直到匹配 flag |
-
-## 特色
-
-- **回显着色**：匹配到 flag 的行为绿色，命令回显行为青色，其余灰色。
-- **拼行匹配**：设备折行时会自动拼接多行进行 flag 匹配，提高成功率。
-- **跨进程互斥**：基于文件锁，确保多进程安全访问串口。
-- **异步读取**：后台线程实时消费串口数据，避免缓冲区溢出丢失数据。
-
-## 依赖
-
-- Python >= 3.7
-- pyserial >= 3.5
-- loguru >= 0.6.0

sdev-0.4.0/sdev.egg-info/PKG-INFO

@@ -1,119 +0,0 @@
-Metadata-Version: 2.4
-Name: sdev
-Version: 0.4.0
-Summary: 串口控制器工具包
-Home-page: https://github.com/klrc/sdev
-Author: klrc
-Author-email: klrc <144069824@qq.com>
-License: MIT
-Project-URL: Homepage, https://github.com/klrc/sdev
-Project-URL: Repository, https://github.com/klrc/sdev
-Project-URL: Bug Tracker, https://github.com/klrc/sdev/issues
-Keywords: serial,controller,hardware,embedded
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Hardware
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyserial>=3.5
-Requires-Dist: loguru>=0.6.0
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# SDEV
-
-串口控制器工具包：后台按行读缓冲、按 flag 扫描与回显着色、执行命令、存活检测。
-
-**注意**：同一串口同一时间只能被一个 sdev 进程使用。系统会自动处理跨进程锁，后来的进程会阻塞等待。
-
-## 安装
-
-```bash
-pip install sdev
-```
-
-## 命令行用法
-
-安装后可使用 `sdev` 命令。默认会执行存活检测（check_alive）。
-
-```bash
-# 执行单条命令并回显
-sdev shell "lsmod | grep -E 'mmz|nnp|vdsp'"
-
-# 指定串口和波特率
-sdev -p /dev/ttyUSB1 -b 115200 shell "ls"
-
-# 跳过存活检测执行命令
-sdev --no-check-alive shell "echo hello"
-
-# 检查本机所有串口状态
-sdev demoboard status
-```
-
-- `-p` / `--port`：串口路径（默认取环境变量 `SDEV_PORT` 或 `/dev/ttyUSB0`）
-- `-b` / `--baudrate`：波特率（默认取 `SDEV_BAUDRATE` 或 `115200`）
-- `--flag`：提示符结束标志（默认 `" #"`）
-- `--timeout`：等待输出超时秒数
-
-## Python API 使用
-
-推荐使用 `sdev()` 工厂函数或 `Demoboard` 类，它们提供了更高层的封装。
-
-### 推荐做法
-
-```python
-from sdev import sdev
-
-# 使用上下文管理器，自动处理 connect() / disconnect()
-with sdev("/dev/ttyUSB0", 115200) as board:
-    # 默认 connect 时会阻塞直到拿到串口锁
-    # 执行命令，返回输出行列表
-    output = board.shell("ls")
-    print(output)
-```
-
-### 存活检测
-
-`Demoboard.check_alive()` 能够处理设备处于 U-Boot、内核启动中或已进入 Shell 的各种状态：
-
-```python
-with sdev("/dev/ttyUSB0") as board:
-    # 自动识别 U-Boot 并执行 reboot，直到进入 Shell
-    board.check_alive() 
-    board.shell("cat /proc/version")
-```
-
-### 核心 API 说明
-
-| 类/方法 | 说明 |
-|-------------|------|
-| `sdev(port, baudrate, device_type="demoboard")` | 工厂函数，返回设备实例（Demoboard 或 Relay） |
-| `Demoboard.shell(cmd, prompt_flag=" #", timeout=None, stream=False)` | 执行命令。`stream=True` 时返回 generator |
-| `Demoboard.check_alive(...)` | 综合检查存活状态，支持 U-Boot 自动重启和等待唤醒 |
-| `SerialDevice.send(text)` | 底层接口：发送一行（自动加换行） |
-| `SerialDevice.scan(end_flag, timeout)` | 底层接口：从缓冲中读取直到匹配 flag |
-
-## 特色
-
-- **回显着色**：匹配到 flag 的行为绿色，命令回显行为青色，其余灰色。
-- **拼行匹配**：设备折行时会自动拼接多行进行 flag 匹配，提高成功率。
-- **跨进程互斥**：基于文件锁，确保多进程安全访问串口。
-- **异步读取**：后台线程实时消费串口数据，避免缓冲区溢出丢失数据。
-
-## 依赖
-
-- Python >= 3.7
-- pyserial >= 3.5
-- loguru >= 0.6.0