feat(publish): Add publish.sh and sync docs for V1.0.3

publish/publish.sh packages src/Script_ABC_Blanton into
publish/Script_ABC_Blanton_<Ver>/, with -z for a zip, -f to overwrite,
-n for a dry run.

The version is read from Script A's "; Version :" header rather than
passed in, so the folder name cannot disagree with what the tester sees
on opening the macro. The header is CRLF, so the carriage return is
stripped -- left in, it becomes part of the directory name. Captured
logs are excluded (they carry DUT serials) but the empty logs/ is kept
because logopen writes there. .gitignore now admits the tool while
still ignoring its output.

config.ttl: testcase ENV, margin scan off for this run.

Docs brought up to date with the 14 commits since 8aa5c90 -- SWB
channel/address map, the traffic and BMC tooling, line-ending policy,
and the exec-bit and tail -f traps.

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

.gitignore

@@ -12,9 +12,10 @@ For_AI/
 !**/logs/.gitkeep
 !**/Logs/.gitkeep
 
-# 打包輸出
+# 打包輸出：產出不進 git，打包工具本身要進
 publish/*
 !publish/.gitkeep
+!publish/publish.sh
 
 # Office 暫存檔
 ~$*

ARCHITECTURE.md

@@ -37,6 +37,7 @@ LTC2980 margin 控制器。TTL 只負責「按順序 `sendln` 並把畫面收進
 | 電源 margin | LTC2980（= 2 × LTC2977）over PMBus，LINEAR16 編碼 |
 | 錯誤計數來源 | Linux PCIe AER sysfs（`aer_dev_*`）、EDAC sysfs（`dimm_ce/ue_count`） |
 | 平台監控 | SONiC `show platform *`（pmon container，含 `leak status` / `leak channels`） |
+| BMC 存取 | host 端 `bmc-manager run "<cmd>"`（不需對 BMC 開 SSH，繞開其 busybox 工具鏈） |
 | 壓力測試 | `mlucas-avx2`（AMD CPU）、`~/hammer/tools/stress_{mem,ssd,usb}.py` |
 | 資料面流量 | `bcmcmd`（Broadcom drivshell）VLAN loopback + `tx` burst，switch unit 0 / 1 |
 | 流量報表 | DUT 上 awk（`blanton_traffic_linespeed report`）；離線 `python3 tools/bcm_mibpair_report_V1.1.0.py` |
@@ -106,7 +107,8 @@ Blanton_TTL_Script/
 │
 ├── CLAUDE.md                          # 專案記憶 & 給 Claude 的指令
 ├── ARCHITECTURE.md                    # 本架構文件
-├── .gitignore                         # secret/ + For_AI/ + logs 規則
+├── .gitignore                         # secret/ + For_AI/ + logs + publish 產出
+├── .gitattributes                     # 換行符政策：.sh/.conf 釘 LF、.ttl 保持 CRLF
 │
 ├── docs/                              # 規格與狀態文件（客戶提供 / 專案產出）
 │   ├── Blantons_FPGA_Registers.md         # FPGA 暫存器規格（markdown 正本，查 offset 用）
@@ -131,7 +133,9 @@ Blanton_TTL_Script/
 │
 ├── For_AI/                            # 🚫 gitignored — AI 協作素材（波形截圖、草稿）
 │
-├── publish/                           # 可交付的打包輸出（Blanton_Script_ABC_v<ver>_<date>/ + zip）
+├── publish/
+│   ├── publish.sh                     # ✅ committed — 打包工具（版號讀 Script A 檔頭）
+│   └── Script_ABC_Blanton_<Ver>/      # 🚫 產出，gitignored（-z 另出同名 .zip）
 │
 └── src/
     └── Script_ABC_Blanton/            # ← Tera Term 的工作目錄（整包給測試員）
@@ -148,6 +152,7 @@ Blanton_TTL_Script/
         │   ├── show_dmesg.ttl             # date + dmesg grep error/fail/warning
         │   ├── show_margin_status.ttl     # source margin_status_all.sh（掃 9 顆 LTC2980）
         │   ├── kill_all_process.ttl       # kill $(jobs -p)
+        │   ├── wait_init.ttl              # 輪詢 show platform temperature 直到 pmon 起來
         │   ├── show_pcie_error_reg.ttl        # 舊的合併版（已被下列 per-device 版取代）
         │   ├── show_pcie_error_reg_TH6_SWB0.ttl   # EP 01:00.0 + RP 00:01.1
         │   ├── show_pcie_error_reg_TH6_SWB1.ttl   # EP 02:00.0 + RP 00:01.2
@@ -167,12 +172,18 @@ Blanton_TTL_Script/
             ├── blanton_pwr_data.sh        # SWB VRM + PDB brick 的 Vin/Vout/Iout/Temp 表
             ├── blanton_traffic_linespeed.sh  # SWB loopback 線速流量（bcmcmd unit 0/1）
             │                                 #   init/clear/show/start/stop/ps/report/run
+            ├── bmc_monitor.sh             # BMC 監控：週期跑 free -m，寫輪替 log
+            ├── bmc_monitor_ddr.sh         # BMC DDR 壓力：memtester，逾時 3600s
+            │                              #   ↑ 兩支都要 chmod +x 才能跑（見 Key Constraints）
             └── LTC2980_Margin_Script/     # 電壓 margin 子專案（另有獨立 repo）
                 ├── margin.sh              # margin_init/status/set/apply_profile/save
                 ├── settings/*.conf        # 一個 .conf = 一顆 LTC2980（CB + SWB0/1 × CONN13~16）
                 ├── profiles/*.conf        # 16-ch 批次組合（comboA/B、high3/5、low3/5、normal、off）
                 ├── script/*_all.sh        # 跨 9 顆 LTC2980 的批次 status / apply / save
+                ├── Ref/margin_command_trace.md  # 指令追蹤參考（SWB 章節已標過期，見文件內警告）
                 └── logs/                  # margin 操作 log
+                #  註：v2.6.0 起不再內含 blanton_cb_i2c.sh / blanton_fpga_pcimem.sh 的複本，
+                #      改由 _swb_find_backend 往上層 Blanton_Script/ 找共用版
 ```
 
 ---
@@ -208,6 +219,18 @@ Log 檔名規則：`<mdir>\Logs\<project_name>_<strTestcase>_<YYYYmmdd-HHMMSS>.l
 
 Channel 定址：`ch / 8` → `CHIPS[]` index，`ch % 8` → LTC2977 PMBus PAGE（0x00~0x07）。
 
+**SWB 通道與位址對應（2026-08-19 上機驗證，`ababb2c`）：**
+
+| FPGA I2C 通道 | 板 / 接頭 | LTC2977 位址（lo / hi） |
+|---|---|---|
+| Ch6 | SWB0 CONN14 / CONN16 | CONN14 `0x5C`,`0x5E` ; CONN16 `0x62`,`0x64` |
+| Ch8 | SWB0 CONN13 / CONN15 | CONN13 `0x5C`,`0x5E` ; CONN15 `0x62`,`0x64` |
+| Ch7 | SWB1 CONN14 / CONN16 | CONN14 `0x5C`,`0x5E` ; CONN16 `0x62`,`0x64` |
+| Ch9 | SWB1 CONN13 / CONN15 | CONN13 `0x5C`,`0x5E` ; CONN15 `0x62`,`0x64` |
+
+> 同一顆 LTC2980 的兩個位址**相差 2**（7-bit，由規格書 8-bit 配對除以 2 而來），不是 1。
+> 兩張板共用一條通道，所以同通道上的位址必須互斥 —— 上表兩組（`0x5C/0x5E` 與 `0x62/0x64`）不重疊。
+
 ### 3. `profiles/*.conf` — 16-ch 批次 margin 組合
 
 ```bash
@@ -267,16 +290,18 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... )   # "channel:operation:change_perc
 
 | 模組 | 進入點 | 功能 |
 |------|--------|------|
-| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` | root 登入 → `mkdir ./logs` → `date -s` 對時 → source **六個** bash 工具 → 清/讀 7 組 PCIe AER → `lspci -tvvv/-vv` → margin 全掃 → PMON 九項 → dmesg 三 grep → `messagebox` 提示接 Script B |
+| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.0.3 | root 登入 → `date -s` 對時 → `show boot` → **等 pmon 起來**（`wait_init.ttl`）→ BMC 版本 → source 六個 bash 工具 → 清/讀 7 組 PCIe AER → `lspci` → margin 全掃 → PMON 九項 → dmesg → 100G port 狀態 → **一輪流量基線** → `show uptime` |
-| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + 5 份 `stress_mem.py` + `stress_ssd.py` + `stress_usb.py` 背景執行（**共 8 個 job**）→ `jobs` 確認 → traffic `ps/init/clear/show/start -u 0` → `while 1` 每輪完整 PMON + margin |
+| **Script B（Stress）** | `2_Blanton_Script_B.ttl` | `mlucas-avx2 -cpu 0:15` + 5 份 `stress_mem.py` + `stress_ssd.py` + `stress_usb.py`（**共 8 個 job**）→ 啟動兩支 BMC monitor → `jobs` → 100G port 狀態 → traffic `ps/init/clear/show/start`（**兩個 unit**）→ `while 1` 每輪完整 PMON + margin |
-| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` → PMON + dmesg 再抓一次 → 7 組 AER 再抓一次 → `cat` mlucas / stress_ssd log → traffic `stop` + `report -u 0` → 完成 messagebox |
+| **Script C（Post-test）** | `3_Blanton_Script_C.ttl` | `kill $(jobs -p)` → PMON + dmesg → 7 組 AER → 停兩支 BMC monitor 並 `cat` 其 log → `cat` mlucas / stress_ssd log → traffic `stop` + `report`（兩個 unit）→ `show reboot-cause` / `show uptime` → 完成 messagebox |
 | **SWB loopback 流量** | `blanton_traffic_linespeed <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`（一條龍） |
 | **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 與狀態掃描 |
+| **電壓 Margin** | `margin_init/status/set/apply_profile/save` + `*_all.sh` | 9 顆 LTC2980（CB CONN13、SWB0/1 CONN13~16）批次 high/low margin 與狀態掃描。v2.6.0 起 SWB 路徑真正接上共用 cb_i2c 後端，並有 `margin_swb_info/probe/scan/reset/sem` 除錯包裝 |
+| **BMC 監控 / 壓力** | `bmc_monitor.sh` / `bmc_monitor_ddr.sh` `{start\|stop\|status\|fg\|tail\|clear}` | 由 host 端 `bmc-manager run` 週期性打 BMC，背景 detached、log 輪替。前者跑 `free -m`（逾時 30s），後者跑 `memtester`（逾時 3600s），各自獨立 log 與 pid |
+| **打包交付** | `publish/publish.sh [-v Ver] [-f] [-z] [-n]` | 版號讀 Script A 檔頭，複製成 `publish/Script_ABC_Blanton_<Ver>/`，排除 `*.log`，可另出 zip |
 
 ---
 
@@ -298,7 +323,12 @@ Script A ── logopen Logs/Blanton_Margin_<ts>.log ──┐  (之後所有畫
     ├─ lspci -tvvv / -vv       ← 拓樸 + link speed/width
     ├─ margin_status_all       ← 9 顆 LTC2980 × 16ch 的 Vout 與偏差%
     ├─ show platform × 9       ← fan/temp/psu/voltage/current/ssdhealth/leak status/leak channels
-    └─ dmesg | grep error/fail/warning
+    ├─ dmesg | grep error/fail/warning
+    ├─ show interfaces status Ethernet513,Ethernet514   ← 100G uplink 狀態
+    ├─ 一輪流量基線：ps → init → clear → show → start → stop → report
+    └─ show uptime
+  （最前面還有 wait_init.ttl：輪詢 show platform temperature 直到不再回報
+    "Thermal Not detected"，避免 pmon 還沒起來就抓基線）
     ▼
 [messagebox "Start Script B"] ← 人工確認後手動跑 B
     │
@@ -306,8 +336,9 @@ Script A ── logopen Logs/Blanton_Margin_<ts>.log ──┐  (之後所有畫
 Script B ── 同一個 log 檔續寫（logwrite 分隔線）
     ├─ 背景程序：mlucas-avx2(CPU) ×1, stress_mem ×5, stress_ssd, stress_usb  → 共 8 個 job
     │     （stress_hhmd / stress_pcie 已於 2026-08-17 移除，見 Status 表 ScriptB #5/#7 "KC Remove"）
+    ├─ BMC: bmc_monitor.sh start + bmc_monitor_ddr.sh start
     ├─ jobs                     ← 確認全部起來了
-    ├─ traffic: ps → init → clear → (pause 3) → show → start   （unit 0，VLAN 30..137 loopback）
+    ├─ traffic: ps → init → clear → (pause 15) → show → start  （unit 0 與 1，VLAN 30..137 loopback）
     └─ while 1: setup_pmon（9 項）→ margin_status_all          （soak 期間持續取樣）
     ▼
 [測試員 Ctrl-C / 停止 macro，接著跑 C]
@@ -317,8 +348,10 @@ Script C
     ├─ kill $(jobs -p)          ← 收掉所有背景壓力
     ├─ show platform × 9 + dmesg  ← 收工快照
     ├─ AER 再抓一次              ← 與 Script A 基線相減 = 本輪新增錯誤
+    ├─ BMC: 兩支 monitor stop → cat log/bmc_poll.log + log/bmc_ddr.log
     ├─ cat mlucas_amm_log / log.stress_ssd  ← 壓力程式自身的 pass/fail
-    └─ traffic: stop → report   ← per-pair TX/RX 交叉比對，PASS/FAIL/NA（exit 2 = 有 FAIL/NA）
+    ├─ traffic: stop → report   ← per-pair TX/RX 交叉比對，PASS/FAIL/NA（exit 2 = 有 FAIL/NA）
+    └─ show reboot-cause / show uptime  ← soak 期間有沒有意外重開，一眼看得到
     ▼
 [messagebox "GOOD JOB! Test Case DONE"] → 人工檢查 log
 ```
@@ -369,7 +402,19 @@ pwr_data
     否則它會吃掉 while 迴圈的 stdin，導致**只有第一個 VLAN 被設定**（V0.3.1 修的 bug）。
 11. **DUT 密碼不得進 git**：`1_Blanton_Script_A.ttl` 目前的 `sendln "YourPaSsWoRd"` 是 placeholder，
     實際帳密必須放 `secret/config_secret.ttl`（gitignored）並由 `config.ttl` include。
-12. **客戶 NDA**：`docs/` 內含客戶 FPGA 規格與 schematic 衍生資訊，**本 repo 只推 NAS + Gitea，
+12. **`.sh` / `.conf` 必須是 LF**：CRLF 的 shell script 在 SONiC 上直接掛
+    （`-bash: $'\r': command not found` + `syntax error near unexpected token`），
+    `settings/*.conf` 則因為是被 `source` 的，未加引號的賦值會變成 `"6\r"`（安靜地壞掉）。
+    `.gitattributes` 已把 `*.sh` `*.conf` `*.py` `*.txt` `*.md` 釘成 LF、`*.ttl` 維持 CRLF。
+    ⚠️ 但 `.gitattributes` **不會回頭重寫既有工作區檔案** —— 早於它 clone 出來的目錄，
+    需 `git rm --cached -r . && git reset --hard` 或刪掉目錄重新 checkout 才會生效，
+    而且 `git status` 乾淨**不代表**磁碟上是 LF（`--renormalize` 只在進 index 的路上轉換）。
+13. **`bmc_monitor*.sh` 需要執行權**：它們是本專案第一組「被執行」而非被 `source` 的腳本，
+    而 `do_start` 內部是 `setsid "$SCRIPT_PATH" __daemon`，**即使用 `bash x.sh start` 呼叫
+    也仍需 exec bit**。git 記錄為 `100644`，且 Windows → 隨身碟 → DUT 的路徑無法攜帶權限位元，
+    所以佈署後要先 `chmod +x ~/Blanton_Script/bmc_monitor*.sh`，否則 Script B 的 start 會
+    `Permission denied`、Script C 的 `cat` 撲空（BMC 段全空但不會報錯）。
+14. **客戶 NDA**：`docs/` 內含客戶 FPGA 規格與 schematic 衍生資訊，**本 repo 只推 NAS + Gitea，
     絕不推 GitHub**。
 
 ---
@@ -404,6 +449,9 @@ cp secret/config_secret.ttl.example secret/config_secret.ttl
 
 # ── 2. DUT 端：部署 bash 工具庫 ─────────────────────────────
 scp -r src/Script_ABC_Blanton/Blanton_Script admin@<DUT_IP>:~/
+#   佈署後務必補執行權（Windows/隨身碟路徑帶不動 exec bit）：
+ssh admin@<DUT_IP> 'chmod +x ~/Blanton_Script/bmc_monitor*.sh'
+#   若曾在舊工作區編輯過，先確認沒有 CRLF：grep -rlU $'\r' ~/Blanton_Script
 ssh admin@<DUT_IP> 'sudo -i'
 #   （現場無網路時改用 USB 隨身碟複製到 ~/Blanton_Script）
 
@@ -439,6 +487,19 @@ lspci -Dnn                          # 對照 ARCHITECTURE.md 的 PCIe 拓樸表
 8. 檢查 Logs\Blanton_Margin_<ts>.log
 ```
 
+**打包交付：**
+
+```bash
+./publish/publish.sh          # 版號讀 Script A 檔頭 → publish/Script_ABC_Blanton_V1.0.3/
+./publish/publish.sh -z       # 另外產出同名 .zip
+./publish/publish.sh -n       # dry run，只印會做什麼
+./publish/publish.sh -f       # 覆蓋既有輸出資料夾
+```
+
+版號**不是參數而是從 Script A 的 `; Version : Vx.y.z` 讀出來的**，所以資料夾名不可能跟
+測試員打開 macro 看到的版本不一致。要出新版就先改 Script A 檔頭再跑。
+輸出會排除 `*.log`（測試 log 含 DUT 序號，不隨交付外流），但保留空的 `logs/` 供 `logopen` 寫入。
+
 > 註：本專案非 .NET / Blazor / EC2 架構，`aws-ec2-deploy` 與 `vbox-run-deploy` 兩份部署指南不適用，已跳過。
 
 ---
@@ -506,6 +567,10 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
 - [x] soak 每輪補 `show platform psustatus` / `voltage` / `current`
       —— 迴圈已改為 `include "utils/setup_pmon.ttl"`，九項全收
 - [ ] 補 `; ========== CLEAR EVENT ==========`（Status 表 ScriptB #1，Owner: Alan）
+- [x] BMC 納入 soak：`bmc_monitor.sh`（`free -m` 取樣）與 `bmc_monitor_ddr.sh`（`memtester`）
+      由 Script B 啟動、Script C 停止並把 log 併進 master log
+- [x] Script A 加開機資訊與就緒等待：`show boot`、BMC `/etc/issue`、`wait_init.ttl`
+- [x] Script C 加 `show reboot-cause` / `show uptime`，soak 期間意外重開看得見
 
 **驗收條件：** Script B 啟動後 `jobs` 顯示 8 個 job；連續跑 3 輪，log 內三段各自帶正確時戳且間隔 ≈10 min；
 故意把 `~/hammer` 改名，Script B 會在前置檢查就停下並提示。
@@ -530,14 +595,15 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
       （取代原規劃的 `utils/show_traffic_counters.ttl`）
 - [x] Script B 接上 `ps → init → clear → show → start`、Script C 接上 `stop → report`
 - [x] 原始 bcmcmd 指令表留檔：`tools/traffic_loopback_{vlan_setting,start,vlan_remove}.txt`
-- [ ] **Script A 的 TRAFFIC-SETUP-STAGE 仍是空區塊** —— 目前流量只在 B/C，A 沒有基線
+- [x] **Script A 的流量基線** —— 原本的空區塊已改成完整一輪
+      （`ps → init → clear → show → start → stop → report`，含 15 秒沉澱）
 - [ ] `utils/show_interface_detail.ttl`：`show interface transceiver eeprom/dom`、
       `show interface link-training`（Status 表 ScriptC #4，仍 On-Going）
 - [ ] `utils/show_tech.ttl`：`show techsupport`（Script C 收工快照，Status 表 ScriptC #4）
 - [ ] `config.ttl` 加 `EN_Traffic` 旗標，未接 loopback 線的站點可整段跳過
       （現在 B/C 是無條件執行，沒接線會整批 bcmcmd 失敗）
-- [ ] 兩支腳本目前都寫死 `-u 0`，另一塊 switch board（unit 1）沒被測到；
+- [x] `-u 0` 已從三支腳本移除，全部沿用工具預設 `TL_UNITS="0 1"`，兩塊 switch board 都測到
-      工具本身預設是 `TL_UNITS="0 1"`，要決定是照工具預設跑兩塊，還是維持只測 unit 0
+- [x] 100G uplink 狀態：`show interfaces status Ethernet513,Ethernet514`（A 與 B 各一次）
 
 **驗收條件：** `EN_Traffic=1` 時，Script C 的 `report` 印出 108 對的 TX/RX 表且全 PASS；
 拔掉一條 loopback 線重跑，該對顯示 FAIL 或 NA 且 exit code 為 2；`EN_Traffic=0` 時整段不執行且不報錯。
@@ -570,9 +636,9 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
 **目標：** 產出可直接交給現場測試員（或客戶）的一包，含操作手冊，不需要看原始碼。
 
 **包含：**
-- [ ] `tools/publish.sh`：把 `src/Script_ABC_Blanton/` + 空 `Logs/` + `secret/*.example`
+- [x] `publish/publish.sh`：把 `src/Script_ABC_Blanton/` 打包成
-      打包成 `publish/Blanton_Script_ABC_v<ver>_<YYYYMMDD>/` 與同名 zip（比照
+      `publish/Script_ABC_Blanton_<Ver>/`（`-z` 另出 zip）。版號讀 Script A 檔頭，
-      既有的 `Blanton_Script_ABC_v1.0_20251229` 命名）
+      排除 `*.log` 但保留空的 `logs/`。工具本身進 git，產出被 gitignore
 - [ ] `README.md`（現場用）：Tera Term 設定、A→B→C 操作順序、常見錯誤（BDF 不符、
       margin 掃不到、hammer 工具缺檔）與對應處理
 - [ ] `CHANGELOG.md`：延續三支腳本頂端的 Version History，集中成一份
@@ -602,6 +668,16 @@ margin status、全部 VRM 軌的 Vin/Vout/Iout/Temp、CB + ICB 溫感讀值，
   bash 工具，速度與可靠度都比 serial 好，TTL 只保留開機階段。
 - **多 DUT 併行**：多台 DUT 同時 soak 時，Tera Term 每台開一個 macro window；
   可考慮改成 Python（`pyserial`）統一排程與集中收 log。
-- **與 `LTC2980_Margin_Script` 獨立 repo 的同步機制**：目前 `Blanton_Script/LTC2980_Margin_Script/`
+- ✅ **margin 子專案的重複檔** —— v2.6.0 已移除內含的 `blanton_cb_i2c.sh` /
-  是該 repo 的複本（少了 `ARCHITECTURE.md`/`CLAUDE.md`/`Reference/`，多了兩支 `blanton_*` 後端）。
+  `blanton_fpga_pcimem.sh` 複本，改由 `_swb_find_backend` 往上層找共用版，漂移風險解除。
-  待評估改用 git submodule 或明確的 vendored 同步腳本。
+  與獨立 repo `LTC2980_Margin_Script` 的同步機制（submodule 或 vendored 腳本）仍待評估。
+- **`Ref/margin_command_trace.md` 需重新產生**：SWB 章節的 1223 條 `cb_pmbus_*` 指令是依
+  修正前的通道／位址展開的（其中 487 條用到已不存在的 `0x5D`/`0x5F`/`0x63`/`0x65`），
+  文件已加過期警告但內文未動。第 1~4 章不受影響。
+- **`wait_init.ttl` 沒有逾時出口**：若 pmon 一直起不來，`result` 既非 1 也非 2，迴圈會無限重試，
+  Script A 既不往下走也不報錯。可加最大重試次數 + `messagebox` 提示。
+- **`bmc_monitor*.sh` 的執行權**：目前需人工 `chmod +x`。可在 Script B 起它們之前補一行
+  `chmod +x`（比照既有的 `chmod +x ~/hammer/tools/amd/mlucas-avx2`），或在 publish 時處理。
+- **`bmc_monitor_ddr.sh` 的壓力強度**：`memtester 500M 1` 配 `INTERVAL_SEC=5` 等於整個 soak
+  近乎不間斷壓 BMC 記憶體，而 BMC 同時還要服務 host 的 `show platform` 查詢。
+  若 PMON 取數變慢，先調大 `INTERVAL_SEC` 或縮小 memtester 的量。

CLAUDE.md

@@ -9,6 +9,10 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 
 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
+**目前狀態（2026-08-21）**：Script A/B/C 為 **V1.0.3**，涵蓋 PCIe AER / DDR EDAC / PMON /
+電壓 margin（9 顆 LTC2980）/ SWB loopback 線速流量（兩個 switch unit）/ BMC 監控與 DDR 壓力。
+SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。交付用 `./publish/publish.sh` 打包。
+
 ## 技術棧
 
 - **Host**：Tera Term 5.x TTL macro（`.ttl`），Windows
@@ -19,6 +23,7 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 - **Margin**：LTC2980（= 2 × LTC2977）over PMBus，LINEAR16
 - **資料面流量**：`bcmcmd`（Broadcom drivshell）SWB loopback，VLAN 30..137 成對 `cdN`/`cdN+32`，
   `tx 100 length=512`；判定讀 ASIC `MIB_TPOK`/`MIB_RPOK` 做 per-pair 雙向交叉比對
+- **BMC**：host 端 `bmc-manager run "<cmd>"`，不需對 BMC 開 SSH（繞開其 busybox 工具鏈）
 - **判定資料源**：PCIe AER sysfs（`aer_dev_*`）、EDAC sysfs（`dimm_{ce,ue}_count`）、SONiC `show platform *`
 - **無編譯步驟**：TTL 與 bash 都直譯執行
 
@@ -50,24 +55,44 @@ pwr_data                           # SWB VRM 全軌
 margin_init Blanton_CB_CONN13 && margin_status
 
 # ── SWB loopback 流量（bcmcmd，unit 0/1）─────────────
-blanton_traffic_linespeed ps     -u 0    # 對照線的 link/speed
+# 不帶 -u 就是預設 TL_UNITS="0 1"，兩塊 switch board 都做（TTL 三支腳本即如此）
-blanton_traffic_linespeed init   -u 0    # VLAN 30..137，cdN <-> cdN+32
+blanton_traffic_linespeed ps             # 對照線的 link/speed
-blanton_traffic_linespeed clear  -u 0    # clear c
+blanton_traffic_linespeed init           # VLAN 30..137，cdN <-> cdN+32
-blanton_traffic_linespeed start  -u 0 -tx 100 -length 512
+blanton_traffic_linespeed clear          # clear c
-blanton_traffic_linespeed stop   -u 0    # 移除 VLAN 成員（--destroy 連 VLAN 一起砍）
+blanton_traffic_linespeed start -tx 100 -length 512
-blanton_traffic_linespeed report -u 0    # per-pair TX/RX + PASS/FAIL（exit 2 = 有 FAIL/NA）
+blanton_traffic_linespeed stop           # 移除 VLAN 成員（--destroy 連 VLAN 一起砍）
-blanton_traffic_linespeed run    -u 0    # ps → init → clear → start → report 一條龍
+blanton_traffic_linespeed report         # per-pair TX/RX + PASS/FAIL（exit 2 = 有 FAIL/NA）
-blanton_traffic_linespeed init   -u 0 -n # -n dry-run：只印要下的 bcmcmd，不碰 DUT
+blanton_traffic_linespeed run            # ps → init → clear → start → report 一條龍
+blanton_traffic_linespeed init   -u 0    # 只做單一 unit 時才需要 -u
+blanton_traffic_linespeed init   -n      # -n dry-run：只印要下的 bcmcmd，不碰 DUT
 blanton_traffic_linespeed report -f <log>  # 離線重解一份存下來的 console log
 
 # 離線版報表（開發機上跑，選項更多）
 python3 tools/bcm_mibpair_report_V1.1.0.py <drivshell.log> -a
 
+# ── BMC 監控 / 壓力（需先 chmod +x！）────────────────
+chmod +x ~/Blanton_Script/bmc_monitor*.sh    # 佈署後必做一次
+~/Blanton_Script/bmc_monitor.sh     start    # free -m 取樣，log/bmc_poll.log
+~/Blanton_Script/bmc_monitor_ddr.sh start    # memtester，log/bmc_ddr.log
+~/Blanton_Script/bmc_monitor.sh     status   # pid / log 路徑 / log 大小
+~/Blanton_Script/bmc_monitor.sh     stop
+#   ⚠️ tail 子命令是 tail -f，會卡住不返回；要倒 log 請直接 cat log/*.log
+
 # ── 各工具的 help ───────────────────────────────────
 blanton_fpga_help ; blanton_cb_i2c_help ; vi2c_help
 temp_sensor_help ; pwr_data_help ; blanton_traffic_linespeed_help
 ```
 
+**打包交付（在開發機上）：**
+
+```bash
+./publish/publish.sh          # 版號讀 Script A 檔頭 → publish/Script_ABC_Blanton_V1.0.3/
+./publish/publish.sh -z       # 另出 zip
+./publish/publish.sh -n       # dry run
+```
+
+要出新版**先改 Script A 檔頭的 `; Version :`**，publish 才會用新版號建資料夾。
+
 **Host 端跑一輪測試：**
 
 ```
@@ -94,6 +119,10 @@ Tera Term 連 COM port (115200-8-N-1)
   若要回到「每支各自記錄」，B/C 的 History 需要補回去
 - **Commit**：Conventional Commits，**英文**。scope 用 `ttl` / `fpga` / `i2c` / `vi2c` /
   `margin` / `pwr` / `temp` / `docs`
+- **換行符**：由 `.gitattributes` 管理 —— `*.sh` `*.conf` `*.py` `*.txt` `*.md` 釘 **LF**
+  （要在 SONiC 上跑／被 source），`*.ttl` 維持 **CRLF**（Tera Term 只在 Windows 跑）。
+  編輯 `.ttl` 時要保留 CRLF，別讓整檔變成 LF 產生假 diff
+- **打包**：`./publish/publish.sh`，版號**讀 Script A 檔頭**不是參數 —— 先改檔頭再打包
 - **Status 表**：`docs/TTL_Script_Blanton_Status_*.xlsx` 是逐項進度的正本（OK / On-Going + Owner），
   完成一項就同步更新，別讓文件跟腳本脫節
 
@@ -130,9 +159,23 @@ Tera Term 連 COM port (115200-8-N-1)
 - ⚠️ **`stress_hhmd.py` / `stress_pcie.py` 已於 2026-08-17 由 KC 移除**（Status 表 ScriptB #5/#7）。
   Script B 現在是 **8 個背景 job**（1 mlucas + 5 mem + ssd + usb），不是 10 個。
   I2C／PCIe 的持續讀取壓力目前沒有替代品。
-- ⚠️ **Script B 的 traffic 與 soak 迴圈都寫死 `-u 0`、且迴圈沒有 `pause`**：
+- ⚠️ **soak 迴圈沒有 `pause`**：取樣間隔不是 Status 表寫的 10 分鐘，而是取決於指令執行時間。
-  只測到一塊 switch board，取樣間隔也不是 Status 表寫的 10 分鐘（取決於指令執行時間）。
+  （`-u 0` 已於 `491e807` 移除，A/B/C 現在都跑兩個 switch unit。）
-  改之前先確認現場期待的是哪一種。
+- 🔒 **`.sh` / `.conf` 一定要 LF**。CRLF 的 shell script 在 SONiC 上直接掛（`$'\r': command not found`）；
+  `settings/*.conf` 更陰險 —— 它們是被 `source` 的，`CB_I2C_CH=6` 會變成 `"6\r"`，安靜地壞掉。
+  `.gitattributes` 已擋住 git 這條路徑，但**不會回頭重寫既有工作區檔案**：早於它 clone 的目錄要
+  `git rm --cached -r . && git reset --hard` 才會生效，而且 **`git status` 乾淨不代表磁碟上是 LF**
+  （`--renormalize` 只在進 index 的路上轉換）。驗證要看 byte：`grep -rlU $'\r' <dir>`
+- ⚠️ **`bmc_monitor*.sh` 需要 exec bit**，且**不是改用 `bash x.sh start` 就能繞過** ——
+  `do_start` 內部是 `setsid "$SCRIPT_PATH" __daemon`，直接執行該路徑。git 記錄是 `100644`，
+  Windows → 隨身碟 → DUT 也帶不動權限位元，所以佈署後要 `chmod +x ~/Blanton_Script/bmc_monitor*.sh`。
+  沒做的話 Script B 的 start 會 Permission denied、Script C 的 `cat` 撲空，而且**不會報錯**，
+  只會得到一份 BMC 段全空的 log
+- ⚠️ **`bmc_monitor*.sh` 的 `tail` 子命令是 `tail -n 50 -f`，永遠不返回**。TTL 裡絕對不要呼叫它
+  （Script C 曾因此卡死，`18ce7a1` 改成直接 `cat log/*.log`）
+- ⚠️ **DUT 的 awk 對 `%d` 會夾到 INT32**（2147483647）。線速流量的計數器是 ~10¹² 量級，
+  所以 awk 裡輸出大數一律用 `%.0f`（double 域，精確到 2⁵³）。`blanton_traffic_linespeed.sh`
+  V0.4.1 已修；寫新的 awk 報表時要記得同一件事
 
 ## 資料夾說明
 
@@ -141,6 +184,6 @@ Tera Term 連 COM port (115200-8-N-1)
 - `tools/` — Host / 離線端：`bcm_mibpair_report_V1.1.0.py`（drivshell log → per-pair 報表）、
   `traffic_loopback_*.txt`（bcmcmd 原始指令表，`blanton_traffic_linespeed.sh` 是其 bash 版，
   **改 loopback 線路時兩邊要同步**）
-- `publish/` — 交付用打包輸出（`Blanton_Script_ABC_v<ver>_<date>/` + zip）
+- `publish/` — `publish.sh`（打包工具，**進 git**）+ `Script_ABC_Blanton_<Ver>/` 產出（**gitignored**）
 - `secret/` — 🚫 gitignored（除 `README.md` 與 `*.example`）：DUT 帳密、per-unit BDF 覆寫、COM 設定
 - `For_AI/` — 🚫 gitignored：AI 協作素材（波形截圖、草稿筆記）

publish/publish.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# =============================================================================
+# publish.sh  --  package src/Script_ABC_Blanton for delivery
+# =============================================================================
+# Version History:
+#   V1.0.0  2026-08-21  Initial. Copies src/Script_ABC_Blanton to
+#                       publish/Script_ABC_Blanton_<Version>, taking <Version>
+#                       from the "; Version : Vx.y.z" header of
+#                       1_Blanton_Script_A.ttl.
+# =============================================================================
+#
+# The version is READ FROM Script A rather than passed in, so the folder name
+# can never disagree with the header the tester sees when they open the macro.
+# Bump Script A's header first, then run this.
+#
+# Usage:
+#   ./publish/publish.sh              # publish at Script A's version
+#   ./publish/publish.sh -v V1.0.4    # override the version
+#   ./publish/publish.sh -f           # overwrite an existing output folder
+#   ./publish/publish.sh -z           # also produce a .zip next to it
+#   ./publish/publish.sh -n           # dry run: print what would happen
+# =============================================================================
+set -u
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd)"
+SRC_DIR="${REPO_ROOT}/src/Script_ABC_Blanton"
+OUT_ROOT="${SCRIPT_DIR}"
+NAME="Script_ABC_Blanton"
+VER=""; FORCE=0; ZIP=0; DRY=0
+
+info() { printf '[\033[34mINFO\033[0m] %s\n' "$*"; }
+ok()   { printf '[\033[32m OK \033[0m] %s\n' "$*"; }
+die()  { printf '[\033[31mERR \033[0m] %s\n' "$*" >&2; exit 1; }
+
+usage() { sed -n '2,26p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; exit 0; }
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -v|--version) VER="${2:-}"; shift 2 ;;
+        -f|--force)   FORCE=1; shift ;;
+        -z|--zip)     ZIP=1; shift ;;
+        -n|--dry-run) DRY=1; shift ;;
+        -h|--help)    usage ;;
+        *) die "unknown option '$1' (try -h)" ;;
+    esac
+done
+
+[ -d "${SRC_DIR}" ] || die "source not found: ${SRC_DIR}"
+
+# --- version from Script A's header ------------------------------------------
+# The .ttl files are CRLF, so strip the carriage return or it lands in the
+# folder name and produces a directory no one can cd into.
+if [ -z "${VER}" ]; then
+    A_TTL="${SRC_DIR}/1_Blanton_Script_A.ttl"
+    [ -f "${A_TTL}" ] || die "cannot read version: ${A_TTL} missing"
+    VER=$(grep -m1 -E '^;[[:space:]]*Version[[:space:]]*:' "${A_TTL}" \
+          | tr -d '\r' | sed -E 's/.*:[[:space:]]*//; s/[[:space:]]+$//')
+    [ -n "${VER}" ] || die "no '; Version : Vx.y.z' header in $(basename "${A_TTL}")"
+    info "version from $(basename "${A_TTL}") : ${VER}"
+else
+    info "version (overridden)              : ${VER}"
+fi
+
+case "${VER}" in
+    V[0-9]*) ;;
+    *) die "version '${VER}' does not look like Vx.y.z" ;;
+esac
+
+DEST="${OUT_ROOT}/${NAME}_${VER}"
+info "source                            : ${SRC_DIR#${REPO_ROOT}/}"
+info "destination                       : ${DEST#${REPO_ROOT}/}"
+
+if [ -e "${DEST}" ]; then
+    [ "${FORCE}" = "1" ] || die "${DEST##*/} already exists (use -f to overwrite)"
+    [ "${DRY}" = "1" ] || rm -rf -- "${DEST}"
+    info "existing folder removed (-f)"
+fi
+
+if [ "${DRY}" = "1" ]; then
+    info "dry run: nothing copied"
+    exit 0
+fi
+
+# --- copy ---------------------------------------------------------------------
+# Captured console logs are per-run and often carry DUT serials, so they are
+# never shipped; the empty logs/ directory itself is kept because Script A's
+# logopen writes into it.
+mkdir -p -- "${DEST}" || die "cannot create ${DEST}"
+if command -v rsync >/dev/null 2>&1; then
+    rsync -a --exclude='*.log' "${SRC_DIR}/" "${DEST}/" || die "rsync failed"
+else
+    cp -a -- "${SRC_DIR}/." "${DEST}/" || die "cp failed"
+    find "${DEST}" -type f -name '*.log' -delete
+fi
+
+# Tera Term's logopen target, in case the source tree never had one
+mkdir -p -- "${DEST}/logs"
+
+n_files=$(find "${DEST}" -type f | wc -l)
+ok "${n_files} files -> ${DEST##*/}"
+
+if [ "${ZIP}" = "1" ]; then
+    command -v zip >/dev/null 2>&1 || die "zip not installed"
+    ( cd -- "${OUT_ROOT}" && rm -f -- "${NAME}_${VER}.zip" \
+      && zip -qr "${NAME}_${VER}.zip" "${NAME}_${VER}" ) || die "zip failed"
+    ok "$(du -h "${OUT_ROOT}/${NAME}_${VER}.zip" | cut -f1) -> ${NAME}_${VER}.zip"
+fi

src/Script_ABC_Blanton/config.ttl

@@ -1,10 +1,10 @@
 ;================================================================
 ; User Configuration
 ;================================================================
-strTestcase="Margin"
 project_name = "Blanton"
+strTestcase="ENV"      ;ENV,EMC,Margin...etc 
 
-EN_Margin         = 1  ; 1: Enable Margin Test, 0: Disable Margin Test
+EN_Margin         = 0  ; 1: Enable Margin Test, 0: Disable Margin Test
 
 EN_log            = 1  ; 1: Enable log, 0: Disable log
 ;================================================================