flash — Flash 下载
Usage: HFLinkCLI flash <command> [options]
六个子操作(位置参数 <command>):
子操作 |
别名 |
在线 |
说明 |
|---|---|---|---|
|
|
否 |
解析 Pack/FLM,列出候选 Flash bank(离线,不接触探针) |
|
— |
否 |
生成结构化下载计划:segments / banks / operations(离线) |
|
— |
是 |
按镜像范围或整片擦除 |
|
|
是 |
仅编程镜像(不隐式擦除) |
|
— |
是 |
读回校验镜像 |
|
— |
是 |
完整下载:erase + program + verify(+ 可选复位/运行) |
离线命令(probe / dry-run)输出计划文本后退出;在线命令在目标上执行。在线命令执行时在终端逐阶段显示进度,结束后输出一行执行汇总(各阶段实际执行的字节数与速度);输出重定向到文件或管道时不做单行刷新,仅保留各阶段的定格行,便于查看日志。
选项
连接选项(全局)
见 HFLinkCLI 使用指南:flash 必须提供 --pack、--interface、非零 --speed。
Flash 选项
选项 |
参数 |
默认值 |
说明 |
|---|---|---|---|
|
|
无 |
镜像文件;除 |
|
|
|
输入格式( |
|
|
无 |
BIN 镜像加载基址(十六进制可用) |
|
|
无 |
覆盖 Pack 默认算法:Pack FLM 基名或自定义 FLM 路径;含 |
|
|
无 |
内存 AP / 地址空间选择(十六进制可用) |
|
|
|
擦除策略; |
|
flag |
off |
强制擦写所有扇区,禁用跳过优化 |
|
|
|
校验模式(Classic 恒为 readback) |
|
flag |
off |
强制 Classic 同步 runner(默认 Turbo;Turbo 失败不回退) |
|
|
无 |
选择执行处理器(Pname) |
|
|
无 |
选择处理器单元 |
|
|
无 |
连接前加载用户 Hook 脚本(Lua) |
默认开启跳过优化:擦除前将待烧录扇区与镜像预期内容比对,内容已一致的扇区跳过擦除、编程与校验,空白扇区及内容仍为擦除值的页跳过擦除与编程,重复下载明显加快;--force-prog 可禁用。另外,待烧录范围覆盖整个 bank 且算法支持整片擦除时,会自动用一次整片擦除替代逐扇区擦除。
复位选项(仅 program)
选项 |
参数 |
默认值 |
说明 |
|---|---|---|---|
|
|
|
连接阶段复位类型;默认系统复位,使下载从确定的复位态开始 |
|
flag |
off |
nRESET 有效期间连接(under-reset) |
|
flag |
off |
正常连接序列前先复位 |
|
flag |
off |
编程完成后执行 Pack 默认复位,恢复目标运行 |
|
|
|
后复位影响范围;必须与 |
|
flag |
off |
JTAG 下自动扫描物理链并映射 TAP;SWD 下禁止 |
交叉校验规则
以下组合会在解析阶段报错(退出码 2):
缺
--pack/--interface/ 非零--speed在线命令(erase/write/verify/program)缺
--imageSWD 下使用
--jtag-autoJTAG 在线命令未提供
--jtag-auto--reset-after/--reset-scope用于非program子操作
示例
# 离线查看 Flash 布局与计划
HFLinkCLI flash probe --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 --image app.elf
# 完整下载 + 编程后复位并运行
HFLinkCLI flash program --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 \
--image app.elf --reset-after
# 指定自定义 FLM 算法与整片擦除
HFLinkCLI flash erase --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 \
--image app.elf --erase chip --algorithm CustomFlm/STM32H7xx.flm
# BIN 镜像需要基址
HFLinkCLI flash program --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 \
--image app.bin --base 0x08000000