docs(arch): Sync ARCHITECTURE and CLAUDE with 20260817 changes
Bring both docs in line with the five commits pulled from Gitea. - BDF: pcimem V1.5.0 auto-detects the CB FPGA BDF, so the "edit the four lines per DUT" guidance was inverted. Documented the detection order and fpga_rescan, and flagged that utils/show_pcie_error_reg_*.ttl still hard-codes its 7 BDFs -- the footgun is only half gone - Traffic: documented blanton_traffic_linespeed.sh (bcmcmd SWB loopback, per-pair TX/RX cross-check) and tools/bcm_mibpair_report + the three loopback command tables; noted the route taken differs from the SONiC-CLI approach Phase 4 originally planned - Stress: stress_hhmd and stress_pcie were removed on 08-17, so the job count is 8 not 10; soak loop now pulls full setup_pmon (9 items) - Constraints: added the bcmcmd exit-0 and stdin-eating gotchas - Phases: ticked 10 completed items, corrected Phase 3/4 acceptance criteria, and moved BDF auto-detect out of Future Extensions Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014RetWKFZFG1ZHcitQAyhwM
This commit is contained in:
Claude Opus 5
@@ -17,6 +17,8 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
|
||||
- **I2C/PMBus**：CB FPGA F3 I2C master（Ch0~Ch17，base 0x300 stride 0x20）、
|
||||
CB F3 VI2C proxy → ICB/PDB（Ch0~Ch4，base 0x780）、CPU 原生 bus（`i2cset`/`i2cget`）
|
||||
- **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 雙向交叉比對
|
||||
- **判定資料源**：PCIe AER sysfs（`aer_dev_*`）、EDAC sysfs（`dimm_{ce,ue}_count`）、SONiC `show platform *`
|
||||
- **無編譯步驟**：TTL 與 bash 都直譯執行
|
||||
|
||||
@@ -26,17 +28,19 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
|
||||
# ── 部署 bash 工具庫到 DUT ──────────────────────────
|
||||
scp -r src/Script_ABC_Blanton/Blanton_Script admin@<DUT_IP>:~/
|
||||
|
||||
# ── DUT 上先確認 FPGA BDF（每台不同！）───────────────
|
||||
lspci -Dnn | grep -i fpga
|
||||
ls -d /sys/bus/pci/devices/0000:*:00.3
|
||||
|
||||
# ── DUT 上載入工具（Script A 也是做這五件事）─────────
|
||||
source ~/Blanton_Script/blanton_fpga_pcimem.sh
|
||||
# ── DUT 上載入工具（Script A 也是做這六件事）─────────
|
||||
source ~/Blanton_Script/blanton_fpga_pcimem.sh # ← 會自己印出偵測到的 CB FPGA BDF
|
||||
source ~/Blanton_Script/blanton_cb_i2c.sh
|
||||
source ~/Blanton_Script/blanton_icb_vi2c.sh
|
||||
source ~/Blanton_Script/blanton_pwr_data.sh
|
||||
source ~/Blanton_Script/blanton_traffic_linespeed.sh
|
||||
source ~/Blanton_Script/LTC2980_Margin_Script/margin.sh
|
||||
|
||||
# ── FPGA BDF：自動偵測，不用改檔；必要時手動釘 ───────
|
||||
fpga_rescan # 換 DUT / 重新列舉後重測
|
||||
FPGA_BDF=0000:05:00 fpga_rescan # 偵測到多顆或選錯時，指定 domain:bus:dev（不含 .fn）
|
||||
echo $FPGA_BDF_ACTIVE # 目前生效的 BDF
|
||||
|
||||
# ── 煙霧測試 ────────────────────────────────────────
|
||||
cb_fpga 0 0xD90 # RST_CAUSE_REG，讀得到 = BAR 通了
|
||||
cb_i2c_init 11 && cb_i2c_scan 11 # Ch11 風扇控制器，應看到 0x20
|
||||
@@ -45,9 +49,23 @@ temp_all # CB + ICB 溫感
|
||||
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
|
||||
blanton_traffic_linespeed report -f <log> # 離線重解一份存下來的 console log
|
||||
|
||||
# 離線版報表（開發機上跑，選項更多）
|
||||
python3 tools/bcm_mibpair_report_V1.1.0.py <drivshell.log> -a
|
||||
|
||||
# ── 各工具的 help ───────────────────────────────────
|
||||
blanton_fpga_help ; blanton_cb_i2c_help ; vi2c_help
|
||||
temp_sensor_help ; pwr_data_help
|
||||
temp_sensor_help ; pwr_data_help ; blanton_traffic_linespeed_help
|
||||
```
|
||||
|
||||
**Host 端跑一輪測試：**
|
||||
@@ -69,8 +87,11 @@ Tera Term 連 COM port (115200-8-N-1)
|
||||
- **新增取數項目** = 新增一支 `utils/show_xxx.ttl`，再在主腳本 `include`，不要往主腳本塞指令
|
||||
- **bash 命名**：公開函數 `cb_i2c_* / vi2c_* / temp_* / pwr_* / margin_*`，內部 helper 一律底線開頭
|
||||
（`_cbi2c_* / _vr / _ts_* / _pwr_*`）
|
||||
- **版本紀錄**：每支 `.ttl` 與 `.sh` 檔頭都有 `Version History` 區塊，改動時**在檔頭補一行**
|
||||
（`V1.0.2 YYYY-MM-DD <做了什麼>`），不要只改版號
|
||||
- **版本紀錄**：`.sh` 每支檔頭都有 `Version History` 區塊，改動時**在檔頭補一行**
|
||||
（`V1.0.2 YYYY-MM-DD <做了什麼>`），不要只改版號。
|
||||
TTL 這邊 **2026-08-17 起改為集中制**：`1_Blanton_Script_A.ttl` 的 History 記錄 A/B/C 三支的
|
||||
所有變更，B 與 C 的檔頭版本區塊已移除。⚠️ 這是待確認的慣例變更 ——
|
||||
若要回到「每支各自記錄」，B/C 的 History 需要補回去
|
||||
- **Commit**：Conventional Commits，**英文**。scope 用 `ttl` / `fpga` / `i2c` / `vi2c` /
|
||||
`margin` / `pwr` / `temp` / `docs`
|
||||
- **Status 表**：`docs/TTL_Script_Blanton_Status_*.xlsx` 是逐項進度的正本（OK / On-Going + Owner），
|
||||
@@ -81,9 +102,12 @@ Tera Term 連 COM port (115200-8-N-1)
|
||||
- 🔒 **NDA：本 repo 只推 `nas` + `gitea`，絕不推 GitHub。** `docs/` 內含客戶 FPGA 規格。
|
||||
- 🔒 **DUT 帳密不進 git**。`1_Blanton_Script_A.ttl` 的 `sendln "YourPaSsWoRd"` 是 placeholder，
|
||||
實際值放 `secret/config_secret.ttl`（gitignored）。**任何 commit 前先 grep 一次確認沒帶到真密碼。**
|
||||
- ⚠️ **PCIe BDF 是 per-unit 的**。`blanton_fpga_pcimem.sh` 的 `FUNCT0..3_RES` 已經改過三次
|
||||
（04:00.x → 03:00.x → 05:00.x → 03:00.x）。換 DUT 一定先 `lspci -Dnn | grep -i fpga`，
|
||||
`utils/show_pcie_error_reg_*.ttl` 內的 BDF 也要一起校。
|
||||
- ⚠️ **PCIe BDF 是 per-unit 的 —— bash 端已自動化，TTL 端還沒**。
|
||||
`blanton_fpga_pcimem.sh` V1.5.0（2026-08-17）起 source 時自動偵測（sysfs vendor `0x1590` →
|
||||
`lspci` → `FPGA_BDF_FALLBACK`），**不用再每台改檔**；印一行 `[INFO] CB FPGA BDF = ...`，
|
||||
可用 `fpga_rescan` 重測、`FPGA_BDF=... fpga_rescan` 手動釘住。
|
||||
**但 `utils/show_pcie_error_reg_*.ttl` 裡的 7 組 BDF 仍是寫死的**，換 DUT 還是要人工校對 ——
|
||||
不校就會讀到別的裝置，或整段 `No such file or directory`。
|
||||
- ⚠️ **AER 判定看差值不看絕對值**：Script A 抓基線、Script C 抓結果，相減才是本輪錯誤。
|
||||
**Endpoint 與上游 Root Port 兩邊都要讀**，錯誤可能只記在 RP。
|
||||
- ⚠️ **ICB/PDB 一律走 VI2C（`blanton_icb_vi2c.sh`），不要走 VSPI**：VSPI ~18 ms/reg 會讓 I2C
|
||||
@@ -99,12 +123,24 @@ Tera Term 連 COM port (115200-8-N-1)
|
||||
shell；log 也只有 A 會 `logopen`，B/C 是續寫。中途關掉 window 就得手動收程序、log 也斷了。
|
||||
- ⚠️ **MP29816 的 Vout 解析度不是固定值**，由 `MFR_VOUT_SCALE_LOOP(0x29)` bit[12:10] 決定，
|
||||
`blanton_pwr_data.sh` 執行期從晶片讀；xlsx 上寫的 `/5mV` 與 MP2985B 的 `+49` offset **都是錯的**。
|
||||
- ⚠️ **`bcmcmd` 就算失敗也 exit 0**（`VLAN: ERROR: Entry exists` /
|
||||
`Failed to execute the diagnostic command` 都照樣回 0），所以 `blanton_traffic_linespeed.sh`
|
||||
是**比對輸出**而非看 exit code。另外 `bcmcmd` 一律要 `</dev/null` ——
|
||||
否則它會吃掉 while 迴圈的 stdin，**只有第一個 VLAN 被設定**（V0.3.1 修過的 bug，很難看出來）。
|
||||
- ⚠️ **`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 分鐘（取決於指令執行時間）。
|
||||
改之前先確認現場期待的是哪一種。
|
||||
|
||||
## 資料夾說明
|
||||
|
||||
- `src/Script_ABC_Blanton/` — 可執行內容（Tera Term 工作目錄；內含要 scp 到 DUT 的 `Blanton_Script/`）
|
||||
- `docs/` — 客戶 FPGA 規格、AER/EDAC 檢查依據、逐項 Status 表
|
||||
- `tools/` — Host 端輔助腳本（log 解析、報表產生、打包）
|
||||
- `docs/` — 客戶 FPGA 規格、AER/EDAC 檢查依據、逐項 Status 表（最新為 `*_20260817.xlsx`）
|
||||
- `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<ver>_<date>/` + zip）
|
||||
- `secret/` — 🚫 gitignored（除 `README.md` 與 `*.example`）：DUT 帳密、per-unit BDF 覆寫、COM 設定
|
||||
- `For_AI/` — 🚫 gitignored：AI 協作素材（波形截圖、草稿筆記）
|
||||
|
||||
Reference in New Issue
Block a user