菜单
Serial communication skill for embedded Linux boards. Provides auto-detection, login verification, and command execution. Invoke when user needs serial port interaction, board verification, or command execution via serial console.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
嵌入式Linux视觉AI应用框架的开发技能集合，支持RK3562/i.MX6ULL开发板的编译、调试和部署。
当需要配置或构建基于 CMake/Makefile 的 Linux 应用工程（如 i.MX6ULL/RK3562 开发板）时使用，支持交叉编译和本地编译。
当需要调试 Linux 应用程序时使用，支持本地调试和远程 GDB 调试（如 RK3562 开发板）。
嵌入式C语言编码规范，适用于安全关键嵌入式系统。强制执行OOP设计模式、内存安全、线程安全、硬件交互规则和强制的编辑后安全审查。在编写、修改或审查C代码、嵌入式固件、驱动、HAL代码、RTOS任务或任何运行在嵌入式平台上的代码时使用此Skill。当用户提到C语言、嵌入式系统、MCU、STM32、驱动、外设或固件开发时也会触发。
用于嵌入式Linux开发板的SSH远程连接和NFS网络文件共享开发流程。支持自动连接、文件同步、远程执行等操作。
| name | serial-communication |
| description | Serial communication skill for embedded Linux boards. Provides auto-detection, login verification, and command execution. Invoke when user needs serial port interaction, board verification, or command execution via serial console. |
.trae/skills/serial-communication/
├── SKILL.md # 技能定义文件
├── references/
│ └── usage.md # 详细使用指南
└── scripts/
├── linux/ # WSL2/Linux 专用脚本
│ ├── __init__.py
│ └── serial_tool.py # 串口通信工具（CLI）
├── shared/ # 跨平台共享代码
│ ├── __init__.py
│ ├── discovery.py # 串口设备发现
│ ├── login_check.py # 自动登录验证
│ ├── serial_core.py # 串口核心功能
│ └── serial_pexpect.py # pexpect 终端封装
├── windows/ # Windows 专用脚本
│ └── wsl2_usb_forward.py # WSL2 USB 转发工具
└── requirements.txt # Python 依赖
/dev/ttyACM*, /dev/ttyUSB*; Windows: COM*)1. 探测串口设备 → scripts/discovery.py
2. 选择目标串口 → resolve_port()
3. 建立串口连接 → SerialSession.open()
4. 自动登录验证 → login_check.py
5. 执行验证命令 → run_command()
6. 捕获输出结果 → read_available_text()
7. 关闭连接 → close()
用户请求验证 →
自动检测串口 →
建立连接 →
检测登录提示 →
发送用户名 →
检测 Shell 提示符 →
执行验证命令 →
返回结果
/dev/ttyUSB0 或 COM3，不提供则自动检测uname -a[serial-check] selected port: /dev/ttyUSB0
[serial-check] detected login prompt -> send root
[serial-check] detected shell prompt -> send command: uname -a
Linux rk3562 5.4.61 #1 SMP PREEMPT ...
root@rk3562:~#
ERROR: No serial port found. Please check USB connection or specify port manually.
ERROR: timed out waiting for login prompt or command output
picocom 作为串口终端（需要安装）pexpect 进行交互式登录/dev/ttyACM* 和 /dev/ttyUSB*pyserial 直接连接COM* 端口pyserial - 串口通信核心库pexpect - 交互式终端（Linux 推荐）picocom - 串口终端程序（可选）# WSL2/Linux 环境
from scripts.shared import SerialSession, make_serial_config, run_login_check
# 方式1：自动检测并验证
result = run_login_check(
port="", # 自动检测
baudrate=115200,
username="", # 无密码登录
password="",
cmd="uname -a; ls /mnt/nfs",
wait_sec=120
)
# 方式2：指定串口并带密码登录
result = run_login_check(
port="/dev/ttyUSB0",
baudrate=115200,
username="root",
password="123456",
cmd="cd /mnt/nfs && ./myapp",
wait_sec=60
)
# === WSL2/Linux 环境 ===
# 自动检测串口并执行命令
python .trae/skills/serial-communication/scripts/linux/serial_tool.py login-check --cmd "uname -a"
# 指定串口和验证命令
python .trae/skills/serial-communication/scripts/linux/serial_tool.py login-check --port /dev/ttyUSB0 --cmd "ls /mnt/nfs"
# 带密码登录
python .trae/skills/serial-communication/scripts/linux/serial_tool.py login-check --port /dev/ttyUSB0 --username root --password 123456 --cmd "./myapp"
# === Windows 环境（USB 转发）===
# 列出所有 USB 设备（Windows PowerShell）
python .trae/skills/serial-communication/scripts/windows/wsl2_usb_forward.py list
# 自动检测并转发串口设备（需要管理员权限）
python .trae/skills/serial-communication/scripts/windows/wsl2_usb_forward.py auto
# 手动指定 BUSID 转发
python .trae/skills/serial-communication/scripts/windows/wsl2_usb_forward.py forward --busid 3-3
| 错误类型 | 返回值 | 处理建议 |
|---|---|---|
No serial port found | RuntimeError | 检查 USB 连接，确认驱动已加载 |
Login timeout | 1 | 检查波特率设置，确认板子已启动 |
Command timeout | 1 | 增加等待时间，检查命令是否卡住 |
pexpect not installed | 2 | 执行 pip install pexpect |
picocom not installed | 2 | 执行 sudo apt-get install picocom |
build-linux-app - 编译完成后需要验证flash-deploy - 烧录完成后需要验证debug-linux-app - 验证失败时启动调试board-workflow - 作为自动化流程的一部分rm -rf、dd、reboot 等破坏性命令sudo 等特权命令