MCU Build Flash Tools

在 VS Code 中完成 Keil 工程编译和串口 IAP 烧录，减少在开发工具之间切换。

• 增量编译：编译修改过的代码。
• 全量编译：重新编译当前 Target。
• 烧录：通过串口将选定的 APP 固件写入 MCU。
• 编译烧录：增量编译成功后，自动烧录当前工程的固件。

编译日志显示在终端，错误和警告可在“问题 / Problems”面板中定位到源码；烧录时显示阶段、进度和结果。

使用前准备

• Windows 10/11 x64 本机环境，VS Code 1.85 或更高版本。当前市场安装包面向 Windows x64，不支持原生 Windows ARM64、远程或 WSL 环境。
• 已安装 Keil5，以及工程需要的编译器、设备包和许可，且工程能够在 Keil 中正常编译。
• Windows PowerShell 5.1（系统自带）。安装使用插件无需另外安装 Node.js 或 Python。
• 使用烧录功能时，需要安装对应的 USB 串口驱动，目标 MCU 已具备兼容本插件 UART IAP 协议的 Bootloader。

快速开始

1. 市场发布后，在 VS Code 扩展面板搜索 MCU Build Flash Tools，确认发布者为 HW 后安装；也可执行 Extensions: Install from VSIX... / 从 VSIX 安装，选择 MCU-Build-Flash-Tools-版本号-win32-x64.vsix，按提示重载窗口。
2. 打开 MCU 项目所在的文件夹。
3. 点击左侧芯片图标，打开 MCU Build Flash Tools。
4. 确认“工程”和“Target”，需要时点击对应字段重新选择。多根工作区中，先选择当前项目所属的“工作区”。
5. 点击 增量编译 或 全量编译，在终端查看结果。
6. 需要烧录时，连接串口并确认“串口”和“烧录固件”，再点击 烧录 或 编译烧录。

编译前会自动保存已有文件。工程和 Target 的选择会按工作区保存；顶部可查看当前插件版本。

底部快捷操作

打开本地工作区后，底部状态栏自动显示串口、增量编译、全量编译、烧录及编译烧录入口，无需先打开左侧面板。默认操作按钮仅显示图标，鼠标悬停可查看名称、当前工程及对应固件路径；点击串口号可切换设备或恢复自动选择。

执行任务时会显示当前阶段，下载阶段显示百分比，并提供“停止”按钮；其他操作暂不可用。完成后显示任务结果，点击状态可打开终端日志。串口插拔状态与左侧面板同步，没有串口时烧录相关按钮暂不可用。

可在设置中关闭 mcuTools.statusBar.compact 显示按钮文字，或关闭 mcuTools.statusBar.enabled 隐藏整组快捷操作。原生状态栏只支持左右排列，这组入口位于左侧区域靠内的位置，无法固定居中；窗口较窄时建议使用默认紧凑模式。底部不显示插件名称及 Target，工程、Target 和固件配置仍可在左侧面板调整。

按钮说明

任务执行期间不能切换参数或重复启动任务。需要全量编译后烧录时，可先执行“全量编译”，成功后确认固件文件，再执行“烧录”。

串口与固件选择

串口

插件每秒自动刷新串口并选中推荐设备，优先级为：USB 串口 → 普通硬件串口 → 类型不明确的端口 → 蓝牙虚拟串口。同一类型内，优先上次成功使用且仍存在的端口，其余按 COM 编号排序。

点击“串口”可以手动指定设备；手动选择会保持到该设备被移除，或在列表中点击“恢复自动选择”。连接多块开发板时，建议手动指定本次目标。

没有设备时显示 “没有串口”，烧录和编译烧录按钮禁用，编译功能仍可使用。自动模式打开端口失败时会尝试下一候选；手动模式会报告指定端口的错误。开始 IAP 通信后不会切换目标设备，断开后需重新发起烧录。

固件

点击“烧录固件”选择与目标板匹配的 APP .bin 文件，也可选择历史版本。文件必须非空且不超过 60 KiB（61,440 字节），不能使用包含 Bootloader 的合并 HEX 文件。

“烧录”和“编译烧录”使用的文件相互独立：前者使用手动选定的固件，后者使用当前工程的构建产物。面板中会单独显示“编译烧录产物”路径，选择历史固件不会改变该路径。

标准 project/MDK/*.uvprojx 工程会自动定位项目下的 MCU_Firmware/OTA/mcu.bin；其他布局或自定义输出目录可在设置中指定固件路径。编译失败、文件缺失或构建产物校验不一致时，不会开始烧录。

串口通信参数固定为 115200、8 数据位、无校验、1 停止位、无流控。烧录成功后会尝试查询 MCU 版本，查询结果显示在终端。

常用设置

点击面板右上角 “设置”。工程参数保存到工作区，本机 Keil 路径填写在用户设置中。

手动填写的相对路径以所选工作区文件夹为基准，也支持绝对路径。工程和 Target 通常直接在面板中选择即可。

常见问题

编译失败或找不到 Keil？

先确认工程能在 Keil 中正常编译，并检查插件的 Keil 路径设置。使用插件编译前请关闭已经打开的 Keil 窗口。具体错误可查看终端和“问题 / Problems”面板。

显示“没有串口”或“没有可用串口”？

检查设备连接和串口驱动，并关闭占用同一 COM 口的串口终端或其他工具。暂不可用的端口会在 10 秒后重新参与推荐，也可手动重新选择。显示“串口扫描失败”时，可在串口选择列表右上角点击刷新。

提示烧录产物与原始 BIN 不一致？

检查设置中的两个构建产物路径是否对应当前工程和 Target，并确认编译后的固件复制步骤已成功。不要用历史版本文件替代“编译烧录”的当前产物。

下载进度到了 100%，是否已经烧录成功？

100% 表示数据下载完成，之后还需要校验和跳转。请以最终的 “烧录成功” 结果为准。成功摘要为绿色，失败为红色，取消为黄色；警告不一定代表编译失败。

烧录中停止、拔线，或烧录后版本查询未完成？

停止和拔线不会恢复已经擦除或写入的数据，需要重新执行完整烧录。如果已经显示烧录成功，仅后续版本查询未完成，则不会改变本次烧录的成功结果。