# 单对以太网台架计划：字段与使用方法

版本：2026-09-23。配套文件为 spe-bench-plan.csv 与 spe-bench-demo-plan.csv。
使用 Excel“从文本/CSV”或 LibreOffice 按 UTF-8 逗号分隔打开。英文列名便于跨语言复用。

计划表已填入 B01 短链路基线、B02 目标线缆、B03 同对供电、B04 启动/负载变化的试验意图。
这是建议顺序，不是厂家接线说明，也不是已完成测试。按设备支持情况删除不适用工况；
同一工况执行多次时复制行并赋予唯一 test_id。工作开始前填齐文档、实际板卡、软件和判据。

| 字段 | 含义与填写方式 |
| --- | --- |
| data_kind | 计划为 unperformed_plan；示例为 illustrative_plan_not_measured；取得实测后在独立记录中使用 measured |
| test_id | 每次执行的唯一编号，用于关联日志 |
| document_and_revision | 实际采用的板卡手册、设计文件和软件文档版本 |
| endpoint_a_hw_fw / endpoint_b_hw_fw | 两端硬件修订、固件/镜像/驱动版本 |
| cable_drawing_lot / planned_length_m | 线缆图纸、连接器与批次 / 计划长度（米） |
| power_route_and_class | 实际供电路径、PSE/PD 配置和供电等级；外接供电与同对供电分开 |
| changed_factor / held_constant | 本行改变的因素 / 保持一致的条件 |
| acceptance_criteria_ref | 执行前确定的产品判据、器件允许条件和停机条件引用 |
| planned_observation | 本工况准备取得的观察与日志 |
| started_at_utc / ended_at_utc | 实际执行窗口，含日期时间和 UTC 时区 |
| actual_tx_mode_vpp | 实际读取的发射模式（Vpp）；计划值不能代填 |
| actual_tx_count / actual_rx_count | 同窗口、同层级的发出/收到计数；计数不可取得时留空 |
| counter_definition | 上述计数究竟是以太帧、应用消息还是其他单位；重复、过滤和重置如何处理 |
| link_down_count / reset_count | 该窗口实际观察的链路中断数 / 端点复位数；未观测留空 |
| pd_input_min_v / pd_input_max_v | 指定测点的 PD 输入最小/最大电压，单位 V；仪器与测点置于 evidence_ref |
| power_setup_result / data_result | 分别记录供电建立与业务数据判断，以及所用判据；未测不填通过 |
| evidence_ref | 同编号日志、波形、测点、采样设置与结果文件位置 |
| next_decision | 下一步：继续、修改哪一项、停止该路线或补测什么，以及依据 |

## 已填示例如何使用

演示文件假设已有兼容两端设备，以 1 m 为起点、20 m 为目标线缆；这些长度只是示意。
它已逐行区分改线缆、改供电、改启动或负载。REPLACE 字段必须换为实际资料；同时确认
两端供电等级、协商和连接器支持，不允许把“兼容”假设当成已经完成的核验。

示例的 started_at_utc 至 next_decision 全部留空：没有实际时间、计数、电压、复位、日志或
测试结论。准备完成后复制成独立执行文件，保留原计划；在文件名和 data_kind 中区分。

## 汇总与诊断

先比较同一窗口、负载、端点和软件的 B01/B02。B02/B03 比较要注明供电路径变化。只有
灯亮不足以填 data_result=通过，应读取业务数据与所用判据。计数口径不同或有计数器重置，
不能直接用发送数减接收数当作丢包数；保留日志并先解释差异。

同对供电才出现异常时，检查供电建立、PD 状态、复位与数据事件的时间关系，再决定下一项
测量；不要只凭这个现象认定线缆压降。短线也失败时，先处理基线配置。记录不存在时留空，
只有实际观测窗口内确实没有发生的事件才填 0。

每个计划工况有配置、判据和结果引用，失败有下一项可执行排查、未测范围单列，即形成一份
可交接的台架结论。该表不自动判定器件兼容性，不代替厂商接线步骤、产品资格或 EMC 验证。