fix(margin): Reference VNOM to what the rails run at, and split profiles per CONN

86 of the 144 margin channels moved up +0.8% .. +2.5% to the measured
median for this platform (3.3 -> 3.38, 0.9 -> 0.915, 0.8 -> 0.82, ...).

That is not a display change. VNOM is the denominator of margin_status'
deviation %, and it is also the basis margin_set derives high/low/OV/UV
from - so both the number you read and the voltage you apply move with
it. A rail steady at 0.756 V used to read +0.80% against a nominal 0.75
and now reads 0.00%. Margin logs from before and after cannot be
compared: the reference moved, the hardware did not.

comboA/comboB are replaced by combo_SWB_CONN13..16_{high,low}. The
per-channel percentages are positional, so they follow the rails of one
specific board - applying a CONN13 profile to a CONN16 margins the wrong
rails and nothing detects it. SWB0 and SWB1 share a profile per CONN
because their rails are identical.

Fixes two things the deletion broke:
  - margin_apply_profile_all.sh still named comboA for all nine boards,
    which would now stop at "Profile not found" nine times over. It names
    the matching per-CONN profile instead, with CB on the generic
    combo_high3, and a note that the low pass is _high -> _low.
  - docs/LTC2980_channel_map.csv is generated from settings/*.conf, so
    all 86 changed rails were stale in it. Regenerated.

The eight new profiles also still carried comboA's header comment
("alternating high/low"), which describes neither what they contain nor
what they are for.

Script A -> V1.1.3.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014RetWKFZFG1ZHcitQAyhwM

.gitignore

@@ -12,6 +12,11 @@ For_AI/
 !**/logs/.gitkeep
 !**/Logs/.gitkeep
 
+# monitor 腳本的執行期產物（原始擷取、pid、狀態）
+*.raw
+*.pid
+*.state
+
 # 打包輸出：產出不進 git，打包工具本身要進
 publish/*
 !publish/.gitkeep

ARCHITECTURE.md

@@ -40,8 +40,9 @@ LTC2980 margin 控制器。TTL 只負責「按順序 `sendln` 並把畫面收進
 | BMC 存取 | host 端 `bmc-manager run "<cmd>"`（不需對 BMC 開 SSH，繞開其 busybox 工具鏈）；`bmc-first-enroll` / `bmc-manager version\|status` |
 | 背景工作管理 | `bgctl run/list/stop --all/reset`（平台工具）；長時間 ping 用 `systemd-run --unit=` 掛成 transient unit |
 | 管理網路 | iproute2（`ip link set` / `ip address replace` / `ip route replace ... metric`）+ `ping -I` |
-| 測試 session | `hw-test-session start\|log\|status\|finish`；job log 收在 `/host/hw-eval/current/jobs/` |
+| 測試 session | `hw-test-session start\|log\|status\|finish`；job log 收在 `/host/hw-eval/jobs/` |
 | 風扇控制 | max31790 driver rebind（`/sys/bus/i2c/drivers/max31790/{bind,unbind}`）+ `fan-speed-control.sh <%>` |
+| 100G PRBS | `bcmcmd -n <unit> -c 'dsh -c "phy diag <phy> prbs …"'`（set / prbsstat STArt / get / Ber / STOp / clear） |
 | 壓力測試 | `mlucas-avx2`（AMD CPU）、`bgctl run` 排程的 `memtester` / `qfx5252-stress-ssd` / `qfx5252-stress-usb` |
 | 資料面流量 | `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` |
@@ -119,6 +120,7 @@ Blanton_TTL_Script/
 │   ├── Blantons_FPGA_Registers_draft.docx # 同上，客戶原始 docx
 │   ├── Blantons_FPGA_Registers_Map_draft.xlsx
 │   ├── Blantons_PCIe_AER_and_DDR_EDAC_checks.pdf  # AER / EDAC 檢查點依據
+│   ├── LTC2980_channel_map.csv            # 9 個 settings/*.conf 合併：Board,CONN,Ch,NetName,Vnom（144 列）
 │   ├── TTL_Script_Blanton_Status_20260814.xlsx
 │   └── TTL_Script_Blanton_Status_20260817.xlsx    # ⭐ 最新：三支腳本逐項 Status（OK / On-Going + Owner）
 │
@@ -126,9 +128,15 @@ Blanton_TTL_Script/
 │   ├── bcm_mibpair_report_V1.1.0.py       # 離線解析 drivshell log → per-pair TX/RX + PASS/FAIL
 │   ├── traffic_loopback_vlan_setting.txt  # bcmcmd VLAN 30..137 建立 + 成對 pbm（cdN <-> cdN+32）
 │   ├── traffic_loopback_start.txt         # bcmcmd tx 100 length=512 VLantag=<vid>
-│   └── traffic_loopback_vlan_remove.txt   # bcmcmd vlan remove <vid> pbm=...
+│   ├── traffic_loopback_vlan_remove.txt   # bcmcmd vlan remove <vid> pbm=...
-│                                          # ↑ 三份為手動貼上用的原始指令表，
+│   │                                      # ↑ 三份為手動貼上用的原始指令表，
-│                                          #   blanton_traffic_linespeed.sh 是其 bash 版
+│   │                                      #   blanton_traffic_linespeed.sh 是其 bash 版
+│   ├── 100G_PRBS.txt                      # 100G PRBS 原始指令（port_prbs_monitor.sh 的來源）
+│   ├── TR518.txt                          # 內建封包測試 tr 518 → blanton_tr518.sh
+│   ├── BER_Test.txt                       # 全機 PRBS BER 指令 → blanton_ber.sh
+│   ├── 100G_Traffic.txt                   # ce0 VLAN 138 打流 → blanton_traffic_linespeed.sh
+│   ├── fan_ctrl.txt                       # MAX31790 unbind/bind + fan-speed-control.sh 30
+│   └── gen_channel_map.sh                 # settings/*.conf → docs/LTC2980_channel_map.csv（需 gawk）
 │
 ├── secret/                            # 🚫 gitignored — DUT 密碼、per-unit BDF、COM 設定
 │   ├── README.md                      # ✅ committed — 用途索引
@@ -177,14 +185,26 @@ Blanton_TTL_Script/
             ├── blanton_traffic_linespeed.sh  # SWB loopback 線速流量（bcmcmd unit 0/1）
             │                                 #   init/clear/show/start/stop/ps/report/run
             ├── mgmt_ping_monitor.sh       # 10G/1G 管理網路 ping 監控（iproute2）
-            │                              #   eth0→TARGET_10G、eth1→TARGET_1G，兩張卡都保持 up
+            │                              #   eth0→TARGET_10G、eth1→TARGET_1G，兩張卡同時持續 ping
-            ├── bmc_monitor.sh             # ⚠️ 已停用：B/C 內呼叫處已註解，改走 bgctl + bmc-manager
+            ├── port_prbs_monitor.sh       # 100G uplink PRBS 測試（bcmcmd phy diag）
-            ├── bmc_monitor_ddr.sh         # ⚠️ 已停用，同上
+            ├── blanton_ber.sh             # 全機 SerDes BER 掃描（phydiag prbs / prbsstat）
+            ├── nfc_polling.sh             # NFC tag 背景輪詢 + PASS/FAIL 統計
+            ├── blantons_nfc_validate.py   # NFC/NCI 驗證工具（廠商提供，未修改）
+            ├── blanton_tr518.sh           # TR518 封包測試，量功耗前的負載來源
+            ├── TH6_SWB0_power_readback.sh # SWB0 19 條軌 V×I + 總功耗
+            ├── TH6_SWB1_power_readback.sh # SWB1 同上
+            │                              #   ⚠️ 已納入交付，但 A/B/C 的呼叫仍註解掉（bring-up 中）
+            ├── usb_target.sh              # 偵測 USB 裝置節點／掛載點（排除系統碟）
+            ├── bmc_monitor.sh             # BMC 監控：free -m + I2C 寫入/讀回圖樣測試
+            ├── bmc_monitor_ddr.sh         # ⚠️ 已停用：B/C 內呼叫處已註解，DDR 壓力改走 bgctl + bmc-manager
             │                              #   ↑ 三支都要 chmod +x 才能跑（見 Key Constraints）
             └── LTC2980_Margin_Script/     # 電壓 margin 子專案（另有獨立 repo）
                 ├── margin.sh              # margin_init/status/set/apply_profile/save
+                #                            #   v2.7.0：margin_save all / margin_save blanton
                 ├── settings/*.conf        # 一個 .conf = 一顆 LTC2980（CB + SWB0/1 × CONN13~16）
-                ├── profiles/*.conf        # 16-ch 批次組合（comboA/B、high3/5、low3/5、normal、off）
+                ├── profiles/*.conf        # 16-ch 批次組合。SWB 為 per-CONN：
+                #                            #   combo_SWB_CONN13~16_{high,low}（百分比對應該片的軌）
+                #                            #   通用：high3/5、low3/5、normal、all_off
                 ├── script/*_all.sh        # 跨 9 顆 LTC2980 的批次 status / apply / save
                 ├── Ref/margin_command_trace.md  # 指令追蹤參考（SWB 章節已標過期，見文件內警告）
                 └── logs/                  # margin 操作 log
@@ -205,7 +225,7 @@ project_name  = "Blanton"       ; 專案名，進 log 檔名
 strTestcase   = "ENV"           ; 測項名（ENV/EMC/Margin...），進 log 檔名
 EN_Margin     = 0               ; 1=跑 margin 掃描, 0=跳過
 EN_log        = 1               ; 1=logopen 存檔, 0=不存
-FAN_SPEED     = 30              ; 傳給 fan-speed-control.sh 的風扇轉速 (%)
+FAN_SPEED     = 100             ; 傳給 fan-speed-control.sh 的風扇轉速 (%)，預設全速
 SWB_UNIT0     = 1               ; 這台有 switch unit 0（流量與 wait_init 都依此）
 SWB_UNIT1     = 1               ; 這台有 switch unit 1
 prompt_login      = "sonic login:"
@@ -225,11 +245,20 @@ Log 檔名規則：`<mdir>\Logs\<project_name>_<strTestcase>_<YYYYmmdd-HHMMSS>.l
 | `CB_I2C_CH` | int | `TRANSPORT="swb"` 時的 FPGA I2C 通道（6/7/8/9） |
 | `CHIPS[]` | string[2] | `"bus:addr"`，index 0 → CH0~7、index 1 → CH8~15 |
 | `CHIP_PRE_CMD[]` / `CHIP_POST_CMD[]` | string[1] | mux 切換等前後置指令，`;` 分隔多筆 |
-| `CH<n>_VNOM` | string | 標稱電壓（`"-"` = 未使用 / NC） |
+| `CH<n>_VNOM` | string | 這條軌的**基準電壓**（`"-"` = 未使用 / NC） |
 | `CH<n>_NET` | string | 電路 net name（對照 schematic） |
 
 Channel 定址：`ch / 8` → `CHIPS[]` index，`ch % 8` → LTC2977 PMBus PAGE（0x00~0x07）。
 
+**`VNOM` 自 2026-08-30 起是「Blanton 實測中位數」，不是規格標稱值。** 144 條軌裡有 86 條
+被改上去 +0.8% ~ +2.5%（例：`PVDD3_3V_SYNTH_LDO_*` 3.3 → 3.38、`P0V9_AVDD_*` 0.9 → 0.915、
+`PVDD0_8V_T3` 0.8 → 0.82）。這件事影響兩處，**不是只有顯示**：
+
+- `margin_status` 的偏差 % 是對 `VNOM` 算的 —— 以前一條穩定在 0.756 V 的軌顯示 `+0.80%`，
+  現在顯示 `0.00%`。**舊 log 的偏差 % 不能跟新 log 直接比。**
+- `margin_set` 的 high / low / OV / UV **全部由 `VNOM` 推算**（`VNOM × (1 ± change%)`），
+  所以整個 margin 視窗跟著平移。同樣下 `+3%`，實際打到的絕對電壓比以前高。
+
 **SWB 通道與位址對應（2026-08-19 上機驗證，`ababb2c`）：**
 
 | FPGA I2C 通道 | 板 / 接頭 | LTC2977 位址（lo / hi） |
@@ -242,6 +271,31 @@ Channel 定址：`ch / 8` → `CHIPS[]` index，`ch % 8` → LTC2977 PMBus PAGE
 > 同一顆 LTC2980 的兩個位址**相差 2**（7-bit，由規格書 8-bit 配對除以 2 而來），不是 1。
 > 兩張板共用一條通道，所以同通道上的位址必須互斥 —— 上表兩組（`0x5C/0x5E` 與 `0x62/0x64`）不重疊。
 
+**同一批 LTC2977 也掛在原生 i2c bus 上**（2026-08-27 上機驗證）：Blanton 的 SONiC 把 CB FPGA F3
+的這四條 I2C 通道同時註冊成 kernel i2c adapter，因此除了 `cb_pmbus_*` → pcimem 這條路，
+還可以用 `i2cset -f -y <bus>` 直接打到同一顆晶片：
+
+| FPGA F3 通道 | Linux bus | CB FPGA 路徑 | 原生 i2c 路徑 |
+|---|---|---|---|
+| Ch6 | 13 | `cb_pmbus_write 6 <addr> …` | `i2cset -f -y 13 <addr> …` |
+| Ch7 | 14 | `cb_pmbus_write 7 <addr> …` | `i2cset -f -y 14 <addr> …` |
+| Ch8 | 15 | `cb_pmbus_write 8 <addr> …` | `i2cset -f -y 15 <addr> …` |
+| Ch9 | 16 | `cb_pmbus_write 9 <addr> …` | `i2cset -f -y 16 <addr> …` |
+
+`margin.sh` 的 `margin_save blanton` 走原生路徑（`MARGIN_BLANTON_STORE` 表），
+其餘功能仍走 `TRANSPORT="swb"` 的 FPGA 路徑。兩條路到的是同一顆 LTC2977，
+**不要同時用**（同一條匯流排上兩個 master 語意的存取）。
+
+**全通道 net / 電壓對照：`docs/LTC2980_channel_map.csv`**（9 個 `.conf` × 16ch = 144 列，
+欄位 `Board,CONN,Ch,NetName,Vnom`）。查「某個 net 在哪片哪個 channel」比翻 9 個 `.conf` 快。
+CSV 是產出物，不是正本 —— 改完 `.conf` 用 `./tools/gen_channel_map.sh` 重產，別手改 CSV。
+兩件從表上看得出來、改 `.conf` 時要記得的事：
+
+- **SWB0 與 SWB1 的 net / 電壓完全相同**，差別只在 `CHIPS[]` 的 bus（`0:` vs `1:`）與 `CB_I2C_CH`。
+  也就是說有兩份會各自漂移的重複資料 —— 改了 SWB0 沒改 SWB1，不會有任何東西擋你。
+- **8 個 NC 通道**（SWB0/1 CONN14 的 CH10/CH11/CH13、CONN15 的 CH10）在 CSV 裡以
+  `NC` / `-` 原樣保留，不是漏掉；濾掉它們會讓 page 編號對不上。
+
 ### 3. `profiles/*.conf` — 16-ch 批次 margin 組合
 
 ```bash
@@ -301,18 +355,26 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... )   # "channel:operation:change_perc
 
 | 模組 | 進入點 | 功能 |
 |------|--------|------|
-| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.0.7 | root 登入 → `date -s` 對時 → 清 job log → `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** → 100G uplink 設定與狀態 → **一輪流量基線** → `show uptime` |
+| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.1.2 | 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 設定與狀態 → **一輪流量基線** → `show uptime` |
-| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + `bgctl run` 的 `memtester` / SSD / USB 壓力 + BMC DDR（`bmc-manager run memtester`）→ BMC USB net test（探測 cdc_ncm 介面，`systemd-run` 掛 4 小時 ping）→ 啟動 mgmt ping 監控 → `jobs` / `bgctl list` → traffic（依 `SWB_UNIT`）→ `while 1` 每輪完整 PMON + margin |
+| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + `bgctl run` 的 `memtester` / SSD / USB 壓力 + BMC DDR（`bmc-manager run memtester`）→ BMC USB net test（探測 cdc_ncm 介面，`systemd-run` 掛 4 小時 ping）→ 啟動 mgmt ping 監控 → **啟動 NFC 輪詢** → `jobs` / `bgctl list` → traffic（依 `SWB_UNIT`）→ `while 1` 每輪完整 PMON + margin |
-| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` + `bgctl stop --all` / `reset` + 停 BMC USB unit 與 mgmt ping → PMON + dmesg → 7 組 AER + `ras-mc-ctl` → BMC USB `journalctl` → `ip -s link show eth0/eth1` → `cat` mlucas log → traffic `stop` + `report` → NVMe 健康 → `show reboot-cause` / `uptime` → **job log 複製到 USB（帶時戳）** → `hw-test-session finish` |
+| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` + `bgctl stop --all` / `reset` + 停 BMC USB unit、mgmt ping 與 **NFC 輪詢** → PMON + dmesg → 7 組 AER + `ras-mc-ctl` → BMC USB `journalctl` → `ip -s link show eth0/eth1` → `cat` mlucas log → **NFC `report`** → traffic `stop` + `report` → **BER 掃描**（依 `SWB_UNIT`）→ NVMe 健康 → `show reboot-cause` / `uptime` → **job log 複製到 USB（帶時戳）** → `hw-test-session finish` |
-| **SWB loopback 流量** | `blanton_traffic_linespeed <sub> [-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`（一條龍） |
+| **SWB loopback 流量** | `blanton_traffic_linespeed <sub> [-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`（一條龍）。**V0.6.0 起含 100G uplink `ce0`**（VLAN 138）：它沒有 loopback 對象，靠 **ingress mirror 打回自己**維持循環，`report` 最後一列就是它，底下再接一份跨 unit summary |
 | **FPGA 暫存器存取** | `cb_fpga <fn> <addr> [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 與狀態掃描。v2.6.0 起 SWB 路徑真正接上共用 cb_i2c 後端，並有 `margin_swb_info/probe/scan/reset/sem` 除錯包裝 |
+| **電壓 Margin** | `margin_init/status/set/apply_profile/save` + `*_all.sh` | 9 顆 LTC2980（CB CONN13、SWB0/1 CONN13~16）批次 high/low margin 與狀態掃描。`VNOM` 為 Blanton 實測中位數（2026-08-30）；SWB 的 profile 是 per-CONN，套錯 CONN 會 margin 到錯的軌且不報錯。v2.6.0 起 SWB 路徑真正接上共用 cb_i2c 後端，並有 `margin_swb_info/probe/scan/reset/sem` 除錯包裝 |
+| **Margin 寫 NVM** | `margin_save` / `margin_save all` / `margin_save blanton` | ⚠️ 永久寫入。`0x15` 送 PMBus **send-byte**（不帶 data byte）。`all` = 依 `settings/` 走 9 顆、跑完還原原本載入的板子；`blanton` = 本平台捷徑，18 顆全走原生 i2c bus（`MARGIN_BLANTON_STORE` 表），不需 `margin_init`。每筆之間 `MARGIN_STORE_SETTLE`（0.5s），工具**不 poll busy bit** |
 | **管理網路 ping** | `mgmt_ping_monitor.sh {start\|stop\|status\|fg\|tail\|clear\|summary}` | 一輪 = 10G leg + 1G leg，各自 `ip address/route replace` 後 `ping -I <if>` 打自己的對端；兩張卡都保持 up。每 leg 記 `ip -s link show` 與該卡的 TX/RX packet delta，另出一行可 grep 的 `RESULT` |
-| **BMC 監控 / 壓力** | `bmc_monitor.sh` / `bmc_monitor_ddr.sh` | ⚠️ **已停用** —— B/C 內呼叫處已註解，改由 `bgctl` + `bmc-manager run memtester` 取代。檔案保留未刪 |
+| **BMC 監控** | `bmc_monitor.sh {start\|stop\|status\|fg\|tail\|clear}` | 由 host 端 `bmc-manager run` 週期取樣 `free -m`，另加一組 **I2C 寫入/讀回圖樣測試**（bus 1、addr 0x41、offset 0x00C0，寫 `55AA55AA` 讀回、再寫 `AA55AA55` 讀回）。B 啟動、C 停止並 `cat log/bmc_poll.log` |
+| **BMC DDR 壓力** | `bmc_monitor_ddr.sh` | ⚠️ **已停用** —— B/C 內呼叫處已註解，改由 `bgctl run bmc-manager run memtester` 取代。檔案保留未刪 |
+| **100G PRBS** | `port_prbs_monitor.sh {start [both\|a\|b]\|stop\|status\|report\|clear}` | 兩個 uplink 各一個 worker，可同時或單獨跑。setup（`lpmode off` → `prbs set` → `prbsstat STArt`）→ 週期 `prbs get`（判定）+ `prbsstat Ber`（只記錄）→ teardown（`STOp` + `prbs clear`）。輸出含 `PRBS OK!` 才算 PASS。**⚠️ A/B/C 的呼叫目前註解掉** |
+| **SerDes BER 掃描** | `blanton_ber.sh {init\|clear\|start\|stop\|report} [-u 0\|1\|all]` | 全機每個對接 port 的 PRBS BER：`prbs set p=3` + `prbs get`（確認每條 lane 都鎖上）→ `prbsstat STArt Interval=30` →（等一個 interval）→ `prbsstat Ber` → `STOp` → `prbs clear`。`report` 一列一條 lane，**BER < 1e-6 才 PASS**，最後跨 unit 的 summary 帶最差 lane。⚠️ PRBS 期間 link 顯示 DOWN、不過流量 |
+| **TR518 負載** | `blanton_tr518.sh {start\|stop} [-u 0\|1\|all]` | `port cd lb=mac` → `l2 learn off` → `test mode nr=yes` → `tr 518 ... testphase=1`，然後 settle `TR_SETTLE_SEC`（120s）再讓人量功耗。`stop` 只送 `port cd lb=none`（照 `TR518.txt`），L2 學習與 test mode **不會還原**，`TR_RESTORE_*=1` 才會 |
+| **SWB 軌功耗** | `TH6_SWB{0,1}_power_readback.sh` | 讀 `show platform voltage/current` **各一次**，19 條軌 V×I 與總功耗。舊版每軌各讀一次（38 次呼叫、每軌不同時刻），總和是不同瞬間的加總 |
+| **NFC 讀取輪詢** | `nfc_polling.sh {start\|stop\|status\|tail\|report\|clear\|fg}` | 背景重複跑 `blantons_nfc_validate.py`，每輪追加一行機器可讀的 `RESULT=`（PASS/FAIL 取自工具自己的摘要行，兩者皆無則 **ERROR**，與 FAIL 分開計數）。`start` 會先清空 log；`report` **只讀 log，polling 中隨時可跑**，並標示 `RUNNING` 免得快照被當最終結果。`tail` **不 follow** |
+| **USB 目標偵測** | `usb_target.sh [-o dev\|mnt\|both\|id] [-n] [-r sec]` | 找出插入的 USB 儲存裝置，排除 `/` 與 `/host` 的底層碟（本平台可能從 USB DOM 開機），多顆時拒絕猜；掛載時會驗證真的可寫 |
 | **打包交付** | `publish/publish.sh [-v Ver] [-f] [-z] [-n]` | 版號讀 Script A 檔頭，複製成 `publish/Script_ABC_Blanton_<Ver>/`，排除 `*.log`，可另出 zip |
 
 ---
@@ -329,7 +391,8 @@ Script A ── logopen Logs/Blanton_Margin_<ts>.log ──┐  (之後所有畫
     │                                              │
     ├─ 登入 admin → sudo -i → root@sonic:~#         │
     ├─ date -s "<host 時間>"   ← 讓 DUT 時戳可對照
-    ├─ rm /host/hw-eval/current/jobs/*   ← 清掉上一輪的 job log
+    ├─ rm /host/hw-eval/jobs/*   ← 清掉上一輪的 job log
+    ├─ hw-test-session finish / bgctl reset / stop --all / list   (收前一輪)
     ├─ hw-test-session start / log / status
     ├─ 風扇：max31790 unbind→sleep→bind（18-0020 與 25-0020 各一次）
     │        → fan-speed-control.sh <FAN_SPEED> → 回答 y 確認   │
@@ -373,7 +436,8 @@ Script C
     ├─ nvme smart-log / smartctl -x /dev/nvme0
     ├─ traffic: stop → report   ← per-pair TX/RX 交叉比對，PASS/FAIL/NA（exit 2 = 有 FAIL/NA）
     ├─ show reboot-cause / show uptime  ← soak 期間有沒有意外重開，一眼看得到
-    ├─ cp -r /host/hw-eval/current/jobs/ /mnt/usb/jobs-<YYYYmmdd>_<HHMM>
+    ├─ usb_target.sh -o dev → sync → mount <dev> /mnt/usb
+    ├─ cp bmc_poll.log / mgmt_ping.log → jobs/，再 cp -r jobs/ /mnt/usb/jobs-<YYYYmmdd>_<HHMM>
     └─ hw-test-session finish
     ▼
 [messagebox "GOOD JOB! Test Case DONE"] → 人工檢查 log
@@ -412,6 +476,8 @@ pwr_data
    只吃 Sr；只有純暫存器裝置兩種都行。
 7. **`margin_save`（`STORE_USER_ALL`）會永久寫進 NVM**，斷電保留。測試流程中**絕不執行**，
    以免覆蓋客戶出廠 config。`margin.sh` 的 auto-enable 只改 RAM（`ON_OFF_CONFIG`），斷電復原。
+   `margin_save all` / `margin_save blanton`（v2.7.0）一次對 9 顆 LTC2980（18 個 LTC2977）
+   下同一道命令，風險同性質但範圍是全機；命令本身是 PMBus send-byte（`0x15`，不帶 data byte）。
 8. **操作硬體電壓有損壞 DUT 的風險**：套 profile 前先確認該軌 OV/UV limit 與 servo DAC 注入電阻
    有 populate（本板部分 margin 電阻標 PROTO，沒 populate 的軌電壓不會動）。
 9. **`ARB_LOST` 不等於裝置存在**：`vi2c_scan` 只看 `RX_ACK`，仲裁失敗會被誤報成「有裝置」。
@@ -460,7 +526,7 @@ pwr_data
 | **客戶機密文件** | `docs/` 內 FPGA 規格（docx/xlsx/md）屬客戶 NDA 範圍；schematic 原始檔（`*.DSN`）一律 gitignore，不進 repo |
 | **Remote 限制** | 只推私有 remote：`nas`（`git.et-wen.com:51222`）+ `gitea`（`etgit.et-wen.com`）。**不設 GitHub `origin`** |
 | **測試 log** | `logs/*.log` 含 DUT 序號、MAC、韌體版本等可識別資訊 → gitignore，只保留目錄結構（`.gitkeep`） |
-| **破壞性硬體指令** | `margin_save` / `STORE_USER_ALL` 為永久 NVM 寫入，工具預設不呼叫；批次腳本 `margin_save_all.sh` 在 README 與腳本頂端都有警語 |
+| **破壞性硬體指令** | `margin_save` / `margin_save all` / `margin_save blanton` / `STORE_USER_ALL` 為永久 NVM 寫入，工具預設不呼叫；`margin_save all` 與批次腳本 `margin_save_all.sh` 在 README 與程式頂端都有警語 |
 | **root 權限** | 全流程在 `root@sonic:~#` 下執行（pcimem / i2c 需要）；腳本不留任何 `chmod 777` 或放寬權限的動作 |
 | **For_AI/** | AI 協作素材（截圖、草稿筆記）整個資料夾 gitignore，避免不小心把客戶圖面帶進 repo |
 
@@ -592,9 +658,11 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
 - [x] 壓力層改用平台的 `bgctl`（`memtester` / `qfx5252-stress-ssd` / `qfx5252-stress-usb`），
       取代 `~/hammer/tools/stress_*.py`；Script B 以 `jobs` + `bgctl list` 兩者並列確認
 - [ ] `bgctl list` 之後加數量驗證，不符時 `messagebox` 提示（目前只印出來給人看）
+      **← V1.0.10 起 `bgctl list` + `jobs` 改為每輪都印，中途死掉的 job 看得到，但仍要靠人眼比對**
 - [ ] soak 迴圈改為「每輪先 `date`、跑完 `pause <間隔>`」，
       把 `EN_LoopInterval`（預設 600 秒 = 10 min）放進 `config.ttl`，兌現 Status 表的「Get data every 10mins」
-      **← 目前 `while 1` 仍無 `pause`，實際間隔取決於指令執行時間，不是 10 分鐘**
+      **← V1.0.10 已補上 `pause 60`（迴圈不再全速空轉），但 60 秒是寫死的、也還沒有每輪 `date`；
+      距 Status 表的 10 分鐘仍有差距，故本項未結**
 - [x] soak 每輪補 `show platform psustatus` / `voltage` / `current`
       —— 迴圈已改為 `include "utils/setup_pmon.ttl"`，九項全收
 - [ ] 補 `; ========== CLEAR EVENT ==========`（Status 表 ScriptB #1，Owner: Alan）
@@ -711,18 +779,46 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
   文件已加過期警告但內文未動。第 1~4 章不受影響。
 - **`wait_init.ttl` 沒有逾時出口**：若 pmon 一直起不來，`result` 既非 1 也非 2，迴圈會無限重試，
   Script A 既不往下走也不報錯。可加最大重試次數 + `messagebox` 提示。
-- **腳本的執行權**：`mgmt_ping_monitor.sh`（以及保留但已停用的 `bmc_monitor*.sh`）需人工 `chmod +x`。
+- **腳本的執行權**：`mgmt_ping_monitor.sh` 與 `bmc_monitor.sh`（以及已停用的 `bmc_monitor_ddr.sh`）需人工 `chmod +x`。
   可在 Script B 起它之前補一行（比照既有的 `chmod +x ~/hammer/tools/amd/mlucas-avx2`），或在 publish 時處理。
-- **`bmc_monitor.sh` / `bmc_monitor_ddr.sh` 已停用**：B/C 內的呼叫都已註解，改由 `bgctl` +
+- **`bmc_monitor_ddr.sh` 已停用**：B/C 內的呼叫已註解，DDR 壓力改由 `bgctl run bmc-manager run memtester`
-  `bmc-manager run memtester` 取代。檔案還留在 repo，待確認不再需要後刪除，或在檔頭標註停用。
+  取代。檔案還留在 repo，待確認不再需要後刪除，或在檔頭標註停用。
-- **`rm /host/hw-eval/current/jobs/*` 清不掉子目錄**：Script A 用的是不帶 `-r` 的 `rm`，但 Script C
+  （`bmc_monitor.sh` 已於 2026-08-25 重新啟用，並加上 I2C 寫入/讀回圖樣測試。）
+- **`rm /host/hw-eval/jobs/*` 清不掉子目錄**：Script A 用的是不帶 `-r` 的 `rm`，但 Script C
   是 `cp -r` 那個目錄，代表裡面可能有子目錄。清不乾淨的話，上一輪的 job log 會被當成這輪的一起
   複製到 USB。要確認 `bgctl` 的產出結構，必要時改成 `rm -rf .../jobs/*`。
+- **100G PRBS 尚未接進 A/B/C**：`port_prbs_monitor.sh` 已隨包交付、可手動執行，但三支腳本裡的呼叫
+  都還註解著（bring-up 中）。要啟用時記得 PRBS 期間 link 會顯示 down，`stop` 之後才會回來。
+- **Script C 的 USB 掛載走 `mount` 而非 `usb_target.sh -o mnt`**：目前是 `-o dev` 取節點再自己
+  `mount <dev> /mnt/usb`，繞過了工具內建的 `mkdir -p`、exfat/ntfs `modprobe` 與可寫性驗證。
+  掛載點不存在、檔案系統模組沒載、或媒體唯讀時只會失敗一行，job log 就沒帶出來。
 - **風扇確認提示是無限等待**：`wait "Set all configured fan channels to"` 之後才 `sendln "y"`；
   若該版 `fan-speed-control.sh` 不再詢問（或字串改了），這個 `wait` 會永遠等下去，Script A 停在那裡
   且不報錯。加個 `timeout` + 分支會比較保險（記得還原 `timeout = 0`）。
-- **USB 掛載點未檢查**：Script C 直接 `cp -r ... /mnt/usb/`，`/mnt/usb` 沒掛載時只會失敗一行，
+- ✅ **TR518 已腳本化** —— `blanton_tr518.sh` V1.0.1（2026-08-28）。仍與 `blanton_traffic_linespeed`
-  整輪測試的 job log 就沒被帶出來。可在複製前先 `mountpoint -q /mnt/usb` 判斷。
+  互斥（兩者都會動 `port cd` loopback 與 L2 學習），檔頭與 help 都標了。剩下三件事：
+  `stop` 沒把 `l2 learn` / `test mode` 放回去（照 `TR518.txt` 的定義，旗標可開）；
+  **`sleep 120` 的方向還沒驗證** —— 若 `tr 518` 的流量是有時限的（參數含 `runtime=1`、
+  `CheckDataTime=200`），等 120 秒可能量到已經降下來的值，要上機比對 0s / 30s / 120s 三次；
+  TTL 尚未呼叫它。
+- **`blanton_ber.sh` 的 `sleep 30` 與 `BER_INTERVAL` 是兩處要同步改的數字**：Script C 寫死
+  `sendln "sleep 30"`，腳本預設 `BER_INTERVAL=30`。改一邊沒改另一邊，report 會讀到還沒累積完
+  一個 interval 的數字，而且不會有任何警告。
+- **`ce0` 的 ingress mirror 尚未上機驗證**：`mirror port ce0 Mode=Ingress DestPort=ce0` 這條路是
+  推論出來的（鏡像複本不受 egress filter 的 source-port knockout 限制），語法取自 DUT 的
+  `help mirror`，但**還沒證明硬體真的接受 destport == srcport**。驗證方式是隔 10 秒看兩次
+  `show c | grep POK.ce0`，數字有沒有繼續長 —— 光看 report 的 PASS 分不出來，因為一次性 burst
+  也是 TX==RX。不通的話備案是 `tr 518 PortList=268`。
+- **SWB 的 LTC2977 有兩條路可以到，目前工具兩條都在用**：`cb_pmbus_*`（CB FPGA F3 → pcimem）
+  是 `margin_init` / `margin_status` / `margin_set` 走的路；原生 i2c bus（Ch+7 = bus 13/14/15/16）
+  是 `margin_save blanton` 走的路。後者短很多 —— 不需要通道初始化、不需要 pcimem，
+  單一 `i2cset` 就到。若原生 bus 在這平台夠穩，整個 `TRANSPORT="swb"` 層其實可以退成
+  「bus 號不同的 i2c 路徑」，`_swb_*`、probe、semaphore、prescale 那整套都能拿掉。
+  要動之前得先確認：讀取（`margin_status` 的 LINEAR16 word read）是否也同樣可靠，
+  以及 kernel driver 有沒有搶著存取（`margin_save blanton` 帶 `-f` 就是為了繞過這件事）。
+- **`settings/` 裡 SWB0 與 SWB1 是兩份相同的資料**：8 個 `.conf` 中，SWB1 的四個除了 `CHIPS[]` 的
+  bus 與 `CB_I2C_CH` 之外，net name 與 `VNOM` 與 SWB0 逐欄相同（見 `docs/LTC2980_channel_map.csv`）。
+  改一邊忘了改另一邊不會有任何警告。可考慮改成「共用 net 定義 + 各自的 transport 覆寫」兩層檔案。
 - **Script C 沒有倒出 `mgmt_ping.log`**：C 會 `stop` 管理網路監控並印 `ip -s link show`，
   但沒有 `cat ~/Blanton_Script/log/mgmt_ping.log`，所以整個 soak 期間累積的 per-leg `RESULT`
   留在 DUT 上、沒進 master log。Script A 那輪基線有 `cat`。

CLAUDE.md

@@ -9,12 +9,22 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 
 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
-**目前狀態（2026-08-25）**：Script A 為 **V1.0.7**（A 集中記錄 A/B/C 三支的變更）。涵蓋
+**目前狀態（2026-08-30）**：Script A 為 **V1.1.3**（A 集中記錄 A/B/C 三支的變更）。涵蓋
 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` 指定。
+switch unit 數量由 `config.ttl` 的 `SWB_UNIT0` / `SWB_UNIT1` 宣告，風扇轉速由 `FAN_SPEED` 指定
-測試 job log 收在 DUT 的 `/host/hw-eval/current/jobs/`，Script C 結束時帶時戳複製到 `/mnt/usb/`。
+（預設 100 = 全速；soak 是熱測試，散熱不該是變因）。
-最後一次發布是 **V1.0.5**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。
+測試 job log 收在 DUT 的 `/host/hw-eval/jobs/`，Script C 結束時掛好 USB 再帶時戳複製到 `/mnt/usb/`。
+100G PRBS（`port_prbs_monitor.sh`）已隨包交付，但 **A/B/C 的呼叫仍註解掉**，還在 bring-up。
+Script B 的 soak 迴圈每輪印 `bgctl list` + `jobs`，並 `pause 60`（V1.0.10 之前完全沒有 pause）。
+V1.1.0 新增全機 SerDes BER 掃描（`blanton_ber.sh`，**Script C 已接**，依 `SWB_UNIT` 分支）、
+TR518 負載（`blanton_tr518.sh`，**TTL 尚未接**）、SWB 軌功耗（`TH6_SWB{0,1}_power_readback.sh`），
+線速流量也納入 100G `ce0`（VLAN 138，靠 ingress mirror 維持循環）。
+Script A 開頭會先收掉前一輪殘留（`hw-test-session finish` + `bgctl reset/stop --all`），
+再 `bgctl list` 確認沒有 job 留著佔資源。
+NFC tag 讀取由 `nfc_polling.sh` 背景輪詢（A 做基線、B 起、C 停並 report）。
+最後一次發布是 **V1.1.2**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。
+margin 的 `VNOM` 已於 2026-08-30 改為 Blanton 實測中位數（144 條軌中 86 條上調 0.8~2.5%）。
 交付用 `./publish/publish.sh` 打包。
 
 ## 技術棧
@@ -61,6 +71,14 @@ temp_all                           # CB + ICB 溫感
 pwr_data                           # SWB VRM 全軌
 margin_init Blanton_CB_CONN13 && margin_status
 
+# ── 電壓 margin 寫 NVM（⚠️ 永久，測試中絕不執行）─────
+margin_save                        # 只寫當前 margin_init 載入的那顆（2 個 LTC2977）
+margin_save all                    # settings/ 全部 9 顆；跑完自動切回原本載入的那顆
+margin_save blanton                # Blanton SONiC 捷徑：18 顆全走原生 i2c，不用 margin_init
+#   0x15 是 send-byte，不帶 data byte：i2cset -f -y <bus> <addr> 0x15
+#   bus = FPGA F3 通道 + 7 → Ch6=13, Ch7=14, Ch8=15, Ch9=16（CB 本來就是 bus 4）
+#   ⚠️ 沒裝滿的機器：改 margin.sh 頂端的 MARGIN_BLANTON_STORE，把沒有的板子註解掉
+
 # ── SWB loopback 流量（bcmcmd，unit 0/1）─────────────
 # 不帶 -u 就是預設 TL_UNITS="0 1"，兩塊 switch board 都做（TTL 三支腳本即如此）
 blanton_traffic_linespeed ps             # 對照線的 link/speed
@@ -85,13 +103,58 @@ chmod +x ~/Blanton_Script/*.sh               # 佈署後必做一次
 ~/Blanton_Script/mgmt_ping_monitor.sh stop
 ~/Blanton_Script/mgmt_ping_monitor.sh summary  # 只看每段的 RESULT 行
 #   ⚠️ tail 子命令是 tail -f，會卡住不返回；TTL 裡要倒 log 請用 cat
-#   ⚠️ bmc_monitor.sh / bmc_monitor_ddr.sh 已停用（改走 bgctl + bmc-manager），檔案仍在
+#   bmc_monitor.sh   start/stop         # free -m + BMC I2C 寫入/讀回圖樣測試，log/bmc_poll.log
+#   ⚠️ bmc_monitor_ddr.sh 已停用（DDR 壓力改走 bgctl + bmc-manager），檔案仍在
+
+# ── 100G PRBS（目前 TTL 未啟用，手動測用）────────────
+bash ~/Blanton_Script/port_prbs_monitor.sh start        # 兩個 port 同時
+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
+
+# ── 全機 SerDes BER（PRBS，期間 link 會顯示 DOWN）────
+./Blanton_Script/blanton_ber.sh init          # prbs set p=3 + prbs get（檢查每條 lane 鎖定）
+./Blanton_Script/blanton_ber.sh start         # prbsstat STArt Interval=30
+sleep 30                                      # 至少等一個 interval 再 report
+./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，要重測得再 init）
+#   -u 0 / -u 1 單邊；-c 1e-9 換門檻；-F 只列失敗；-f <log> 離線重解
+#   ⚠️ 不能跟 blanton_traffic_linespeed / blanton_tr518 同時跑（都會接管同一批 port）
+
+# ── TR518 負載 + 量功耗（TTL 尚未接）─────────────────
+./Blanton_Script/blanton_tr518.sh start       # 兩 unit，跑完 settle 120s
+./Blanton_Script/TH6_SWB0_power_readback.sh   # 19 條軌 V×I + TOTAL POWER
+./Blanton_Script/TH6_SWB1_power_readback.sh
+./Blanton_Script/blanton_tr518.sh stop        # 只送 port cd lb=none
+#   ⚠️ stop 不還原 l2 learn / test mode（TR_RESTORE_LEARN=1 / _TESTMODE=1 才會）
+
+# ── NFC tag 輪詢 ────────────────────────────────────
+~/Blanton_Script/nfc_polling.sh start      # 背景，start 會先清空 log
+~/Blanton_Script/nfc_polling.sh status     # pid、已跑幾輪、最後一筆結果
+~/Blanton_Script/nfc_polling.sh report     # PASS/FAIL/ERROR 統計，polling 中也能跑
+~/Blanton_Script/nfc_polling.sh tail 50    # 最後 50 行（不 follow，不會卡住）
+~/Blanton_Script/nfc_polling.sh stop
+#   log: ~/Blanton_Script/log/nfc_poll.log
+#   ERROR = 工具沒印出 [PASS]/[FAIL]（或逾時），跟「tag 讀不到」分開算
+#   NFC_INTERVAL_SEC / NFC_TIMEOUT_SEC / NFC_ARGS 可調（要每個子指令都帶）
+
+# ── USB 目標偵測 ────────────────────────────────────
+bash ~/Blanton_Script/usb_target.sh -o dev              # /dev/sdX1
+bash ~/Blanton_Script/usb_target.sh -o mnt              # 掛好並回傳掛載點
 
 # ── 背景壓力（平台工具）──────────────────────────────
 bgctl run /usr/sbin/memtester 1G 100
 bgctl list
 bgctl stop --all ; bgctl reset --yes
 
+# ── 通道對照表（開發機上跑，改完 settings/*.conf 一定要重產）──
+./tools/gen_channel_map.sh              # → docs/LTC2980_channel_map.csv（144 列）
+./tools/gen_channel_map.sh -            # 只印到 stdout
+#   ⚠️ 需要 gawk（用到 3 參數的 match()）；mawk 會直接擋下並提示
+
 # ── 各工具的 help ───────────────────────────────────
 blanton_fpga_help ; blanton_cb_i2c_help ; vi2c_help
 temp_sensor_help ; pwr_data_help ; blanton_traffic_linespeed_help
@@ -156,8 +219,19 @@ Tera Term 連 COM port (115200-8-N-1)
 - ⚠️ **ICB/PDB 一律走 VI2C（`blanton_icb_vi2c.sh`），不要走 VSPI**：VSPI ~18 ms/reg 會讓 I2C
   byte 相間隔拉到 ~50 ms，踩中 SMBus 25–35 ms timeout，裝置直接 NACK。實測全掃 9.4 s vs 34.0 s。
 - ⚠️ **I2C 讀一律 Repeated START**（不是 STOP + START），否則 PMBus/SMBus 裝置（VRM、EFUSE）不理。
+- ⚠️ **`settings/*.conf` 的 `VNOM` 是實測中位數，不是規格值**（2026-08-30 起）。它同時是
+  `margin_status` 偏差 % 的分母、也是 `margin_set` 推算 high/low/OV/UV 的基準，所以改它會
+  同時移動「看到的數字」和「實際打出去的電壓」。**跨這個日期的 margin log 不能直接互比。**
+- ⚠️ **SWB 的 margin profile 是 per-CONN 的**：`combo_SWB_CONN13~16_{high,low}` 各自的百分比
+  對應該片板子的軌。套到別的 CONN 會 margin 到錯的軌，而且**不會報錯**。CB 沒有專屬 profile，
+  用通用的 `combo_high3` / `combo_low3`
 - ⚠️ **`margin_save` / `STORE_USER_ALL` 會永久寫 NVM**，斷電保留 → **測試流程中絕不執行**，
   以免覆蓋客戶出廠 config。`margin.sh` 的 auto-enable（`ON_OFF_CONFIG=0x1a`）只改 RAM，斷電復原。
+  v2.7.0 新增的 **`margin_save all` / `margin_save blanton` 一次寫 18 個 LTC2977**，
+  同一個警告放大 9 倍；另外 `0x15` 現在送 send-byte，不再帶多餘的 `0x00` data byte。
+- ⚠️ **SWB 的 LTC2977 有兩條路可以到**：`cb_pmbus_*`（CB FPGA F3 Ch6/7/8/9 → pcimem）與
+  原生 i2c bus（`i2cset -f -y 13/14/15/16`，Ch+7 = bus）。`margin_save blanton` 走後者，
+  其餘功能走前者。同一顆晶片，**不要同時用兩條路**。
 - ⚠️ **改電壓會弄壞 DUT**：套 profile 前確認該軌 OV/UV limit，且 servo DAC 注入電阻有 populate
   （本板部分 margin 電阻標 PROTO，沒 populate 的軌電壓不會動，不是腳本壞掉）。
 - ⚠️ **`ARB_LOST` ≠ 有裝置**：`vi2c_scan` 只看 `RX_ACK`，仲裁失敗會被誤報成裝置存在。
@@ -186,6 +260,8 @@ Tera Term 連 COM port (115200-8-N-1)
 - ⚠️ **兩張管理網卡同網段會 ARP flux**：`mgmt_ping_monitor.sh` 讓 eth0/eth1 同時 up，同一個 /24 下
   對端 ARP 可能由任一張卡回應，回包落在沒送封包的那張。`ARP_STRICT=1` 擋掉；判讀時看 `RESULT` 行的
   `nic_tx`/`nic_rx`（該卡自己的 packet delta）—— **ping 成功但 `nic_tx` 接近 0 = 封包從另一張卡出去的**
+- ⚠️ **PRBS 跑起來時 `show interfaces status` 會顯示 DOWN**，那是 link 離開正常運作模式，不是故障。
+  `port_prbs_monitor.sh` 的 `start` 因此刻意不印 port status（避免測試員誤判），只在 `prbs clear` 之後的報表裡印
 - ⚠️ **`ip -s link` 的欄位順序是 `bytes packets errors ...`**，要 packet 數取的是**第 2 欄**不是第 1 欄
 - ⚠️ **`mgmt_ping_monitor.sh` / `bmc_monitor*.sh` 需要 exec bit**，且**不是改用 `bash x.sh start` 就能繞過** ——
   `do_start` 內部是 `setsid "$SCRIPT_PATH" __daemon`，直接執行該路徑。git 記錄是 `100644`，
@@ -199,6 +275,17 @@ Tera Term 連 COM port (115200-8-N-1)
   （版本改了、字串換了）就會永遠卡住且不報錯 —— 現場看起來像 Script A 當掉
 - ⚠️ **`show_dmesg.ttl` 結尾會 `dmesg -C` 清空 kernel ring buffer**。這是刻意的（讓 Script C 只看到
   soak 期間新產生的訊息），但代表事後在 DUT 上 `dmesg` 撈不到舊訊息 —— 內容只存在 master log 裡
+- ⚠️ **`bcmcmd` 的輸出是 CRLF**。`show c` 的計數器後面還跟著 delta，所以「砍掉第一個空白之後」
+  順便把 CR 砍掉了；但 `prbsstat Ber` 的 BER 是**整行最後一個 token**，CR 直接黏在數字上 ——
+  數字驗證會失敗（全變 NA），而且印出來時 CR 把游標拉回行首，後面的欄位會**覆蓋掉前面的欄位**。
+  寫新的 awk 解析器時，第一件事就是 `{ gsub(/\r/, "") }`（`blanton_ber.sh` V1.0.1 的教訓）
+- ⚠️ **`bcmcmd` 的 exit code 兩邊都不能信**：BCM shell 拒絕指令時它回 **0**
+  （`blanton_traffic_linespeed.sh` V0.3.1），而 `tr 518` 這種跑很久的指令會讓它 poll 逾時而回
+  **非 0**，但指令其實已經在跑（`polling socket timeout: Success`）。可靠的作法是**找成功的證據**
+  ——例如 `tr 518` 印出 `TR 518 TEST PARAMETERS` 才算收下（`blanton_tr518.sh` V1.0.1）
+- ⚠️ **交換晶片不會把封包從進來的那個 port 送回去**（source-port knockout）。所以單一 port 的
+  VLAN 打不出持續流量：`tx 100` 就是一趟來回然後結束。`ce0` 靠 **ingress mirror 打回自己**繞過
+  這個限制（鏡像複本不經過 egress filter），**且不 stop 就不會自己停**
 - ⚠️ **DUT 的 awk 對 `%d` 會夾到 INT32**（2147483647）。線速流量的計數器是 ~10¹² 量級，
   所以 awk 裡輸出大數一律用 `%.0f`（double 域，精確到 2⁵³）。`blanton_traffic_linespeed.sh`
   V0.4.1 已修；寫新的 awk 報表時要記得同一件事
@@ -206,10 +293,13 @@ Tera Term 連 COM port (115200-8-N-1)
 ## 資料夾說明
 
 - `src/Script_ABC_Blanton/` — 可執行內容（Tera Term 工作目錄；內含要 scp 到 DUT 的 `Blanton_Script/`）
-- `docs/` — 客戶 FPGA 規格、AER/EDAC 檢查依據、逐項 Status 表（最新為 `*_20260817.xlsx`）
+- `docs/` — 客戶 FPGA 規格、AER/EDAC 檢查依據、逐項 Status 表（最新為 `*_20260817.xlsx`）、
+  `LTC2980_channel_map.csv`（9 個 `settings/*.conf` 合併成 Board,CONN,Ch,NetName,Vnom 144 列，
+  查 net 對應哪片哪個 channel 用；**改 `.conf` 後要重跑產生**）
 - `tools/` — Host / 離線端：`bcm_mibpair_report_V1.1.0.py`（drivshell log → per-pair 報表）、
   `traffic_loopback_*.txt`（bcmcmd 原始指令表，`blanton_traffic_linespeed.sh` 是其 bash 版，
-  **改 loopback 線路時兩邊要同步**）
+  **改 loopback 線路時兩邊要同步**）、`100G_PRBS.txt` / `TR518.txt` / `fan_ctrl.txt`
+  （上機手貼用的原始指令；PRBS 已有 `.sh`，TR518 尚未腳本化）
 - `publish/` — `publish.sh`（打包工具，**進 git**）+ `Script_ABC_Blanton_<Ver>/` 產出（**gitignored**）
 - `secret/` — 🚫 gitignored（除 `README.md` 與 `*.example`）：DUT 帳密、per-unit BDF 覆寫、COM 設定
 - `For_AI/` — 🚫 gitignored：AI 協作素材（波形截圖、草稿筆記）

docs/LTC2980_channel_map.csv

@@ -0,0 +1,145 @@
+Board,CONN,Ch,NetName,Vnom
+CB,CONN13,CH0,V5P0_ALW,5.0
+CB,CONN13,CH1,V3P3_ALW,3.3
+CB,CONN13,CH2,PWR_VDD_MISC_ALW,0.75
+CB,CONN13,CH3,V1P8_ALW,1.8
+CB,CONN13,CH4,PWR_APU_VDDIO_SUS,1.1
+CB,CONN13,CH5,PWR_VDD_MISC_RUN,0.75
+CB,CONN13,CH6,PWR_APU_VDD_MEM_RUN,0.78
+CB,CONN13,CH7,V0P8_PHY2_DVDD,0.816
+CB,CONN13,CH8,V0P8_AVDD,0.8
+CB,CONN13,CH9,V0P8_PHY,0.8
+CB,CONN13,CH10,V1P8_FPGA,1.8
+CB,CONN13,CH11,V2P5_FPGA,2.5
+CB,CONN13,CH12,V1P1_FPGA,1.1
+CB,CONN13,CH13,P5V_STBY,5.0
+CB,CONN13,CH14,P3V3_STBY,3.3
+CB,CONN13,CH15,V0P8_PHY2_AVDD,0.816
+SWB0,CONN13,CH0,P0V75_DVDD_47,0.75
+SWB0,CONN13,CH1,P0V75_AVDD_47,0.756
+SWB0,CONN13,CH2,P1V5_AVDD_47,1.524
+SWB0,CONN13,CH3,P0V9_AVDD_47,0.915
+SWB0,CONN13,CH4,P1V8_1,1.816
+SWB0,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.38
+SWB0,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.38
+SWB0,CONN13,CH7,P1V8_3,1.816
+SWB0,CONN13,CH8,P1V8_DVDDIO_3,1.8
+SWB0,CONN13,CH9,P0V75_DVDD_39,0.75
+SWB0,CONN13,CH10,P0V75_AVDD_39,0.756
+SWB0,CONN13,CH11,P1V5_AVDD_39,1.524
+SWB0,CONN13,CH12,P0V9_AVDD_39,0.915
+SWB0,CONN13,CH13,PVDD1V5_2,1.5
+SWB0,CONN13,CH14,PVDD1V8_DUT,1.8
+SWB0,CONN13,CH15,PVDD_MDIO,1.2
+SWB0,CONN14,CH0,P0V75_AVDD_7,0.756
+SWB0,CONN14,CH1,P1V5_AVDD_7,1.524
+SWB0,CONN14,CH2,P0V9_AVDD_7,0.915
+SWB0,CONN14,CH3,P1V8_5,1.816
+SWB0,CONN14,CH4,P1V8_2,1.816
+SWB0,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.38
+SWB0,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.38
+SWB0,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.38
+SWB0,CONN14,CH8,PVDD1V5_TSC,1.516
+SWB0,CONN14,CH9,PVDD1V5_ANLG,1.516
+SWB0,CONN14,CH10,NC,-
+SWB0,CONN14,CH11,NC,-
+SWB0,CONN14,CH12,PVDD1V5_1,1.5
+SWB0,CONN14,CH13,NC,-
+SWB0,CONN14,CH14,P1V8_DVDDIO_1,1.8
+SWB0,CONN14,CH15,P0V75_DVDD_7,0.75
+SWB0,CONN15,CH0,P1V5_AVDD_55,1.524
+SWB0,CONN15,CH1,P0V9_AVDD_55,0.915
+SWB0,CONN15,CH2,P0V75_DVDD_63,0.75
+SWB0,CONN15,CH3,P0V75_AVDD_63,0.756
+SWB0,CONN15,CH4,P1V5_AVDD_63,1.524
+SWB0,CONN15,CH5,P0V9_AVDD_63,0.915
+SWB0,CONN15,CH6,PVDD3_3V_SYNTH_LDO_B3,3.38
+SWB0,CONN15,CH7,PVDD1V5_3,1.5
+SWB0,CONN15,CH8,P0V85_STBY,0.85
+SWB0,CONN15,CH9,P1V8_STBY,1.8
+SWB0,CONN15,CH10,NC,-
+SWB0,CONN15,CH11,P3V3_STBY,3.3
+SWB0,CONN15,CH12,PVDD0V9_2,0.91
+SWB0,CONN15,CH13,P0V75_DVDD_55,0.75
+SWB0,CONN15,CH14,P0V75_AVDD_55,0.756
+SWB0,CONN15,CH15,P1V8_DVDDIO_4,1.8
+SWB0,CONN16,CH0,PVDD1V5_0,1.5
+SWB0,CONN16,CH1,P1V8_4,1.816
+SWB0,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.38
+SWB0,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.38
+SWB0,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.38
+SWB0,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.38
+SWB0,CONN16,CH6,P3V3,3.327
+SWB0,CONN16,CH7,PVDD0_8V_T3,0.82
+SWB0,CONN16,CH8,P0V75_DVDD_1,0.75
+SWB0,CONN16,CH9,P0V75_AVDD_1,0.756
+SWB0,CONN16,CH10,P1V5_AVDD_1,1.524
+SWB0,CONN16,CH11,P0V9_AVDD_1,0.915
+SWB0,CONN16,CH12,PVDD0V9_0,0.915
+SWB0,CONN16,CH13,PVDD0V9_1,0.91
+SWB0,CONN16,CH14,PVDD0V9_3,0.915
+SWB0,CONN16,CH15,PVDD1V2_T3,1.224
+SWB1,CONN13,CH0,P0V75_DVDD_47,0.75
+SWB1,CONN13,CH1,P0V75_AVDD_47,0.756
+SWB1,CONN13,CH2,P1V5_AVDD_47,1.524
+SWB1,CONN13,CH3,P0V9_AVDD_47,0.915
+SWB1,CONN13,CH4,P1V8_1,1.816
+SWB1,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.38
+SWB1,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.38
+SWB1,CONN13,CH7,P1V8_3,1.816
+SWB1,CONN13,CH8,P1V8_DVDDIO_3,1.8
+SWB1,CONN13,CH9,P0V75_DVDD_39,0.75
+SWB1,CONN13,CH10,P0V75_AVDD_39,0.756
+SWB1,CONN13,CH11,P1V5_AVDD_39,1.524
+SWB1,CONN13,CH12,P0V9_AVDD_39,0.915
+SWB1,CONN13,CH13,PVDD1V5_2,1.5
+SWB1,CONN13,CH14,PVDD1V8_DUT,1.8
+SWB1,CONN13,CH15,PVDD_MDIO,1.2
+SWB1,CONN14,CH0,P0V75_AVDD_7,0.756
+SWB1,CONN14,CH1,P1V5_AVDD_7,1.524
+SWB1,CONN14,CH2,P0V9_AVDD_7,0.915
+SWB1,CONN14,CH3,P1V8_5,1.816
+SWB1,CONN14,CH4,P1V8_2,1.816
+SWB1,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.38
+SWB1,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.38
+SWB1,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.38
+SWB1,CONN14,CH8,PVDD1V5_TSC,1.516
+SWB1,CONN14,CH9,PVDD1V5_ANLG,1.516
+SWB1,CONN14,CH10,NC,-
+SWB1,CONN14,CH11,NC,-
+SWB1,CONN14,CH12,PVDD1V5_1,1.5
+SWB1,CONN14,CH13,NC,-
+SWB1,CONN14,CH14,P1V8_DVDDIO_1,1.8
+SWB1,CONN14,CH15,P0V75_DVDD_7,0.75
+SWB1,CONN15,CH0,P1V5_AVDD_55,1.524
+SWB1,CONN15,CH1,P0V9_AVDD_55,0.915
+SWB1,CONN15,CH2,P0V75_DVDD_63,0.75
+SWB1,CONN15,CH3,P0V75_AVDD_63,0.756
+SWB1,CONN15,CH4,P1V5_AVDD_63,1.524
+SWB1,CONN15,CH5,P0V9_AVDD_63,0.915
+SWB1,CONN15,CH6,PVDD3_3V_SYNTH_LDO_B3,3.38
+SWB1,CONN15,CH7,PVDD1V5_3,1.5
+SWB1,CONN15,CH8,P0V85_STBY,0.85
+SWB1,CONN15,CH9,P1V8_STBY,1.8
+SWB1,CONN15,CH10,NC,-
+SWB1,CONN15,CH11,P3V3_STBY,3.3
+SWB1,CONN15,CH12,PVDD0V9_2,0.91
+SWB1,CONN15,CH13,P0V75_DVDD_55,0.75
+SWB1,CONN15,CH14,P0V75_AVDD_55,0.756
+SWB1,CONN15,CH15,P1V8_DVDDIO_4,1.8
+SWB1,CONN16,CH0,PVDD1V5_0,1.5
+SWB1,CONN16,CH1,P1V8_4,1.816
+SWB1,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.38
+SWB1,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.38
+SWB1,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.38
+SWB1,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.38
+SWB1,CONN16,CH6,P3V3,3.327
+SWB1,CONN16,CH7,PVDD0_8V_T3,0.82
+SWB1,CONN16,CH8,P0V75_DVDD_1,0.75
+SWB1,CONN16,CH9,P0V75_AVDD_1,0.756
+SWB1,CONN16,CH10,P1V5_AVDD_1,1.524
+SWB1,CONN16,CH11,P0V9_AVDD_1,0.915
+SWB1,CONN16,CH12,PVDD0V9_0,0.915
+SWB1,CONN16,CH13,PVDD0V9_1,0.91
+SWB1,CONN16,CH14,PVDD0V9_3,0.915
+SWB1,CONN16,CH15,PVDD1V2_T3,1.224

docs/release-notes/v1.0.10.md

@@ -0,0 +1,56 @@
+# v1.0.10 — The soak loop stops spinning flat out, and shows you what is still running
+
+## ✨ New features
+
+**Every soak round now reports the background jobs**
+* Script B's monitoring loop prints `bgctl list` (platform jobs) and `jobs` (the login shell's own background jobs) on every pass, right after the platform data. A stress job that dies three hours into an overnight soak now shows up as a shorter list on the next round, instead of only being noticed at the end — or not at all.
+* The two lists answer different questions and are both worth having: `bgctl` knows about the platform's job runner, `jobs` knows about anything the macro backgrounded in that shell.
+
+**A single table for all 144 margin channels**
+* `docs/LTC2980_channel_map.csv` flattens the nine `settings/*.conf` files into one sheet — `Board,CONN,Ch,NetName,Vnom` — so "which board and channel is `PVDD1V5_TSC` on?" is one search instead of opening nine files.
+* `tools/gen_channel_map.sh` regenerates it. **The CSV is output, not source**: edit the `.conf` files and re-run the script, never the other way round.
+* Unused channels stay in the table as `NC` / `-` rather than being dropped, because the channel number is also the PMBus page (`ch / 8` picks the chip, `ch % 8` picks the page) — filtering the gaps out would shift everything after them.
+
+**The bench command lists that these scripts came from**
+* `tools/100G_PRBS.txt`, `tools/TR518.txt` and `tools/fan_ctrl.txt` join the existing `traffic_loopback_*.txt` set: the raw `bcmcmd` / sysfs sequences, kept in the form you can paste into a console when a script is misbehaving and you want to drive the hardware directly.
+
+## 🐛 Bug fixes
+
+**The soak loop ran as fast as the DUT could answer**
+* `while 1` had no pause at all, so each round started the moment the previous one finished. Over a long soak that means constant console traffic and a log full of near-identical samples taken seconds apart. The loop now ends each round with `pause 60`.
+* Note the gap this leaves: the Status sheet asks for a 10-minute sampling interval, and 60 seconds is still hard-coded rather than configurable. This makes the loop sane, it does not finish the job.
+
+**A comment promised a cadence the code never had**
+* The loop was labelled `Get data every 10mins` while running with no delay whatsoever. It now says what it does.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.0.10.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`mgmt_ping_monitor.sh` and `port_prbs_monitor.sh` launch their workers through `bash`, so those two run without the execute bit. `bmc_monitor.sh` and `usb_target.sh` still need it, and neither git (mode 100644) nor a Windows/USB copy carries it. Without the `chmod`, `start` fails with `Permission denied` and the later `cat` finds nothing: **the section ends up empty and nothing reports an error.**
+
+## ⚠️ Before you run
+
+* **Declare the switch population.** `SWB_UNIT0` / `SWB_UNIT1` in `config.ttl` say which switch units this DUT has; traffic and the readiness gate both follow them.
+* **Set `FAN_SPEED`.** It is applied at the start of every run.
+* **Management connectivity is in use, not preserved.** Both management NICs are up and pinging — drive the run from the serial console.
+* **PRBS is still not wired into the macros.** Run `port_prbs_monitor.sh` by hand if you want it; the calls in A/B/C remain commented out, unchanged from v1.0.9.
+* **TR518 and the loopback traffic test cannot both run.** `tools/TR518.txt` sets `port all lb=mac` and `l2 learn off` across the whole unit, which is the same hardware `blanton_traffic_linespeed` is using. Pick one.
+* **Two settings persist to `config_db.json`** and survive a reboot: LLDP is left disabled and the 100G uplinks are left configured. Restore them before the DUT moves on.
+
+## 🔗 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
+* [LTC2980_channel_map.csv](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/src/branch/main/docs/LTC2980_channel_map.csv) — all 144 margin channels
+
+**Full changelog:** [V1.0.9...V1.0.10](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.0.9...V1.0.10)

docs/release-notes/v1.0.11.md

@@ -0,0 +1,59 @@
+# v1.0.11 — Saving the margin settings to NVM is now one command, and the command is correct
+
+## ✨ New features
+
+**`margin_save blanton` — all 18 LTC2977 in one go**
+* On this platform the CB FPGA's I2C channels are also exposed as ordinary Linux i2c buses, so every margin controller on the box — CB and both switch boards — can be reached with plain `i2cset`. `margin_save blanton` walks all 18 of them from one flat list: no `margin_init`, no FPGA channel setup, no `pcimem`.
+* The channel-to-bus mapping it relies on (F3 Ch6 → bus 13, Ch7 → 14, Ch8 → 15, Ch9 → 16; CB is bus 4 as before) is now written down in `ARCHITECTURE.md` and the margin README, not just known at the bench.
+* **A partly-populated DUT is a normal build.** Comment out the lines you do not have in `MARGIN_BLANTON_STORE` at the top of `margin.sh` rather than letting the tool talk to boards that are not there.
+* Missing bus and unresponsive chip are reported as two different failures. `/dev/i2c-16 does not exist` means the FPGA's i2c adapters did not enumerate; `i2cset failed (NACK/busy)` means the board is absent or the address is wrong. Chasing the second when you have the first wastes an afternoon.
+
+**`margin_save all` — every board in `settings/`**
+* Runs `margin_init` + `margin_save` across all nine boards, then puts back whichever board you had loaded, so a following `margin_status` still reports the board you were looking at.
+* It does not stop at the first failure: a half-saved set is harder to reason about than a fully-attempted one. The summary names the boards that failed.
+
+Both print a per-chip line and a `N saved, M failed` tally, and both return a non-zero exit code when anything failed.
+
+**The fans now default to full speed**
+* `FAN_SPEED` in `config.ttl` is 100 instead of 30. A soak is a thermal test of everything *except* the cooling, so the cooling should not be a variable in it — and a DUT that throttles halfway through a run produces results that look like a different fault. Lower it deliberately if quiet operation is what you are measuring.
+
+## 🐛 Bug fixes
+
+**A failed NVM write still reported success**
+* `margin_save` discarded the result of every write, so a NACK printed `Change Saved` exactly like a successful store. For the one operation in this tool that is permanent, that is the worst place to stay quiet. Each store is now checked and named if it fails.
+
+**`STORE_USER_ALL` was sent with a data byte it should not have**
+* The command went out as `0x15` followed by a dummy `0x00` — an SMBus write-byte, where `STORE_USER_ALL` is a send-byte. The LTC2977 tolerated it, but tolerance is not correctness. It is now `i2cset ... 0x15 c` on the native path and a no-data `cb_pmbus_write` on the FPGA path.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.0.11.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`mgmt_ping_monitor.sh` and `port_prbs_monitor.sh` launch their workers through `bash`, so those two run without the execute bit. `bmc_monitor.sh` and `usb_target.sh` still need it, and neither git (mode 100644) nor a Windows/USB copy carries it. Without the `chmod`, `start` fails with `Permission denied` and the later `cat` finds nothing: **the section ends up empty and nothing reports an error.**
+
+## ⚠️ Before you run
+
+* **`margin_save` in any form writes NVM permanently.** A power cycle does not undo it. `margin_save all` and `margin_save blanton` do it to all 18 controllers at once. Run `margin_status_all.sh` first and never call any of them during a test run — the macros do not, and should not be made to.
+* **The 18 raw commands were verified on the DUT; the wrapper was not.** `margin_save blanton` issues exactly the sequence that was run by hand at the bench, and the packaging was tested against stubbed hardware, but the function itself has not been run on a DUT yet. Watch the per-chip lines the first time.
+* **Declare the switch population.** `SWB_UNIT0` / `SWB_UNIT1` in `config.ttl` say which switch units this DUT has; traffic and the readiness gate both follow them.
+* **`FAN_SPEED` is now 100.** It is applied at the start of every run, so this build runs the fans flat out unless you change `config.ttl`. Expect the noise.
+* **Management connectivity is in use, not preserved.** Both management NICs are up and pinging — drive the run from the serial console.
+* **PRBS is still not wired into the macros.** Run `port_prbs_monitor.sh` by hand if you want it; the calls in A/B/C remain commented out.
+* **Two settings persist to `config_db.json`** and survive a reboot: LLDP is left disabled and the 100G uplinks are left configured. Restore them before the DUT moves on.
+
+## 🔗 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
+* [LTC2980_Margin_Script/README.md](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/src/branch/main/src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/README.md) — the three `margin_save` variants and what each one sends
+
+**Full changelog:** [V1.0.10...V1.0.11](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.0.10...V1.0.11)

docs/release-notes/v1.0.8.md

@@ -0,0 +1,61 @@
+# v1.0.8 — Both management links tested at once, and ARP stops looking like packet loss
+
+## ✨ New features
+
+**Both management NICs are pinged simultaneously and continuously**
+* `mgmt_ping_monitor.sh` no longer alternates fixed bursts. `start` configures both NICs, then pings from each at the same time and keeps accumulating until stopped — so a soak-long run is one continuous measurement rather than a series of snapshots.
+* `stop` renders a report into the log: the last 20 entries per NIC, each one's ping statistics and PASS/FAIL, then `ip -s link show` for both interfaces.
+* Every line is timestamped, and a request that got no reply prints a marker instead of merely being absent — a drop is visible in the tail, not inferred from a gap in the sequence numbers.
+* `status` shows both pids and how many replies each NIC has received so far, which is the quick way to see one side is dead without waiting for the report.
+
+**The USB stress target is detected, not assumed**
+* New `usb_target.sh` reports an inserted USB device's node, mount point or by-id path. Script B asks it for the node and builds the stress command from the answer, so a stick that enumerates as `sdb` no longer sends a write test at whatever `/dev/sda1` happens to be.
+* It excludes whatever disk backs `/` and `/host` — this platform can boot from a USB DOM, which also reports as USB — refuses to guess when several USB disks are present, and when it mounts, verifies the result is actually writable rather than trusting that `mount` succeeded.
+
+**BMC I2C integrity is exercised through the soak**
+* `bmc_monitor.sh` is back in the run and now writes two complementary patterns to a BMC scratch register and reads each back. One pattern alone cannot catch a bit stuck the same way it was written; repeating the pair through the soak turns an intermittent I2C fault into something the log records rather than something the tester has to witness.
+
+**Test artefacts leave the DUT with the run**
+* Script C copies `bmc_poll.log` and `mgmt_ping.log` into the job directory before it is archived to USB, so the monitors' output travels with the `bgctl` job logs.
+* DDR stress now runs continuously instead of stopping after 100 passes, matching the other soak loads.
+
+## 🐛 Bug fixes
+
+**Three FAILs that were not link faults**
+* A bench run reported `FAIL=3` with zero NIC errors, zero drops and sub-millisecond replies. Every failure was missing exactly `icmp_seq=1` and nothing else: once the neighbour entry for the target expires, the first echo request is spent resolving ARP and `ping` counts it as loss. A discarded warm-up ping per NIC now absorbs that, which is what lets the loss threshold stay at zero and still mean something. Raising the threshold instead would have hidden genuine single-packet loss.
+
+**Job logs were being cleared before they were collected**
+* Script C ran `bgctl reset --yes` while killing processes — before the job directory is copied to USB. Moved to after the archive, so a run's own logs are collected before anything clears them.
+
+**The fan controller was bound twice**
+* One of the two MAX31790 controllers received a second `bind` immediately after the first, which could only fail because the driver was already attached.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.0.8.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`mgmt_ping_monitor.sh` no longer re-execs itself, so `bash mgmt_ping_monitor.sh start` works without the execute bit. `bmc_monitor.sh` and `usb_target.sh` still need it — and neither git (mode 100644) nor a Windows/USB copy carries it. Without the `chmod`, `start` fails with `Permission denied` and the later `cat` finds nothing: **the section ends up empty and nothing reports an error.**
+
+## ⚠️ Before you run
+
+* **Declare the switch population.** `SWB_UNIT0` / `SWB_UNIT1` in `config.ttl` say which switch units this DUT has. Traffic and the readiness gate both follow them; with neither set the traffic stage is skipped rather than failing against hardware that is not there.
+* **Set the fan speed you want.** `FAN_SPEED` in `config.ttl` is applied at the start of every run.
+* **Management connectivity is in use, not preserved.** Both NICs are up and pinging — drive the run from the serial console.
+* **If the two management NICs share a subnet, keep `ARP_STRICT=1`.** Otherwise the target's ARP can be answered by either NIC and a reply may arrive on the one that did not send. Check `nic_tx` / `nic_rx` on the RESULT line: they are that interface's own counter delta.
+* **Two settings persist to `config_db.json`** and survive a reboot: LLDP is left disabled and the 100G uplinks are left configured. Restore them before the DUT moves on.
+
+## 🔗 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.0.7...V1.0.8](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.0.7...V1.0.8)

docs/release-notes/v1.0.9.md

@@ -0,0 +1,63 @@
+# v1.0.9 — 100G PRBS testing, and the job logs actually reach the USB stick
+
+## ✨ New features
+
+**100G uplink PRBS test**
+* New `port_prbs_monitor.sh` drives a PRBS test on both 100G uplinks: it clears low-power mode, arms the pattern, then polls `phy diag <phy> prbs get` in the background until stopped. A poll counts as PASS only when the output says `PRBS OK!`; `prbsstat Ber` is captured alongside every poll for the record.
+* `stop` runs `prbsstat STOp` and `prbs clear` on each port before rendering the report, so the test does not leave PRBS armed behind it.
+* `report` gives the tally the bench actually wants:
+
+  ```
+  PORT           POLLS    PASS     FAIL     RESULT
+  Ethernet513    42       42       0        PASS
+  Ethernet514    42       40       2        FAIL
+  ```
+* **One port at a time is a first-class mode.** `start a` or `start b` runs a single uplink, which is how you separate a genuine port fault from the DUT not coping with two PRBS streams at once. A port that was not run reports `SKIP`, not `FAIL`.
+* Every command and its full output — setup, each poll, teardown — goes to that port's raw log.
+
+> ⚠️ The script ships in this build and can be run by hand, but **the calls in Script A, B and C are commented out**: PRBS is still under bring-up on this platform.
+
+**USB target detection**
+* `usb_target.sh` reports an inserted USB device's node, mount point or by-id path. It excludes whatever disk backs `/` and `/host` — this platform can boot from a USB DOM, which also reports as USB — refuses to guess when several USB disks are present, and when mounting, verifies the result is writable rather than trusting that `mount` succeeded.
+* Script B builds the USB stress command from the detected node instead of a hard-coded `/dev/sda1`.
+
+## 🐛 Bug fixes
+
+**The job logs were being written to a path nobody collected**
+* Stress output, the monitors' logs and the USB archive disagreed about where the job directory lives. Everything now uses `/host/hw-eval/jobs/`, so what Script B writes is what Script C copies out.
+
+**Script C copied to a USB that was never mounted**
+* The archive step assumed `/mnt/usb` was ready. Script C now finds the device and mounts it first, so a run's logs leave the DUT instead of being written into an empty mount point.
+
+**`show interfaces status` right after starting PRBS reads as a failure**
+* With PRBS armed the link is out of normal operation and reports DOWN. `port_prbs_monitor.sh` deliberately does not print the port status at `start` — it appears in the report instead, after `prbs clear`, labelled as the recovered state.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.0.9.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`mgmt_ping_monitor.sh` and `port_prbs_monitor.sh` launch their workers through `bash`, so those two run without the execute bit. `bmc_monitor.sh` and `usb_target.sh` still need it, and neither git (mode 100644) nor a Windows/USB copy carries it. Without the `chmod`, `start` fails with `Permission denied` and the later `cat` finds nothing: **the section ends up empty and nothing reports an error.**
+
+## ⚠️ Before you run
+
+* **Declare the switch population.** `SWB_UNIT0` / `SWB_UNIT1` in `config.ttl` say which switch units this DUT has; traffic and the readiness gate both follow them.
+* **Set `FAN_SPEED`.** It is applied at the start of every run.
+* **Management connectivity is in use, not preserved.** Both management NICs are up and pinging — drive the run from the serial console.
+* **PRBS is not wired into the macros yet.** Run `port_prbs_monitor.sh` by hand if you want it; uncommenting the calls in A/B/C is not supported in this build.
+* **Two settings persist to `config_db.json`** and survive a reboot: LLDP is left disabled and the 100G uplinks are left configured. Restore them before the DUT moves on.
+
+## 🔗 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.0.8...V1.0.9](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.0.8...V1.0.9)

docs/release-notes/v1.1.0.md

@@ -0,0 +1,81 @@
+# v1.1.0 — BER, power under load, and a 100G port that actually keeps sending
+
+## ✨ New features
+
+**Whole-switch SerDes BER sweep**
+* New `blanton_ber.sh` runs PRBS across every cabled port and reports the bit error rate lane by lane. `init` → `start` → wait → `report` → `stop` → `clear`, with `-u 0` / `-u 1` for a single switch unit.
+* **A lane passes only when its BER is below 1e-6.** Equal to the threshold is a FAIL, not a pass. `-c <ber>` sets a different bar.
+* `report` ends with a summary across both units, and each unit's row carries its **worst lane** — so a run where everything passes still tells you how much margin there was:
+
+  ```
+  Unit        LANES     PASS     FAIL       NA  WORST BER    WORST LANE RESULT
+  unit 0        432      432        0        0  1.98e-08     203[0]     PASS
+  unit 1        432      432        0        0  6.34e-10     366[1]     PASS
+  ```
+* `init` also checks that every lane locked. This matters: an unlocked lane still reports a BER later, and it is a meaningless one. Without the check, a dead lane can report a beautiful number and pass.
+* A lane whose reading is not a number is `NA` — counted separately from `FAIL`, because "not measured" and "measured and bad" are different problems.
+* Script C runs the sweep after the traffic report, following `SWB_UNIT0` / `SWB_UNIT1` the same way the traffic block does.
+
+**TR518 load test, for measuring power under traffic**
+* New `blanton_tr518.sh` puts the cd ports in loopback and runs the built-in `tr 518` packet test, then waits `TR_SETTLE_SEC` (120s by default) before handing back — so the power figures you take afterwards are loaded and settled, not caught mid-ramp.
+* `-u 0` / `-u 1` for one unit; no flag runs both.
+* `stop` sends `port cd lb=none` and nothing else, which is exactly what the bench procedure does. **L2 learning and test mode are left as `start` set them** — the tool says so on every `stop` rather than quietly leaving the box in a state you did not ask about. `TR_RESTORE_LEARN=1` / `TR_RESTORE_TESTMODE=1` if you want a true inverse.
+
+**Per-rail power readback for both switch boards**
+* `TH6_SWB0_power_readback.sh` / `TH6_SWB1_power_readback.sh` report V × I and total power for the 19 rails on each board.
+
+## 🐛 Bug fixes
+
+**The power readback measured every rail at a different moment**
+* It ran `show platform voltage` and `show platform current` once *per rail* — 38 invocations of a slow CLI, and 38 different instants. Under load the currents move a lot (`TH6_CORE` was seen going from 186 A to 636 A), so the "total" was a sum of readings taken seconds apart. Both tables are now read once, up front. Same output, one moment.
+* A rail missing from the sensor table used to contribute a silent `0.000 V / 0.00 W` to the total. It now says so on stderr; the printed report format is unchanged.
+
+**The 100G port stopped sending after one round trip**
+* `ce0` has no loopback partner, and a switch never forwards a frame back out the port it arrived on — so a `tx` burst went out, came back, and was dropped. TX 100, RX 100, silence. That measures the link; it does not exercise it.
+* `init` now sets an ingress mirror of `ce0` back to itself. The mirrored copy is not egress-filtered, so each packet keeps lapping and the load is set by how much you inject (`-tx`). **`stop` is what ends it** — removing the VLAN membership does not, because the mirrored copy never consulted the VLAN.
+
+**The 100G verdict was being decided the wrong way**
+* `ce0` was treated as a cross-unit check. The bench says otherwise: there is one `ce0` per unit and a burst sent on unit 0 alone came back on unit 0. It is now judged within its own unit. The distinction is invisible while everything works and decisive when it does not — read as cross-unit, *both* links dying still leaves `unit0.TX == unit1.RX` (0 == 0) and reports PASS.
+
+**Every BER lane reported `NA`, and the Port column printed `NA` too**
+* `bcmcmd` returns CRLF, and the BER is the last token on its line, so the carriage return stayed glued to the number: it failed the numeric check, and printing it sent the cursor back to column 1 so the RESULT column overwrote the start of the row. Both symptoms, one stray `\r`.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.1.0.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`blanton_ber.sh` is invoked by Script C as `./Blanton_Script/blanton_ber.sh`, so it joins `bmc_monitor.sh` and `usb_target.sh` in needing the execute bit — and neither git nor a Windows/USB copy carries it reliably. Without the `chmod` the BER section fails with `Permission denied` and the log simply has no BER in it.
+
+## ⚠️ Before you run
+
+* **These three tests cannot share the switch.** `blanton_ber.sh`, `blanton_tr518.sh` and `blanton_traffic_linespeed` all take over port loopback and L2 learning. Run one at a time; Script C already orders BER after the traffic report.
+* **PRBS takes the links down.** While `blanton_ber.sh` is armed the ports report DOWN and no traffic passes. That is the test working, not a fault. `clear` releases them.
+* **`ce0` keeps running until you stop it.** If a run is interrupted between `start` and `stop`, the 100G port stays saturated with nothing in `show interfaces status` to hint at it. `blanton_traffic_linespeed stop` (or `bcmcmd -n <u> -c 'mirror port ce0 Mode=Off'`) ends it.
+* **Two numbers must stay in step**: Script C's `sleep 30` and `blanton_ber.sh`'s `BER_INTERVAL`. Change one without the other and `report` reads an interval that has not finished accumulating — with no warning.
+* **`FAN_SPEED` is 100.** This build runs the fans flat out unless you change `config.ttl`.
+* **Declare the switch population** with `SWB_UNIT0` / `SWB_UNIT1`; traffic, the readiness gate and now the BER sweep all follow it.
+* **PRBS on the two 100G uplinks (`port_prbs_monitor.sh`) is still not wired into the macros.** Unchanged from v1.0.9.
+
+## 🔬 Not yet verified on hardware
+
+Three things in this build were reasoned out rather than measured, and each has a one-command check:
+
+* **The `ce0` ingress mirror.** `mirror port ce0 Mode=Ingress DestPort=ce0` should make the port circulate, but the hardware may refuse a mirror destination equal to its source. Check `show c | grep POK.ce0` twice ten seconds apart — the number must climb. The report cannot tell you: a one-shot burst is also `TX == RX` and also says PASS. Fallback is `tr 518 PortList=268`.
+* **The 120s settle in `blanton_tr518.sh`.** If `tr 518`'s traffic is time-limited (its parameters include `runtime=1`, `CheckDataTime=200`), waiting 120s could mean measuring after the load has already dropped. Compare a power readback at 0s, 30s and 120s.
+* **`test mode nr=no`** in `blanton_tr518.sh` is the derived inverse of the `nr=yes` that `start` sends; it is not part of the bench-verified sequence, and is off by default.
+
+## 🔗 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.0.11...V1.1.0](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.0.11...V1.1.0)

docs/release-notes/v1.1.1.md

@@ -0,0 +1,42 @@
+# v1.1.1 — A run no longer inherits the last one's leftovers
+
+## 🐛 Bug fixes
+
+**A previous run's jobs and session survived into the next one**
+* Script A now clears the box before it starts: `hw-test-session finish`, `bgctl reset --yes`, `bgctl stop --all`, then `bgctl list` so you can see it came back empty.
+* This matters after a run that ended badly — a closed Tera Term window, a DUT reboot mid-soak, a macro stopped by hand. The stress jobs kept running and the session stayed open, so the next run started on a box that was already loaded. Nothing failed; the numbers were just quietly wrong, and the only hint was a `bgctl list` nobody was reading.
+* The `bgctl list` at the end is the point of the sequence, not decoration: it is the one line in the log that proves the DUT was idle when the run began.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.1.1.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`blanton_ber.sh` is invoked by Script C as `./Blanton_Script/blanton_ber.sh`, so it needs the execute bit along with `bmc_monitor.sh` and `usb_target.sh` — and neither git nor a Windows/USB copy carries it reliably. Without the `chmod` the BER section fails with `Permission denied` and the log simply has no BER in it.
+
+## ⚠️ Before you run
+
+* **`hw-test-session finish` at the start will complain if no session is open.** That is expected on a fresh DUT and does not stop the run.
+* **These three tests cannot share the switch.** `blanton_ber.sh`, `blanton_tr518.sh` and `blanton_traffic_linespeed` all take over port loopback and L2 learning. Script C already orders BER after the traffic report.
+* **PRBS takes the links down** while `blanton_ber.sh` is armed. That is the test working, not a fault.
+* **`ce0` keeps running until you stop it.** If a run is interrupted between `start` and `stop`, the 100G port stays saturated with nothing in `show interfaces status` to hint at it.
+* **Two numbers must stay in step**: Script C's `sleep 30` and `blanton_ber.sh`'s `BER_INTERVAL`.
+* **`FAN_SPEED` is 100** — the fans run flat out unless you change `config.ttl`.
+* **Declare the switch population** with `SWB_UNIT0` / `SWB_UNIT1`.
+* **PRBS on the two 100G uplinks (`port_prbs_monitor.sh`) is still not wired into the macros.**
+* **The three items listed as unverified in v1.1.0 are still unverified**: the `ce0` ingress mirror, the 120s settle in `blanton_tr518.sh`, and `test mode nr=no` on stop. See [v1.1.0](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/releases/tag/V1.1.0) for the one-command check on each.
+
+## 🔗 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.1.0...V1.1.1](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.1.0...V1.1.1)

docs/release-notes/v1.1.2.md

@@ -0,0 +1,63 @@
+# v1.1.2 — NFC tag reads are now watched for the whole soak, not sampled once
+
+## ✨ New features
+
+**Background NFC polling**
+* New `nfc_polling.sh` runs `blantons_nfc_validate.py` over and over in the background and keeps score. `start` / `stop` / `status` / `tail` / `report` / `clear` / `fg`.
+* **`report` works while the poll is still running.** It only reads the log, so it never disturbs the run — and it labels itself `RUNNING` so a mid-soak snapshot is not mistaken for the final answer:
+
+  ```
+  state    : RUNNING (pid=2240323) -- this is a snapshot, the count is still moving
+  rounds   : 240
+  PASS     : 238
+  FAIL     : 2
+  ERROR    : 0   (tool did not produce a verdict)
+  RESULT   : FAIL
+
+  --- tags seen ---
+    046F7BD2142290       238
+  ```
+* **`ERROR` is counted apart from `FAIL`.** A round where the tool printed neither `[PASS]` nor `[FAIL]` — it crashed, the file was missing, it hung past the timeout — did not measure anything. That is a different problem from a tag that would not read, and rolling the two together hides whichever one you are not looking for.
+* `report` also lists which NFCID1s were seen and how often, and the last ten failures with their timestamps and reasons.
+* `start` clears the log first, so a report always describes the run you just did rather than everything since the DUT was built.
+* Script A takes a 30-second NFC baseline, Script B starts the poll for the soak, Script C stops it with the other monitors and reports.
+
+## 🐛 Bug fixes
+
+**The NFC log never reached the USB stick**
+* Script C copied `nfc_polling.log`; the file is `nfc_poll.log`. The `cp` failed, nothing checked it, and the run finished looking fine — you would only notice back at the desk with a job archive that had no NFC log in it.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.1.2.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`blanton_ber.sh` and `nfc_polling.sh` are invoked by the macros through `./` or `~/`, so they need the execute bit along with `bmc_monitor.sh` and `usb_target.sh` — neither git nor a Windows/USB copy carries it reliably. `blantons_nfc_validate.py` does **not** need it: `nfc_polling.sh` calls it through `python3` precisely so one more `chmod` cannot be forgotten.
+
+## ⚠️ Before you run
+
+* **`nfc_polling.sh start` clears the log.** Script B starts a fresh poll for the soak, which wipes Script A's baseline log — the baseline numbers are already in the master console log by then, but the file is gone.
+* **NFC log path is `~/Blanton_Script/log/nfc_poll.log`** and it is copied into the job directory by Script C for the USB archive.
+* **These three tests cannot share the switch.** `blanton_ber.sh`, `blanton_tr518.sh` and `blanton_traffic_linespeed` all take over port loopback and L2 learning. Script C already orders BER after the traffic report.
+* **PRBS takes the links down** while `blanton_ber.sh` is armed. That is the test working, not a fault.
+* **`ce0` keeps running until you stop it.** An interrupted run leaves the 100G port saturated with nothing in `show interfaces status` to hint at it.
+* **Two numbers must stay in step**: Script C's `sleep 30` and `blanton_ber.sh`'s `BER_INTERVAL`.
+* **`FAN_SPEED` is 100** — the fans run flat out unless you change `config.ttl`.
+* **Declare the switch population** with `SWB_UNIT0` / `SWB_UNIT1`.
+* **PRBS on the two 100G uplinks (`port_prbs_monitor.sh`) is still not wired into the macros.**
+* **The three items listed as unverified in v1.1.0 are still unverified**: the `ce0` ingress mirror, the 120s settle in `blanton_tr518.sh`, and `test mode nr=no` on stop. See [v1.1.0](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/releases/tag/V1.1.0) for the one-command check on each.
+
+## 🔗 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.1.1...V1.1.2](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.1.1...V1.1.2)

docs/release-notes/v1.1.3.md

@@ -0,0 +1,59 @@
+# v1.1.3 — Margin now measures against what this platform actually runs at
+
+## ✨ New features
+
+**Per-CONN margin profiles for the switch boards**
+* `combo_SWB_CONN13_high` / `_low` through `combo_SWB_CONN16_high` / `_low` replace the old `comboA` / `comboB` pair. Each file's per-channel percentages follow the rails on *that* board, so a CONN13 profile is no longer a rough fit for CONN16.
+* SWB0 and SWB1 share a profile per CONN — the two boards carry identical rails and differ only by I2C bus.
+* A high pass and a low pass are now the same run with `_high` swapped for `_low`.
+* **A profile applied to the wrong CONN margins the wrong rails and says nothing.** The percentages are positional, so nothing detects the mismatch. `margin_apply_profile_all.sh` now names the right profile per board instead of one name for all nine.
+
+## 🐛 Bug fixes
+
+**`VNOM` was the spec value, not what the rails actually sit at**
+* 86 of the 144 channels moved up between +0.8% and +2.5% to the measured median for this platform — `PVDD3_3V_SYNTH_LDO_*` 3.3 → 3.38, `P0V9_AVDD_*` 0.9 → 0.915, `PVDD0_8V_T3` 0.8 → 0.82, and so on.
+* **This is not a display change.** `VNOM` is the denominator of `margin_status`'s deviation %, *and* the basis `margin_set` derives high / low / OV / UV from. A rail sitting steady at 0.756 V used to read `+0.80%` against a nominal 0.75 and now reads `0.00%`; and asking for `+3%` now lands on a different absolute voltage than it did last week.
+* **Margin logs from before and after this build cannot be compared directly.** The numbers moved because the reference moved, not because the hardware did.
+
+**The batch profile script pointed at files that no longer exist**
+* `margin_apply_profile_all.sh` still named `comboA` for all nine boards. With `comboA.conf` removed, every board would have stopped at `Profile not found` — a nine-line wall of errors on a script that is normally left to run.
+
+**The channel map CSV was stale**
+* `docs/LTC2980_channel_map.csv` is generated from `settings/*.conf`, so all 86 changed rails were wrong in it. Regenerated with `tools/gen_channel_map.sh`. It is output, not source — regenerate it, never hand-edit it.
+
+## 📦 Downloads
+
+| File | Contents |
+|---|---|
+| `Script_ABC_Blanton_V1.1.3.zip` | The full Tera Term working directory, including `Blanton_Script/` to copy onto the DUT |
+
+**After copying to the DUT:**
+
+```bash
+chmod +x ~/Blanton_Script/*.sh      # see below
+grep -rlU $'\r' ~/Blanton_Script    # expect no output
+```
+
+`blanton_ber.sh` and `nfc_polling.sh` are invoked by the macros through `./` or `~/`, so they need the execute bit along with `bmc_monitor.sh` and `usb_target.sh` — neither git nor a Windows/USB copy carries it reliably.
+
+## ⚠️ Before you run
+
+* **Re-baseline your margin expectations.** Any pass/fail limits or golden logs derived from the old `VNOM` values need redoing against this build.
+* **`margin_save` in any form writes NVM permanently** and now writes margin windows derived from the new reference. Run `margin_status_all.sh` first and never call it during a test.
+* **SWB profiles are per-CONN.** Applying `combo_SWB_CONN13_high` to a CONN16 board is silently wrong.
+* **These three tests cannot share the switch**: `blanton_ber.sh`, `blanton_tr518.sh` and `blanton_traffic_linespeed`.
+* **PRBS takes the links down** while `blanton_ber.sh` is armed.
+* **`ce0` keeps running until you stop it.**
+* **Two numbers must stay in step**: Script C's `sleep 30` and `blanton_ber.sh`'s `BER_INTERVAL`.
+* **`FAN_SPEED` is 100** — the fans run flat out unless you change `config.ttl`.
+* **`nfc_polling.sh start` clears the log**, so Script B wipes Script A's NFC baseline file (the numbers are already in the console log).
+* **The NFC tool is written for the customer's tag.** It polls Type A / B / F only and parses Type A strictly; a tag of another technology is never discovered and fails as `no RF interface activation notification received`. Without `--expected-id` it does not check identity, so a different tag of the same type still passes.
+* **The three items listed as unverified in v1.1.0 are still unverified**: the `ce0` ingress mirror, the 120s settle in `blanton_tr518.sh`, and `test mode nr=no` on stop.
+
+## 🔗 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
+* [LTC2980_channel_map.csv](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/src/branch/main/docs/LTC2980_channel_map.csv) — all 144 margin channels with the new `VNOM`
+
+**Full changelog:** [V1.1.2...V1.1.3](https://etgit.et-wen.com/etwen/Blanton_TTL_Script/compare/V1.1.2...V1.1.3)

src/Script_ABC_Blanton/1_Blanton_Script_A.ttl

@@ -1,7 +1,7 @@
 ; =============================================================================
 ; Script A for Blanton
-; Version : V1.0.7
+; Version : V1.1.3
-; Date    : 2026-08-25
+; Date    : 2026-08-30
 ; Author  : ETWen
 ; =============================================================================
 ; Version History:
@@ -43,6 +43,141 @@
 ;                       ScriptC                                         Copy stress jobs log to USB, timestamped
 ;                       utils/wait_init.ttl                             WT_INTERVAL 10 -> 60, fix WT_MIN comments
 ;                       ScriptC                                         Disable BMC USB journalctl dump
+;   V1.0.8  2026-08-25  Blanton_Script/bmc_monitor.sh                   Add BMC I2C write/read-back pattern test
+;                       ScriptB                                         Re-enable bmc_monitor.sh start
+;                       ScriptC                                         Re-enable bmc_monitor.sh stop + cat bmc_poll.log
+;                       ScriptC                                         Copy bmc_poll.log + mgmt_ping.log into jobs/ before the USB archive
+;                       Blanton_Script/usb_target.sh                    Created - auto-detect USB device node / mount point
+;                       ScriptB                                         USB stress uses the detected node, not a hard-coded /dev/sda1
+;                       ScriptB                                         DDR memtester runs continuously (drop the 100-pass limit)
+;                       ScriptC                                         Move bgctl reset --yes after the USB archive
+;                       Blanton_Script/mgmt_ping_monitor.sh             V3.0.0 - both NICs ping simultaneously, accumulating
+;                                                                         + ARP warm-up so a stale neighbour entry is not counted as loss
+;                                                                         + stop renders last-N per NIC, stats, and both ip -s link show
+;                       .gitignore                                      Ignore monitor *.raw / *.pid / *.state
+;                       ScriptA                                         MGMT ping baseline 45s -> 30s, clear the log afterwards
+;                       ScriptB                                         Show mgmt_ping status after start
+;                       ScriptC                                         Show mgmt_ping status before stop, cat the report after
+;   V1.0.9  2026-08-26  Blanton_Script/port_prbs_monitor.sh             Add 100G Port PRBS test
+;                                                                         start [both|a|b] - single port isolates a port fault from
+;                                                                         the DUT not coping with two PRBS streams at once
+;                                                                         !! TTL calls are commented out in A/B/C - still under bring-up
+;                       ScriptA/B/C                                     Job log path /host/hw-eval/current/jobs -> /host/hw-eval/jobs
+;                       ScriptC                                         Mount the USB (usb_target.sh) before copying the job logs
+;                       ScriptC                                         Reorder results: stress logs, then MGMT ping, then 100G status
+;   V1.0.10 2026-08-27  ScriptB                                         Monitor loop lists the background jobs every round
+;                                                                         + bgctl list  - platform jobs
+;                                                                         + jobs        - shell jobs of the login shell
+;                                                                         + pause 60    - the loop used to run with no pause at all
+;                       docs/LTC2980_channel_map.csv                    Channel / net / Vnom map built from settings/*.conf
+;                       tools/gen_channel_map.sh                        Regenerates that CSV - the CSV is output, not source
+;                       tools/100G_PRBS.txt                             Bench command references, kept for hand-run debug
+;                       tools/TR518.txt                                 TR518 = built-in packet test (swutil / bcmcmd tr 518)
+;                       tools/fan_ctrl.txt                              MAX31790 rebind + fan-speed-control.sh
+;   V1.0.11 2026-08-28  LTC2980_Margin_Script/margin.sh                 v2.7.0 - margin_save fixes + two new subcommands
+;                                                                         STORE_USER_ALL (0x15) is now a PMBus send-byte, not
+;                                                                         0x15 followed by a dummy 0x00 data byte. The LTC2977
+;                                                                         tolerated the old form, but it was the wrong protocol
+;                                                                         i2c: i2cset .. 0x15 c   swb: cb_pmbus_write <ch> <addr> 0x15
+;                                                                         + margin_save all     - every board in settings/ (9 boards,
+;                                                                           18 chips), then re-init the one loaded beforehand
+;                                                                         + margin_save blanton - Blanton SONiC shortcut: all 18
+;                                                                           LTC2977 straight over the native i2c buses - no
+;                                                                           margin_init, no FPGA channel setup, no pcimem
+;                                                                           F3 Ch6->bus 13, Ch7->14, Ch8->15, Ch9->16
+;                                                                           board list = MARGIN_BLANTON_STORE at the top of margin.sh
+;                                                                         The store result is now checked - a NACK used to still
+;                                                                         print "Change Saved"
+;                                                                         MARGIN_STORE_SETTLE (0.5s) between stores; nothing in this
+;                                                                         tool polls the part's busy bit
+;                       LTC2980_Margin_Script/README.md                 What each margin_save variant sends, and the
+;                                                                         FPGA-channel -> i2c-bus map
+;                       LTC2980_Margin_Script/Ref/*.md                  0x15 trace note corrected to send-byte
+;                       LTC2980_Margin_Script/script/margin_save_all.sh Point at margin_save all; keep it for subsets
+;                       config.ttl                                      FAN_SPEED 30 -> 100 (full speed by default)
+;   V1.1.0  2026-08-28  Blanton_Script/blanton_ber.sh                   Add whole-switch SerDes BER test (PRBS via phydiag)
+;                                                                         init / start / report / stop / clear, -u 0|1|all
+;                                                                         report: one row per lane, PASS when BER < 1e-6, then
+;                                                                         a summary across units carrying the worst lane
+;                                                                         init also checks every lane locked - an unlocked lane
+;                                                                         still reports a BER, and it is a meaningless one
+;                                                                         !! PRBS takes the SerDes out of normal operation:
+;                                                                            links show DOWN, no traffic passes while it runs
+;                       Blanton_Script/blanton_tr518.sh                 Add TR518 packet test - loads the switch so the rails
+;                                                                         can be measured under traffic
+;                                                                         start [-u 0|1] then settles 120s (TR_SETTLE_SEC), so
+;                                                                         the power read afterwards is loaded, not ramping
+;                                                                         stop = port cd lb=none, exactly what TR518.txt does;
+;                                                                         l2 learn / test mode are NOT put back - stop says so
+;                       Blanton_Script/TH6_SWB{0,1}_power_readback.sh   Read the sensor tables ONCE, not once per rail
+;                                                                         38 'show platform' calls -> 2. The old loop sampled
+;                                                                         each rail at a different instant, so the total was a
+;                                                                         sum of readings seconds apart. Output format unchanged
+;                                                                         A rail missing from the table now warns on stderr
+;                                                                         instead of silently counting as 0 W
+;                       Blanton_Script/blanton_traffic_linespeed.sh     Add the 100G uplink (ce0, VLAN 138) to the test
+;                                                                         ce0 has no loopback partner and a switch will not send
+;                                                                         a frame back out its ingress port, so a tx burst was
+;                                                                         one round trip. An INGRESS MIRROR of ce0 back to ce0
+;                                                                         keeps it circulating until stop turns the mirror off
+;                                                                         !! stop MUST run - the loop does not end on its own
+;                                                                         report: ce0 is the last row; a summary at the bottom
+;                                                                         carries every unit's PASS / FAIL / NA totals
+;                       ScriptC                                         Run the BER sweep, after the traffic report so the
+;                                                                         two do not fight over the same ports
+;                                                                         Follows SWB_UNIT0/SWB_UNIT1 like the traffic block:
+;                                                                         -u 0 / -u 1 / skip, so a single-unit DUT is not asked
+;                                                                         for counters from a board it does not have
+;                       tools/BER_Test.txt                              Bench command references for the two new scripts
+;                       tools/100G_Traffic.txt
+;                       tools/TR518.txt                                 Corrected on the bench: port cd (not *:port all),
+;                                                                         testphase=1, and an explicit stop
+;   V1.1.1  2026-08-28  ScriptA                                         Clear a leftover session before starting a new run
+;                                                                         hw-test-session finish -> bgctl reset --yes ->
+;                                                                         bgctl stop --all -> bgctl list (must come back empty)
+;                                                                         A run that ended badly leaves jobs holding CPU and a
+;                                                                         session open; the next run used to inherit both, and
+;                                                                         the stress numbers were quietly wrong because of it
+;   V1.1.2  2026-08-28  Blanton_Script/nfc_polling.sh                   Add background NFC tag polling
+;                                                                         start / stop / status / tail / report / clear / fg
+;                                                                         wraps blantons_nfc_validate.py; start clears the log
+;                                                                         first, so a report covers this run only
+;                                                                         report works WHILE polling - it only reads the log,
+;                                                                         and says RUNNING so a snapshot is not read as final
+;                                                                         Each round appends a machine-readable RESULT line, so
+;                                                                         the tally never depends on the tool's wording
+;                                                                         PASS / FAIL come from the tool's own summary; ERROR
+;                                                                         means it produced neither, which is a different fault
+;                                                                         from a tag that would not read - counted separately
+;                                                                         tail does NOT follow (tail -f never returns, and a
+;                                                                         macro waiting on the prompt would hang there)
+;                                                                         Runs the .py through python3, not ./ - the file is
+;                                                                         mode 100644 and a USB copy carries no execute bit
+;                       Blanton_Script/blantons_nfc_validate.py         Vendor NFC/NCI validation tool (unmodified)
+;                       ScriptA                                         NFC baseline: start -> status -> 30s -> stop -> report
+;                       ScriptB                                         Start NFC polling for the soak, then status
+;                       ScriptC                                         Stop NFC polling with the other monitors, report it
+;                                                                         next to the mgmt ping log, and copy nfc_poll.log to
+;                                                                         the job dir for the USB archive
+;                                                                         Fix: that cp said nfc_polling.log - the file is
+;                                                                         nfc_poll.log, so the NFC log never reached the USB
+;   V1.1.3  2026-08-30  LTC2980_Margin_Script/settings/*.conf           VNOM is now the measured median, not the spec value
+;                                                                         86 of 144 rails moved up +0.8% .. +2.5%
+;                                                                         (3.3 -> 3.38, 0.9 -> 0.915, 0.8 -> 0.82, ...)
+;                                                                         This is NOT display-only: VNOM is the denominator of
+;                                                                         margin_status deviation %  AND the basis margin_set
+;                                                                         derives high/low/OV/UV from, so the whole margin
+;                                                                         window shifts with it
+;                                                                         !! margin logs from before/after cannot be compared
+;                       LTC2980_Margin_Script/profiles/                 Add per-CONN SWB profiles, drop comboA/comboB
+;                                                                         combo_SWB_CONN13..16_{high,low} - the percentages
+;                                                                         follow that board rails, so applying one to a
+;                                                                         different CONN margins the wrong things, silently
+;                                                                         SWB0 and SWB1 share a profile per CONN (same rails)
+;                       LTC2980_Margin_Script/script/*.sh               Fix: margin_apply_profile_all.sh still pointed every
+;                                                                         board at comboA, which this change deleted - all 9
+;                                                                         boards would have failed with "Profile not found"
+;                       docs/LTC2980_channel_map.csv                    Regenerated (tools/gen_channel_map.sh) - it is output
 ; =============================================================================
 include "config.ttl"
 
@@ -79,9 +214,19 @@ sendln cmd
 
 ;Stress log clear
 wait prompt_sonic_root
-sendln "rm /host/hw-eval/current/jobs/*"
+sendln "rm /host/hw-eval/jobs/*"
 
 ; ========== HW Test Session ==========
+; Clear session
+wait prompt_sonic_root
+sendln "hw-test-session finish"
+wait prompt_sonic_root
+sendln "bgctl reset --yes"
+wait prompt_sonic_root
+sendln "bgctl stop --all"
+wait prompt_sonic_root
+sendln "bgctl list"
+
 wait prompt_sonic_root
 sendln "hw-test-session start"
 wait prompt_sonic_root
@@ -194,14 +339,27 @@ include "utils/show_dmesg.ttl"
 wait prompt_sonic_root
 sendln "./Blanton_Script/mgmt_ping_monitor.sh start"
 wait prompt_sonic_root
-pause 45
+pause 30
 sendln "~/Blanton_Script/mgmt_ping_monitor.sh stop"
 wait prompt_sonic_root
 sendln "cat ~/Blanton_Script/log/mgmt_ping.log"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/mgmt_ping_monitor.sh clear"
+
+; ========== NFC Test ==========
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh start"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh status"
+wait prompt_sonic_root
+sendln "sleep 30"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh stop"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh report"
 
 
 ; ========== 100G Port Status ==========
-; Lpmode Disable
 wait prompt_sonic_root
 sendln "sudo sfputil lpmode off Ethernet513"
 wait prompt_sonic_root
@@ -216,6 +374,37 @@ sendln "config save -y"
 wait prompt_sonic_root
 sendln "show interfaces status Ethernet513,Ethernet514"
 
+;=============================================================================================================
+; ========== 100G PRBS ==========
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh start"
+;wait prompt_sonic_root
+;sendln "sleep 10"
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh status"
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh stop"
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh report"
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh clear"
+
+; ========== 100G Port Status ==========
+;wait prompt_sonic_root
+;sendln "sudo sfputil lpmode off Ethernet513"
+;wait prompt_sonic_root
+;sendln "sudo sfputil lpmode off Ethernet514"
+;wait prompt_sonic_root
+;sendln "config interface -n asic0 startup  Ethernet513"
+;wait prompt_sonic_root
+;sendln "config interface -n asic1 startup  Ethernet514"
+;wait prompt_sonic_root
+;sendln "config save -y"
+
+;wait prompt_sonic_root
+;sendln "show interfaces status Ethernet513,Ethernet514"
+;=============================================================================================================
+
 ; ========== First Traffic Test ==========
 ; Silent MAC
 wait prompt_sonic_root

src/Script_ABC_Blanton/2_Blanton_Script_B.ttl

@@ -28,17 +28,34 @@ sendln "~/hammer/tools/amd/mlucas-avx2 -s l -cpu 0:15 > ~/hammer/tools/amd/mluca
 wait prompt_sonic_root
 sendln "bgctl run bmc-manager run '/usr/bin/memtester 64M 1'"
 
-; ========== DDR MEMORY STRESS TEST ==========
+; ========== BMC Monitor Test ==========
 wait prompt_sonic_root
-sendln "bgctl run /usr/sbin/memtester 1G 100"
+sendln "./Blanton_Script/bmc_monitor.sh start"
+
+; ========== DDR MEMORY STRESS TEST ==========
+;wait prompt_sonic_root
+;sendln "bgctl run /usr/sbin/memtester 1G 100"
+wait prompt_sonic_root
+sendln "bgctl run /usr/sbin/memtester 1G"   ; Continue Execture
 
 ; ========== SSD read/write ==========
 wait prompt_sonic_root
-sendln "bgctl run qfx5252-stress-ssd 1G --runtime 3600 --passes 5 --write --force --log /host/hw-eval/current/qfx5252-stress-ssd.log"
+sendln "bgctl run qfx5252-stress-ssd 1G --runtime 3600 --passes 5 --write --force --log /host/hw-eval/jobs/qfx5252-stress-ssd.log"
 
 ; ========== USB read/write ==========
+; ---- Get USB partition node -> usb_dev ----
+usb_dev = ''
 wait prompt_sonic_root
-sendln "bgctl run qfx5252-stress-usb /dev/sda1 256M --runtime 60 --passes 1 --write --log /host/hw-eval/qfx5252-stress-usb.log"
+sendln 'D=$(bash ~/Blanton_Script/usb_target.sh -o dev 2>/dev/null); echo "<<D""EV=${D:-NONE}>>"'
+waitregex '<<DEV=([^>]*)>>'
+usb_dev = groupmatchstr1
+
+wait prompt_sonic_root
+sprintf2 cmd "bgctl run qfx5252-stress-usb %s 256M --runtime 60 --passes 1 --write --log /host/hw-eval/jobs/qfx5252-stress-usb.log" usb_dev
+sendln cmd
+
+;wait prompt_sonic_root
+;sendln "bgctl run qfx5252-stress-usb /dev/sda1 256M --runtime 60 --passes 1 --write --log /host/hw-eval/qfx5252-stress-usb.log"
 
 ; ========== SHOW Background job ==========
 wait prompt_sonic_root
@@ -79,12 +96,27 @@ timeout = 0
 ; ========== 10G/1G MGMT Ping Test ==========
 wait prompt_sonic_root
 sendln "./Blanton_Script/mgmt_ping_monitor.sh start"
+wait prompt_sonic_root
+pause 3
+sendln "./Blanton_Script/mgmt_ping_monitor.sh status"
+
+; ========== NFC Test ==========
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh start"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh status"
 
 
 ; ========== 100G Port ==========
 wait prompt_sonic_root
 sendln "show interfaces status Ethernet513,Ethernet514"
 
+;=============================================================================================================
+; ========== 100G PRBS ==========
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh start"
+;=============================================================================================================
+
 
 ; ========== Traffic START ==========
 ; Silent MAC
@@ -135,11 +167,16 @@ endif
 
 
 
-; ========== Get data every 10mins ==========
+; ========== Monitor loop: platform data + background jobs (pause 60s per round) ==========
 while 1
     include "utils/setup_pmon.ttl"
+    wait prompt_sonic_root
+    sendln "bgctl list"
+    wait prompt_sonic_root
+    sendln "jobs"
     ; ========== Check Margin ==========
     if EN_Margin = 1 then
         include "utils/show_margin_status.ttl"
     endif
+    pause 60
 endwhile

src/Script_ABC_Blanton/3_Blanton_Script_C.ttl

@@ -17,14 +17,32 @@ wait prompt_sonic_root
 sendln "bgctl stop --all"
 wait prompt_sonic_root
 sendln "bgctl stop --all"
-wait prompt_sonic_root
-sendln "bgctl reset --yes"
 ; BMC USB Test STOP
 wait prompt_sonic_root
 sendln "systemctl stop qfx5252-bmc-usb-net-test.service"
 ; 10G/1G MGMT Test STOP
 wait prompt_sonic_root
+sendln "~/Blanton_Script/mgmt_ping_monitor.sh status"
+wait prompt_sonic_root
 sendln "~/Blanton_Script/mgmt_ping_monitor.sh stop"
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh stop"
+
+;=============================================================================================================
+; 100G PRBS STOP
+;wait prompt_sonic_root
+;sendln "~/Blanton_Script/port_prbs_monitor.sh stop"
+;wait prompt_sonic_root
+;sendln "sudo sfputil lpmode off Ethernet513"
+;wait prompt_sonic_root
+;sendln "sudo sfputil lpmode off Ethernet514"
+;wait prompt_sonic_root
+;sendln "config interface -n asic0 startup  Ethernet513"
+;wait prompt_sonic_root
+;sendln "config interface -n asic1 startup  Ethernet514"
+;=============================================================================================================
+
+
 
 
 ; ========== TAKE DATA ==========
@@ -53,20 +71,40 @@ sendln "/usr/sbin/ras-mc-ctl --summary"
 ;wait prompt_sonic_root
 ;sendln "cat ./Blanton_Script/log/bmc_ddr.log"
 
+; ========== BMC Monitor TAKE DATA ==========
+wait prompt_sonic_root
+sendln "./Blanton_Script/bmc_monitor.sh stop"
+wait prompt_sonic_root
+sendln "cat ./Blanton_Script/log/bmc_poll.log"
+
 ; ========== BMC USB Test result ==========
 ;wait prompt_sonic_root
 ;sendln "journalctl -u qfx5252-bmc-usb-net-test.service --no-pager"
 
-; ========== 10G/1G MGMT Test result ==========
-wait prompt_sonic_root
-sendln "ip -s link show eth0"
-wait prompt_sonic_root
-sendln "ip -s link show eth1"
-
 
 ; ========== CHECK Stress results ==========
 wait prompt_sonic_root
 sendln "cat ~/hammer/tools/amd/mlucas_amm_log"
+wait prompt_sonic_root
+sendln "cat /host/hw-eval/jobs/qfx5252-stress-ssd.log"
+wait prompt_sonic_root
+sendln "cat /host/hw-eval/jobs/qfx5252-stress-usb.log"
+
+; ========== 10G/1G MGMT Test result ==========
+wait prompt_sonic_root
+sendln "cat ~/Blanton_Script/log/mgmt_ping.log"
+
+; ========== NFC Test result ==========
+wait prompt_sonic_root
+sendln "~/Blanton_Script/nfc_polling.sh report"
+
+; ========== 100G Port ==========
+wait prompt_sonic_root
+sendln "show interfaces status Ethernet513,Ethernet514"
+;=============================================================================================================
+;wait prompt_sonic_root
+;sendln "cat ~/Blanton_Script/log/port_prbs.log "
+;=============================================================================================================
 
 ; ========== CHECK Traffic counters ==========
 if SWB_UNIT0 = 1 && SWB_UNIT1 = 1 then
@@ -88,6 +126,54 @@ else
 
 endif
 
+; ========== BER ==========
+; PRBS takes the SerDes out of normal operation, so this runs AFTER the
+; traffic report. sleep 30 matches blanton_ber.sh BER_INTERVAL - reporting
+; earlier reads an interval that has not finished accumulating.
+if SWB_UNIT0 = 1 && SWB_UNIT1 = 1 then
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh init"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh start"
+    wait prompt_sonic_root
+    sendln "sleep 30"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh report"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh stop"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh clear"
+elseif SWB_UNIT0 = 1 && SWB_UNIT1 = 0 then
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh init -u 0"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh start -u 0"
+    wait prompt_sonic_root
+    sendln "sleep 30"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh report -u 0"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh stop -u 0"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh clear -u 0"
+elseif SWB_UNIT0 = 0 && SWB_UNIT1 = 1 then
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh init -u 1"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh start -u 1"
+    wait prompt_sonic_root
+    sendln "sleep 30"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh report -u 1"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh stop -u 1"
+    wait prompt_sonic_root
+    sendln "./Blanton_Script/blanton_ber.sh clear -u 1"
+else
+
+endif
+
+
 ; ========== NVME Err Info ==========
 wait prompt_sonic_root
 sendln "/usr/sbin/nvme smart-log -H /dev/nvme0"
@@ -102,16 +188,39 @@ sendln "show reboot-cause"
 wait prompt_sonic_root
 sendln "show uptime"
 
+
+; ---- Get USB partition node -> usb_dev ----
+usb_dev = ''
+wait prompt_sonic_root
+sendln 'D=$(bash ~/Blanton_Script/usb_target.sh -o dev 2>/dev/null); echo "<<D""EV=${D:-NONE}>>"'
+waitregex '<<DEV=([^>]*)>>'
+usb_dev = groupmatchstr1
+
+wait prompt_sonic_root
+sendln "sync"
+wait prompt_sonic_root
+sprintf2 cmd "mount %s /mnt/usb" usb_dev
+sendln cmd
+
 ; ========== Copy Stress Log to USB ==========
+wait prompt_sonic_root
+sendln "cp ./Blanton_Script/log/bmc_poll.log /host/hw-eval/jobs/"
+wait prompt_sonic_root
+sendln "cp ./Blanton_Script/log/mgmt_ping.log /host/hw-eval/jobs/"
+wait prompt_sonic_root
+sendln "cp ./Blanton_Script/log/nfc_poll.log /host/hw-eval/jobs/"
+
+wait prompt_sonic_root
 getdate ts_date "%Y%m%d"
 gettime ts_time "%H%M"
 sprintf2 usb_dst "/mnt/usb/jobs-%s_%s" ts_date ts_time
-sprintf2 cmd "cp -r /host/hw-eval/current/jobs/ %s" usb_dst
+sprintf2 cmd "cp -r /host/hw-eval/jobs/ %s" usb_dst
-wait prompt_sonic_root
 sendln cmd
 
 ; ========== HW Test Session ==========
 wait prompt_sonic_root
 sendln "hw-test-session finish"
+wait prompt_sonic_root
+sendln "bgctl reset --yes"
 
 messagebox 'GOOD JOB! Test Case DONE' 'teraterm'

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/README.md

@@ -14,6 +14,8 @@
 | `margin_operation <ch> <op>` | 只切 OPERATION register |
 | `margin_apply_profile <file>` | 批次套用 profile（套用在當前載入的 LTC2980） |
 | `margin_save` | 寫入 NVM（當前 LTC2980 的兩個 LTC2977 都寫） |
+| `margin_save all` | 對 `settings/` 底下**全部** LTC2980 寫入 NVM，結束後回到原本載入的那顆 |
+| `margin_save blanton` | **Blanton SONiC 專用**：18 顆 LTC2977 全部走原生 i2c bus 寫入，不需要 `margin_init` |
 | `margin_debug [on\|off]` | 開關 debug 模式（不帶參數則 toggle） |
 | `margin_log [on\|off]` | 開關 log 記錄（不帶參數則 toggle，預設開啟） |
 
@@ -70,16 +72,18 @@ margin_operation 0 high
 margin_operation 0 nominal
 
 # 批次套用 profile（套在當前載入的 LTC2980）
-margin_apply_profile profiles/comboA.conf
+margin_apply_profile profiles/combo_SWB_CONN13_high.conf
-margin_apply_profile profiles/comboB.conf
+margin_apply_profile profiles/combo_SWB_CONN13_low.conf
 margin_apply_profile profiles/all_off.conf
 
 # 切換到另一顆 LTC2980
 margin_init Blanton_SWB1_CONN16
-margin_apply_profile profiles/comboA.conf
+margin_apply_profile profiles/combo_SWB_CONN16_high.conf
 
 # 儲存到 NVM（斷電後保留）
-margin_save
+margin_save            # 只寫當前載入的那顆
+margin_save all        # settings/ 底下 9 顆全部寫，最後自動切回原本那顆
+margin_save blanton    # Blanton SONiC 專用捷徑，18 顆一次寫完（見下）
 ```
 
 ## 一次掃所有 LTC2980
@@ -104,7 +108,7 @@ BOARDS=(
 ## 一次套 profile 到所有 LTC2980
 
 `script/margin_apply_profile_all.sh` 對多顆 LTC2980 依 `BOARDS[i]` 配對
-`PROFILES[i]` 套用 profile（預設全部 `comboA`）。
+`PROFILES[i]` 套用 profile（預設 SWB 各用自己 CONN 的 `_high`，CB 用 `combo_high3`）。
 
 ```bash
 source script/margin_apply_profile_all.sh
@@ -120,8 +124,8 @@ BOARDS=(
 )
 
 PROFILES=(
-    "comboA"    # Blanton_CB_CONN13
+    "combo_high3"               # Blanton_CB_CONN13
-    "comboB"    # Blanton_SWB0_CONN13   ← 改成 comboB
+    "combo_SWB_CONN13_high"     # Blanton_SWB0_CONN13
     ...
 )
 ```
@@ -129,18 +133,109 @@ PROFILES=(
 `PROFILES` 寫名字即可（不含路徑跟 `.conf`），script 會自動展開成
 `profiles/<name>.conf`。兩個陣列長度不一致會直接報錯。
 
-## 一次把所有 LTC2980 寫入 NVM
+> ⚠️ **SWB 的 profile 是 per-CONN 的**：每個檔的百分比對應該片板子的軌，
+> 套到別的 CONN 會 margin 到錯的東西（而且不會報錯）。這裡不能全部填同一個名字。
+> HIGH / LOW 兩輪就是把 `_high` 全換成 `_low` 再跑一次。
 
-`script/margin_save_all.sh` 對 `BOARDS` 列出的每顆 LTC2980 跑 `margin_save`。
+## 一次把所有 LTC2980 寫入 NVM
 
 > ⚠️  `margin_save` 會把當前 margin / OV / UV 設定**永久寫入 NVM**，
 > 斷電後保留。執行前先用 `margin_status_all.sh` 確認狀態正確。
 
+**全部 9 顆**直接用內建的：
+
+```bash
+margin_save all
+```
+
+依 `settings/*.conf` 的檔名順序跑，中途某顆失敗**不會停**（半套完成的狀態比全部試完更難查），
+最後印出「幾顆成功 / 哪幾顆失敗」的總結，並把 `margin_init` 切回你呼叫前載入的那顆。
+
+**只寫其中幾顆**才需要 `script/margin_save_all.sh`，編 script 頂端的 `BOARDS` 陣列：
+
 ```bash
 source script/margin_save_all.sh
 ```
 
-要改寫哪幾顆，編 script 頂端的 `BOARDS` 陣列即可（同前述）。
+### 送出去的是什麼
+
+`margin_save` 對每顆 LTC2977 送一次 `STORE_USER_ALL`（PMBus command `0x15`），
+**不分 page**（這是整顆晶片的命令），也**不帶 data byte** —— 它是 SMBus send-byte：
+
+```bash
+i2cset -y 4 0x5C 0x15 c            # CB CONN13（原生 bus 4）
+cb_pmbus_write 8 0x5C 0x15         # SWB0 CONN13（CB FPGA F3 Ch8）
+```
+
+> v2.7.0 之前送的是 `0x15 0x00`（write-byte）。LTC2977 在 CB 上吃得下去，但那是零件寬容，
+> 不是規範。同時 v2.7.0 起會檢查回傳值 —— 以前 NACK 了還是印 `Change Saved`。
+
+每顆之間會 `sleep $MARGIN_STORE_SETTLE`（預設 0.5 秒）。這不是量測值，是保守的保護：
+NVM 寫入需要時間，而這支工具**沒有**去 poll 零件的 busy bit。`margin_save all` 連續送 18 次，
+這個間隔就是唯一的緩衝。要關掉設成空字串即可。
+
+## `margin_save blanton` — Blanton SONiC 專用
+
+Blanton 這台把 CB FPGA F3 的 I2C 通道**同時掛成了原生 Linux i2c adapter**，
+所以 SWB 上的 LTC2977 不必走 `cb_pmbus_*` / pcimem，用 `i2cset` 直接打得到：
+
+| FPGA F3 通道 | Linux bus | 板 / 接頭 |
+|---|---|---|
+| Ch6 | 13 | SWB0 CONN14 / CONN16 |
+| Ch8 | 15 | SWB0 CONN13 / CONN15 |
+| Ch7 | 14 | SWB1 CONN14 / CONN16 |
+| Ch9 | 16 | SWB1 CONN13 / CONN15 |
+| —（原生） | 4 | CB CONN13 |
+
+因此 `margin_save blanton` 就是一張平表跑完 18 顆，**不需要 `margin_init`**、
+不做 FPGA 通道初始化、不做 probe，也不會動到你當前載入的那顆板子：
+
+```bash
+margin_save blanton
+```
+
+```
+  CB   CONN13  bus 4  0x5C : saved
+  SWB0 CONN13  bus 15 0x5C : saved
+  ...
+margin_save blanton: 18 saved, 0 failed
+```
+
+送出去的就是這 18 行（2026-08-27 上機驗證）：
+
+```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
+```
+
+`-f` 是因為這些 bus 上的 LTC2977 可能已被 kernel driver 認走；上機驗證過的指令帶 `-f`，就照原樣保留。
+
+**這台沒裝滿的話**，把 `margin.sh` 頂端 `MARGIN_BLANTON_STORE` 陣列裡對應的行註解掉即可，
+不要讓它去打不存在的板子。bus 節點不存在（`/dev/i2c-N` 沒有）與晶片不回應（NACK）
+會分別報不同訊息 —— 前者代表 FPGA 的 i2c adapter 根本沒 enumerate，後者才是板子的問題。
+
+## 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 專用** | 同上 |
+| `combo_high3` / `combo_low3` | 通用 | 全部 channel ±3% |
+| `combo_high5` / `combo_low5` | 通用 | 全部 channel ±5% |
+| `combo_normal` | 通用 | 全部回 nominal |
+| `all_off` | 通用 | 全部 OPERATION off |
+
+SWB0 和 SWB1 的同號 CONN 共用同一個 profile（兩片板的軌完全相同，
+只差 I2C bus）。CB CONN13 沒有專屬 profile，用通用的 `combo_high3` / `combo_low3`。
 
 ## Operation 對應
 

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/Ref/margin_command_trace.md

@@ -424,8 +424,9 @@ SWB debug 指令(margin.sh v2.6.0 新增,皆為 `blanton_cb_i2c.sh` 的薄包裝
   `Blanton_SWB0_CONN14.conf` 的第一顆也是 `0:0x5E`。兩個 CONN 現在同在 Ch6,
   位址相撞。對照 SWB1 的規律(CONN13=`0x5C/0x5D`、CONN14=`0x5E/0x5F`),
   SWB0_CONN13 第二顆推測應為 `0:0x5D` — **尚未修改,待硬體確認**。
-- `margin_save` 走 `0x15` + data byte(`i2cset ... 0x15 0x00 b`)。PMBus 規範
+- `margin_save` 走 `0x15` **send-byte**(`i2cset ... 0x15 c` / `cb_pmbus_write <ch> <addr> 0x15`),
-  STORE_USER_ALL 是 send-byte;CB 上實測可用故保留原樣,swb 路徑沿用同一寫法。
+  不帶 data byte。v2.7.0 之前送的是 `0x15 0x00`(write-byte),CB 上實測可用,
+  但那是零件寬容而非規範。
 
 ---
 

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/margin.sh

@@ -5,6 +5,24 @@
 # =============================================================================
 # Version Control
 # -----------------------------------------------------------------------------
+# v2.7.0  margin_save fixes and batching:
+#           * STORE_USER_ALL (0x15) is now issued as an SMBus send-byte instead
+#             of a write-byte with a dummy 0x00 data byte. The LTC2977 accepted
+#             the old form on CB, but it was the wrong protocol.
+#             i2c path: i2cset ... 0x15 c   swb path: cb_pmbus_write ch addr 0x15
+#           * margin_save all -- STORE_USER_ALL on every board in settings/,
+#             then re-init whichever board was loaded beforehand. Does not stop
+#             on the first failure; prints a per-board summary at the end.
+#           * The store result is now checked. It used to be discarded, so a
+#             NACK still printed "Change Saved".
+#           * MARGIN_STORE_SETTLE (default 0.5s) between stores - nothing polls
+#             the part's busy bit, and `all` issues 18 of them in a row.
+#           * margin_save blanton -- Blanton SONiC shortcut. On this platform the
+#             CB FPGA F3 I2C channels also appear as native Linux i2c adapters
+#             (Ch6->bus 13, Ch7->14, Ch8->15, Ch9->16), so all 18 LTC2977 can be
+#             stored with plain i2cset: no margin_init, no FPGA channel setup,
+#             no pcimem. Bench-verified on the DUT 2026-08-27. The board list is
+#             MARGIN_BLANTON_STORE at the top of this file.
 # v2.6.0  SWB path actually wired to the shared CB I2C package. blanton_cb_i2c.sh
 #         and blanton_fpga_pcimem.sh live in the PARENT dir (Blanton_Script/), not
 #         next to margin.sh, so the backend is now searched in both places.
@@ -115,6 +133,45 @@ ONOFF_ENABLE_VALUE="0x1a"   # controlled_on=1, use_pmbus=1, use_control=0, b1=1
 # margin_status after all channels are set. Bump this if you want margin_set's own
 # read-back to reflect the settled value.
 MARGIN_SETTLE="0.3"
+# Pause after each STORE_USER_ALL. The LTC2977 is busy committing NVM once the
+# command lands and nothing here polls a busy bit, so this is a plain guard
+# rather than a measured value - it matters most for `margin_save all`, which
+# fires 18 stores back to back. Set to "" to disable.
+MARGIN_STORE_SETTLE="${MARGIN_STORE_SETTLE:-0.5}"
+
+# --- `margin_save blanton`: the bench-verified Blanton SONiC store list -------
+# On this platform the CB FPGA F3 I2C channels are ALSO exposed as native Linux
+# i2c adapters, so every LTC2977 - CB and SWB alike - can be reached with plain
+# i2cset. That path needs no FPGA channel setup, no pcimem, and no margin_init:
+# one flat list, 18 commands, done. Verified on the DUT 2026-08-27.
+#
+#   FPGA F3 channel -> Linux bus:  Ch6->13  Ch7->14  Ch8->15  Ch9->16
+#
+# Entry format: "bus:addr:label". Comment out the lines for boards this DUT does
+# not have rather than letting them fail - a single-SWB unit is a normal build.
+MARGIN_BLANTON_STORE=(
+    "4:0x5C:CB   CONN13"
+    "4:0x5E:CB   CONN13"
+    "15:0x5C:SWB0 CONN13"
+    "15:0x5E:SWB0 CONN13"
+    "13:0x5C:SWB0 CONN14"
+    "13:0x5E:SWB0 CONN14"
+    "15:0x62:SWB0 CONN15"
+    "15:0x64:SWB0 CONN15"
+    "13:0x62:SWB0 CONN16"
+    "13:0x64:SWB0 CONN16"
+    "16:0x5C:SWB1 CONN13"
+    "16:0x5E:SWB1 CONN13"
+    "14:0x5C:SWB1 CONN14"
+    "14:0x5E:SWB1 CONN14"
+    "16:0x62:SWB1 CONN15"
+    "16:0x64:SWB1 CONN15"
+    "14:0x62:SWB1 CONN16"
+    "14:0x64:SWB1 CONN16"
+)
+# -f because the LTC2977s may be claimed by a kernel driver on these buses; the
+# command that was verified on the bench carries it, so it stays.
+MARGIN_BLANTON_I2CSET_FLAGS="${MARGIN_BLANTON_I2CSET_FLAGS:--f -y}"
 _BUS=""
 _ADDR=""
 _PRE_SCOPE=""   # set while inside a PRE/POST wrapped operation; prevents nested re-entry
@@ -257,6 +314,20 @@ _swb_write() {
     return 0
 }
 
+# _swb_send <cmd>  -> cb_pmbus_write with NO data byte (SMBus send-byte).
+# cb_pmbus_write routes a no-data call to _cbi2c_xfer_cmd_only: START, slave+W,
+# command byte, STOP. That is what STORE_USER_ALL expects.
+_swb_send() {
+    local reg=$1
+    [ "$DEBUG_MODE" = "1" ] && echo -e "\033[90m[DEBG] cb_pmbus_write $CB_I2C_CH $_ADDR $reg (send-byte)\033[0m"
+    if ! _swb_call cb_pmbus_write "$CB_I2C_CH" "$_ADDR" "$reg" >/dev/null 2>&1; then
+        echo -e "[\033[31mERRO\033[0m] cb_pmbus_write ch=$CB_I2C_CH $_ADDR reg=$reg (send-byte) failed (NACK/timeout)" >&2
+        _log_detail "ERRO cb_pmbus_write ch=$CB_I2C_CH $_ADDR $reg send-byte"
+        return 1
+    fi
+    return 0
+}
+
 # _swb_read_word <reg>  -> echoes "0xXXXX" parsed out of cb_pmbus_read's "=> 0xXXXX"
 _swb_read_word() {
     local reg=$1 out word
@@ -520,6 +591,20 @@ _i2c_write_byte() {
     i2cset -y "$_BUS" "$_ADDR" "$1" "$2" b >/dev/null 2>&1
 }
 
+# Send a PMBus command with NO data byte (SMBus send-byte).
+# STORE_USER_ALL (0x15) and its relatives are send-byte commands: the command
+# byte alone triggers them. Appending a dummy 0x00 makes it a write-byte, which
+# is a different SMBus protocol - the LTC2977 happened to accept it, but that is
+# tolerance, not correctness. i2cset's "c" mode is the send-byte form.
+_i2c_send_byte() {
+    if [ "$TRANSPORT" = "swb" ]; then
+        _swb_send "$1"
+        return
+    fi
+    [ "$DEBUG_MODE" = "1" ] && echo -e "\033[90m[DEBG] i2cset -y $_BUS $_ADDR $1 c\033[0m"
+    i2cset -y "$_BUS" "$_ADDR" "$1" c >/dev/null 2>&1
+}
+
 # Read a 16-bit word; echoes "0xXXXX". For swb, parse cb_pmbus_read's "=> 0xXXXX".
 _i2c_read_word() {
     if [ "$TRANSPORT" = "swb" ]; then
@@ -730,20 +815,171 @@ margin_apply_profile() {
 }
 
 # --- Save to NVM ---
+# margin_save          -- STORE_USER_ALL on the currently initialised board
+# margin_save all      -- ... on every board in settings/, then re-init the one
+#                         that was loaded when you called it
+# margin_save blanton  -- Blanton SONiC shortcut: all 18 LTC2977 straight over
+#                         the native i2c buses, no margin_init needed
+#
+# ⚠️  This is the only permanent write in the tool: it commits the current
+#     margin / OV / UV registers to NVM, and a power cycle will NOT undo it.
+#     Run margin_status first and never call it during a test run.
 margin_save() {
+    if [ "${1:-}" = "all" ]; then
+        _margin_save_every_board
+        return
+    fi
+    if [ "${1:-}" = "blanton" ]; then
+        _margin_save_blanton
+        return
+    fi
+
     local _own=0
     _pre_enter_own && _own=1
 
+    local chip fails=0
     for chip in "${CHIPS[@]}"; do
         IFS=':' read -r _BUS _ADDR <<< "$chip"
-        _i2c_write_byte 0x15 0x00
+        # STORE_USER_ALL is chip-wide (all 8 pages), so no _open_page here.
+        if _i2c_send_byte 0x15; then
+            _log_detail "STORE_USER_ALL $PART_NUMBER $_ADDR ok"
+        else
+            fails=$(( fails + 1 ))
+            echo -e "[\033[31mERRO\033[0m] STORE_USER_ALL failed on $_ADDR" >&2
+            _log_detail "ERRO STORE_USER_ALL $PART_NUMBER $_ADDR"
+        fi
+        # The part is busy writing NVM after this; nothing here polls a busy bit,
+        # so leave a gap before touching it again. See MARGIN_STORE_SETTLE.
+        [ -n "$MARGIN_STORE_SETTLE" ] && sleep "$MARGIN_STORE_SETTLE"
     done
+
+    if [ "$fails" -eq 0 ]; then
         echo "Change Saved (${#CHIPS[@]} chips)"
-    _log_label "margin_save $PART_NUMBER (${#CHIPS[@]} chips)"
+    else
+        echo -e "[\033[31mERRO\033[0m] $fails of ${#CHIPS[@]} chips did NOT save"
+    fi
+    _log_label "margin_save $PART_NUMBER (${#CHIPS[@]} chips, $fails failed)"
 
     [ "$_own" = "1" ] && _pre_exit
+    return $(( fails > 0 ))
 }
 
+# margin_save all -- every .conf in settings/, in filename order.
+# Deliberately does NOT stop on the first failure: a half-saved set is worse to
+# diagnose than a fully-attempted one, and the summary tells you which boards
+# to redo. margin_init is re-run per board because CHIPS / TRANSPORT /
+# CB_I2C_CH are global state.
+_margin_save_every_board() {
+    local files=( "$SETTINGS_DIR"/*.conf )
+    if [ ! -e "${files[0]}" ]; then
+        echo -e "[\033[31mERRO\033[0m] no .conf found in $SETTINGS_DIR"
+        return 1
+    fi
+
+    local restore="$PART_NUMBER"      # empty if margin_init was never run
+    local board f ok=0 bad=0 failed=""
+
+    echo "-------------"
+    echo "margin_save all -- ${#files[@]} boards, permanent NVM write"
+    echo "-------------"
+    _log_label "margin_save all (${#files[@]} boards)"
+
+    for f in "${files[@]}"; do
+        board=$(basename "$f" .conf)
+        echo ""
+        if ! margin_init "$board"; then
+            bad=$(( bad + 1 )); failed="$failed $board(init)"
+            continue
+        fi
+        if margin_save; then
+            ok=$(( ok + 1 ))
+        else
+            bad=$(( bad + 1 )); failed="$failed $board"
+        fi
+    done
+
+    echo ""
+    echo "-------------"
+    printf "margin_save all: %d saved, %d failed\n" "$ok" "$bad"
+    [ "$bad" -gt 0 ] && echo -e "[\033[31mERRO\033[0m] failed:$failed"
+    echo "-------------"
+    _log_label "margin_save all done: $ok ok, $bad failed$failed"
+
+    # Put back whatever board the caller had loaded, so a following
+    # margin_status does not silently report the last board in the list.
+    if [ -n "$restore" ] && [ "$restore" != "$board" ]; then
+        echo ""
+        echo -e "[\033[34mINFO\033[0m] restoring previous board: $restore"
+        margin_init "$restore" >/dev/null
+    fi
+
+    return $(( bad > 0 ))
+}
+
+# margin_save blanton -- Blanton SONiC only. Walks MARGIN_BLANTON_STORE and
+# sends STORE_USER_ALL to each LTC2977 over the native i2c buses.
+#
+# Deliberately does NOT use margin_init / CHIPS / TRANSPORT: the whole point is
+# that on this platform every LTC2977 is reachable with plain i2cset, so the
+# FPGA channel setup and the per-board probe are not needed. That also means it
+# does not touch the loaded board - PART_NUMBER is the same afterwards.
+_margin_save_blanton() {
+    local n=${#MARGIN_BLANTON_STORE[@]}
+    if [ "$n" -eq 0 ]; then
+        echo -e "[\033[31mERRO\033[0m] MARGIN_BLANTON_STORE is empty"
+        return 1
+    fi
+
+    echo "-------------"
+    echo "margin_save blanton -- $n LTC2977, permanent NVM write"
+    echo "-------------"
+    _log_label "margin_save blanton ($n chips)"
+
+    local entry bus addr label ok=0 bad=0 failed=""
+    for entry in "${MARGIN_BLANTON_STORE[@]}"; do
+        IFS=':' read -r bus addr label <<< "$entry"
+
+        # "no such bus" and "chip did not answer" are different faults: the first
+        # means the FPGA i2c adapters did not enumerate, the second means the
+        # board is absent or the address is wrong. Do not blur them into one.
+        if [ ! -e "/dev/i2c-$bus" ]; then
+            echo -e "[\033[31mERRO\033[0m] $label  bus $bus addr $addr : /dev/i2c-$bus does not exist"
+            _log_detail "ERRO STORE_USER_ALL $label bus=$bus addr=$addr no-such-bus"
+            bad=$(( bad + 1 )); failed="$failed [$label $addr]"
+            continue
+        fi
+
+        [ "$DEBUG_MODE" = "1" ] && echo -e "\033[90m[DEBG] i2cset $MARGIN_BLANTON_I2CSET_FLAGS $bus $addr 0x15\033[0m"
+        if i2cset $MARGIN_BLANTON_I2CSET_FLAGS "$bus" "$addr" 0x15 >/dev/null 2>&1; then
+            printf "  %-12s bus %-2s %s : saved\n" "$label" "$bus" "$addr"
+            ok=$(( ok + 1 ))
+            _log_detail "STORE_USER_ALL $label bus=$bus addr=$addr ok"
+        else
+            echo -e "[\033[31mERRO\033[0m] $label  bus $bus addr $addr : i2cset failed (NACK/busy)"
+            _log_detail "ERRO STORE_USER_ALL $label bus=$bus addr=$addr"
+            bad=$(( bad + 1 )); failed="$failed [$label $addr]"
+        fi
+
+        # No busy-bit poll anywhere in this tool; this gap is the only buffer.
+        [ -n "$MARGIN_STORE_SETTLE" ] && sleep "$MARGIN_STORE_SETTLE"
+    done
+
+    echo "-------------"
+    printf "margin_save blanton: %d saved, %d failed\n" "$ok" "$bad"
+    [ "$bad" -gt 0 ] && echo -e "[\033[31mERRO\033[0m] failed:$failed"
+    echo "-------------"
+    _log_label "margin_save blanton done: $ok ok, $bad failed$failed"
+
+    return $(( bad > 0 ))
+}
+
+# --- Tab completion for margin_save ---
+_margin_save_completions() {
+    [ "$COMP_CWORD" -ne 1 ] && return
+    COMPREPLY=($(compgen -W "all blanton" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+complete -F _margin_save_completions margin_save
+
 if [ -z "$_LOG_FILE" ]; then
     _LOG_FILE="$LOGS_DIR/margin_$(date '+%Y%m%d_%H%M%S').log"
     _LOG_DETAIL_FILE="${_LOG_FILE%.log}_detail.log"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/comboA.conf

@@ -1,22 +0,0 @@
-# Profile: comboA - alternating high/low (even=high, odd=low)
-# Applied to whichever LTC2980 is currently loaded via margin_init
-# Format: "channel:operation:change_percent"
-
-PROFILE_CHANNELS=(
-    "0:high:8"
-    "1:low:8"
-    "2:high:8"
-    "3:low:8"
-    "4:high:8"
-    "5:low:8"
-    "6:high:8"
-    "7:low:8"
-    "8:high:8"
-    "9:low:8"
-    "10:high:8"
-    "11:low:8"
-    "12:high:8"
-    "13:low:8"
-    "14:high:8"
-    "15:low:8"
-)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/comboB.conf

@@ -1,22 +0,0 @@
-# Profile: comboB - inverse of comboA (even=low, odd=high)
-# Applied to whichever LTC2980 is currently loaded via margin_init
-# Format: "channel:operation:change_percent"
-
-PROFILE_CHANNELS=(
-    "0:low:8"
-    "1:high:8"
-    "2:low:8"
-    "3:high:8"
-    "4:low:8"
-    "5:high:8"
-    "6:low:8"
-    "7:high:8"
-    "8:low:8"
-    "9:high:8"
-    "10:low:8"
-    "11:high:8"
-    "12:low:8"
-    "13:high:8"
-    "14:low:8"
-    "15:high:8"
-)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN13_high.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN13_high - every channel margin HIGH, per-channel percentage
+# For the SWB CONN13 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:high:3"
+    "1:high:3"
+    "2:high:3"
+    "3:high:3"
+    "4:high:5"
+    "5:high:5"
+    "6:high:5"
+    "7:high:5"
+    "8:high:5"
+    "9:high:3"
+    "10:high:3"
+    "11:high:3"
+    "12:high:3"
+    "13:high:3"
+    "14:high:3"
+    "15:high:5"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN13_low.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN13_low - every channel margin LOW, per-channel percentage
+# For the SWB CONN13 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:low:3"
+    "1:low:3"
+    "2:low:3"
+    "3:low:3"
+    "4:low:5"
+    "5:low:5"
+    "6:low:5"
+    "7:low:5"
+    "8:low:5"
+    "9:low:3"
+    "10:low:3"
+    "11:low:3"
+    "12:low:3"
+    "13:low:3"
+    "14:low:3"
+    "15:low:5"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN14_high.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN14_high - every channel margin HIGH, per-channel percentage
+# For the SWB CONN14 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:high:3"
+    "1:high:3"
+    "2:high:3"
+    "3:high:5"
+    "4:high:5"
+    "5:high:5"
+    "6:high:5"
+    "7:high:5"
+    "8:high:3"
+    "9:high:3"
+    "10:nominal:5"
+    "11:nominal:5"
+    "12:high:3"
+    "13:nominal:5"
+    "14:high:5"
+    "15:high:3"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN14_low.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN14_low - every channel margin LOW, per-channel percentage
+# For the SWB CONN14 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:low:3"
+    "1:low:3"
+    "2:low:3"
+    "3:low:5"
+    "4:low:5"
+    "5:low:5"
+    "6:low:5"
+    "7:low:5"
+    "8:low:3"
+    "9:low:3"
+    "10:nominal:5"
+    "11:nominal:5"
+    "12:low:3"
+    "13:nominal:5"
+    "14:low:5"
+    "15:low:3"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN15_high.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN15_high - every channel margin HIGH, per-channel percentage
+# For the SWB CONN15 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:high:3"
+    "1:high:3"
+    "2:high:3"
+    "3:high:3"
+    "4:high:3"
+    "5:high:3"
+    "6:high:5"
+    "7:high:3"
+    "8:high:5"
+    "9:high:5"
+    "10:nominal:5"
+    "11:high:5"
+    "12:high:3"
+    "13:high:3"
+    "14:high:3"
+    "15:high:5"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN15_low.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN15_low - every channel margin LOW, per-channel percentage
+# For the SWB CONN15 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:low:3"
+    "1:low:3"
+    "2:low:3"
+    "3:low:3"
+    "4:low:3"
+    "5:low:3"
+    "6:low:5"
+    "7:low:3"
+    "8:low:5"
+    "9:low:5"
+    "10:nominal:5"
+    "11:low:5"
+    "12:low:3"
+    "13:low:3"
+    "14:low:3"
+    "15:low:5"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN16_high.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN16_high - every channel margin HIGH, per-channel percentage
+# For the SWB CONN16 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:high:3"
+    "1:high:5"
+    "2:high:5"
+    "3:high:5"
+    "4:high:5"
+    "5:high:5"
+    "6:high:5"
+    "7:high:3"
+    "8:high:3"
+    "9:high:3"
+    "10:high:3"
+    "11:high:3"
+    "12:high:3"
+    "13:high:3"
+    "14:high:3"
+    "15:high:3"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/profiles/combo_SWB_CONN16_low.conf

@@ -0,0 +1,24 @@
+# Profile: combo_SWB_CONN16_low - every channel margin LOW, per-channel percentage
+# For the SWB CONN16 board only: the percentages follow that board's
+# rails, so applying it to a different CONN margins the wrong things.
+# Applied to whichever LTC2980 is currently loaded via margin_init
+# Format: "channel:operation:change_percent"
+
+PROFILE_CHANNELS=(
+    "0:low:3"
+    "1:low:5"
+    "2:low:5"
+    "3:low:5"
+    "4:low:5"
+    "5:low:5"
+    "6:low:5"
+    "7:low:3"
+    "8:low:3"
+    "9:low:3"
+    "10:low:3"
+    "11:low:3"
+    "12:low:3"
+    "13:low:3"
+    "14:low:3"
+    "15:low:3"
+)

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/script/margin_apply_profile_all.sh

@@ -17,17 +17,24 @@ BOARDS=(
     "Blanton_SWB1_CONN16"
 )
 
-# 對應的 profile 名稱（不含路徑與 .conf 副檔名），預設全部 comboA
+# 對應的 profile 名稱（不含路徑與 .conf 副檔名）。
+#
+# SWB 的 profile 是 per-CONN 的：百分比對應該片板子的軌，套到別的 CONN 會 margin
+# 到錯的東西，所以這裡不能全部填同一個名字。
+#
+# 這份預設是 HIGH 那一輪；LOW 那一輪把下面的 _high 全換成 _low 再跑一次
+# （或 sed -i 's/_high/_low/' 這個檔）。
+# CB 沒有 per-CONN profile，沿用通用的 combo_high3 / combo_low3。
 PROFILES=(
-    "comboA"    # Blanton_CB_CONN13
+    "combo_high3"               # Blanton_CB_CONN13   (低壓軌多，用通用 +3%)
-    "comboA"    # Blanton_SWB0_CONN13
+    "combo_SWB_CONN13_high"     # Blanton_SWB0_CONN13
-    "comboA"    # Blanton_SWB0_CONN14
+    "combo_SWB_CONN14_high"     # Blanton_SWB0_CONN14
-    "comboA"    # Blanton_SWB0_CONN15
+    "combo_SWB_CONN15_high"     # Blanton_SWB0_CONN15
-    "comboA"    # Blanton_SWB0_CONN16
+    "combo_SWB_CONN16_high"     # Blanton_SWB0_CONN16
-    "comboA"    # Blanton_SWB1_CONN13
+    "combo_SWB_CONN13_high"     # Blanton_SWB1_CONN13
-    "comboA"    # Blanton_SWB1_CONN14
+    "combo_SWB_CONN14_high"     # Blanton_SWB1_CONN14
-    "comboA"    # Blanton_SWB1_CONN15
+    "combo_SWB_CONN15_high"     # Blanton_SWB1_CONN15
-    "comboA"    # Blanton_SWB1_CONN16
+    "combo_SWB_CONN16_high"     # Blanton_SWB1_CONN16
 )
 
 # --- Source margin.sh if not already loaded ---

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/script/margin_save_all.sh

@@ -4,6 +4,10 @@
 # ⚠️  margin_save 會把目前的 margin / OV / UV 設定**永久寫入 NVM**，
 #     斷電後仍保留。執行前請務必先 margin_status 確認各 channel 狀態正確。
 #
+# 全部 9 顆請直接用 margin.sh v2.7.0 內建的 `margin_save all` —— 它有成功/失敗總結，
+# 跑完還會把 margin_init 切回你原本載入的那顆。這支只在「只想寫其中幾顆」時才需要，
+# 編下面的 BOARDS 陣列。
+#
 # Usage:
 #   source script/margin_save_all.sh
 

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_CB_CONN13.conf

@@ -41,7 +41,7 @@ CH3_VNOM="1.8";     CH3_NET="V1P8_ALW"
 CH4_VNOM="1.1";     CH4_NET="PWR_APU_VDDIO_SUS"
 CH5_VNOM="0.75";    CH5_NET="PWR_VDD_MISC_RUN"
 CH6_VNOM="0.78";    CH6_NET="PWR_APU_VDD_MEM_RUN"
-CH7_VNOM="0.8";     CH7_NET="V0P8_PHY2_DVDD"
+CH7_VNOM="0.816";   CH7_NET="V0P8_PHY2_DVDD"
 CH8_VNOM="0.8";     CH8_NET="V0P8_AVDD"
 CH9_VNOM="0.8";     CH9_NET="V0P8_PHY"
 CH10_VNOM="1.8";    CH10_NET="V1P8_FPGA"
@@ -49,4 +49,4 @@ CH11_VNOM="2.5";    CH11_NET="V2P5_FPGA"
 CH12_VNOM="1.1";    CH12_NET="V1P1_FPGA"
 CH13_VNOM="5.0";    CH13_NET="P5V_STBY"
 CH14_VNOM="3.3";    CH14_NET="P3V3_STBY"
-CH15_VNOM="0.8";    CH15_NET="V0P8_PHY2_AVDD"
+CH15_VNOM="0.816";  CH15_NET="V0P8_PHY2_AVDD"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB0_CONN13.conf

@@ -35,18 +35,18 @@ CHIP_POST_CMD=(
 # chip1: SWB0 (CONN13)
 # ============================================================
 CH0_VNOM="0.75";    CH0_NET="P0V75_DVDD_47"
-CH1_VNOM="0.75";    CH1_NET="P0V75_AVDD_47"
+CH1_VNOM="0.756";   CH1_NET="P0V75_AVDD_47"
-CH2_VNOM="1.5";     CH2_NET="P1V5_AVDD_47"
+CH2_VNOM="1.524";   CH2_NET="P1V5_AVDD_47"
-CH3_VNOM="0.9";     CH3_NET="P0V9_AVDD_47"
+CH3_VNOM="0.915";   CH3_NET="P0V9_AVDD_47"
-CH4_VNOM="1.8";     CH4_NET="P1V8_1"
+CH4_VNOM="1.816";   CH4_NET="P1V8_1"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_A3"
+CH5_VNOM="3.38";    CH5_NET="PVDD3_3V_SYNTH_LDO_A3"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_B1"
+CH6_VNOM="3.38";    CH6_NET="PVDD3_3V_SYNTH_LDO_B1"
-CH7_VNOM="1.8";     CH7_NET="P1V8_3"
+CH7_VNOM="1.816";   CH7_NET="P1V8_3"
 CH8_VNOM="1.8";     CH8_NET="P1V8_DVDDIO_3"
 CH9_VNOM="0.75";    CH9_NET="P0V75_DVDD_39"
-CH10_VNOM="0.75";   CH10_NET="P0V75_AVDD_39"
+CH10_VNOM="0.756";  CH10_NET="P0V75_AVDD_39"
-CH11_VNOM="1.5";    CH11_NET="P1V5_AVDD_39"
+CH11_VNOM="1.524";  CH11_NET="P1V5_AVDD_39"
-CH12_VNOM="0.9";    CH12_NET="P0V9_AVDD_39"
+CH12_VNOM="0.915";  CH12_NET="P0V9_AVDD_39"
 CH13_VNOM="1.5";    CH13_NET="PVDD1V5_2"
 CH14_VNOM="1.8";    CH14_NET="PVDD1V8_DUT"
 CH15_VNOM="1.2";    CH15_NET="PVDD_MDIO"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB0_CONN14.conf

@@ -34,16 +34,16 @@ CHIP_POST_CMD=(
 # ============================================================
 # chip1: SWB0 (CONN14)
 # ============================================================
-CH0_VNOM="0.75";    CH0_NET="P0V75_AVDD_7"
+CH0_VNOM="0.756";    CH0_NET="P0V75_AVDD_7"
-CH1_VNOM="1.5";     CH1_NET="P1V5_AVDD_7"
+CH1_VNOM="1.524";     CH1_NET="P1V5_AVDD_7"
-CH2_VNOM="0.9";     CH2_NET="P0V9_AVDD_7"
+CH2_VNOM="0.915";     CH2_NET="P0V9_AVDD_7"
-CH3_VNOM="1.8";     CH3_NET="P1V8_5"
+CH3_VNOM="1.816";     CH3_NET="P1V8_5"
-CH4_VNOM="1.8";     CH4_NET="P1V8_2"
+CH4_VNOM="1.816";     CH4_NET="P1V8_2"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_B2"
+CH5_VNOM="3.38";     CH5_NET="PVDD3_3V_SYNTH_LDO_B2"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_A2"
+CH6_VNOM="3.38";     CH6_NET="PVDD3_3V_SYNTH_LDO_A2"
-CH7_VNOM="3.3";     CH7_NET="PVDD3_3V_SYNTH_LDO_A1"
+CH7_VNOM="3.38";     CH7_NET="PVDD3_3V_SYNTH_LDO_A1"
-CH8_VNOM="1.5";     CH8_NET="PVDD1V5_TSC"
+CH8_VNOM="1.516";     CH8_NET="PVDD1V5_TSC"
-CH9_VNOM="1.5";     CH9_NET="PVDD1V5_ANLG"
+CH9_VNOM="1.516";     CH9_NET="PVDD1V5_ANLG"
 CH10_VNOM="-";      CH10_NET="NC"
 CH11_VNOM="-";      CH11_NET="NC"
 CH12_VNOM="1.5";    CH12_NET="PVDD1V5_1"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB0_CONN15.conf

@@ -34,19 +34,19 @@ CHIP_POST_CMD=(
 # ============================================================
 # chip1: SWB0 (CONN15)
 # ============================================================
-CH0_VNOM="1.5";     CH0_NET="P1V5_AVDD_55"
+CH0_VNOM="1.524";     CH0_NET="P1V5_AVDD_55"
-CH1_VNOM="0.9";     CH1_NET="P0V9_AVDD_55"
+CH1_VNOM="0.915";     CH1_NET="P0V9_AVDD_55"
 CH2_VNOM="0.75";    CH2_NET="P0V75_DVDD_63"
-CH3_VNOM="0.75";    CH3_NET="P0V75_AVDD_63"
+CH3_VNOM="0.756";    CH3_NET="P0V75_AVDD_63"
-CH4_VNOM="1.5";     CH4_NET="P1V5_AVDD_63"
+CH4_VNOM="1.524";     CH4_NET="P1V5_AVDD_63"
-CH5_VNOM="0.9";     CH5_NET="P0V9_AVDD_63"
+CH5_VNOM="0.915";     CH5_NET="P0V9_AVDD_63"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_B3"
+CH6_VNOM="3.38";     CH6_NET="PVDD3_3V_SYNTH_LDO_B3"
 CH7_VNOM="1.5";     CH7_NET="PVDD1V5_3"
 CH8_VNOM="0.85";    CH8_NET="P0V85_STBY"
 CH9_VNOM="1.8";     CH9_NET="P1V8_STBY"
 CH10_VNOM="-";      CH10_NET="NC"
 CH11_VNOM="3.3";    CH11_NET="P3V3_STBY"
-CH12_VNOM="0.9";    CH12_NET="PVDD0V9_2"
+CH12_VNOM="0.91";    CH12_NET="PVDD0V9_2"
 CH13_VNOM="0.75";   CH13_NET="P0V75_DVDD_55"
-CH14_VNOM="0.75";   CH14_NET="P0V75_AVDD_55"
+CH14_VNOM="0.756";   CH14_NET="P0V75_AVDD_55"
 CH15_VNOM="1.8";    CH15_NET="P1V8_DVDDIO_4"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB0_CONN16.conf

@@ -35,18 +35,18 @@ CHIP_POST_CMD=(
 # chip1: SWB0 (CONN16)
 # ============================================================
 CH0_VNOM="1.5";     CH0_NET="PVDD1V5_0"
-CH1_VNOM="1.8";     CH1_NET="P1V8_4"
+CH1_VNOM="1.816";   CH1_NET="P1V8_4"
-CH2_VNOM="3.3";     CH2_NET="PVDD3_3V_SYNTH_LDO_B5"
+CH2_VNOM="3.38";    CH2_NET="PVDD3_3V_SYNTH_LDO_B5"
-CH3_VNOM="3.3";     CH3_NET="PVDD3_3V_SYNTH_LDO_A5"
+CH3_VNOM="3.38";    CH3_NET="PVDD3_3V_SYNTH_LDO_A5"
-CH4_VNOM="3.3";     CH4_NET="PVDD3_3V_SYNTH_LDO_B4"
+CH4_VNOM="3.38";    CH4_NET="PVDD3_3V_SYNTH_LDO_B4"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_A4"
+CH5_VNOM="3.38";    CH5_NET="PVDD3_3V_SYNTH_LDO_A4"
-CH6_VNOM="3.3";     CH6_NET="P3V3"
+CH6_VNOM="3.327";   CH6_NET="P3V3"
-CH7_VNOM="0.8";     CH7_NET="PVDD0_8V_T3"
+CH7_VNOM="0.82";    CH7_NET="PVDD0_8V_T3"
 CH8_VNOM="0.75";    CH8_NET="P0V75_DVDD_1"
-CH9_VNOM="0.75";    CH9_NET="P0V75_AVDD_1"
+CH9_VNOM="0.756";   CH9_NET="P0V75_AVDD_1"
-CH10_VNOM="1.5";    CH10_NET="P1V5_AVDD_1"
+CH10_VNOM="1.524";  CH10_NET="P1V5_AVDD_1"
-CH11_VNOM="0.9";    CH11_NET="P0V9_AVDD_1"
+CH11_VNOM="0.915";  CH11_NET="P0V9_AVDD_1"
-CH12_VNOM="0.9";    CH12_NET="PVDD0V9_0"
+CH12_VNOM="0.915";  CH12_NET="PVDD0V9_0"
-CH13_VNOM="0.9";    CH13_NET="PVDD0V9_1"
+CH13_VNOM="0.91";   CH13_NET="PVDD0V9_1"
-CH14_VNOM="0.9";    CH14_NET="PVDD0V9_3"
+CH14_VNOM="0.915";  CH14_NET="PVDD0V9_3"
-CH15_VNOM="1.2";    CH15_NET="PVDD1V2_T3"
+CH15_VNOM="1.224";  CH15_NET="PVDD1V2_T3"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB1_CONN13.conf

@@ -35,18 +35,18 @@ CHIP_POST_CMD=(
 # chip1: SWB1 (CONN13)
 # ============================================================
 CH0_VNOM="0.75";    CH0_NET="P0V75_DVDD_47"
-CH1_VNOM="0.75";    CH1_NET="P0V75_AVDD_47"
+CH1_VNOM="0.756";   CH1_NET="P0V75_AVDD_47"
-CH2_VNOM="1.5";     CH2_NET="P1V5_AVDD_47"
+CH2_VNOM="1.524";   CH2_NET="P1V5_AVDD_47"
-CH3_VNOM="0.9";     CH3_NET="P0V9_AVDD_47"
+CH3_VNOM="0.915";   CH3_NET="P0V9_AVDD_47"
-CH4_VNOM="1.8";     CH4_NET="P1V8_1"
+CH4_VNOM="1.816";   CH4_NET="P1V8_1"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_A3"
+CH5_VNOM="3.38";    CH5_NET="PVDD3_3V_SYNTH_LDO_A3"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_B1"
+CH6_VNOM="3.38";    CH6_NET="PVDD3_3V_SYNTH_LDO_B1"
-CH7_VNOM="1.8";     CH7_NET="P1V8_3"
+CH7_VNOM="1.816";   CH7_NET="P1V8_3"
 CH8_VNOM="1.8";     CH8_NET="P1V8_DVDDIO_3"
 CH9_VNOM="0.75";    CH9_NET="P0V75_DVDD_39"
-CH10_VNOM="0.75";   CH10_NET="P0V75_AVDD_39"
+CH10_VNOM="0.756";  CH10_NET="P0V75_AVDD_39"
-CH11_VNOM="1.5";    CH11_NET="P1V5_AVDD_39"
+CH11_VNOM="1.524";  CH11_NET="P1V5_AVDD_39"
-CH12_VNOM="0.9";    CH12_NET="P0V9_AVDD_39"
+CH12_VNOM="0.915";  CH12_NET="P0V9_AVDD_39"
 CH13_VNOM="1.5";    CH13_NET="PVDD1V5_2"
 CH14_VNOM="1.8";    CH14_NET="PVDD1V8_DUT"
 CH15_VNOM="1.2";    CH15_NET="PVDD_MDIO"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB1_CONN14.conf

@@ -34,16 +34,16 @@ CHIP_POST_CMD=(
 # ============================================================
 # chip1: SWB1 (CONN14)
 # ============================================================
-CH0_VNOM="0.75";    CH0_NET="P0V75_AVDD_7"
+CH0_VNOM="0.756";    CH0_NET="P0V75_AVDD_7"
-CH1_VNOM="1.5";     CH1_NET="P1V5_AVDD_7"
+CH1_VNOM="1.524";     CH1_NET="P1V5_AVDD_7"
-CH2_VNOM="0.9";     CH2_NET="P0V9_AVDD_7"
+CH2_VNOM="0.915";     CH2_NET="P0V9_AVDD_7"
-CH3_VNOM="1.8";     CH3_NET="P1V8_5"
+CH3_VNOM="1.816";     CH3_NET="P1V8_5"
-CH4_VNOM="1.8";     CH4_NET="P1V8_2"
+CH4_VNOM="1.816";     CH4_NET="P1V8_2"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_B2"
+CH5_VNOM="3.38";     CH5_NET="PVDD3_3V_SYNTH_LDO_B2"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_A2"
+CH6_VNOM="3.38";     CH6_NET="PVDD3_3V_SYNTH_LDO_A2"
-CH7_VNOM="3.3";     CH7_NET="PVDD3_3V_SYNTH_LDO_A1"
+CH7_VNOM="3.38";     CH7_NET="PVDD3_3V_SYNTH_LDO_A1"
-CH8_VNOM="1.5";     CH8_NET="PVDD1V5_TSC"
+CH8_VNOM="1.516";     CH8_NET="PVDD1V5_TSC"
-CH9_VNOM="1.5";     CH9_NET="PVDD1V5_ANLG"
+CH9_VNOM="1.516";     CH9_NET="PVDD1V5_ANLG"
 CH10_VNOM="-";      CH10_NET="NC"
 CH11_VNOM="-";      CH11_NET="NC"
 CH12_VNOM="1.5";    CH12_NET="PVDD1V5_1"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB1_CONN15.conf

@@ -34,19 +34,19 @@ CHIP_POST_CMD=(
 # ============================================================
 # chip1: SWB1 (CONN15)
 # ============================================================
-CH0_VNOM="1.5";     CH0_NET="P1V5_AVDD_55"
+CH0_VNOM="1.524";     CH0_NET="P1V5_AVDD_55"
-CH1_VNOM="0.9";     CH1_NET="P0V9_AVDD_55"
+CH1_VNOM="0.915";     CH1_NET="P0V9_AVDD_55"
 CH2_VNOM="0.75";    CH2_NET="P0V75_DVDD_63"
-CH3_VNOM="0.75";    CH3_NET="P0V75_AVDD_63"
+CH3_VNOM="0.756";    CH3_NET="P0V75_AVDD_63"
-CH4_VNOM="1.5";     CH4_NET="P1V5_AVDD_63"
+CH4_VNOM="1.524";     CH4_NET="P1V5_AVDD_63"
-CH5_VNOM="0.9";     CH5_NET="P0V9_AVDD_63"
+CH5_VNOM="0.915";     CH5_NET="P0V9_AVDD_63"
-CH6_VNOM="3.3";     CH6_NET="PVDD3_3V_SYNTH_LDO_B3"
+CH6_VNOM="3.38";     CH6_NET="PVDD3_3V_SYNTH_LDO_B3"
 CH7_VNOM="1.5";     CH7_NET="PVDD1V5_3"
 CH8_VNOM="0.85";    CH8_NET="P0V85_STBY"
 CH9_VNOM="1.8";     CH9_NET="P1V8_STBY"
 CH10_VNOM="-";      CH10_NET="NC"
 CH11_VNOM="3.3";    CH11_NET="P3V3_STBY"
-CH12_VNOM="0.9";    CH12_NET="PVDD0V9_2"
+CH12_VNOM="0.91";    CH12_NET="PVDD0V9_2"
 CH13_VNOM="0.75";   CH13_NET="P0V75_DVDD_55"
-CH14_VNOM="0.75";   CH14_NET="P0V75_AVDD_55"
+CH14_VNOM="0.756";   CH14_NET="P0V75_AVDD_55"
 CH15_VNOM="1.8";    CH15_NET="P1V8_DVDDIO_4"

src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings/Blanton_SWB1_CONN16.conf

@@ -35,18 +35,18 @@ CHIP_POST_CMD=(
 # chip1: SWB1 (CONN16)
 # ============================================================
 CH0_VNOM="1.5";     CH0_NET="PVDD1V5_0"
-CH1_VNOM="1.8";     CH1_NET="P1V8_4"
+CH1_VNOM="1.816";   CH1_NET="P1V8_4"
-CH2_VNOM="3.3";     CH2_NET="PVDD3_3V_SYNTH_LDO_B5"
+CH2_VNOM="3.38";    CH2_NET="PVDD3_3V_SYNTH_LDO_B5"
-CH3_VNOM="3.3";     CH3_NET="PVDD3_3V_SYNTH_LDO_A5"
+CH3_VNOM="3.38";    CH3_NET="PVDD3_3V_SYNTH_LDO_A5"
-CH4_VNOM="3.3";     CH4_NET="PVDD3_3V_SYNTH_LDO_B4"
+CH4_VNOM="3.38";    CH4_NET="PVDD3_3V_SYNTH_LDO_B4"
-CH5_VNOM="3.3";     CH5_NET="PVDD3_3V_SYNTH_LDO_A4"
+CH5_VNOM="3.38";    CH5_NET="PVDD3_3V_SYNTH_LDO_A4"
-CH6_VNOM="3.3";     CH6_NET="P3V3"
+CH6_VNOM="3.327";   CH6_NET="P3V3"
-CH7_VNOM="0.8";     CH7_NET="PVDD0_8V_T3"
+CH7_VNOM="0.82";    CH7_NET="PVDD0_8V_T3"
 CH8_VNOM="0.75";    CH8_NET="P0V75_DVDD_1"
-CH9_VNOM="0.75";    CH9_NET="P0V75_AVDD_1"
+CH9_VNOM="0.756";   CH9_NET="P0V75_AVDD_1"
-CH10_VNOM="1.5";    CH10_NET="P1V5_AVDD_1"
+CH10_VNOM="1.524";  CH10_NET="P1V5_AVDD_1"
-CH11_VNOM="0.9";    CH11_NET="P0V9_AVDD_1"
+CH11_VNOM="0.915";  CH11_NET="P0V9_AVDD_1"
-CH12_VNOM="0.9";    CH12_NET="PVDD0V9_0"
+CH12_VNOM="0.915";  CH12_NET="PVDD0V9_0"
-CH13_VNOM="0.9";    CH13_NET="PVDD0V9_1"
+CH13_VNOM="0.91";   CH13_NET="PVDD0V9_1"
-CH14_VNOM="0.9";    CH14_NET="PVDD0V9_3"
+CH14_VNOM="0.915";  CH14_NET="PVDD0V9_3"
-CH15_VNOM="1.2";    CH15_NET="PVDD1V2_T3"
+CH15_VNOM="1.224";  CH15_NET="PVDD1V2_T3"

src/Script_ABC_Blanton/Blanton_Script/TH6_SWB0_power_readback.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# =============================================================================
+# TH6_SWB0_power_readback.sh  --  SWB0 rail power from the platform sensors
+# =============================================================================
+# Version History:
+#   V1.1.0  2026-08-28  'show platform voltage' and 'show platform current' are
+#                       now read ONCE each instead of once per rail. The old
+#                       loop ran them 19 times apiece (38 invocations of a slow
+#                       Python CLI) and every sample came from a different
+#                       instant, so the rails were never actually measured
+#                       together. Output format is unchanged.
+#                       Rails missing from the tables are reported on stderr
+#                       instead of silently contributing 0.000 V / 0.00 W.
+#   V1.0.0  2026-08-28  First version.
+# =============================================================================
+#
+# Reads the two platform sensor tables:
+#     'show platform voltage'  ->  <RAIL>          in mV
+#     'show platform current'  ->  <RAIL>_CURRENT  in mA
+# and reports V x I per rail plus the total.
+#
+# For a loaded reading, start traffic first:  blanton_tr518.sh start
+# =============================================================================
+
+# --- Rails to report, in output order (edit this list) ---
+rails=(
+    "SWB0_0V9_ANLG0"
+    "SWB0_0V9_ANLG1"
+    "SWB0_0V75_ANLG0"
+    "SWB0_0V75_ANLG1"
+    "SWB0_PHYTILE_P0"
+    "SWB0_PHYTILE_P1"
+    "SWB0_PHYTILE_P2"
+    "SWB0_PHYTILE_P3"
+    "SWB0_PHYTILE_P4"
+    "SWB0_PHYTILE_P5"
+    "SWB0_PHYTILE_P6"
+    "SWB0_PHYTILE_P7"
+    "SWB0_PVDD1V5_CNDR0"
+    "SWB0_PVDD1V5_CNDR1"
+    "SWB0_PVDDA_PHYT0"
+    "SWB0_PVDDA_PHYT1"
+    "SWB0_PVDDA_PHYT2"
+    "SWB0_PVDDA_PHYT3"
+    "SWB0_TH6_CORE"
+)
+
+# --- One snapshot of each table ---------------------------------------------
+# Both are taken up front, back to back, so every rail below comes from the same
+# moment. Under tr 518 the currents move a lot; re-reading per rail meant the
+# total was a sum of readings taken seconds apart.
+V_TABLE="$(show platform voltage 2>/dev/null)"
+C_TABLE="$(show platform current 2>/dev/null)"
+
+if [ -z "$V_TABLE" ] || [ -z "$C_TABLE" ]; then
+    echo "ERROR: 'show platform voltage/current' returned nothing" >&2
+    exit 1
+fi
+
+# --- Join and report ---------------------------------------------------------
+# Sensor name is field 1 and the value field 2 in both tables; header and rule
+# lines drop out because their field 2 is not numeric.
+{
+    printf '%s\n' "$V_TABLE"
+    echo "@@@SPLIT@@@"
+    printf '%s\n' "$C_TABLE"
+} | awk -v rails="${rails[*]}" '
+    BEGIN { n = split(rails, R, " "); sec = 1 }
+    /^@@@SPLIT@@@$/ { sec = 2; next }
+    {
+        if (NF < 2) next
+        name = $1; val = $2
+        if (val !~ /^[0-9]+(\.[0-9]+)?$/) next     # header / ---- / blank
+        if (sec == 2) CUR[name] = val + 0
+        else          VOLT[name] = val + 0
+    }
+    END {
+        total = 0
+        for (i = 1; i <= n; i++) {
+            rail = R[i]; cname = rail "_CURRENT"
+            haveV = (rail in VOLT); haveC = (cname in CUR)
+            if (!haveV || !haveC)
+                printf "WARN: %s missing from the sensor table (%s%s%s) -- counted as 0 W\n", \
+                       rail, (haveV ? "" : "no voltage"), \
+                       ((!haveV && !haveC) ? ", " : ""), \
+                       (haveC ? "" : "no current") > "/dev/stderr"
+            v = haveV ? VOLT[rail] : 0
+            c = haveC ? CUR[cname] : 0
+            p = sprintf("%.2f", (v/1000)*(c/1000))
+            printf "%s: Voltage=%.3f V, Current=%.3f A, Power=%.2f W\n", rail, v/1000, c/1000, p
+            total = sprintf("%.2f", total + p)
+        }
+        print "----------------------------------------"
+        printf "TOTAL POWER: %.2f W\n", total
+    }'

src/Script_ABC_Blanton/Blanton_Script/TH6_SWB1_power_readback.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# =============================================================================
+# TH6_SWB1_power_readback.sh  --  SWB1 rail power from the platform sensors
+# =============================================================================
+# Version History:
+#   V1.1.0  2026-08-28  'show platform voltage' and 'show platform current' are
+#                       now read ONCE each instead of once per rail. The old
+#                       loop ran them 19 times apiece (38 invocations of a slow
+#                       Python CLI) and every sample came from a different
+#                       instant, so the rails were never actually measured
+#                       together. Output format is unchanged.
+#                       Rails missing from the tables are reported on stderr
+#                       instead of silently contributing 0.000 V / 0.00 W.
+#   V1.0.0  2026-08-28  First version.
+# =============================================================================
+#
+# Reads the two platform sensor tables:
+#     'show platform voltage'  ->  <RAIL>          in mV
+#     'show platform current'  ->  <RAIL>_CURRENT  in mA
+# and reports V x I per rail plus the total.
+#
+# For a loaded reading, start traffic first:  blanton_tr518.sh start
+# =============================================================================
+
+# --- Rails to report, in output order (edit this list) ---
+rails=(
+    "SWB1_0V9_ANLG0"
+    "SWB1_0V9_ANLG1"
+    "SWB1_0V75_ANLG0"
+    "SWB1_0V75_ANLG1"
+    "SWB1_PHYTILE_P0"
+    "SWB1_PHYTILE_P1"
+    "SWB1_PHYTILE_P2"
+    "SWB1_PHYTILE_P3"
+    "SWB1_PHYTILE_P4"
+    "SWB1_PHYTILE_P5"
+    "SWB1_PHYTILE_P6"
+    "SWB1_PHYTILE_P7"
+    "SWB1_PVDD1V5_CNDR0"
+    "SWB1_PVDD1V5_CNDR1"
+    "SWB1_PVDDA_PHYT0"
+    "SWB1_PVDDA_PHYT1"
+    "SWB1_PVDDA_PHYT2"
+    "SWB1_PVDDA_PHYT3"
+    "SWB1_TH6_CORE"
+)
+
+# --- One snapshot of each table ---------------------------------------------
+# Both are taken up front, back to back, so every rail below comes from the same
+# moment. Under tr 518 the currents move a lot; re-reading per rail meant the
+# total was a sum of readings taken seconds apart.
+V_TABLE="$(show platform voltage 2>/dev/null)"
+C_TABLE="$(show platform current 2>/dev/null)"
+
+if [ -z "$V_TABLE" ] || [ -z "$C_TABLE" ]; then
+    echo "ERROR: 'show platform voltage/current' returned nothing" >&2
+    exit 1
+fi
+
+# --- Join and report ---------------------------------------------------------
+# Sensor name is field 1 and the value field 2 in both tables; header and rule
+# lines drop out because their field 2 is not numeric.
+{
+    printf '%s\n' "$V_TABLE"
+    echo "@@@SPLIT@@@"
+    printf '%s\n' "$C_TABLE"
+} | awk -v rails="${rails[*]}" '
+    BEGIN { n = split(rails, R, " "); sec = 1 }
+    /^@@@SPLIT@@@$/ { sec = 2; next }
+    {
+        if (NF < 2) next
+        name = $1; val = $2
+        if (val !~ /^[0-9]+(\.[0-9]+)?$/) next     # header / ---- / blank
+        if (sec == 2) CUR[name] = val + 0
+        else          VOLT[name] = val + 0
+    }
+    END {
+        total = 0
+        for (i = 1; i <= n; i++) {
+            rail = R[i]; cname = rail "_CURRENT"
+            haveV = (rail in VOLT); haveC = (cname in CUR)
+            if (!haveV || !haveC)
+                printf "WARN: %s missing from the sensor table (%s%s%s) -- counted as 0 W\n", \
+                       rail, (haveV ? "" : "no voltage"), \
+                       ((!haveV && !haveC) ? ", " : ""), \
+                       (haveC ? "" : "no current") > "/dev/stderr"
+            v = haveV ? VOLT[rail] : 0
+            c = haveC ? CUR[cname] : 0
+            p = sprintf("%.2f", (v/1000)*(c/1000))
+            printf "%s: Voltage=%.3f V, Current=%.3f A, Power=%.2f W\n", rail, v/1000, c/1000, p
+            total = sprintf("%.2f", total + p)
+        }
+        print "----------------------------------------"
+        printf "TOTAL POWER: %.2f W\n", total
+    }'

src/Script_ABC_Blanton/Blanton_Script/blanton_ber.sh

@@ -0,0 +1,495 @@
+#!/usr/bin/env bash
+# =============================================================================
+# blanton_ber.sh  --  SerDes BER test over every cabled port (PRBS via phydiag)
+# =============================================================================
+# Version History:
+#   V1.0.1  2026-08-28  Fix: every lane reported NA and the Port column showed
+#                       "NA". bcmcmd returns CRLF, and the BER is the last token
+#                       on its line, so the CR stayed glued to the number: it
+#                       failed the numeric test (-> NA) and printing it sent the
+#                       cursor back to column 1, so the RESULT column overwrote
+#                       the start of the row. The parser now strips CR first.
+#                       (The traffic report never hit this -- there the counter
+#                       is followed by a delta, so the CR was trimmed with it.)
+#   V1.0.0  2026-08-28  First version. Bash port of tools/BER_Test.txt.
+#                       init/clear/start/stop/report, -u 0|1|all (default both).
+#                       report parses 'prbsstat Ber' into a per-lane table with a
+#                       PASS/FAIL against BER_MAX (default 1e-6) and a summary
+#                       across units at the very bottom.
+# =============================================================================
+#
+# This is the WHOLE-SWITCH BER sweep: every cabled port, both lanes, PRBS-31
+# through the SerDes. Not to be confused with port_prbs_monitor.sh, which drives
+# the two 100G uplinks only and polls them continuously.
+#
+# Order of operations (matches tools/BER_Test.txt):
+#     init    phydiag <ports> prbs set p=3        arm PRBS on every lane
+#             phydiag <ports> prbs get            confirm every lane locked
+#     start   phydiag <ports> prbsstat STArt Interval=<n>
+#     ...wait at least one Interval...
+#     report  phydiag <ports> prbsstat Ber        read + judge
+#     stop    phydiag <ports> prbsstat STOp
+#     clear   phydiag <ports> prbs clear          disarm, release the lanes
+#
+# ⚠️ 'clear' disarms PRBS -- run 'init' again before another measurement.
+# ⚠️ PRBS takes the SerDes out of normal operation: the links report DOWN and no
+#    traffic passes while it is armed. Do not run this alongside
+#    blanton_traffic_linespeed or blanton_tr518.
+#
+# Usage (run directly):
+#   ./blanton_ber.sh init            # both units
+#   ./blanton_ber.sh start -u 0      # unit 0 only
+#   ./blanton_ber.sh report
+#   ./blanton_ber.sh stop
+#   ./blanton_ber.sh clear
+#
+# Usage (sourced, like the other blanton_*.sh tools):
+#   source blanton_ber.sh
+#   blanton_ber report -u 1
+#
+# Options:
+#   -u|--unit <0|1|all|0,1>  bcmcmd unit(s). Default: $BER_UNITS ("0 1")
+#   -c|--criteria <ber>      report: PASS threshold (default $BER_MAX)
+#   -i|--interval <sec>      start: prbsstat Interval (default $BER_INTERVAL)
+#   -p|--ports <list>        override the port list
+#   -F|--fail-only           report: list only the lanes that FAIL
+#      --tsv                 report: tab-separated (paste into Excel)
+#      --raw                 report: also print the raw 'prbsstat Ber' output
+#      --color|--no-color    report: force / disable colours
+#   -f|--file <log>          report: parse a saved console log, do not touch DUT
+#   -d|--debug               print every bcmcmd before running it
+#   -n|--dry-run             print commands only, do not touch the DUT
+#   -h|--help                help
+#
+# Environment overrides:
+#   BCMCMD_CMD=bcmcmd  BER_UNITS="0 1"  BER_MAX=1e-6  BER_INTERVAL=30
+#   BER_PORTS="1-24,..."  BER_POLY=p=3  BER_LOG_DIR=/tmp  DEBUG_MODE=1
+# =============================================================================
+
+# === Config ==================================================================
+BCMCMD_CMD="${BCMCMD_CMD:-bcmcmd}"
+BER_UNITS="${BER_UNITS:-0 1}"        # one DUT = two switch boards (0 and 1)
+
+# The cabled ports, in bcm logical-port numbering. Same list as
+# blanton_traffic_linespeed.sh's TL_PS_PORTS -- kept as one string so it can be
+# pasted straight from/into a manual phydiag command.
+BER_PORTS="${BER_PORTS:-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}"
+
+BER_POLY="${BER_POLY:-p=3}"          # passed to 'prbs set'
+BER_INTERVAL="${BER_INTERVAL:-30}"   # passed to 'prbsstat STArt Interval='
+
+# PASS threshold. A lane PASSES when its BER is strictly BELOW this.
+# 1e-6 is the acceptance figure for this project; the measured lanes sit around
+# 1e-13..1e-8, so anything near the threshold is already a real finding.
+BER_MAX="${BER_MAX:-1e-6}"
+
+BER_LOG_DIR="${BER_LOG_DIR:-/tmp}"   # where the raw 'prbsstat Ber' capture goes
+BER_FAIL_ONLY=${BER_FAIL_ONLY:-0}
+BER_TSV=${BER_TSV:-0}
+BER_RAW=${BER_RAW:-0}
+BER_REPORT_FILE=""                   # -f <log>: parse this instead of the DUT
+BER_COLOR="${BER_COLOR:-auto}"       # auto|always|never
+
+DEBUG_MODE=${DEBUG_MODE:-0}
+BER_DRY_RUN=${BER_DRY_RUN:-0}
+
+# === Logging =================================================================
+_ber_info() { echo -e "[\033[34mINFO\033[0m] $*"; }
+_ber_ok()   { echo -e "[\033[32m OK \033[0m] $*"; }
+_ber_warn() { echo -e "[\033[33mWARN\033[0m] $*" >&2; }
+_ber_err()  { echo -e "[\033[31mERR \033[0m] $*" >&2; }
+_ber_dbg()  { [ "$DEBUG_MODE" = "1" ] && echo -e "\033[90m[DEBG] $*\033[0m" >&2; return 0; }
+
+# === bcmcmd wrapper ==========================================================
+# stdin closed for the same reason as blanton_traffic_linespeed.sh: bcmcmd
+# otherwise inherits the caller's stdin and eats what a surrounding loop reads.
+#
+# bcmcmd exits 0 even when the BCM shell refused the command, so the output is
+# pattern-matched as well. And it exits NON-zero on long-running commands whose
+# response poll times out while the command is in fact fine -- that one is
+# tolerated (the blanton_tr518.sh lesson).
+BER_ERR_PAT="${BER_ERR_PAT:-ERROR|Failed to execute|Invalid|Syntax error|Unavailable|Unknown command}"
+BER_BENIGN_PAT="${BER_BENIGN_PAT:-polling socket timeout}"
+
+# _ber_bcm <unit> <phydiag args...>  -- wraps in dsh -c 'phydiag <ports> ...'
+# echoes the DUT output on stdout, returns 0 ok / 1 failed
+_ber_bcm() {
+    local unit="$1"; shift
+    local inner="phydiag ${BER_PORTS} $*"
+    local cmd="dsh -c '${inner}'"
+    _ber_dbg "$BCMCMD_CMD -n $unit -c \"${cmd}\""
+    if [ "$BER_DRY_RUN" = "1" ]; then
+        echo "[DRY ] $BCMCMD_CMD -n $unit -c \" ${cmd} \"" >&2
+        return 0
+    fi
+    local out rc
+    out=$("$BCMCMD_CMD" -n "$unit" -c "$cmd" </dev/null 2>&1); rc=$?
+    printf '%s\n' "$out"
+    if echo "$out" | grep -qiE "$BER_ERR_PAT"; then
+        _ber_err "unit $unit: the BCM shell rejected 'phydiag ... $*'"
+        return 1
+    fi
+    if [ "$rc" -ne 0 ] && ! echo "$out" | grep -qiE "$BER_BENIGN_PAT"; then
+        _ber_err "unit $unit: bcmcmd exited $rc on 'phydiag ... $*'"
+        return 1
+    fi
+    return 0
+}
+
+_ber_units_check() {
+    local u ok=""
+    for u in $BER_UNITS; do
+        case "$u" in
+            0|1) ok="$ok $u" ;;
+            *)   _ber_err "invalid unit '$u' (use 0, 1 or all)"; return 1 ;;
+        esac
+    done
+    [ -n "$ok" ] || { _ber_err "no unit selected"; return 1; }
+    BER_UNITS="${ok# }"
+    return 0
+}
+
+_ber_use_color() {
+    case "$BER_COLOR" in
+        always|1|yes) return 0 ;;
+        never|0|no)   return 1 ;;
+        *)            [ -t 1 ] && [ "$BER_TSV" != "1" ] ;;
+    esac
+}
+
+# === init ====================================================================
+# prbs set + prbs get. The 'get' is not decoration: a lane that did not lock
+# still reports a BER later, and it is a meaningless one.
+blanton_ber_init() {
+    _ber_units_check || return 1
+    local unit out total ok rc=0
+    for unit in $BER_UNITS; do
+        _ber_info "unit $unit: prbs set ${BER_POLY} on ${BER_PORTS}"
+        _ber_bcm "$unit" "prbs set ${BER_POLY}" >/dev/null || { rc=1; continue; }
+
+        out=$(_ber_bcm "$unit" "prbs get") || { rc=1; continue; }
+        [ "$BER_DRY_RUN" = "1" ] && continue
+        # lines look like:  "  185 : PRBS OK!has been unlocked since last call"
+        total=$(printf '%s\n' "$out" | grep -cE '^[ \t]*[0-9]+[ \t]*:')
+        ok=$(printf '%s\n'    "$out" | grep -cE '^[ \t]*[0-9]+[ \t]*:.*PRBS OK')
+        if [ "$total" -eq 0 ]; then
+            _ber_err "unit $unit: 'prbs get' reported no lanes at all"
+            rc=1
+        elif [ "$ok" -eq "$total" ]; then
+            _ber_ok "unit $unit: $ok/$total ports locked"
+        else
+            _ber_warn "unit $unit: only $ok/$total ports locked -- the rest will report a meaningless BER:"
+            printf '%s\n' "$out" | grep -E '^[ \t]*[0-9]+[ \t]*:' | grep -v 'PRBS OK' >&2
+            rc=2
+        fi
+    done
+    return $rc
+}
+
+# === clear ===================================================================
+blanton_ber_clear() {
+    _ber_units_check || return 1
+    local unit rc=0
+    for unit in $BER_UNITS; do
+        _ber_info "unit $unit: prbs clear"
+        _ber_bcm "$unit" "prbs clear" >/dev/null || rc=1
+    done
+    [ "$rc" -eq 0 ] && _ber_ok "PRBS disarmed on unit(s): $BER_UNITS -- run 'init' before measuring again"
+    return $rc
+}
+
+# === start ===================================================================
+blanton_ber_start() {
+    _ber_units_check || return 1
+    local unit rc=0
+    for unit in $BER_UNITS; do
+        _ber_info "unit $unit: prbsstat STArt Interval=${BER_INTERVAL}"
+        _ber_bcm "$unit" "prbsstat STArt Interval=${BER_INTERVAL}" >/dev/null || rc=1
+    done
+    if [ "$rc" -eq 0 ]; then
+        _ber_ok "BER accumulation running on unit(s): $BER_UNITS"
+        _ber_info "wait at least ${BER_INTERVAL}s before 'report' -- a shorter run has not accumulated a full interval"
+    fi
+    return $rc
+}
+
+# === stop ====================================================================
+blanton_ber_stop() {
+    _ber_units_check || return 1
+    local unit rc=0
+    for unit in $BER_UNITS; do
+        _ber_info "unit $unit: prbsstat STOp"
+        _ber_bcm "$unit" "prbsstat STOp" >/dev/null || rc=1
+    done
+    if [ "$rc" -eq 0 ]; then
+        _ber_ok "BER accumulation stopped on unit(s): $BER_UNITS"
+        _ber_info "PRBS is still armed -- 'clear' releases the lanes and restores normal operation"
+    fi
+    return $rc
+}
+
+# === report ==================================================================
+# Parses 'prbsstat Ber' output:
+#     port     BER
+#     ====
+#     1[0] : 3.53e-11
+#     1[1] : 4.00e-11
+# into <port> <lane> <ber> <verdict>, PASS when ber < BER_MAX.
+# _ber_render <logfile> [side_file] -> 0 all PASS, 2 any FAIL/NA, 1 parse error
+_ber_render() {
+    local log="$1" side="${2:-/dev/null}" color=0
+    _ber_use_color && color=1
+    awk -v MAXBER="$BER_MAX" \
+        -v FAILONLY="$BER_FAIL_ONLY" \
+        -v TSV="$BER_TSV" \
+        -v COLOR="$color" \
+        -v SIDE="$side" '
+    function vc(v) {
+        if (!COLOR) return v
+        if (v == "PASS") return "\033[32m" v "\033[0m"
+        if (v == "FAIL") return "\033[31m" v "\033[0m"
+        return "\033[33m" v "\033[0m"
+    }
+    BEGIN {
+        LIM = MAXBER + 0
+        NC = 4
+        HDR[1] = "Port";   AL[1] = 1
+        HDR[2] = "Lane";   AL[2] = 1
+        HDR[3] = "BER";    AL[3] = 1
+        HDR[4] = "RESULT"; AL[4] = 1
+        worst = -1; worstlane = "-"
+    }
+    # bcmcmd hands back CRLF. On the cd/traffic report the counter is followed by
+    # a delta, so the CR got trimmed with the rest of the line; here the BER is
+    # the LAST token, so the CR sticks to the number -- it failed the numeric
+    # test (every lane NA) and, worse, printing it moved the cursor back to
+    # column 1 so the RESULT column overwrote the start of the row.
+    { gsub(/\r/, "") }
+
+    {
+        # "  203[1] : 5.05e-09"   (leading spaces vary, "====" separators ignored)
+        if ($0 !~ /^[ \t]*[0-9]+\[[0-9]+\][ \t]*:/) next
+        line = $0
+        sub(/^[ \t]+/, "", line)
+        p  = index(line, "[")
+        q  = index(line, "]")
+        c  = index(line, ":")
+        port = substr(line, 1, p - 1)
+        lane = substr(line, p + 1, q - p - 1)
+        ber  = substr(line, c + 1)
+        gsub(/^[ \t\r]+|[ \t\r]+$/, "", ber)
+        sub(/[ \t\r].*$/, "", ber)
+        seen++
+        n++
+        PORT[n] = port; LANE[n] = lane; BERS[n] = ber
+        # a lane that reported something non-numeric has no usable measurement
+        if (ber ~ /^[0-9]+(\.[0-9]+)?([eE][-+]?[0-9]+)?$/) {
+            v = ber + 0
+            if (v < LIM) { V[n] = "PASS"; npass++ }
+            else         { V[n] = "FAIL"; nfail++ }
+            if (v > worst) { worst = v; worstlane = port "[" lane "]"; worststr = ber }
+        } else {
+            V[n] = "NA"; nna++
+        }
+    }
+    END {
+        if (seen == 0) {
+            print "error: no \"<port>[<lane>] : <ber>\" line found in the log" > "/dev/stderr"
+            exit 1
+        }
+        # column widths over the rows that will actually be printed
+        for (c2 = 1; c2 <= NC; c2++) w[c2] = length(HDR[c2])
+        for (i = 1; i <= n; i++) {
+            if (FAILONLY && V[i] == "PASS") continue
+            if (length(PORT[i]) > w[1]) w[1] = length(PORT[i])
+            if (length(LANE[i]) > w[2]) w[2] = length(LANE[i])
+            if (length(BERS[i]) > w[3]) w[3] = length(BERS[i])
+            if (length(V[i])    > w[4]) w[4] = length(V[i])
+        }
+        for (c2 = 1; c2 <= NC; c2++) w[c2] += 2
+
+        if (TSV) {
+            print HDR[1] "\t" HDR[2] "\t" HDR[3] "\t" HDR[4]
+            for (i = 1; i <= n; i++) {
+                if (FAILONLY && V[i] == "PASS") continue
+                print PORT[i] "\t" LANE[i] "\t" BERS[i] "\t" V[i]
+            }
+        } else {
+            printf "%*s%*s%*s%*s\n", w[1], HDR[1], w[2], HDR[2], w[3], HDR[3], w[4], HDR[4]
+            for (i = 1; i <= n; i++) {
+                if (FAILONLY && V[i] == "PASS") continue
+                printf "%*s%*s%*s", w[1], PORT[i], w[2], LANE[i], w[3], BERS[i]
+                # pad on the plain text, then colour, so the columns stay aligned
+                printf "%*s%s\n", w[4] - length(V[i]), "", vc(V[i])
+            }
+            if (FAILONLY && nfail == 0 && nna == 0)
+                print "  (no failing lane)"
+        }
+
+        print ""
+        printf "# lanes measured : %d\n", n
+        printf "# %s %d  %s %d  %s %d  (criteria BER < %s)\n", \
+               vc("PASS"), npass + 0, vc("FAIL"), nfail + 0, vc("NA"), nna + 0, MAXBER
+        if (worst >= 0)
+            printf "# worst lane     : %s  %s\n", worstlane, worststr
+        if (SIDE != "" && SIDE != "/dev/null")
+            printf "SUM %d %d %d %d %s %s\n", n, npass + 0, nfail + 0, nna + 0, \
+                   (worst >= 0 ? worststr : "-"), worstlane > SIDE
+        exit (nfail || nna) ? 2 : 0
+    }' "$log"
+}
+
+# _ber_summary <stamp> -- one table for every unit, printed last
+_ber_summary() {
+    local stamp="$1" unit side g r y n worst=0
+    g=$'\033[32m'; r=$'\033[31m'; y=$'\033[33m'; n=$'\033[0m'
+    _ber_use_color || { g=""; r=""; y=""; n=""; }
+
+    echo ""
+    echo "===== summary : all units ====="
+    printf '%-8s %8s %8s %8s %8s  %-12s %-10s %s\n' \
+           "Unit" "LANES" "PASS" "FAIL" "NA" "WORST BER" "WORST LANE" "RESULT"
+
+    local tag lanes pass fail na wber wlane v any=0
+    for unit in $BER_UNITS; do
+        side="$BER_LOG_DIR/berside_unit${unit}_${stamp}"
+        [ -r "$side" ] || continue
+        read -r tag lanes pass fail na wber wlane < "$side" 2>/dev/null
+        [ "$tag" = "SUM" ] || continue
+        any=1
+        if [ "${fail:-0}" -gt 0 ] || [ "${na:-0}" -gt 0 ]; then
+            v="${r}FAIL${n}"; worst=2
+        else
+            v="${g}PASS${n}"
+        fi
+        printf '%-8s %8s %8s %8s %8s  %-12s %-10s %b\n' \
+               "unit $unit" "$lanes" "$pass" "$fail" "$na" "$wber" "$wlane" "$v"
+    done
+    [ "$any" = "1" ] || echo "  (no unit produced a result)"
+    echo ""
+    printf 'criteria: BER < %s\n' "$BER_MAX"
+    echo ""
+    return "$worst"
+}
+
+blanton_ber_report() {
+    local unit log side rc worst=0 stamp
+
+    # -f <log>: offline, no DUT access, no unit loop -> no cross-unit summary
+    if [ -n "$BER_REPORT_FILE" ]; then
+        [ -r "$BER_REPORT_FILE" ] || { _ber_err "cannot read log '$BER_REPORT_FILE'"; return 1; }
+        _ber_info "report from log: $BER_REPORT_FILE (criteria BER < $BER_MAX)" >&2
+        _ber_render "$BER_REPORT_FILE"; return $?
+    fi
+
+    _ber_units_check || return 1
+    if [ "$BER_DRY_RUN" = "1" ]; then
+        for unit in $BER_UNITS; do _ber_bcm "$unit" "prbsstat Ber" >/dev/null; done
+        return 0
+    fi
+
+    stamp=$(date +%Y%m%d_%H%M%S 2>/dev/null || echo now)
+    for unit in $BER_UNITS; do
+        log="$BER_LOG_DIR/prbsber_unit${unit}_${stamp}.log"
+        side="$BER_LOG_DIR/berside_unit${unit}_${stamp}"
+        : > "$side"
+        if ! _ber_bcm "$unit" "prbsstat Ber" > "$log" 2>&1; then
+            _ber_err "unit $unit: 'prbsstat Ber' failed (see $log)"; worst=1; continue
+        fi
+        [ "$BER_RAW" = "1" ] && { echo "----- unit $unit : raw prbsstat Ber -----"; cat "$log"; }
+        echo "===== unit $unit : PRBS BER report (raw: $log) ====="
+        _ber_render "$log" "$side"; rc=$?
+        [ "$rc" -gt "$worst" ] && worst=$rc
+        case "$rc" in
+            0) _ber_ok   "unit $unit: every lane below $BER_MAX" ;;
+            2) _ber_warn "unit $unit: at least one lane FAIL/NA" ;;
+            *) _ber_err  "unit $unit: report parse error" ;;
+        esac
+    done
+
+    _ber_summary "$stamp"; rc=$?
+    [ "$rc" -gt "$worst" ] && worst=$rc
+    rm -f "$BER_LOG_DIR"/berside_unit*_"${stamp}"
+    return "$worst"
+}
+
+# === Help ====================================================================
+blanton_ber_help() {
+    echo -e "\033[1mblanton_ber.sh - SerDes BER test over every cabled port (PRBS via phydiag)\033[0m"
+    echo ""
+    echo -e "  Units    : \033[36m$BER_UNITS\033[0m    poly: \033[36m$BER_POLY\033[0m    interval: \033[36m${BER_INTERVAL}s\033[0m"
+    echo -e "  Criteria : BER < \033[36m$BER_MAX\033[0m"
+    echo -e "  Ports    : \033[36m$BER_PORTS\033[0m"
+    echo ""
+    echo -e "\033[1mSubcommands\033[0m"
+    echo -e "  \033[33minit\033[0m     prbs set $BER_POLY  +  prbs get (checks every lane locked)"
+    echo -e "  \033[33mstart\033[0m    prbsstat STArt Interval=$BER_INTERVAL"
+    echo -e "  \033[33mreport\033[0m   prbsstat Ber -> per-lane table + PASS/FAIL + summary"
+    echo -e "  \033[33mstop\033[0m     prbsstat STOp"
+    echo -e "  \033[33mclear\033[0m    prbs clear  (disarms PRBS -- 'init' again before measuring)"
+    echo -e "  \033[33mhelp\033[0m"
+    echo ""
+    echo -e "\033[1mOptions\033[0m"
+    echo -e "  \033[33m-u|--unit\033[0m <0|1|all>   bcmcmd unit(s); 'all' = 0 1  (default: $BER_UNITS)"
+    echo -e "  \033[33m-c|--criteria\033[0m <ber>   PASS threshold          (default $BER_MAX)"
+    echo -e "  \033[33m-i|--interval\033[0m <sec>   prbsstat Interval       (default $BER_INTERVAL)"
+    echo -e "  \033[33m-p|--ports\033[0m <list>     override the port list"
+    echo -e "  \033[33m-F|--fail-only\033[0m        report: list only failing lanes"
+    echo -e "  \033[33m--tsv\033[0m                 report: tab-separated"
+    echo -e "  \033[33m--raw\033[0m                 report: also print the raw output"
+    echo -e "  \033[33m-f|--file\033[0m <log>       report: parse a saved log, do not touch the DUT"
+    echo -e "  \033[33m-d|--debug\033[0m            print every bcmcmd"
+    echo -e "  \033[33m-n|--dry-run\033[0m          print commands only"
+    echo ""
+    echo -e "\033[1mTypical run\033[0m"
+    echo -e "  ./blanton_ber.sh init && ./blanton_ber.sh start"
+    echo -e "  sleep $BER_INTERVAL"
+    echo -e "  ./blanton_ber.sh report"
+    echo -e "  ./blanton_ber.sh stop && ./blanton_ber.sh clear"
+    echo ""
+    echo -e "\033[33m  PRBS takes the SerDes out of normal operation: links show DOWN and no\033[0m"
+    echo -e "\033[33m  traffic passes. Do not run alongside blanton_traffic_linespeed / blanton_tr518.\033[0m"
+}
+
+# === Argument parsing ========================================================
+blanton_ber() {
+    local sub="${1:-help}"; shift 2>/dev/null
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            -u|--unit)
+                case "$2" in
+                    all|ALL) BER_UNITS="0 1" ;;
+                    *)       BER_UNITS="$(echo "$2" | tr ',' ' ')" ;;
+                esac
+                shift 2 ;;
+            -c|--criteria) BER_MAX="$2";      shift 2 ;;
+            -i|--interval) BER_INTERVAL="$2"; shift 2 ;;
+            -p|--ports)    BER_PORTS="$2";    shift 2 ;;
+            -f|--file)     BER_REPORT_FILE="$2"; shift 2 ;;
+            -F|--fail-only) BER_FAIL_ONLY=1;  shift ;;
+            --tsv)         BER_TSV=1;         shift ;;
+            --raw)         BER_RAW=1;         shift ;;
+            --color)       BER_COLOR=always;  shift ;;
+            --no-color)    BER_COLOR=never;   shift ;;
+            -d|--debug)    DEBUG_MODE=1;      shift ;;
+            -n|--dry-run)  BER_DRY_RUN=1;     shift ;;
+            -h|--help)     blanton_ber_help;  return 0 ;;
+            *)             _ber_err "unknown option '$1'"; return 1 ;;
+        esac
+    done
+
+    case "$sub" in
+        init)           blanton_ber_init ;;
+        clear)          blanton_ber_clear ;;
+        start)          blanton_ber_start ;;
+        stop)           blanton_ber_stop ;;
+        report)         blanton_ber_report ;;
+        help|-h|--help) blanton_ber_help ;;
+        *)              _ber_err "unknown subcommand '$sub'"; blanton_ber_help; return 1 ;;
+    esac
+}
+
+# Run when executed, define-only when sourced (same as the other blanton_*.sh).
+if [ "${BASH_SOURCE[0]}" = "$0" ]; then
+    blanton_ber "$@"
+fi

src/Script_ABC_Blanton/Blanton_Script/blanton_tr518.sh

@@ -0,0 +1,326 @@
+#!/usr/bin/env bash
+# =============================================================================
+# blanton_tr518.sh  --  TH6 built-in packet test (tr 518) via bcmcmd
+# =============================================================================
+# Version History:
+#   V1.0.1  2026-08-28  Fix: start reported ERR on a run that was actually fine.
+#                       bcmcmd exits NON-zero on 'tr 518' because the test
+#                       outlives its response poll ("polling socket timeout:
+#                       Success") -- the command had been accepted and was
+#                       running. The tr 518 step is now judged on a POSITIVE
+#                       marker in the output ("TR 518 TEST PARAMETERS", which
+#                       the shell prints only after it starts the test) instead
+#                       of on bcmcmd's exit status, and "polling socket timeout"
+#                       is tolerated generally. Failures now also say WHICH
+#                       check tripped (shell rejected it / bcmcmd exited N).
+#   V1.0.0  2026-08-28  First version. Bash port of tools/TR518.txt, command for
+#                       command. start = port cd lb=mac, l2 learn off,
+#                       test mode nr=yes, tr 518 ... testphase=1, then a settle
+#                       wait so a power reading taken afterwards is a loaded and
+#                       stable one rather than a ramping one.
+#                       stop  = port cd lb=none (exactly what TR518.txt does).
+#                       -u 0 | -u 1 | -u all (default both).
+# =============================================================================
+#
+# What this is for: tr 518 loads the switch so the power rails can be measured
+# under traffic. The usual sequence is
+#
+#     blanton_tr518.sh start                 # loads both units, waits to settle
+#     TH6_SWB0_power_readback.sh             # now the numbers mean something
+#     TH6_SWB1_power_readback.sh
+#     blanton_tr518.sh stop
+#
+# ⚠️ tr 518 and blanton_traffic_linespeed CANNOT run at the same time. Both take
+#    over the cd ports and L2 learning; running one while the other is set up
+#    gives numbers from neither test. Stop one before the other starts.
+#
+# ⚠️ stop only undoes the loopback -- see TR_RESTORE_* below.
+#
+# Usage (run directly):
+#   ./blanton_tr518.sh start            # both units
+#   ./blanton_tr518.sh start -u 0       # unit 0 only
+#   ./blanton_tr518.sh start -u 1       # unit 1 only
+#   ./blanton_tr518.sh stop [-u 0|1]
+#   ./blanton_tr518.sh help
+#
+# Usage (sourced, like the other blanton_*.sh tools):
+#   source blanton_tr518.sh
+#   blanton_tr518 start -u 0
+#
+# Options:
+#   -u|--unit <0|1|all|0,1>  bcmcmd unit(s). Default: $TR_UNITS ("0 1")
+#   -w|--wait <sec>          start: settle wait after tr 518 (default $TR_SETTLE_SEC)
+#      --no-wait             start: skip the settle wait entirely
+#   -d|--debug               print every bcmcmd and its output
+#   -n|--dry-run             print commands only, do not touch the DUT
+#   -h|--help                help
+#
+# Environment overrides:
+#   BCMCMD_CMD=bcmcmd   TR_UNITS="0 1"   TR_SETTLE_SEC=120   TR_UNIT_GAP_SEC=1
+#   TR_TEST_ARGS="..."  TR_LB_PORTS=cd   TR_RESTORE_LEARN=0  TR_RESTORE_TESTMODE=0
+#   DEBUG_MODE=1
+# =============================================================================
+
+# === Config ==================================================================
+BCMCMD_CMD="${BCMCMD_CMD:-bcmcmd}"
+TR_UNITS="${TR_UNITS:-0 1}"            # one DUT = two switch boards (0 and 1)
+
+# Settle wait after tr 518 is issued. The point is NOT the test itself -- it is
+# to stop someone reading power while traffic is still ramping and reporting a
+# number that is neither idle nor loaded. Lower it only if you know the rails
+# have already settled.
+TR_SETTLE_SEC="${TR_SETTLE_SEC:-120}"
+
+# Gap between unit 0 and unit 1 (each unit is set up as a complete block, the
+# way TR518.txt does it -- the cd ports are in MAC loopback, so a unit does not
+# depend on the other one being ready).
+TR_UNIT_GAP_SEC="${TR_UNIT_GAP_SEC:-1}"
+
+# Ports put into MAC loopback. 'cd' = the cd port group, per TR518.txt.
+TR_LB_PORTS="${TR_LB_PORTS:-cd}"
+
+# The tr 518 argument string, verbatim from tools/TR518.txt. One editable line
+# so it can be pasted straight from / into a manual bcmcmd.
+# Printed by the BCM shell only after tr 518 has accepted its arguments and
+# started. Used as the success marker, because bcmcmd's own exit status is not
+# trustworthy for a command that runs longer than its response poll.
+TR_TEST_OK_PAT="${TR_TEST_OK_PAT:-TR 518 TEST PARAMETERS}"
+
+TR_TEST_ARGS="${TR_TEST_ARGS:-Scenario=6 Profile=2 Count=260 PktSize=324 PortList=1-259,270-565 rm=ext CheckLinkTime=20 CheckDataTime=200 testphase=1}"
+
+# TR518.txt stops with 'port cd lb=none' and nothing else, so that is the
+# default here too. But note what start changed and stop does NOT put back:
+#   l2 learn off      -> the unit keeps learning disabled
+#   test mode nr=yes  -> the unit stays in test mode
+# Both persist until something else changes them or the box reboots. Set these
+# to 1 if you want stop to be a true inverse; they are off by default because
+# they are not in the bench-verified list.
+TR_RESTORE_LEARN="${TR_RESTORE_LEARN:-0}"
+TR_RESTORE_TESTMODE="${TR_RESTORE_TESTMODE:-0}"
+
+DEBUG_MODE=${DEBUG_MODE:-0}
+TR_DRY_RUN=${TR_DRY_RUN:-0}
+TR_NO_WAIT=${TR_NO_WAIT:-0}
+
+# === Logging =================================================================
+_tr_info() { echo -e "[\033[34mINFO\033[0m] $*"; }
+_tr_ok()   { echo -e "[\033[32m OK \033[0m] $*"; }
+_tr_warn() { echo -e "[\033[33mWARN\033[0m] $*" >&2; }
+_tr_err()  { echo -e "[\033[31mERR \033[0m] $*" >&2; }
+_tr_dbg()  { [ "$DEBUG_MODE" = "1" ] && echo -e "\033[90m[DEBG] $*\033[0m" >&2; return 0; }
+
+# === bcmcmd wrapper ==========================================================
+# stdin is closed for the same reason as in blanton_traffic_linespeed.sh:
+# bcmcmd otherwise inherits the caller's stdin and eats whatever a surrounding
+# loop was reading.
+#
+# bcmcmd exits 0 even when the BCM shell refused the command, so the output is
+# pattern-matched as well (the V0.3.1 lesson from blanton_traffic_linespeed.sh).
+TR_ERR_PAT="${TR_ERR_PAT:-ERROR|Failed to execute|Invalid|Syntax error|Unavailable|Unknown command}"
+
+# ...and the reverse also happens: bcmcmd exits NON-zero on a command that was
+# accepted and is running. 'tr 518' outlives bcmcmd's response poll, so bcmcmd
+# gives up with "polling socket timeout: Success" and a non-zero status while
+# the test carries on inside the BCM shell. Treating that as a failure is what
+# made V1.0.0 report ERR on a run that was actually fine.
+TR_BENIGN_PAT="${TR_BENIGN_PAT:-polling socket timeout}"
+
+# _tr_bcm <unit> <cmd>                 -> 0 ok, 1 failed
+# _tr_bcm_ok <unit> <ok_marker> <cmd>  -> as above, but if the output contains
+#                                         <ok_marker> the command is a success
+#                                         regardless of exit status.
+#
+# The marker is a POSITIVE proof of success ("the shell printed the thing it
+# only prints when it accepted this command"), which is far more reliable than
+# trying to enumerate every way bcmcmd can look unhappy.
+_tr_bcm() { _tr_bcm_ok "$1" "" "${@:2}"; }
+
+_tr_bcm_ok() {
+    local unit="$1" okpat="$2"; shift 2
+    local cmd="$*" out rc why=""
+    _tr_dbg "$BCMCMD_CMD -n $unit -c '$cmd'"
+    if [ "$TR_DRY_RUN" = "1" ]; then
+        echo "[DRY ] $BCMCMD_CMD -n $unit -c '$cmd'"
+        return 0
+    fi
+    out=$("$BCMCMD_CMD" -n "$unit" -c "$cmd" </dev/null 2>&1); rc=$?
+    [ "$DEBUG_MODE" = "1" ] && [ -n "$out" ] && echo "$out"
+
+    # 1. positive proof wins over everything else
+    if [ -n "$okpat" ] && echo "$out" | grep -qF "$okpat"; then
+        [ "$rc" -ne 0 ] && _tr_dbg "unit $unit: bcmcmd rc=$rc but '$okpat' seen -> accepted"
+        return 0
+    fi
+    # 2. the BCM shell said no
+    if echo "$out" | grep -qiE "$TR_ERR_PAT"; then
+        why="the BCM shell rejected it"
+    # 3. bcmcmd itself was unhappy -- unless it is the known transport artifact
+    elif [ "$rc" -ne 0 ]; then
+        if echo "$out" | grep -qiE "$TR_BENIGN_PAT"; then
+            _tr_dbg "unit $unit: bcmcmd rc=$rc (${TR_BENIGN_PAT}) -> tolerated"
+            return 0
+        fi
+        why="bcmcmd exited $rc"
+    else
+        return 0
+    fi
+
+    _tr_err "unit $unit: $why -- '$cmd'"
+    [ "$DEBUG_MODE" = "1" ] || { [ -n "$out" ] && echo "$out" >&2; }
+    return 1
+}
+
+_tr_units_check() {
+    local u ok=""
+    for u in $TR_UNITS; do
+        case "$u" in
+            0|1) ok="$ok $u" ;;
+            *)   _tr_err "invalid unit '$u' (use 0, 1 or all)"; return 1 ;;
+        esac
+    done
+    [ -n "$ok" ] || { _tr_err "no unit selected"; return 1; }
+    TR_UNITS="${ok# }"
+    return 0
+}
+
+_tr_is_uint() { case "$1" in ''|*[!0-9]*) return 1 ;; *) return 0 ;; esac; }
+
+_tr_gap() {
+    [ "$TR_DRY_RUN" = "1" ] && return 0
+    [ "$TR_UNIT_GAP_SEC" = "0" ] && return 0
+    sleep "$TR_UNIT_GAP_SEC"
+}
+
+# === start ===================================================================
+# One complete block per unit, exactly the order in tools/TR518.txt.
+blanton_tr518_start() {
+    _tr_units_check || return 1
+    _tr_is_uint "$TR_SETTLE_SEC" || { _tr_err "settle wait '$TR_SETTLE_SEC' is not an integer (-w <sec>)"; return 1; }
+
+    local unit fail=0 first=1
+    _tr_info "TR518 start on unit(s): $TR_UNITS"
+    for unit in $TR_UNITS; do
+        [ "$first" = "0" ] && _tr_gap
+        first=0
+        _tr_info "unit $unit: port $TR_LB_PORTS lb=mac -> l2 learn off -> test mode nr=yes -> tr 518"
+        _tr_bcm "$unit" "port $TR_LB_PORTS lb=mac"                     || fail=$((fail+1))
+        _tr_bcm "$unit" "l2 learn off"                                 || fail=$((fail+1))
+        _tr_bcm "$unit" 'dsh -c "test mode nr=yes"'                    || fail=$((fail+1))
+        # "TR 518 TEST PARAMETERS" is printed only once the shell has parsed the
+        # arguments and started the test -- that is the proof we check for.
+        _tr_bcm_ok "$unit" "$TR_TEST_OK_PAT" "dsh -c \"tr 518 $TR_TEST_ARGS\"" || fail=$((fail+1))
+    done
+
+    if [ "$fail" -ne 0 ]; then
+        _tr_err "$fail command(s) failed -- traffic may not be running, not waiting"
+        _tr_warn "the unit(s) may still be in loopback: blanton_tr518.sh stop"
+        return 1
+    fi
+
+    if [ "$TR_NO_WAIT" = "1" ] || [ "$TR_SETTLE_SEC" = "0" ]; then
+        _tr_ok "TR518 running on unit(s): $TR_UNITS (settle wait skipped)"
+        _tr_warn "rails may still be ramping -- a power reading taken now is not a settled one"
+        return 0
+    fi
+
+    _tr_info "settling ${TR_SETTLE_SEC}s before the rails are worth reading ..."
+    [ "$TR_DRY_RUN" = "1" ] || sleep "$TR_SETTLE_SEC"
+    _tr_ok "TR518 running and settled on unit(s): $TR_UNITS"
+    _tr_info "read power now:  TH6_SWB0_power_readback.sh / TH6_SWB1_power_readback.sh"
+    _tr_info "when finished:   blanton_tr518.sh stop"
+    return 0
+}
+
+# === stop ====================================================================
+# TR518.txt stops with 'port cd lb=none' only. l2 learning and test mode are
+# left as start set them unless TR_RESTORE_* is turned on.
+blanton_tr518_stop() {
+    _tr_units_check || return 1
+    local unit fail=0 first=1
+    _tr_info "TR518 stop on unit(s): $TR_UNITS"
+    for unit in $TR_UNITS; do
+        [ "$first" = "0" ] && _tr_gap
+        first=0
+        _tr_bcm "$unit" "port $TR_LB_PORTS lb=none" || fail=$((fail+1))
+        [ "$TR_RESTORE_LEARN"    = "1" ] && { _tr_bcm "$unit" "l2 learn on"                 || fail=$((fail+1)); }
+        [ "$TR_RESTORE_TESTMODE" = "1" ] && { _tr_bcm "$unit" 'dsh -c "test mode nr=no"'    || fail=$((fail+1)); }
+    done
+
+    if [ "$fail" -eq 0 ]; then
+        _tr_ok "unit(s) $TR_UNITS: port $TR_LB_PORTS lb=none"
+        [ "$TR_RESTORE_LEARN" = "1" ] || \
+            _tr_info "l2 learning is still off (TR_RESTORE_LEARN=1 to put it back)"
+        [ "$TR_RESTORE_TESTMODE" = "1" ] || \
+            _tr_info "test mode is still nr=yes (TR_RESTORE_TESTMODE=1 to put it back)"
+    else
+        _tr_warn "$fail command(s) failed -- check the unit is not still in loopback:"
+        _tr_warn "  bcmcmd -n <u> -c 'port $TR_LB_PORTS' | head"
+        return 1
+    fi
+    return 0
+}
+
+# === Help ====================================================================
+blanton_tr518_help() {
+    echo -e "\033[1mblanton_tr518.sh - TH6 built-in packet test (tr 518) for power loading\033[0m"
+    echo ""
+    echo -e "  Units       : \033[36m$TR_UNITS\033[0m"
+    echo -e "  Settle wait : \033[36m${TR_SETTLE_SEC}s\033[0m after tr 518 (so power is read loaded, not ramping)"
+    echo -e "  Loopback    : \033[36mport $TR_LB_PORTS lb=mac\033[0m"
+    echo -e "  tr 518 args : \033[36m$TR_TEST_ARGS\033[0m"
+    echo ""
+    echo -e "\033[1mSubcommands\033[0m"
+    echo -e "  \033[33mstart\033[0m    per unit: port $TR_LB_PORTS lb=mac -> l2 learn off -> test mode nr=yes -> tr 518 -> wait"
+    echo -e "  \033[33mstop\033[0m     per unit: port $TR_LB_PORTS lb=none"
+    echo -e "  \033[33mhelp\033[0m"
+    echo ""
+    echo -e "\033[1mOptions\033[0m"
+    echo -e "  \033[33m-u|--unit\033[0m <0|1|all>   bcmcmd unit(s); 'all' = 0 1  (default: $TR_UNITS)"
+    echo -e "  \033[33m-w|--wait\033[0m <sec>      start: settle wait  (default $TR_SETTLE_SEC)"
+    echo -e "  \033[33m--no-wait\033[0m            start: skip the settle wait"
+    echo -e "  \033[33m-d|--debug\033[0m           print every bcmcmd and its output"
+    echo -e "  \033[33m-n|--dry-run\033[0m         print commands only, do not touch the DUT"
+    echo ""
+    echo -e "\033[1mExamples\033[0m"
+    echo -e "  ./blanton_tr518.sh start           # both units, then wait ${TR_SETTLE_SEC}s"
+    echo -e "  ./blanton_tr518.sh start -u 0      # unit 0 only"
+    echo -e "  ./blanton_tr518.sh stop -u 1       # release unit 1"
+    echo -e "  ./blanton_tr518.sh start -n        # show the bcmcmds, touch nothing"
+    echo ""
+    echo -e "\033[33m  stop only sends 'port $TR_LB_PORTS lb=none'. l2 learning stays off and test mode\033[0m"
+    echo -e "\033[33m  stays nr=yes -- TR_RESTORE_LEARN=1 / TR_RESTORE_TESTMODE=1 to put them back.\033[0m"
+    echo -e "\033[33m  tr 518 and blanton_traffic_linespeed cannot run together.\033[0m"
+}
+
+# === Argument parsing ========================================================
+blanton_tr518() {
+    local sub="${1:-help}"; shift 2>/dev/null
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            -u|--unit)
+                case "$2" in
+                    all|ALL) TR_UNITS="0 1" ;;
+                    *)       TR_UNITS="$(echo "$2" | tr ',' ' ')" ;;
+                esac
+                shift 2 ;;
+            -w|--wait)    TR_SETTLE_SEC="$2"; shift 2 ;;
+            --no-wait)    TR_NO_WAIT=1; shift ;;
+            -d|--debug)   DEBUG_MODE=1; shift ;;
+            -n|--dry-run) TR_DRY_RUN=1; shift ;;
+            -h|--help)    blanton_tr518_help; return 0 ;;
+            *)            _tr_err "unknown option '$1'"; return 1 ;;
+        esac
+    done
+
+    case "$sub" in
+        start)          blanton_tr518_start ;;
+        stop)           blanton_tr518_stop ;;
+        help|-h|--help) blanton_tr518_help ;;
+        *)              _tr_err "unknown subcommand '$sub'"; blanton_tr518_help; return 1 ;;
+    esac
+}
+
+# Run when executed, define-only when sourced (same as the other blanton_*.sh).
+if [ "${BASH_SOURCE[0]}" = "$0" ]; then
+    blanton_tr518 "$@"
+fi

src/Script_ABC_Blanton/Blanton_Script/blanton_traffic_linespeed.sh

@@ -74,6 +74,44 @@
 #                       Same fix applied to the "# FAIL ..." delta line (%+d ->
 #                       %+.0f), which would otherwise saturate when a dead port
 #                       makes the delta the size of the whole counter.
+#   V0.5.0  2026-08-28  Add: the 100G uplink (ce0, VLAN 138) joins init / start /
+#                       stop / report, from tools/100G_Traffic.txt.
+#                       ce0 is NOT a loopback pair: there is one per unit and the
+#                       two are cabled to each other, so its verdict is a
+#                       CROSS-UNIT check and cannot be decided from one unit's
+#                       counters. It therefore appears as the LAST row of each
+#                       unit table with the verdict DEFER, and is judged in a new
+#                       summary printed once at the very bottom, after every
+#                       unit -- which also carries the per-unit PASS/FAIL/NA
+#                       totals ("all Results" in one place).
+#                       TL_CE_MODE=cross (default) | self picks the topology;
+#                       it is a plain editable flag, NOT auto-detected, because
+#                       a non-zero RX cannot tell the two cablings apart.
+#                       With only one unit selected the summary reports
+#                       UNDECIDED (exit 3) instead of guessing.
+#                       TL_CE_ENABLE=0 restores the old cd-pairs-only behaviour.
+#   V0.6.0  2026-08-28  Add: ce0 traffic is now SUSTAINED, not a single burst.
+#                       A cd pair keeps its packets circulating because they
+#                       flood to the partner port; ce0 has no partner and a
+#                       switch will not send a frame back out its ingress port,
+#                       so 'tx 100' was exactly one round trip (TX 100/RX 100)
+#                       and then silence. init now sets an INGRESS MIRROR of ce0
+#                       back to ce0 -- the mirrored copy is not egress-filtered,
+#                       so each packet keeps lapping until stop turns it off.
+#                         init : mirror init; mirror port ce0 Mode=Ingress
+#                                DestPort=ce0; vlan create/add
+#                         stop : mirror port ce0 Mode=Off (FIRST -- this is what
+#                                breaks the loop), then vlan remove
+#                       Bench-verified command set. TL_CE_MIRROR=0 goes back to
+#                       the one-shot burst.
+#                       Change: TL_CE_MODE now defaults to 'self'. 'ps ce' shows
+#                       one ce port per unit and a unit-0-only burst returned on
+#                       unit 0, so the cross-unit reading was wrong.
+#   V0.5.1  2026-08-28  Add: TL_CE_COUNTER selects which counter judges the ce
+#                       port -- packets (MIB_TPOK/MIB_RPOK, default, same as the
+#                       cd rows) or bytes (MIB_TBYT/MIB_RBYT). The report prints
+#                       which one it used under the table, so a byte figure is
+#                       never mistaken for a packet count next to the cd rows.
 # =============================================================================
 #
 # The VLAN/port table below is copied verbatim from
@@ -145,6 +183,56 @@ TL_DEFAULT_VLAN_PBM="${TL_DEFAULT_VLAN_PBM:-cd}"
 # pasted straight from/into a manual "bcmcmd -n 0 -c 'ps <list>'".
 TL_PS_PORTS="${TL_PS_PORTS:-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}"
 
+# --- 100G uplink (ce0) ------------------------------------------------------
+# The cd pairs above are loopback pairs WITHIN one switch unit (cdN <-> cdN+32).
+# ce0 is not a pair: 'ps ce' shows exactly one ce port per unit, and it is looped
+# back on itself. Bench-confirmed 2026-08-28 -- a tx burst on unit 0 alone came
+# back on unit 0 (TPOK +100 AND RPOK +100), which only happens on a self loop.
+#
+#   TL_CE_MODE=self   ce0 loops back on itself           (default, matches bench)
+#                     verdict: TX == RX within the unit, decided in its own table
+#   TL_CE_MODE=cross  unit0.ce0 <-> unit1.ce0 cabled together
+#                     verdict: unit0.TX == unit1.RX and unit0.RX == unit1.TX,
+#                     decided in the summary; needs BOTH units
+#
+# If the bench cabling changes, edit TL_CE_MODE -- it is not auto-detected,
+# because "RX happens to be non-zero" cannot tell the two topologies apart.
+# Note the two modes agree whenever both units send the same amount, so a wrong
+# setting looks fine until something actually breaks: with a self loop read as
+# cross, BOTH links dying still leaves unit0.TX == unit1.RX (0 == 0) -> PASS.
+TL_CE_ENABLE=${TL_CE_ENABLE:-1}       # 0 = skip ce0 entirely (cd pairs only)
+TL_CE_VLAN="${TL_CE_VLAN:-138}"       # one past the cd range (30..137)
+TL_CE_PORT="${TL_CE_PORT:-ce0}"       # bcm port name, same on both units
+TL_CE_MODE="${TL_CE_MODE:-self}"      # cross | self  -- see above
+
+# --- Why ce0 needs an ingress mirror -----------------------------------------
+# A cd pair sustains itself: the packet floods to the OTHER member, goes out the
+# cable, comes back on the partner, floods to the other member again -- forever.
+# ce0 has no partner. A switch never forwards a frame back out the port it
+# arrived on (source-port knockout), so with ce0 as the only VLAN member the
+# returning packet is dropped and one 'tx' burst is exactly one round trip:
+# TX 100, RX 100, done. That measures the link, it does not load it.
+#
+# An INGRESS MIRROR of ce0 back to ce0 is the way round it: the mirrored copy is
+# not subject to the egress filter, so it does leave the port it came in on.
+# Each circulating packet makes exactly one copy per lap -- 1:1, not amplifying,
+# so the load is set by how many packets 'start' injects, and it runs until
+# 'stop' turns the mirror off.
+#
+# ⚠️ The loop does NOT stop on its own. Unlike the cd pairs, removing the VLAN
+#    membership is not enough -- 'stop' must set Mode=Off, or the port keeps
+#    running flat out with nothing in 'show interfaces status' to hint at it.
+# ⚠️ 'mirror init' resets the mirror module. Anything else using mirroring on
+#    this box (ERSPAN, monitoring) is cleared. Set TL_CE_MIRROR=0 to skip it.
+TL_CE_MIRROR=${TL_CE_MIRROR:-1}       # 0 = no mirror (one-shot burst, as before)
+
+# Which counter the ce port is judged on. Packets by default, the same counter
+# as the cd pairs, so every row of the table is in the same unit.
+#   packets  -> MIB_TPOK / MIB_RPOK   (default, same as the cd rows)
+#   bytes    -> MIB_TBYT / MIB_RBYT
+# Either way the report prints which one it used under the table.
+TL_CE_COUNTER="${TL_CE_COUNTER:-packets}"
+
 # --- report (pair cross-check) defaults -------------------------------------
 TL_TOLERANCE="${TL_TOLERANCE:-0}"    # allowed |delta| in packets before FAIL
 TL_LOG_DIR="${TL_LOG_DIR:-/tmp}"     # where the raw 'show c' capture is kept
@@ -378,6 +466,21 @@ traffic_linespeed_init() {
             _tl_bcm_q "$unit" "vlan add $vid pbm=$pa,$pb" || fail=$((fail+1))
             n=$((n+1))
         done 3<<< "$TL_PAIRS"
+        # 100G uplink: one port, its own VLAN, added last so it is easy to skip.
+        # The mirror goes up BEFORE the VLAN so the loop is armed the moment the
+        # first packet is injected.
+        if [ "$TL_CE_ENABLE" = "1" ]; then
+            if [ "$TL_CE_MIRROR" = "1" ]; then
+                _tl_bcm_q "$unit" "mirror init" || fail=$((fail+1))
+                _tl_bcm_q "$unit" "mirror port $TL_CE_PORT Mode=Ingress DestPort=$TL_CE_PORT" \
+                    || fail=$((fail+1))
+            fi
+            _tl_bcm_run "$unit" "$TL_BENIGN_CREATE" "vlan create $TL_CE_VLAN"; rc=$?
+            [ "$rc" = "1" ] && fail=$((fail+1))
+            [ "$rc" = "2" ] && exist=$((exist+1))
+            _tl_bcm_q "$unit" "vlan add $TL_CE_VLAN pbm=$TL_CE_PORT" || fail=$((fail+1))
+            n=$((n+1))
+        fi
         if [ "$fail" -eq 0 ]; then
             _tl_ok "unit $unit: $n VLANs configured$([ "$exist" -gt 0 ] && echo " ($exist already existed)"), port pairs added"
         else
@@ -421,8 +524,14 @@ traffic_linespeed_start() {
             _tl_bcm_q "$unit" "tx $TL_TX_COUNT length=$TL_TX_LENGTH VLantag=$vid" || fail=$((fail+1))
             n=$((n+1))
         done 3<<< "$TL_PAIRS"
+        if [ "$TL_CE_ENABLE" = "1" ]; then
+            _tl_bcm_q "$unit" "tx $TL_TX_COUNT length=$TL_TX_LENGTH VLantag=$TL_CE_VLAN" || fail=$((fail+1))
+            n=$((n+1))
+        fi
         if [ "$fail" -eq 0 ]; then
             _tl_ok "unit $unit: $n bursts sent ($((n * TL_TX_COUNT)) packets, ${TL_TX_LENGTH}B each)"
+            [ "$TL_CE_ENABLE" = "1" ] && [ "$TL_CE_MIRROR" = "1" ] && \
+                _tl_info "unit $unit: ${TL_CE_PORT} is now circulating and will keep running until 'stop'"
         else
             _tl_warn "unit $unit: $n bursts attempted, $fail failed"
         fi
@@ -446,6 +555,25 @@ traffic_linespeed_stop() {
             fi
             n=$((n+1))
         done 3<<< "$TL_PAIRS"
+        if [ "$TL_CE_ENABLE" = "1" ]; then
+            # Mirror OFF first: that is what actually breaks the loop. Removing
+            # the VLAN membership does not -- the mirrored copy never consulted
+            # the VLAN in the first place.
+            if [ "$TL_CE_MIRROR" = "1" ]; then
+                _tl_bcm_q "$unit" "mirror port $TL_CE_PORT Mode=Off" || {
+                    fail=$((fail+1))
+                    _tl_err "unit $unit: ${TL_CE_PORT} mirror still ON -- the loop is STILL RUNNING"
+                    _tl_err "  stop it by hand: ${BCMCMD_CMD} -n $unit -c 'mirror port $TL_CE_PORT Mode=Off'"
+                }
+            fi
+            _tl_bcm_run "$unit" "$TL_BENIGN_REMOVE" "vlan remove $TL_CE_VLAN pbm=$TL_CE_PORT"
+            [ "$?" = "1" ] && fail=$((fail+1))
+            if [ "$TL_DESTROY" = "1" ]; then
+                _tl_bcm_run "$unit" "$TL_BENIGN_REMOVE" "vlan destroy $TL_CE_VLAN"
+                [ "$?" = "1" ] && fail=$((fail+1))
+            fi
+            n=$((n+1))
+        fi
         if [ "$fail" -eq 0 ]; then
             _tl_ok "unit $unit: $n VLANs cleaned$([ "$TL_DESTROY" = "1" ] && echo " and destroyed")"
         else
@@ -480,8 +608,11 @@ traffic_linespeed_ps() {
 #           (a cd port absent from 'show c' means the counter is zero or the
 #            console scrolled -- cross-check with 'ps' before blaming the port).
 # _tl_pair_report <logfile>   -> 0 all PASS, 2 any FAIL/NA, 1 parse error
+# _tl_pair_report <logfile> [side_file]
+# side_file (optional) receives machine-readable lines for the cross-unit
+# summary:   SUM <npass> <nfail> <nna>      CE <tx> <rx>   (CE omitted if absent)
 _tl_pair_report() {
-    local log="$1" color=0
+    local log="$1" side="${2:-/dev/null}" color=0
     # PASS green / FAIL red / NA yellow. auto = only when stdout is a terminal,
     # so redirecting to a file or piping into grep/diff stays plain text.
     case "$TL_COLOR" in
@@ -497,7 +628,11 @@ _tl_pair_report() {
         -v WITHPORT="$TL_REPORT_WITHPORT" \
         -v QUIET="$TL_REPORT_QUIET" \
         -v TSV="$TL_REPORT_TSV" \
-        -v COLOR="$color" '
+        -v COLOR="$color" \
+        -v CEPORT="$([ "$TL_CE_ENABLE" = "1" ] && echo "$TL_CE_PORT")" \
+        -v CEMODE="$TL_CE_MODE" \
+        -v CECOUNTER="$TL_CE_COUNTER" \
+        -v SIDE="$side" '
     function grp(v,   s,out,l,i) {
         s = sprintf("%.0f", v)
         if (!GROUPED) return s
@@ -515,6 +650,7 @@ _tl_pair_report() {
         if (!COLOR) return v
         if (v == "PASS")  return "\033[32m" v "\033[0m"
         if (v == "FAIL")  return "\033[31m" v "\033[0m"
+        if (v == "DEFER") return "\033[36m" v "\033[0m"   # cyan: judged in the summary
         return "\033[33m" v "\033[0m"
     }
     function redl(s) { return COLOR ? "\033[31m" s "\033[0m" : s }
@@ -535,11 +671,12 @@ _tl_pair_report() {
         if (idx == 0) next
         s = substr($0, idx)
         kind = substr(s, 5, 4)
-        if (kind != "TPOK" && kind != "RPOK") next
+        # POK = packets (the cd pairs), BYT = bytes (used for the ce port)
+        if (kind != "TPOK" && kind != "RPOK" && kind != "TBYT" && kind != "RBYT") next
         p1 = index(s, "."); p2 = index(s, "("); p3 = index(s, ")"); p4 = index(s, ":")
         if (p1 == 0 || p2 == 0 || p3 == 0 || p4 == 0 || p2 < p1 || p4 < p3) next
         cd = substr(s, p1 + 1, p2 - p1 - 1)
-        if (cd !~ /^cd[0-9]+$/) next
+        if (cd !~ /^(cd|ce)[0-9]+$/) next
         lp  = substr(s, p2 + 1, p3 - p2 - 1)
         val = substr(s, p4 + 1)
         sub(/^[ \t]+/, "", val)
@@ -547,7 +684,10 @@ _tl_pair_report() {
         sub(/[ \t].*$/, "", val)
         gsub(/,/, "", val)
         LP[cd] = lp
-        if (kind == "TPOK") { TX[cd] = val + 0; HTX[cd] = 1 } else { RX[cd] = val + 0; HRX[cd] = 1 }
+        if      (kind == "TPOK") { TX[cd]  = val + 0; HTX[cd]  = 1 }
+        else if (kind == "RPOK") { RX[cd]  = val + 0; HRX[cd]  = 1 }
+        else if (kind == "TBYT") { TXB[cd] = val + 0; HTXB[cd] = 1 }
+        else                     { RXB[cd] = val + 0; HRXB[cd] = 1 }
         seen++
     }
     END {
@@ -580,6 +720,41 @@ _tl_pair_report() {
             nrow++; CELL[nrow,1] = pname(b); CELL[nrow,2] = tb; CELL[nrow,3] = rb; CELL[nrow,4] = v
         }
 
+        # --- 100G uplink, appended LAST so it sits at the bottom of the table ---
+        # It is a single port, not a pair, so it gets one row. In cross mode the
+        # verdict needs the OTHER unit counters and is decided in the summary;
+        # DEFER says "not judged here", which is not the same as NA ("no data").
+        cev = ""; ceunit = ""
+        if (CEPORT != "") {
+            if (CECOUNTER == "packets") {
+                ceunit = "packets"
+                haveT = (CEPORT in HTX);  haveR = (CEPORT in HRX)
+                cetv  = TX[CEPORT];       cerv  = RX[CEPORT]
+            } else {
+                ceunit = "bytes"
+                haveT = (CEPORT in HTXB); haveR = (CEPORT in HRXB)
+                cetv  = TXB[CEPORT];      cerv  = RXB[CEPORT]
+            }
+            cet = haveT ? grp(cetv) : MISSING
+            cer = haveR ? grp(cerv) : MISSING
+            if (!(haveT && haveR)) {
+                cev = "NA"; nna++
+            } else if (CEMODE == "self") {
+                if (absd(cetv - cerv) <= TOL + 0) { cev = "PASS"; npass++ }
+                else {
+                    cev = "FAIL"; nfail++
+                    FL[++nf] = sprintf("# FAIL %s: TX-RX=%+.0f %s (self loopback)", \
+                                       CEPORT, cetv - cerv, ceunit)
+                }
+            } else {
+                cev = "DEFER"
+            }
+            nrep++
+            nrow++; CELL[nrow,1] = pname(CEPORT); CELL[nrow,2] = cet; CELL[nrow,3] = cer; CELL[nrow,4] = cev
+            if (SIDE != "" && SIDE != "/dev/null" && haveT && haveR)
+                printf "CE %.0f %.0f\n", cetv, cerv > SIDE
+        }
+
         if (TSV) {
             line = HDR[1]
             for (c = 2; c <= NC; c++) line = line "\t" HDR[c]
@@ -616,13 +791,103 @@ _tl_pair_report() {
             printf "# pairs reported    : %d\n", nrep
             printf "# %s %d  %s %d  %s %d  (tolerance %d)\n", \
                    vc("PASS"), npass, vc("FAIL"), nfail, vc("NA"), nna, TOL + 0
+            if (CEPORT != "" && ceunit != "")
+                printf "# %s TX/RX are %s (MIB_%s/MIB_%s); the cd rows are packets\n", \
+                       CEPORT, ceunit, \
+                       (ceunit == "bytes" ? "TBYT" : "TPOK"), \
+                       (ceunit == "bytes" ? "RBYT" : "RPOK")
+            if (cev == "DEFER")
+                printf "# %s is judged across units -- see the summary at the end\n", CEPORT
             # every NA pair is a visible row -> no long "no counters" list needed
             for (i = 1; i <= nf; i++) print redl(FL[i])
         }
+        if (SIDE != "" && SIDE != "/dev/null")
+            printf "SUM %d %d %d\n", npass, nfail, nna > SIDE
         exit (nfail || nna) ? 2 : 0
     }' "$log"
 }
 
+# _tl_ce_summary -- the cross-unit ce0 verdict + the per-unit totals.
+# Printed once, at the very bottom, after every unit's table.
+# Args: <stamp>  (side files are $TL_LOG_DIR/tlside_unit<N>_<stamp>)
+# Returns 0 all PASS, 2 any FAIL/NA, 3 could not be decided.
+_tl_ce_summary() {
+    local stamp="$1" unit side c g y n r
+    c=$'\033[36m'; g=$'\033[32m'; y=$'\033[33m'; r=$'\033[31m'; n=$'\033[0m'
+    case "$TL_COLOR" in
+        never|0|no) c=""; g=""; y=""; r=""; n="" ;;
+        always|1|yes) ;;
+        *) [ -t 1 ] || { c=""; g=""; y=""; r=""; n=""; } ;;
+    esac
+
+    local u tx rx pass fail na have=""
+    local -A CETX CERX UPASS UFAIL UNA
+    for unit in $TL_UNITS; do
+        side="$TL_LOG_DIR/tlside_unit${unit}_${stamp}"
+        [ -r "$side" ] || continue
+        while read -r tag a b cc; do
+            case "$tag" in
+                CE)  CETX[$unit]="$a"; CERX[$unit]="$b" ;;
+                SUM) UPASS[$unit]="$a"; UFAIL[$unit]="$b"; UNA[$unit]="$cc" ;;
+            esac
+        done < "$side"
+        have="$have $unit"
+    done
+
+    echo ""
+    echo "===== summary : all units ====="
+    printf '%-8s %8s %8s %8s   %s\n' "Unit" "PASS" "FAIL" "NA" "RESULT"
+    local worst=0 v
+    for unit in $have; do
+        pass="${UPASS[$unit]:-0}"; fail="${UFAIL[$unit]:-0}"; na="${UNA[$unit]:-0}"
+        if [ "$fail" -gt 0 ] || [ "$na" -gt 0 ]; then v="${r}FAIL${n}"; worst=2
+        else v="${g}PASS${n}"; fi
+        printf '%-8s %8s %8s %8s   %b\n' "unit $unit" "$pass" "$fail" "$na" "$v"
+    done
+
+    [ "$TL_CE_ENABLE" = "1" ] || { echo ""; return "$worst"; }
+
+    echo ""
+    echo "----- ${TL_CE_PORT} (100G uplink, VLAN ${TL_CE_VLAN}, mode=${TL_CE_MODE}, counter=${TL_CE_COUNTER}) -----"
+    if [ "$TL_CE_MODE" != "cross" ]; then
+        echo "# mode=self: the verdict is in each unit's table above"
+        echo ""
+        return "$worst"
+    fi
+
+    # cross mode needs both units' counters
+    if [ -z "${CETX[0]}" ] || [ -z "${CETX[1]}" ]; then
+        printf '%b\n' "${y}UNDECIDED${n}  ${TL_CE_PORT} is a cross-unit check and needs unit 0 AND unit 1;"
+        echo "           this run had TL_UNITS=\"$TL_UNITS\" (counters seen for:${have:-none})."
+        echo "           Re-run with -u all, or set TL_CE_MODE=self if the cabling is a self loopback."
+        echo ""
+        [ "$worst" -lt 3 ] && worst=3
+        return "$worst"
+    fi
+
+    local cu="bytes"; [ "$TL_CE_COUNTER" = "packets" ] && cu="packets"
+    printf '%-22s %18s %18s\n' "Direction" "TX ($cu)" "RX ($cu)"
+    printf '%-22s %18s %18s\n' "unit0.${TL_CE_PORT}" "${CETX[0]}" "${CERX[0]}"
+    printf '%-22s %18s %18s\n' "unit1.${TL_CE_PORT}" "${CETX[1]}" "${CERX[1]}"
+
+    local d1 d2 v1 v2
+    d1=$(awk -v a="${CETX[0]}" -v b="${CERX[1]}" 'BEGIN{printf "%.0f", a-b}')
+    d2=$(awk -v a="${CETX[1]}" -v b="${CERX[0]}" 'BEGIN{printf "%.0f", a-b}')
+    v1=$(awk -v d="$d1" -v t="$TL_TOLERANCE" 'BEGIN{print (d<0?-d:d)<=t ? "PASS" : "FAIL"}')
+    v2=$(awk -v d="$d2" -v t="$TL_TOLERANCE" 'BEGIN{print (d<0?-d:d)<=t ? "PASS" : "FAIL"}')
+    echo ""
+    printf 'unit0.TX -> unit1.RX   delta %+d   %b\n' "$d1" "$([ "$v1" = PASS ] && echo "${g}PASS${n}" || echo "${r}FAIL${n}")"
+    printf 'unit1.TX -> unit0.RX   delta %+d   %b\n' "$d2" "$([ "$v2" = PASS ] && echo "${g}PASS${n}" || echo "${r}FAIL${n}")"
+    if [ "$v1" = PASS ] && [ "$v2" = PASS ]; then
+        printf '%-22s %b\n' "${TL_CE_PORT} RESULT" "${g}PASS${n}"
+    else
+        printf '%-22s %b\n' "${TL_CE_PORT} RESULT" "${r}FAIL${n}"
+        worst=2
+    fi
+    echo ""
+    return "$worst"
+}
+
 # traffic_linespeed_report -- 'show c' per unit, keep the raw log, render the table
 traffic_linespeed_report() {
     local unit log rc worst=0 stamp
@@ -641,14 +906,17 @@ traffic_linespeed_report() {
     fi
 
     stamp=$(date +%Y%m%d_%H%M%S 2>/dev/null || echo now)
+    local side
     for unit in $TL_UNITS; do
         log="$TL_LOG_DIR/showc_unit${unit}_${stamp}.log"
+        side="$TL_LOG_DIR/tlside_unit${unit}_${stamp}"
+        : > "$side"
         if ! _tl_bcm "$unit" "show c" > "$log" 2>&1; then
             _tl_err "unit $unit: show c failed (see $log)"; return 1
         fi
         [ "$TL_REPORT_RAW" = "1" ] && { echo "----- unit $unit : raw show c -----"; cat "$log"; }
         echo "===== unit $unit : loopback pair counter report (raw: $log) ====="
-        _tl_pair_report "$log"; rc=$?
+        _tl_pair_report "$log" "$side"; rc=$?
         [ "$rc" -gt "$worst" ] && worst=$rc
         case "$rc" in
             0) _tl_ok   "unit $unit: all pairs PASS" ;;
@@ -656,6 +924,12 @@ traffic_linespeed_report() {
             *) _tl_err  "unit $unit: report parse error" ;;
         esac
     done
+
+    # Summary last, after every unit's table -- this is where the cross-unit
+    # ce0 verdict can finally be decided.
+    _tl_ce_summary "$stamp"; rc=$?
+    [ "$rc" -gt "$worst" ] && worst=$rc
+    rm -f "$TL_LOG_DIR"/tlside_unit*_"${stamp}"
     return "$worst"
 }
 
@@ -677,6 +951,8 @@ blanton_traffic_linespeed_help() {
     echo ""
     echo -e "  Units: \033[36m$TL_UNITS\033[0m   tx: \033[36m$TL_TX_COUNT pkt x ${TL_TX_LENGTH}B\033[0m"
     echo -e "  VLANs: 30..137 ($(_tl_pair_count) loopback pairs, cdN <-> cdN+32)"
+    [ "$TL_CE_ENABLE" = "1" ] && \
+        echo -e "  100G : VLAN \033[36m$TL_CE_VLAN\033[0m port \033[36m$TL_CE_PORT\033[0m  mode=\033[36m$TL_CE_MODE\033[0m (cross = unit0.$TL_CE_PORT <-> unit1.$TL_CE_PORT cabled)"
     echo ""
     echo -e "\033[1mSubcommands\033[0m"
     echo -e "  \033[33minit\033[0m     step 1  vlan remove 1 pbm=cd, vlan create/add each pair"
@@ -684,8 +960,11 @@ blanton_traffic_linespeed_help() {
     echo -e "  \033[33mshow\033[0m     step 3/6  show c  (run before and after traffic)"
     echo -e "  \033[33mstart\033[0m    step 4  tx <count> length=<len> VLantag=<vid> per VLAN"
     echo -e "  \033[33mstop\033[0m     step 5  vlan remove <vid> pbm=<pair>  [--destroy also destroys]"
+    [ "$TL_CE_ENABLE" = "1" ] && [ "$TL_CE_MIRROR" = "1" ] && \
+        echo -e "           \033[33m^ also turns the $TL_CE_PORT mirror off -- without it the 100G loop keeps running\033[0m"
     echo -e "  \033[33mps\033[0m       ps <portlist>  port status (link/speed) of the cabled ports"
     echo -e "  \033[33mreport\033[0m   show c -> per-port TX/RX per pair + PASS/FAIL/NA cross-check"
+    echo -e "           ${TL_CE_PORT} is the last row (DEFER), judged in the summary at the bottom"
     echo -e "  \033[33mrun\033[0m      ps -> init -> clear -> start -> report"
     echo -e "  \033[33mhelp\033[0m"
     echo ""

src/Script_ABC_Blanton/Blanton_Script/bmc_monitor.sh

@@ -34,6 +34,10 @@ set -u
 # Add a line to add a command; comment it out to disable it.
 COMMANDS=(
     "free -m"
+    "i2ctransfer -f -y 1 w6@0x41 0x00 0xC0 0x55 0xAA 0x55 0xAA"
+    "i2ctransfer -f -y 1 w2@0x41 0x00 0xC0 r4"
+    "i2ctransfer -f -y 1 w6@0x41 0x00 0xC0 0xAA 0x55 0xAA 0x55"
+    "i2ctransfer -f -y 1 w2@0x41 0x00 0xC0 r4"
     #"uptime"
     #"cat /proc/loadavg"
     #"cat /proc/meminfo"

src/Script_ABC_Blanton/Blanton_Script/mgmt_ping_monitor.sh

@@ -2,48 +2,41 @@
 ###############################################################################
 # mgmt_ping_monitor.sh
 #
-# Version : V1.0.0
+# Version : V3.0.0
 # Author  : ETWen
-# Date    : 20260824
+# Date    : 20260826
 #
-# Purpose : Exercise both management NICs and ping each one's own target,
+# Purpose : Ping from BOTH management NICs at the same time, continuously, and
-#           appending everything to a rotating log. One round is
+#           keep accumulating until stopped:
 #
-#               10G (eth0) : ip link up + address/route replace -> settle
+#               10G (eth0) -> TARGET_10G
-#                            -> ping N x TARGET_10G -> ip -s link show
+#               1G  (eth1) -> TARGET_1G
-#               1G  (eth1) : ip link up + address/route replace -> settle
-#                            -> ping N x TARGET_1G  -> ip -s link show
 #
-#           Designed to run detached in the background, same sub-commands as
+#           `stop` renders a report into the log: the last TAIL_LINES entries
-#           bmc_monitor.sh: start/stop/status/fg/tail/clear.
+#           per NIC, each one's ping statistics and verdict, then
+#           `ip -s link show` for both interfaces.
 #
-# Notes   : - Both NICs are brought up and LEFT up. Addresses and default
+# Notes   : - Both NICs are configured with iproute2 `replace`, which is
-#             routes are applied with iproute2 `replace`, which is idempotent:
+#             idempotent, and both are left up. On a shared subnet the target's
-#             re-running a round does not stack duplicate addresses or routes.
+#             ARP can be answered by either NIC, so ARP_STRICT keeps each one
-#           - The default routes carry different metrics (100 / 200), so the
+#             to its own address.
-#             lower one wins for off-subnet traffic. They do NOT decide which
+#           - ARP WARM-UP: the first packet after a neighbour entry expires is
-#             NIC a ping leaves by: `ping -I <iface>` binds to the device.
+#             spent resolving ARP and is counted as loss. On the bench this
-#           - !! SAME-SUBNET WARNING !! With both NICs up on one subnet the
+#             produced three FAILs whose only missing packet was icmp_seq=1,
-#             target ARPs for the address and Linux may answer from either
+#             every time, with zero NIC errors or drops. One discarded ping
-#             NIC, so replies can arrive on the wrong one and the result is
+#             before the measured run removes that artefact, which is what lets
-#             not attributable. ARP_STRICT=1 sets arp_ignore/arp_announce to
+#             MAX_LOSS_PCT stay at 0 and still mean something.
-#             stop that. Leave it on unless the two NICs are on separate
+#           - MANAGEMENT CONNECTIVITY IS IN USE while this runs. Drive it from
-#             subnets, as in the iproute2 example this was modelled on.
+#             the serial console.
-#           - Each leg logs `ip -s link show <iface>` and the TX/RX packet
-#             delta across the burst, which is the direct evidence of which
-#             NIC actually carried the traffic.
-#           - The first pings after bringing a link up are lost to ARP, not to
-#             the link: a bench capture showed 4x "Destination Host
-#             Unreachable" on the first burst and 0% loss on the very next
-#             one. LINK_SETTLE_SEC absorbs that; it is not packet loss.
 #
 # Version History
-# V1.0.0     20260824    Initial Version
+# V1.0.0     20260824    Initial Version (ifconfig, one NIC at a time)
-# V2.0.0     20260824    Switch from ifconfig to iproute2 (ip link / address
+# V2.0.0     20260824    iproute2; both NICs stay up; per-NIC target;
-#                        replace / route replace with per-NIC metric). Both
+#                        ip -s link show + TX/RX delta per leg
-#                        NICs now stay up -- no link down between legs. Add
+# V3.0.0     20260826    Both NICs ping SIMULTANEOUSLY and continuously instead
-#                        `ip -s link show` per leg with a TX/RX delta, and
+#                        of alternating fixed bursts. Add the ARP warm-up.
-#                        ARP_STRICT for the same-subnet case.
+#                        `stop` renders last-N per NIC + statistics + both
+#                        ip -s link outputs into the log.
 ###############################################################################
 
 set -u
@@ -63,149 +56,67 @@ METRIC_10G=100                 # lower metric wins for off-subnet traffic
 # --- 1G management port ---
 IF_1G="eth1"
 IP_1G="192.168.1.101"
-TARGET_1G="192.168.1.31"       # host this NIC pings
+TARGET_1G="192.168.1.31"
 PLEN_1G=24
 GW_1G=""
 METRIC_1G=200
 
 # --- ping ---
-PING_COUNT=10                  # echo requests per leg
+PING_INTERVAL_SEC=1            # seconds between echo requests (ping -i)
-MAX_LOSS_PCT=0                 # loss above this marks the leg FAIL
+MAX_LOSS_PCT=0                 # loss above this marks the NIC FAIL
+TAIL_LINES=20                  # how many recent entries per NIC the report shows
 
-# Both NICs stay up. If they share a subnet the target's ARP can be answered
+# Extra ping flags. -D timestamps every line, -O prints a marker for a request
-# by either one, so a reply may arrive on the NIC that did not send. Setting
+# that got no reply, so a drop is visible in the tail instead of just missing.
-# this applies arp_ignore=1 / arp_announce=2 to both, which keeps each NIC to
+# Clear this if the platform's ping does not accept them.
-# its own address. RAM only -- reverts on reboot. Set 0 for separate subnets.
+PING_EXTRA_OPTS="-D -O"
+
+# One discarded ping per NIC before the measured run, to resolve ARP. Without
+# it the first packet of the run is lost to neighbour resolution and looks
+# exactly like a link fault. 0 disables.
+ARP_WARMUP=1
+ARP_WARMUP_TIMEOUT=2           # seconds to wait for the warm-up reply
+
+# Both NICs stay up. If they share a subnet the target's ARP can be answered by
+# either one, so a reply may arrive on the NIC that did not send. This applies
+# arp_ignore=1 / arp_announce=2 to both. RAM only -- reverts on reboot.
 ARP_STRICT=1
 
-# Prefix for the ip commands; empty because the daemon already runs as root.
+# Prefix for the ip commands; empty because this already runs as root.
 SUDO=""
 
-# Seconds to wait after bringing a link up before pinging, so ARP is resolved
+# Seconds to wait after bringing a link up before pinging.
-# and the PHY has finished autoneg. The bench needed a few seconds on the 1G.
 LINK_SETTLE_SEC=5
 
-# Seconds between rounds (0 = start the next round immediately)
-INTERVAL_SEC=10
-
-# Per-ping-burst timeout in seconds; stops a wedged ping from freezing the
-# loop. 0 disables. Must exceed PING_COUNT (one packet per second).
-PING_TIMEOUT_SEC=60
-
-# Stop after this many rounds. 0 = run until stopped manually.
-MAX_ROUNDS=0
-
 # Logging
 LOG_DIR=""                     # empty = <script directory>/log
 LOG_NAME="mgmt_ping.log"
-MAX_LOG_SIZE_MB=100             # rotate above this size; 0 = never rotate
-MAX_LOG_KEEP=5                  # keep .1 .. .N
 
 # What `start` does with the log left behind by the previous run:
-#   new     = begin with an empty log; previous content and rotated copies are
+#   new     = discard it (default -- one run, one log)
-#             discarded (default -- one run, one log)
+#   archive = rename it to <log>.YYYYmmdd-HHMMSS first
-#   archive = rename the previous log to <log>.YYYYmmdd-HHMMSS, then begin empty
+#   append  = keep it
-#   append  = keep appending to the existing log
 START_LOG_MODE="new"
 
 ###############################################################################
 # Internal
 ###############################################################################
 SCRIPT_NAME="$(basename -- "${BASH_SOURCE[0]}")"
-SCRIPT_PATH="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)/${SCRIPT_NAME}"
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-[ -n "${LOG_DIR}" ] || LOG_DIR="$(dirname -- "${SCRIPT_PATH}")/log"
+[ -n "${LOG_DIR}" ] || LOG_DIR="${SCRIPT_DIR}/log"
-LOG_FILE="${LOG_DIR}/${LOG_NAME}"
-PID_FILE="${LOG_DIR}/${LOG_NAME%.log}.pid"
 
-LOG_TO_FILE=0
+LOG_FILE="${LOG_DIR}/${LOG_NAME}"
-STOP=0
+BASE="${LOG_DIR}/${LOG_NAME%.log}"
-SLEEP_PID=""
+PID_FILE="${BASE}.pid"
+STATE_FILE="${BASE}.state"
+RAW_10G="${BASE}_${IF_10G}.raw"
+RAW_1G="${BASE}_${IF_1G}.raw"
 
 ts()  { date '+%Y-%m-%d %H:%M:%S'; }
 die() { printf '[ERROR] %s\n' "$*" >&2; exit 1; }
 
-on_signal() {
+# "<rx_packets> <tx_packets>" for an interface. ip -s link orders the columns
-    STOP=1
+# "bytes packets errors ...", so packets is $2, not $1.
-    [ -n "${SLEEP_PID}" ] && kill "${SLEEP_PID}" 2>/dev/null
-}
-
-interruptible_sleep() {
-    local sec="$1"
-    [ "${sec}" -gt 0 ] 2>/dev/null || return 0
-    sleep "${sec}" &
-    SLEEP_PID=$!
-    wait "${SLEEP_PID}" 2>/dev/null
-    SLEEP_PID=""
-}
-
-is_running() {
-    local pid
-    [ -f "${PID_FILE}" ] || return 1
-    pid="$(cat "${PID_FILE}" 2>/dev/null)"
-    [[ "${pid}" =~ ^[0-9]+$ ]] || return 1
-    kill -0 "${pid}" 2>/dev/null || return 1
-    grep -qa "${SCRIPT_NAME}" "/proc/${pid}/cmdline" 2>/dev/null || return 1
-    printf '%s' "${pid}"
-    return 0
-}
-
-rotate_log_if_needed() {
-    local max_bytes size i
-    [ "${LOG_TO_FILE}" -eq 1 ] || return 0
-    [ "${MAX_LOG_SIZE_MB}" -gt 0 ] || return 0
-    [ -f "${LOG_FILE}" ] || return 0
-
-    max_bytes=$(( MAX_LOG_SIZE_MB * 1024 * 1024 ))
-    size="$(stat -c %s "${LOG_FILE}" 2>/dev/null || echo 0)"
-    [ "${size}" -ge "${max_bytes}" ] || return 0
-
-    for (( i = MAX_LOG_KEEP - 1; i >= 1; i-- )); do
-        [ -f "${LOG_FILE}.${i}" ] && mv -f "${LOG_FILE}.${i}" "${LOG_FILE}.$(( i + 1 ))"
-    done
-    mv -f "${LOG_FILE}" "${LOG_FILE}.1"
-    exec >>"${LOG_FILE}" 2>&1
-    printf '[%s] INFO : log rotated at %s MB\n' "$(ts)" "${MAX_LOG_SIZE_MB}"
-}
-
-remove_rotated_logs() {
-    local i
-    for (( i = 1; i <= MAX_LOG_KEEP + 1; i++ )); do
-        rm -f "${LOG_FILE}.${i}"
-    done
-}
-
-prepare_log_on_start() {
-    local stamp
-    case "${START_LOG_MODE}" in
-        append)
-            return 0
-            ;;
-        archive)
-            if [ -s "${LOG_FILE}" ]; then
-                stamp="$(date '+%Y%m%d-%H%M%S')"
-                mv -f "${LOG_FILE}" "${LOG_FILE}.${stamp}" \
-                    || die "cannot archive ${LOG_FILE}"
-                printf 'previous log archived: %s.%s\n' "${LOG_FILE}" "${stamp}"
-            fi
-            remove_rotated_logs
-            ;;
-        new)
-            # Truncate rather than unlink: the inode is preserved, so a tail -f
-            # that is already attached keeps following the new run.
-            if [ -f "${LOG_FILE}" ]; then
-                : > "${LOG_FILE}" || die "cannot truncate ${LOG_FILE}"
-            fi
-            remove_rotated_logs
-            ;;
-        *)
-            die "invalid START_LOG_MODE: ${START_LOG_MODE}"
-            ;;
-    esac
-}
-
-# Cumulative "<rx_packets> <tx_packets>" for an interface, from ip -s link.
-# The numbers sit on the line after each RX:/TX: header, and the column order
-# is "bytes packets errors ..." -- so packets is $2, not $1.
 if_counters() {
     ${SUDO} ip -s link show "$1" 2>/dev/null | awk '
         /RX:/ { getline; rx = $2 }
@@ -213,11 +124,9 @@ if_counters() {
         END   { printf "%s %s", (rx == "" ? 0 : rx), (tx == "" ? 0 : tx) }'
 }
 
-# Bring the NIC up and (re)apply its address and default route. `replace` is
+# Bring the NIC up and (re)apply its address and default route.
-# idempotent, so repeated rounds do not stack duplicates.
 setup_iface() {
     local iface="$1" ipaddr="$2" plen="$3" gw="$4" metric="$5"
-
     ${SUDO} ip link set "${iface}" up 2>&1                             || return 1
     ${SUDO} ip address replace "${ipaddr}/${plen}" dev "${iface}" 2>&1 || return 1
     if [ -n "${gw}" ]; then
@@ -227,74 +136,6 @@ setup_iface() {
     return 0
 }
 
-# One leg: configure <if>, settle, ping its own target, report. The NIC is
-# LEFT UP -- nothing is brought down between legs.
-# Usage: ping_leg <label> <if> <ip> <plen> <gw> <metric> <target>
-ping_leg() {
-    local label="$1" iface="$2" ipaddr="$3" plen="$4" gw="$5" metric="$6" target="$7"
-    local out rc tx rx loss avg verdict
-    local c0 c1 rx0 tx0 rx1 tx1 drx dtx
-
-    printf -- '----- [%s] %s : %s (%s/%s) -> %s -----\n' \
-              "$(ts)" "${label}" "${iface}" "${ipaddr}" "${plen}" "${target}"
-
-    if ! setup_iface "${iface}" "${ipaddr}" "${plen}" "${gw}" "${metric}"; then
-        printf '[%s] FAIL : cannot configure %s\n\n' "$(ts)" "${iface}"
-        return 1
-    fi
-    interruptible_sleep "${LINK_SETTLE_SEC}"
-    [ "${STOP}" -eq 0 ] || return 1
-
-    c0="$(if_counters "${iface}")"; rx0="${c0% *}"; tx0="${c0#* }"
-
-    if [ "${PING_TIMEOUT_SEC}" -gt 0 ]; then
-        out="$(timeout "${PING_TIMEOUT_SEC}" ping -I "${iface}" -c "${PING_COUNT}" "${target}" 2>&1)"
-    else
-        out="$(ping -I "${iface}" -c "${PING_COUNT}" "${target}" 2>&1)"
-    fi
-    rc=$?
-    printf '%s\n' "${out}"
-
-    c1="$(if_counters "${iface}")"; rx1="${c1% *}"; tx1="${c1#* }"
-    drx=$(( rx1 - rx0 )); dtx=$(( tx1 - tx0 ))
-
-    printf -- '--- ip -s link show %s ---\n' "${iface}"
-    ${SUDO} ip -s link show "${iface}" 2>&1
-
-    # "10 packets transmitted, 10 received, 0% packet loss"
-    tx="$(printf '%s' "${out}"   | sed -n 's/^\([0-9]\+\) packets transmitted.*/\1/p'   | tail -1)"
-    rx="$(printf '%s' "${out}"   | sed -n 's/.*[, ]\([0-9]\+\) received.*/\1/p'         | tail -1)"
-    loss="$(printf '%s' "${out}" | sed -n 's/.*[, ]\([0-9]\+\)% packet loss.*/\1/p'     | tail -1)"
-    # "rtt min/avg/max/mdev = 1.044/1.743/2.387/0.437 ms"
-    avg="$(printf '%s' "${out}"  | sed -n 's|.*= [0-9.]*/\([0-9.]*\)/.*|\1|p'           | tail -1)"
-
-    [ -n "${tx}" ]   || tx=0
-    [ -n "${rx}" ]   || rx=0
-    [ -n "${loss}" ] || loss=100
-    [ -n "${avg}" ]  || avg="-"
-
-    if [ "${rc}" -eq 124 ]; then
-        verdict="FAIL(timeout)"
-    elif [ "${loss}" -le "${MAX_LOSS_PCT}" ]; then
-        verdict="PASS"
-    else
-        verdict="FAIL"
-    fi
-
-    # one greppable line per leg: grep RESULT <log>
-    # nic_tx/nic_rx are this interface's own counter delta across the burst --
-    # if they stay near zero while the ping succeeded, the traffic went out a
-    # different NIC and the result is not attributable to this one.
-    printf '[%s] RESULT %-3s %-6s -> %-15s tx=%s rx=%s loss=%s%% rtt_avg=%sms nic_tx=%s nic_rx=%s %s\n\n' \
-           "$(ts)" "${label}" "${iface}" "${target}" "${tx}" "${rx}" "${loss}" "${avg}" \
-           "${dtx}" "${drx}" "${verdict}"
-
-    [ "${verdict}" = "PASS" ]
-}
-
-# arp_ignore=1 : answer ARP only for addresses configured on the incoming NIC
-# arp_announce=2: pick the source address from the outgoing NIC's own subnet
-# Both are RAM-only sysctls and revert on reboot.
 apply_arp_strict() {
     local i
     [ "${ARP_STRICT}" -eq 1 ] || return 0
@@ -302,143 +143,245 @@ apply_arp_strict() {
         ${SUDO} sysctl -qw "net.ipv4.conf.${i}.arp_ignore=1"   2>/dev/null
         ${SUDO} sysctl -qw "net.ipv4.conf.${i}.arp_announce=2" 2>/dev/null
     done
-    printf '[%s] INFO : arp_ignore=1 arp_announce=2 applied to %s,%s\n' \
-           "$(ts)" "${IF_10G}" "${IF_1G}"
 }
 
-main_loop() {
+# Resolve the neighbour so the measured run does not spend its first packet on
-    local round=0 pass=0 fail=0
+# ARP. Result is deliberately discarded.
+arp_warmup() {
+    local iface="$1" target="$2"
+    [ "${ARP_WARMUP}" -eq 1 ] || return 0
+    ping -I "${iface}" -c 1 -W "${ARP_WARMUP_TIMEOUT}" "${target}" >/dev/null 2>&1
+    return 0
+}
 
-    command -v ip   >/dev/null 2>&1 || die "ip (iproute2) not found"
+# echo "pid_10g pid_1g" and return 0 when both are alive
-    command -v ping >/dev/null 2>&1 || die "ping not found"
+is_running() {
-    [ "${PING_COUNT}" -gt 0 ] 2>/dev/null || die "PING_COUNT must be > 0"
+    local p0 p1
+    [ -f "${PID_FILE}" ] || return 1
+    p0="$(sed -n '1p' "${PID_FILE}" 2>/dev/null)"
+    p1="$(sed -n '2p' "${PID_FILE}" 2>/dev/null)"
+    [[ "${p0}" =~ ^[0-9]+$ ]] || return 1
+    [[ "${p1}" =~ ^[0-9]+$ ]] || return 1
+    kill -0 "${p0}" 2>/dev/null || kill -0 "${p1}" 2>/dev/null || return 1
+    printf '%s %s' "${p0}" "${p1}"
+    return 0
+}
 
-    trap on_signal INT TERM
+###############################################################################
+# Report
+###############################################################################
 
+# The recent entries for one NIC: replies and, thanks to -O, the requests that
+# got none.
+tail_entries() {
+    grep -aE 'bytes from|no answer|Unreachable|Time to live' "$1" 2>/dev/null \
+        | tail -n "${TAIL_LINES}"
+}
+
+# The trailing "--- x ping statistics ---" block.
+stats_block() {
+    sed -n '/ping statistics ---/,$p' "$1" 2>/dev/null
+}
+
+# render_leg <label> <iface> <target> <raw> <rx0> <tx0>
+render_leg() {
+    local label="$1" iface="$2" target="$3" raw="$4" rx0="$5" tx0="$6"
+    local st tx rx loss avg verdict c1 rx1 tx1 drx dtx
+
+    printf -- '----- %s : %s -> %s : last %s entries -----\n' \
+              "${label}" "${iface}" "${target}" "${TAIL_LINES}"
+    tail_entries "${raw}"
+    printf '\n'
+    st="$(stats_block "${raw}")"
+    printf '%s\n' "${st}"
+
+    tx="$(printf '%s' "${st}"   | sed -n 's/^\([0-9]\+\) packets transmitted.*/\1/p'   | tail -1)"
+    rx="$(printf '%s' "${st}"   | sed -n 's/.*[, ]\([0-9]\+\) received.*/\1/p'         | tail -1)"
+    loss="$(printf '%s' "${st}" | sed -n 's/.*[, ]\([0-9]\+\)% packet loss.*/\1/p'     | tail -1)"
+    avg="$(printf '%s' "${st}"  | sed -n 's|.*= [0-9.]*/\([0-9.]*\)/.*|\1|p'           | tail -1)"
+    [ -n "${tx}" ]   || tx=0
+    [ -n "${rx}" ]   || rx=0
+    [ -n "${loss}" ] || loss=100
+    [ -n "${avg}" ]  || avg="-"
+
+    c1="$(if_counters "${iface}")"; rx1="${c1% *}"; tx1="${c1#* }"
+    drx=$(( rx1 - rx0 )); dtx=$(( tx1 - tx0 ))
+
+    if [ "${loss}" -le "${MAX_LOSS_PCT}" ] && [ "${tx}" -gt 0 ]; then
+        verdict="PASS"
+    else
+        verdict="FAIL"
+    fi
+
+    # nic_tx/nic_rx are this interface's own counter delta over the whole run.
+    # A pass with nic_tx near zero means the traffic left on the other NIC.
+    printf '[%s] RESULT %-3s %-6s -> %-15s tx=%s rx=%s loss=%s%% rtt_avg=%sms nic_tx=%s nic_rx=%s %s\n\n' \
+           "$(ts)" "${label}" "${iface}" "${target}" "${tx}" "${rx}" "${loss}" "${avg}" \
+           "${dtx}" "${drx}" "${verdict}"
+}
+
+write_report() {
+    local rx0_10g tx0_10g rx0_1g tx0_1g started
+    started="$(sed -n '1p' "${STATE_FILE}" 2>/dev/null)"
+    rx0_10g="$(sed -n '2p' "${STATE_FILE}" 2>/dev/null)"; rx0_10g="${rx0_10g:-0}"
+    tx0_10g="$(sed -n '3p' "${STATE_FILE}" 2>/dev/null)"; tx0_10g="${tx0_10g:-0}"
+    rx0_1g="$(sed -n '4p' "${STATE_FILE}" 2>/dev/null)";  rx0_1g="${rx0_1g:-0}"
+    tx0_1g="$(sed -n '5p' "${STATE_FILE}" 2>/dev/null)";  tx0_1g="${tx0_1g:-0}"
+
+    {
         printf '#############################################################\n'
-    printf '[%s] START: pid=%d count=%d settle=%ds interval=%ds\n' \
+        printf '[%s] mgmt ping report\n' "$(ts)"
-           "$(ts)" "$$" "${PING_COUNT}" "${LINK_SETTLE_SEC}" "${INTERVAL_SEC}"
+        printf '  started : %s\n' "${started:-unknown}"
-    printf '[%s]        10G %s %s/%s -> %s  (metric %s)\n' \
+        printf '  stopped : %s\n' "$(ts)"
-           "$(ts)" "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${TARGET_10G}" "${METRIC_10G}"
+        printf '  10G     : %s %s/%s -> %s (metric %s)\n' \
-    printf '[%s]        1G  %s %s/%s -> %s  (metric %s)\n' \
+               "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${TARGET_10G}" "${METRIC_10G}"
-           "$(ts)" "${IF_1G}" "${IP_1G}" "${PLEN_1G}" "${TARGET_1G}" "${METRIC_1G}"
+        printf '  1G      : %s %s/%s -> %s (metric %s)\n' \
-    printf '#############################################################\n'
+               "${IF_1G}" "${IP_1G}" "${PLEN_1G}" "${TARGET_1G}" "${METRIC_1G}"
+        printf '  ping    : -i %s %s, max loss %s%%\n' \
+               "${PING_INTERVAL_SEC}" "${PING_EXTRA_OPTS}" "${MAX_LOSS_PCT}"
+        printf '#############################################################\n\n'
 
-    apply_arp_strict
+        render_leg "10G" "${IF_10G}" "${TARGET_10G}" "${RAW_10G}" "${rx0_10g}" "${tx0_10g}"
+        render_leg "1G"  "${IF_1G}"  "${TARGET_1G}"  "${RAW_1G}"  "${rx0_1g}"  "${tx0_1g}"
 
-    while [ "${STOP}" -eq 0 ]; do
+        printf -- '--- ip -s link show %s ---\n' "${IF_10G}"
-        round=$(( round + 1 ))
+        ${SUDO} ip -s link show "${IF_10G}" 2>&1
-        printf -- '---------- ROUND %d @ %s ----------\n' "${round}" "$(ts)"
+        printf '\n'
-
+        printf -- '--- ip -s link show %s ---\n' "${IF_1G}"
-        if ping_leg "10G" "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${GW_10G}" \
+        ${SUDO} ip -s link show "${IF_1G}" 2>&1
-                    "${METRIC_10G}" "${TARGET_10G}"; then
+    } >> "${LOG_FILE}"
-            pass=$(( pass + 1 )); else fail=$(( fail + 1 ))
-        fi
-        [ "${STOP}" -eq 0 ] || break
-
-        if ping_leg "1G" "${IF_1G}" "${IP_1G}" "${PLEN_1G}" "${GW_1G}" \
-                    "${METRIC_1G}" "${TARGET_1G}"; then
-            pass=$(( pass + 1 )); else fail=$(( fail + 1 ))
-        fi
-
-        rotate_log_if_needed
-
-        if [ "${MAX_ROUNDS}" -gt 0 ] && [ "${round}" -ge "${MAX_ROUNDS}" ]; then
-            break
-        fi
-        [ "${STOP}" -eq 0 ] && interruptible_sleep "${INTERVAL_SEC}"
-    done
-
-    printf '[%s] STOP : pid=%d after %d round(s), legs PASS=%d FAIL=%d\n' \
-           "$(ts)" "$$" "${round}" "${pass}" "${fail}"
 }
 
 ###############################################################################
 # Sub-commands
 ###############################################################################
-do_start() {
+prepare_log_on_start() {
-    local pid
+    local stamp
-    pid="$(is_running)" && die "already running (pid=${pid})"
+    case "${START_LOG_MODE}" in
-    mkdir -p "${LOG_DIR}" || die "cannot create ${LOG_DIR}"
+        append) return 0 ;;
-    prepare_log_on_start
+        archive)
-
+            if [ -s "${LOG_FILE}" ]; then
-    if command -v setsid >/dev/null 2>&1; then
+                stamp="$(date '+%Y%m%d-%H%M%S')"
-        setsid "${SCRIPT_PATH}" __daemon >/dev/null 2>&1 &
+                mv -f "${LOG_FILE}" "${LOG_FILE}.${stamp}" || die "cannot archive ${LOG_FILE}"
-    else
+                printf 'previous log archived: %s.%s\n' "${LOG_FILE}" "${stamp}"
-        nohup "${SCRIPT_PATH}" __daemon >/dev/null 2>&1 &
-        disown 2>/dev/null
             fi
-
+            ;;
-    sleep 1
+        new)
-    pid="$(is_running)" || die "start failed, check ${LOG_FILE}"
+            # Truncate rather than unlink, so a tail -f already attached keeps
-    printf 'started (pid=%s)\nlog: %s\n' "${pid}" "${LOG_FILE}"
+            # following the new run.
+            [ -f "${LOG_FILE}" ] && { : > "${LOG_FILE}" || die "cannot truncate ${LOG_FILE}"; }
+            ;;
+        *) die "invalid START_LOG_MODE: ${START_LOG_MODE}" ;;
+    esac
 }
 
-do_daemon() {
+do_start() {
+    local pids p0 p1 c
+
+    pids="$(is_running)" && die "already running (pids=${pids})"
+
+    command -v ip   >/dev/null 2>&1 || die "ip (iproute2) not found"
+    command -v ping >/dev/null 2>&1 || die "ping not found"
+
     mkdir -p "${LOG_DIR}" || die "cannot create ${LOG_DIR}"
-    LOG_TO_FILE=1
+    prepare_log_on_start
-    exec >>"${LOG_FILE}" 2>&1
+    : > "${RAW_10G}"
-    printf '%d\n' "$$" > "${PID_FILE}"
+    : > "${RAW_1G}"
-    trap 'rm -f "${PID_FILE}"' EXIT
+
-    main_loop
+    setup_iface "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${GW_10G}" "${METRIC_10G}" \
+        || die "cannot configure ${IF_10G}"
+    setup_iface "${IF_1G}"  "${IP_1G}"  "${PLEN_1G}"  "${GW_1G}"  "${METRIC_1G}" \
+        || die "cannot configure ${IF_1G}"
+    apply_arp_strict
+    sleep "${LINK_SETTLE_SEC}"
+
+    # Spend the ARP resolution here, not on the first measured packet.
+    arp_warmup "${IF_10G}" "${TARGET_10G}"
+    arp_warmup "${IF_1G}"  "${TARGET_1G}"
+
+    # Counter baseline, taken after the warm-up so its packets are excluded.
+    { c="$(if_counters "${IF_10G}")"
+      printf '%s\n%s\n%s\n' "$(ts)" "${c% *}" "${c#* }"
+      c="$(if_counters "${IF_1G}")"
+      printf '%s\n%s\n' "${c% *}" "${c#* }"
+    } > "${STATE_FILE}"
+
+    # Both NICs ping at the same time and keep accumulating until stopped.
+    nohup ping -I "${IF_10G}" -i "${PING_INTERVAL_SEC}" ${PING_EXTRA_OPTS} \
+          "${TARGET_10G}" >> "${RAW_10G}" 2>&1 &
+    p0=$!
+    nohup ping -I "${IF_1G}"  -i "${PING_INTERVAL_SEC}" ${PING_EXTRA_OPTS} \
+          "${TARGET_1G}"  >> "${RAW_1G}"  2>&1 &
+    p1=$!
+    disown "${p0}" 2>/dev/null
+    disown "${p1}" 2>/dev/null
+    printf '%s\n%s\n' "${p0}" "${p1}" > "${PID_FILE}"
+
+    sleep 1
+    kill -0 "${p0}" 2>/dev/null || die "10G ping failed to start, see ${RAW_10G}"
+    kill -0 "${p1}" 2>/dev/null || die "1G ping failed to start, see ${RAW_1G}"
+    printf 'started (10G pid=%s, 1G pid=%s)\nlog: %s\n' "${p0}" "${p1}" "${LOG_FILE}"
 }
 
 do_stop() {
-    local pid i
+    local pids p0 p1 i
-    pid="$(is_running)" || { printf 'not running\n'; rm -f "${PID_FILE}"; return 0; }
 
-    kill -TERM -"${pid}" 2>/dev/null || kill -TERM "${pid}" 2>/dev/null
+    pids="$(is_running)" || {
+        printf 'not running\n'
+        rm -f "${PID_FILE}"
+        return 0
+    }
+    p0="${pids% *}"; p1="${pids#* }"
+
+    # SIGINT, not SIGTERM: ping prints its statistics block on interrupt, and
+    # that block is what the report parses.
+    kill -INT "${p0}" 2>/dev/null
+    kill -INT "${p1}" 2>/dev/null
     for (( i = 0; i < 20; i++ )); do
-        kill -0 "${pid}" 2>/dev/null || break
+        kill -0 "${p0}" 2>/dev/null || kill -0 "${p1}" 2>/dev/null || break
         sleep 0.5
     done
-    if kill -0 "${pid}" 2>/dev/null; then
+    kill -KILL "${p0}" 2>/dev/null
-        printf 'SIGTERM ignored, sending SIGKILL\n'
+    kill -KILL "${p1}" 2>/dev/null
-        kill -KILL -"${pid}" 2>/dev/null || kill -KILL "${pid}" 2>/dev/null
+
-    fi
+    write_report
     rm -f "${PID_FILE}"
-    printf 'stopped (pid=%s)\n' "${pid}"
+    printf 'stopped (10G pid=%s, 1G pid=%s)\nreport: %s\n' "${p0}" "${p1}" "${LOG_FILE}"
 }
 
 do_status() {
-    local pid
+    local pids
-    if pid="$(is_running)"; then
+    if pids="$(is_running)"; then
-        printf 'status : running (pid=%s)\n' "${pid}"
+        printf 'status : running (10G pid=%s, 1G pid=%s)\n' "${pids% *}" "${pids#* }"
     else
         printf 'status : stopped\n'
     fi
     printf 'log    : %s\n' "${LOG_FILE}"
-    [ -f "${LOG_FILE}" ] && printf 'size   : %s\n' "$(du -h "${LOG_FILE}" | cut -f1)"
+    printf '10G    : %s %s/%s -> %s\n' "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${TARGET_10G}"
-    printf 'ping   : count=%d, interval=%ds, settle=%ds\n' "${PING_COUNT}" "${INTERVAL_SEC}" "${LINK_SETTLE_SEC}"
+    printf '1G     : %s %s/%s -> %s\n' "${IF_1G}"  "${IP_1G}"  "${PLEN_1G}"  "${TARGET_1G}"
-    printf '10G    : %s %s/%s -> %s (metric %s)\n' "${IF_10G}" "${IP_10G}" "${PLEN_10G}" "${TARGET_10G}" "${METRIC_10G}"
+    [ -f "${RAW_10G}" ] && printf '10G recv: %s\n' "$(grep -ac 'bytes from' "${RAW_10G}")"
-    printf '1G     : %s %s/%s -> %s (metric %s)\n' "${IF_1G}" "${IP_1G}" "${PLEN_1G}" "${TARGET_1G}" "${METRIC_1G}"
+    [ -f "${RAW_1G}" ]  && printf '1G  recv: %s\n' "$(grep -ac 'bytes from' "${RAW_1G}")"
 }
 
 usage() {
     cat <<EOF
-Usage: ${SCRIPT_NAME} {start|stop|status|fg|tail|clear|summary}
+Usage: ${SCRIPT_NAME} {start|stop|status|summary|clear}
 
-  start    Run detached in the background; the previous log is discarded first
+  start    Configure both NICs, warm up ARP, then ping from BOTH at the same
-           (see START_LOG_MODE)
+           time and keep accumulating. The previous log is discarded first.
-  stop     Stop the background instance
+  stop     Stop both pings and render the report into the log
-  status   Show pid / log path / configured NICs
+  status   Show pids, configured NICs and replies received so far
-  fg       Run in the foreground, output to the terminal (for a quick check)
+  summary  Print just the RESULT lines from the log
-  tail     tail -f the log file  (does NOT return -- do not call from a macro)
+  clear    Remove the log and the raw captures (must be stopped first)
-  clear    Remove the log file and all rotated copies (must be stopped first)
-  summary  Print just the per-leg RESULT lines from the log
 
 Log file : ${LOG_FILE}
 
-One round = 10G leg then 1G leg, each pinging its own target. Both NICs are
+The report holds, per NIC, the last ${TAIL_LINES} entries and the ping
-brought up and left up; addresses and routes are applied with
+statistics, then "ip -s link show" for both interfaces.
-"ip address/route replace", so repeating a round does not stack duplicates.
 
-If both NICs share a subnet, keep ARP_STRICT=1 -- otherwise a reply can come
+Both NICs are used at once, so management connectivity is in play -- drive
-back on the NIC that did not send it. Check nic_tx/nic_rx on the RESULT line:
+this from the serial console. Edit the User Configurable Section at the top
-they are that interface's own counter delta across the burst.
+to change interfaces, addresses, targets or the ping options.
-
-Edit the User Configurable Section at the top to change interfaces, addresses,
-targets, prefix lengths, gateways, metrics or the packet count.
 EOF
 }
 
@@ -449,15 +392,12 @@ case "${1:-}" in
     start)   do_start ;;
     stop)    do_stop ;;
     status)  do_status ;;
-    fg)       LOG_TO_FILE=0; main_loop ;;
-    tail)     tail -n 50 -f "${LOG_FILE}" ;;
     summary) grep -a 'RESULT' "${LOG_FILE}" 2>/dev/null || printf 'no results in %s\n' "${LOG_FILE}" ;;
     clear)
         is_running >/dev/null && die "still running, stop it first"
-        rm -f "${LOG_FILE}" "${LOG_FILE}".[0-9]*
+        rm -f "${LOG_FILE}" "${LOG_FILE}".[0-9]* "${RAW_10G}" "${RAW_1G}" "${STATE_FILE}"
         printf 'log cleared\n'
         ;;
-    __daemon) do_daemon ;;
     -h|--help|"") usage ;;
     *) printf '[ERROR] unknown sub-command: %s\n\n' "$1" >&2; usage; exit 1 ;;
 esac

src/Script_ABC_Blanton/Blanton_Script/nfc_polling.sh

@@ -0,0 +1,314 @@
+#!/usr/bin/env bash
+# =============================================================================
+# nfc_polling.sh  --  keep reading the NFC tag in the background, and tally it
+# =============================================================================
+# Version History:
+#   V1.0.0  2026-08-28  First version. start/stop/status/tail/report/clear/fg,
+#                       wraps blantons_nfc_validate.py. 'report' works while the
+#                       poll is still running.
+# =============================================================================
+#
+# Each round runs blantons_nfc_validate.py once and appends a machine-readable
+# verdict line, so 'report' never has to parse the tool's prose:
+#
+#     [2026-08-28 15:04:11] NFC poll #000001 START
+#     ... the tool's own output ...
+#     [2026-08-28 15:04:14] NFC poll #000001 RESULT=PASS tag=046F7BD2142290
+#
+# The verdict comes from the tool's own [PASS] / [FAIL] summary line. If neither
+# appears the round is ERROR, not FAIL -- "the tool did not run" and "the tag was
+# not read" are different problems and get counted separately.
+#
+# Usage:
+#   ./nfc_polling.sh start        # background, CLEARS the log first
+#   ./nfc_polling.sh status       # running? pid, rounds so far, log size
+#   ./nfc_polling.sh tail [n]     # last n lines (default 50) -- does NOT follow
+#   ./nfc_polling.sh report       # PASS/FAIL tally; safe to run WHILE polling
+#   ./nfc_polling.sh stop
+#   ./nfc_polling.sh clear        # delete the log (must be stopped)
+#   ./nfc_polling.sh fg           # run in the foreground, Ctrl-C to stop
+#
+# Environment overrides:
+#   NFC_INTERVAL_SEC=10   NFC_TIMEOUT_SEC=60   NFC_MAX_ROUNDS=0 (0 = forever)
+#   NFC_ARGS="test --debug"   NFC_LOG_DIR=<dir>   NFC_BIN=<python3>
+# =============================================================================
+
+# --- User Configurable Section ----------------------------------------------
+NFC_INTERVAL_SEC="${NFC_INTERVAL_SEC:-10}"   # gap between rounds
+NFC_TIMEOUT_SEC="${NFC_TIMEOUT_SEC:-60}"     # kill a round that hangs (0 = never)
+NFC_MAX_ROUNDS="${NFC_MAX_ROUNDS:-0}"        # 0 = until 'stop'
+
+# Called through python3 on purpose: blantons_nfc_validate.py arrives from git
+# (mode 100644) and a Windows/USB copy does not carry the execute bit either, so
+# "./blantons_nfc_validate.py" would fail with Permission denied on a fresh DUT.
+NFC_PY="${NFC_PY:-python3}"
+NFC_SCRIPT_NAME="${NFC_SCRIPT_NAME:-blantons_nfc_validate.py}"
+
+# --debug is kept because that is the output that has been seen on the bench.
+# It costs ~1.5 KB per round (~13 MB/day at a 10s interval), which is fine for a
+# soak; drop it to "test" if you want a smaller log.
+NFC_ARGS="${NFC_ARGS:-test --debug}"
+
+NFC_LOG_DIR="${NFC_LOG_DIR:-}"               # empty = <script dir>/log
+NFC_LOG_NAME="${NFC_LOG_NAME:-nfc_poll.log}"
+# -----------------------------------------------------------------------------
+
+SCRIPT_NAME="$(basename -- "${BASH_SOURCE[0]}")"
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPT_PATH="${SCRIPT_DIR}/${SCRIPT_NAME}"
+NFC_SCRIPT="${NFC_SCRIPT:-${SCRIPT_DIR}/${NFC_SCRIPT_NAME}}"
+[ -n "${NFC_LOG_DIR}" ] || NFC_LOG_DIR="${SCRIPT_DIR}/log"
+LOG_FILE="${NFC_LOG_DIR}/${NFC_LOG_NAME}"
+PID_FILE="${NFC_LOG_DIR}/${NFC_LOG_NAME%.log}.pid"
+
+STOP=0
+SLEEP_PID=""
+
+ts()  { date '+%Y-%m-%d %H:%M:%S'; }
+die() { printf '[ERROR] %s\n' "$*" >&2; exit 1; }
+
+on_signal() {
+    STOP=1
+    [ -n "${SLEEP_PID}" ] && kill "${SLEEP_PID}" 2>/dev/null
+    return 0
+}
+
+# sleep that a signal can cut short, so 'stop' does not wait out the interval
+interruptible_sleep() {
+    local sec="$1"
+    [ "${sec}" -le 0 ] 2>/dev/null && return 0
+    sleep "${sec}" &
+    SLEEP_PID=$!
+    wait "${SLEEP_PID}" 2>/dev/null
+    SLEEP_PID=""
+    return 0
+}
+
+is_running() {
+    local pid
+    [ -f "${PID_FILE}" ] || return 1
+    pid="$(cat "${PID_FILE}" 2>/dev/null)"
+    [ -n "${pid}" ] || return 1
+    kill -0 "${pid}" 2>/dev/null || return 1
+    printf '%s' "${pid}"
+    return 0
+}
+
+# --- one round ---------------------------------------------------------------
+# Appends START, the tool output, then a RESULT line. Everything about a round
+# lands in the log even when the tool dies, so 'report' can still account for it.
+run_one_round() {
+    local n="$1" out rc verdict tag reason
+    printf '[%s] NFC poll #%06d START\n' "$(ts)" "${n}"
+
+    if [ -n "${NFC_TIMEOUT_SEC}" ] && [ "${NFC_TIMEOUT_SEC}" -gt 0 ] 2>/dev/null \
+       && command -v timeout >/dev/null 2>&1; then
+        out="$(timeout "${NFC_TIMEOUT_SEC}" "${NFC_PY}" "${NFC_SCRIPT}" ${NFC_ARGS} 2>&1)"; rc=$?
+    else
+        out="$("${NFC_PY}" "${NFC_SCRIPT}" ${NFC_ARGS} 2>&1)"; rc=$?
+    fi
+    printf '%s\n' "${out}"
+
+    # The tool's own summary decides. Exit status is only the fallback, because
+    # a tool that never printed a summary did not measure anything.
+    if printf '%s\n' "${out}" | grep -q '^\[PASS\]'; then
+        verdict="PASS"
+    elif printf '%s\n' "${out}" | grep -q '^\[FAIL\]'; then
+        verdict="FAIL"
+    elif [ "${rc}" -eq 124 ]; then
+        verdict="ERROR"; reason="round exceeded NFC_TIMEOUT_SEC=${NFC_TIMEOUT_SEC}s"
+    else
+        verdict="ERROR"; reason="no [PASS]/[FAIL] summary, exit=${rc}"
+    fi
+
+    tag="$(printf '%s\n' "${out}" | sed -n 's/.*NFCID1=\([0-9A-Fa-f]*\).*/\1/p' | tail -1)"
+    [ -n "${reason}" ] || reason="$(printf '%s\n' "${out}" | grep -m1 '^\[\(PASS\|FAIL\)\]' | cut -c8-)"
+
+    printf '[%s] NFC poll #%06d RESULT=%s tag=%s reason=%s\n' \
+           "$(ts)" "${n}" "${verdict}" "${tag:--}" "${reason:--}"
+}
+
+main_loop() {
+    local n=0
+    trap on_signal INT TERM
+    printf '[%s] ===== nfc_polling start : %s %s (interval %ss) =====\n' \
+           "$(ts)" "${NFC_PY}" "${NFC_SCRIPT}" "${NFC_INTERVAL_SEC}"
+    while [ "${STOP}" -eq 0 ]; do
+        n=$(( n + 1 ))
+        run_one_round "${n}"
+        if [ "${NFC_MAX_ROUNDS}" -gt 0 ] 2>/dev/null && [ "${n}" -ge "${NFC_MAX_ROUNDS}" ]; then
+            break
+        fi
+        [ "${STOP}" -eq 0 ] && interruptible_sleep "${NFC_INTERVAL_SEC}"
+    done
+    printf '[%s] ===== nfc_polling stop : %d round(s) =====\n' "$(ts)" "${n}"
+}
+
+# --- sub-commands ------------------------------------------------------------
+do_start() {
+    local pid
+    pid="$(is_running)" && die "already running (pid=${pid})"
+    [ -r "${NFC_SCRIPT}" ] || die "cannot read ${NFC_SCRIPT}"
+    command -v "${NFC_PY}" >/dev/null 2>&1 || die "${NFC_PY} not found"
+    mkdir -p "${NFC_LOG_DIR}" || die "cannot create ${NFC_LOG_DIR}"
+
+    # start always begins a fresh log, so a report is about THIS run only
+    : > "${LOG_FILE}" || die "cannot write ${LOG_FILE}"
+
+    if command -v setsid >/dev/null 2>&1; then
+        setsid "${SCRIPT_PATH}" __daemon >/dev/null 2>&1 &
+    else
+        nohup "${SCRIPT_PATH}" __daemon >/dev/null 2>&1 &
+        disown 2>/dev/null
+    fi
+
+    sleep 1
+    pid="$(is_running)" || die "start failed, check ${LOG_FILE}"
+    printf 'started (pid=%s)\nlog: %s\n' "${pid}" "${LOG_FILE}"
+}
+
+do_daemon() {
+    mkdir -p "${NFC_LOG_DIR}" || die "cannot create ${NFC_LOG_DIR}"
+    exec >>"${LOG_FILE}" 2>&1
+    printf '%d\n' "$$" > "${PID_FILE}"
+    trap 'rm -f "${PID_FILE}"' EXIT
+    main_loop
+}
+
+do_stop() {
+    local pid i
+    pid="$(is_running)" || { printf 'not running\n'; rm -f "${PID_FILE}"; return 0; }
+    kill -TERM -"${pid}" 2>/dev/null || kill -TERM "${pid}" 2>/dev/null
+    for (( i = 0; i < 20; i++ )); do
+        kill -0 "${pid}" 2>/dev/null || break
+        sleep 0.5
+    done
+    if kill -0 "${pid}" 2>/dev/null; then
+        printf 'SIGTERM ignored, sending SIGKILL\n'
+        kill -KILL -"${pid}" 2>/dev/null || kill -KILL "${pid}" 2>/dev/null
+    fi
+    rm -f "${PID_FILE}"
+    printf 'stopped (pid=%s)\n' "${pid}"
+}
+
+# counts straight out of the log, so it is the same answer running or stopped
+_tally() {
+    local f="$1"
+    [ -r "${f}" ] || { printf '0 0 0 0\n'; return; }
+    awk '
+        /RESULT=PASS/  { p++ }
+        /RESULT=FAIL/  { f++ }
+        /RESULT=ERROR/ { e++ }
+        / START$/      { s++ }
+        END { printf "%d %d %d %d\n", s+0, p+0, f+0, e+0 }
+    ' "${f}"
+}
+
+do_status() {
+    local pid started passed failed errored size
+    if pid="$(is_running)"; then
+        printf 'status : running (pid=%s)\n' "${pid}"
+    else
+        printf 'status : stopped\n'
+    fi
+    printf 'log    : %s\n' "${LOG_FILE}"
+    if [ -r "${LOG_FILE}" ]; then
+        size="$(du -h "${LOG_FILE}" 2>/dev/null | cut -f1)"
+        read -r started passed failed errored <<< "$(_tally "${LOG_FILE}")"
+        printf 'size   : %s\n' "${size:-?}"
+        printf 'rounds : %s started  (PASS %s / FAIL %s / ERROR %s)\n' \
+               "${started}" "${passed}" "${failed}" "${errored}"
+        printf 'last   : %s\n' "$(grep -a 'RESULT=' "${LOG_FILE}" | tail -1)"
+    else
+        printf 'size   : (no log yet)\n'
+    fi
+}
+
+do_report() {
+    local pid started passed failed errored inflight verdict first last
+    [ -r "${LOG_FILE}" ] || die "no log at ${LOG_FILE} -- has it been started?"
+    read -r started passed failed errored <<< "$(_tally "${LOG_FILE}")"
+    inflight=$(( started - passed - failed - errored ))
+
+    echo "===== NFC polling report ====="
+    printf 'log      : %s\n' "${LOG_FILE}"
+    if pid="$(is_running)"; then
+        printf 'state    : RUNNING (pid=%s) -- this is a snapshot, the count is still moving\n' "${pid}"
+    else
+        printf 'state    : stopped\n'
+    fi
+    first="$(grep -a -m1 ' START$' "${LOG_FILE}" | sed -n 's/^\[\([^]]*\)\].*/\1/p')"
+    last="$(grep -a 'RESULT=' "${LOG_FILE}" | tail -1 | sed -n 's/^\[\([^]]*\)\].*/\1/p')"
+    printf 'window   : %s -> %s\n' "${first:-?}" "${last:-?}"
+    echo ""
+    printf 'rounds   : %d\n' "${started}"
+    printf 'PASS     : %d\n' "${passed}"
+    printf 'FAIL     : %d\n' "${failed}"
+    printf 'ERROR    : %d   (tool did not produce a verdict)\n' "${errored}"
+    [ "${inflight}" -gt 0 ] && printf 'in flight: %d   (round started, no result yet)\n' "${inflight}"
+
+    if [ "${started}" -eq 0 ]; then
+        verdict="NO DATA"
+    elif [ "${failed}" -gt 0 ] || [ "${errored}" -gt 0 ]; then
+        verdict="FAIL"
+    else
+        verdict="PASS"
+    fi
+    printf 'RESULT   : %s\n' "${verdict}"
+
+    echo ""
+    echo "--- tags seen ---"
+    grep -a 'RESULT=PASS' "${LOG_FILE}" \
+        | sed -n 's/.* tag=\([0-9A-Fa-f]*\) .*/\1/p' \
+        | sort | uniq -c | sort -rn | awk '{printf "  %-20s %s\n", $2, $1}'
+    grep -aq 'RESULT=PASS.* tag=[0-9A-Fa-f]' "${LOG_FILE}" || echo "  (none)"
+
+    if [ "$(( failed + errored ))" -gt 0 ]; then
+        echo ""
+        echo "--- last 10 FAIL / ERROR ---"
+        grep -aE 'RESULT=(FAIL|ERROR)' "${LOG_FILE}" | tail -10 | sed 's/^/  /'
+    fi
+    echo ""
+    [ "${verdict}" = "FAIL" ] && return 2
+    return 0
+}
+
+usage() {
+    cat <<USAGE
+${SCRIPT_NAME} - background NFC tag polling (wraps ${NFC_SCRIPT_NAME})
+
+  start        run in the background; CLEARS the log first
+  stop         stop it
+  status       running? pid, rounds so far, last result
+  tail [n]     last n lines of the log (default 50) -- does NOT follow
+  report       PASS/FAIL tally -- safe to run WHILE polling
+  clear        delete the log (must be stopped)
+  fg           run in the foreground, Ctrl-C to stop
+
+  interval ${NFC_INTERVAL_SEC}s   per-round timeout ${NFC_TIMEOUT_SEC}s   rounds ${NFC_MAX_ROUNDS} (0 = forever)
+  log ${LOG_FILE}
+
+  A round is PASS or FAIL from the tool's own summary line; ERROR means it
+  produced neither, which is a different problem from a tag that would not read.
+USAGE
+}
+
+case "${1:-}" in
+    start)    do_start ;;
+    stop)     do_stop ;;
+    status)   do_status ;;
+    report)   do_report ;;
+    # deliberately NOT 'tail -f': that never returns, and a TTL macro waiting on
+    # the prompt would hang there forever.
+    tail)     [ -r "${LOG_FILE}" ] || die "no log at ${LOG_FILE}"
+              tail -n "${2:-50}" "${LOG_FILE}" ;;
+    clear)
+        is_running >/dev/null && die "still running, stop it first"
+        rm -f "${LOG_FILE}"
+        printf 'log cleared\n'
+        ;;
+    fg)       main_loop ;;
+    __daemon) do_daemon ;;
+    -h|--help|"") usage ;;
+    *)        printf '[ERROR] unknown sub-command: %s\n\n' "$1" >&2; usage; exit 1 ;;
+esac

src/Script_ABC_Blanton/Blanton_Script/port_prbs_monitor.sh

@@ -0,0 +1,431 @@
+#!/bin/bash
+###############################################################################
+# port_prbs_monitor.sh
+#
+# Version : V1.0.0
+# Author  : ETWen
+# Date    : 20260826
+#
+# Purpose : Run a PRBS test on the two 100G uplinks AT THE SAME TIME and keep
+#           polling until stopped. Each port gets its own background worker:
+#
+#               setup : sfputil lpmode off <port>
+#                       phy diag <phy> prbs set <poly>
+#                       phy diag <phy> prbsstat STArt Interval=<n>
+#               poll  : phy diag <phy> prbs get        <- PASS/FAIL comes from here
+#                       phydiag  <phy> prbsstat Ber    <- recorded only
+#               stop  : phydiag <phy> prbsstat STOp
+#                       phydiag <phy> prbs clear
+#
+#           Every command and its full output goes to that port's raw log.
+#           `stop` tears the test down and renders the report; `report`
+#           prints the PASS/FAIL tally per port.
+#
+# Notes   : - A poll counts as PASS only when the output contains "PRBS OK!".
+#             bcmcmd exits 0 even when the BCM shell rejects a command, so the
+#             exit status cannot be used -- only the output can.
+#           - bcmcmd is always run with </dev/null. Without it, it inherits the
+#             polling loop's stdin and eats it, and the loop runs once.
+#
+# Version History
+# V1.0.0     20260826    Initial Version
+###############################################################################
+
+set -u
+
+###############################################################################
+# User Configurable Section  -- normally this is the only part you need to edit
+###############################################################################
+
+# --- port A ---
+PORT_A_NAME="Ethernet513"
+PORT_A_UNIT=0                  # bcmcmd -n <unit>
+PORT_A_PHY=268                 # phy diag <phy>
+
+# --- port B ---
+PORT_B_NAME="Ethernet514"
+PORT_B_UNIT=1
+PORT_B_PHY=268
+
+# Which ports `start` runs when no argument is given: both | a | b
+# Override per run:  start a   /   start b   /   start both
+# Running one at a time is how you tell a genuine port fault from the DUT not
+# coping with two PRBS streams at once.
+PORTS="both"
+
+# --- PRBS ---
+PRBS_POLY="p=3"                # passed to "prbs set"
+PRBS_STAT_INTERVAL=5           # passed to "prbsstat STArt Interval="
+POLL_INTERVAL_SEC=10           # seconds between polls
+PASS_PATTERN="PRBS OK!"        # a poll is PASS only if the output contains this
+
+# Seconds to wait after the setup commands before the first poll, so the link
+# has settled and the counters mean something.
+SETTLE_SEC=10
+
+
+# Stop after this many polls per port. 0 = run until stopped manually.
+MAX_POLLS=0
+
+# How many recent poll blocks the report shows per port.
+TAIL_ENTRIES=20
+
+# Prefix for privileged commands; empty because this already runs as root.
+SUDO=""
+BCMCMD="bcmcmd"
+
+# Logging
+LOG_DIR=""                     # empty = <script directory>/log
+LOG_NAME="port_prbs.log"
+
+# What `start` does with the log left behind by the previous run:
+#   new | archive | append
+START_LOG_MODE="new"
+
+###############################################################################
+# Internal
+###############################################################################
+SCRIPT_NAME="$(basename -- "${BASH_SOURCE[0]}")"
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPT_PATH="${SCRIPT_DIR}/${SCRIPT_NAME}"
+[ -n "${LOG_DIR}" ] || LOG_DIR="${SCRIPT_DIR}/log"
+
+LOG_FILE="${LOG_DIR}/${LOG_NAME}"
+BASE="${LOG_DIR}/${LOG_NAME%.log}"
+PID_FILE="${BASE}.pid"
+STATE_FILE="${BASE}.state"
+RAW_A="${BASE}_${PORT_A_NAME}.raw"
+RAW_B="${BASE}_${PORT_B_NAME}.raw"
+
+ts()  { date '+%Y-%m-%d %H:%M:%S'; }
+
+# port_tally <name> <raw>  ->  "<polls> <pass> <fail> <verdict>"
+# A raw without a "PRBS START" line means the port was not run this session,
+# which is SKIP -- reporting it as FAIL would make a deliberate single-port
+# run look like half the hardware is broken.
+port_tally() {
+    local name="$1" raw="$2" pass fail polls verdict
+    if [ ! -s "${raw}" ] || ! grep -aq "PRBS START ${name}" "${raw}" 2>/dev/null; then
+        printf '0 0 0 SKIP'; return 0
+    fi
+    pass=$(grep -ac "PRBS ${name} poll=[0-9]* PASS" "${raw}" 2>/dev/null); pass=${pass:-0}
+    fail=$(grep -ac "PRBS ${name} poll=[0-9]* FAIL" "${raw}" 2>/dev/null); fail=${fail:-0}
+    polls=$(( pass + fail ))
+    if [ "${polls}" -gt 0 ] && [ "${fail}" -eq 0 ]; then verdict=PASS; else verdict=FAIL; fi
+    printf '%s %s %s %s' "${polls}" "${pass}" "${fail}" "${verdict}"
+}
+die() { printf '[ERROR] %s\n' "$*" >&2; exit 1; }
+
+# bcm <unit> <dsh command> -- output on stdout, never trusts the exit status.
+# </dev/null so it cannot consume the caller's stdin.
+bcm() {
+    local unit="$1" cmd="$2"
+    ${SUDO} "${BCMCMD}" -n "${unit}" -c "dsh -c \"${cmd}\"" </dev/null 2>&1
+}
+
+# run_step <unit> <dsh command>
+# The command and its full output are written to the LOG via stderr, because
+# the worker has stderr pointed at the raw file. Only the output itself goes to
+# stdout, so `out="$(run_step ...)"` captures the output without swallowing the
+# log lines -- writing both to stdout would have put the whole record inside
+# the variable and left the log with nothing but the poll verdicts.
+run_step() {
+    local unit="$1" cmd="$2" out
+    out="$(bcm "${unit}" "${cmd}")"
+    {
+        printf '[%s] CMD  : bcmcmd -n %s -c '\''dsh -c "%s"'\''\n' "$(ts)" "${unit}" "${cmd}"
+        printf '%s\n' "${out}"
+    } >&2
+    printf '%s' "${out}"
+}
+
+# Echo "<pid_a> <pid_b>" and return 0 while at least one worker is alive. A
+# port that was not started this run is recorded as "-", so a single-port run
+# is a first-class case rather than a half-broken two-port one.
+is_running() {
+    local pa pb alive=0
+    [ -f "${PID_FILE}" ] || return 1
+    pa="$(sed -n '1p' "${PID_FILE}" 2>/dev/null)"; pa="${pa:--}"
+    pb="$(sed -n '2p' "${PID_FILE}" 2>/dev/null)"; pb="${pb:--}"
+    [[ "${pa}" =~ ^[0-9]+$ ]] && kill -0 "${pa}" 2>/dev/null && alive=1
+    [[ "${pb}" =~ ^[0-9]+$ ]] && kill -0 "${pb}" 2>/dev/null && alive=1
+    [ "${alive}" -eq 1 ] || return 1
+    printf '%s %s' "${pa}" "${pb}"
+    return 0
+}
+
+###############################################################################
+# Worker  -- one per port, launched by `start`
+###############################################################################
+WORKER_STOP=0
+worker_on_signal() { WORKER_STOP=1; }
+
+# __worker <name> <unit> <phy> <rawfile>
+do_worker() {
+    local name="$1" unit="$2" phy="$3" raw="$4"
+    local n=0 pass=0 fail=0 out
+
+    exec >>"${raw}" 2>&1
+    trap worker_on_signal INT TERM
+
+    printf '#############################################################\n'
+    printf '[%s] PRBS START %s (unit %s, phy %s) poly=%s interval=%ss poll=%ss\n' \
+           "$(ts)" "${name}" "${unit}" "${phy}" "${PRBS_POLY}" \
+           "${PRBS_STAT_INTERVAL}" "${POLL_INTERVAL_SEC}"
+    printf '#############################################################\n'
+
+    # --- setup ---
+    printf '[%s] CMD  : sfputil lpmode off %s\n' "$(ts)" "${name}"
+    ${SUDO} sfputil lpmode off "${name}" </dev/null 2>&1
+    run_step "${unit}" "phy diag ${phy} prbs set ${PRBS_POLY}"                 >/dev/null
+    run_step "${unit}" "phy diag ${phy} prbsstat STArt Interval=${PRBS_STAT_INTERVAL}" >/dev/null
+
+    sleep "${SETTLE_SEC}"
+
+    # --- poll ---
+    while [ "${WORKER_STOP}" -eq 0 ]; do
+        n=$(( n + 1 ))
+        printf -- '---------- %s POLL %d @ %s ----------\n' "${name}" "${n}" "$(ts)"
+
+        out="$(run_step "${unit}" "phy diag ${phy} prbs get")"
+        # Ber is recorded for the log only; it does not decide the verdict.
+        run_step "${unit}" "phydiag ${phy} prbsstat Ber" >/dev/null
+
+        if printf '%s' "${out}" | grep -qF "${PASS_PATTERN}"; then
+            pass=$(( pass + 1 ))
+            printf '[%s] PRBS %s poll=%d PASS\n' "$(ts)" "${name}" "${n}"
+        else
+            fail=$(( fail + 1 ))
+            printf '[%s] PRBS %s poll=%d FAIL\n' "$(ts)" "${name}" "${n}"
+        fi
+
+        [ "${MAX_POLLS}" -gt 0 ] && [ "${n}" -ge "${MAX_POLLS}" ] && break
+        [ "${WORKER_STOP}" -eq 0 ] || break
+        sleep "${POLL_INTERVAL_SEC}"
+    done
+
+    # --- teardown ---
+    run_step "${unit}" "phydiag ${phy} prbsstat STOp"  >/dev/null
+    run_step "${unit}" "phydiag ${phy} prbs clear"     >/dev/null
+    printf '[%s] PRBS STOP %s polls=%d PASS=%d FAIL=%d\n' \
+           "$(ts)" "${name}" "${n}" "${pass}" "${fail}"
+}
+
+###############################################################################
+# Report
+###############################################################################
+# render_port <name> <unit> <phy> <raw>
+render_port() {
+    local name="$1" unit="$2" phy="$3" raw="$4"
+    local t polls pass fail verdict
+
+    t="$(port_tally "${name}" "${raw}")"
+    polls="$(printf '%s' "${t}" | awk '{print $1}')"
+    pass="$(printf '%s'  "${t}" | awk '{print $2}')"
+    fail="$(printf '%s'  "${t}" | awk '{print $3}')"
+    verdict="$(printf '%s' "${t}" | awk '{print $4}')"
+
+    if [ "${verdict}" = "SKIP" ]; then
+        printf -- '----- %s (unit %s, phy %s) : not run this session -----\n\n' \
+                  "${name}" "${unit}" "${phy}"
+        printf '[%s] RESULT %-12s polls=%-4s PASS=%-4s FAIL=%-4s %s\n\n' \
+               "$(ts)" "${name}" "${polls}" "${pass}" "${fail}" "${verdict}"
+        return 0
+    fi
+
+    printf -- '----- %s (unit %s, phy %s) : last %s poll blocks -----\n' \
+              "${name}" "${unit}" "${phy}" "${TAIL_ENTRIES}"
+    grep -aE "^-{10} ${name} POLL|PRBS ${name} poll=|prbsstat Ber|^ *[0-9]+ *: " "${raw}" 2>/dev/null \
+        | tail -n $(( TAIL_ENTRIES * 3 ))
+    printf '\n'
+    printf '[%s] RESULT %-12s polls=%-4s PASS=%-4s FAIL=%-4s %s\n\n' \
+           "$(ts)" "${name}" "${polls}" "${pass}" "${fail}" "${verdict}"
+}
+
+write_report() {
+    local started
+    started="$(sed -n '1p' "${STATE_FILE}" 2>/dev/null)"
+    {
+        printf '#############################################################\n'
+        printf '[%s] 100G PRBS report\n' "$(ts)"
+        printf '  started : %s\n' "${started:-unknown}"
+        printf '  stopped : %s\n' "$(ts)"
+        printf '  %s : unit %s, phy %s\n' "${PORT_A_NAME}" "${PORT_A_UNIT}" "${PORT_A_PHY}"
+        printf '  %s : unit %s, phy %s\n' "${PORT_B_NAME}" "${PORT_B_UNIT}" "${PORT_B_PHY}"
+        printf '  poly=%s  prbsstat Interval=%s  poll every %ss\n' \
+               "${PRBS_POLY}" "${PRBS_STAT_INTERVAL}" "${POLL_INTERVAL_SEC}"
+        printf '  a poll is PASS only when the output contains "%s"\n' "${PASS_PATTERN}"
+        printf '#############################################################\n\n'
+
+        render_port "${PORT_A_NAME}" "${PORT_A_UNIT}" "${PORT_A_PHY}" "${RAW_A}"
+        render_port "${PORT_B_NAME}" "${PORT_B_UNIT}" "${PORT_B_PHY}" "${RAW_B}"
+
+        # Taken after prbsstat STOp + prbs clear, so this is the recovered
+        # state. During the test the same command would have reported DOWN.
+        printf -- '--- show interfaces status %s,%s (after prbsstat STOp + prbs clear) ---\n' \
+               "${PORT_A_NAME}" "${PORT_B_NAME}"
+        ${SUDO} show interfaces status "${PORT_A_NAME},${PORT_B_NAME}" </dev/null 2>&1
+    } >> "${LOG_FILE}"
+}
+
+###############################################################################
+# Sub-commands
+###############################################################################
+prepare_log_on_start() {
+    local stamp
+    case "${START_LOG_MODE}" in
+        append) return 0 ;;
+        archive)
+            if [ -s "${LOG_FILE}" ]; then
+                stamp="$(date '+%Y%m%d-%H%M%S')"
+                mv -f "${LOG_FILE}" "${LOG_FILE}.${stamp}" || die "cannot archive ${LOG_FILE}"
+            fi ;;
+        new)
+            [ -f "${LOG_FILE}" ] && { : > "${LOG_FILE}" || die "cannot truncate ${LOG_FILE}"; } ;;
+        *) die "invalid START_LOG_MODE: ${START_LOG_MODE}" ;;
+    esac
+}
+
+# do_start [both|a|b|<port name>]
+do_start() {
+    local which="${1:-${PORTS}}" pids pa="-" pb="-" run_a=0 run_b=0
+
+    case "${which}" in
+        both|BOTH|all)                  run_a=1; run_b=1 ;;
+        a|A|"${PORT_A_NAME}")           run_a=1 ;;
+        b|B|"${PORT_B_NAME}")           run_b=1 ;;
+        *) die "unknown port selector '${which}' (use: both | a | b | ${PORT_A_NAME} | ${PORT_B_NAME})" ;;
+    esac
+
+    pids="$(is_running)" && die "already running (pids=${pids})"
+    command -v "${BCMCMD}" >/dev/null 2>&1 || die "${BCMCMD} not found"
+
+    mkdir -p "${LOG_DIR}" || die "cannot create ${LOG_DIR}"
+    prepare_log_on_start
+    # Only the selected ports are truncated. A raw with no "PRBS START" line is
+    # what the report uses to tell "not run this session" from "ran and failed".
+    [ "${run_a}" -eq 1 ] && : > "${RAW_A}"
+    [ "${run_b}" -eq 1 ] && : > "${RAW_B}"
+    printf '%s\n' "$(ts)" > "${STATE_FILE}"
+
+    # One worker per selected port; with both, they run at the same time.
+    # Invoked through bash so the file does not need the execute bit.
+    if [ "${run_a}" -eq 1 ]; then
+        setsid bash "${SCRIPT_PATH}" __worker \
+               "${PORT_A_NAME}" "${PORT_A_UNIT}" "${PORT_A_PHY}" "${RAW_A}" >/dev/null 2>&1 &
+        pa=$!
+        disown "${pa}" 2>/dev/null
+    fi
+    if [ "${run_b}" -eq 1 ]; then
+        setsid bash "${SCRIPT_PATH}" __worker \
+               "${PORT_B_NAME}" "${PORT_B_UNIT}" "${PORT_B_PHY}" "${RAW_B}" >/dev/null 2>&1 &
+        pb=$!
+        disown "${pb}" 2>/dev/null
+    fi
+    printf '%s\n%s\n' "${pa}" "${pb}" > "${PID_FILE}"
+
+    sleep 1
+    [ "${run_a}" -eq 1 ] && { kill -0 "${pa}" 2>/dev/null || die "${PORT_A_NAME} worker failed, see ${RAW_A}"; }
+    [ "${run_b}" -eq 1 ] && { kill -0 "${pb}" 2>/dev/null || die "${PORT_B_NAME} worker failed, see ${RAW_B}"; }
+    printf 'started (%s pid=%s, %s pid=%s)\nlog: %s\n' \
+           "${PORT_A_NAME}" "${pa}" "${PORT_B_NAME}" "${pb}" "${LOG_FILE}"
+
+    # Deliberately NOT printing "show interfaces status" here. With PRBS armed
+    # the link is out of normal operation and reports DOWN, which reads as a
+    # failure to anyone glancing at the console. The status is shown in the
+    # report instead, once PRBS has been cleared.
+}
+
+do_stop() {
+    local pids pa pb i
+    pids="$(is_running)" || { printf 'not running\n'; rm -f "${PID_FILE}"; return 0; }
+    pa="${pids% *}"; pb="${pids#* }"
+
+    # TERM lets each worker finish its poll and run prbsstat STOp / prbs clear.
+    [[ "${pa}" =~ ^[0-9]+$ ]] && kill -TERM "${pa}" 2>/dev/null
+    [[ "${pb}" =~ ^[0-9]+$ ]] && kill -TERM "${pb}" 2>/dev/null
+    for (( i = 0; i < 120; i++ )); do
+        kill -0 "${pa}" 2>/dev/null || kill -0 "${pb}" 2>/dev/null || break
+        sleep 0.5
+    done
+    if kill -0 "${pa}" 2>/dev/null || kill -0 "${pb}" 2>/dev/null; then
+        printf 'workers did not exit in time, sending SIGKILL (PRBS may be left running)\n' >&2
+        kill -KILL "${pa}" 2>/dev/null
+        kill -KILL "${pb}" 2>/dev/null
+    fi
+
+    write_report
+    rm -f "${PID_FILE}"
+    printf 'stopped\nreport: %s\n' "${LOG_FILE}"
+}
+
+do_report() {
+    local name raw pass fail polls verdict
+    printf '%-14s %-8s %-8s %-8s %s\n' PORT POLLS PASS FAIL RESULT
+    printf '%-14s %-8s %-8s %-8s %s\n' -------------- -------- -------- -------- ------
+    for spec in "${PORT_A_NAME}:${RAW_A}" "${PORT_B_NAME}:${RAW_B}"; do
+        name="${spec%%:*}"; raw="${spec#*:}"
+        set -- $(port_tally "${name}" "${raw}")
+        printf '%-14s %-8s %-8s %-8s %s\n' "${name}" "$1" "$2" "$3" "$4"
+    done
+}
+
+do_status() {
+    local pids
+    if pids="$(is_running)"; then
+        printf 'status : running (%s pid=%s, %s pid=%s)\n' \
+               "${PORT_A_NAME}" "${pids% *}" "${PORT_B_NAME}" "${pids#* }"
+    else
+        printf 'status : stopped\n'
+    fi
+    printf 'log    : %s\n' "${LOG_FILE}"
+    do_report
+}
+
+usage() {
+    cat <<EOF
+Usage: ${SCRIPT_NAME} {start [both|a|b]|stop|status|report|clear}
+
+  start    Set up PRBS and poll in the background. With no argument it runs
+           \$PORTS (currently "${PORTS}"); "a" or "b" runs that port alone,
+           which is how you tell a genuine port fault from the DUT not coping
+           with two PRBS streams at once.
+             start        both ports at the same time
+             start a      ${PORT_A_NAME} only
+             start b      ${PORT_B_NAME} only
+           Port status is NOT shown here: with PRBS armed the link reports
+           DOWN, which looks like a failure. See the report instead.
+  stop     Stop polling, run prbsstat STOp + prbs clear on both ports, and
+           render the report into the log
+  report   Print the PASS/FAIL tally per port
+  status   Show worker pids plus the current tally
+  clear    Remove the log and raw captures (must be stopped first)
+
+Log file : ${LOG_FILE}
+Raw      : ${RAW_A}
+           ${RAW_B}
+
+A poll is PASS only when "phy diag <phy> prbs get" reports "${PASS_PATTERN}".
+prbsstat Ber is captured alongside every poll but does not decide the verdict.
+A port that was not run in this session reports SKIP, not FAIL.
+EOF
+}
+
+###############################################################################
+# Entry point
+###############################################################################
+case "${1:-}" in
+    start)  shift; do_start "${1:-${PORTS}}" ;;
+    stop)   do_stop ;;
+    status) do_status ;;
+    report) do_report ;;
+    clear)
+        is_running >/dev/null && die "still running, stop it first"
+        rm -f "${LOG_FILE}" "${LOG_FILE}".[0-9]* "${RAW_A}" "${RAW_B}" "${STATE_FILE}"
+        printf 'log cleared\n' ;;
+    __worker)
+        shift
+        do_worker "$1" "$2" "$3" "$4" ;;
+    -h|--help|"") usage ;;
+    *) printf '[ERROR] unknown sub-command: %s\n\n' "$1" >&2; usage; exit 1 ;;
+esac

src/Script_ABC_Blanton/Blanton_Script/usb_target.sh

@@ -0,0 +1,203 @@
+#!/bin/bash
+###############################################################################
+# usb_target.sh
+#
+# Version : V1.1.0
+# Author  : ETWen
+# Date    : 20260825
+# Purpose : Auto-detect an inserted USB mass-storage device and report either
+#           its device node, its mount point, or both.
+#
+#           stdout : requested value(s) only, for $(...) capture
+#           stderr : diagnostic messages
+#
+# Usage   : usb_target.sh [-o dev|mnt|both|id] [-n] [-r seconds]
+#
+#             -o dev    print partition device node   (e.g. /dev/sda1)
+#             -o mnt    print mount point             (e.g. /mnt/usb)   [default]
+#             -o both   print "<dev> <mnt>" on one line
+#             -o id     print stable by-id path       (/dev/disk/by-id/...)
+#             -n        detect only, do not mount
+#             -r sec    udev enumeration wait, default 15
+#
+# Exit    : 0  success
+#           1  no USB mass-storage found
+#           2  multiple USB disks detected (refuse to guess)
+#           3  no usable filesystem on the device
+#           4  mount failed
+#           5  mounted but not writable
+#
+# Version History
+# V1.0.0     20260825    Initial Version
+# V1.1.0     20260825    Add -o/-n/-r options; expose device node and by-id path
+###############################################################################
+set -u
+
+MNT_BASE="/mnt/usb"
+RETRY=15
+OUTPUT="mnt"
+DO_MOUNT=1
+
+log() { echo "[usb] $*" >&2; }   # diagnostics go to stderr; stdout stays clean
+
+while getopts "o:nr:h" opt; do
+    case "$opt" in
+        o) OUTPUT="$OPTARG" ;;
+        n) DO_MOUNT=0 ;;
+        r) RETRY="$OPTARG" ;;
+        h) sed -n '3,30p' "$0" >&2; exit 0 ;;
+        *) log "invalid option"; exit 1 ;;
+    esac
+done
+shift $((OPTIND - 1))
+
+case "$OUTPUT" in
+    dev|mnt|both|id) ;;
+    *) log "invalid -o value: $OUTPUT"; exit 1 ;;
+esac
+
+# "-o dev" / "-o id" alone does not require mounting.
+[ "$OUTPUT" = "dev" ] && [ "$DO_MOUNT" = "1" ] && DO_MOUNT=0
+[ "$OUTPUT" = "id" ]  && [ "$DO_MOUNT" = "1" ] && DO_MOUNT=0
+
+#------------------------------------------------------------------------------
+# Identify the physical disk(s) backing rootfs / /host so they can be excluded.
+# Needed because some platforms boot from a USB DOM, which also reports TRAN=usb.
+#------------------------------------------------------------------------------
+get_system_disk() {
+    local src
+    for mp in /host / ; do
+        src=$(findmnt -no SOURCE "$mp" 2>/dev/null) || continue
+        lsblk -no PKNAME "$src" 2>/dev/null | head -1
+    done | sort -u
+}
+
+#------------------------------------------------------------------------------
+# List candidate USB disks (whole devices, not partitions).
+#------------------------------------------------------------------------------
+find_usb_disks() {
+    local sysdisks; sysdisks=$(get_system_disk)
+    lsblk -dn -o NAME,TYPE,TRAN,RM 2>/dev/null | while read -r name type tran rm; do
+        [ "$type" = "disk" ] || continue
+        case "$name" in loop*|ram*|dm-*|sr*|zram*) continue ;; esac
+
+        # Older util-linux may not expose the TRAN column; fall back to sysfs.
+        if [ "$tran" != "usb" ]; then
+            readlink -f "/sys/block/$name/device" 2>/dev/null | grep -q '/usb[0-9]' || continue
+            [ "$rm" = "1" ] || continue
+        fi
+
+        echo "$sysdisks" | grep -qx "$name" && { log "skip $name (system disk)"; continue; }
+        echo "/dev/$name"
+    done
+}
+
+#------------------------------------------------------------------------------
+# Pick a mountable partition from a disk; fall back to the whole device for
+# superfloppy layouts (filesystem written directly, no partition table).
+#------------------------------------------------------------------------------
+pick_partition() {
+    local disk="$1" p
+    p=$(lsblk -ln -o NAME,TYPE,FSTYPE "$disk" | \
+        awk '$2=="part" && $3!="" {print "/dev/"$1; exit}')
+    [ -n "$p" ] && { echo "$p"; return; }
+    [ -n "$(lsblk -dn -o FSTYPE "$disk")" ] && echo "$disk"
+}
+
+#------------------------------------------------------------------------------
+# Resolve a device node to a stable /dev/disk/by-id path, if one exists.
+#------------------------------------------------------------------------------
+resolve_by_id() {
+    local dev="$1" real link
+    real=$(readlink -f "$dev")
+    for link in /dev/disk/by-id/*; do
+        [ -e "$link" ] || continue
+        case "$link" in *-part*|*) ;; esac
+        [ "$(readlink -f "$link")" = "$real" ] && { echo "$link"; return 0; }
+    done
+    return 1
+}
+
+#------------------------------------------------------------------------------
+# Main
+#------------------------------------------------------------------------------
+disks=""
+for i in $(seq 1 "$RETRY"); do
+    disks=$(find_usb_disks)
+    [ -n "$disks" ] && break
+    sleep 1
+done
+
+[ -z "$disks" ] && { log "no USB mass-storage found"; exit 1; }
+
+n=$(echo "$disks" | wc -l)
+if [ "$n" -gt 1 ]; then
+    log "multiple USB disks detected, refuse to guess:"
+    log "$disks"
+    exit 2
+fi
+disk="$disks"
+
+part=$(pick_partition "$disk")
+[ -z "$part" ] && { log "$disk has no usable filesystem"; exit 3; }
+
+fstype=$(lsblk -no FSTYPE "$part")
+log "found $part (disk=$disk fstype=$fstype)"
+
+# --- device-node only: no mount needed ---------------------------------------
+if [ "$OUTPUT" = "dev" ]; then
+    echo "$part"
+    exit 0
+fi
+
+if [ "$OUTPUT" = "id" ]; then
+    if byid=$(resolve_by_id "$part"); then
+        echo "$byid"
+        exit 0
+    fi
+    log "no by-id path for $part, falling back to device node"
+    echo "$part"
+    exit 0
+fi
+
+# --- mount point required ----------------------------------------------------
+mp=$(lsblk -no MOUNTPOINT "$part" | head -1)
+
+if [ -z "$mp" ] && [ "$DO_MOUNT" = "0" ]; then
+    log "$part is not mounted and -n was given"
+    exit 4
+fi
+
+if [ -z "$mp" ]; then
+    log "mounting $part -> $MNT_BASE"
+    mkdir -p "$MNT_BASE"
+
+    # exfat/ntfs are not always built into the platform kernel.
+    case "$fstype" in
+        exfat) grep -qw exfat /proc/filesystems || modprobe exfat 2>/dev/null ;;
+        ntfs)  grep -qw ntfs3 /proc/filesystems || modprobe ntfs3 2>/dev/null ;;
+    esac
+
+    if ! mount -o rw,noatime "$part" "$MNT_BASE" 2>/dev/null; then
+        log "mount failed (fstype=$fstype)"
+        exit 4
+    fi
+    mp="$MNT_BASE"
+
+    # Verify it is actually writable (read-only media, dirty FAT, or full device).
+    if ! touch "$mp/.wtest" 2>/dev/null; then
+        log "mounted read-only or no space left"
+        umount "$mp"
+        exit 5
+    fi
+    rm -f "$mp/.wtest"
+else
+    log "$part already mounted at $mp"
+fi
+
+if [ "$OUTPUT" = "both" ]; then
+    echo "$part $mp"
+else
+    echo "$mp"
+fi
+exit 0

src/Script_ABC_Blanton/config.ttl

@@ -10,7 +10,7 @@ EN_log            = 1  ; 1: Enable log, 0: Disable log
 ;================================================================
 ; FAN_SPEED
 ;================================================================
-FAN_SPEED = 30
+FAN_SPEED = 100
 ;================================================================
 ; Switch Unit Population
 ;================================================================

tools/100G_PRBS.txt

@@ -0,0 +1,63 @@
+
+
+echo PORTS0=$(bcmcmd -n 0 -c ps | grep -w up | wc -l)
+echo PORTS0=$(bcmcmd -n 1 -c ps | grep -w up | wc -l)
+
+show interfaces status Ethernet513,Ethernet514
+
+
+//100G Port 513 
+sudo sfputil lpmode off Ethernet513
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbs set p=3"'
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbsstat STArt Interval=5"'
+
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbs get"'
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbsstat Ber"'
+
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbsstat STOp"'
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbs clear"'
+
+
+//100G Port 514
+sudo sfputil lpmode off Ethernet514
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbs set p=3"'
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbsstat STArt Interval=5"'
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbs get"'
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbsstat Ber"'
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbsstat STOp"'
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbs clear"'
+
+
+
+
+
+//100G Port 513 
+sudo sfputil lpmode off Ethernet513
+sudo sfputil lpmode off Ethernet514
+
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbs set p=3"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbs set p=3"'
+
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbsstat STArt Interval=5"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbsstat STArt Interval=5"'
+
+bcmcmd -n 0 -c 'dsh -c "phy diag 268 prbs get"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phy diag 268 prbs get"'
+
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbsstat Ber"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbsstat Ber"'
+
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbsstat STOp"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbsstat STOp"'
+
+bcmcmd -n 0 -c 'dsh -c "phydiag 268 prbs clear"'
+sleep 1
+bcmcmd -n 1 -c 'dsh -c "phydiag 268 prbs clear"'
+
+
+

tools/100G_Traffic.txt

@@ -0,0 +1,12 @@
+//Init
+bcmcmd -n 0 -c 'mirror init'
+bcmcmd -n 0 -c 'mirror port ce0 Mode=Ingress DestPort=ce0'
+bcmcmd -n 0 -c 'vlan create 138'
+bcmcmd -n 0 -c 'vlan add 138 pbm=ce0'
+
+//Start
+bcmcmd -n 0 -c 'tx 100 length=512 VLantag=138'
+
+//stop
+bcmcmd -n 0 -c 'mirror port ce0 Mode=Off'
+bcmcmd -n 0 -c 'vlan remove 138 pbm=ce0'

tools/BER_Test.txt

@@ -0,0 +1,900 @@
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs set p=3' "
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs get' "
+ 
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbsstat STArt Interval=30' "
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbsstat Ber' "
+ 
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbsstat STOp' "
+bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs clear' " 
+
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs set p=3' "
+ dsh -c 'phydiag 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 prbs set p=3'
+drivshell>
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs get' "
+ dsh -c 'phydiag 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 prbs get'
+1 : PRBS OK!has been unlocked since last call
+2 : PRBS OK!has been unlocked since last call
+3 : PRBS OK!has been unlocked since last call
+4 : PRBS OK!has been unlocked since last call
+5 : PRBS OK!has been unlocked since last call
+6 : PRBS OK!has been unlocked since last call
+7 : PRBS OK!has been unlocked since last call
+8 : PRBS OK!has been unlocked since last call
+18 : PRBS OK!has been unlocked since last call
+19 : PRBS OK!has been unlocked since last call
+20 : PRBS OK!has been unlocked since last call
+21 : PRBS OK!has been unlocked since last call
+22 : PRBS OK!has been unlocked since last call
+23 : PRBS OK!has been unlocked since last call
+24 : PRBS OK!has been unlocked since last call
+40 : PRBS OK!has been unlocked since last call
+41 : PRBS OK!has been unlocked since last call
+42 : PRBS OK!has been unlocked since last call
+43 : PRBS OK!has been unlocked since last call
+54 : PRBS OK!has been unlocked since last call
+55 : PRBS OK!has been unlocked since last call
+56 : PRBS OK!has been unlocked since last call
+57 : PRBS OK!has been unlocked since last call
+58 : PRBS OK!has been unlocked since last call
+59 : PRBS OK!has been unlocked since last call
+60 : PRBS OK!has been unlocked since last call
+61 : PRBS OK!has been unlocked since last call
+72 : PRBS OK!has been unlocked since last call
+73 : PRBS OK!has been unlocked since last call
+74 : PRBS OK!has been unlocked since last call
+75 : PRBS OK!has been unlocked since last call
+76 : PRBS OK!has been unlocked since last call
+77 : PRBS OK!has been unlocked since last call
+78 : PRBS OK!has been unlocked since last call
+79 : PRBS OK!has been unlocked since last call
+90 : PRBS OK!has been unlocked since last call
+91 : PRBS OK!has been unlocked since last call
+92 : PRBS OK!has been unlocked since last call
+93 : PRBS OK!has been unlocked since last call
+94 : PRBS OK!has been unlocked since last call
+95 : PRBS OK!has been unlocked since last call
+96 : PRBS OK!has been unlocked since last call
+112 : PRBS OK!has been unlocked since last call
+113 : PRBS OK!has been unlocked since last call
+114 : PRBS OK!has been unlocked since last call
+115 : PRBS OK!has been unlocked since last call
+126 : PRBS OK!has been unlocked since last call
+127 : PRBS OK!has been unlocked since last call
+128 : PRBS OK!has been unlocked since last call
+129 : PRBS OK!has been unlocked since last call
+130 : PRBS OK!has been unlocked since last call
+131 : PRBS OK!has been unlocked since last call
+132 : PRBS OK!has been unlocked since last call
+133 : PRBS OK!has been unlocked since last call
+144 : PRBS OK!has been unlocked since last call
+145 : PRBS OK!has been unlocked since last call
+146 : PRBS OK!has been unlocked since last call
+147 : PRBS OK!has been unlocked since last call
+148 : PRBS OK!has been unlocked since last call
+149 : PRBS OK!has been unlocked since last call
+150 : PRBS OK!has been unlocked since last call
+151 : PRBS OK!has been unlocked since last call
+162 : PRBS OK!has been unlocked since last call
+163 : PRBS OK!has been unlocked since last call
+164 : PRBS OK!has been unlocked since last call
+165 : PRBS OK!has been unlocked since last call
+166 : PRBS OK!has been unlocked since last call
+167 : PRBS OK!has been unlocked since last call
+168 : PRBS OK!has been unlocked since last call
+184 : PRBS OK!has been unlocked since last call
+185 : PRBS OK!has been unlocked since last call
+186 : PRBS OK!has been unlocked since last call
+187 : PRBS OK!has been unlocked since last call
+198 : PRBS OK!has been unlocked since last call
+199 : PRBS OK!has been unlocked since last call
+200 : PRBS OK!has been unlocked since last call
+201 : PRBS OK!has been unlocked since last call
+202 : PRBS OK!has been unlocked since last call
+203 : PRBS OK!has been unlocked since last call
+204 : PRBS OK!has been unlocked since last call
+205 : PRBS OK!has been unlocked since last call
+216 : PRBS OK!has been unlocked since last call
+217 : PRBS OK!has been unlocked since last call
+218 : PRBS OK!has been unlocked since last call
+219 : PRBS OK!has been unlocked since last call
+220 : PRBS OK!has been unlocked since last call
+221 : PRBS OK!has been unlocked since last call
+222 : PRBS OK!has been unlocked since last call
+223 : PRBS OK!has been unlocked since last call
+234 : PRBS OK!has been unlocked since last call
+235 : PRBS OK!has been unlocked since last call
+236 : PRBS OK!has been unlocked since last call
+237 : PRBS OK!has been unlocked since last call
+238 : PRBS OK!has been unlocked since last call
+239 : PRBS OK!has been unlocked since last call
+240 : PRBS OK!has been unlocked since last call
+256 : PRBS OK!has been unlocked since last call
+257 : PRBS OK!has been unlocked since last call
+258 : PRBS OK!has been unlocked since last call
+259 : PRBS OK!has been unlocked since last call
+270 : PRBS OK!has been unlocked since last call
+271 : PRBS OK!has been unlocked since last call
+272 : PRBS OK!has been unlocked since last call
+273 : PRBS OK!has been unlocked since last call
+274 : PRBS OK!has been unlocked since last call
+275 : PRBS OK!has been unlocked since last call
+276 : PRBS OK!has been unlocked since last call
+277 : PRBS OK!has been unlocked since last call
+288 : PRBS OK!has been unlocked since last call
+289 : PRBS OK!has been unlocked since last call
+290 : PRBS OK!has been unlocked since last call
+291 : PRBS OK!has been unlocked since last call
+292 : PRBS OK!has been unlocked since last call
+293 : PRBS OK!has been unlocked since last call
+294 : PRBS OK!has been unlocked since last call
+295 : PRBS OK!has been unlocked since last call
+306 : PRBS OK!has been unlocked since last call
+307 : PRBS OK!has been unlocked since last call
+308 : PRBS OK!has been unlocked since last call
+310 : PRBS OK!has been unlocked since last call
+311 : PRBS OK!has been unlocked since last call
+312 : PRBS OK!has been unlocked since last call
+313 : PRBS OK!has been unlocked since last call
+324 : PRBS OK!has been unlocked since last call
+325 : PRBS OK!has been unlocked since last call
+326 : PRBS OK!has been unlocked since last call
+327 : PRBS OK!has been unlocked since last call
+342 : PRBS OK!has been unlocked since last call
+343 : PRBS OK!has been unlocked since last call
+344 : PRBS OK!has been unlocked since last call
+345 : PRBS OK!has been unlocked since last call
+346 : PRBS OK!has been unlocked since last call
+347 : PRBS OK!has been unlocked since last call
+348 : PRBS OK!has been unlocked since last call
+349 : PRBS OK!has been unlocked since last call
+360 : PRBS OK!has been unlocked since last call
+361 : PRBS OK!has been unlocked since last call
+362 : PRBS OK!has been unlocked since last call
+363 : PRBS OK!has been unlocked since last call
+364 : PRBS OK!has been unlocked since last call
+365 : PRBS OK!has been unlocked since last call
+366 : PRBS OK!has been unlocked since last call
+367 : PRBS OK!has been unlocked since last call
+378 : PRBS OK!has been unlocked since last call
+379 : PRBS OK!has been unlocked since last call
+380 : PRBS OK!has been unlocked since last call
+382 : PRBS OK!has been unlocked since last call
+383 : PRBS OK!has been unlocked since last call
+384 : PRBS OK!has been unlocked since last call
+385 : PRBS OK!has been unlocked since last call
+396 : PRBS OK!has been unlocked since last call
+397 : PRBS OK!has been unlocked since last call
+398 : PRBS OK!has been unlocked since last call
+399 : PRBS OK!has been unlocked since last call
+414 : PRBS OK!has been unlocked since last call
+415 : PRBS OK!has been unlocked since last call
+416 : PRBS OK!has been unlocked since last call
+417 : PRBS OK!has been unlocked since last call
+418 : PRBS OK!has been unlocked since last call
+419 : PRBS OK!has been unlocked since last call
+420 : PRBS OK!has been unlocked since last call
+421 : PRBS OK!has been unlocked since last call
+432 : PRBS OK!has been unlocked since last call
+433 : PRBS OK!has been unlocked since last call
+434 : PRBS OK!has been unlocked since last call
+435 : PRBS OK!has been unlocked since last call
+436 : PRBS OK!has been unlocked since last call
+437 : PRBS OK!has been unlocked since last call
+438 : PRBS OK!has been unlocked since last call
+439 : PRBS OK!has been unlocked since last call
+450 : PRBS OK!has been unlocked since last call
+451 : PRBS OK!has been unlocked since last call
+452 : PRBS OK!has been unlocked since last call
+454 : PRBS OK!has been unlocked since last call
+455 : PRBS OK!has been unlocked since last call
+456 : PRBS OK!has been unlocked since last call
+457 : PRBS OK!has been unlocked since last call
+468 : PRBS OK!has been unlocked since last call
+469 : PRBS OK!has been unlocked since last call
+470 : PRBS OK!has been unlocked since last call
+471 : PRBS OK!has been unlocked since last call
+486 : PRBS OK!has been unlocked since last call
+487 : PRBS OK!has been unlocked since last call
+488 : PRBS OK!has been unlocked since last call
+489 : PRBS OK!has been unlocked since last call
+490 : PRBS OK!has been unlocked since last call
+491 : PRBS OK!has been unlocked since last call
+492 : PRBS OK!has been unlocked since last call
+493 : PRBS OK!has been unlocked since last call
+504 : PRBS OK!has been unlocked since last call
+505 : PRBS OK!has been unlocked since last call
+506 : PRBS OK!has been unlocked since last call
+507 : PRBS OK!has been unlocked since last call
+508 : PRBS OK!has been unlocked since last call
+509 : PRBS OK!has been unlocked since last call
+510 : PRBS OK!has been unlocked since last call
+511 : PRBS OK!has been unlocked since last call
+522 : PRBS OK!has been unlocked since last call
+523 : PRBS OK!has been unlocked since last call
+524 : PRBS OK!has been unlocked since last call
+526 : PRBS OK!has been unlocked since last call
+527 : PRBS OK!has been unlocked since last call
+528 : PRBS OK!has been unlocked since last call
+529 : PRBS OK!has been unlocked since last call
+540 : PRBS OK!has been unlocked since last call
+541 : PRBS OK!has been unlocked since last call
+542 : PRBS OK!has been unlocked since last call
+543 : PRBS OK!has been unlocked since last call
+558 : PRBS OK!has been unlocked since last call
+559 : PRBS OK!has been unlocked since last call
+560 : PRBS OK!has been unlocked since last call
+561 : PRBS OK!has been unlocked since last call
+562 : PRBS OK!has been unlocked since last call
+563 : PRBS OK!has been unlocked since last call
+564 : PRBS OK!has been unlocked since last call
+565 : PRBS OK!has been unlocked since last call
+drivshell>
+root@sonic:~#
+root@sonic:~#
+root@sonic:~#
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbssat STArt Interval=30' "
+ dsh -c 'phydiag 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 prbsstat STArt Interval=30'
+PRBSStat thread started ...
+drivshell>
+root@sonic:~# sleep 30
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbsstat Ber' "
+ dsh -c 'phydiag 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 prbsstat Ber'
+port     BER
+====
+1[0] : 3.53e-11
+1[1] : 4.00e-11
+====
+2[0] : 1.64e-10
+2[1] : 8.80e-11
+====
+3[0] : 6.01e-11
+3[1] : 3.45e-12
+====
+4[0] : 7.69e-11
+4[1] : 2.60e-11
+====
+5[0] : 9.41e-13
+5[1] : 6.27e-13
+====
+6[0] : 3.14e-13
+6[1] : 6.27e-13
+====
+7[0] : 2.98e-12
+7[1] : 2.20e-12
+====
+8[0] : 4.24e-12
+8[1] : 9.41e-13
+====
+18[0] : 7.84e-13
+18[1] : 2.04e-12
+====
+19[0] : 1.57e-13
+19[1] : 1.73e-12
+====
+20[0] : 1.19e-11
+20[1] : 1.41e-12
+====
+21[0] : 5.65e-12
+21[1] : 7.69e-12
+====
+22[0] : 1.54e-11
+22[1] : 7.84e-13
+====
+23[0] : 1.10e-12
+23[1] : 2.35e-12
+====
+24[0] : 2.51e-12
+24[1] : 1.41e-12
+====
+40[0] : 2.23e-11
+40[1] : 2.35e-11
+====
+41[0] : 3.76e-12
+41[1] : 4.55e-12
+====
+42[0] : 7.84e-12
+42[1] : 3.76e-12
+====
+43[0] : 5.02e-12
+43[1] : 1.35e-11
+====
+54[0] : 7.84e-13
+54[1] : 6.27e-13
+====
+55[0] : 1.57e-13
+55[1] : 1.57e-13
+====
+56[0] : 3.14e-13
+56[1] : 4.71e-13
+====
+57[0] : 4.71e-12
+57[1] : 6.27e-13
+====
+58[0] : 5.80e-12
+58[1] : 4.24e-11
+====
+59[0] : 6.90e-12
+59[1] : 7.84e-13
+====
+60[0] : 1.13e-11
+60[1] : 1.10e-12
+====
+61[0] : 2.35e-12
+61[1] : 5.49e-12
+====
+72[0] : 4.39e-11
+72[1] : 5.49e-12
+====
+73[0] : 7.22e-12
+73[1] : 8.00e-12
+====
+74[0] : 3.29e-12
+74[1] : 1.25e-12
+====
+75[0] : 5.96e-12
+75[1] : 3.45e-12
+====
+76[0] : 1.57e-13
+76[1] : 1.41e-12
+====
+77[0] : 2.20e-12
+77[1] : 1.57e-13
+====
+78[0] : 2.67e-12
+78[1] : 1.41e-12
+====
+79[0] : 6.27e-13
+79[1] : 3.14e-13
+====
+90[0] : 3.61e-12
+90[1] : 1.91e-11
+====
+91[0] : 1.88e-12
+91[1] : 4.24e-12
+====
+92[0] : 8.47e-12
+92[1] : 4.08e-12
+====
+93[0] : 3.92e-12
+93[1] : 1.82e-11
+====
+94[0] : 1.57e-13
+94[1] : 1.41e-12
+====
+95[0] : 1.57e-13
+95[1] : 1.57e-13
+====
+96[0] : 1.57e-13
+96[1] : 4.71e-13
+====
+112[0] : 4.08e-12
+112[1] : 2.04e-12
+====
+113[0] : 4.08e-12
+113[1] : 3.29e-12
+====
+114[0] : 7.84e-13
+114[1] : 9.41e-13
+====
+115[0] : 6.27e-13
+115[1] : 1.88e-12
+====
+126[0] : 2.82e-12
+126[1] : 1.57e-13
+====
+127[0] : 1.57e-13
+127[1] : 4.71e-13
+====
+128[0] : 3.45e-12
+128[1] : 3.14e-13
+====
+129[0] : 4.71e-13
+129[1] : 6.27e-13
+====
+130[0] : 2.67e-12
+130[1] : 1.57e-12
+====
+131[0] : 2.35e-12
+131[1] : 6.12e-12
+====
+132[0] : 3.33e-11
+132[1] : 5.02e-12
+====
+133[0] : 9.88e-12
+133[1] : 6.90e-12
+====
+144[0] : 7.84e-13
+144[1] : 7.22e-12
+====
+145[0] : 3.29e-12
+145[1] : 6.12e-12
+====
+146[0] : 1.02e-11
+146[1] : 1.57e-12
+====
+147[0] : 1.57e-12
+147[1] : 3.92e-12
+====
+148[0] : 1.57e-13
+148[1] : 1.25e-12
+====
+149[0] : 1.57e-13
+149[1] : 1.57e-13
+====
+150[0] : 6.27e-13
+150[1] : 1.57e-13
+====
+151[0] : 6.27e-13
+151[1] : 3.14e-13
+====
+162[0] : 1.57e-13
+162[1] : 6.27e-13
+====
+163[0] : 3.14e-13
+163[1] : 1.57e-12
+====
+164[0] : 1.25e-12
+164[1] : 2.20e-12
+====
+165[0] : 4.71e-13
+165[1] : 2.67e-12
+====
+166[0] : 1.57e-13
+166[1] : 3.14e-13
+====
+167[0] : 1.57e-13
+167[1] : 1.57e-12
+====
+168[0] : 4.71e-13
+168[1] : 1.57e-13
+====
+184[0] : 4.11e-10
+184[1] : 3.12e-10
+====
+185[0] : 1.71e-08
+185[1] : 3.13e-09
+====
+186[0] : 2.05e-10
+186[1] : 2.27e-09
+====
+187[0] : 3.94e-11
+187[1] : 2.97e-09
+====
+198[0] : 3.44e-11
+198[1] : 3.29e-11
+====
+199[0] : 7.53e-10
+199[1] : 1.66e-10
+====
+200[0] : 4.38e-11
+200[1] : 3.81e-11
+====
+201[0] : 5.43e-11
+201[1] : 1.95e-11
+====
+202[0] : 1.82e-10
+202[1] : 5.74e-09
+====
+203[0] : 1.98e-08
+203[1] : 5.05e-09
+====
+204[0] : 2.09e-10
+204[1] : 5.71e-11
+====
+205[0] : 6.59e-11
+205[1] : 5.21e-11
+====
+216[0] : 4.71e-13
+216[1] : 6.27e-13
+====
+217[0] : 1.57e-12
+217[1] : 6.27e-13
+====
+218[0] : 3.14e-13
+218[1] : 1.57e-13
+====
+219[0] : 1.41e-12
+219[1] : 1.41e-12
+====
+220[0] : 1.57e-13
+220[1] : 1.57e-13
+====
+221[0] : 1.57e-13
+221[1] : 1.57e-13
+====
+222[0] : 1.57e-13
+222[1] : 3.14e-13
+====
+223[0] : 9.41e-13
+223[1] : 1.57e-13
+====
+234[0] : 1.57e-13
+234[1] : 4.71e-13
+====
+235[0] : 3.14e-13
+235[1] : 1.25e-12
+====
+236[0] : 4.71e-13
+236[1] : 1.57e-13
+====
+237[0] : 3.14e-13
+237[1] : 1.57e-13
+====
+238[0] : 1.57e-13
+238[1] : 1.57e-13
+====
+239[0] : 3.14e-13
+239[1] : 3.14e-13
+====
+240[0] : 2.35e-12
+240[1] : 1.57e-13
+====
+256[0] : 4.24e-12
+256[1] : 7.37e-12
+====
+257[0] : 4.71e-13
+257[1] : 7.69e-12
+====
+258[0] : 1.09e-09
+258[1] : 6.25e-09
+====
+259[0] : 1.66e-11
+259[1] : 1.02e-10
+====
+270[0] : 1.10e-12
+270[1] : 9.25e-12
+====
+271[0] : 5.33e-12
+271[1] : 1.62e-11
+====
+272[0] : 1.37e-10
+272[1] : 9.15e-10
+====
+273[0] : 9.41e-12
+273[1] : 1.90e-11
+====
+274[0] : 1.57e-13
+274[1] : 2.04e-12
+====
+275[0] : 1.73e-12
+275[1] : 2.20e-12
+====
+276[0] : 1.30e-10
+276[1] : 1.36e-10
+====
+277[0] : 1.41e-12
+277[1] : 2.04e-12
+====
+288[0] : 4.71e-13
+288[1] : 4.71e-13
+====
+289[0] : 3.14e-13
+289[1] : 2.20e-12
+====
+290[0] : 3.14e-13
+290[1] : 1.57e-13
+====
+291[0] : 3.29e-11
+291[1] : 1.08e-11
+====
+292[0] : 3.14e-13
+292[1] : 6.27e-13
+====
+293[0] : 1.57e-13
+293[1] : 5.80e-12
+====
+294[0] : 5.96e-12
+294[1] : 1.88e-12
+====
+295[0] : 1.27e-11
+295[1] : 1.21e-11
+====
+306[0] : 4.71e-13
+306[1] : 1.10e-12
+====
+307[0] : 7.84e-13
+307[1] : 5.02e-12
+====
+308[0] : 3.92e-12
+308[1] : 2.67e-12
+====
+310[0] : 3.92e-12
+310[1] : 1.25e-12
+====
+311[0] : 2.51e-12
+311[1] : 6.27e-13
+====
+312[0] : 2.20e-12
+312[1] : 6.75e-12
+====
+313[0] : 5.43e-11
+313[1] : 2.18e-10
+====
+324[0] : 1.46e-11
+324[1] : 1.27e-11
+====
+325[0] : 2.67e-12
+325[1] : 7.94e-11
+====
+326[0] : 5.35e-11
+326[1] : 2.35e-12
+====
+327[0] : 7.15e-11
+327[1] : 1.11e-11
+====
+342[0] : 2.04e-12
+342[1] : 1.41e-12
+====
+343[0] : 3.14e-13
+343[1] : 3.61e-12
+====
+344[0] : 1.41e-12
+344[1] : 1.57e-13
+====
+345[0] : 1.25e-12
+345[1] : 1.41e-12
+====
+346[0] : 3.14e-13
+346[1] : 1.57e-13
+====
+347[0] : 1.57e-13
+347[1] : 3.14e-13
+====
+348[0] : 1.57e-13
+348[1] : 3.14e-13
+====
+349[0] : 1.73e-12
+349[1] : 2.21e-11
+====
+360[0] : 8.78e-12
+360[1] : 1.24e-11
+====
+361[0] : 7.22e-12
+361[1] : 1.87e-11
+====
+362[0] : 1.30e-11
+362[1] : 1.74e-11
+====
+363[0] : 1.51e-10
+363[1] : 2.85e-11
+====
+364[0] : 1.38e-11
+364[1] : 1.17e-10
+====
+365[0] : 3.95e-11
+365[1] : 2.67e-12
+====
+366[0] : 4.24e-12
+366[1] : 5.49e-12
+====
+367[0] : 1.71e-10
+367[1] : 1.40e-11
+====
+378[0] : 1.41e-11
+378[1] : 3.50e-11
+====
+379[0] : 7.67e-11
+379[1] : 1.03e-09
+====
+380[0] : 2.16e-11
+380[1] : 1.62e-11
+====
+382[0] : 4.35e-11
+382[1] : 1.81e-10
+====
+383[0] : 2.28e-10
+383[1] : 1.41e-10
+====
+384[0] : 7.22e-12
+384[1] : 5.71e-11
+====
+385[0] : 3.36e-11
+385[1] : 2.16e-11
+====
+396[0] : 2.82e-12
+396[1] : 4.55e-12
+====
+397[0] : 1.27e-11
+397[1] : 1.41e-11
+====
+398[0] : 2.99e-10
+398[1] : 5.80e-11
+====
+399[0] : 2.51e-11
+399[1] : 1.11e-11
+====
+414[0] : 4.55e-12
+414[1] : 8.31e-12
+====
+415[0] : 1.57e-13
+415[1] : 9.41e-13
+====
+416[0] : 6.27e-12
+416[1] : 5.96e-12
+====
+417[0] : 2.20e-12
+417[1] : 1.88e-12
+====
+418[0] : 6.27e-13
+418[1] : 1.25e-12
+====
+419[0] : 1.57e-13
+419[1] : 1.41e-12
+====
+420[0] : 3.14e-13
+420[1] : 2.82e-12
+====
+421[0] : 4.39e-12
+421[1] : 1.16e-11
+====
+432[0] : 4.71e-13
+432[1] : 6.27e-13
+====
+433[0] : 4.71e-13
+433[1] : 1.57e-12
+====
+434[0] : 4.71e-13
+434[1] : 1.57e-13
+====
+435[0] : 1.25e-12
+435[1] : 1.57e-13
+====
+436[0] : 1.57e-13
+436[1] : 1.57e-13
+====
+437[0] : 1.57e-13
+437[1] : 4.71e-13
+====
+438[0] : 7.84e-13
+438[1] : 1.41e-12
+====
+439[0] : 1.41e-12
+439[1] : 1.10e-12
+====
+450[0] : 6.27e-13
+450[1] : 4.71e-13
+====
+451[0] : 1.57e-13
+451[1] : 1.25e-12
+====
+452[0] : 1.10e-12
+452[1] : 7.84e-13
+====
+454[0] : 1.10e-12
+454[1] : 1.88e-12
+====
+455[0] : 6.27e-13
+455[1] : 1.57e-12
+====
+456[0] : 1.88e-12
+456[1] : 9.41e-13
+====
+457[0] : 7.84e-13
+457[1] : 4.71e-13
+====
+468[0] : 6.27e-13
+468[1] : 9.41e-13
+====
+469[0] : 2.67e-12
+469[1] : 4.08e-12
+====
+470[0] : 3.14e-13
+470[1] : 4.71e-13
+====
+471[0] : 3.14e-13
+471[1] : 7.84e-13
+====
+486[0] : 1.73e-12
+486[1] : 1.57e-12
+====
+487[0] : 1.10e-12
+487[1] : 2.82e-12
+====
+488[0] : 4.71e-13
+488[1] : 4.71e-13
+====
+489[0] : 9.41e-13
+489[1] : 3.14e-13
+====
+490[0] : 1.57e-13
+490[1] : 3.14e-13
+====
+491[0] : 3.14e-13
+491[1] : 1.57e-13
+====
+492[0] : 9.41e-13
+492[1] : 1.10e-12
+====
+493[0] : 7.84e-13
+493[1] : 2.98e-12
+====
+504[0] : 4.71e-13
+504[1] : 3.14e-13
+====
+505[0] : 1.57e-13
+505[1] : 7.84e-13
+====
+506[0] : 4.71e-13
+506[1] : 1.57e-13
+====
+507[0] : 3.14e-13
+507[1] : 1.57e-13
+====
+508[0] : 2.04e-12
+508[1] : 1.41e-12
+====
+509[0] : 9.41e-13
+509[1] : 7.84e-13
+====
+510[0] : 1.57e-13
+510[1] : 6.27e-13
+====
+511[0] : 6.27e-13
+511[1] : 4.71e-13
+====
+522[0] : 2.35e-12
+522[1] : 1.57e-13
+====
+523[0] : 3.14e-13
+523[1] : 6.27e-13
+====
+524[0] : 7.84e-13
+524[1] : 1.57e-13
+====
+526[0] : 7.84e-13
+526[1] : 3.14e-13
+====
+527[0] : 1.41e-12
+527[1] : 4.71e-13
+====
+528[0] : 3.14e-13
+528[1] : 9.41e-13
+====
+529[0] : 4.71e-13
+529[1] : 1.57e-13
+====
+540[0] : 6.27e-13
+540[1] : 1.25e-12
+====
+541[0] : 3.14e-13
+541[1] : 1.10e-12
+====
+542[0] : 2.98e-12
+542[1] : 6.27e-13
+====
+543[0] : 2.98e-12
+543[1] : 3.14e-13
+====
+558[0] : 9.41e-13
+558[1] : 1.10e-12
+====
+559[0] : 3.29e-12
+559[1] : 2.04e-12
+====
+560[0] : 1.57e-13
+560[1] : 1.57e-13
+====
+561[0] : 2.35e-12
+561[1] : 4.71e-13
+====
+562[0] : 1.57e-13
+562[1] : 1.57e-13
+====
+563[0] : 1.57e-13
+563[1] : 4.71e-13
+====
+564[0] : 1.41e-12
+564[1] : 7.84e-13
+====
+565[0] : 4.55e-12
+565[1] : 1.57e-13
+====
+drivshell>
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbssat STOp' "
+ dsh -c 'phydiag 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 prbsstat STOp'
+Stopping PRBSStat thread
+drivshell>
+root@sonic:~# bcmcmd -n 0 -c " dsh -c 'phydiag 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 prbs clear' "
+ dsh -c 'phydiag 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 prbs clear'
+drivshell>
+root@sonic:~#

tools/TR518.txt

@@ -0,0 +1,17 @@
+//Start Unit0 Tr518
+bcmcmd -n 0 -c 'port cd lb=mac'
+bcmcmd -n 0 -c 'l2 learn off'
+bcmcmd -n 0 -c 'dsh -c "test mode nr=yes"'
+bcmcmd -n 0 -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"'
+
+//Stop Unit0 Tr518
+bcmcmd -n 0 -c 'port cd lb=none'
+
+//Start Unit1 Tr518
+bcmcmd -n 1 -c 'port cd lb=mac'
+bcmcmd -n 1 -c 'l2 learn off'
+bcmcmd -n 1 -c 'dsh -c "test mode nr=yes"'
+bcmcmd -n 1 -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"'
+
+//Stop Unit1 Tr518
+bcmcmd -n 1 -c 'port cd lb=none'

tools/fan_ctrl.txt

@@ -0,0 +1,7 @@
+echo 18-0020 > /sys/bus/i2c/drivers/max31790/unbind
+sleep .5
+echo 18-0020 > /sys/bus/i2c/drivers/max31790/bind
+echo 25-0020 > /sys/bus/i2c/drivers/max31790/unbind
+sleep .5
+echo 25-0020 > /sys/bus/i2c/drivers/max31790/bind
+fan-speed-control.sh 30

tools/gen_channel_map.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# =============================================================================
+# gen_channel_map.sh - Build docs/LTC2980_channel_map.csv from settings/*.conf
+# Version : V1.0.0
+# Date    : 2026-08-27
+# Author  : ETWen
+# =============================================================================
+# Runs on the DEV machine, not the DUT. Reads every LTC2980 margin settings
+# file and flattens CH<n>_VNOM / CH<n>_NET into one CSV:
+#
+#     Board,CONN,Ch,NetName,Vnom
+#     CB,CONN13,CH0,V5P0_ALW,5.0
+#
+# NC channels keep their literal NC / "-" so the page numbering still lines up
+# (ch/8 -> CHIPS[] index, ch%8 -> LTC2977 PAGE). Do not filter them out.
+#
+# Usage:
+#   tools/gen_channel_map.sh                 # write docs/LTC2980_channel_map.csv
+#   tools/gen_channel_map.sh -              # write to stdout
+# =============================================================================
+set -eu
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+SET_DIR="${REPO_ROOT}/src/Script_ABC_Blanton/Blanton_Script/LTC2980_Margin_Script/settings"
+OUT="${1:-${REPO_ROOT}/docs/LTC2980_channel_map.csv}"
+
+[ -d "${SET_DIR}" ] || { echo "settings dir not found: ${SET_DIR}" >&2; exit 1; }
+
+# 3-argument match(str, regex, array) is a gawk extension. Under mawk it is a
+# syntax error at best and an empty CSV at worst - fail loudly instead.
+awk 'BEGIN { if (match("a", /a/, m) != 1) exit 1 }' 2>/dev/null \
+    || { echo "need gawk (3-arg match); this awk is: $(awk --version 2>&1 | head -1)" >&2; exit 1; }
+
+gen() {
+    printf 'Board,CONN,Ch,NetName,Vnom\n'
+    # CB first, then SWB0/SWB1 CONN13..CONN16 - matches the physical walk order.
+    for f in "${SET_DIR}"/Blanton_CB_CONN*.conf \
+             "${SET_DIR}"/Blanton_SWB0_CONN*.conf \
+             "${SET_DIR}"/Blanton_SWB1_CONN*.conf ; do
+        [ -f "${f}" ] || continue
+        base="$(basename "${f}" .conf)"          # Blanton_SWB0_CONN13
+        board="$(echo "${base}" | cut -d_ -f2)"  # SWB0
+        conn="$(echo  "${base}" | cut -d_ -f3)"  # CONN13
+
+        # .conf files are LF per .gitattributes, but strip CR anyway - a stray
+        # CR would land inside the net name and travel into the CSV unseen.
+        sed 's/\r$//' "${f}" | awk -v b="${board}" -v c="${conn}" '
+            match($0, /^CH([0-9]+)_VNOM="([^"]*)"[^"]*CH[0-9]+_NET="([^"]*)"/, m) {
+                printf "%s,%s,CH%s,%s,%s\n", b, c, m[1], m[3], m[2]
+            }'
+    done
+}
+
+if [ "${OUT}" = "-" ]; then
+    gen
+else
+    gen > "${OUT}"
+    echo "wrote ${OUT}  ($(($(wc -l < "${OUT}") - 1)) channels)"
+fi