mcpField
F
flash-keil

flash-keil

github.com/leokemp223开发1.0k568 次安装10 周前更新
代码仓库

关于 flash-keil

用于将 Keil MDK 工程固件烧录到目标板的技能，使用工程中配置的调试器和 Flash 算法，无需额外安装 OpenOCD。

主要功能

  1. 01探测 Keil UV4.exe
  2. 02识别工程配置的调试器
  3. 03使用工程 Flash 配置烧录
  4. 04生成包含状态和日志的结果报告

适用场景

  1. 01将 Keil 工程固件写入目标板
  2. 02检查烧录失败及连接问题
  3. 03烧录后交接串口监控或调试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/leokemp223/embed-ai-tool --skill flash-keil

安装后在 Claude Code 中输入/flash-keil确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
usage.md
scripts/
keil_flasher.py

详细介绍

来自项目 README

Keil MDK 烧录

适用场景

  • Project Profile 中标明 build_system: keil 或工作区中存在 .uvprojx / .uvproj 文件。
  • 用户希望将编译产物烧录到目标板，且工程已在 Keil 中配置好调试器（ST-Link、J-Link、CMSIS-DAP 等）。
  • 不需要额外安装 OpenOCD，直接使用 Keil MDK 内置的 Flash Download 功能。

必要输入

  • .uvprojx / .uvproj 工程文件路径（或从 Project Profile 获取）。
  • 可选的构建目标名称和 UV4.exe 路径。

自动探测

  • 脚本启动即自动复用工程根目录 .em_skill.json 中上次成功的 profile 作为默认参数（显式参数优先，无需先手动传 --resume）；--resume 仅用于断言缓存必须存在，无缓存则非零退出。无缓存或用户明确要求重新探测时，脚本自动回退到正常扫描。
  • 复用 build-keil 的 UV4.exe 探测逻辑（配置文件 → 环境变量 → 常见路径 → PATH）。
  • 解析工程 XML 中的 <DriverSelection> 识别调试器类型（ST-Link、J-Link、CMSIS-DAP、ULINK）。
  • 若未指定目标，默认使用工程中的第一个 Target。

执行步骤

  1. 先阅读 references/usage.md，确认本次操作。
  2. 对于常见场景，直接一次调用完成探测+烧录： 
    python scripts/keil_flasher.py --detect --flash --project <工程文件> --target <目标名>
  3. 读取脚本输出的烧录结果报告，关注成功/失败状态、调试器类型和日志证据。
  4. 将烧录结果写回 Project Profile，推荐下一步 skill。

失败分流

  • environment-missing：Keil MDK 未安装或 UV4.exe 不可用。
  • connection-failure：调试器连接失败（USB 未连接、驱动问题、目标板未上电）。
  • project-config-error：工程文件中的 Flash 配置无效或目标名不存在。

平台说明

  • Keil MDK 烧录仅在 Windows 上支持。
  • 烧录使用工程中已配置的调试器和 Flash 算法，无需额外配置。
  • 烧录日志可能包含 GBK 编码字符，脚本自动处理多种编码。

输出约定

脚本执行完成后，必须将以下关键信息提取并呈现给用户：

  • 烧录状态（成功/失败）
  • 工程文件和目标名
  • 芯片型号（如 STM32F103RC）
  • 调试器类型（如 ST-Link、J-Link）
  • 烧录固件路径和大小（如 Demo02.axf, 519.6 KB）
  • 烧录完成时间
  • 若失败：失败分类和日志证据

示例输出格式：

烧录成功 ✅
  工程: Demo02.uvprojx → 目标: Demo02
  芯片: STM32F103RC | 调试器: ST-Link
  固件: Demo02.axf (519.6 KB)
  状态: Erase Done → Programming Done → Verify OK → Application running
  • 成功后推荐 serial-monitor（查看串口输出）或 debug-gdb-openocd（在线调试）。
  • 失败时输出失败分类和日志证据，帮助用户定位问题。

交接关系

  • 从 build-keil 接收编译成功的工程信息。
  • 烧录成功后交给 serial-monitor（查看串口输出）或 debug-gdb-openocd（在线调试）。

评论

支持 Markdown