flash-keil

name flash-keil description 当需要通过 Keil MDK 内置调试器烧录固件到目标板时使用，利用工程中已配置的调试器和 Flash 算法执行下载。 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。 执行步骤 先阅读 references/usage.md ，确认本次操作。 对于常见场景，直接一次调用完成探测+烧录： python scripts/keil_flasher.py --detect --flash --project <工程文件> --target <目标名> 读取脚本输出的烧录结果报告，关注成功/失败状态、调试器类型和日志证据。 将烧录结果写回 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 （在线调试）。