Skip to content
FunCoding

flash-keil

当需要通过 Keil MDK 内置调试器烧录固件到目标板时使用，利用工程中已配置的调试器和 Flash 算法执行下载。

Star
1,000
Category
Coding & debugging
Last commit
Aug 20, 2026

skills/flash-keil/SKILL.md

View on GitHub

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（在线调试）。

Similar Skills

receiving-code-review

OBobra/superpowers298k2,631 new stars in the last 7 days

requesting-code-review

OBobra/superpowers298k2,631 new stars in the last 7 days

systematic-debugging

OBobra/superpowers298k2,631 new stars in the last 7 days

code-review

MAmattpocock/skills288k10,178 new stars in the last 7 days

codebase-design

MAmattpocock/skills288k10,178 new stars in the last 7 days

scaffold-exercises

MAmattpocock/skills288k10,178 new stars in the last 7 days