MSPM0 固件配置助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4b09efbc/mspm0-skill。
技能介绍
MSPM0 固件工程常因 SysConfig 配置分散、生成代码被手改、引脚冲突等问题变得脆弱。本技能面向 TI MSPM0 项目,约束 Agent 在 SysConfig、DriverLib 与工具链之间保持一致工作流。
核心能力与关键步骤
- 定位工程入口:识别
.syscfg、生成的ti_msp_dl_config.h以及目标配置,按 CCS、Keil 或 CMake/OpenOCD 分别判断构建路径。 - 以配置为唯一事实源:外设、时钟、中断、DMA 与引脚复用优先通过
.syscfg修改,再走生成或构建流程;禁止手改生成输出,保留@cliArgs、--device、--package等元数据。 - 降低猜测风险:遇到不熟悉的 SysConfig 字段时,先查本地
.syscfg、examples/*/manifest.json、SDK 示例或.meta/*.syscfg.js;不杜撰设备、包名、板名或工具版本。 - 辅助检查与调试:用
scripts/check_syscfg.py做静态体检,用scripts/ccs_dss_debug.py读取复位与寄存器状态,验证.ccxml调试路径;针对已验证板卡,优先使用 DSLite System Reset。
适用边界与注意点
- 不改基础属性:未经确认不得变更 device、package、SDK、编译器、CCS 版本、板卡或调试探头。
- 硬件验证分阶段:SysConfig 生成或构建通过不代表硬件行为正确;未在实物上验证时,应明确说明验证止步于源码、配置或构建层面。
- 板卡引脚强约束:针对自定义 MSPM0G3519 LQFP-64 板,
PA2、PA5、PA6、PA19、PA20完全不可用作普通外设;PA18为 BSL 入口兼 BACK 键,复位时拉高会阻止固件运行。已被占用的引脚(如PA0/PA1软件 I2C OLED、PB6-PB9SPI Flash 等)在无确认时不得重新分配。LCKFB 天门星 MSPM0G3507 的A21/PA21等特殊引脚同样需谨慎。 - 尊重工程形态:简单工程可小范围修改
main.c;框架类工程须先确认app/、bsp/、drivers/等目录边界。存在 FreeRTOS 时,保持现有任务与 ISR 边界,不强行套用特定架构。
使用场景
- 使用 CCS 开发 MSPM0 工程时,需要在不改坏现有配置的前提下为 UART 分配可用引脚。
- 修改自定义 MSPM0G3519 板卡的外设功能前,检查目标引脚是否与板载 OLED、IMU 等复用冲突。
- 基于 Keil 的工程重新生成 SysConfig 后,核对 ti_msp_dl_config.h 中的宏与初始化函数命名。
- 使用 CMake 与 OpenOCD 烧录固件时,排查 CMSIS-DAP 探头识别失败与构建错误。
适合人员
- 基于 TI MSPM0 开发智能硬件的嵌入式工程师,需要在多工具链间维护外设配置一致性。
- 使用 CLI 编程助手自动生成或重构 MSPM0 固件底层驱动的开发者。
- 自制 MSPM0 开发板或扩展板的电子工程师,需要规避高冲突引脚及 BSL 陷阱。