Skip to content

wal-rust v0.11.13

Choose a tag to compare

@hesheng01 hesheng01 released this 06 Sep 07:15
· 172 commits to main since this release

wal-rust v0.11.13

x86_64 单文件二进制,glibc ≥ 2.17(CentOS 7 / RHEL 7 / Ubuntu 16.04+;zigbuild 交叉构建)。

自 v0.11.4 以来的修复与新增(内网 152GB 测试反馈轮)

准确性与语义(测试报告 P0/P1 逐项)

  • X/Z 读取闭环:get/at/getwave/slice 值含 x/z 时返回位串(全 x → "x"、全 z → "z"、部分 → 逐位,IEEE 1364-1995 §14.1.1.4 约定);4-state 语义定型(x ≠ 0 ≠ 1),count/find 与 get 同源一致(0.11.4 的"折叠 get vs find 判 x"矛盾消除)
  • (at ...) 不再静默返回 (0 0):早于首变化 → 返回初始值;无变化/不存在 → 显式报错
  • 多行 $timescale 解析修复(VCD 头部 + 解析器;iverilog 空格形式 1 ns 兼容;单行解析失败不再吞行)
  • (timescale) 操作符实现(文档引用但此前未注册)
  • signal-width / sample-at 接受字符串(作用域全名)如 "tb.dut.sig [7:0]"
  • 共享 id 别名(iverilog/VCS scope 局部 id)按名解析,实测无槽错位;is-x/is-z 向量语义逐项验证(VCD/FST)

语言/工具(与官方 WAL 0.8.2 对齐)

  • (boolean?) / (bool?);(for/list [x xs] ...)(单/多绑定 zip,body+)
  • (count/step cond) / (find/step cond) = 官方逐拍语义(默认 count/find 保持变化点采样快路径)
  • 未知操作符/信号给最近候选;列表打印有界 ...(N items);&&/|| 统一返回布尔
  • CLI: count/sigs/topsig、--halt-on-error、--version 附安装路径;(take n lst)
  • 迁移文档 docs/migration-0.8-0.11.md(行为变更表)

基准与工具

  • scripts/gen_big_vcd.py(同构合成生成器)、scripts/run_bench.sh、scripts/diff_find.sh(差分门禁)
  • bench/RESULTS.md:11.5GB(加载 58.5s/冷查 190s)与 58.7GB(加载 360s/冷查 674s)基线
  • 213 测试全绿

已知边界(诚实)

  • >50GB VCD 查询仍慢(单信号 count ≈ 0.5GB/s 有效吞吐;58.7GB 冷查 11 分钟)——150GB 单信号 ≤60s 的
    SIMD 优化路线已定并立项(差分门禁就绪),本版未含
  • count/step 逐拍口径在大波形较慢(设计如此,显式选择)
  • 大文件建议优先 FST(Verdi/GTKWave 直出,wal-rust FST 后端已配)

构建

cargo zigbuild --release --target x86_64-unknown-linux-gnu.2.17