
Serial
A comprehensive serial port debugging toolkit that handles everything from port scanning to live monitoring, hex viewing, and logging. It automatically detects available ports when you don't specify one, supports both text and binary protocols, and includes a multiplexing server so you can run minicom and monitoring scripts simultaneously without port conflicts. The config priority chain (CLI args, workspace config, state file, defaults) is sensible, and it persists your working parameters back to the project config after successful runs. Built for embedded work with AT commands, UART debugging, and MCU output inspection. The mux architecture using socat and TCP broadcast is clever but watch out for write collisions if multiple clients try sending at once.
- skills.sh installs
- 847
- GitHub stars
- 791
- last updated
- Aug 21, 2026
Install
$ npx -y skills add zhinkgit/embeddedskills --skill serial --agent claude-codeInstalls into .claude/skills of the current project.
Files
Serial — 嵌入式串口调试工具
统一封装端口发现、实时监控、数据发送、日志记录和 Hex 查看能力。
配置
环境级配置 (skill/config.json)
serial skill 的环境级配置目前为空对象 {},因为串口参数属于工程级配置,统一在工作区的 .embeddedskills/config.json 中管理。
工程级配置 (.embeddedskills/config.json)
工作区下的 .embeddedskills/config.json 存放工程级串口配置:
{
"serial": {
"port": "",
"baudrate": 115200,
"bytesize": 8,
"parity": "none",
"stopbits": 1,
"encoding": "utf-8",
"timeout_sec": 1.0,
"log_dir": ".embeddedskills/logs/serial"
}
}
| 字段 | 说明 | 默认值 |
|---|---|---|
port | 串口号,如 COM3 | "" |
baudrate | 波特率 | 115200 |
bytesize | 数据位 | 8 |
parity | 校验位:none/even/odd/mark/space | none |
stopbits | 停止位:1/1.5/2 | 1 |
encoding | 文本编码 | utf-8 |
timeout_sec | 读写超时(秒) | 1.0 |
log_dir | 日志输出目录 | .embeddedskills/logs/serial |
参数解析优先级
- CLI 参数 (
--port,--baudrate等) - 最高优先级 - 工程级配置 (
.embeddedskills/config.json中的serial部分) - 状态文件 (
.embeddedskills/state.json中的历史记录) - 默认值 - 最低优先级
自动扫描行为
当未指定 port 时,脚本会自动扫描系统串口:
- 若只找到一个串口,自动使用该端口并写入工程配置
- 若找到多个串口,返回候选列表让用户选择(通过
--port指定) - 若未找到串口,提示错误
子命令
Sponsors
Details
- Repository
- github.com/zhinkgit/embeddedskills
- First seen
- Jun 3, 2026