STM32/GD32 调试器检测与固件烧录 CLI 工具，基于 OpenOCD 实现。
支持 ST-Link 和 DAPLink (CMSIS-DAP) 调试器，可自动检测设备并烧录固件。
安装时会自动下载当前平台对应的 OpenOCD 二进制文件，无需手动配置。
- Windows x64
- Linux x64 / arm64
- macOS x64 / arm64 (Apple Silicon)
# 全局安装（推荐，可直接使用 openocd-tool 命令）
npm install -g openocd-tool
# 或作为项目依赖
npm install openocd-tool安装过程中会自动从 GitHub 下载对应平台的 OpenOCD 预编译包。
扫描已连接的 ST-Link 和 DAPLink 设备：
openocd-tool detect以 JSON 格式输出：
openocd-tool detect --json或直接运行：
node bin/cli.js detect输出示例：
正在检测已连接的调试器设备...
共检测到 1 个调试器设备：
[1] ST-Link
描述: STLINK V2J14S0 (API v2)
VID:PID = 0483:3748
序列号: 066FFF535752877167253530
目标电压: 3.24V
openocd-tool flash <固件文件> -t <目标芯片> [选项]# 烧录 HEX 文件到 STM32F103
openocd-tool flash firmware.hex -t stm32f1x
# 烧录 BIN 文件到 STM32F407（需指定基地址）
openocd-tool flash firmware.bin -t stm32f4x -a 0x08000000
# 烧录 ELF 文件到 GD32E230
openocd-tool flash app.elf -t gd32e23xopenocd-tool flash firmware.hex -t stm32f1x -i cmsis-dap# 全片擦除后烧录
openocd-tool flash firmware.hex -t stm32f1x --erase-all
# 烧录后不复位
openocd-tool flash firmware.hex -t stm32f1x --no-reset
# 跳过校验
openocd-tool flash firmware.hex -t stm32f1x --no-verify
# 使用 JTAG 传输协议，调整速度
openocd-tool flash firmware.hex -t stm32f1x -p jtag -s 1000| 参数 | 说明 | 默认值 |
|---|---|---|
-t, --target <name> |
目标芯片配置（必须） | - |
-i, --interface <type> |
调试器接口：stlink 或 cmsis-dap |
stlink |
-p, --transport <type> |
传输协议：swd 或 jtag |
swd |
-s, --speed <kHz> |
适配器速度 | 4000 |
-a, --address <hex> |
.bin 文件基地址 |
0x08000000 |
--no-verify |
烧录后不校验 | - |
--no-reset |
烧录后不复位 | - |
--json |
以 JSON 格式输出检测结果（仅 detect） | - |
--erase-all |
全片擦除 | - |
--timeout <ms> |
超时时间 | 60000 |
-h, --help |
显示帮助 | - |
-v, --version |
显示版本 | - |
STM32 系列：
stm32f0x stm32f1x stm32f2x stm32f3x stm32f4x stm32f7x
stm32g0x stm32g4x stm32h7x stm32l0 stm32l1 stm32l4x stm32l5x
stm32u0x stm32u5x stm32c0x stm32wbx stm32wlx
GD32 系列：
gd32e23x gd32vf103
也可以作为 Node.js 模块使用：
const { detect, detectStlink, detectDaplink, flashFirmware } = require("openocd-tool");检测所有已连接的调试器设备（ST-Link + DAPLink），返回设备数组。
const devices = await detect();
// [
// {
// type: "ST-Link",
// description: "STLINK V2J14S0 (API v2)",
// vid: "0483",
// pid: "3748",
// serial: "066FFF535752877167253530",
// targetVoltage: "3.24V"
// }
// ]也可以单独检测某一类调试器：
const stlinks = await detectStlink(); // 仅 ST-Link
const daplinks = await detectDaplink(); // 仅 DAPLink (CMSIS-DAP)烧录固件到目标芯片，返回 { success: boolean, output: string }。
const result = await flashFirmware({
firmwarePath: "./firmware.hex", // 支持 .hex / .bin / .elf
target: "stm32f1x", // 必须，目标芯片
interface: "stlink", // 可选，"stlink" | "cmsis-dap"，默认 "stlink"
transport: "swd", // 可选，"swd" | "jtag"，默认 "swd"
speed: 4000, // 可选，适配器速度 (kHz)，默认 4000
baseAddress: 0x08000000, // 可选，.bin 文件基地址，默认 0x08000000
verify: true, // 可选，烧录后校验，默认 true
reset: true, // 可选，烧录后复位，默认 true
eraseAll: false, // 可选，全片擦除，默认 false
timeout: 60000, // 可选，超时 (ms)，默认 60000
});
if (result.success) {
console.log("烧录成功");
} else {
console.error("烧录失败:", result.output);
}设备未检测到？
- 确认设备已通过 USB 连接
- ST-Link：需安装 ST-LINK USB Driver
- DAPLink：Windows 通常免驱动
烧录失败？
- 检查
-t参数是否与芯片型号匹配 - 确认固件文件路径正确
.bin文件需通过-a指定正确的基地址
ISC