本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
偵錯並執行自訂測試套件
重要
這是 FreeRTOS 使用者指南的封存版本,可與 FreeRTOS 版本 202012.00 搭配使用。如需本文件的最新版本,請參閱 FreeRTOS 使用者指南。
設定必要的組態後,IDT 可以執行您的測試套件。完整測試套件的執行時間取決於硬體和測試套件的組成。如需參考,在 Raspberry Pi 3B 上完成完整的 FreeRTOS 資格測試套件大約需要 30 分鐘。 3B
當您撰寫測試套件時,您可以使用 IDT 在偵錯模式下執行測試套件,在執行程式碼之前先檢查程式碼,或將其提供給測試執行器。
在偵錯模式下執行 IDT
由於測試套件依賴 IDT 與裝置互動、提供內容並接收結果,因此您無法在沒有任何 IDT 互動的情況下,在 IDE 中對測試套件進行偵錯。若要這樣做,IDT CLI 會提供 debug-test-suite
命令,讓您以偵錯模式執行 IDT。執行下列命令以檢視 的可用選項debug-test-suite
:
devicetester_
[linux | mac | win_x86-64]
debug-test-suite -h
當您在偵錯模式下執行 IDT 時,IDT 實際上不會啟動測試套件或執行狀態機器;而是與您的 IDE 互動,以回應從 IDE 中執行的測試套件發出的請求,並將日誌列印到主控台。IDT 不會逾時,並等待結束,直到手動中斷為止。在偵錯模式中,IDT 也不會執行狀態機器,也不會產生任何報告檔案。若要偵錯測試套件,您必須使用 IDE 來提供 IDT 通常從組態 JSON 檔案取得的一些資訊。請務必提供下列資訊:
-
每個測試的環境變數和引數。IDT 不會從
test.json
或 讀取此資訊suite.json
。 -
選取資源裝置的引數。IDT 不會從 讀取此資訊
test.json
。
若要偵錯您的測試套件,請完成下列步驟:
-
建立執行測試套件所需的設定組態檔案。例如,如果您的測試套件需要
device.json
、resource.json
和user data.json
,請務必視需要設定所有測試套件。 -
執行下列命令,將 IDT 置於偵錯模式,然後選取執行測試所需的任何裝置。
devicetester_[linux | mac | win_x86-64] debug-test-suite
[options]
在您執行此命令後,IDT 會等待來自測試套件的請求,然後回應這些請求。IDT 也會產生 IDT 用戶端 SDK 案例程序所需的環境變數。
-
在您的 IDE 中,使用
run
或debug
組態來執行下列動作:-
設定 IDT 產生之環境變數的值。
-
設定您在
test.json
和suite.json
檔案中指定的任何環境變數或引數的值。 -
視需要設定中斷點。
-
-
在 IDE 中執行測試套件。
您可以視需要多次偵錯並重新執行測試套件。IDT 不會在偵錯模式下逾時。
-
完成偵錯後,請中斷 IDT 以結束偵錯模式。
用於執行測試的 IDT CLI 命令
下節說明 IDT CLI 命令: