PRBS 与 SMART 数值解码评审说明
!1333 原本修复未对齐读取和超宽移位,不是把 PowerOnHours 改为能够精确保存所有128位整数的新属性。本轮评审进一步发现,初版拆分采用的浮点合成仍可能多舍入一次;PRBS 成功用例也需要真正检查每个 lane 的完整四字节。以下对应本轮实际源码修订,版本和 CHANGELOG 按 测试说明中的拆分约定 处理。
Huawei、Samsung、DERA 的 SMART 属性。 三处修改分别位于 Huawei smart.cpp、Samsung smart.cpp 和 DERA smart.cpp,关键表达式一致:
// 本轮评审修改前:高、低半部先各自转成 double,再相加。
double power_on_hours =
std::ldexp(static_cast<double>(power_on_hours_high), 64) + static_cast<double>(power_on_hours_low);
// 修改后:先解码完整整数,只在写入既有浮点属性前转换一次。
const double power_on_hours =
static_cast<double>(nvme_read_u128(smart_log.power_on_hours_l, smart_log.power_on_hours_h));
PowerOnHours.set_value(power_on_hours);
这里的 static_cast<double>(x) 在数值转换用途上相当于 C 的 (double)x;它不会增加 double 的精度。std::ldexp(x, 64) 与 C 的 ldexp(x, 64) 一样,将浮点数乘以 2^64。旧表达式在转换低半部时就可能丢失整数低位,随后相加又舍入一次。新表达式先保留完整整数,到最外层转换时才舍入;const 只禁止随后修改该局部变量,不影响精度。
公共 nvme_read_u128() 原先通过字节复制取得两个本机整数,本轮补上显式 <endian.h> 依赖和小端转换。核心代码为:
#include <endian.h>
static inline unsigned __int128 nvme_read_u128(const uint8_t* low, const uint8_t* high)
{
uint64_t lo = 0;
uint64_t hi = 0;
if (low) {
(void)memcpy_s(&lo, sizeof(lo), low, sizeof(lo));
}
if (high) {
(void)memcpy_s(&hi, sizeof(hi), high, sizeof(hi));
}
return (static_cast<unsigned __int128>(le64toh(hi)) << 64) | le64toh(lo);
}
low、high 指向协议中的两个8字节小端数组。像 C 中先 memcpy 到局部整数一样,memcpy_s 按字节复制到有正常对齐的 lo、hi,避免直接把打包字段地址当作 uint64_t* 解引用;调用者仍需保证非空来源各有8个可读字节。le64toh 再把协议小端值转为本机整数,而显式包含头文件避免依赖其他头文件间接声明它。本轮没有大端机器实测,不能把这项源码修正写成大端验证通过。
unsigned __int128 是现用编译器支持的扩展整数类型,不是所有标准 C++ 实现都保证提供的类型。它也不是 C++ 智能指针或对象包装,仍是整数。先把高半部转换为128位,才执行 << 64,因此移位数小于左操作数宽度;若左操作数仍是 uint64_t,移动64位就不合法,事后再转128位也无法补救。按位或将低半部放入下64位,得到完整整数。最后转 double 仍会损失精度:本轮使用的 binary64 不能精确保存所有大于 2^53 的整数,更不能精确保存全部128位计数;若需要这种能力,须另行设计整数或字符串属性。
为什么回归必须严格比较浮点值。 三厂的 RoundsPowerOnHoursOnce 用例通过共享 mock_nvme_mi_vpd.h 按 power_on_hours_l/h 字段填写原始小端字节,并以 Admin 头长度追加日志,使 high = 1、low = 0x80000000000017ff,再调用真实 SMART 更新路径并读取 PowerOnHours,不在期望值中重复调用解码 helper。在本轮 binary64 与默认舍入配置下:
协议精确整数 = 2^64 + 2^63 + 6143
完整整数转 double = 0x1.8000000000001p64
旧算法结果 = 0x1.8000000000002p64(比期望大4096)
原因是低半部先转换时,2^63 + 6143 被舍入为 2^63 + 6144;再加高半部时恰好落在两个可表示结果中间,按本轮采用的舍入方式选到较大值。直接转换完整整数则位于该中点下方1,选到较小值。这里相邻两个 double 相差4096,即1 ULP(当前数量级下相邻可表示值的间距);EXPECT_DOUBLE_EQ 会放行本例的1 ULP 差异,因此改用 EXPECT_EQ(actual, 0x1.8000000000001p64) 严格比较数值,才能让旧算法失败。
这些十六进制浮点字面量与 C 的写法相同:0x 后是十六进制有效数字,p64 表示乘以 2^64,不是乘以 16^64。字面量直接表示预先确定的浮点期望,不需要在测试里再执行生产算法。Huawei 测试 的另两个期望也改为独立字面量:低半部全 0xff、高半部为1的精确整数 2^65 - 1 舍入为 0x1p65;低半部为0、高半部小端字节为 10 20 30 40 50 60 70 80 的结果为 0x1.00e0c0a080604p127。后二者用于核对高低半部组合与字节顺序,不能替代前述专门揭示额外舍入的输入。
PRBS 的四字节与 lane 偏移。 test_prbs_test.cpp 中 GetResult_OmSuccess、GetResult_PortSuccess 分别提供独立的原始字节数组,不通过整数编码 helper 生成报文,再调用真实 GetResult() 解码。两例都逐一比较8个 lane,包含 78 56 34 12 → 0x12345678 和 ff ff ff ff → 0xffffffff 等完整四字节数值;两种回复的数据起点不同,lane 的值及排列也能揭示取错偏移。这样不会因测试和实现共用同一种错误编码而互相印证。
2026-10-14 的历史验证中,三厂严格舍入回归在旧浮点合成实现上实跑,均发生目标断言失败。PRBS 也临时把实际读取函数退化为只复制2字节,两条成功用例均明确失败,随后恢复 sizeof(value) 的完整四字节复制。这些历史结果证明回归能发现相应缺陷,不代表后续重基提交已重新验证通过;每次修订的实际验证范围、通过数、执行源码及日志以对应 PR 自验证报告为准,不在这里预填尚未完成的结果。
端序覆盖边界与评审整改。 独立 nvme_read_u128_test.UnalignedLittleEndianHalves 将两个非对称 8 字节序列放在明确未对齐的地址,分别检查结果的高低半部;既有 PRBS 两条成功用例也使用非对称四字节字段。这些测试验证当前执行主机上的小端 wire 解码与未对齐输入,不能证明大端主机上的字节交换分支已经执行。把输入字节倒序也只是改变协议数值,无法模拟大端机器的内存读取;大端平台交叉运行仍待后续环境验证,本次不宣称已覆盖。
共享回复 helper 使用的 nvme_smart_log_response_t log{} 相当于 C 的 struct ... log = {0},将所有字段先置零;随后只写四个命名数组元素。sizeof(nvme_mi_admin_response_header_t) 代替裸头长,std::memcpy 与 C 的 memcpy 一样把日志字节附到头后,避免三处重复维护 144/145/151/152 偏移。返回的 std::string 持有自己的字节副本,不保留局部 log 的地址;三厂测试继续调用各自真实更新路径,并用独立固定期望值严格比较。
其他 128 位 SMART 字段的有界排查。 本次检查 drivers、libraries 中全部标准 SMART 高低半部字段引用,并检查 drivers/pcie_nvme、libraries/nvme 中的 uint64_t 移位及 ldexp 用法。Huawei、Samsung 的 interface/nvme/log_collection.cpp 第194—203行和 DERA 对应文件第187—196行,均通过 nvme_read_u128 读取 DataUnitsRead、DataUnitsWritten、HostReads、HostWrites、ControllerBusyTime、PowerCycles、PowerOnHours、UnsafeShutdowns、MediaErrors 和 NumErrLogEntries,再用 nvme_u128_to_string 输出完整十进制值;没有继续采用旧的 64 位超宽移位或浮点合成。剩余字节循环分别处理6字节厂商属性和最多8字节 VPD 容量,最大移位为40和56,均小于左操作数64位宽度。本排查限于上述源码路径及字段,不代表完成仓库所有整数运算审计,也不改变前述大端运行验证边界。