用途
本技能用于 TI MSPM0 固件项目,这些项目通过 SysConfig 和 DriverLib 进行配置与开发,工具链可以是 CCS / CCS Theia、Keil/uVision,或 CMake + Arm GNU Toolchain + OpenOCD。它面向 Claude Code、OpenCode、OpenClaw、Continue、Cursor、Codex 及类似的 CLI/编辑器智能体。
主要能力
- 定位项目中的 .syscfg 或 system.syscfg、可编辑源文件、生成的 ti_msp_dl_config.h,以及当前项目入口:CCS 的 targetConfigs/*.ccxml、Keil/uVision 的 *.uvprojx 加分散加载文件,或 CMake/GCC/OpenOCD 的 CMakeLists.txt 加 OpenOCD .cfg 文件。
- 读取 .syscfg 元数据:器件、封装、SDK 产品、SysConfig 版本、模块、实例、引脚、时钟和中断。
- 检查生成的 ti_msp_dl_config.h,获取宏名、IRQ 名、实例名以及 SysConfig 初始化函数的准确拼写。
- 在添加不熟悉的 SysConfig 字段前,检查用户现有 .syscfg、examples//manifest.json、TI SDK 示例或 source/ti/driverlib/.meta/.syscfg.js。
- 提供探针检测、SysConfig 校验、示例列举与捕获、串口控制台、CCS-DSS 调试、OpenOCD 调试等脚本。
使用方式
默认工作流:定位项目关键文件;在技能可用时运行 python scripts/check_syscfg.py <project-dir>;读取 .syscfg 元数据;检查生成的 ti_msp_dl_config.h;在添加不熟悉字段前查阅本地示例或 SDK 元数据;只修改最小相关的 .syscfg 与应用代码面;默认做最小且有依据的 .syscfg 编辑,并在重新构建前运行 python scripts/run_sysconfig.py <project-dir>。仅当用户明确要求或当前会话已暴露确认的 SysConfig MCP 工具时,才使用 CCS SysConfig MCP。
如需烧录或调试,先运行 python scripts/detect_probe.py 或 python scripts/check_syscfg.py <project-dir> --probe 再选择后端。确认配置的探针与连接的硬件匹配,烧录后优先执行系统复位。
核心规则
- 将 .syscfg 视为引脚复用、外设设置、时钟、中断、DMA 归属和生成初始化的真值来源。
- GPIO、UART、PWM、Timer、ADC、I2C、SPI、DMA 和时钟设置优先使用 SysConfig + DriverLib。
- 不要手改生成输出,例如 Debug/ti_msp_dl_config.c、Debug/ti_msp_dl_config.h、Keil 布局中项目根目录的 ti_msp_dl_config.c / ti_msp_dl_config.h、device_linker.cmd、Objects/、Listings/、目标文件、map 或 .out 文件。
- 保留 .syscfg 元数据,例如 @cliArgs、@v2CliArgs、@versions、--device、--package 和 --product。
- 不要猜测生成名称,应读取 ti_msp_dl_config.h 并使用本地宏和本地初始化函数拼写,例如 SYSCFG_DL_init()。
- 不要臆造 SysConfig 字段、枚举值、器件元数据、板名、封装名或工具版本。
- 未经用户确认,不要更改器件、封装、SDK、编译器、CCS 版本、板卡或调试探针。
- 如果用户只要求“烧录”或“调试”,不要默认假设 J-Link、XDS110、CMSIS-DAP/DAPLink 或 ST-Link,应先检测连接的探针。
- 空的探针检测结果视为不确定,而非证明没有探针连接。
- 如果 SysConfig 产生警告,应与构建/烧录成功分开报告,不要称产生警告的生成过程为“干净”。
- 如果硬件行为未在连接的板卡上验证,应说明验证止于源码、SysConfig 或构建层面。
适用场景
适用于 TI MSPM0 固件项目的配置、构建、烧录与调试辅助,包括 CCS、Keil/uVision、CMake/GCC/OpenOCD 工作流,以及 FreeRTOS 感知项目。也包含针对 LCKFB Tianmengxing MSPM0G3507 板卡的引脚注意事项。
限制
TI SDK、SysConfig、CCS/UniFlash、OpenOCD 和 GDB 仍是外部工作流依赖,本技能不安装它们。脚本需要 Python 3.10 或更高版本;serial_console.py 额外需要 pyserial,若导入失败需运行 python -m pip install pyserial。MSPM0 OpenOCD 烧录通常需要支持 TI MSPM0 的 OpenOCD 构建或 TI 扩展分支。若 OpenOCD 报告 unable to find a matching CMSIS-DAP device,应作为探针发现失败而非固件失败报告。