Sigma Agent / QuickTrack WiFi 認證測試完整流程，涵蓋環境建置、Docker 設定、Device 檔客製化、HE/VHT/EHT 測試執行、報告判讀與常見問題排除。用於 Broadcom 平台 WiFi 6/6E/7 認證。觸發關鍵字：Sigma、QuickTrack、WiFi 認證、CAPI、device file、HE test、EHT、Wi-Fi Test Suite。
| Sigma Agent | QuickTrack | |
|---|---|---|
| 角色 | 外部測試機控制 APUT | DUT 內建服務 |
| 架構 | UCC → Sigma Agent → APUT | UCC → app-dut (on APUT) |
| 轉接層 | 多一層 Sigma Agent | 直連，少一道轉接 |
| 報告路徑 | agent_log_extract | Cloud-Reports / Test-Logs |
控制網 (out-of-band): 192.168.250.x/24 ← UCC/控制器
測試網 (in-band): 192.165.1.x/16 ← AP LAN/BSS
/etc/sysconfig/selinux → SELINUX=disabledsystemctl disable firewalldtcllib expect lftp telnet# WSL2 Ubuntu → Docker Container 架構
# NIC1: 控制網 192.168.250.x
# NIC2: 測試網 192.165.1.x
# Container 內執行 agent_start，開放 agentport (15000/TCP)
# USB NIC（控制網）
ip addr add 192.168.250.100/24 dev enp1s0f0
# 內建 NIC（測試網）
ip addr add 192.165.1.100/16 dev enp4s0
cp sigma/main/device/brcm-cms.tcl sigma/main/device/<new-device>.tclnamespace eval HE::<device> 必須與封包名稱一致mlo_list 以 MAP/AAP 順序列舉wl# 吻合sigma/main/others/Wi-FiTestSuite/cmds/WTS-HE/AllInitCommand_HE.txt)：
InitEnv.txt、CommonDefs.txt、HE-testbed-reset.txtwfa_test_commands!RadioOff.txt! Radio Reset 步驟$PreCorrection_TC_Flag 控制版本資訊蒐集cd sigma/main
./agent_start --program HE --device <device-name>
# agentport 預設 15000/TCP
| Program | 標準 | 說明 |
|---|---|---|
| HE | 802.11ax | Wi-Fi 6 主要認證 |
| VHT | 802.11ac | Wi-Fi 5 |
| EHT | 802.11be | Wi-Fi 7 |
| WPA3 | — | 安全性認證 |
| MBO | — | Multi-Band Operation |
| ... | — | 見 [[sigma-qt-setup]] 完整清單 |
# 在 Wi-FiTestSuite 目錄下透過 cmds/config 手動執行
# 另開終端觀察 CAPI
./agent_log_extract.tcl
/usr/local/bin/WFA-QuickTrack-Tool/Cloud-Reports/usr/local/bin/WFA-QuickTrack-Tool/Test-Logs| 問題 | 可能原因 | 解法 |
|---|---|---|
| Test Suite 找不到 AP | 控制網/測試網未隔離 | 確認兩張 NIC 分屬不同網段 |
| Device 檔載入失敗 | namespace 不匹配 | 確認 package provide 與 namespace eval 一致 |
| MLO 測試失敗 | wl# 索引對應錯誤 | 檢查 mlo_list 與實際介面映射 |
| CAPI timeout | agent 未啟動或 port 不通 | 確認 agent_start 執行中、firewall 開放 15000/TCP |
| Wi-Fi 7 lftp 上傳失敗 | 缺少 lftp 套件 | dnf install lftp |
[[sigma-qt-test-framework-details]] — 測試框架完整細節（母筆記）[[sigma-qt-setup]] — 架構設定與 Program 總覽[[sigma-qt-he-tests]] — Wi-Fi 6 HE 測試項目[[sigma-qt-other-tests]] — VHT/EHT 測試與報告[[sigma-qt-local-setup-guide]] — 本機測試環境建置[[sigma-qt-build-setup]] — 建置環境[[Sigma-Agent-device-file-guide]] — Device 檔指南[[Sigma-QT工具建置與測試流程]] — 工具建置流程[[wifi-certification-summary]] — WiFi 認證流程總結