本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # IDT for FreeRTOS 資格套件 2.0 的 UI (FRQ 2.0) AWS IoT Device Tester for FreeRTOS (IDT for FreeRTOS) 包含 Web 型使用者介面 (UI)，您可以在其中與 IDT 命令列應用程式和相關組態檔案互動。您可以使用 IDT for FreeRTOS UI 為您的裝置建立新的組態，或修改現有的組態。您也可以使用 UI 呼叫 IDT 應用程式，並對您的裝置執行 FreeRTOS 測試。 如需有關如何使用命令列來執行資格測試的資訊，請參閱 [微控制器電路板的第一個測試](lts-qual-steps.md)。 本節說明 IDT for FreeRTOS UI 的先決條件，以及如何從 UI 執行資格測試。 **Topics** + [設定 IDT 先決條件](#lts-dev-tester-ui-prereqs) + [設定 AWS 登入資料以使用 IDT UI](lts-configure-aws-credentials.md) + [開啟 IDT for FreeRTOS UI](lts-open-idt-ui.md) + [建立新的組態](lts-create-new-configuration.md) + [修改現有的組態](lts-modify-existing-configuration.md) + [執行資格測試](lts-run-tests-from-ui.md) ## 設定 IDT 先決條件 若要透過 FreeRTOS UI 的 AWS IoT Device Tester (IDT) 執行測試，您必須完成 IDT FreeRTOS 資格 (FRQ) 2.x 頁面上[設定 LTS 資格先決條件](lts-idt-dev-tester-prereqs.md)的先決條件。 # 設定 AWS 登入資料以使用 IDT UI 您必須為您在 中建立的使用者設定 IAM AWS 使用者憑證[建立 AWS 帳戶](lts-idt-dev-tester-prereqs.md#lts-config-aws-account)。您可以使用下列兩種方式的其中之一指定登入資料： + 在登入資料檔案中 + 做為環境變數 ## 使用 AWS 登入資料檔案設定登入資料 IDT 會使用與 AWS CLI相同的登入資料檔案。如需詳細資訊，請參閱[組態與登入資料檔案](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)。 登入資料檔案的位置會根據您使用的作業系統而有所不同： + **macOS 和 Linux** – `~/.aws/credentials` + **Windows** – `C:\Users\UserName\.aws\credentials` 以下列格式將您的 AWS 登入資料新增至 `credentials` 檔案： ``` [default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key ``` **注意** 如果您不使用`default` AWS 設定檔，則必須在 IDT for FreeRTOS UI 中指定設定檔名稱。如需設定檔的詳細資訊，請參閱[組態和登入資料檔案設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)。 ## 使用環境變數設定 AWS 登入資料 環境變數是由作業系統維護且由系統命令使用的變數。如果您關閉 SSH 工作階段，則不會儲存它們。IDT for FreeRTOS UI 使用 `AWS_ACCESS_KEY_ID`和 `AWS_SECRET_ACCESS_KEY`環境變數來存放您的 AWS 登入資料。 若要在 Linux、macOS 或 Unix 上設定這些變數，請使用 **export**： ``` export AWS_ACCESS_KEY_ID=your_access_key_id export AWS_SECRET_ACCESS_KEY=your_secret_access_key ``` 若要在 Windows 上設定這些變數，請使用 **set**： ``` set AWS_ACCESS_KEY_ID=your_access_key_id set AWS_SECRET_ACCESS_KEY=your_secret_access_key ``` # 開啟 IDT for FreeRTOS UI 本主題說明如何開啟 IDT for FreeRTOS UI 以使用 FreeRTOS 資格套件。 **開啟 IDT for FreeRTOS UI** 1. 下載支援的 IDT for FreeRTOS 版本。然後將下載的封存解壓縮到您具有讀取和寫入許可的目錄。 1. 導覽至 IDT for FreeRTOS 安裝目錄： ``` cd devicetester-extract-location/bin ``` 1. 執行下列命令以開啟 IDT for FreeRTOS UI： ------ #### [ Linux ] ``` .devicetester_ui_linux_x86-64 ``` ------ #### [ Windows ] ``` ./devicetester_ui_win_x64-64 ``` ------ #### [ macOS ] ``` ./devicetester_ui_mac_x86-64 ``` **注意** 在 macOS 中，若要允許系統執行 UI，請前往**系統偏好設定 -> 安全性與隱私權**。當您執行測試時，您可能需要再這樣做三次。 ------ IDT for FreeRTOS UI 會在您的預設瀏覽器中開啟。下列瀏覽器的最新三個主要版本支援 UI： + Google Chrome + Mozilla Firefox + Microsoft Edge + 適用於 macOS 的 Apple Safari **注意** 為了獲得更好的體驗，我們建議 Google Chrome 或 Mozilla Firefox 存取 IDT for FreeRTOS UI。UI 不支援 Microsoft Internet Explorer。 **重要** 您必須先設定 AWS 登入資料，才能開啟 UI。如果您尚未設定登入資料，請關閉 IDT for FreeRTOS UI 瀏覽器視窗，遵循 中的步驟[設定 AWS 登入資料以使用 IDT UI](lts-configure-aws-credentials.md)，然後重新開啟 IDT for FreeRTOS UI。 # 建立新的組態 如果您是第一次使用，則必須建立新的組態，以設定 IDT for FreeRTOS 執行測試所需的 JSON 組態檔案。然後，您可以執行測試或修改建立的組態。 如需 `config.json`、 `device.json`和 `userdata.json` 檔案的範例，請參閱 [微控制器電路板的第一個測試](lts-qual-steps.md)。 **建立新的組態。** 1. 在 IDT for FreeRTOS UI 中，開啟導覽功能表，然後選擇**建立新組態**。 ![\[Device Tester for FreeRTOS 介面搭配「建立新的組態」按鈕，以及有關自動自我測試微控制器的資訊。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-create-configuration.png) 1. 遵循組態精靈來輸入用於執行資格測試的 IDT 組態設定。精靈會在位於 `devicetester-extract-location/config`目錄中的 JSON 組態檔案中設定下列設定。 + **裝置設定** – 要測試之裝置的裝置集區設定。這些設定是在 `id`和 `sku`欄位中設定，以及 `config.json` 檔案中**裝置**集區的裝置區塊。 ![\[適用於 FreeRTOS 的 Device Tester 組態畫面，其中包含用於設定裝置集區的識別碼和 SKU 欄位、連線方法、金鑰佈建、PKCS #11 設定、裝置詳細資訊輸入欄位等裝置設定選項，以及用於新增裝置或識別碼的控制項。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-device-settings.png) + **AWS 帳戶設定** – AWS 帳戶 IDT for FreeRTOS 在測試執行期間用來建立 AWS 資源的資訊。這些設定是在 `config.json` 檔案中設定。 ![\[AWS 帳戶 設定頁面，其中包含帳戶區域的欄位、檔案或環境的登入資料位置，以及設定檔名稱\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-account-settings.png) + **FreeRTOS 實作** – FreeRTOS 儲存庫和移植程式碼的絕對路徑，以及您想要執行 IDT FRQ 的 FreeRTOS 版本。從 `FreeRTOS-Libraries-Integration-Tests` GitHub 儲存庫到執行和參數組態標頭檔案的路徑。硬體的建置和刷新命令，可讓 IDT 自動在您的主機板上建置和刷新測試。這些設定是在 `userdata.json` 檔案中設定。 ![\[包含儲存庫路徑、測試執行路徑、FreeRTOS 版本、建置工具詳細資訊和快閃記憶體工具設定的 FreeRTOS 實作組態區段。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-implementation-settings.png) + **PKCS \$111 標籤和 Echo 伺服器** – 根據金鑰功能和金鑰佈建方法，對應至硬體中佈建之金鑰的 [PKCS \$111](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html) 標籤。傳輸介面測試的 echo 伺服器組態設定。這些設定是在 `userdata.json`和 `device.json`檔案中設定。 ![\[PKCS #11 標籤和 Echo 伺服器組態，其中包含金鑰標籤、金鑰產生方法和伺服器連接埠號碼的輸入欄位\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-pkcs11-settings.png) + **Over-the-air(OTA) 更新** – 控制 OTA 功能測試的設定。這些設定是在 `device.json`和 `userdata.json` 檔案的 `features`區塊中設定。 ![\[OTA 更新組態選項：略過測試、資料通訊協定、韌體路徑、PAL 憑證路徑、程式碼簽署、雜湊/簽署演算法、受信任/不受信任簽署者憑證、簽署者憑證檔案、編譯簽署者憑證、簽署者平台。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-ota-settings.png) 1. 在**檢閱**頁面上，驗證您的組態資訊。 ![\[Device Tester for FreeRTOS 的組態建立對話方塊，顯示有關使用編輯或執行測試的選項建立新的測試組態的詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/gsg-configuration-created.png) 檢閱組態完成後，若要執行資格測試，請選擇**執行測試**。 # 修改現有的組態 如果您已經為 IDT for FreeRTOS 設定組態檔案，您可以使用 IDT for FreeRTOS UI 來修改現有的組態。現有的組態檔案必須位於 `devicetester-extract-location/config`目錄中。 **修改組態** 1. 在 IDT for FreeRTOS UI 中，開啟導覽功能表，然後選擇**編輯現有組態**。 組態儀表板會顯示現有組態設定的相關資訊。如果組態不正確或無法使用，則該組態的狀態為 `Error validating configuration`。 ![\[裝置 AWS 帳戶、FreeRTOS 實作、PKCS 標籤和 echo 伺服器、over-the-air更新，以及顯示有效狀態的測試執行設定區段的組態畫面。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/modify-existing-configuration.png) 1. 若要修改現有的組態設定，請完成下列步驟： 1. 選擇組態設定的名稱以開啟其設定頁面。 1. 修改設定，然後選擇**儲存**以重新產生對應的組態檔案。 1. 若要修改 IDT for FreeRTOS 測試執行設定，請在編輯檢視中選擇 **IDT 測試執行設定**： ![\[IDT 測試執行設定對話方塊，其中包含測試選擇、略過測試群組、逾時乘數，以及在第一次失敗時停止的選項。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/idt-testrun-settings.png) 修改組態完成後，請確認所有組態設定都通過驗證。如果每個組態設定的狀態為 `Valid`，您可以使用此組態執行資格測試。 # 執行資格測試 為 IDT for FreeRTOS UI 建立組態後，您可以執行資格測試。 **執行資格測試** 1. 在導覽功能表中，選擇**執行測試**。 1. 選擇**開始測試**以開始測試執行。根據預設，會針對您的裝置組態執行所有適用的測試。IDT for FreeRTOS 會在所有測試完成時產生資格報告。 ![\[Device Tester for FreeRTOS 介面顯示尚未執行任何測試，並提供建立新組態、編輯現有組態和執行測試的選項。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/idt-run-tests.png) IDT for FreeRTOS 會執行資格測試。然後，它會在測試執行**器主控台中顯示測試執行**摘要和任何錯誤。測試執行完成後，您可以從下列位置檢視測試結果和日誌： + 測試結果位於 `devicetester-extract-location/results/execution-id`目錄中。 + 測試日誌位於 `devicetester-extract-location/results/execution-id/logs`目錄中。 如需測試結果和日誌的詳細資訊，請參閱 [檢視 IDT for FreeRTOSresults](view-results-lts.md)和 [檢視 IDT for FreeRTOSlogs](view-logs-lts.md)。 ![\[適用於 FreeRTOS 的 Device Tester 執行日誌，顯示通過的測試、測試群組，以及日誌和報告的檔案路徑。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/idt-results.png)