# Blanton Script User Guide

> 適用版本：Script A **V1.2.7**（2026-11）
> 對象：上機跑 A → B → C 的測試員，以及要在 DUT 上手動下 `Blanton_Script/` 工具的人

本指南分兩部分：

1. [TTL Script A / B / C](#part-1--ttl-script-a--b--c)：Host 端準備、把 `Blanton_Script/` 從 USB 放進 DUT、A → B → C 的跑法
2. [Blanton_Script 工具說明](#part-2--blanton_script-工具說明)：DUT 上每一支 `.sh` 的用法

---

## 目錄

- [Part 1 — TTL Script A / B / C](#part-1--ttl-script-a--b--c)
  - [1.1 交付包內容](#11-交付包內容)
  - [1.2 Host 端準備（Windows）](#12-host-端準備windows)
  - [1.3 把 Blanton_Script 從 USB 放到 DUT](#13-把-blanton_script-從-usb-放到-dut)
  - [1.4 config.ttl 設定](#14-configttl-設定)
  - [1.5 跑一輪測試：A → B → C](#15-跑一輪測試a--b--c)
  - [1.6 Script A 做了什麼](#16-script-a-做了什麼)
  - [1.7 Script B 做了什麼](#17-script-b-做了什麼)
  - [1.8 Script C 做了什麼](#18-script-c-做了什麼)
  - [1.9 Log 在哪裡](#19-log-在哪裡)
  - [1.10 常見問題](#110-常見問題)
- [Part 2 — Blanton_Script 工具說明](#part-2--blanton_script-工具說明)
  - [2.0 通用規則](#20-通用規則)
  - [2.1 總覽表](#21-總覽表)
  - [2.2 平台存取底層（source 進來用）](#22-平台存取底層source-進來用)
  - [2.3 溫度 / 電壓 / 電流 / 功耗](#23-溫度--電壓--電流--功耗)
  - [2.4 電壓 Margin（含 LTC2980 Margin Script 完整說明）](#24-電壓-margin)
  - [2.5 交換晶片：流量 / BER / FDR / 負載](#25-交換晶片流量--ber--fdr--負載)
  - [2.6 SerDes DSC 擷取](#26-serdes-dsc-擷取)
  - [2.7 背景監控（start / stop 型）](#27-背景監控start--stop-型)
  - [2.8 其他](#28-其他)

---

# Part 1 — TTL Script A / B / C

## 1.1 交付包內容

```
Script_ABC_Blanton_<Ver>/            ← Tera Term 的工作目錄（整包放在 Windows 上）
├── 1_Blanton_Script_A.ttl           ← 基線（開頭收殘留 → 取基線數據 → 第一輪流量 / BER）
├── 2_Blanton_Script_B.ttl           ← 壓力 soak（背景壓力 + while 1 每 60 秒取一次數據）
├── 3_Blanton_Script_C.ttl           ← 收工（停壓力 → 收尾數據 → 判定 → log 拷 USB）
├── config.ttl                       ← 所有設定都在這裡
├── utils/*.ttl                      ← A/B/C 共用的片段（PMON、dmesg、PCIe 錯誤…）
├── logs/                            ← Tera Term log 寫在這
├── 4_*.ttl / 5_*.ttl / 6_*.ttl      ← 其他獨立測試（熱 / 開機循環 / BER 循環），不接 A→B→C
└── Blanton_Script/                  ← ★ 要放到 DUT 的 ~/Blanton_Script/
```

| 腳本 | 用途 | 跟 A→B→C 的關係 |
|---|---|---|
| `1_Blanton_Script_A.ttl` | 基線 | 第一支，**唯一會開 log** 的 |
| `2_Blanton_Script_B.ttl` | 壓力 soak | A 之後，同一個 Tera Term 視窗 |
| `3_Blanton_Script_C.ttl` | 收工 + 判定 | B 停掉之後，同一個視窗 |
| `4_Blanton_Script_thermal_safety.ttl` | 熱 / 安規 | 獨立跑，**沒有收尾段** |
| `4_1_Blanton_Script_thermal.ttl` | 熱測：先 idle 300 輪，再 `blanton_tr518_thermal.sh` 滿載 | 獨立跑，**沒有收尾段**（結束要手動 `blanton_tr518_thermal.sh stop` + `systemctl stop mlucas-amm`） |
| `5_Blanton_Script_Boot_Cycle.ttl` | 斷電開機循環 | 獨立跑，`while 1` 無止境 |
| `5_1_Blanton_Script_Boot_Cycle_Fast.ttl` | 同上，拿掉流量只留 `ps` | 獨立跑 |
| `6_Blanton_Script_BER_Cycle.ttl` | Diag ↔ SONiC 冷開機量 BER | 獨立跑 |

## 1.2 Host 端準備（Windows）

1. 把整個 `Script_ABC_Blanton_<Ver>/` 複製到 Windows（例如 `D:\Blanton\`）。
2. **改密碼**：`1_Blanton_Script_A.ttl` 的登入段是
   ```
   sendln "admin"
   wait "Password:"
   sendln "YourPaSsWoRd"      ← 換成 DUT 實際的 admin 密碼
   ```
   `YourPaSsWoRd` 是佔位字，不改 A 會卡在登入。（B / C 不登入，沿用 A 的 session。）
3. 確認 `config.ttl` 的 prompt 跟 DUT hostname 一致（見 [1.4](#14-configttl-設定)）。
4. Tera Term 連 DUT 的 COM port：**115200-8-N-1**。
5. （建議）Tera Term → Setup → Additional settings → Log，確認時戳格式；格式存在**這台電腦的 `TERATERM.INI`**，不在腳本裡。

## 1.3 把 Blanton_Script 從 USB 放到 DUT

TTL 會直接呼叫 `~/Blanton_Script/xxx.sh`（root 的家目錄 = `/root`），所以 **跑 Script A 之前**，DUT 上要先有 `/root/Blanton_Script/`。

### Step 1：Windows 端把資料夾放進 USB

把交付包裡的 `Blanton_Script/` 整個資料夾拷到 USB 隨身碟**根目錄**：

```
USB:\
└── Blanton_Script\
    ├── blanton_ber.sh
    ├── ...
    └── LTC2980_Margin_Script\
```

> ⚠️ **不要在 Windows 上用記事本打開再存 `.sh` / `.conf`**。存檔可能變成 CRLF 換行，
> 在 SONiC 上會直接掛（`$'\r': command not found`），`.conf` 被 source 時更會安靜地讀錯值。

### Step 2：DUT 端掛 USB

```bash
# 登入並切 root
admin / <密碼>
sudo -i

# 找 USB 的 partition（通常是 /dev/sda1；看 TRAN 欄 = usb 的那顆）
lsblk -o NAME,SIZE,TRAN,FSTYPE,MOUNTPOINT

# 掛載（已掛過可跳過）
mkdir -p /mnt/usb
mount /dev/sda1 /mnt/usb          # ← 依 lsblk 結果改 sda1
ls /mnt/usb                       # 應看到 Blanton_Script
```

### Step 3：複製到家目錄

```bash
# 已經有舊版的話先備份（可略過）
[ -d ~/Blanton_Script ] && mv ~/Blanton_Script ~/Blanton_Script.bak_$(date +%Y%m%d-%H%M%S)

cp -r /mnt/usb/Blanton_Script ~/
```

### Step 4：加執行權限 + 檢查換行（**每次佈署都要做**）

```bash
find ~/Blanton_Script -name '*.sh' -exec chmod +x {} +
grep -rlU $'\r' ~/Blanton_Script          # ← 應該「沒有任何輸出」
```

- **為什麼一定要 `chmod +x`**：從 Windows → USB 拷過來的檔案沒有執行權限。
  `mgmt_ping_monitor.sh` / `bmc_monitor.sh` / `nfc_polling.sh` 的 `start` 內部是直接執行自己的路徑，
  沒有 exec bit 會 Permission denied，**而且不會報錯**，只會得到一份空的 log。
  `unused_lanes.sh` 也會檢查 `retimer_lanes.sh` 有沒有 exec bit。
- **`grep` 有輸出 = 有檔案是 CRLF**，修法：
  ```bash
  grep -rlU $'\r' ~/Blanton_Script | xargs sed -i 's/\r$//'
  ```

### Step 5：確認 + 卸載

```bash
ls ~/Blanton_Script
bash ~/Blanton_Script/usb_target.sh -n -o both     # 確認 USB 偵測得到（Script B/C 會用）
sync
umount /mnt/usb
```

> **USB 不要拔**：Script B 會對它跑 USB 讀寫壓力，Script C 最後會把 log 拷進去。
> 測試期間 DUT 上只能插**一支** USB 隨身碟（偵測到多支時 `usb_target.sh` 會拒絕猜測，exit 2）。

### 另一個方法：base64 貼上

沒有 USB 時，可以把 `Blanton_Script/` 打成 `tar.gz` 再轉 base64，在 Tera Term 分段貼上、
DUT 端解碼解壓。每段後面附 md5，對不上就重貼該段。（貼上檔請向開發端索取。）

## 1.4 config.ttl 設定

| 變數 | 預設 | 說明 |
|---|---|---|
| `project_name` | `"Blanton"` | log 檔名前綴 |
| `strTestcase` | `"ENV"` | log 檔名的測試類別（ENV / EMC / Margin…） |
| `EN_Margin` | `0` | 1 = A / C 會跑 `margin_status`（9 顆 LTC2980 的電壓狀態） |
| `EN_TX_FIR` | `0` | 1 = A / C 各跑一次 `bcm_dsc_scan.sh`（每次約 10 分鐘，整輪多 ~20 分鐘） |
| `EN_log` | `1` | 1 = Script A 開 log |
| `EN_timestamp` | `1` | 1 = log 每行帶時戳（**必要變數，不可刪**） |
| `FAN_SPEED` | `100` | 風扇轉速 %，soak 是熱測試，預設全速 |
| `SWB_UNIT0` / `SWB_UNIT1` | `1` / `1` | 這台 DUT 有沒有 switch unit 0 / 1。**FDR 只在兩個都是 1 時才跑** |
| `SSD_RUNTIME` / `SSD_COUNT` | `3600` / `240` | SSD 壓力：`--runtime` 是**整個 job 的總時限（秒）**，`COUNT` = `--passes` |
| `USB_RUNTIME` / `USB_COUNT` | `3600` / `240` | USB 壓力，同上 |
| `BMC_USB_RUNTIME` | `172800` | BMC USB 網路 ping 的總秒數（2 天）**必要變數** |
| `prompt_login` | `"sonic login:"` | 登入提示 |
| `prompt_sonic` | `"admin@sonic:~$"` | admin prompt |
| `prompt_sonic_root` | `"root@sonic:~#"` | root prompt，**每個 `wait` 都靠它** |

> ⚠️ **hostname 不是 `sonic` 的 DUT**（例如 `root@Margin02:~#`），要把三個 prompt 改成對應的字串，
> 否則 macro 會卡在第一個 `wait`。
>
> ⚠️ **`config.ttl` 少一個變數，macro 會當場中止**（不是當成 0）。換新版 TTL 時，`config.ttl` 一起換，
> 再把自己的設定值填回去。
>
> ⚠️ **SSD / USB 壓力的時間**：`--runtime` 跑滿就停，`--passes` 不會把它延長。
> 2 天 soak 要把 `SSD_RUNTIME` / `USB_RUNTIME` 改成 `172800`。壓力提早結束時唯一線索是
> Script B 每輪印的 `bgctl list` 數量變少，**不會報警**。

## 1.5 跑一輪測試：A → B → C

```
Tera Term 連 COM port (115200-8-N-1)，DUT 停在 "sonic login:" 或正在開機
  │
  ├─ Control → Macro → 1_Blanton_Script_A.ttl
  │     自動登入 → 基線 → 跳出 messagebox「Script A DONE / Start Script B」
  │
  ├─ Control → Macro → 2_Blanton_Script_B.ttl
  │     起背景壓力 → while 1 每 ~60 秒取一次數據（不會自己停）
  │     泡到時間後：在 Tera Term 的 MACRO 小視窗按 End 停掉 macro，不要關 Tera Term 主視窗
  │
  └─ Control → Macro → 3_Blanton_Script_C.ttl
        停壓力 → 收尾數據 → 流量報表 / BER → log 拷 USB →「GOOD JOB! Test Case DONE」
```

**鐵則：**

- **A → B → C 必須在同一個 Tera Term 視窗、同一個 shell session。** B 的背景 job 跟 C 的 `kill $(jobs -p)`
  綁在同一個 shell；log 也只有 A 會開，B / C 是續寫。中途關掉視窗就得手動收程序，log 也斷了。
- B 停掉時，DUT 可能停在某個指令中間。**等 prompt 回來再跑 C**（必要時按一下 Enter）。
- DUT 上要有 `~/hammer/tools/amd/mlucas-avx2`（CPU 壓力，由 DUT image 帶，不在交付包裡）。

## 1.6 Script A 做了什麼

依序：

| # | 段落 | 主要指令 |
|---|---|---|
| 1 | 開 log、登入、切 root | `logopen`、`sudo -i` |
| 2 | 前置 | `mkdir ./logs`、`date -s`（用 Host 時間對時）、`rm /host/hw-eval/jobs/*` |
| 3 | 收前一輪殘留 | `hw-test-session finish` → `bgctl reset --yes` → `bgctl stop --all` → `bgctl list` → `hw-test-session start` |
| 4 | 風扇 | max31790 driver rebind → `fan-speed-control.sh <FAN_SPEED>` → 回答 `y` |
| 5 | 等 DUT 初始化 | `utils/wait_init.ttl`：每 60 秒 `bcmcmd ps` 數 up port，每個開啟的 unit ≥ 216 才往下 |
| 6 | DUT 資訊 | `show boot / version / system-memory / service / platform syseeprom / ssdhealth`、`fwutil show status`、TPM 版本、NVMe SMART |
| 7 | BMC | `bmc-first-enroll`、`bmc-manager version / status` |
| 8 | 載入工具 | `source` 6 支：`blanton_fpga_pcimem` / `cb_i2c` / `icb_vi2c` / `pwr_data` / `traffic_linespeed` / `margin.sh` |
| 9 | PCIe AER 基線 | `utils/show_pcie_error_reg_*.ttl`（TH6×2 / FPGA / BMC / DDR / I210 / SSD）、`ras-mc-ctl --summary` |
| 10 | PCIe tree | `lspci -tvvv`、`lspci -vv` |
| 11 | Margin（`EN_Margin=1`） | `utils/show_margin_status.ttl` |
| 12 | PMON 快照 | `utils/setup_pmon.ttl`（溫度 / 風扇 / 電壓 / 電流 / SWB 功耗 / DDR5 / HSC / SSD / leak / TPM）+ `utils/show_dmesg.ttl`（**最後會 `dmesg -C`**） |
| 13 | Tray ID I2C stress | `tray_id_stress.sh` |
| 14 | 管理網路 ping | `mgmt_ping_monitor.sh start` → `sleep 15` → `stop` → `cat log` → `clear` |
| 15 | NFC | `nfc_polling.sh start` → `sleep 30` → `stop` → `report` |
| 16 | 100G port | `sfputil lpmode off`、`config interface startup Ethernet513/514` |
| 17 | 關沒接線的 lane | `unused_lanes.sh off`（**之後沒有任何地方 `on` 回來**） |
| 18 | BER 基線 | `blanton_ber.sh init → start → sleep 30 → report → stop → clear` |
| 19 | 第一輪流量 + FDR | `blanton_traffic_linespeed ps → init` → `fdr start` → `clear` → `fdr clear` → `show` → `start` → `sleep 40` → `fdr rdcnt` → `stop` → `fdr stop` → `report` |
| 20 | DSC（`EN_TX_FIR=1`） | `bcm_dsc_scan.sh -f blanton_dsc_ScriptA.log -F` |
| 21 | 結束 | `show uptime` → messagebox |

> 單一 unit 的 DUT（`SWB_UNIT0` / `SWB_UNIT1` 只有一個是 1）會走 `-u 0` / `-u 1` 分支，**沒有 FDR**，流量只跑 15 秒。

## 1.7 Script B 做了什麼

**起壓力（一次）**

| 壓力 | 指令 |
|---|---|
| AMD CPU | `systemd-run --unit=mlucas-amm ... mlucas-avx2`（`Restart=always`，掉了會自己重起） |
| BMC DDR | `bgctl run bmc-manager run '/usr/bin/memtester 64M'` |
| BMC I2C 監控 | `bmc_monitor.sh start` |
| Host DDR | `bgctl run /usr/sbin/memtester 1G` |
| SSD | `bgctl run qfx5252-stress-ssd 1G --runtime <SSD_RUNTIME> --passes <SSD_COUNT> ...` |
| USB | `bgctl run qfx5252-stress-usb <usb_dev> 256M --runtime <USB_RUNTIME> --passes <USB_COUNT> ...` |
| BMC USB 網路 | `systemd-run --unit=qfx5252-bmc-usb-net-test ... ping -I <cdc_ncm 網卡> 192.168.200.200` |
| 管理網路 | `mgmt_ping_monitor.sh start` |
| NFC | `nfc_polling.sh start` |
| SWB 流量 | `blanton_traffic_linespeed init / clear / start` + `blanton_fdr.sh start / clear` |

> 找不到 cdc_ncm 網卡時會跳 messagebox「cdc_ncm interface not found. Ping test skipped.」，按 OK 後繼續跑，只是少了 BMC USB 網路測試。

**Soak 迴圈（`while 1`，每輪）**

`setup_pmon.ttl` 快照 → `bgctl list` → `jobs` → `systemctl is-active mlucas-amm` → `tray_id_stress.sh` → `blanton_fdr.sh rdcnt` → `sleep 60`

> 每輪間隔 = 指令執行時間 + 60 秒，不是固定 1 分鐘。
> 看 `bgctl list` 的 job 數有沒有變少，是判斷壓力有沒有提早結束的唯一方法。

## 1.8 Script C 做了什麼

| # | 段落 | 主要指令 |
|---|---|---|
| 1 | 停壓力 | `kill $(jobs -p)`、`systemctl stop mlucas-amm`、`bgctl stop --all`×2、`systemctl stop qfx5252-bmc-usb-net-test`、`mgmt_ping_monitor.sh stop`、`nfc_polling.sh stop` |
| 2 | 收尾快照 | `setup_pmon.ttl`、`show_dmesg.ttl` |
| 3 | PCIe AER / EDAC | 同 Script A 的 7 組 + `ras-mc-ctl --summary` → **跟 A 相減才是本輪錯誤** |
| 4 | BMC | `bmc_monitor.sh stop`；`journalctl -u qfx5252-bmc-usb-net-test > ~/Blanton_Script/log/bmc_usb_net.log` |
| 5 | 壓力結果 | `cat` SSD / USB stress log、`mgmt_ping.log`、`nfc_polling.sh report` |
| 6 | 流量判定 | `blanton_fdr.sh rdcnt` → `blanton_traffic_linespeed stop` → `fdr stop` → `report` |
| 7 | BER 收尾 | `blanton_ber.sh init → start → sleep 30 → report → stop → clear` |
| 8 | DSC（`EN_TX_FIR=1`） | `bcm_dsc_scan.sh -f blanton_dsc_ScriptC.log -F` |
| 9 | NVMe / 開機原因 | `nvme smart-log`、`smartctl -x`、`show reboot-cause` |
| 10 | Margin（`EN_Margin=1`） | `show_margin_status.ttl` |
| 11 | Log 拷 USB | 掛 USB 到 `/mnt/usb` → 把 mlucas / bmc_usb_net / bmc_poll / mgmt_ping / nfc_poll log 拷進 `/host/hw-eval/jobs/` → `cp -r /host/hw-eval/jobs/ /mnt/usb/jobs-<YYYYMMDD>_<HHMM>` |
| 12 | 收工 | `exit` → 等 `Script done` → `hw-test-session finish` → `bgctl reset --yes` → messagebox |

## 1.9 Log 在哪裡

| Log | 位置 | 誰寫的 |
|---|---|---|
| **主 log（A+B+C 全部 console）** | Windows：`<Tera Term 工作目錄>\Logs\Blanton_<strTestcase>_<YYYYMMDD-HHMMSS>.log` | Script A `logopen` |
| 壓力 job log | DUT：`/host/hw-eval/jobs/` | `qfx5252-stress-*`、Script C 拷進來的 |
| 工具 log | DUT：`~/Blanton_Script/log/`（`mgmt_ping.log` / `nfc_poll.log` / `bmc_poll.log` / `bmc_usb_net.log` / `blanton_dsc_*.log`） | 各 `.sh` |
| **USB 備份** | USB：`/jobs-<YYYYMMDD>_<HHMM>/` | Script C 最後一步 |

> ⚠️ `bmc_usb_net.log` **不進主 log**，USB 上那份是唯一一份。
> ⚠️ `show_dmesg.ttl` 會 `dmesg -C`，事後在 DUT 上 `dmesg` 撈不到舊訊息，只存在主 log 裡。

## 1.10 常見問題

| 症狀 | 原因 / 處理 |
|---|---|
| A 一開始就停在 `logopen` | `config.ttl` 是舊版，少了 `EN_timestamp` 之類的必要變數 → 換新版 `config.ttl` |
| A 卡在登入 | 密碼還是 `YourPaSsWoRd`，或 prompt 跟 hostname 不符 |
| A 卡在風扇那段 | 在等 `Set all configured fan channels to` 提示再回 `y`；提示字串改了就會永遠卡住 |
| A 卡在 wait_init | 有 unit 的 up port 一直 < 216，或 `SWB_UNITx=1` 但 DUT 沒那張板子 |
| `xxx.sh: Permission denied` | 沒做 [1.3 Step 4](#step-4加執行權限--檢查換行每次佈署都要做) 的 `chmod +x` |
| `$'\r': command not found` | `.sh` 變成 CRLF → `sed -i 's/\r$//'` |
| mgmt_ping / nfc / bmc log 是空的 | 沒 `chmod +x`（`start` 不會報錯） |
| Script C 沒把 log 拷到 USB | USB 沒插、插了兩支、或檔案系統不能寫 → `bash ~/Blanton_Script/usb_target.sh -o both` 看錯誤碼 |
| 跑完 C 之後 CPU 還是滿載 | `systemctl stop mlucas-amm` 沒跑到 → 手動下一次 |

---

# Part 2 — Blanton_Script 工具說明

## 2.0 通用規則

- 一律在 **root** 下跑：`sudo -i`，工具在 `~/Blanton_Script/`。
- 兩種用法：
  - **直接執行**：`~/Blanton_Script/xxx.sh <子指令> [選項]`（需要 exec bit）
  - **source 後呼叫函式**：`source ~/Blanton_Script/xxx.sh` 再下 `xxx <子指令>`（A/B/C 對 `blanton_traffic_linespeed` 就是這樣用）
- 大部分工具都支援：`-u 0|1`（只做一個 switch unit，預設兩個都做）、`-n`（dry-run，只印指令不碰硬體）、`-d`（印每一個底層指令）、`-h`（help）。
- **`bcmcmd` 的 exit code 不能信**：BCM shell 拒絕指令時照樣回 0，看輸出內容判斷。
- **互斥**：下面這幾支都會接管同一批 switch port，**一次只能跑一支**：
  `blanton_traffic_linespeed` / `blanton_ber` / `blanton_ber_debug` / `blanton_tr518` / `blanton_tr518_thermal` / `port_prbs_monitor` / `bcm_100g_dsc_cycle`
- **會寫 NVM（永久）的指令**：`margin_save*`、`blanton_multiphase_margin.sh save` —— **測試流程中絕不執行**。

## 2.1 總覽表

| 工具 | 類別 | TTL 有沒有接 | 一句話 |
|---|---|---|---|
| `blanton_fpga_pcimem.sh` | 底層 | A（source） | CB / PMC / ICB FPGA 暫存器讀寫，自動偵測 BDF |
| `blanton_cb_i2c.sh` | 底層 | A（source） | CB FPGA 的 I2C master（Ch0~Ch17） |
| `blanton_icb_vi2c.sh` | 底層 | A（source） | 經 CB 的 VI2C 走到 ICB / PDB（Ch0~Ch4） |
| `blanton_temp_sensor.sh` | 量測 | — | CB + ICB 溫感 |
| `ddr5_temp.sh` | 量測 | PMON | DDR5 DIMM 溫度 |
| `hsc_temp_readback.sh` | 量測 | PMON | LTC4287 HSC 溫度 |
| `TH6_SWB0/1_power_readback.sh` | 量測 | PMON | SWB 19 條軌 V×I + 總功耗（平台 sensor） |
| `blanton_multiphase_read.sh` | 量測 | — | 直接讀多相 VRM 的 V / I / T（含原始 hex） |
| `blanton_pwr_data.sh` | 量測 | A（source） | SWB VRM + PDB 讀值（經 CB FPGA I2C） |
| `pwr_brick.sh` | 量測 | — | PDB / CPB power brick |
| `avt_pmpower.sh` | 量測 | Script 4 / 4_1 | AMD CPU 封裝功耗（需 NDA 工具） |
| `LTC2980_Margin_Script/margin.sh` | Margin | A/C（`EN_Margin`） | 9 顆 LTC2980 電壓 margin |
| `blanton_multiphase_margin.sh` | Margin | — | 多相 VRM 38 條軌 margin |
| `blanton_traffic_linespeed.sh` | 交換晶片 | A/B/C | SWB loopback 線速流量 + 判定 |
| `blanton_fdr.sh` | 交換晶片 | A/B/C | FDR 統計（`phydiag fdrstat`） |
| `blanton_ber.sh` | 交換晶片 | A/C | 全機 SerDes BER（PRBS）+ 判定 |
| `blanton_ber_debug.sh` | 交換晶片 | — | BER 原始輸出（`p=p31`） |
| `blanton_tr518.sh` | 交換晶片 | Script 4 | `tr 518` 負載（量功耗用） |
| `blanton_tr518_thermal.sh` | 交換晶片 | Script 4_1 | `tr 518` 熱測參數版（**未上機驗證**） |
| `port_prbs_monitor.sh` | 交換晶片 | — | 100G Ethernet513/514 PRBS |
| `unused_lanes.sh` / `retimer_lanes.sh` | 交換晶片 | A（`off`） | 沒接線的 retimer lane / TH6 port 關 TX |
| `bcm_dsc_scan.sh` / `bcm_dsc_parse.sh` | DSC | A/C（`EN_TX_FIR`） | SerDes DSC 擷取 / 轉 CSV |
| `bcm_100g_dsc_cycle.sh` | DSC | — | 100G link down/up 循環 + DSC（**未上機驗證**） |
| `mgmt_ping_monitor.sh` | 背景監控 | A/B/C | 10G + 1G 管理網路 ping |
| `nfc_polling.sh` | 背景監控 | A/B/C | NFC tag 輪詢 |
| `bmc_monitor.sh` | 背景監控 | B/C | BMC `free -m` + I2C 寫讀圖樣 |
| `bmc_monitor_ddr.sh` | 背景監控 | 已停用 | BMC memtester（改走 `bgctl`） |
| `tray_id_stress.sh` | 其他 | A/B | Tray ID I2C 寫讀比對 |
| `usb_target.sh` | 其他 | B/C | 找 USB 隨身碟、掛載 |
| `blantons_nfc_validate.py` | 其他 | 由 nfc_polling 呼叫 | 客戶 NFC 驗證工具 v2.5 |

## 2.2 平台存取底層（source 進來用）

這三支是其他工具的基礎，平常不用直接下；debug 時 source 進來用。

```bash
source ~/Blanton_Script/blanton_fpga_pcimem.sh   # 會印 [INFO] CB FPGA BDF = ...
source ~/Blanton_Script/blanton_cb_i2c.sh
source ~/Blanton_Script/blanton_icb_vi2c.sh
```

### blanton_fpga_pcimem.sh

| 指令 | 說明 |
|---|---|
| `cb_fpga <offset> [value]` | 讀 / 寫 CB FPGA 暫存器（32-bit） |
| `pmc_fpga` / `icb_fpga` | 同上，其他 FPGA |
| `fpga_rescan` | 重新偵測 BDF（換 DUT / 重新列舉後） |
| `FPGA_BDF=0000:05:00 fpga_rescan` | 手動指定 BDF（偵測到多顆或選錯時） |
| `echo $FPGA_BDF_ACTIVE` | 目前用的 BDF |
| `blanton_fpga_help` | help |

```bash
cb_fpga 0 0xD90          # 讀 RST_CAUSE_REG，讀得到 = BAR 通了
```

### blanton_cb_i2c.sh

| 指令 | 說明 |
|---|---|
| `cb_i2c_init <ch>` | 初始化通道 |
| `cb_i2c_scan <ch>` | 掃描通道上的裝置 |
| `cb_i2c_read` / `cb_i2c_write` | 讀寫 |
| `cb_pmbus_read` / `cb_pmbus_write` | PMBus 讀寫 |
| `cb_i2c_muxsel` / `cb_i2c_reset` | 切 mux / 重置 |
| `blanton_cb_i2c_help` | help |

```bash
cb_i2c_init 11 && cb_i2c_scan 11     # Ch11 風扇控制器，應看到 0x20
```

### blanton_icb_vi2c.sh

ICB / PDB **一律走這支（VI2C）**，不要走 VSPI（太慢會踩 SMBus timeout）。

| 指令 | 說明 |
|---|---|
| `vi2c_scan_all` | 掃 ICB / PDB 五個通道 |
| `vi2c_scan <ch>` / `vi2c_init <ch>` | 單一通道 |
| `vi2c_read` / `vi2c_write` / `vi2c_pmbus_read` / `vi2c_dump` | 讀寫 |
| `vi2c_help` | help |

> `vi2c_scan` 只看 ACK，**仲裁失敗（ARB_LOST）會被誤報成有裝置**。

## 2.3 溫度 / 電壓 / 電流 / 功耗

### blanton_temp_sensor.sh — CB + ICB 溫感

```bash
~/Blanton_Script/blanton_temp_sensor.sh              # CB + ICB 一次
~/Blanton_Script/blanton_temp_sensor.sh -r           # 多印 TMP432 remote1/remote2
~/Blanton_Script/blanton_temp_sensor.sh -c           # 只 CB（-i 只 ICB）
~/Blanton_Script/blanton_temp_sensor.sh -n 10 -t 5   # 10 次、每次間隔 5 秒（-n 0 = 無限）
```

### ddr5_temp.sh — DDR5 DIMM 溫度

```bash
~/Blanton_Script/ddr5_temp.sh               # 預設 bus 5，位址 0x50 0x51
~/Blanton_Script/ddr5_temp.sh 5 0x50        # 指定 bus / 位址
```

### hsc_temp_readback.sh — HSC 溫度

```bash
~/Blanton_Script/hsc_temp_readback.sh       # LTC4287 HSC_MAIN(0x40) / HSC_STBY(0x45)，bus 28，約 4 秒
```

### TH6_SWB0_power_readback.sh / TH6_SWB1_power_readback.sh — SWB 軌功耗

```bash
~/Blanton_Script/TH6_SWB0_power_readback.sh
~/Blanton_Script/TH6_SWB1_power_readback.sh
```

- 讀 `show platform voltage` / `show platform current` 各一次，算 19 條軌的 V×I，最後印 `TOTAL POWER`。
- 某條軌在 sensor 表裡找不到時，stderr 印 `WARN` 並當 0 W 計。
- 要量**有負載**的功耗：先 `blanton_tr518.sh start`。

### blanton_multiphase_read.sh — 多相 VRM 讀值（含原始 hex）

```bash
~/Blanton_Script/blanton_multiphase_read.sh          # 兩片 SWB
~/Blanton_Script/blanton_multiphase_read.sh -u 0     # 只 SWB0
~/Blanton_Script/blanton_multiphase_read.sh -n       # 只印 i2c 指令
~/Blanton_Script/blanton_multiphase_read.sh -d       # 印每個 i2c 指令與讀到的值
```

- 直接 `i2cget` 讀 VRM（SWB0 = i2c-13/15，SWB1 = i2c-14/16），每顆一列：`VOUT / VOUT2 / IOUT / IOUT2 / POUT / POUT2 / TEMP`，
  電壓電流後面括號是讀到的 PMBus 原始 word，例如 `0.740(0x0128)`；最後印每片 SWB 的 Total Power。
- POUT = V × I。讀完會把 PAGE 讀回確認沒被別人切走，被切走就重讀，一直不穩印 `NA`。
- **不要跟 `blanton_multiphase_margin.sh` 同時跑**（兩支都會切 PAGE）。
- ⚠️ 0x21 / 0x22 的 PU 名稱（PU105 / PU102）與 `blanton_multiphase_margin.sh` 的 PHYTILE 對應相反，待上機確認；總功耗不受影響。

### blanton_pwr_data.sh — SWB VRM / PDB（經 CB FPGA I2C）

```bash
source ~/Blanton_Script/blanton_pwr_data.sh
pwr_data              # SWB0（預設）
pwr_data swb1         # SWB1
pwr_data pdb          # PDB power brick + EFUSE（ICB VI2C ch4，mux 0x72 ch0）
pwr_data all          # 三個都印
pwr_pdb_id            # 讀 PDB 上每顆裝置的 MFR_ID / MFR_MODEL
pwr_data_help
```

> 讀不到或數值不合理時印 `NA`——寧可 NA 也不印看起來像數據的錯值。

### pwr_brick.sh — PDB / CPB power brick

```bash
~/Blanton_Script/pwr_brick.sh show           # Vin / Iin / Vout / Iout / Temp × 5 顆
~/Blanton_Script/pwr_brick.sh show -r        # 多印 raw word
PB_TRIES=1 ~/Blanton_Script/pwr_brick.sh show -r    # 看不經重試的原始行為
```

### avt_pmpower.sh — AMD CPU 封裝功耗

```bash
~/Blanton_Script/avt_pmpower.sh -p ~/AVT_Linux_NDA_2.8.37/AVTCMD       # 印 PM table + 摘要
~/Blanton_Script/avt_pmpower.sh -q -p ~/AVT_Linux_NDA_2.8.37/AVTCMD    # 只印摘要
```

- **AVT 是 NDA 工具，不在交付包裡**：要先解壓到 `~/AVT_Linux_NDA_2.8.37/`，沒有就 exit 2。
- 數值是 SMU telemetry 不是量測，要準就對照 VR 的 PMBus READ_POUT。
- exit：0 OK / 1 參數錯 / 2 找不到 AVTCMD / 3 AVTCMD 失敗 / 4 解析不到功耗欄位。

## 2.4 電壓 Margin

> ⚠️ **改電壓會弄壞 DUT**：套 profile 前確認該軌 OV / UV limit。
> ⚠️ `margin.sh`（LTC2980）跟 `blanton_multiphase_margin.sh`（多相 VRM）**摸的是同一批軌**，兩支不要同時用。
> ⚠️ 會寫 NVM 的指令（`margin_save*`、`... save`）**測試中絕不執行**，斷電也不會還原。

### LTC2980_Margin_Script/margin.sh — 9 顆 LTC2980

用 PMBus 控制 LTC2980 的電壓 margin。**一個 `.conf` = 一顆 LTC2980**（= 2 顆 LTC2977，每顆 8 channel，合起來 CH0~CH15）。

```
~/Blanton_Script/LTC2980_Margin_Script/
├── margin.sh          ← 主程式（source 進來用）
├── settings/*.conf    ← 每顆 LTC2980 的 channel 定義（Vnom、Net 名稱、I2C 位址）
├── profiles/*.conf    ← 批次套用的 margin 組合
├── script/*.sh        ← 多顆一起跑（status / apply / save）
└── logs/              ← 操作 log（主 log + detail log）
```

#### 載入

```bash
cd ~/Blanton_Script/LTC2980_Margin_Script     # ← profile 路徑是相對於目前目錄，先 cd 進來
source margin.sh
margin_init Blanton_SWB0_CONN14              # 指定要操作哪一顆（支援 TAB 補全）
```

可以載入的 9 顆：

| `margin_init` 名稱 | 板 / 接頭 |
|---|---|
| `Blanton_CB_CONN13` | CB 板 CONN13 |
| `Blanton_SWB0_CONN13` ~ `Blanton_SWB0_CONN16` | SWB0 板 CONN13 ~ 16 |
| `Blanton_SWB1_CONN13` ~ `Blanton_SWB1_CONN16` | SWB1 板 CONN13 ~ 16 |

#### 函式一覽

| 函式 | 說明 |
|---|---|
| `margin_init <NAME>` | 載入 `settings/<NAME>.conf`，之後的指令都作用在這一顆 |
| `margin_status [ch]` | 讀 CH0~CH15（或指定 channel）的 Vout 與偏差 % |
| `margin_set <ch> <op> <change%>` | 三合一：寫 margin 值 + 切 operation + 讀回驗證 |
| `margin_set_value <ch> <vnom> <change%>` | 只寫 HIGH / LOW / OV / UV 暫存器 |
| `margin_operation <ch> <op>` | 只切 OPERATION（不改 margin 值） |
| `margin_apply_profile <file>` | 把一個 profile 套到目前載入的那顆 |
| `margin_save` | ⚠️ 寫 NVM：目前這顆（2 顆 LTC2977） |
| `margin_save all` | ⚠️ 寫 NVM：`settings/` 底下全部 9 顆，跑完切回原本那顆 |
| `margin_save blanton` | ⚠️ 寫 NVM：Blanton 專用，18 顆 LTC2977 走原生 i2c，不需 `margin_init` |
| `margin_debug [on\|off]` | 印出所有 i2c 指令（不帶參數 = 切換） |
| `margin_log [on\|off]` | 開關 log 記錄（預設開） |

`<op>` 對應的 OPERATION（PMBus 0x01）值：

| op | 值 | 說明 |
|---|---|---|
| `high` | 0xA8 | margin high |
| `low` | 0x98 | margin low |
| `nominal` | 0x80 | 回標稱值 |
| `off` | 0x00 | **關閉輸出** |

Channel 編號：`ch / 8` 決定是哪顆 LTC2977（0 = 低位址、1 = 高位址），`ch % 8` 是該顆的 page（0~7）。

#### 常用範例

```bash
margin_status                  # 全部 channel
margin_status 3                # 只看 ch3

margin_set 0 high 8            # ch0 margin high 8%
margin_set 5 low 5             # ch5 margin low 5%
margin_set 3 nominal 8         # ch3 回標稱值

margin_operation 0 high        # 只切 operation
margin_operation 0 nominal

margin_apply_profile profiles/combo_SWB_CONN13_high.conf   # 批次套用（要在 LTC2980_Margin_Script/ 底下）
margin_apply_profile profiles/combo_normal.conf            # 全部回 nominal

margin_init Blanton_SWB1_CONN16                            # 換一顆
margin_apply_profile profiles/combo_SWB_CONN16_high.conf
```

#### Profile 一覽

| Profile | 適用 | 說明 |
|---|---|---|
| `combo_SWB_CONN13_high` / `_low` | **只能套 SWB CONN13** | 每個 channel 依該板的軌給 3% 或 5% |
| `combo_SWB_CONN14_high` / `_low` | **只能套 SWB CONN14** | 同上 |
| `combo_SWB_CONN15_high` / `_low` | **只能套 SWB CONN15** | 同上 |
| `combo_SWB_CONN16_high` / `_low` | **只能套 SWB CONN16** | 同上 |
| `comboA_SWB_CONN13~16` / `comboB_SWB_CONN13~16` | **只能套對應 CONN** | 棋盤式：相鄰軌一高一低；A、B 互補，兩個都跑完每條軌兩個方向都測到 |
| `comboA_CB` / `comboB_CB` | **只能套 CB** | 同上，CB 版 |
| `combo_high3` / `combo_low3` | 通用 | 全部 channel ±3%（CB 用這組） |
| `combo_high5` / `combo_low5` | 通用 | 全部 channel ±5% |
| `combo_normal` | 通用 | 全部回 nominal |
| `all_off` | 通用 | ⚠️ 全部 OPERATION **off（關輸出）** |

- SWB0 與 SWB1 的同號 CONN 共用同一個 profile（兩片板子的軌相同，只差 I2C bus）。
- ⚠️ **per-CONN profile 套到別的 CONN 會 margin 到錯的軌，而且不會報錯。** 套之前確認 `margin_init` 載入的是哪一顆。
- 回到正常狀態用 `combo_normal`，**不是 `all_off`**。

#### 多顆一起跑（script/）

```bash
cd ~/Blanton_Script/LTC2980_Margin_Script
source script/margin_status_all.sh            # 9 顆依序 margin_init + margin_status
source script/margin_apply_profile_all.sh     # 每顆套各自的 profile（預設 SWB 用自己 CONN 的 _high，CB 用 combo_high3）
source script/margin_save_all.sh              # ⚠️ 只寫其中幾顆的 NVM（全部 9 顆請用 margin_save all）
```

- 要改範圍：編各支 script 開頭的 `BOARDS=( ... )` 陣列，註解掉不想跑的那行。
- `margin_apply_profile_all.sh` 另有 `PROFILES=( ... )` 陣列，`PROFILES[i]` 套在 `BOARDS[i]`，只寫名稱（不含路徑和 `.conf`），兩個陣列長度不同會直接報錯。
- 跑 LOW 那一輪：把 `PROFILES` 裡的 `_high` 全換成 `_low` 再跑一次。
- Script A / C 的 `EN_Margin=1` 走的就是 `margin_status_all.sh` + 逐顆 `margin_status`。

#### 寫 NVM（⚠️ 永久，測試流程中絕不執行）

`margin_save*` 會把目前的 margin / OV / UV 設定**永久寫進 NVM**，斷電不會還原，可能蓋掉客戶出廠設定。
真的要寫之前，先用 `margin_status_all.sh` 確認每個 channel 的狀態正確。

| 指令 | 寫哪些 | 備註 |
|---|---|---|
| `margin_save` | 目前載入的那顆（2 顆 LTC2977） | |
| `margin_save all` | `settings/` 全部 9 顆 | 中途失敗不會停，最後印成功 / 失敗總結 |
| `margin_save blanton` | 18 顆 LTC2977，走原生 i2c | 不需 `margin_init`、不動目前載入的那顆；2026-08-27 上機驗證 |

`margin_save blanton` 送出的就是這 18 行（PMBus `STORE_USER_ALL` = `0x15`，send-byte，不帶 data）：

```bash
i2cset -f -y 4  0x5C 0x15 ; i2cset -f -y 4  0x5E 0x15    # CB   CONN13
i2cset -f -y 15 0x5C 0x15 ; i2cset -f -y 15 0x5E 0x15    # SWB0 CONN13
i2cset -f -y 13 0x5C 0x15 ; i2cset -f -y 13 0x5E 0x15    # SWB0 CONN14
i2cset -f -y 15 0x62 0x15 ; i2cset -f -y 15 0x64 0x15    # SWB0 CONN15
i2cset -f -y 13 0x62 0x15 ; i2cset -f -y 13 0x64 0x15    # SWB0 CONN16
i2cset -f -y 16 0x5C 0x15 ; i2cset -f -y 16 0x5E 0x15    # SWB1 CONN13
i2cset -f -y 14 0x5C 0x15 ; i2cset -f -y 14 0x5E 0x15    # SWB1 CONN14
i2cset -f -y 16 0x62 0x15 ; i2cset -f -y 16 0x64 0x15    # SWB1 CONN15
i2cset -f -y 14 0x62 0x15 ; i2cset -f -y 14 0x64 0x15    # SWB1 CONN16
```

| Linux bus | CB FPGA F3 通道 | 板 / 接頭 |
|---|---|---|
| 4 | （CPU 原生） | CB CONN13 |
| 13 | Ch6 | SWB0 CONN14 / CONN16 |
| 15 | Ch8 | SWB0 CONN13 / CONN15 |
| 14 | Ch7 | SWB1 CONN14 / CONN16 |
| 16 | Ch9 | SWB1 CONN13 / CONN15 |

- **DUT 沒裝滿板子時**：把 `margin.sh` 開頭 `MARGIN_BLANTON_STORE` 陣列裡對應的行註解掉。
- 回報 `/dev/i2c-N` 不存在 = FPGA 的 i2c adapter 沒起來；回報 NACK = 板子 / 晶片的問題。
- 每顆之間預設等 0.5 秒（`MARGIN_STORE_SETTLE`），工具沒有去讀晶片的 busy bit，這段等待是唯一的緩衝。

#### 注意事項

- **改電壓會弄壞 DUT**：套 profile 前確認該軌的 OV / UV limit；部分 margin 電阻沒 populate，那些軌的電壓不會動，不是腳本壞了。
- `margin_status` 的偏差 % 是以 `VNOM`（Blanton 實測中位數，2026-08-30 起）為分母；**跨這個日期的 margin log 不能直接互比**。
- SWB 的 LTC2977 有兩條路可以到：一般功能走 CB FPGA（`cb_pmbus_*`），`margin_save blanton` 走原生 i2c。**同一顆晶片不要兩條路同時用。**
- margin 之前 `margin.sh` 會自動把該 channel 的 `ON_OFF_CONFIG` 設成 `0x1a`（否則 margin 不會生效），這只改 RAM，斷電會還原，不是 NVM 寫入；`MARGIN_AUTO_ENABLE=0` 可關掉。
- log 在 `LTC2980_Margin_Script/logs/`：主 log 是摘要，每行帶 `(detail Line:N)` 對到 detail log 的完整輸出。

### blanton_multiphase_margin.sh — 多相 VRM（38 條軌）

```bash
~/Blanton_Script/blanton_multiphase_margin.sh high3     # 全部 +3%
~/Blanton_Script/blanton_multiphase_margin.sh low3      # 全部 -3%
~/Blanton_Script/blanton_multiphase_margin.sh comboA    # 混合 A
~/Blanton_Script/blanton_multiphase_margin.sh comboB    # 混合 B（comboA 的高低對調）
~/Blanton_Script/blanton_multiphase_margin.sh normal    # 回標稱值
~/Blanton_Script/blanton_multiphase_margin.sh high3 -u 0   # 只 SWB0
~/Blanton_Script/blanton_multiphase_margin.sh high3 -n     # 只印指令
~/Blanton_Script/blanton_multiphase_margin.sh save      # ⚠️ 永久寫 NVM
```

- 每條軌印一行：`SWB0_0V9_ANLG0 - 0.930V Configure Done`。
- 改完用 `blanton_multiphase_read.sh` 讀回確認。
- `normal` 之後 TH6_CORE 讀回約 0.859 V 不是 0.8 V，那是 load line，不是寫失敗。

## 2.5 交換晶片：流量 / BER / FDR / 負載

### blanton_traffic_linespeed.sh — SWB loopback 線速流量

```bash
source ~/Blanton_Script/blanton_traffic_linespeed.sh
blanton_traffic_linespeed ps             # 看有接線的 port link / speed
blanton_traffic_linespeed init           # 建 VLAN 30..137，cdN <-> cdN+32
blanton_traffic_linespeed clear          # 清計數器
blanton_traffic_linespeed show           # 看計數器
blanton_traffic_linespeed start          # 打流量
blanton_traffic_linespeed stop           # 移除 VLAN 成員（--destroy 連 VLAN 一起砍）
blanton_traffic_linespeed report         # 每一對 TX/RX 交叉比對 → PASS / FAIL / NA
blanton_traffic_linespeed run            # ps → init → clear → start → report 一條龍
blanton_traffic_linespeed report -f <log>   # 離線重解一份存下來的 console log
```

- `ps` 實際下的是 `bcmcmd -n <u> -c 'ps <有接線的 port 清單>'`；`-p "<list>"` 換清單、`TL_PS_PORTS=all` 看全部。
- `report` 的 exit：0 全 PASS、2 有 FAIL / NA。
- 判定是**成對交叉比對**（cdA 的 TX = cdB 的 RX），不看絕對值。

### blanton_fdr.sh — FDR 統計

```bash
~/Blanton_Script/blanton_fdr.sh start      # fdrstat STArt bin_group=both Interval=30
~/Blanton_Script/blanton_fdr.sh clear      # fdrstat clear
~/Blanton_Script/blanton_fdr.sh rdcnt      # fdrstat Counters（至少等 Interval 之後再讀）
~/Blanton_Script/blanton_fdr.sh stop       # fdrstat STOp（⚠️ 關鍵字未上機驗證）
~/Blanton_Script/blanton_fdr.sh rdcnt -u 0 # 只 unit 0
~/Blanton_Script/blanton_fdr.sh start -i 60   # Interval 改 60 秒
```

- 原始輸出照印，不判定 PASS / FAIL。
- 印目前參數：`grep -E '^FDR_[A-Z_]+=' ~/Blanton_Script/blanton_fdr.sh`
- port 清單同 traffic 的有接線 port（不含 268），`FDR_PORTS="..."` 可改。

### blanton_ber.sh — 全機 SerDes BER（PRBS）

```bash
~/Blanton_Script/blanton_ber.sh init       # prbs set p=3 + prbs get（檢查每條 lane 有沒有鎖上）
~/Blanton_Script/blanton_ber.sh start      # prbsstat STArt Interval=30
sleep 40                                   # ⚠️ 必須「大於」Interval
~/Blanton_Script/blanton_ber.sh report     # 每條 lane 一列，BER < 1e-6 才 PASS，最後 summary
~/Blanton_Script/blanton_ber.sh stop       # prbsstat STOp
~/Blanton_Script/blanton_ber.sh clear      # prbs clear（解除 PRBS，lane 回正常運作）
```

- 選項：`-u 0|1`、`-c 1e-9`（換門檻）、`-F`（只列失敗）、`-f <log>`（離線重解）、`--tsv`、`--raw`。
- summary 每個 unit 三列：`200G ports` / `100G p268` / `TOTAL`。
- **PRBS 跑的時候 `show interfaces status` 會顯示 DOWN，這是正常的。** `clear` 之後才回正常。
- 某一組「一條 lane 都沒回報」算 FAIL。

### blanton_ber_debug.sh — BER 原始輸出

```bash
~/Blanton_Script/blanton_ber_debug.sh        # unit 0+1：set p=p31 → get×2 → STArt 30 → sleep 40 → Ber → STOp → clear
~/Blanton_Script/blanton_ber_debug.sh -u 0   # 單一 unit
BER_PORTS="...,268" ~/Blanton_Script/blanton_ber_debug.sh   # 加 port 268
```

> 這支是 `p=p31`（已上機驗證），`blanton_ber.sh` 是 `p=3`，兩者量的碼型可能不同。

### blanton_tr518.sh — `tr 518` 負載（量功耗用）

```bash
~/Blanton_Script/blanton_tr518.sh start           # 兩個 unit，跑完等 120 秒讓功耗穩定
~/Blanton_Script/blanton_tr518.sh start -u 0      # 只 unit 0
~/Blanton_Script/blanton_tr518.sh start --no-wait # 不等
~/Blanton_Script/blanton_tr518.sh start -w 60     # 等 60 秒
~/Blanton_Script/blanton_tr518.sh stop            # port cd lb=none
```

`start` 每個 unit 依序下：

```bash
bcmcmd -n <u> -c 'port cd lb=mac'
bcmcmd -n <u> -c 'l2 learn off'
bcmcmd -n <u> -c 'dsh -c "test mode nr=yes"'
bcmcmd -n <u> -c 'dsh -c "tr 518 Scenario=6 Profile=2 Count=260 PktSize=324 PortList=1-259,270-565 rm=ext CheckLinkTime=20 CheckDataTime=200 testphase=1"'
```

- 輸出有 `TR 518 TEST PARAMETERS` 才算真的開始跑。
- **`stop` 只解 loopback**，`l2 learn off` 與 `test mode nr=yes` 會留著。要一起還原：
  ```bash
  TR_RESTORE_LEARN=1 TR_RESTORE_TESTMODE=1 ~/Blanton_Script/blanton_tr518.sh stop
  # 每個 unit 多送：'l2 learn on'、'dsh -c "test mode nr=no"'（這兩行未上機驗證）
  ```

### blanton_tr518_thermal.sh — `tr 518` 熱測參數版（未上機驗證）

用法、選項、`stop` 都跟 `blanton_tr518.sh` 一樣，只有 `tr 518` 參數不同：

```bash
bcmcmd -n <u> -c 'dsh -c "tr 518 Scenario=6 Profile=2 portstopktszstride=1 Count=260 PktSize=603,218 CheckLinkTime=20 CheckDataTime=200 TestPhase=1"'
```

參數覆蓋用 `TR_THERMAL_ARGS="..."`（不是 `TR_TEST_ARGS`）。

### port_prbs_monitor.sh — 100G PRBS

```bash
bash ~/Blanton_Script/port_prbs_monitor.sh start     # Ethernet513 + 514
bash ~/Blanton_Script/port_prbs_monitor.sh start a   # 只 Ethernet513
bash ~/Blanton_Script/port_prbs_monitor.sh start b   # 只 Ethernet514
bash ~/Blanton_Script/port_prbs_monitor.sh report    # PASS / FAIL（沒跑的顯示 SKIP）
bash ~/Blanton_Script/port_prbs_monitor.sh stop      # prbsstat STOp + prbs clear
```

> PRBS 打起來時 link 顯示 down 是正常的，所以 `start` 刻意不印 port status。

### unused_lanes.sh / retimer_lanes.sh — 沒接線的 lane 關 TX

```bash
~/Blanton_Script/unused_lanes.sh status                 # 兩個 unit 全部列出 rx_lock / tx_off
~/Blanton_Script/unused_lanes.sh off                    # 預設 TX squelch
~/Blanton_Script/unused_lanes.sh off --asic 0 --th6     # 只 unit 0，連 retimer 後面的 TH6 port 一起關
~/Blanton_Script/unused_lanes.sh on                     # 開回來
~/Blanton_Script/retimer_lanes.sh 0 0x102 0xff status   # 單顆 retimer：<asic> <addr> <lane_map> <off|on|status>
```

- lane 有 RX lock（有訊號進來）時 `off` 會被拒絕（exit 2），`--force` 才硬關。
- Script A 會 `off`，**沒有任何腳本 `on` 回來**；需要 DUT 回正常狀態時手動 `on`。
- 兩支都要 `chmod +x`（`unused_lanes.sh` 會檢查 `retimer_lanes.sh` 的 exec bit）。

## 2.6 SerDes DSC 擷取

### bcm_dsc_scan.sh — DUT 端擷取

```bash
~/Blanton_Script/bcm_dsc_scan.sh                 # unit 0+1 全掃，約 10 分鐘
~/Blanton_Script/bcm_dsc_scan.sh -u 0            # 只掃一個 unit
~/Blanton_Script/bcm_dsc_scan.sh -f my.log -F    # 自訂檔名 + 覆蓋
~/Blanton_Script/bcm_dsc_scan.sh -n              # dry-run，只列要掃的 port
```

- log 在 `~/Blanton_Script/log/`，掃完自動 cp 到 `/host/hw-eval/jobs`（`-C` 關掉）。
- 結尾固定印 `### DSC_SCAN_DONE rc=<n>`，**rc=0 才是全部 port 都拿到完整 dump**。

### bcm_dsc_parse.sh — raw log 轉 CSV

```bash
sh ~/Blanton_Script/bcm_dsc_parse.sh -i blanton_dsc_ScriptA_u0.log -o u0
# 產出 u0_lane.csv（每 lane 一列）+ u0_pm.csv（每 pm_id 一列）
```

Host / DUT 都能跑（純 sh + awk）。解不出來的列標成 `UNPARSED` 印到 stderr。

### bcm_100g_dsc_cycle.sh — 100G link down/up 循環（未上機驗證）

```bash
~/Blanton_Script/bcm_100g_dsc_cycle.sh             # 印說明
~/Blanton_Script/bcm_100g_dsc_cycle.sh 200         # 跑 200 輪
~/Blanton_Script/bcm_100g_dsc_cycle.sh 200 -d      # 每行指令以 [CMD] 印出
~/Blanton_Script/bcm_100g_dsc_cycle.sh 20 -T       # 跳過 tuning
~/Blanton_Script/bcm_100g_dsc_cycle.sh 1 -n        # dry-run
```

log：`~/dsc_log/100G_dsc_cycle_test_<ts>.log`。

## 2.7 背景監控（start / stop 型）

這幾支共通：`start` 只等 1 秒就返回（**不是跑完一輪**）、`start` 會先清空 log、需要 exec bit。

> ⚠️ **`bmc_monitor.sh tail` 是 `tail -f`，永遠不返回**，TTL 裡絕對不要用。看 log 請用 `cat`（`nfc_polling.sh tail N` 不會卡住）。

### mgmt_ping_monitor.sh — 10G + 1G 管理網路 ping

```bash
~/Blanton_Script/mgmt_ping_monitor.sh start     # 背景，log/mgmt_ping.log
~/Blanton_Script/mgmt_ping_monitor.sh status
~/Blanton_Script/mgmt_ping_monitor.sh stop      # 停 + 產出報表（每張卡最近 N 筆 + 統計 + 判定）
~/Blanton_Script/mgmt_ping_monitor.sh summary   # 只看每段的 RESULT 行
~/Blanton_Script/mgmt_ping_monitor.sh clear
cat ~/Blanton_Script/log/mgmt_ping.log
```

- IP 設定在腳本開頭的 **User Configurable Section**（預設 eth0 `192.168.1.99` → `192.168.1.30`、eth1 `192.168.1.101` → `192.168.1.31`），依現場網路改。
- 兩張卡同網段會 ARP flux：判讀看 `RESULT` 行的 `nic_tx` / `nic_rx`——**ping 成功但 `nic_tx` 接近 0 = 封包從另一張卡出去的**。

### nfc_polling.sh — NFC tag 輪詢

```bash
~/Blanton_Script/nfc_polling.sh start       # 背景
~/Blanton_Script/nfc_polling.sh status      # pid、已跑幾輪、最後一筆結果
~/Blanton_Script/nfc_polling.sh report      # PASS / FAIL / ERROR 統計（輪詢中也能跑）
~/Blanton_Script/nfc_polling.sh tail 50     # 最後 50 行（不會卡住）
~/Blanton_Script/nfc_polling.sh stop
~/Blanton_Script/nfc_polling.sh fg          # 前景跑
```

- 每輪呼叫同目錄的 `blantons_nfc_validate.py test --debug`。
- `ERROR` = 工具沒印出 `[PASS]` / `[FAIL]` 或逾時，跟「tag 讀不到（FAIL）」分開算。
- `NFC_INTERVAL_SEC` / `NFC_TIMEOUT_SEC` / `NFC_ARGS` 可調（**每個子指令都要帶**）。

### bmc_monitor.sh — BMC 記憶體 + I2C 圖樣

```bash
~/Blanton_Script/bmc_monitor.sh start       # 背景，log/bmc_poll.log
~/Blanton_Script/bmc_monitor.sh status
~/Blanton_Script/bmc_monitor.sh stop
~/Blanton_Script/bmc_monitor.sh fg          # 前景跑
cat ~/Blanton_Script/log/bmc_poll.log
```

每輪透過 `bmc-manager run` 在 BMC 上跑 `free -m` + I2C（bus 1, 0x41）寫 `55 AA 55 AA` / `AA 55 AA 55` 再讀回比對，間隔 10 秒。要加減指令改腳本開頭的 `COMMANDS=( ... )`。

### bmc_monitor_ddr.sh — 已停用

BMC DDR 壓力已改成 Script B 的 `bgctl run bmc-manager run '/usr/bin/memtester 64M'`。檔案保留，用法同 `bmc_monitor.sh`（log 為 `log/bmc_ddr.log`）。

## 2.8 其他

### tray_id_stress.sh — Tray ID I2C stress

```bash
~/Blanton_Script/tray_id_stress.sh          # bus 34/35/38/39，0x70 reg 0x02：寫 0xA5/0x5A 讀回比對 → Summary
~/Blanton_Script/tray_id_stress.sh -n 100   # 重複 100 輪
~/Blanton_Script/tray_id_stress.sh -R       # 跑完不還原（預設會寫回原值並讀回確認）
```

exit：0 全 PASS / 1 有 FAIL（讀回不符）或 ERROR（i2c 指令本身失敗）/ 2 參數錯。

### usb_target.sh — 找 USB 隨身碟

```bash
bash ~/Blanton_Script/usb_target.sh              # 掛好並印掛載點（預設 /mnt/usb）
bash ~/Blanton_Script/usb_target.sh -o dev       # 印 partition（例如 /dev/sda1）
bash ~/Blanton_Script/usb_target.sh -o both      # 印 "<dev> <mnt>"
bash ~/Blanton_Script/usb_target.sh -o id        # 印 /dev/disk/by-id/... 路徑
bash ~/Blanton_Script/usb_target.sh -n -o both   # 只偵測，不掛載
```

| exit | 意思 |
|---|---|
| 0 | 成功 |
| 1 | 找不到 USB 隨身碟 |
| 2 | 偵測到多支（拒絕猜） |
| 3 | 沒有可用的檔案系統 |
| 4 | 掛載失敗 |
| 5 | 掛上了但不能寫 |

### blantons_nfc_validate.py — 客戶 NFC 驗證工具（v2.5）

```bash
python3 ~/Blanton_Script/blantons_nfc_validate.py inventory      # 唯讀探測，不送 I2C、不寫硬體
python3 ~/Blanton_Script/blantons_nfc_validate.py test --debug   # 切 VEN 並跑廠商 NCI 輪詢流程
python3 ~/Blanton_Script/blantons_nfc_validate.py --version
```

平常由 `nfc_polling.sh` 呼叫，不需要手動跑。

---

## 附錄：一頁速查

```bash
# 佈署
mount /dev/sda1 /mnt/usb && cp -r /mnt/usb/Blanton_Script ~/
find ~/Blanton_Script -name '*.sh' -exec chmod +x {} + ; grep -rlU $'\r' ~/Blanton_Script

# 載入（Script A 也是這 6 支）
source ~/Blanton_Script/blanton_fpga_pcimem.sh
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

# 收拾一個被中斷的測試
kill $(jobs -p); systemctl stop mlucas-amm; bgctl stop --all; bgctl reset --yes
~/Blanton_Script/mgmt_ping_monitor.sh stop; ~/Blanton_Script/nfc_polling.sh stop; ~/Blanton_Script/bmc_monitor.sh stop
systemctl stop qfx5252-bmc-usb-net-test.service
blanton_traffic_linespeed stop; ~/Blanton_Script/blanton_fdr.sh stop
~/Blanton_Script/blanton_tr518.sh stop          # 跑過 Script 4 / tr 518 時
~/Blanton_Script/unused_lanes.sh on             # 需要 DUT 回正常狀態時
```