Skip to content
Back to search

mspm0-skill

面向电赛的 MSPM0 + SysConfig Agent Skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mc3545dada--mspm0-skill/badge.svg)](/listings/mc3545dada--mspm0-skill)

HTML

<a href="/listings/mc3545dada--mspm0-skill"><img src="/api/listings/mc3545dada--mspm0-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # MSPM0 Skill
  3. **让 AI Agent 真正参与 MSPM0 的 SysConfig 配置、工程构建、烧录与调试。**
  4. [![GitHub Stars](https://img.shields.io/github/stars/mc3545dada/mspm0-skill?style=for-the-badge&logo=github&color=F4B400)](https://github.com/mc3545dada/mspm0-skill/stargazers)
  5. [![Latest Release](https://img.shields.io/github/v/release/mc3545dada/mspm0-skill?style=for-the-badge&color=2EA44F)](https://github.com/mc3545dada/mspm0-skill/releases/latest)
  6. [![TI MSPM0](https://img.shields.io/badge/TI-MSPM0-C8102E?style=for-the-badge)](https://www.ti.com/microcontrollers-mcus-processors/arm-based-microcontrollers/arm-cortex-m0-mcus/overview.html)
  7. [![License](https://img.shields.io/github/license/mc3545dada/mspm0-skill?style=for-the-badge&color=1673B1)](LICENSE)
  8. [快速安装](#快速安装) · [快速使用](#快速使用) · [亮点](#核心亮点) · [实战展示](#实战展示) · [内置例程](#内置例程)
  9. </div>
  10. 面向MSPM0 开发与电赛备赛,适用于 Claude Code、Codex、OpenCode、OpenClaw、Continue、Cursor 等 CLI / 编辑器 Agent。这是一组经过真实项目验证的规则、脚本、例程和调试 Skill。
  11. > [!IMPORTANT]
  12. > 已在 **立创天猛星 MSPM0G3507 + CCS Theia / CLion + J-Link / DAPLink** 环境中完成真实板级验证。Agent 能直接修改 `.syscfg`、调用现有工具链构建,并根据探针选择 DSLite、CCS-DSS 或 OpenOCD 路径。
  13. ## 核心亮点
  14. | 能力 | 能解决什么问题 |
  15. | --- | --- |
  16. | **直接理解 SysConfig** | 检查和修改 `.syscfg`,保留 metadata、时钟树、PinMux、DMA 与中断配置,不直接篡改 `ti_msp_dl_config.c/.h` |
  17. | **识别工程与工具链** | 区分 CCS、Keil/uVision、CMake + GCC/OpenOCD,以及简单工程、分层框架和 FreeRTOS 工程 |
  18. | **自动构建与烧录** | 固化 SysConfig CLI、gmake、TI Arm Clang、CMake、DSLite/J-Link 和 OpenOCD 工作流 |
  19. | **连接真实硬件调试** | 支持 CCS-DSS 与 OpenOCD/GDB 两条调试链路,辅助断点、寄存器、符号和复位检查 |
  20. | **锁定诊断与恢复引导** | 辅助区分探针断连、MEM-AP 不可用和 NONMAIN/安全策略异常,并在用户授权擦除后引导 UART BSL、DSSM Mass Erase 或 Factory Reset 恢复 |
  21. | **串口闭环验证/调参** | Python 串口收发、文本帧/二进制测试,可用于 PID 与控制参数调试 |
  22. | **例程与 SDK 检索** | 优先利用用户工程和 TI SDK 官方例程,同时提供经过验证的 GPIO、PWM、Timer、UART/DMA 样例 |
  23. ## 快速安装
  24. ```bash
  25. npx skills add mc3545dada/mspm0-skill@mspm0-ccs
  26. ```
  27. 也可以只复制本仓库的可安装目录:
  28. ```text
  29. skills/mspm0-ccs/
  30. ```
  31. | Agent | 常见安装位置 |
  32. | --- | --- |
  33. | Claude Code | `~/.claude/skills/mspm0-ccs/` |
  34. | Codex 等 | `~/.agents/skills/mspm0-ccs/` |
  35. | OpenClaw | `~/.openclaw/skills/mspm0-ccs/` |
  36. <details>
  37. <summary><strong>Windows PowerShell 手动安装</strong></summary>
  38. ```powershell
  39. New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
  40. Copy-Item -Recurse -Force .\skills\mspm0-ccs "$env:USERPROFILE\.claude\skills\mspm0-ccs"
  41. ```
  42. </details>
  43. ### 运行环境
  44. - 辅助脚本需要 Python 3.10 或更高版本。
  45. - 串口工具额外需要 `pyserial`:`python -m pip install pyserial`。
  46. - SDK、SysConfig、CCS/UniFlash、OpenOCD、GDB 等开发工具不会随 skill 自动安装,只需准备当前工作流实际使用的工具。
  47. ## 快速使用
  48. 安装skill后,确认你已经配置好了IDE/工具链/烧录器(也可让Agent检查)
  49. 连接烧录器后,可以直接尝试
  50. 在 MSPM0 工程目录中直接告诉 Agent:
  51. ```text
  52. 请使用 mspm0-ccs skill,检查当前工程的 .syscfg 和工具链,
  53. 为立创天猛星 PB22 板载 LED 配置 1 秒闪烁,完成构建并烧录。
  54. ```
  55. 也可以针对现有工程继续开发:
  56. ```text
  57. 请使用 mspm0-ccs skill,(读取AGENTS.md) 保留现有工程结构和无关配置,
  58. 为我选择一个可用的串口并告诉我连接方式,之后用 Python 串口工具验证回显。
  59. ```
  60. 对于新项目,建议使用Plan模式开始开发
  61. 对于所有需要外接模块的情况,建议提供模块数据手册给Agent
  62. 开发前,建议根据自己风格让其设计AGENTS.md文件(如划分BSP/APP目录等)
  63. Agent 会先识别工程结构、`.syscfg`、生成符号、构建方式和探针,再选择对应流程;不会默认把示例目录结构强行搬进用户工程。
  64. ## 实战展示
  65. ### 2024 年电赛 H 题:全程使用本 skill 开发
  66. 仓库:**[2024hVibe:完整代码与 Agent 对话记录](https://github.com/mc3545dada/2024hVibe)**
  67. 从需求分析、SysConfig 外设配置、工程修改到板级调试均由本 skill 辅助完成,可作为端到端使用参考。
  68. - [2024 年电赛 H 题完整实战演示](https://www.bilibili.com/video/BV1w9Nc69EXP/)
  69. - [MSPM0 Skill 完整使用视频](https://www.bilibili.com/video/BV1RbLY6xECu)
  70. <table>
  71. <tr>
  72. <td width="50%"><img src="assets/screenshots/claude-code-summary.png" alt="Claude Code 完成 SysConfig、编译和烧录后的总结"></td>
  73. <td width="50%"><img src="assets/screenshots/vofa-output.png" alt="Codex 配置外设并通过 VOFA+ 查看串口输出"></td>
  74. </tr>
  75. <tr>
  76. <td align="center">SysConfig、编译与烧录结果</td>
  77. <td align="center">串口收发与 VOFA+ 验证</td>
  78. </tr>
  79. </table>
  80. 更多过程截图见 [`assets/screenshots/`](assets/screenshots/)。
  81. ## 已验证环境
  82. | 类别 | 已验证组合 |
  83. | --- | --- |
  84. | 开发板 | 立创天猛星 MSPM0G3507 |
  85. | IDE / 环境 | CCS Theia、Keil、VS Code、CLion |
  86. | SDK / SysConfig | MSPM0 SDK 2.10.00.04 / 2.11.00.07、SysConfig 1.26.2 / 1.28.0 CLI |
  87. | 编译器 | TI Arm Clang 4.x LTS、Arm GNU Toolchain / CMake |
  88. | 探针 | J-Link、XDS110、DAPLink / CMSIS-DAP |
  89. | 烧录与调试 | UniFlash / DSLite、CCS-DSS、OpenOCD / GDB |
  90. | 外设 | GPIO、PWM、Timer、UART + DMA、I2C、SPI、ADC等 |
  91. 其他开发板、芯片封装、SDK/CCS/Keil/CMake 版本和调试器可能同样可用,但尚未全部实机验证。迁移到新组合时,建议先完成最小点灯、串口或定时器测试。
  92. ## 内置例程
  93. | 例程 | 主频 | 主要内容 |
  94. | --- | --- | --- |
  95. | `empty_project` | 32 MHz | 空工程基线 |
  96. | `led_blink` | 32 MHz | PB22 板载 LED 闪烁 |
  97. | `pwm_breath_led` | 80 MHz | PB22 / TIMG PWM 呼吸灯 |
  98. | `timer_irq_led` | 80 MHz | TIMG12 1 ms 中断,ISR 每 500 ms 翻转 PB22 |
  99. | `uart_blocking_tx` | 80 MHz | UART0 阻塞发送字符串 |
  100. | `uart_dma_tx_irq_rx` | 80 MHz | 双 UART、DMA 发送、中断/轮询接收与文本帧解析 |
  101. 例程是经过验证的参考,不是必须照搬的模板。Agent 应以用户现有工程结构为准,只提取需要的 `.syscfg` 字段、代码模式或调试经验。
  102. <details>
  103. <summary><strong>常用脚本与命令</strong></summary>
  104. 以下命令默认在本仓库根目录执行;从其他目录调用时请使用脚本绝对路径。
  105. 检查 MSPM0 工程:
  106. ```powershell
  107. python skills\mspm0-ccs\scripts\check_syscfg.py C:\path\to\project
  108. ```
  109. 使用工程声明的 SysConfig/SDK 版本,在临时目录中安全验证生成结果:
  110. ```powershell
  111. python skills\mspm0-ccs\scripts\run_sysconfig.py C:\path\to\project
  112. ```
  113. 只读识别探针并对比工程配置:
  114. ```powershell
  115. python skills\mspm0-ccs\scripts\detect_probe.py
  116. python skills\mspm0-ccs\scripts\check_syscfg.py C:\path\to\project --probe
  117. ```
  118. 探针检测为空只表示“当前方法未识别”,不能直接断言烧录器未连接。部分 DAPLink/CMSIS-DAP 或 XDS110 会表现为复合 USB 设备或虚拟串口,可继续检查:
  119. ```powershell
  120. python skills\mspm0-ccs\scripts\serial_console.py --list
  121. Get-PnpDevice -PresentOnly
  122. ```
  123. 串口收发测试:
  124. ```powershell
  125. python skills\mspm0-ccs\scripts\serial_console.py --list
  126. python skills\mspm0-ccs\scripts\serial_console.py -p COM6 -b 115200 --timestamp --duration 10
  127. python skills\mspm0-ccs\scripts\serial_console.py -p COM6 -b 115200 --send "ping" --send-line --timestamp --duration 3
  128. ```
  129. 查看内置例程和搜索 TI SDK:
  130. ```powershell
  131. python skills\mspm0-ccs\scripts\list_examples.py
  132. python skills\mspm0-ccs\scripts\index_syscfg_examples.py C:\ti\mspm0_sdk_2_10_00_04 --board LP_MSPM0G3507 --module UART
  133. ```
  134. CCS-DSS 调试:
  135. ```powershell
  136. python skills\mspm0-ccs\scripts\ccs_dss_debug.py C:\path\to\project probe --leave-running
  137. python skills\mspm0-ccs\scripts\ccs_dss_debug.py C:\path\to\project run-to-symbol --symbol main --load --reset "System Reset"
  138. ```
  139. OpenOCD/GDB 调试,需要含 TI MSPM0 扩展的 OpenOCD:
  140. ```powershell
  141. python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project probe
  142. python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project flash
  143. python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project registers
  144. python skills\mspm0-ccs\scripts\openocd_debug.py C:\path\to\project run-to-symbol --symbol main
  145. ```
  146. </details>
  147. ## 使用前须知
  148. - 修改 `.syscfg` 后需要重新运行 SysConfig 或重新构建工程。
  149. - 烧录前确认 CCS `targetConfigs/*.ccxml`、Keil 调试器配置或 OpenOCD `.cfg` 与真实探针一致。
  150. - CCS-DSS 与 OpenOCD/GDB 是两条独立调试路径,不要混用配置。
  151. - 同一探针不要并行运行多个 OpenOCD 操作;遇到芯片锁定或保护时停止自动操作并提示用户手动解锁。
  152. - 串口测试前关闭 VOFA+ 等占用同一串口的软件。
  153. - 不确定硬件行为时应区分“代码/构建验证通过”和“真实板级验证通过”。
  154. ## 参考资料
  155. - [TI SysConfig](https://www.ti.com/tool/SYSCONFIG)
  156. - [TI MSPM0 SDK](https://www.ti.com/tool/MSPM0-SDK)
  157. - [TI MSPM0 SysConfig Guide](https://software-dl.ti.com/msp430/esd/MSPM0-SDK/2_05_01_00/docs/english/tools/sysconfig_guide/doc_guide/doc_guide-srcs/sysconfig_guide.html)
  158. - [TI LP-MSPM0G3507](https://www.ti.com.cn/tool/cn/LP-MSPM0G3507)
  159. - [立创天猛星 MSPM0G3507 文档](https://wiki.lckfb.com/zh-hans/tmx-mspm0g3507/)
  160. ## 开源协议
  161. 本项目使用 [MIT License](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.