AixProbe 调试器 V821 上电配置指南
一、硬件接口说明
| 编号 | 接口 / 部件 | 功能说明 |
|---|---|---|
| 1 | BOOT 按键 | 用于系统烧录 |
| 2 | 拨码开关 | 用于 USB 调试与电平切换 |
| 3 | Type-C 接口 | 用于供电与 USB 调试 |
| 4 | Type-A 接口 | 用于外接设备 |
| 5 | Type-C 接口 | 用于 CH347F 直连电脑 |
| 6 | 用户按键 | 用于自定义功能 |
| 7 | LED 指示灯 | 用户自定义 LED1 |
| 8 | LED 指示灯 | 用户自定义 LED2 |
| 9 | LED 指示灯 | 电源指示灯 |
| 10 | LED 指示灯 | CH347F 就绪指示灯 |
二、安装全志烧录上位机
在电脑端安装全志（Allwinner）烧录上位机，安装过程中会自动同步安装所需驱动。
三、调试器功能配置
1. 连接 WiFi 天线
先将 WiFi 天线连接到调试器。
2. 配置拨码开关
拨码开关上带有ON丝印，将开关拨到丝印ON一侧即为ON状态。需要做如下设置：
- 拨码开关 4：拨到ON
- 拨码开关 1：拨到ON（选择 3.3V 电平）
3. Type-C 连接供电
使用 Type-C 线将硬件接口 3连接到电脑，等待约30 秒，系统启动完成。
4. 打开 AixProbe-UI
双击打开AixProbe-UI.exe，软件启动后会自动连接到调试器。
5. 配置 WiFi
注意：
- 当前仅支持2.4GWiFi。
- WiFi 名称（SSID）和密码仅支持英文，不支持中文。
配置项说明：
| 配置项 | 含义 |
|---|---|
xrlink_last_connected_ssid | WiFi 名称 |
xrlink_last_connected_pwd | WiFi 密码 |
6. OpenOCD 配置
在 OpenOCD 配置中设置正确的目标设备。
提示：如果对 OpenOCD 不熟悉，可以将完整的 OpenOCD 指令复制给 AI，让 AI 帮你输出正确的指令。
注意：并非所有 MCU 都被 OpenOCD 默认支持。若遇到不支持的型号，可检查芯片原厂是否提供特殊版本的 OpenOCD 源码，自行编译后放到调试器中使用。
7. DNS 名称配置（选配）
可以使用 DNS 名称代替 IP 地址访问调试器。当同时使用多个调试器时，建议修改各自的名称以避免冲突。
默认访问域名：aixprobe.local
四、电脑端 AI MCP 配置
1. 调试器断电
拔掉调试器，使其断电。
2. 修改拨码开关
将拨码开关 4拨到OFF。
3. 重新供电
重新插入 Type-C 供电（电脑或适配器均可），等待片刻。系统正常启动后，4 个 LED 指示灯全亮即表示就绪。
4. 验证网络连通性
在电脑端通过ping命令检查与调试器的网络连通性。只有 ping 通，电脑端的 AI 才能访问调试器的 MCP 服务。
pingaixprobe.local5. 配置 MCP
目前 AI Agent 客户端较多，MCP 配置入口各有差异，但配置方式类似，请根据所用客户端自行配置。
以Claude Code为例：
claude mcpadd--transporthttp aixprobe http://aixprobe.local:8080/mcp6. 部署 Skill 技能文件
MCP 配置完成后，将提供的 Skill 技能文件放到对应 AI 客户端的支持目录中。不同客户端的路径有所区别：
| AI 客户端 | Skill 路径 |
|---|---|
| Claude Code | .claude/skills/ |
| Trae | .trae/skills/ |
7. 准备 SVD 芯片描述文件（选配，强烈建议配置）
为了实现更精准的芯片级调试，建议准备目标平台的SVD（System View Description）文件，该文件通常由芯片厂商官方提供。
说明：配置 SVD 文件可避免 AI 在解读寄存器时出现错误描述，强烈建议配置。
不同架构的 SVD 文件可放到不同的目录中，便于管理。
五、开始调试
重要：配置完 AI MCP 后，需要重启 AI 客户端，否则新配置的 MCP 无法被识别。
一切就绪！现在可以直接在 AI 客户端中提问，开始调试。
- 主动调用：直接告诉 AI 使用 AixProbe 工具。
- 自动触发：无需特殊说明，当你描述的问题匹配到已部署的 Skill 技能时，AI 会自动调用相应的调试能力。
