feat(nfc): Poll the NFC tag through the soak instead of sampling it once

nfc_polling.sh wraps blantons_nfc_validate.py in a background loop and
keeps score: start/stop/status/tail/report/clear/fg. Script A takes a
30s baseline, Script B starts the poll for the soak, Script C stops it
with the other monitors and reports.

report only reads the log, so it can be run mid-soak without disturbing
anything - and it says RUNNING so a snapshot is not read as the final
answer. Each round appends a machine-readable RESULT line, which keeps
the tally independent of the tool's wording.

ERROR is counted apart from FAIL. A round where the tool printed neither
[PASS] nor [FAIL] - crashed, missing, hung past the timeout - measured
nothing, and that is a different fault from a tag that would not read.
Rolling them together hides whichever one you are not looking for.

Two habits from earlier bugs are baked in: tail does not follow (tail -f
never returns and a macro waiting on the prompt hangs there), and the .py
is called through python3 rather than ./ (it arrives mode 100644 and a
USB copy carries no execute bit).

Also fixes Script C copying "nfc_polling.log" to the job dir when the
file is "nfc_poll.log". The cp failed, nothing checked it, and the run
finished looking fine - you would find out at the desk, with a job
archive that had no NFC log in it.

Script A -> V1.1.2.

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

ARCHITECTURE.md

@@ -188,6 +188,8 @@ Blanton_TTL_Script/
             │                              #   eth0→TARGET_10G、eth1→TARGET_1G，兩張卡同時持續 ping
             ├── port_prbs_monitor.sh       # 100G uplink PRBS 測試（bcmcmd phy diag）
             ├── 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 同上
@@ -342,9 +344,9 @@ 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 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 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` → **BER 掃描**（依 `SWB_UNIT`）→ NVMe 健康 → `show reboot-cause` / `uptime` → **job log 複製到 USB（帶時戳）** → `hw-test-session finish` |
+| **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 監控 → **啟動 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 與 **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`（一條龍）。**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 裝置必需） |
@@ -360,6 +362,7 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... )   # "channel:operation:change_perc
 | **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 |
 
@@ -378,6 +381,7 @@ Script A ── logopen Logs/Blanton_Margin_<ts>.log ──┐  (之後所有畫
     ├─ 登入 admin → sudo -i → root@sonic:~#         │
     ├─ date -s "<host 時間>"   ← 讓 DUT 時戳可對照
     ├─ 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 確認   │

CLAUDE.md

@@ -9,7 +9,7 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 
 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
-**目前狀態（2026-08-28）**：Script A 為 **V1.1.0**（A 集中記錄 A/B/C 三支的變更）。涵蓋
+**目前狀態（2026-08-28）**：Script A 為 **V1.1.2**（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` 指定
@@ -20,7 +20,10 @@ Script B 的 soak 迴圈每輪印 `bgctl list` + `jobs`，並 `pause 60`（V1.0.
 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 維持循環）。
-最後一次發布是 **V1.0.11**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。
+Script A 開頭會先收掉前一輪殘留（`hw-test-session finish` + `bgctl reset/stop --all`），
+再 `bgctl list` 確認沒有 job 留著佔資源。
+NFC tag 讀取由 `nfc_polling.sh` 背景輪詢（A 做基線、B 起、C 停並 report）。
+最後一次發布是 **V1.1.1**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。
 交付用 `./publish/publish.sh` 打包。
 
 ## 技術棧
@@ -127,6 +130,16 @@ sleep 30                                      # 至少等一個 interval 再 rep
 ./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              # 掛好並回傳掛載點

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)

src/Script_ABC_Blanton/1_Blanton_Script_A.ttl

@@ -1,6 +1,6 @@
 ; =============================================================================
 ; Script A for Blanton
-; Version : V1.1.0
+; Version : V1.1.2
 ; Date    : 2026-08-28
 ; Author  : ETWen
 ; =============================================================================
@@ -132,6 +132,35 @@
 ;                       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
 ; =============================================================================
 include "config.ttl"
 
@@ -171,6 +200,16 @@ wait prompt_sonic_root
 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
@@ -290,6 +329,18 @@ 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 ==========
 wait prompt_sonic_root

src/Script_ABC_Blanton/2_Blanton_Script_B.ttl

@@ -100,6 +100,12 @@ 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

src/Script_ABC_Blanton/3_Blanton_Script_C.ttl

@@ -25,6 +25,8 @@ 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
@@ -92,6 +94,10 @@ sendln "cat /host/hw-eval/jobs/qfx5252-stress-usb.log"
 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"
@@ -201,6 +207,8 @@ 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"

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