# 單對乙太網路台架計畫：欄位與說明

版本：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 | 每次執行的唯一 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 | 同一 ID 下的記錄、波形、量測點、取樣設定及結果檔案位置 |
| next_decision | 下一步行動：繼續、變更指定項目、停止此路徑或追加測試，並附上決策依據 |

## 如何使用已填妥的示例計畫

示範檔案假設已有相容端點，起始鏈路為 1 m，目標電纜為 20 m。這些長度僅供說明。各列分別變更電纜、供電安排，以及啟動或負載。請用實際資訊替換 REPLACE 欄位。也應驗證兩端的供電等級、協商及連接器支援情況；假設相容不代表已完成檢查。

示例中，從 started_at_utc 到 next_decision 的每個欄位皆留白，沒有實際時間、計數、電壓、重設、記錄或測試結論。準備完成後，將計畫複製到獨立的執行檔案，並保留原始計畫。請在檔名及 data_kind 值中都區分這些檔案。

## 彙總與診斷結果

先在相同時間窗、負載、端點及軟體條件下比較 B01/B02。比較 B02/B03 時，留意供電路徑的變化。僅有指示燈亮起，不足以將 data_result 判為合格；應讀取應用資料並套用已列明的準則。如果計數定義不同，或計數器發生重設，不能直接將傳送計數減去接收計數視為封包遺失。應先保留記錄並說明差異。

故障若僅出現在同對線供電時，先檢查供電建立、PD 狀態、重設與資料事件的時序關係，再選擇下一個量測項目。不要僅憑此症狀推斷是電纜壓降。若短鏈路也失敗，先解決基準配置問題。無法取得的記錄應留白。只有在觀察時間窗內確實未發生的事件，才填 0。

每個計畫條件都有配置、準則及結果參照，失敗後有可執行的下一步診斷，且另行列出未測試範圍時，台架結論才具備交接條件。此表不會自動判定元件相容性，也不能取代廠商接線程序、產品資格確認或 EMC 驗證。


## CSV 原始值與意義

原始檔案保留固定的英文值。下表解釋其意義；示範識別碼不對應實際零件或測試。

| 原始值 | 意義 |
| --- | --- |
| `unperformed_plan` | 尚未執行的計畫。 |
| `illustrative_plan_not_measured` | 沒有實測結果的示例計畫。 |
| `measured` | 執行後另行建立的實際量測記錄。 |
| `B01` | 短鏈路基準條件。 |
| `B02` | 目標電纜條件。 |
| `B03` | 同對線供電條件。 |
| `B04` | 啟動或負載變化條件。 |
| `REPLACE: exact board manuals and matched revisions` | 填入實際板卡手冊，並核實版次一致。 |
| `REPLACE: compatible endpoint A / firmware` | 填入實際端點 A 與韌體，並驗證相容性。 |
| `REPLACE: compatible endpoint B / firmware` | 填入實際端點 B 與韌體，並驗證相容性。 |
| `REPLACE: actual drawing and lot` | 填入實際電纜圖面與批號。 |
| `REPLACE: product-specific criteria agreed before test` | 填入執行前確定的產品專用準則。 |
| `original supported supply` | 使用廠商支援的原有供電安排。 |
| `same as B01` | 保留 B01 使用的供電安排。 |
| `compatible PoDL/SPoE only` | 驗證相容性後，才使用 PoDL/SPoE。 |
| `validated route` | 使用已針對設備驗證的供電路徑。 |
| `establish baseline` | 建立初始比較配置。 |
| `target cable and connector assembly` | 換成目標電纜與連接器組件。 |
| `power route` | 變更供電安排。 |
| `one declared startup or load condition` | 變更一個明確定義的啟動或負載條件。 |
| `endpoint firmware; application load` | 保持端點韌體與應用負載不變。 |
| `endpoints; firmware; data load; supply` | 保持端點、韌體、資料負載及電源不變。 |
| `B02 cable; endpoints; firmware; data load` | 保持 B02 電纜、端點、韌體及資料負載不變。 |
| `validated circuit and cable` | 保持已驗證的電路與電纜不變。 |
| `negotiation; application data; supply state` | 觀察協商、應用資料及電源狀態。 |
| `same-window data counters; reconnect/reset; supply readings` | 觀察相同時間窗內的資料計數器、重連／重設及電源讀值。 |
| `power classification/start; PD state; application data` | 觀察供電分類與啟動、受電裝置狀態及應用資料。 |
| `startup count; recovery duration; logs/waveform` | 記錄啟動次數、恢復時間及相關記錄或波形。 |