Device Advisor 詳細主控台工作流程 - AWS IoT Core

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Device Advisor 詳細主控台工作流程

在此教學課程中,您已建立自訂測試套件,並針對您要在主控台中測試的裝置執行測試。在測試完成之後,您可以檢視測試結果和詳細記錄。

必要條件

為完成此教學課程,您需要建立物件和憑證

建立測試套件定義

  1. AWS IoT 主控台的導覽窗格中,展開 Test (測試)、Device Advisor,然後選擇 Test suites (測試套件)。

    Device Advisor 介面提供選項,可為合格裝置建立測試套件、執行長時間測試,以及自訂測試套件。

    選擇 Create Test Suite (建立測試套件)。

  2. 擇一選取 Use the AWS Qualification test suite 或者 Create a new test suite

    對於通訊協定,請選擇 MQTT 3.1.1MQTT 5

    「創建測試套件」,其中包含選擇測試套件類型(AWS IoT Core 合格,長期或自定義)和協議(MQTT 3.1.1 或 MQTT 5)的選項。

    選取Use the AWS Qualification test suite以符合資格,並將您的裝置列入 AWS 合作夥伴裝置目錄。透過選擇此選項,根據 AWS IoT Core 資格計劃限定您裝置所需的測試案例是預先選取的。無法新增或移除測試群組和測試案例。不過,您仍然需要設定測試套件屬性。

    選取 Create a new test suite 來建立和設定自訂測試套件。我們建議您從這個選項開始進行初始測試和疑難排解。一個自訂測試套件必須至少具有一個測試群組,而且每個測試群組必須至少具有一個測試案例。基於本教學課程的目的,我們將選取此選項並選擇 Next (下一步)。

    設定測試套件頁面,其中顯示建立測試套件的步驟,其中包含測試群組和案例以測試 IoT 裝置。
  3. 選擇 Test suite properties (測試套件屬性)。必須在建立測試套件時建立測試套件屬性。

    「配置測試套件」界面,顯示用於創建測試組和添加測試用例以測試 IoT 設備功能的選項。

    Test suite properties (測試套件屬性) 下,請填寫下列資訊:

    • Test suite name (測試套件名稱):您可以使用自訂名稱建立套件。

    • Timeout (逾時) (選用):目前測試套件中每個測試案例的逾時 (以秒為單位)。如果您未指定逾時值,則系統會使用預設值。

    • Tags (標籤) (選用):將標籤新增至測試套件。

    標題為「測試套件屬性」的視窗,顯示用於指定「裝置建議程式」示範套件之測試套件名稱、逾時和自訂標籤的欄位。

    完成後,請選擇 Update properties (更新屬性)。

  4. 若要修改群組層級組態,請在 Test group 1 下,選擇 Edit (編輯)。接著,輸入 Name (名稱),為群組提供自訂名稱。

    您也可以選擇性地在選取的測試群組下輸入 Timeout (逾時) 值 (以秒為單位)。如果您未指定逾時值,則系統會使用預設值。

    「配置測試套件」界面,用於創建測試組和案例以驗證 IoT 設備功能。

    選擇 Done (完成)

  5. 將其中一個可用的測試案例從 Test cases (測試案例) 拖曳至測試群組。

    用於在 Device Advisor 中建立測試套件的組態介面,其中包含新增測試群組和測試案例以測試 IoT 裝置的選項。
  6. 若要為新增至測試群組的測試案例修改測試案例層級組態,請選擇 Edit (編輯)。接著,輸入 Name (名稱),為群組提供自訂名稱。

    您也可以選擇性地在選取的測試群組下輸入 Timeout (逾時) 值 (以秒為單位)。如果您未指定逾時值,則系統會使用預設值。

    測試套件配置界面,其中包含用於配置測試組,測試用例,超時設置和測試套件執行的起點的選項。

    選擇 Done (完成)

    注意

    若要將更多測試群組新增至測試套件,請選擇 Add test group (新增測試群組)。依照上述步驟建立和設定更多測試群組,或將更多測試案例新增至一或多個測試群組。選擇測試案例並將其拖曳至所需位置,即可將測試群組和測試案例重新排序。Device Advisor 會依您定義測試群組和測試案例的順序執行測試。

  7. 選擇下一步

  8. 步驟 3 中,設定裝置角色,裝置建議程式將用來代表您的測試裝置執行 AWS IoT MQTT 動作。

    如果僅在 Step 2 (步驟 2) 中選取 MQTT Connect 測試案例,系統會自動檢查 Connect (連接) 動作,因為裝置角色需要該許可才能執行此測試套件。如果選取了其他測試案例,系統會檢查相應的必要動作。確保已為每個動作提供資源值。例如,對於 Connect (連接) 動作,請提供裝置在連接至 Device Advisor 端點所用的用戶端 ID。可以使用逗號分隔值的方式提供多個值,也可以使用萬用字元 (*) 字元來提供字首值。若要提供以 MyTopic 為開頭的主題發佈許可,則可提供 MyTopic* 作為資源值。

    Device Advisor 中用於建立測試套件的「選取裝置角色」步驟,其中包含建立新角色或選取現有角色的選項,以及用於指定角色名稱、權限和資源詳細資訊的欄位。

    如果先前已建立裝置角色,而且希望使用該角色,請選擇 Select an existing role (選取現有角色),然後在 Select role (選取角色) 下選擇裝置角色。

    用於為「裝置建議程式」測試選取裝置角色的頁面,其中包含建立新角色或選取現有角色的選項。

    使用提供的兩個選項之一來設定裝置角色,然後選擇 Next (下一步)。

  9. Step 4 (步驟 4),請確保每個步驟中提供的組態正確無誤。若要編輯針對特定步驟提供的組態,請選擇 Edit (編輯) 來取得相應的步驟。

    確認組態之後,請選擇 Create test suite (建立測試套件)。

    應該成功建立測試套件,並且您將被重新導向到 Test suites (測試套件) 頁面,在這裡您可以檢視所有已建立的測試套件。

    如果建立測試套件失敗,請確保已根據先前的指示,設定測試套件、測試群組、測試案例和裝置角色。

啟動測試套件執行

  1. AWS IoT 主控台的導覽窗格中,展開 Test (測試)、Device Advisor,然後選擇 Test suites (測試套件)。

  2. 選擇您要檢視哪個測試套件的詳細資訊。

    顯示於 2021 年 5 月 11 日創建的單個測試套件,名為「設備顧問演示套件」的控制台。

    測試套件詳細資訊頁面會顯示與測試套件相關的所有資訊。

  3. 選擇 Actions (動作),然後 Run test suite (執行測試套件)。

    帶有「運行測試套件」按鈕和顯示以前沒有運行測試套件的空活動日誌的演示套件頁面。
  4. 在 [執行組態] 下,您需要選取要使用 [裝置建議程式] 測試的 AWS IoT 物件或憑證。如果您沒有任何現有的東西或證書,請先創建 AWS IoT Core 資源

    Test endpoint (測試端點) 區段中,選取最適合案例的端點。如果您計劃 future 使用同一 AWS 帳戶同時執行多個測試套件,請選取裝置層級端點。如果打算一次只執行一個測試套件,請選取 Account-level endpoint (帳戶層級端點)。

    使用選取的 Device Advisor 測試端點來設定測試裝置。

    選取物件或憑證並選擇 Device Advisor 端點後,請選擇 Run test (執行測試)。

    執行測試套件的組態 AWS IoT Core,可讓您選取測試裝置 (物件或憑證)、選擇測試端點 (帳戶層級或裝置層級),以及選擇性地新增標籤。
  5. 選擇頂端橫幅上的 Go to results (前往結果),以檢視測試執行詳細資訊。

    標題為「設備顧問演示套件」的自定義測試套件的詳細信息正在進行,狀態為「待定」。

停止測試套件執行 (選用)

  1. AWS IoT 主控台的導覽窗格中,展開 Test (測試)、Device Advisor,然後選擇 Test runs and results (測試執行和結果)。

  2. 選擇您要停止的進行中測試套件。

    測試結果會在「裝置建議程式」主控台上執行。
  3. 選擇 Actions (動作),然後 Stop test suite (停止測試套件)。

    測試結果會在「裝置建議程式」主控台上執行。
  4. 此清除程序需要幾分鐘的時間來完成。當清除程序執行時,測試執行狀態將為 STOPPING。等待清除程序完成,且測試套件狀態變更為 STOPPED 狀態,再開始新的套件執行。

    已停止的測試結果會在「裝置建議程式」主控台上執行。

檢視測試套件執行詳細資訊和記錄

  1. AWS IoT 主控台的導覽窗格中,展開 Test (測試)、Device Advisor,然後選擇 Test runs and results (測試執行和結果)。

    此頁面顯示:

    • IoT 物件的數目

    • IoT 憑證的數目

    • 目前執行的測試套件數目

    • 所有已建立的測試套件執行

  2. 選擇您要檢視哪個測試套件的執行詳細資訊和記錄。

    「測試執行和結果」區段,顯示目前正在進行的測試套件「Device Advisor 示範套件」的詳細資料。

    執行摘要頁面會顯示目前測試套件執行的狀態。此頁面每隔 10 秒自動重新整理一次。我們建議您為裝置建置一個機制,每隔五秒嘗試連接到我們的測試端點,持續一到兩分鐘。然後,您可以採取自動方式依序執行多個測試用例。

    測試案例日誌顯示成功的 MQTT Connect 測試,但未顯示任何系統訊息。
  3. 要訪問測試套件運行的 CloudWatch 日誌,請選擇測試套件日誌

    要訪問任何測試用例的 CloudWatch 日誌,請選擇測試用例日誌

  4. 根據您的測試結果,疑難排解您的裝置,直到所有測試都通過。

下載 AWS IoT 資格報告

如果您在建立測試套件時選擇了使用 AWS IoT 資格測試套件選項,並且能夠執行資格測試套件,則可以在測試回合摘要頁面中選擇 [下載資格報告] 來下載資格報告。

資格計畫測試結果,顯示 MQTT、TLS 和其他元件的通過測試。