更新日志
记录 HFLinkSDK 及其配套工具(HFLinkCLI、HFLink_Flash 等图形界面工具)面向用户的功能与行为变化。文档随软件版本发布同步更新。
2026-10-03:HSS 采样帧距均匀化
HSS 采样改为固定间隔连续节拍,帧距均匀不再成簇突发,1 kHz–100 kHz 各档实测帧距单峰均匀。
目标采样周期超出调试接口能力时启动即自动降频,宁可降低采样率也保持帧距均匀,不再出现突发簇与队列丢帧。
实机 STM32H723(SWD 60 MHz、3 个 32 位变量)实测稳定 93.6 kHz、全程零丢帧,帧距 p50≈10.4 µs;单变量最高 96.3 kHz。
修复每批采样之间重复重建调试连接导致的批间断流。
2026-09-20:Lua 表达式引擎新增字符串求值与类型查询
新增
sess:eval_str(expr, max_len?):按地址读取 NUL 结尾字符串,支持指针、数组与复合左值;max_len严格限长,省略时用内置上限。新增
sess:size_info(expr_or_type):一次取得类型或表达式的尺寸、数组元素个数与元素大小。typeof结果补充数组元素个数count与 typedef 原类型underlying_kind;member_offset支持含数组下标的成员路径。类型解析支持 C 标准类型别名(
int8_t、size_t、单独unsigned等)并自动跳过const/volatile等限定词;求值遵循目标位宽的 C 语言语义(整数提升、常规算术转换、数组名退化、移位计数按位宽取模),结果与目标机上编译执行一致。无调试类型信息的符号(如中断向量表
g_pfnVectors)改为按地址求值返回,不再报「无可用类型」错误。行为调整(升级请留意):求值成功时统一返回
(值, nil, 0)三元组,失败返回(nil, message, code);标量一律按整数位模式返回 number(uint64全范围无损,不再呈现为十六进制字符串);顶层指针表达式一律返回地址标量,不再按类型猜测读取字符串——读字符串请改用eval_str。
2026-09-10:Lua 内存访问位宽与半主机请求调整
target:read_memory/target:write_memory新增可选位宽参数width(1/2/4 字节,默认 1),指定位宽可提升访问速度,地址与长度须按位宽对齐。半主机请求对象不再提供
read_memory/write_memory方法,请改用req.target取得目标后调用其read_memory/write_memory。C 接口同步移除半主机请求的
ReadMemory/WriteMemory,新增GetTarget。
2026-09-10:命令行工具退出行为修正
rtt守护模式支持Ctrl+C(SIGINT/SIGTERM)优雅退出,退出时完整清理会话并正确释放探针。修复
gdbserver退出时因清理顺序错误导致设备关闭失败的问题。
2026-09-09:Flash 下载与 RTT 提速
Flash 编程速度大幅提升:实机 STM32H723 烧录 1 MB 镜像(SWD 10 MHz、
--force-prog)实测编程速度约 195 KB/s,编程耗时由 26.9 s 降至 5.3 s(约 1/5)。Flash 校验与预扫描回读提速约 4 倍:同条件实测回读速度约 775 KB/s(5.2 s 降至 1.3 s),整镜像下载总耗时由 36.8 s 缩短至 11.2 s。
RTT 收割吞吐提升 16.2%:实机 STM32H723、SWD 60 MHz、telnet 端到端实测由 2.91 MB/s 升至 3.38 MB/s,吞吐随 SWD 时钟近似线性提升。
2026-09-08:Lua 脚本 Buffer、hexdump 与 HSS 视图
新增
hf.util工具模块:Buffer 字节缓冲、大端/小端 8–64 位整数与 float/double 编解码(带 offset 参数)、hexdump十六进制转储(左侧地址、一行 16 字节、支持 8/16/32 位宽打印),以及time/sleep_ms等时间与延时 API(安全模式即可使用)。target:read_memory返回值由二进制 string 改为 Buffer,可直接按buf:le_u32(0)等方式解码;write_memory同时接受 Buffer 与 string。hf.hss的read()改为返回 SampleView 视图数组(v:ts()/v:block(i)/v:u32(i)),零拷贝按块解码,会话销毁后视图仍可读取已采数据。表达式引擎
set_reader回调的返回值兼容 Buffer 与 string 两种形态。
2026-09-08:Flash 下载进度显示与阶段统计
flash在线命令新增逐阶段进度条与完成后的汇总行,实时显示擦除、编程、校验的进度与速度。Flash 下载的预检查调整为先连续探测全部 Flash 区域、再统一擦除,多区域下载的阶段顺序更清晰。
Flash 下载 API 新增阶段统计输出,可在下载完成后获取各阶段实际执行的字节数与耗时。
2026-09-06:Flash 下载与进度显示优化
预检查确认一致的扇区在校验阶段不再重复读取,重复烧录整体耗时进一步缩短。
内容为空白(与擦除值相同)的页不再重复编程,含大量空白区域的镜像下载更快。
图形界面工具中预检查作为独立阶段显示进度与耗时,下载速度按实际写入量统计。
Flash 烧录范围按芯片包描述与算法实际支持范围共同界定,芯片选择界面同步只显示可用的 Flash 区域。
2026-09-05:Flash 下载提速与本地 Pack 安装
Flash 下载自动跳过内容已一致或空白的扇区,重复烧录明显加快。
新增
flash program --force-prog选项,可禁用跳过优化、强制擦写所有扇区。烧录范围覆盖整个 Flash 区域时自动改用整片擦除,缩短擦除耗时。
优化 Turbo 下载的指令流水线,提升下载速度与稳定性。
Classic 模式烧录时不再向终端输出冗余的诊断调试信息。
CMSIS-Pack 管理工具新增本地导入功能,无需联网即可安装
.pack固件包,版本冲突时会弹窗确认。
2026-09-04:Flash 下载与连接更新
Flash 下载 API 调用完成后目标保持停机(halt),不再自动恢复运行,需要运行固件时请显式触发复位。
flash program连接阶段默认执行系统复位(--reset默认值改为system),提升较高 SWD 时钟频率下的烧录成功率。移除
flash program的--run选项,编程后恢复运行请改用--reset-after。修复较高 SWD 时钟频率下复位未完成即被误判完成导致的下载失败、目标意外启动与校验失败。
修复连接阶段所选复位类型未实际生效的问题。
提升与 HFLink 探针建立连接时的通信稳定性。