📚 课程目录第4章 PXI硬件层数据溯源

4. PXI硬件层数据溯源

在PXI测试系统中，测试结果的可追溯性不仅取决于软件记录的测试数据，更取决于硬件层信息的完整捕获。当同一型号的PXI板卡在多台机箱中混用、同一机箱内多块板卡承担不同通道任务时，若不能自动记录板卡的唯一标识、通道映射关系、校准状态、驱动版本和硬件配置，后续出现数据异常或质量争议时，将无法判断问题来自被测件、测试程序还是硬件本身。因此，硬件层数据溯源的核心目标是：在每次测试执行时，自动采集并固化一组能够唯一描述“本次测试使用了哪些硬件、处于什么状态”的元数据。

一、需要自动记录的硬件溯源字段

PXI硬件层溯源信息可分为五类，每类都有明确的采集来源和记录意义。

类别	关键字段	采集来源	溯源意义
板卡ID	厂商、型号、序列号、插槽号、总线/设备号	NI-MAX、VISA资源串、PXI资源描述符	唯一确定物理板卡，区分同型号不同个体
通道映射	逻辑通道名、物理通道号、端子/连接器、多路复用状态	测试程序通道配置、接线表、开关模块拓扑	保证“逻辑通道—物理引脚—被测点”三者一致
校准信息	上次校准日期、校准周期、校准温度、校准证书号、校准状态	板卡校准EEPROM、校准数据库、NI校准服务记录	判断测量不确定度是否在有效期内
驱动版本	驱动名称、版本号、安装日期、补丁级别	NI Package Manager、系统注册表、驱动API查询	排除驱动升级或降级导致的测量行为变化
硬件配置	机箱型号、控制器型号、触发线配置、时钟源、电源状态	PXI机箱管理接口、机箱配置文件、系统BIOS信息	还原测试时的完整硬件环境

这些字段并非全部需要人工填写。实际工程中，应优先通过程序接口自动读取，仅在接口无法提供时才允许人工补充，并标记数据来源为“自动”或“手动”。

二、自动采集的实现路径

在NI PXI平台上，硬件信息的自动采集通常通过以下三条路径组合完成。

路径一：VISA资源串解析。每块PXI板卡在系统中都有唯一的VISA资源描述符，例如PXI0::15::INSTR或PXI5::2::0::INSTR。其中包含机箱号、插槽号、设备号等信息。测试程序启动时，可遍历viFindRsrc返回的资源列表，解析出每块板卡的物理位置。这种方式不依赖额外驱动，适合快速获取板卡ID和插槽号。

路径二：NI-MAX配置导出与API查询。NI-MAX中保存了板卡的型号、序列号、校准日期等详细信息。可通过nimi或nidmm等驱动API读取部分属性，也可调用niSysCfg库获取机箱和板卡的配置树。对于校准信息，部分模块支持通过niDMM_GetAttribute读取校准日期和校准温度。若模块不支持直接读取，则从校准数据库按序列号关联查询。

路径三：驱动版本与系统环境采集。驱动版本可通过NI Package Manager的命令行接口nipkg list导出，或读取注册表HKLM\SOFTWARE\National Instruments下的版本键值。机箱和控制器信息可通过PXI System属性节点获取。建议在测试程序初始化阶段一次性采集，写入测试结果文件的元数据区。

  采集时机建议：在测试程序加载硬件配置之后、执行第一条测试用例之前完成采集。这样既能保证硬件已初始化，又能避免测试过程中硬件状态变化导致记录不一致。

三、通道映射的自动记录方法

通道映射是硬件溯源中最容易出错的部分。逻辑通道名（如AI0_Voltage）与物理通道号（如PXI1Slot3/ai0）之间的对应关系，通常由测试程序中的通道配置字符串决定。自动记录时，不能只记录逻辑名，而应同时记录物理通道、连接器端子、以及开关模块的路由状态。

具体做法是：在测试程序初始化时，将通道配置字符串解析为结构化数据。例如，对于PXI1Slot3/ai0:3，解析为板卡位于PXI1槽3、使用模拟输入通道0至3。若系统中包含矩阵开关模块，还需记录开关闭合路径，例如SW1:COM0→NO5。这些信息应与板卡序列号绑定，形成“本次测试的通道映射表”。

对于多路复用或扫描测试，通道映射会随测试步骤变化。此时应记录每个测试步骤对应的通道映射快照，而不是只记录初始配置。快照的粒度可以是“每测试项一条记录”，字段包括测试项名称、逻辑通道、物理通道、开关状态、量程和耦合方式。

四、校准信息的关联与有效性判断

校准信息自动记录的关键在于“关联”和“判断”。关联是指将板卡序列号与校准记录绑定；判断是指根据校准周期和当前日期，自动计算校准是否在有效期内。

假设某PXIe-6363板卡序列号为01A2B3C4，上次校准日期为2024-03-15，校准周期为12个月。测试执行日期为2025-02-20，则剩余有效天数为23天，状态为“有效但临近到期”。若测试日期为2025-04-01，则状态为“已过期”，测试程序应给出警告或阻止测试继续。这一判断逻辑应写入测试程序的初始化检查中，并将结果记录到测试元数据。

注意：校准有效期判断应使用测试执行时的系统日期，而不是测试程序编译日期。对于长期运行的自动化测试系统，建议每天首次运行时重新检查校准状态。

五、驱动版本与硬件配置的固化

驱动版本记录应至少包含驱动包名称、版本号、安装日期和补丁级别。例如：NI-DAQmx 2024 Q1, 24.0.0, 2024-02-10。若同一机箱内不同板卡使用不同驱动版本，应分别记录。硬件配置记录则包括机箱型号（如PXIe-1095）、控制器型号（如PXIe-8880）、触发总线配置（如PXI_Trig0用于星形触发）、时钟源（如PXIe_CLK100）以及电源状态。

这些信息一旦采集完成，应写入测试结果文件的固定元数据区，并与测试数据文件一同归档。归档格式可以是JSON、XML或数据库表，关键是保证字段名称稳定、单位明确、时间格式统一。

六、自动记录流程与数据流

下图展示了PXI硬件层数据溯源从硬件对象到归档记录的完整数据流。左侧为硬件层实际对象，中间为采集与解析过程，右侧为最终固化的溯源记录。图中同时标出了自动采集与人工补充的边界。

七、记录格式与归档建议

硬件溯源记录建议采用JSON格式，便于程序读写和人工查看。以下是一个示例结构，字段名可根据实际系统调整，但应保持稳定。

{
  "test_session_id": "TS-20250220-001",
  "timestamp": "2025-02-20T09:15:32+08:00",
  "hardware": [
    {
      "slot": "PXI1Slot3",
      "model": "PXIe-6363",
      "serial": "01A2B3C4",
      "calibration": {
        "last_date": "2024-03-15",
        "period_months": 12,
        "status": "valid",
        "remaining_days": 23
      },
      "channels": [
        {"logical": "AI0_Voltage", "physical": "ai0", "terminal": "AI0"},
        {"logical": "AI1_Current", "physical": "ai1", "terminal": "AI1"}
      ]
    }
  ],
  "drivers": [
    {"name": "NI-DAQmx", "version": "24.0.0", "install_date": "2024-02-10"}
  ],
  "chassis": {
    "model": "PXIe-1095",
    "controller": "PXIe-8880",
    "trigger_bus": "PXI_Trig0",
    "clock_source": "PXIe_CLK100"
  }
}

归档时，该JSON文件应与测试数据文件同名或建立明确关联，存放于同一目录或数据库的同一记录中。对于长期质量追溯，建议同时保存采集时的原始资源串和解析后的结构化数据，以便在字段解析逻辑变更时仍能回溯原始信息。

实践建议：将硬件溯源采集封装为独立的初始化函数，在测试程序启动时调用一次，返回结构化对象。后续所有测试项共享该对象，避免重复采集和字段不一致。若测试过程中更换板卡或重新配置通道，应重新采集并生成新的快照。

硬件层数据溯源的价值在于“自动”和“完整”。自动采集减少了人工记录的错误和遗漏，完整字段保证了任何一次测试都能还原当时的硬件状态。当测试结果出现异常时，可以快速比对正常批次与异常批次的板卡序列号、校准状态、驱动版本和通道映射，从而将问题定位到具体硬件或配置变更，而不是停留在“测试不稳定”的模糊判断上。