diff --git a/.gitignore b/.gitignore index 8af875b..8a1fadb 100644 --- a/.gitignore +++ b/.gitignore @@ -12,9 +12,10 @@ For_AI/ !**/logs/.gitkeep !**/Logs/.gitkeep -# 打包輸出 +# 打包輸出：產出不進 git，打包工具本身要進 publish/* !publish/.gitkeep +!publish/publish.sh # Office 暫存檔 ~$* diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 43bb6b2..7a79ae6 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -37,6 +37,7 @@ LTC2980 margin 控制器。TTL 只負責「按順序 `sendln` 並把畫面收進 | 電源 margin | LTC2980（= 2 × LTC2977）over PMBus，LINEAR16 編碼 | | 錯誤計數來源 | Linux PCIe AER sysfs（`aer_dev_*`）、EDAC sysfs（`dimm_ce/ue_count`） | | 平台監控 | SONiC `show platform *`（pmon container，含 `leak status` / `leak channels`） | +| BMC 存取 | host 端 `bmc-manager run ""`（不需對 BMC 開 SSH，繞開其 busybox 工具鏈） | | 壓力測試 | `mlucas-avx2`（AMD CPU）、`~/hammer/tools/stress_{mem,ssd,usb}.py` | | 資料面流量 | `bcmcmd`（Broadcom drivshell）VLAN loopback + `tx` burst，switch unit 0 / 1 | | 流量報表 | DUT 上 awk（`blanton_traffic_linespeed report`）；離線 `python3 tools/bcm_mibpair_report_V1.1.0.py` | @@ -106,7 +107,8 @@ Blanton_TTL_Script/ │ ├── CLAUDE.md # 專案記憶 & 給 Claude 的指令 ├── ARCHITECTURE.md # 本架構文件 -├── .gitignore # secret/ + For_AI/ + logs 規則 +├── .gitignore # secret/ + For_AI/ + logs + publish 產出 +├── .gitattributes # 換行符政策：.sh/.conf 釘 LF、.ttl 保持 CRLF │ ├── docs/ # 規格與狀態文件（客戶提供 / 專案產出） │ ├── Blantons_FPGA_Registers.md # FPGA 暫存器規格（markdown 正本，查 offset 用） @@ -131,7 +133,9 @@ Blanton_TTL_Script/ │ ├── For_AI/ # 🚫 gitignored — AI 協作素材（波形截圖、草稿） │ -├── publish/ # 可交付的打包輸出（Blanton_Script_ABC_v_/ + zip） +├── publish/ +│ ├── publish.sh # ✅ committed — 打包工具（版號讀 Script A 檔頭） +│ └── Script_ABC_Blanton_/ # 🚫 產出，gitignored（-z 另出同名 .zip） │ └── src/ └── Script_ABC_Blanton/ # ← Tera Term 的工作目錄（整包給測試員） @@ -148,6 +152,7 @@ Blanton_TTL_Script/ │ ├── show_dmesg.ttl # date + dmesg grep error/fail/warning │ ├── show_margin_status.ttl # source margin_status_all.sh（掃 9 顆 LTC2980） │ ├── kill_all_process.ttl # kill $(jobs -p) + │ ├── wait_init.ttl # 輪詢 show platform temperature 直到 pmon 起來 │ ├── show_pcie_error_reg.ttl # 舊的合併版（已被下列 per-device 版取代） │ ├── show_pcie_error_reg_TH6_SWB0.ttl # EP 01:00.0 + RP 00:01.1 │ ├── show_pcie_error_reg_TH6_SWB1.ttl # EP 02:00.0 + RP 00:01.2 @@ -167,12 +172,18 @@ Blanton_TTL_Script/ ├── blanton_pwr_data.sh # SWB VRM + PDB brick 的 Vin/Vout/Iout/Temp 表 ├── blanton_traffic_linespeed.sh # SWB loopback 線速流量（bcmcmd unit 0/1） │ # init/clear/show/start/stop/ps/report/run + ├── bmc_monitor.sh # BMC 監控：週期跑 free -m，寫輪替 log + ├── bmc_monitor_ddr.sh # BMC DDR 壓力：memtester，逾時 3600s + │ # ↑ 兩支都要 chmod +x 才能跑（見 Key Constraints） └── LTC2980_Margin_Script/ # 電壓 margin 子專案（另有獨立 repo） ├── margin.sh # margin_init/status/set/apply_profile/save ├── settings/*.conf # 一個 .conf = 一顆 LTC2980（CB + SWB0/1 × CONN13~16） ├── profiles/*.conf # 16-ch 批次組合（comboA/B、high3/5、low3/5、normal、off） ├── script/*_all.sh # 跨 9 顆 LTC2980 的批次 status / apply / save + ├── Ref/margin_command_trace.md # 指令追蹤參考（SWB 章節已標過期，見文件內警告） └── logs/ # margin 操作 log + # 註：v2.6.0 起不再內含 blanton_cb_i2c.sh / blanton_fpga_pcimem.sh 的複本， + # 改由 _swb_find_backend 往上層 Blanton_Script/ 找共用版 ``` --- @@ -208,6 +219,18 @@ Log 檔名規則：`\Logs\__.l Channel 定址：`ch / 8` → `CHIPS[]` index，`ch % 8` → LTC2977 PMBus PAGE（0x00~0x07）。 +**SWB 通道與位址對應（2026-08-19 上機驗證，`ababb2c`）：** + +| FPGA I2C 通道 | 板 / 接頭 | LTC2977 位址（lo / hi） | +|---|---|---| +| Ch6 | SWB0 CONN14 / CONN16 | CONN14 `0x5C`,`0x5E` ; CONN16 `0x62`,`0x64` | +| Ch8 | SWB0 CONN13 / CONN15 | CONN13 `0x5C`,`0x5E` ; CONN15 `0x62`,`0x64` | +| Ch7 | SWB1 CONN14 / CONN16 | CONN14 `0x5C`,`0x5E` ; CONN16 `0x62`,`0x64` | +| Ch9 | SWB1 CONN13 / CONN15 | CONN13 `0x5C`,`0x5E` ; CONN15 `0x62`,`0x64` | + +> 同一顆 LTC2980 的兩個位址**相差 2**（7-bit，由規格書 8-bit 配對除以 2 而來），不是 1。 +> 兩張板共用一條通道，所以同通道上的位址必須互斥 —— 上表兩組（`0x5C/0x5E` 與 `0x62/0x64`）不重疊。 + ### 3. `profiles/*.conf` — 16-ch 批次 margin 組合 ```bash @@ -267,16 +290,18 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... ) # "channel:operation:change_perc | 模組 | 進入點 | 功能 | |------|--------|------| -| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` | root 登入 → `mkdir ./logs` → `date -s` 對時 → source **六個** bash 工具 → 清/讀 7 組 PCIe AER → `lspci -tvvv/-vv` → margin 全掃 → PMON 九項 → dmesg 三 grep → `messagebox` 提示接 Script B | -| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + 5 份 `stress_mem.py` + `stress_ssd.py` + `stress_usb.py` 背景執行（**共 8 個 job**）→ `jobs` 確認 → traffic `ps/init/clear/show/start -u 0` → `while 1` 每輪完整 PMON + margin | -| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` → PMON + dmesg 再抓一次 → 7 組 AER 再抓一次 → `cat` mlucas / stress_ssd log → traffic `stop` + `report -u 0` → 完成 messagebox | +| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.0.3 | root 登入 → `date -s` 對時 → `show boot` → **等 pmon 起來**（`wait_init.ttl`）→ BMC 版本 → source 六個 bash 工具 → 清/讀 7 組 PCIe AER → `lspci` → margin 全掃 → PMON 九項 → dmesg → 100G port 狀態 → **一輪流量基線** → `show uptime` | +| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + 5 份 `stress_mem.py` + `stress_ssd.py` + `stress_usb.py`（**共 8 個 job**）→ 啟動兩支 BMC monitor → `jobs` → 100G port 狀態 → traffic `ps/init/clear/show/start`（**兩個 unit**）→ `while 1` 每輪完整 PMON + margin | +| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` → PMON + dmesg → 7 組 AER → 停兩支 BMC monitor 並 `cat` 其 log → `cat` mlucas / stress_ssd log → traffic `stop` + `report`（兩個 unit）→ `show reboot-cause` / `show uptime` → 完成 messagebox | | **SWB loopback 流量** | `blanton_traffic_linespeed [-u 0\|1\|all]` | `init`（VLAN 30..137，成對 `cdN`/`cdN+32`）→ `clear` → `start`（`tx 100 length=512`）→ `stop` → `report`（per-pair TX/RX 交叉比對 PASS/FAIL）；另有 `ps`（link/speed）與 `run`（一條龍） | | **FPGA 暫存器存取** | `cb_fpga [data]`、`fpga_rescan` | pcimem 打 `resource0` + BAR 相對 offset，32-bit word；BDF 於 source 時自動偵測；`pmc/icb/swb0/swb1_fpga` 走 VSPI 窗口 | | **CB I2C / PMBus** | `cb_i2c_init/scan/read/write`、`cb_pmbus_read/write/linear16` | FPGA F3 OpenCores master，**讀用 Repeated START**（SMBus/PMBus 裝置必需） | | **ICB / PDB 存取** | `vi2c_init/scan/read/write`、`vi2c_scan_all` | CB F3 VI2C proxy，~3.3 ms/reg，取代 VSPI 的 ~18 ms/reg（後者會踩 SMBus 25–35 ms timeout） | | **溫度** | `temp_cb` / `temp_icb` / `temp_all` | TMP75（12-bit 左靠齊 ×0.0625）、TMP432（含 RANGE bit 的 −64 偏移、remote1/2） | | **電源資料** | `pwr_data` / `pwr_data_pdb` / `pwr_pdb_id` | SWB VRM 全軌 Vin/Vout/Iout/Temp 對齊表；MP29816 解析度**執行期從 `MFR_VOUT_SCALE_LOOP` 讀**，不寫死 | -| **電壓 Margin** | `margin_init/status/set/apply_profile/save` + `*_all.sh` | 9 顆 LTC2980（CB CONN13、SWB0/1 CONN13~16）批次 high/low margin 與狀態掃描 | +| **電壓 Margin** | `margin_init/status/set/apply_profile/save` + `*_all.sh` | 9 顆 LTC2980（CB CONN13、SWB0/1 CONN13~16）批次 high/low margin 與狀態掃描。v2.6.0 起 SWB 路徑真正接上共用 cb_i2c 後端，並有 `margin_swb_info/probe/scan/reset/sem` 除錯包裝 | +| **BMC 監控 / 壓力** | `bmc_monitor.sh` / `bmc_monitor_ddr.sh` `{start\|stop\|status\|fg\|tail\|clear}` | 由 host 端 `bmc-manager run` 週期性打 BMC，背景 detached、log 輪替。前者跑 `free -m`（逾時 30s），後者跑 `memtester`（逾時 3600s），各自獨立 log 與 pid | +| **打包交付** | `publish/publish.sh [-v Ver] [-f] [-z] [-n]` | 版號讀 Script A 檔頭，複製成 `publish/Script_ABC_Blanton_/`，排除 `*.log`，可另出 zip | --- @@ -298,7 +323,12 @@ Script A ── logopen Logs/Blanton_Margin_.log ──┐ (之後所有畫 ├─ lspci -tvvv / -vv ← 拓樸 + link speed/width ├─ margin_status_all ← 9 顆 LTC2980 × 16ch 的 Vout 與偏差% ├─ show platform × 9 ← fan/temp/psu/voltage/current/ssdhealth/leak status/leak channels - └─ dmesg | grep error/fail/warning + ├─ dmesg | grep error/fail/warning + ├─ show interfaces status Ethernet513,Ethernet514 ← 100G uplink 狀態 + ├─ 一輪流量基線：ps → init → clear → show → start → stop → report + └─ show uptime + （最前面還有 wait_init.ttl：輪詢 show platform temperature 直到不再回報 + "Thermal Not detected"，避免 pmon 還沒起來就抓基線） ▼ [messagebox "Start Script B"] ← 人工確認後手動跑 B │ @@ -306,8 +336,9 @@ Script A ── logopen Logs/Blanton_Margin_.log ──┐ (之後所有畫 Script B ── 同一個 log 檔續寫（logwrite 分隔線） ├─ 背景程序：mlucas-avx2(CPU) ×1, stress_mem ×5, stress_ssd, stress_usb → 共 8 個 job │ （stress_hhmd / stress_pcie 已於 2026-08-17 移除，見 Status 表 ScriptB #5/#7 "KC Remove"） + ├─ BMC: bmc_monitor.sh start + bmc_monitor_ddr.sh start ├─ jobs ← 確認全部起來了 - ├─ traffic: ps → init → clear → (pause 3) → show → start （unit 0，VLAN 30..137 loopback） + ├─ traffic: ps → init → clear → (pause 15) → show → start （unit 0 與 1，VLAN 30..137 loopback） └─ while 1: setup_pmon（9 項）→ margin_status_all （soak 期間持續取樣） ▼ [測試員 Ctrl-C / 停止 macro，接著跑 C] @@ -317,8 +348,10 @@ Script C ├─ kill $(jobs -p) ← 收掉所有背景壓力 ├─ show platform × 9 + dmesg ← 收工快照 ├─ AER 再抓一次 ← 與 Script A 基線相減 = 本輪新增錯誤 + ├─ BMC: 兩支 monitor stop → cat log/bmc_poll.log + log/bmc_ddr.log ├─ cat mlucas_amm_log / log.stress_ssd ← 壓力程式自身的 pass/fail - └─ traffic: stop → report ← per-pair TX/RX 交叉比對，PASS/FAIL/NA（exit 2 = 有 FAIL/NA） + ├─ traffic: stop → report ← per-pair TX/RX 交叉比對，PASS/FAIL/NA（exit 2 = 有 FAIL/NA） + └─ show reboot-cause / show uptime ← soak 期間有沒有意外重開，一眼看得到 ▼ [messagebox "GOOD JOB! Test Case DONE"] → 人工檢查 log ``` @@ -369,7 +402,19 @@ pwr_data 否則它會吃掉 while 迴圈的 stdin，導致**只有第一個 VLAN 被設定**（V0.3.1 修的 bug）。 11. **DUT 密碼不得進 git**：`1_Blanton_Script_A.ttl` 目前的 `sendln "YourPaSsWoRd"` 是 placeholder， 實際帳密必須放 `secret/config_secret.ttl`（gitignored）並由 `config.ttl` include。 -12. **客戶 NDA**：`docs/` 內含客戶 FPGA 規格與 schematic 衍生資訊，**本 repo 只推 NAS + Gitea， +12. **`.sh` / `.conf` 必須是 LF**：CRLF 的 shell script 在 SONiC 上直接掛 + （`-bash: $'\r': command not found` + `syntax error near unexpected token`）， + `settings/*.conf` 則因為是被 `source` 的，未加引號的賦值會變成 `"6\r"`（安靜地壞掉）。 + `.gitattributes` 已把 `*.sh` `*.conf` `*.py` `*.txt` `*.md` 釘成 LF、`*.ttl` 維持 CRLF。 + ⚠️ 但 `.gitattributes` **不會回頭重寫既有工作區檔案** —— 早於它 clone 出來的目錄， + 需 `git rm --cached -r . && git reset --hard` 或刪掉目錄重新 checkout 才會生效， + 而且 `git status` 乾淨**不代表**磁碟上是 LF（`--renormalize` 只在進 index 的路上轉換）。 +13. **`bmc_monitor*.sh` 需要執行權**：它們是本專案第一組「被執行」而非被 `source` 的腳本， + 而 `do_start` 內部是 `setsid "$SCRIPT_PATH" __daemon`，**即使用 `bash x.sh start` 呼叫 + 也仍需 exec bit**。git 記錄為 `100644`，且 Windows → 隨身碟 → DUT 的路徑無法攜帶權限位元， + 所以佈署後要先 `chmod +x ~/Blanton_Script/bmc_monitor*.sh`，否則 Script B 的 start 會 + `Permission denied`、Script C 的 `cat` 撲空（BMC 段全空但不會報錯）。 +14. **客戶 NDA**：`docs/` 內含客戶 FPGA 規格與 schematic 衍生資訊，**本 repo 只推 NAS + Gitea， 絕不推 GitHub**。 --- @@ -404,6 +449,9 @@ cp secret/config_secret.ttl.example secret/config_secret.ttl # ── 2. DUT 端：部署 bash 工具庫 ───────────────────────────── scp -r src/Script_ABC_Blanton/Blanton_Script admin@:~/ +# 佈署後務必補執行權（Windows/隨身碟路徑帶不動 exec bit）： +ssh admin@ 'chmod +x ~/Blanton_Script/bmc_monitor*.sh' +# 若曾在舊工作區編輯過，先確認沒有 CRLF：grep -rlU $'\r' ~/Blanton_Script ssh admin@ 'sudo -i' # （現場無網路時改用 USB 隨身碟複製到 ~/Blanton_Script） @@ -439,6 +487,19 @@ lspci -Dnn # 對照 ARCHITECTURE.md 的 PCIe 拓樸表 8. 檢查 Logs\Blanton_Margin_.log ``` +**打包交付：** + +```bash +./publish/publish.sh # 版號讀 Script A 檔頭 → publish/Script_ABC_Blanton_V1.0.3/ +./publish/publish.sh -z # 另外產出同名 .zip +./publish/publish.sh -n # dry run，只印會做什麼 +./publish/publish.sh -f # 覆蓋既有輸出資料夾 +``` + +版號**不是參數而是從 Script A 的 `; Version : Vx.y.z` 讀出來的**，所以資料夾名不可能跟 +測試員打開 macro 看到的版本不一致。要出新版就先改 Script A 檔頭再跑。 +輸出會排除 `*.log`（測試 log 含 DUT 序號，不隨交付外流），但保留空的 `logs/` 供 `logopen` 寫入。 + > 註：本專案非 .NET / Blazor / EC2 架構，`aws-ec2-deploy` 與 `vbox-run-deploy` 兩份部署指南不適用，已跳過。 --- @@ -506,6 +567,10 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值， - [x] soak 每輪補 `show platform psustatus` / `voltage` / `current` —— 迴圈已改為 `include "utils/setup_pmon.ttl"`，九項全收 - [ ] 補 `; ========== CLEAR EVENT ==========`（Status 表 ScriptB #1，Owner: Alan） +- [x] BMC 納入 soak：`bmc_monitor.sh`（`free -m` 取樣）與 `bmc_monitor_ddr.sh`（`memtester`） + 由 Script B 啟動、Script C 停止並把 log 併進 master log +- [x] Script A 加開機資訊與就緒等待：`show boot`、BMC `/etc/issue`、`wait_init.ttl` +- [x] Script C 加 `show reboot-cause` / `show uptime`，soak 期間意外重開看得見 **驗收條件：** Script B 啟動後 `jobs` 顯示 8 個 job；連續跑 3 輪，log 內三段各自帶正確時戳且間隔 ≈10 min； 故意把 `~/hammer` 改名，Script B 會在前置檢查就停下並提示。 @@ -530,14 +595,15 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值， （取代原規劃的 `utils/show_traffic_counters.ttl`） - [x] Script B 接上 `ps → init → clear → show → start`、Script C 接上 `stop → report` - [x] 原始 bcmcmd 指令表留檔：`tools/traffic_loopback_{vlan_setting,start,vlan_remove}.txt` -- [ ] **Script A 的 TRAFFIC-SETUP-STAGE 仍是空區塊** —— 目前流量只在 B/C，A 沒有基線 +- [x] **Script A 的流量基線** —— 原本的空區塊已改成完整一輪 + （`ps → init → clear → show → start → stop → report`，含 15 秒沉澱） - [ ] `utils/show_interface_detail.ttl`：`show interface transceiver eeprom/dom`、 `show interface link-training`（Status 表 ScriptC #4，仍 On-Going） - [ ] `utils/show_tech.ttl`：`show techsupport`（Script C 收工快照，Status 表 ScriptC #4） - [ ] `config.ttl` 加 `EN_Traffic` 旗標，未接 loopback 線的站點可整段跳過 （現在 B/C 是無條件執行，沒接線會整批 bcmcmd 失敗） -- [ ] 兩支腳本目前都寫死 `-u 0`，另一塊 switch board（unit 1）沒被測到； - 工具本身預設是 `TL_UNITS="0 1"`，要決定是照工具預設跑兩塊，還是維持只測 unit 0 +- [x] `-u 0` 已從三支腳本移除，全部沿用工具預設 `TL_UNITS="0 1"`，兩塊 switch board 都測到 +- [x] 100G uplink 狀態：`show interfaces status Ethernet513,Ethernet514`（A 與 B 各一次） **驗收條件：** `EN_Traffic=1` 時，Script C 的 `report` 印出 108 對的 TX/RX 表且全 PASS； 拔掉一條 loopback 線重跑，該對顯示 FAIL 或 NA 且 exit code 為 2；`EN_Traffic=0` 時整段不執行且不報錯。 @@ -570,9 +636,9 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值， **目標：** 產出可直接交給現場測試員（或客戶）的一包，含操作手冊，不需要看原始碼。 **包含：** -- [ ] `tools/publish.sh`：把 `src/Script_ABC_Blanton/` + 空 `Logs/` + `secret/*.example` - 打包成 `publish/Blanton_Script_ABC_v_/` 與同名 zip（比照 - 既有的 `Blanton_Script_ABC_v1.0_20251229` 命名） +- [x] `publish/publish.sh`：把 `src/Script_ABC_Blanton/` 打包成 + `publish/Script_ABC_Blanton_/`（`-z` 另出 zip）。版號讀 Script A 檔頭， + 排除 `*.log` 但保留空的 `logs/`。工具本身進 git，產出被 gitignore - [ ] `README.md`（現場用）：Tera Term 設定、A→B→C 操作順序、常見錯誤（BDF 不符、 margin 掃不到、hammer 工具缺檔）與對應處理 - [ ] `CHANGELOG.md`：延續三支腳本頂端的 Version History，集中成一份 @@ -602,6 +668,16 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值， bash 工具，速度與可靠度都比 serial 好，TTL 只保留開機階段。 - **多 DUT 併行**：多台 DUT 同時 soak 時，Tera Term 每台開一個 macro window； 可考慮改成 Python（`pyserial`）統一排程與集中收 log。 -- **與 `LTC2980_Margin_Script` 獨立 repo 的同步機制**：目前 `Blanton_Script/LTC2980_Margin_Script/` - 是該 repo 的複本（少了 `ARCHITECTURE.md`/`CLAUDE.md`/`Reference/`，多了兩支 `blanton_*` 後端）。 - 待評估改用 git submodule 或明確的 vendored 同步腳本。 +- ✅ **margin 子專案的重複檔** —— v2.6.0 已移除內含的 `blanton_cb_i2c.sh` / + `blanton_fpga_pcimem.sh` 複本，改由 `_swb_find_backend` 往上層找共用版，漂移風險解除。 + 與獨立 repo `LTC2980_Margin_Script` 的同步機制（submodule 或 vendored 腳本）仍待評估。 +- **`Ref/margin_command_trace.md` 需重新產生**：SWB 章節的 1223 條 `cb_pmbus_*` 指令是依 + 修正前的通道／位址展開的（其中 487 條用到已不存在的 `0x5D`/`0x5F`/`0x63`/`0x65`）， + 文件已加過期警告但內文未動。第 1~4 章不受影響。 +- **`wait_init.ttl` 沒有逾時出口**：若 pmon 一直起不來，`result` 既非 1 也非 2，迴圈會無限重試， + Script A 既不往下走也不報錯。可加最大重試次數 + `messagebox` 提示。 +- **`bmc_monitor*.sh` 的執行權**：目前需人工 `chmod +x`。可在 Script B 起它們之前補一行 + `chmod +x`（比照既有的 `chmod +x ~/hammer/tools/amd/mlucas-avx2`），或在 publish 時處理。 +- **`bmc_monitor_ddr.sh` 的壓力強度**：`memtester 500M 1` 配 `INTERVAL_SEC=5` 等於整個 soak + 近乎不間斷壓 BMC 記憶體，而 BMC 同時還要服務 host 的 `show platform` 查詢。 + 若 PMON 取數變慢，先調大 `INTERVAL_SEC` 或縮小 memtester 的量。 diff --git a/CLAUDE.md b/CLAUDE.md index a4b3be3..eb040de 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,6 +9,10 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` → 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。 +**目前狀態（2026-08-21）**：Script A/B/C 為 **V1.0.3**，涵蓋 PCIe AER / DDR EDAC / PMON / +電壓 margin（9 顆 LTC2980）/ SWB loopback 線速流量（兩個 switch unit）/ BMC 監控與 DDR 壓力。 +SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。交付用 `./publish/publish.sh` 打包。 + ## 技術棧 - **Host**：Tera Term 5.x TTL macro（`.ttl`），Windows @@ -19,6 +23,7 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` → - **Margin**：LTC2980（= 2 × LTC2977）over PMBus，LINEAR16 - **資料面流量**：`bcmcmd`（Broadcom drivshell）SWB loopback，VLAN 30..137 成對 `cdN`/`cdN+32`， `tx 100 length=512`；判定讀 ASIC `MIB_TPOK`/`MIB_RPOK` 做 per-pair 雙向交叉比對 +- **BMC**：host 端 `bmc-manager run ""`，不需對 BMC 開 SSH（繞開其 busybox 工具鏈） - **判定資料源**：PCIe AER sysfs（`aer_dev_*`）、EDAC sysfs（`dimm_{ce,ue}_count`）、SONiC `show platform *` - **無編譯步驟**：TTL 與 bash 都直譯執行 @@ -50,24 +55,44 @@ pwr_data # SWB VRM 全軌 margin_init Blanton_CB_CONN13 && margin_status # ── SWB loopback 流量（bcmcmd，unit 0/1）───────────── -blanton_traffic_linespeed ps -u 0 # 對照線的 link/speed -blanton_traffic_linespeed init -u 0 # VLAN 30..137，cdN <-> cdN+32 -blanton_traffic_linespeed clear -u 0 # clear c -blanton_traffic_linespeed start -u 0 -tx 100 -length 512 -blanton_traffic_linespeed stop -u 0 # 移除 VLAN 成員（--destroy 連 VLAN 一起砍） -blanton_traffic_linespeed report -u 0 # per-pair TX/RX + PASS/FAIL（exit 2 = 有 FAIL/NA） -blanton_traffic_linespeed run -u 0 # ps → init → clear → start → report 一條龍 -blanton_traffic_linespeed init -u 0 -n # -n dry-run：只印要下的 bcmcmd，不碰 DUT +# 不帶 -u 就是預設 TL_UNITS="0 1"，兩塊 switch board 都做（TTL 三支腳本即如此） +blanton_traffic_linespeed ps # 對照線的 link/speed +blanton_traffic_linespeed init # VLAN 30..137，cdN <-> cdN+32 +blanton_traffic_linespeed clear # clear c +blanton_traffic_linespeed start -tx 100 -length 512 +blanton_traffic_linespeed stop # 移除 VLAN 成員（--destroy 連 VLAN 一起砍） +blanton_traffic_linespeed report # per-pair TX/RX + PASS/FAIL（exit 2 = 有 FAIL/NA） +blanton_traffic_linespeed run # ps → init → clear → start → report 一條龍 +blanton_traffic_linespeed init -u 0 # 只做單一 unit 時才需要 -u +blanton_traffic_linespeed init -n # -n dry-run：只印要下的 bcmcmd，不碰 DUT blanton_traffic_linespeed report -f # 離線重解一份存下來的 console log # 離線版報表（開發機上跑，選項更多） python3 tools/bcm_mibpair_report_V1.1.0.py -a +# ── BMC 監控 / 壓力（需先 chmod +x！）──────────────── +chmod +x ~/Blanton_Script/bmc_monitor*.sh # 佈署後必做一次 +~/Blanton_Script/bmc_monitor.sh start # free -m 取樣，log/bmc_poll.log +~/Blanton_Script/bmc_monitor_ddr.sh start # memtester，log/bmc_ddr.log +~/Blanton_Script/bmc_monitor.sh status # pid / log 路徑 / log 大小 +~/Blanton_Script/bmc_monitor.sh stop +# ⚠️ tail 子命令是 tail -f，會卡住不返回；要倒 log 請直接 cat log/*.log + # ── 各工具的 help ─────────────────────────────────── blanton_fpga_help ; blanton_cb_i2c_help ; vi2c_help temp_sensor_help ; pwr_data_help ; blanton_traffic_linespeed_help ``` +**打包交付（在開發機上）：** + +```bash +./publish/publish.sh # 版號讀 Script A 檔頭 → publish/Script_ABC_Blanton_V1.0.3/ +./publish/publish.sh -z # 另出 zip +./publish/publish.sh -n # dry run +``` + +要出新版**先改 Script A 檔頭的 `; Version :`**，publish 才會用新版號建資料夾。 + **Host 端跑一輪測試：** ``` @@ -94,6 +119,10 @@ Tera Term 連 COM port (115200-8-N-1) 若要回到「每支各自記錄」，B/C 的 History 需要補回去 - **Commit**：Conventional Commits，**英文**。scope 用 `ttl` / `fpga` / `i2c` / `vi2c` / `margin` / `pwr` / `temp` / `docs` +- **換行符**：由 `.gitattributes` 管理 —— `*.sh` `*.conf` `*.py` `*.txt` `*.md` 釘 **LF** + （要在 SONiC 上跑／被 source），`*.ttl` 維持 **CRLF**（Tera Term 只在 Windows 跑）。 + 編輯 `.ttl` 時要保留 CRLF，別讓整檔變成 LF 產生假 diff +- **打包**：`./publish/publish.sh`，版號**讀 Script A 檔頭**不是參數 —— 先改檔頭再打包 - **Status 表**：`docs/TTL_Script_Blanton_Status_*.xlsx` 是逐項進度的正本（OK / On-Going + Owner）， 完成一項就同步更新，別讓文件跟腳本脫節 @@ -130,9 +159,23 @@ Tera Term 連 COM port (115200-8-N-1) - ⚠️ **`stress_hhmd.py` / `stress_pcie.py` 已於 2026-08-17 由 KC 移除**（Status 表 ScriptB #5/#7）。 Script B 現在是 **8 個背景 job**（1 mlucas + 5 mem + ssd + usb），不是 10 個。 I2C／PCIe 的持續讀取壓力目前沒有替代品。 -- ⚠️ **Script B 的 traffic 與 soak 迴圈都寫死 `-u 0`、且迴圈沒有 `pause`**： - 只測到一塊 switch board，取樣間隔也不是 Status 表寫的 10 分鐘（取決於指令執行時間）。 - 改之前先確認現場期待的是哪一種。 +- ⚠️ **soak 迴圈沒有 `pause`**：取樣間隔不是 Status 表寫的 10 分鐘，而是取決於指令執行時間。 + （`-u 0` 已於 `491e807` 移除，A/B/C 現在都跑兩個 switch unit。） +- 🔒 **`.sh` / `.conf` 一定要 LF**。CRLF 的 shell script 在 SONiC 上直接掛（`$'\r': command not found`）； + `settings/*.conf` 更陰險 —— 它們是被 `source` 的，`CB_I2C_CH=6` 會變成 `"6\r"`，安靜地壞掉。 + `.gitattributes` 已擋住 git 這條路徑，但**不會回頭重寫既有工作區檔案**：早於它 clone 的目錄要 + `git rm --cached -r . && git reset --hard` 才會生效，而且 **`git status` 乾淨不代表磁碟上是 LF** + （`--renormalize` 只在進 index 的路上轉換）。驗證要看 byte：`grep -rlU $'\r' ` +- ⚠️ **`bmc_monitor*.sh` 需要 exec bit**，且**不是改用 `bash x.sh start` 就能繞過** —— + `do_start` 內部是 `setsid "$SCRIPT_PATH" __daemon`，直接執行該路徑。git 記錄是 `100644`， + Windows → 隨身碟 → DUT 也帶不動權限位元，所以佈署後要 `chmod +x ~/Blanton_Script/bmc_monitor*.sh`。 + 沒做的話 Script B 的 start 會 Permission denied、Script C 的 `cat` 撲空，而且**不會報錯**， + 只會得到一份 BMC 段全空的 log +- ⚠️ **`bmc_monitor*.sh` 的 `tail` 子命令是 `tail -n 50 -f`，永遠不返回**。TTL 裡絕對不要呼叫它 + （Script C 曾因此卡死，`18ce7a1` 改成直接 `cat log/*.log`） +- ⚠️ **DUT 的 awk 對 `%d` 會夾到 INT32**（2147483647）。線速流量的計數器是 ~10¹² 量級， + 所以 awk 裡輸出大數一律用 `%.0f`（double 域，精確到 2⁵³）。`blanton_traffic_linespeed.sh` + V0.4.1 已修；寫新的 awk 報表時要記得同一件事 ## 資料夾說明 @@ -141,6 +184,6 @@ Tera Term 連 COM port (115200-8-N-1) - `tools/` — Host / 離線端：`bcm_mibpair_report_V1.1.0.py`（drivshell log → per-pair 報表）、 `traffic_loopback_*.txt`（bcmcmd 原始指令表，`blanton_traffic_linespeed.sh` 是其 bash 版， **改 loopback 線路時兩邊要同步**） -- `publish/` — 交付用打包輸出（`Blanton_Script_ABC_v_/` + zip） +- `publish/` — `publish.sh`（打包工具，**進 git**）+ `Script_ABC_Blanton_/` 產出（**gitignored**） - `secret/` — 🚫 gitignored（除 `README.md` 與 `*.example`）：DUT 帳密、per-unit BDF 覆寫、COM 設定 - `For_AI/` — 🚫 gitignored：AI 協作素材（波形截圖、草稿筆記） diff --git a/publish/publish.sh b/publish/publish.sh new file mode 100644 index 0000000..80406a1 --- /dev/null +++ b/publish/publish.sh @@ -0,0 +1,108 @@ +#!/usr/bin/env bash +# ============================================================================= +# publish.sh -- package src/Script_ABC_Blanton for delivery +# ============================================================================= +# Version History: +# V1.0.0 2026-08-21 Initial. Copies src/Script_ABC_Blanton to +# publish/Script_ABC_Blanton_, taking +# from the "; Version : Vx.y.z" header of +# 1_Blanton_Script_A.ttl. +# ============================================================================= +# +# The version is READ FROM Script A rather than passed in, so the folder name +# can never disagree with the header the tester sees when they open the macro. +# Bump Script A's header first, then run this. +# +# Usage: +# ./publish/publish.sh # publish at Script A's version +# ./publish/publish.sh -v V1.0.4 # override the version +# ./publish/publish.sh -f # overwrite an existing output folder +# ./publish/publish.sh -z # also produce a .zip next to it +# ./publish/publish.sh -n # dry run: print what would happen +# ============================================================================= +set -u + +SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)" +REPO_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd)" +SRC_DIR="${REPO_ROOT}/src/Script_ABC_Blanton" +OUT_ROOT="${SCRIPT_DIR}" +NAME="Script_ABC_Blanton" +VER=""; FORCE=0; ZIP=0; DRY=0 + +info() { printf '[\033[34mINFO\033[0m] %s\n' "$*"; } +ok() { printf '[\033[32m OK \033[0m] %s\n' "$*"; } +die() { printf '[\033[31mERR \033[0m] %s\n' "$*" >&2; exit 1; } + +usage() { sed -n '2,26p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; exit 0; } + +while [ $# -gt 0 ]; do + case "$1" in + -v|--version) VER="${2:-}"; shift 2 ;; + -f|--force) FORCE=1; shift ;; + -z|--zip) ZIP=1; shift ;; + -n|--dry-run) DRY=1; shift ;; + -h|--help) usage ;; + *) die "unknown option '$1' (try -h)" ;; + esac +done + +[ -d "${SRC_DIR}" ] || die "source not found: ${SRC_DIR}" + +# --- version from Script A's header ------------------------------------------ +# The .ttl files are CRLF, so strip the carriage return or it lands in the +# folder name and produces a directory no one can cd into. +if [ -z "${VER}" ]; then + A_TTL="${SRC_DIR}/1_Blanton_Script_A.ttl" + [ -f "${A_TTL}" ] || die "cannot read version: ${A_TTL} missing" + VER=$(grep -m1 -E '^;[[:space:]]*Version[[:space:]]*:' "${A_TTL}" \ + | tr -d '\r' | sed -E 's/.*:[[:space:]]*//; s/[[:space:]]+$//') + [ -n "${VER}" ] || die "no '; Version : Vx.y.z' header in $(basename "${A_TTL}")" + info "version from $(basename "${A_TTL}") : ${VER}" +else + info "version (overridden) : ${VER}" +fi + +case "${VER}" in + V[0-9]*) ;; + *) die "version '${VER}' does not look like Vx.y.z" ;; +esac + +DEST="${OUT_ROOT}/${NAME}_${VER}" +info "source : ${SRC_DIR#${REPO_ROOT}/}" +info "destination : ${DEST#${REPO_ROOT}/}" + +if [ -e "${DEST}" ]; then + [ "${FORCE}" = "1" ] || die "${DEST##*/} already exists (use -f to overwrite)" + [ "${DRY}" = "1" ] || rm -rf -- "${DEST}" + info "existing folder removed (-f)" +fi + +if [ "${DRY}" = "1" ]; then + info "dry run: nothing copied" + exit 0 +fi + +# --- copy --------------------------------------------------------------------- +# Captured console logs are per-run and often carry DUT serials, so they are +# never shipped; the empty logs/ directory itself is kept because Script A's +# logopen writes into it. +mkdir -p -- "${DEST}" || die "cannot create ${DEST}" +if command -v rsync >/dev/null 2>&1; then + rsync -a --exclude='*.log' "${SRC_DIR}/" "${DEST}/" || die "rsync failed" +else + cp -a -- "${SRC_DIR}/." "${DEST}/" || die "cp failed" + find "${DEST}" -type f -name '*.log' -delete +fi + +# Tera Term's logopen target, in case the source tree never had one +mkdir -p -- "${DEST}/logs" + +n_files=$(find "${DEST}" -type f | wc -l) +ok "${n_files} files -> ${DEST##*/}" + +if [ "${ZIP}" = "1" ]; then + command -v zip >/dev/null 2>&1 || die "zip not installed" + ( cd -- "${OUT_ROOT}" && rm -f -- "${NAME}_${VER}.zip" \ + && zip -qr "${NAME}_${VER}.zip" "${NAME}_${VER}" ) || die "zip failed" + ok "$(du -h "${OUT_ROOT}/${NAME}_${VER}.zip" | cut -f1) -> ${NAME}_${VER}.zip" +fi diff --git a/src/Script_ABC_Blanton/config.ttl b/src/Script_ABC_Blanton/config.ttl index 6490fc5..b4122d7 100644 --- a/src/Script_ABC_Blanton/config.ttl +++ b/src/Script_ABC_Blanton/config.ttl @@ -1,10 +1,10 @@ ;================================================================ ; User Configuration ;================================================================ -strTestcase="Margin" project_name = "Blanton" +strTestcase="ENV" ;ENV,EMC,Margin...etc -EN_Margin = 1 ; 1: Enable Margin Test, 0: Disable Margin Test +EN_Margin = 0 ; 1: Enable Margin Test, 0: Disable Margin Test EN_log = 1 ; 1: Enable log, 0: Disable log ;================================================================