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

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 同上
@@ -200,7 +202,9 @@ Blanton_TTL_Script/
                 ├── 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
@@ -241,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） |
@@ -342,16 +355,16 @@ PROFILE_CHANNELS=( "0:high:8" "1:low:8" ... )   # "channel:operation:change_perc
 
 | 模組 | 進入點 | 功能 |
 |------|--------|------|
-| **Script A（Pre-test）** | `1_Blanton_Script_A.ttl` V1.1.1 | 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** → 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` → **BER 掃描**（依 `SWB_UNIT`）→ 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`（一條龍）。**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 {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` |
@@ -360,6 +373,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 |
 

CLAUDE.md

@@ -9,7 +9,7 @@ DUT 端的取數能力由一組 **bash 工具庫** 提供（CB FPGA `pcimem` →
 
 完整架構見 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
-**目前狀態（2026-08-28）**：Script A 為 **V1.1.1**（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` 指定
@@ -22,7 +22,9 @@ TR518 負載（`blanton_tr518.sh`，**TTL 尚未接**）、SWB 軌功耗（`TH6_
 線速流量也納入 100G `ce0`（VLAN 138，靠 ingress mirror 維持循環）。
 Script A 開頭會先收掉前一輪殘留（`hw-test-session finish` + `bgctl reset/stop --all`），
 再 `bgctl list` 確認沒有 job 留著佔資源。
-最後一次發布是 **V1.1.0**；SWB 的 I2C 通道與位址已於 2026-08-19 上機驗證。
+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` 打包。
 
 ## 技術棧
@@ -129,6 +131,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              # 掛好並回傳掛載點
@@ -207,6 +219,12 @@ 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**，

docs/LTC2980_channel_map.csv

@@ -6,7 +6,7 @@ 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.8
+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
@@ -14,132 +14,132 @@ 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.8
+CB,CONN13,CH15,V0P8_PHY2_AVDD,0.816
 SWB0,CONN13,CH0,P0V75_DVDD_47,0.75
-SWB0,CONN13,CH1,P0V75_AVDD_47,0.75
+SWB0,CONN13,CH1,P0V75_AVDD_47,0.756
-SWB0,CONN13,CH2,P1V5_AVDD_47,1.5
+SWB0,CONN13,CH2,P1V5_AVDD_47,1.524
-SWB0,CONN13,CH3,P0V9_AVDD_47,0.9
+SWB0,CONN13,CH3,P0V9_AVDD_47,0.915
-SWB0,CONN13,CH4,P1V8_1,1.8
+SWB0,CONN13,CH4,P1V8_1,1.816
-SWB0,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.3
+SWB0,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.38
-SWB0,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.3
+SWB0,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.38
-SWB0,CONN13,CH7,P1V8_3,1.8
+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.75
+SWB0,CONN13,CH10,P0V75_AVDD_39,0.756
-SWB0,CONN13,CH11,P1V5_AVDD_39,1.5
+SWB0,CONN13,CH11,P1V5_AVDD_39,1.524
-SWB0,CONN13,CH12,P0V9_AVDD_39,0.9
+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.75
+SWB0,CONN14,CH0,P0V75_AVDD_7,0.756
-SWB0,CONN14,CH1,P1V5_AVDD_7,1.5
+SWB0,CONN14,CH1,P1V5_AVDD_7,1.524
-SWB0,CONN14,CH2,P0V9_AVDD_7,0.9
+SWB0,CONN14,CH2,P0V9_AVDD_7,0.915
-SWB0,CONN14,CH3,P1V8_5,1.8
+SWB0,CONN14,CH3,P1V8_5,1.816
-SWB0,CONN14,CH4,P1V8_2,1.8
+SWB0,CONN14,CH4,P1V8_2,1.816
-SWB0,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.3
+SWB0,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.38
-SWB0,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.3
+SWB0,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.38
-SWB0,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.3
+SWB0,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.38
-SWB0,CONN14,CH8,PVDD1V5_TSC,1.5
+SWB0,CONN14,CH8,PVDD1V5_TSC,1.516
-SWB0,CONN14,CH9,PVDD1V5_ANLG,1.5
+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.5
+SWB0,CONN15,CH0,P1V5_AVDD_55,1.524
-SWB0,CONN15,CH1,P0V9_AVDD_55,0.9
+SWB0,CONN15,CH1,P0V9_AVDD_55,0.915
 SWB0,CONN15,CH2,P0V75_DVDD_63,0.75
-SWB0,CONN15,CH3,P0V75_AVDD_63,0.75
+SWB0,CONN15,CH3,P0V75_AVDD_63,0.756
-SWB0,CONN15,CH4,P1V5_AVDD_63,1.5
+SWB0,CONN15,CH4,P1V5_AVDD_63,1.524
-SWB0,CONN15,CH5,P0V9_AVDD_63,0.9
+SWB0,CONN15,CH5,P0V9_AVDD_63,0.915
-SWB0,CONN15,CH6,PVDD3_3V_SYNTH_LDO_B3,3.3
+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.9
+SWB0,CONN15,CH12,PVDD0V9_2,0.91
 SWB0,CONN15,CH13,P0V75_DVDD_55,0.75
-SWB0,CONN15,CH14,P0V75_AVDD_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.8
+SWB0,CONN16,CH1,P1V8_4,1.816
-SWB0,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.3
+SWB0,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.38
-SWB0,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.3
+SWB0,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.38
-SWB0,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.3
+SWB0,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.38
-SWB0,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.3
+SWB0,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.38
-SWB0,CONN16,CH6,P3V3,3.3
+SWB0,CONN16,CH6,P3V3,3.327
-SWB0,CONN16,CH7,PVDD0_8V_T3,0.8
+SWB0,CONN16,CH7,PVDD0_8V_T3,0.82
 SWB0,CONN16,CH8,P0V75_DVDD_1,0.75
-SWB0,CONN16,CH9,P0V75_AVDD_1,0.75
+SWB0,CONN16,CH9,P0V75_AVDD_1,0.756
-SWB0,CONN16,CH10,P1V5_AVDD_1,1.5
+SWB0,CONN16,CH10,P1V5_AVDD_1,1.524
-SWB0,CONN16,CH11,P0V9_AVDD_1,0.9
+SWB0,CONN16,CH11,P0V9_AVDD_1,0.915
-SWB0,CONN16,CH12,PVDD0V9_0,0.9
+SWB0,CONN16,CH12,PVDD0V9_0,0.915
-SWB0,CONN16,CH13,PVDD0V9_1,0.9
+SWB0,CONN16,CH13,PVDD0V9_1,0.91
-SWB0,CONN16,CH14,PVDD0V9_3,0.9
+SWB0,CONN16,CH14,PVDD0V9_3,0.915
-SWB0,CONN16,CH15,PVDD1V2_T3,1.2
+SWB0,CONN16,CH15,PVDD1V2_T3,1.224
 SWB1,CONN13,CH0,P0V75_DVDD_47,0.75
-SWB1,CONN13,CH1,P0V75_AVDD_47,0.75
+SWB1,CONN13,CH1,P0V75_AVDD_47,0.756
-SWB1,CONN13,CH2,P1V5_AVDD_47,1.5
+SWB1,CONN13,CH2,P1V5_AVDD_47,1.524
-SWB1,CONN13,CH3,P0V9_AVDD_47,0.9
+SWB1,CONN13,CH3,P0V9_AVDD_47,0.915
-SWB1,CONN13,CH4,P1V8_1,1.8
+SWB1,CONN13,CH4,P1V8_1,1.816
-SWB1,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.3
+SWB1,CONN13,CH5,PVDD3_3V_SYNTH_LDO_A3,3.38
-SWB1,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.3
+SWB1,CONN13,CH6,PVDD3_3V_SYNTH_LDO_B1,3.38
-SWB1,CONN13,CH7,P1V8_3,1.8
+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.75
+SWB1,CONN13,CH10,P0V75_AVDD_39,0.756
-SWB1,CONN13,CH11,P1V5_AVDD_39,1.5
+SWB1,CONN13,CH11,P1V5_AVDD_39,1.524
-SWB1,CONN13,CH12,P0V9_AVDD_39,0.9
+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.75
+SWB1,CONN14,CH0,P0V75_AVDD_7,0.756
-SWB1,CONN14,CH1,P1V5_AVDD_7,1.5
+SWB1,CONN14,CH1,P1V5_AVDD_7,1.524
-SWB1,CONN14,CH2,P0V9_AVDD_7,0.9
+SWB1,CONN14,CH2,P0V9_AVDD_7,0.915
-SWB1,CONN14,CH3,P1V8_5,1.8
+SWB1,CONN14,CH3,P1V8_5,1.816
-SWB1,CONN14,CH4,P1V8_2,1.8
+SWB1,CONN14,CH4,P1V8_2,1.816
-SWB1,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.3
+SWB1,CONN14,CH5,PVDD3_3V_SYNTH_LDO_B2,3.38
-SWB1,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.3
+SWB1,CONN14,CH6,PVDD3_3V_SYNTH_LDO_A2,3.38
-SWB1,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.3
+SWB1,CONN14,CH7,PVDD3_3V_SYNTH_LDO_A1,3.38
-SWB1,CONN14,CH8,PVDD1V5_TSC,1.5
+SWB1,CONN14,CH8,PVDD1V5_TSC,1.516
-SWB1,CONN14,CH9,PVDD1V5_ANLG,1.5
+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.5
+SWB1,CONN15,CH0,P1V5_AVDD_55,1.524
-SWB1,CONN15,CH1,P0V9_AVDD_55,0.9
+SWB1,CONN15,CH1,P0V9_AVDD_55,0.915
 SWB1,CONN15,CH2,P0V75_DVDD_63,0.75
-SWB1,CONN15,CH3,P0V75_AVDD_63,0.75
+SWB1,CONN15,CH3,P0V75_AVDD_63,0.756
-SWB1,CONN15,CH4,P1V5_AVDD_63,1.5
+SWB1,CONN15,CH4,P1V5_AVDD_63,1.524
-SWB1,CONN15,CH5,P0V9_AVDD_63,0.9
+SWB1,CONN15,CH5,P0V9_AVDD_63,0.915
-SWB1,CONN15,CH6,PVDD3_3V_SYNTH_LDO_B3,3.3
+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.9
+SWB1,CONN15,CH12,PVDD0V9_2,0.91
 SWB1,CONN15,CH13,P0V75_DVDD_55,0.75
-SWB1,CONN15,CH14,P0V75_AVDD_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.8
+SWB1,CONN16,CH1,P1V8_4,1.816
-SWB1,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.3
+SWB1,CONN16,CH2,PVDD3_3V_SYNTH_LDO_B5,3.38
-SWB1,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.3
+SWB1,CONN16,CH3,PVDD3_3V_SYNTH_LDO_A5,3.38
-SWB1,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.3
+SWB1,CONN16,CH4,PVDD3_3V_SYNTH_LDO_B4,3.38
-SWB1,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.3
+SWB1,CONN16,CH5,PVDD3_3V_SYNTH_LDO_A4,3.38
-SWB1,CONN16,CH6,P3V3,3.3
+SWB1,CONN16,CH6,P3V3,3.327
-SWB1,CONN16,CH7,PVDD0_8V_T3,0.8
+SWB1,CONN16,CH7,PVDD0_8V_T3,0.82
 SWB1,CONN16,CH8,P0V75_DVDD_1,0.75
-SWB1,CONN16,CH9,P0V75_AVDD_1,0.75
+SWB1,CONN16,CH9,P0V75_AVDD_1,0.756
-SWB1,CONN16,CH10,P1V5_AVDD_1,1.5
+SWB1,CONN16,CH10,P1V5_AVDD_1,1.524
-SWB1,CONN16,CH11,P0V9_AVDD_1,0.9
+SWB1,CONN16,CH11,P0V9_AVDD_1,0.915
-SWB1,CONN16,CH12,PVDD0V9_0,0.9
+SWB1,CONN16,CH12,PVDD0V9_0,0.915
-SWB1,CONN16,CH13,PVDD0V9_1,0.9
+SWB1,CONN16,CH13,PVDD0V9_1,0.91
-SWB1,CONN16,CH14,PVDD0V9_3,0.9
+SWB1,CONN16,CH14,PVDD0V9_3,0.915
-SWB1,CONN16,CH15,PVDD1V2_T3,1.2
+SWB1,CONN16,CH15,PVDD1V2_T3,1.224

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.1.1
+; Version : V1.1.3
-; Date    : 2026-08-28
+; Date    : 2026-08-30
 ; Author  : ETWen
 ; =============================================================================
 ; Version History:
@@ -138,6 +138,46 @@
 ;                                                                         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"
 
@@ -306,6 +346,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/LTC2980_Margin_Script/README.md

@@ -72,13 +72,13 @@ 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            # 只寫當前載入的那顆
@@ -108,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
@@ -124,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
     ...
 )
 ```
@@ -133,6 +133,10 @@ PROFILES=(
 `PROFILES` 寫名字即可（不含路徑跟 `.conf`），script 會自動展開成
 `profiles/<name>.conf`。兩個陣列長度不一致會直接報錯。
 
+> ⚠️ **SWB 的 profile 是 per-CONN 的**：每個檔的百分比對應該片板子的軌，
+> 套到別的 CONN 會 margin 到錯的東西（而且不會報錯）。這裡不能全部填同一個名字。
+> HIGH / LOW 兩輪就是把 `_high` 全換成 `_low` 再跑一次。
+
 ## 一次把所有 LTC2980 寫入 NVM
 
 > ⚠️  `margin_save` 會把當前 margin / OV / UV 設定**永久寫入 NVM**，
@@ -217,6 +221,22 @@ i2cset -f -y 14 0x62 0x15   ;  i2cset -f -y 14 0x64 0x15    # SWB1 CONN16
 不要讓它去打不存在的板子。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 對應
 
 | 參數 | PMBus 0x01 值 | 說明 |

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/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/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