DSP 自动调试（CodeBuddy Skill）

TI C2000 / DSP2833x 在 CCS12 / CCS6 上的全自动开发 + 调试闭环： 写代码 → 自动编译链接自检（不用打开 CCS 界面）→ 自动下载进调试器运行 → 读回寄存器/变量 → 失败自动分类并给出原因。

已在 DSP28335 + XDS100 + CCS12.8.1（ti-cgt-c2000_22.6.1.LTS） 上完成硬件实测； CCS6（ti-cgt-c2000_15.12.1.LTS）完成编译链接实测。

---

1. 它能做什么

能力	说明
编译 + 链接自检	ti_c2000_build.ps1：包含路径、汇编器版本、内存模型、浮点、输出格式、运行库、链接脚本全部从 .cproject 反推，换型号不用改脚本
自动进调试器	ti_c2000_debug.ps1：自动找 CCS 安装与仿真器 → 下载 → 复位跳到程序入口 → 运行 → 停机 → 读回表达式
就绪轮询	不再"盲等固定时间"：每 250 ms 采样一次就绪条件，命中即返回（大程序用 -RunMs 给上限，如 5 分钟）
长调试	-Background 自分离运行 + 日志轮询，避免上层命令超时打断
失败分类	失败必报 FAILURE: <分类> + REASON: <原因> + 非 0 退出码，绝不把失败说成成功

失败分类：COMPILE_ERRORS / LINK_ERRORS / TIMEOUT / CONNECT_FAILED / LOADTI_ERROR / LOADTI_TIMEOUT / NO_PROBE / NO_OUT_FILE / NO_CCXML / ENV_*（5 类已用真实失败实例验证）。

2. 目录结构

SKILL.md                          # 主文件：触发条件、铁律、SOP、防错清单、失败分类
README.md                         # 本文件
references/
  environment.md                  # 本机实测环境、已验证项、踩过的坑
  project-map.md                  # 工程结构、模块接口、引脚占用表
  dss-debug.md                    # loadti / DSS 用法与排错、长时调试
  other-devices-and-probes.md     # 其他 C2000 型号 + 其他仿真器/双核
docs/
  portability.md                  # 迁移到 Codex / Claude Code / 其他 agent 的步骤与差异
setup/
  Setup-CCS-Skills.ps1            # 一键部署（-Target codebuddy|claude|codex|custom）
scripts/
  ti_c2000_build.ps1              # 编译 + 链接自检
  ti_c2000_debug.ps1              # 构建 + 下载 + 运行 + 读回（支持后台/超时/核选择）
  dss_template.js                 # DSS 会话模板（占位符由 PS1 填充）
  dss_api_probe.js                # 换 CCS 版本时反射探测真实 DSS API

3. 安装

把整个文件夹放到 CodeBuddy 的 skills 目录：

Windows:  C:\Users\<你的用户名>\.codebuddy\skills\ti-c2000-ccs-auto\
Linux/mac: ~/.codebuddy/skills/ti-c2000-ccs-auto/

重启会话后，提到 DSP/C2000/CCS/调试/写程序或读写 DSP 头文件时会自动加载。

装给别的 agent（Codex / Claude Code / 任意目录）用仓库自带的部署脚本，-Target 选目录：

... \setup\Setup-CCS-Skills.ps1 -Target codex      # -> ~/.codex/skills/
... \setup\Setup-CCS-Skills.ps1 -Target claude     # -> ~/.claude/skills/
... \setup\Setup-CCS-Skills.ps1 -Target custom -SkillsRoot <目录>

迁移细节与差异见 docs/portability.md。

4. 依赖

• 必需：Code Composer Studio 12.x 或 6.x（自带 ti-cgt-c2000_* 编译器、ccs_base\scripting 下的 DSS 与 loadti）
• 可选：XDS100/110/200/510/560、SEGGER J-Link、Blackhawk、Spectrum Digital 等 JTAG 仿真器 （只做编译链接自检不需要硬件；TI 模拟器 tisim 目标也不需要）
• 运行环境：Windows + PowerShell 7.0+（pwsh，本机 7.6.6 实测），脚本首行 #requires -Version 7.0

5. 快速开始

# ① 只做编译+链接自检（几秒，不需要硬件、不打开 CCS）
pwsh -NoProfile -ExecutionPolicy Bypass -File "<skill>\scripts\ti_c2000_build.ps1" -ProjectPath "<CCS工程根目录>"

# ② 构建 + 下载运行
pwsh -NoProfile -ExecutionPolicy Bypass -File "<skill>\scripts\ti_c2000_debug.ps1" -ProjectPath "<工程>" -Build -Run

# ③ 构建 + 下载运行 + 读回寄存器/变量（最完整验证）
pwsh -NoProfile -ExecutionPolicy Bypass -File "<skill>\scripts\ti_c2000_debug.ps1" -ProjectPath "<工程>" -Build -Run `
  -ReadVars "EPwm1Regs.TBPRD,EPwm1Regs.CMPA.all,SciaRegs.SCILBAUD"

# ④ 5 分钟级长调试，后台跑
powershell ... -ProjectPath "<工程>" -Build -Run -RunMs 300000 -WaitFor "GPIO 状态表达式" -ReadVars "..." -Background

判定只看输出里的 RESULT: OK / RESULT: FAIL。

6. 常用参数

参数	作用
-ProjectPath	工程根目录（含 .cproject），省略时从当前目录向上查找
-Build	调试前先跑一次编译自检，失败即中止（分类透传）
-ReadVars "a,b,c"	停机读回的表达式/变量/寄存器（逗号分隔），走 DSS 通道
-WaitFor "<表达式>"	就绪判据（非 0 视为就绪）；默认取 -ReadVars 第一项 != 0
-RunMs	就绪轮询上限（默认 8000 ms）；命中即返回，设大不白等
-RunMs/-TimeoutSec	就绪上限 / loadti 超时（默认 180 s）
-Background	自分离运行，立即返回日志路径
-AllowNotReady	超时也照常返回读值（会提示值可能无效）
-Ccxml / -CorePattern	指定目标配置 / 双核选核（如 .*CPU1.*）
-CcsRoot / -CompilerRoot	指定 CCS / 编译器版本
-LinkCmd	追加链接命令文件（如 Flash 版 .cmd）
-NoProbeCheck	跳过仿真器前置检查
-ReadOnly	只读回，不复位不加载（程序已由别的方式跑着）

7. 已验证 / 未验证

已实测：DSP28335 + XDS100 + CCS12.8.1；编译链接用 CCS6 的 15.12.1.LTS 与 CCS12 的 22.6.1.LTS 均通过； 读回值与源码逐项吻合（TBPRD=65535、CMPA=0xCCCC=52428、CLKDIV=3、SCILBAUD=39）。

未实测：其他 C2000 型号（F2802x/F2806x/F2837x/F28004x/F2838x…）与其他仿真器，脚本按 TI 通用结构自动适配， 首次使用请先跑编译自检，再上调试器。

8. 注意

• scripts/*.ps1 要求 PowerShell 7.0+（首行 #requires -Version 7.0，示例统一用 pwsh）； 脚本仍保持纯 ASCII（历史约定 + 避免编码坑），中文说明一律放在 .md 里。
• 默认链接脚本多为 RAM 版（如 28335_RAM_lnk.cmd），掉电即失；要脱机运行需换 Flash 链接脚本。
• 调试器操作会打断目标板当前程序；-ReadVars 会复位并运行被加载的程序。
• 本仓库不含任何密钥；references/environment.md 里的路径是本机实测记录，可按需替换。

9. 迁移到其他 agent（Codex / Claude Code / …）

SKILL.md 用的是通用 skill 格式（name + description），scripts/*.ps1 是纯 PowerShell 调 CCS 命令行， 不含 CodeBuddy 专有 API，所以整套可以直接搬到别的 agent 用：

... \setup\Setup-CCS-Skills.ps1 -Target codex      # ~/.codex/skills/
... \setup\Setup-CCS-Skills.ps1 -Target claude     # ~/.claude/skills/
... \setup\Setup-CCS-Skills.ps1 -Target custom -SkillsRoot <目录>

只有 git 快照 hooks 是 CodeBuddy 专有（写在 ~/.codebuddy/settings.json，且匹配 CodeBuddy 的工具名）， 给别的 agent 安装时会自动跳过（也可 -NoHooks）。各 agent 的目录、触发方式差异、以及用 AGENTS.md 兜底的做法：docs/portability.md。