更新日志

记录 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 探针建立连接时的通信稳定性。