From 9c9ec5f4f546c3d0c0065510f285f26f3d175a38 Mon Sep 17 00:00:00 2001 From: ETWen Date: Thu, 22 Oct 2026 14:26:14 +0800 Subject: [PATCH] docs: Record V1.2.7 in Script A's history and add the release note Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_0131orciRKrejchsuDk6UpXk --- ARCHITECTURE.md | 6 +-- CLAUDE.md | 7 +-- docs/release-notes/v1.2.7.md | 47 +++++++++++++++++++ src/Script_ABC_Blanton/1_Blanton_Script_A.ttl | 22 ++++++++- 4 files changed, 74 insertions(+), 8 deletions(-) create mode 100644 docs/release-notes/v1.2.7.md diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index a9309c5..24696f1 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -215,7 +215,7 @@ Blanton_TTL_Script/ ├── blanton_multiphase_margin.sh # 多相 VRM margin（原生 i2c，38 條軌） ├── pwr_brick.sh # PDB / CPB power brick 讀值（VI2C ch4） ├── nfc_polling.sh # NFC tag 背景輪詢 + PASS/FAIL 統計 - ├── blantons_nfc_validate.py # NFC/NCI 驗證工具（廠商提供，未修改） + ├── blantons_nfc_validate.py # NFC/NCI 驗證工具（廠商提供，未修改；V1.2.7 起為 v2.5） ├── blanton_tr518.sh # TR518 封包測試，量功耗前的負載來源 ├── TH6_SWB0_power_readback.sh # SWB0 19 條軌 V×I + 總功耗 ├── TH6_SWB1_power_readback.sh # SWB1 同上 @@ -388,7 +388,7 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... ) # "channel:operation:change_perc | 模組 | 進入點 | 功能 | |------|--------|------| -| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.2.6 | root 登入 → `date -s` 對時 → 清 job log → **收掉前一輪殘留**（`hw-test-session finish` → `bgctl reset --yes` → `bgctl stop --all` → `bgctl list` 確認清空）→ `hw-test-session start` → **設定風扇轉速** → **等資料面就緒**（`wait_init.ttl`）→ DUT 清單（boot/version/fwutil/syseeprom/ssdhealth/TPM/NVMe）→ BMC enroll + version/status → source bash 工具 → 清/讀 7 組 PCIe AER + `ras-mc-ctl --summary` → `lspci` → margin → PMON → dmesg → **10G/1G 管理網路 ping** → **NFC 基線**（start → 30s → stop → report）→ 100G uplink 設定與狀態 → **`unused_lanes.sh off`**（V1.2.6）→ **BER 基線掃描**（依 `SWB_UNIT`，V1.2.1 新增）→ **一輪流量基線**（V1.2.6 起兩 unit 時夾 FDR，sleep 40） → **SerDes DSC 基線**（`EN_TX_FIR`）→ `show uptime` | +| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.2.7 | root 登入 → `date -s` 對時 → 清 job log → **收掉前一輪殘留**（`hw-test-session finish` → `bgctl reset --yes` → `bgctl stop --all` → `bgctl list` 確認清空）→ `hw-test-session start` → **設定風扇轉速** → **等資料面就緒**（`wait_init.ttl`）→ DUT 清單（boot/version/fwutil/syseeprom/ssdhealth/TPM/NVMe）→ BMC enroll + version/status → source bash 工具 → 清/讀 7 組 PCIe AER + `ras-mc-ctl --summary` → `lspci` → margin → PMON → dmesg → **10G/1G 管理網路 ping** → **NFC 基線**（start → 30s → stop → report）→ 100G uplink 設定與狀態 → **`unused_lanes.sh off`**（V1.2.6）→ **BER 基線掃描**（依 `SWB_UNIT`，V1.2.1 新增）→ **一輪流量基線**（V1.2.6 起兩 unit 時夾 FDR，sleep 40） → **SerDes DSC 基線**（`EN_TX_FIR`）→ `show uptime` | | **Script B（Stress）** | `2_Blanton_Script_B.ttl` | **V1.1.8 起 `mlucas-avx2 -cpu 0:15` 由 `systemd-run --unit=mlucas-amm`（`Type=exec`、`Restart=always`）啟動，不再是 shell 的 `&` 背景 job** + `bgctl run` 的 `memtester` / SSD / USB 壓力（v1.1.7 起 SSD/USB 的 `--runtime`/`--passes` 讀 `config.ttl` 的 `SSD_RUNTIME`/`SSD_COUNT`、`USB_RUNTIME`/`USB_COUNT`；BMC memtester 不帶次數 = 跑到被停） + BMC DDR（`bmc-manager run memtester`）→ BMC USB net test（探測 cdc_ncm 介面，`systemd-run` 掛 `BMC_USB_RUNTIME` 秒的 ping，V1.1.8 前寫死 4 小時）→ 啟動 mgmt ping 監控 → **啟動 NFC 輪詢** → `jobs` / `systemctl is-active mlucas-amm` / `bgctl list` → traffic（依 `SWB_UNIT`）→ `while 1` 每輪 PMON + `bgctl list`/`jobs`/`systemctl is-active mlucas-amm` + `sleep 60`（**V1.1.4 起 margin 不在迴圈內**；V1.2.0 起等待走 DUT 端 `sleep` 而非 macro 端 `pause`）| | **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` + **`systemctl stop mlucas-amm`**（systemd unit 不是 shell job，`jobs -p` 抓不到）+ `bgctl stop --all` / `reset` + 停 BMC USB unit、mgmt ping 與 **NFC 輪詢** → PMON + dmesg → 7 組 AER + `ras-mc-ctl` → BMC USB `journalctl` **寫進 `log/bmc_usb_net.log`**（不再印在 console） → `ip -s link show eth0/eth1` → `cat` mlucas log（並 `cp` 進 job 目錄一起帶走）→ **NFC `report`** → traffic `stop` + `report` → **SerDes DSC 收尾**（`EN_TX_FIR`）→ **BER 掃描**（依 `SWB_UNIT`）→ NVMe 健康 → `show reboot-cause` → **margin 掃描**（`EN_Margin`，V1.1.4 由 Script B 移來）→ `uptime` → **job log 複製到 USB（帶時戳）** → `exit` + wait『Script done』→ `hw-test-session finish` | | **Script 4（Thermal / Safety）** | `4_Blanton_Script_thermal_safety.ttl` | **獨立腳本，不接 A→B→C。** Script A 式的環境建立（登入 / session / 風扇 / `wait_init` / DUT 清單 / BMC / PCIe 清除 / `pcie_bus` / PMON / dmesg）→ **滿載**（`mlucas-avx2 -cpu 0:15`，V1.1.8 起與 Script B 同樣掛成 `mlucas-amm` systemd unit + `blanton_tr518.sh start`）→ `while 1`：PMON + `TH6_SWB0/1_power_readback.sh` + `avt_pmpower.sh`（CPU 封裝功耗，V1.2.3）+ `bgctl list` / `jobs` / `systemctl is-active mlucas-amm`，`pause 60`。**沒有收尾段** —— 中斷後 DUT 仍在 `port cd lb=mac` / `l2 learn off` / `test mode nr=yes`，且 CPU 仍滿載，要手動 `blanton_tr518.sh stop` + `systemctl stop mlucas-amm` | @@ -819,7 +819,7 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值， - [ ] `CHANGELOG.md`：延續三支腳本頂端的 Version History，集中成一份 - [ ] 三支腳本的 header 版號與 `CHANGELOG.md` 對齊，`config.ttl` 加 `script_version` 並寫進 log 開頭 - [ ] `docs/TTL_Script_Blanton_Status_*.xlsx` 更新為全 OK，或把剩餘項目移進 Future Extensions -- [x] 打 git tag，push `nas` + `gitea`（已至 `V1.2.6`；`publish/` 依 Script A 檔頭版號打包） +- [x] 打 git tag，push `nas` + `gitea`（已至 `V1.2.7`；`publish/` 依 Script A 檔頭版號打包） **驗收條件：** 從 zip 解壓到一台乾淨的測試 NB，照 README 操作，不看原始碼就能完成一輪 A→B→C 並產出 summary；`publish/` 內容與 git tag 一致。 diff --git a/CLAUDE.md b/CLAUDE.md index 4d18b75..0d2fc27 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,7 +9,7 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` → 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。 -**目前狀態（2026-10-21）**：Script A 為 **V1.2.6**（A 集中記錄所有 TTL 的變更）。涵蓋 +**目前狀態（2026-10-22）**：Script A 為 **V1.2.7**（A 集中記錄所有 TTL 的變更）。涵蓋 PCIe AER / DDR EDAC / PMON+TPM / 電壓 margin（9 顆 LTC2980）/ SWB loopback 線速流量 / 10G+1G 管理網路 ping / BMC DDR 與 USB / NVMe 健康，壓力層走平台的 `bgctl`。 switch unit 數量由 `config.ttl` 的 `SWB_UNIT0` / `SWB_UNIT1` 宣告，風扇轉速由 `FAN_SPEED` 指定 @@ -46,11 +46,12 @@ NFC tag 讀取由 `nfc_polling.sh` 背景輪詢（A 做基線、B 起、C 停並 **V1.2.6 起 FDR 統計（`blanton_fdr.sh`，`phydiag fdrstat`）接進流量**：A 包住流量基線（sleep 15→40）、 B 在 soak 前 start、每輪 rdcnt、C 收尾 rdcnt + stop，**只在兩個 unit 都開時才跑**。Script A 另在 BER 前先 `unused_lanes.sh off`， ⚠️ **沒有任何地方再 `on` 回來**。 +**V1.2.7**：`blanton_fdr.sh` 預設 port 改成只含有接線的 port（同 traffic 的 `TL_PS_PORTS`，不含 268）；`blantons_nfc_validate.py` 換成客戶 v2.5（`qfx5252-nfc-validate` 改名，`nfc_polling.sh` 不用改）。 以及 **`5_Blanton_Script_Boot_Cycle.ttl`**（重開機循環，**獨立跑不接 A→B→C**：登入 → 風扇 → Check Pt1~Pt13 → `reboot` → `wait "Booting in blind mode"`，`cnt_cycle` 每輪遞增，`while 1` 無止境， 要停就關 Tera Term 的 macro）。**尚未上機驗證**。 流程圖：`docs/Blanton_Test_Flow.drawio`。 -最後一次發布是 **V1.2.6**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。 +最後一次發布是 **V1.2.7**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。 margin 的 `VNOM` 已於 2026-08-30 改為 Blanton 實測中位數（144 條軌中 86 條上調 0.8~2.5%）。 交付用 `./publish/publish.sh` 打包。 @@ -196,7 +197,7 @@ sleep 30 # 至少等一個 interval 再 rep ~/Blanton_Script/blanton_fdr.sh clear # fdrstat clear ~/Blanton_Script/blanton_fdr.sh rdcnt # fdrstat Counters（Interval 結算後才讀，A 用 sleep 40） ~/Blanton_Script/blanton_fdr.sh stop # fdrstat STOp ⚠️ 關鍵字是類推的，未上機驗證 -# -u 0|1 單邊；-i 改 Interval；-n dry-run。ports 預設 '1-259,270-565'（FDR_PORTS 可改） +# -u 0|1 單邊；-i 改 Interval；-n dry-run。ports 預設同 traffic 的 TL_PS_PORTS（只含有接線的 port，不含 268；FDR_PORTS 可改） # ── 沒接線的 retimer lane / TH6 port 關 TX（V1.2.5；V1.2.6 起 Script A 會 off，沒人 on 回來）── ./Blanton_Script/unused_lanes.sh status # 兩 unit 全部列出 rx_lock / tx_off diff --git a/docs/release-notes/v1.2.7.md b/docs/release-notes/v1.2.7.md new file mode 100644 index 0000000..9a22146 --- /dev/null +++ b/docs/release-notes/v1.2.7.md @@ -0,0 +1,47 @@ +# v1.2.7 — FDR on the cabled ports only, and the vendor NFC tool updated to v2.5 + +## 🐛 Bug fixes + +**`blanton_fdr.sh` no longer prints the uncabled ports** (v1.0.1) +* The default port list was `'1-259,270-565'`, which also covered ports nothing is cabled to (cd15..19, cd47..51, cd111..115, ...). +* It is now the cabled-port list from `blanton_traffic_linespeed.sh` (`TL_PS_PORTS`), the same one `blanton_ber_debug.sh` uses: + `1-24,40-96,112-168,184-240,256-259,270-308,310-327,342-380,382-399,414-452,454-471,486-524,526-543,558-565`. +* Script A, B and C pick this up with no change to the TTLs. + +## 📦 Vendor tool update + +**`blantons_nfc_validate.py` v2.3 → v2.5** — the customer's `qfx5252-nfc-validate`, renamed to keep the name `nfc_polling.sh` calls. +* New: `--read-ndef` (Type 2 / Type 4 NDEF, Text and AMD FRU records), `--write-ndef` / `--set-location`, `--max-ndef-bytes`; NCI data packets with credit flow control. +* Fixed: a `FileNotFoundError` crash while listing the processes that hold the NFC device open. +* Bad arguments now print `[FAIL]` and exit 1 — `nfc_polling.sh` counts that as **FAIL**, not ERROR. +* The default `test --debug` output (`[PASS]` / `[FAIL]` lines, `NFCID1=`) is unchanged, so `nfc_polling.sh` is not modified. + +## 📦 Downloads + +| File | Contents | +|---|---| +| `Script_ABC_Blanton_V1.2.7.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT | + +```bash +chmod +x ~/Blanton_Script/*.sh +grep -rlU $'\r' ~/Blanton_Script # expect no output +python3 ~/Blanton_Script/blantons_nfc_validate.py --version # expect 2.5 +``` + +## ⚠️ Before you run + +* **Port 268 (ce0, 100G uplink) is not in the FDR list** — as before. Add it with `FDR_PORTS="...,268"` if FDR is wanted there. +* **The cabled-port list now lives in three scripts** — `blanton_traffic_linespeed.sh`, `blanton_ber_debug.sh`, `blanton_fdr.sh`. Change all three when the cabling changes. +* **Never put the NFC write flags (`--write-ndef`, `--set-location`, `--confirm-write`) in `NFC_ARGS`** — polling would rewrite the tag every round. +* **`blanton_fdr.sh stop` (`fdrstat STOp`) is still unverified on the bench**; see v1.2.6. +* **Nothing turns the unused lanes back on**; run `unused_lanes.sh on` by hand. See v1.2.6. +* **`blanton_ber.sh` (Script A / C) still uses `p=3` and `sleep 30`**; see v1.2.5. +* **Script 4 has no teardown**: finish it with `blanton_tr518.sh stop` **and** `systemctl stop mlucas-amm`. +* **`FAN_SPEED` is 100.** + +## 🔗 Links + +* [ARCHITECTURE.md](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/src/branch/main/ARCHITECTURE.md) — test flow, data models, constraints +* [CLAUDE.md](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/src/branch/main/CLAUDE.md) — commands and the bench gotchas + +**Full changelog:** [V1.2.6...V1.2.7](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.2.6...V1.2.7) diff --git a/src/Script_ABC_Blanton/1_Blanton_Script_A.ttl b/src/Script_ABC_Blanton/1_Blanton_Script_A.ttl index 243eacc..c29e580 100644 --- a/src/Script_ABC_Blanton/1_Blanton_Script_A.ttl +++ b/src/Script_ABC_Blanton/1_Blanton_Script_A.ttl @@ -1,7 +1,7 @@ ; ============================================================================= ; Script A for Blanton -; Version : V1.2.6 -; Date : 2026-10-21 +; Version : V1.2.7 +; Date : 2026-10-22 ; Author : ETWen ; ============================================================================= ; Version History: @@ -881,6 +881,24 @@ ; ScriptC fdr rdcnt before traffic stop, fdr stop after it ; (SWB_UNIT0 = SWB_UNIT1 = 1 only) - the closing read of the ; counters Script B started, bracketing the soak +; V1.2.7 2026-10-22 Blanton_Script/blanton_fdr.sh v1.0.1 - default ports are the cabled ports only +; '1-259,270-565' -> the TL_PS_PORTS list of +; blanton_traffic_linespeed.sh (same as blanton_ber_debug.sh) +; The old range also printed the uncabled ports (cd15..19, +; cd47..51, cd111..115, ...) +; !! port 268 (ce0) is still left out - add ',268' through +; FDR_PORTS if FDR is wanted on the 100G uplink +; !! the port list now lives in three scripts (traffic, +; BER debug, FDR) - change all three when the cabling changes +; Blanton_Script/blantons_nfc_validate.py Vendor tool v2.3 -> v2.5 (qfx5252-nfc-validate, renamed) +; Adds --read-ndef / --write-ndef / --set-location, NCI data +; packets with credit flow control; fixes a FileNotFoundError +; crash while listing the processes holding the NFC device +; Bad arguments now print [FAIL] and exit 1, so nfc_polling +; counts them as FAIL instead of ERROR +; The default "test --debug" output ([PASS]/[FAIL], NFCID1=) +; is unchanged - nfc_polling.sh is not modified +; !! never put the write flags in NFC_ARGS ; ============================================================================= include "config.ttl"