docs: Update CLAUDE / ARCHITECTURE for V1.2.0 and add the release note

CLAUDE.md: status to V1.2.0 / 2026-09-07; the PRBS paragraph now says the
A/B/C call sites were deleted in V1.1.9 rather than commented out; the
DSC scan and parser get a commands block and a line in the status
summary; the soak loop uses sleep 60; the bcmcmd gotcha records that
bcm_dsc_scan.sh hit the same stdin trap on 2026-09-07 and why the
existing marker check could not see it; and a new gotcha on pause versus
sleep.

ARCHITECTURE.md: bcm_dsc_scan.sh / bcm_dsc_parse.sh in the tree and a
Key Features row of their own; EN_TX_FIR in the config.ttl line; Script A
ref to V1.2.0 and the A / B / C rows updated for the DSC steps and sleep;
constraint 10 extended with the recurrence; new constraint 18 (pause
stops the macro, sleep stops the DUT) with the old 18 renumbered to 19
and EN_TX_FIR added to it; the git tag checkbox to V1.2.0; the PRBS and
bmc_monitor_ddr known issues corrected from "commented out" to "deleted";
and a new known issue for the DSC scan being off by default and sharing
ports with the other traffic tools.

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

CLAUDE.md

@@ -9,15 +9,19 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 
 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
-**目前狀態（2026-09-06）**：Script A 為 **V1.1.8**（A 集中記錄所有 TTL 的變更）。涵蓋
+**目前狀態（2026-09-07）**：Script A 為 **V1.2.0**（A 集中記錄所有 TTL 的變更）。涵蓋
 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` 指定
 （預設 100 = 全速；soak 是熱測試，散熱不該是變因）。
 測試 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` + `systemctl is-active mlucas-amm`，並 `pause 60`
-（V1.0.10 之前完全沒有 pause）。V1.1.8 起 AMD CPU 壓力（`mlucas-avx2`）由 `systemd-run` 掛成
+100G PRBS（`port_prbs_monitor.sh`）已隨包交付、可手動執行，但 **V1.1.9 起 A/B/C 裡註解掉的呼叫已整段刪除**，
+要接回去得重寫（`bmc_monitor_ddr.sh` 在 Script C 的註解區塊同時移除）。
+V1.1.9 新增 **SerDes DSC 擷取**：`bcm_dsc_scan.sh`（DUT 端，`phydiag <port> dsc` 掃全機 ~445 port × 2 unit，
+約 10 分鐘）由 Script A 與 Script C 各跑一次夾住 soak，`bcm_dsc_parse.sh`（Host 端）把 raw log 轉成
+`_lane.csv` / `_pm.csv`。**由 `config.ttl` 的 `EN_TX_FIR` 控制，預設 0（關）** —— 開了整輪測試多 ~20 分鐘。
+Script B 的 soak 迴圈每輪印 `bgctl list` + `jobs` + `systemctl is-active mlucas-amm`，並 `sendln "sleep 60"`
+（V1.0.10 之前完全沒有間隔；V1.2.0 起 A/B/C 的等待一律改成 DUT 端 `sleep` 而非 macro 端 `pause`）。V1.1.8 起 AMD CPU 壓力（`mlucas-avx2`）由 `systemd-run` 掛成
 `mlucas-amm` transient unit（`Restart=always`），不再是 shell 的 `&` 背景 job —— 掉線也不會停，
 Script C 用 `systemctl stop mlucas-amm` 收掉並把 log 複製到隨身碟。
 V1.1.0 新增全機 SerDes BER 掃描（`blanton_ber.sh`，**Script C 已接**，依 `SWB_UNIT` 分支）、
@@ -150,6 +154,22 @@ sleep 30                                      # 至少等一個 interval 再 rep
 #   -u 0 / -u 1 單邊；-c 1e-9 換門檻；-F 只列失敗；-f <log> 離線重解
 #   ⚠️ 不能跟 blanton_traffic_linespeed / blanton_tr518 同時跑（都會接管同一批 port）
 
+# ── SerDes DSC 擷取（TX_FIR / RXFFE / DFE / EYE / SNR）──
+./Blanton_Script/bcm_dsc_scan.sh                        # unit 0+1 全掃，約 10 分鐘
+./Blanton_Script/bcm_dsc_scan.sh -u 0                   # 只掃一個 unit（時間減半）
+./Blanton_Script/bcm_dsc_scan.sh -f my.log -F           # 自訂檔名 + 覆蓋
+./Blanton_Script/bcm_dsc_scan.sh -n                     # dry-run，只列要掃的 port
+#   log: ~/Blanton_Script/log/，掃完自動 cp 到 /host/hw-eval/jobs（-C 可關）
+#   檔名沒帶 %u 時會自動插 _u0 / _u1，所以兩個 unit 不會互相覆蓋
+#   結尾固定印 "### DSC_SCAN_DONE rc=<n>"；rc=0 才是全部 port 都拿到完整 dump
+#   ⚠️ 由 TTL 的 EN_TX_FIR 控制，預設 0（關）—— A 與 C 各掃一次，開了整輪多 ~20 分鐘
+
+# ── DSC raw log → CSV（離線解，Host 或 DUT 都可）──────
+sh ~/Blanton_Script/bcm_dsc_parse.sh -i blanton_dsc_ScriptA_u0.log -o u0
+#   產出 u0_lane.csv（每 lane 一列）+ u0_pm.csv（每 pm_id 一列）
+#   純 sh + awk（mawk 相容），欄位靠括號群組順序抓，SDK 改排版不會壞；
+#   群組數 != 9 的列標成 UNPARSED 印到 stderr，不會安靜解錯
+
 # ── TR518 負載 + 量功耗（TTL 尚未接）─────────────────
 ./Blanton_Script/blanton_tr518.sh start       # 兩 unit，跑完 settle 120s
 ./Blanton_Script/TH6_SWB0_power_readback.sh   # 19 條軌 V×I + TOTAL POWER
@@ -304,9 +324,17 @@ Tera Term 連 COM port (115200-8-N-1)
   `Failed to execute the diagnostic command` 都照樣回 0），所以 `blanton_traffic_linespeed.sh`
   是**比對輸出**而非看 exit code。另外 `bcmcmd` 一律要 `</dev/null` ——
   否則它會吃掉 while 迴圈的 stdin，**只有第一個 VLAN 被設定**（V0.3.1 修過的 bug，很難看出來）。
+  **2026-09-07 `bcm_dsc_scan.sh` 又踩了同一個坑**：port 清單走 stdin，第一次 `bcmcmd` 就把剩下的吃光，
+  445 個 port 只掃了 1 個，而且 marker 與 dump 數量一起變少 → 比對通過、exit 0、log 看起來正常。
+  修法是迴圈改讀 fd 3（`done 3< "$PORTFILE"`）+ `bcmcmd ... < /dev/null`，並加一道
+  「實際迭代筆數 == 清單筆數」的檢查。**任何 `while ... done < file` 裡呼叫 `bcmcmd` 都要當它會讀 stdin。**
 - ⚠️ **`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 的持續讀取壓力目前沒有替代品。
+- ⚠️ **`pause` 是停 macro，`sleep` 是停 DUT**（V1.2.0 起 A/B/C 一律用後者）：`pause N` 期間 macro 不理會
+  DUT，shell 是閒著的，等於用猜的估上一個指令跑多久；`sendln "sleep N"` + `wait prompt_sonic_root`
+  把等待放到 DUT 上，prompt 回來才繼續，兩邊不會走散，而且這一段會帶時戳進 log。
+  **Script 4 / Script 5 尚未轉換，仍在用 `pause`**；B/C 開頭那個 `pause 1` 也保留（登入前沒有 prompt 可等）
 - ⚠️ **soak 迴圈沒有 `pause`**：取樣間隔不是 Status 表寫的 10 分鐘，而是取決於指令執行時間。
   （`-u 0` 已於 `491e807` 移除，A/B/C 現在都跑兩個 switch unit。）
 - 🔒 **`.sh` / `.conf` 一定要 LF**。CRLF 的 shell script 在 SONiC 上直接掛（`$'\r': command not found`）；