AI Closed-Loop Debugging for Embedded Systems

AI 自主闭环调试 —— 让 AI Agent 成为嵌入式开发者的远程手和眼

作者：Seeed

快速开始

# Linux / WSL
bash 00-QUICK-START.sh

# Windows
双击 00-QUICK-START.bat

什么是 AI 闭环调试？

闭环调试（Closed-Loop Debugging） 是指 AI Agent 在编译/开发环境中，通过某种通信通道自主地：

1. 感知 — 读取设备日志、寄存器状态、传感器数据
2. 决策 — 大模型分析当前状态，决定下一步操作
3. 执行 — 向设备发送命令、烧录固件、修改配置
4. 循环 — 回到第 1 步，直到问题解决

传统调试：人 → 敲命令 → 看输出 → 思考 → 再敲命令 → ...
闭环调试：人 → 描述问题 → AI 自主完成上面整个循环 → 报告结论

五种方案

方案	传输层	适用设备	AI 闭环能力
FRP + 串口	TCP 隧道	Linux 嵌入式 / MCU	日志读取、命令执行
USBIP + 调试器	USB over IP	Cortex-M / RISC-V MCU	断点调试、寄存器读写、烧录
ESP32 透传	WiFi TCP	STM32 等 MCU	日志读取、命令执行
ADB	USB / TCP	RK / 全志 / NXP 开发板	Shell + 文件 + 日志 + 截屏
SSH	SSH	Linux 嵌入式板	Shell 全功能

快速选型

你的设备是什么？
│
├─ MCU（无操作系统）
│   ├─ 需要断点/寄存器调试 → USBIP + 调试器
│   └─ 只需要串口日志/命令 → ESP32 透传（同网段）
│                              或 FRP + 串口（跨网段）
│
└─ Linux 开发板
    ├─ 支持 ADB → ADB（功能最丰富，支持截屏）
    ├─ 有 SSH → SSH 直连（最简单）
    └─ 只有串口 → FRP + 串口

仓库结构

ai-closed-loop-debug/
├── README.md                    # 你正在看的
├── LICENSE
├── 00-QUICK-START.sh            # Linux/WSL 一键启动
├── 00-QUICK-START.bat           # Windows 一键启动
│
├── docs/                        # 核心文档库
│   ├── index.md                 # 文档导航
│   ├── remote-serial/           # FRP + 串口方案
│   ├── remote-debugger/         # USBIP + GDB 方案
│   ├── embedded-devices/        # ESP32 + ADB 方案
│   ├── remote-ssh/              # SSH 方案
│   └── common/                  # 公共：驱动、故障排查、环境自检
│
├── scripts/                     # 一键部署脚本
│   ├── windows/                 # Windows 版
│   └── linux/                   # Linux/WSL 版
│
├── configs/                     # 现成配置模板（改 IP 就能用）
│   ├── frp/                     # FRP 客户端+服务端配置
│   ├── ser2net/                 # ser2net 串口转 TCP 配置
│   ├── openocd/                 # OpenOCD 调试器配置
│   └── udev/                    # Linux udev 规则
│
├── examples/                    # AI 闭环示例代码
│   ├── python/                  # Python 示例
│   └── shell/                   # Shell 验证脚本
│
├── tools/                       # 内置工具和驱动
│   ├── binaries/                # FRP / ADB / OpenOCD 二进制
│   └── drivers/                 # USB 转串口 / 调试器驱动
│
└── logs/                        # 部署和调试日志

各方案核心依赖

方案	必备软件	必备驱动/硬件
FRP + 串口	FRP, ser2net/socat	USB 转串口 (CP210x/CH340/FTDI)
USBIP + 调试器	USBIP, OpenOCD, GDB	ST-Link/J-Link, SWD/JTAG 接口
ESP32 透传	ESP-IDF 或 Arduino IDE	ESP32 开发板
ADB	Android Platform Tools	厂商 USB 驱动
SSH	OpenSSH / Dropbear	无

所有驱动安装详见 docs/common/drivers.md 故障排查详见 docs/common/troubleshooting.md 环境自检：bash docs/common/env-check.sh 或双击 docs\common\env-check.bat

适用场景

• 远程办公，开发板在公司/实验室，人在家
• AI Agent（Claude Code、Codex、Cursor 等）需要直接与硬件交互
• 自动化硬件测试与回归验证
• 多人共享同一套硬件调试环境

贡献

欢迎提交 PR 补充新的方案或改进现有文档。

License

MIT