J-Link Commander V7.70c 脚本自动化：3行命令实现STM32F103C8T6固件一键烧录

嵌入式开发中，固件烧录是每个工程师都无法绕开的环节。传统GUI操作不仅效率低下，更难以融入现代CI/CD流程。本文将揭示如何用J-Link Commander V7.70c的脚本功能，将原本需要多次点击的烧录过程压缩为3行核心命令，实现真正的"烧录即走"体验。

1. 环境配置与工具准备

在开始自动化烧录前，需要确保基础环境正确配置。不同于GUI操作需要手动设置参数，脚本化方案要求所有配置都能通过命令行参数传递。

必备组件清单：

• SEGGER J-Link软件包（V7.70c或更高版本）
• STM32F103C8T6开发板或目标设备
• 标准SWD连接线（SWDIO+SWCLK+VCC+GND）

验证J-Link连接状态的快捷命令：

JLink.exe -USB

正常连接时会显示硬件版本和固件信息，类似：

SEGGER J-Link Commander V7.70c (Compiled Aug 18 2022 17:30:05) DLL version V7.70c, compiled Aug 18 2022 17:29:50 Connecting to J-Link via USB...O.K.

提示：建议将JLink安装目录加入系统PATH环境变量，这样可以在任意路径直接调用JLink.exe

连接参数对照表：

2. 核心脚本解析与实现

自动化烧录的核心在于.jlink脚本文件，这个文本文件包含所有需要顺序执行的J-Link命令。与交互式操作不同，脚本中的命令会按序执行且无需人工干预。

基础烧录脚本(flash.jlink)：

r halt loadfile firmware.bin 0x08000000 g exit

逐行解析：

1. r：复位目标芯片，确保处于已知状态
2. halt：暂停CPU运行，准备烧录操作
3. loadfile：加载二进制文件到指定Flash地址
4. g：跳转到程序入口执行
5. exit：退出Commander界面

进阶版本增加错误处理和状态校验：

// 初始化连接 usb connect // 验证连接状态 mem32 0xE000ED00 1 // 擦除Flash w4 0x40022010 0x45670123 w4 0x40022010 0xCDEF89AB w4 0x40022014 1 w4 0x40022010 0x45670123 w4 0x40022010 0xCDEF89AB w4 0x40022008 1 // 烧录固件 loadfile firmware.bin 0x08000000 // 校验写入内容 verifybin firmware.bin 0x08000000 // 启动应用 g

3. 批处理封装与CI/CD集成

单纯的.jlink脚本仍需手动执行，通过批处理或Shell脚本可以实现真正的"一键操作"。根据不同操作系统，封装方式略有差异。

Windows批处理示例(flash.bat)：

@echo off set JLINK_PATH="C:\Program Files (x86)\SEGGER\JLink\JLink.exe" set DEVICE=STM32F103C8T6 set SPEED=4000 set INTERFACE=SWD %JLINK_PATH% -CommandFile flash.jlink -AutoConnect 1 -Device %DEVICE% -If %INTERFACE% -Speed %SPEED% if %errorlevel% neq 0 ( echo 烧录失败，错误码: %errorlevel% exit /b %errorlevel% ) echo 烧录成功

Linux Shell脚本示例(flash.sh)：

#!/bin/bash JLINK_EXE="/opt/SEGGER/JLink/JLinkExe" DEVICE="STM32F103C8T6" SPEED="4000" INTERFACE="SWD" $JLINK_EXE -CommandFile flash.jlink \ -AutoConnect 1 \ -Device $DEVICE \ -If $INTERFACE \ -Speed $SPEED if [ $? -ne 0 ]; then echo "烧录失败" exit 1 fi echo "烧录成功"

与CI系统集成的关键点：

• 将J-Link安装到构建服务器固定路径
• 设置环境变量指向JLink可执行文件
• 在构建后步骤中添加烧录脚本调用
• 处理可能的错误返回码

4. 高级技巧与故障排除

当脚本化烧录遇到问题时，需要系统化的排查方法。以下是几个常见问题及其解决方案：

连接超时问题：

• 现象：脚本执行时卡在连接阶段
• 解决方案：增加超时参数和重试机制

// 在脚本开头添加 SetTimeout 5000 // 设置5秒超时 SetRetryDelay 1000 // 重试间隔1秒 SetMaxRetry 3 // 最大重试次数

速度优化技巧：

1. 使用RAM缓冲加速写入：

w4 0x40022010 0x45670123 w4 0x40022010 0xCDEF89AB w4 0x40022014 0x08000000 // Flash起始地址 w4 0x40022010 0x45670123 w4 0x40022010 0xCDEF89AB w4 0x40022008 0x00000001 // 开始擦除

2. 分段烧录大文件：

// 分块加载16KB数据 loadbin firmware.bin 0x08000000 0x4000 verifybin firmware.bin 0x08000000 0x4000 loadbin firmware.bin 0x08004000 0x4000 verifybin firmware.bin 0x08004000 0x4000

典型错误代码表：

实际项目中，我在为产线设计自动化测试系统时，发现通过添加预处理命令可以显著提高稳定性：

// 复位前先断开连接 Disconnect Sleep 100 r Sleep 50 Connect