原始内容
面向MSPM0 开发与电赛备赛，适用于 Claude Code、Codex、OpenCode、OpenClaw、Continue、Cursor 等 CLI / 编辑器 Agent。这是一组经过真实项目验证的规则、脚本、例程和调试 Skill。
[!IMPORTANT] 已在 立创天猛星 MSPM0G3507 + CCS Theia / CLion + J-Link / DAPLink 环境中完成真实板级验证。Agent 能直接修改
.syscfg、调用现有工具链构建，并根据探针选择 DSLite、CCS-DSS 或 OpenOCD 路径。
核心亮点
| 能力 | 能解决什么问题 |
|---|---|
| 直接理解 SysConfig | 检查和修改 .syscfg，保留 metadata、时钟树、PinMux、DMA 与中断配置，不直接篡改 ti_msp_dl_config.c/.h |
| 识别工程与工具链 | 区分 CCS、Keil/uVision、CMake + GCC/OpenOCD，以及简单工程、分层框架和 FreeRTOS 工程 |
| 自动构建与烧录 | 固化 SysConfig CLI、gmake、TI Arm Clang、CMake、DSLite/J-Link 和 OpenOCD 工作流 |
| 连接真实硬件调试 | 支持 CCS-DSS 与 OpenOCD/GDB 两条调试链路，辅助断点、寄存器、符号和复位检查 |
| 串口闭环验证/调参 | Python 串口收发、文本帧/二进制测试，可用于 PID 与控制参数调试 |
| 例程与 SDK 检索 | 优先利用用户工程和 TI SDK 官方例程，同时提供经过验证的 GPIO、PWM、Timer、UART/DMA 样例 |
快速安装
npx skills add mc3545dada/mspm0-skill@mspm0-ccs
也可以只复制本仓库的可安装目录：
skills/mspm0-ccs/
| Agent | 常见安装位置 |
|---|---|
| Claude Code | ~/.claude/skills/mspm0-ccs/ |
| Codex 等 | ~/.agents/skills/mspm0-ccs/ |
| OpenClaw | ~/.openclaw/skills/mspm0-ccs/ |
Windows PowerShell 手动安装
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\mspm0-ccs "$env:USERPROFILE\.claude\skills\mspm0-ccs"
运行环境
- 辅助脚本需要 Python 3.10 或更高版本。
- 串口工具额外需要
pyserial：python -m pip install pyserial。 - SDK、SysConfig、CCS/UniFlash、OpenOCD、GDB 等开发工具不会随 skill 自动安装，只需准备当前工作流实际使用的工具。
快速使用
安装skill后，确认你已经配置好了IDE/工具链/烧录器(也可让Agent检查)
连接烧录器后，可以直接尝试
在 MSPM0 工程目录中直接告诉 Agent：
请使用 mspm0-ccs skill，检查当前工程的 .syscfg 和工具链，
为立创天猛星 PB22 板载 LED 配置 1 秒闪烁，完成构建并烧录。
也可以针对现有工程继续开发：
请使用 mspm0-ccs skill，(读取AGENTS.md) 保留现有工程结构和无关配置，
为我选择一个可用的串口并告诉我连接方式，之后用 Python 串口工具验证回显。
对于新项目，建议使用Plan模式开始开发
对于所有需要外接模块的情况，建议提供模块数据手册给Agent
开发前，建议根据自己风格让其设计AGENTS.md文件(如划分BSP/APP目录等)
Agent 会先识别工程结构、.syscfg、生成符号、构建方式和探针，再选择对应流程；不会默认把示例目录结构强行搬进用户工程。
实战展示
2024 年电赛 H 题：全程使用本 skill 开发
从需求分析、SysConfig 外设配置、工程修改到板级调试均由本 skill 辅助完成，可作为端到端使用参考。
 |
 |
| SysConfig、编译与烧录结果 | 串口收发与 VOFA+ 验证 |
更多过程截图见 assets/screenshots/。
已验证环境
| 类别 | 已验证组合 |
|---|---|
| 开发板 | 立创天猛星 MSPM0G3507 |
| IDE / 环境 | CCS Theia、Keil、VS Code、CLion |
| SDK / SysConfig | MSPM0 SDK 2.10.00.04、SysConfig 1.26.2 |
| 编译器 | TI Arm Clang 4.x LTS、Arm GNU Toolchain / CMake |
| 探针 | J-Link、XDS110、DAPLink / CMSIS-DAP |
| 烧录与调试 | UniFlash / DSLite、CCS-DSS、OpenOCD / GDB |
| 外设 | GPIO、PWM、Timer、UART + DMA、I2C、SPI、ADC等 |
其他开发板、芯片封装、SDK/CCS/Keil/CMake 版本和调试器可能同样可用，但尚未全部实机验证。迁移到新组合时，建议先完成最小点灯、串口或定时器测试。
内置例程
| 例程 | 主频 | 主要内容 |
|---|---|---|
empty_project |
32 MHz | 空工程基线 |
led_blink |
32 MHz | PB22 板载 LED 闪烁 |
pwm_breath_led |
80 MHz | PB22 / TIMG PWM 呼吸灯 |
timer_irq_led |
80 MHz | TIMG12 1 ms 中断，ISR 每 500 ms 翻转 PB22 |
uart_blocking_tx |
80 MHz | UART0 阻塞发送字符串 |
uart_dma_tx_irq_rx |
80 MHz | 双 UART、DMA 发送、中断/轮询接收与文本帧解析 |
例程是经过验证的参考，不是必须照搬的模板。Agent 应以用户现有工程结构为准，只提取需要的 .syscfg 字段、代码模式或调试经验。
常用脚本与命令
以下命令默认在本仓库根目录执行；从其他目录调用时请使用脚本绝对路径。
检查 MSPM0 工程：
python skills\mspm0-ccs\scripts\check_syscfg.py C:\path\to\project
只读识别探针并对比工程配置：
python skills\mspm0-ccs\scripts\detect_probe.py
python skills\mspm0-ccs\scripts\check_syscfg.py C:\path\to\project --probe
探针检测为空只表示“当前方法未识别”，不能直接断言烧录器未连接。部分 DAPLink/CMSIS-DAP 或 XDS110 会表现为复合 USB 设备或虚拟串口，可继续检查：
python skills\mspm0-ccs\scripts\serial_console.py --list
Get-PnpDevice -PresentOnly
串口收发测试：
python skills\mspm0-ccs\scripts\serial_console.py --list
python skills\mspm0-ccs\scripts\serial_console.py -p COM6 -b 115200 --timestamp --duration 10
python skills\mspm0-ccs\scripts\serial_console.py -p COM6 -b 115200 --send "ping" --send-line --timestamp --duration 3
查看内置例程和搜索 TI SDK：
python skills\mspm0-ccs\scripts\list_examples.py
python skills\mspm0-ccs\scripts\index_syscfg_examples.py C:\ti\mspm0_sdk_2_10_00_04 --board LP_MSPM0G3507 --module UART
CCS-DSS 调试：
python skills\mspm0-ccs\scripts\ccs_dss_debug.py C:\path\to\project probe --leave-running
python skills\mspm0-ccs\scripts\ccs_dss_debug.py C:\path\to\project run-to-symbol --symbol main --load --reset "System Reset"
OpenOCD/GDB 调试，需要含 TI MSPM0 扩展的 OpenOCD：
python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project probe
python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project flash
python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project registers
python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project run-to-symbol --symbol main
使用前须知
- 修改
.syscfg后需要重新运行 SysConfig 或重新构建工程。 - 烧录前确认 CCS
targetConfigs/*.ccxml、Keil 调试器配置或 OpenOCD.cfg与真实探针一致。 - CCS-DSS 与 OpenOCD/GDB 是两条独立调试路径，不要混用配置。
- 同一探针不要并行运行多个 OpenOCD 操作；遇到芯片锁定或保护时停止自动操作并提示用户手动解锁。
- 串口测试前关闭 VOFA+ 等占用同一串口的软件。
- 不确定硬件行为时应区分“代码/构建验证通过”和“真实板级验证通过”。
参考资料
开源协议
本项目使用 MIT License。