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

# 在主控台中開始使用 Device Advisor
<a name="da-console-guide"></a>

本教學課程可協助您在 主控台 AWS IoT Core Device Advisor 上開始使用 。Device Advisor 提供必要測試和已簽署的資格報告等功能。您可以使用這些測試和報告，來限定並列出 [AWS Partner Device Catalog](https://devices.amazonaws.com/) 中的裝置，如 [AWS IoT Core 資格計畫](https://aws.amazon.com/partners/dqp/)所詳述。

如需使用 Device Advisor 的詳細資訊，請參閱 [Device Advisor 工作流程](device-advisor-workflow.md) 和 [Device Advisor 詳細主控台工作流程](device-advisor-console-tutorial.md)。

若要完成此教學課程，請遵循 [設定](device-advisor-setting-up.md) 中概述的步驟。

**注意**  
下列支援 Device Advisor AWS 區域：  
美國東部 (維吉尼亞北部)
美國西部 (奧勒岡)
亞太地區 (東京)
歐洲 (愛爾蘭)

**開始使用**

1. 在 [AWS IoT 主控台](https://console.aws.amazon.com//iot)導覽窗格的**測試**下，選擇 **Device Advisor**。然後，選擇主控台上的**開始演練**按鈕。  
![\[Device Advisor 是 IoT 裝置的完整受管測試功能，可驗證與 的安全互動 AWS IoT Core、識別軟體問題，以及取得測試結果。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-gs.png)

1. **開始使用 Device Advisor** 頁面概述建立測試套件和針對您裝置執行測試所需的步驟。您也可以在這裡針對您的帳戶尋找 Device Advisor 測試端點。您必須在用於測試的裝置上設定韌體或軟體，才能連線到此測試端點。

   若要完成本教學課程，請先[建立物件和憑證](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html#da-create-thing-certificate)。在您檢閱**運作方式**下的資訊之後，請選擇**下一步**。  
![\[測試 IoT 裝置連線的步驟：選取通訊協定、建立測試套件、設定裝置設定。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-gs1.png)

1.  在**步驟 1：選取通訊協定**中，從列出的選項中選取通訊協定。然後選擇**下一步**。  
![\[Device Advisor 介面顯示選擇通訊協定的選項 (MQTT 3.1.1、透過 WebSocket 的 MQTT 3.1.1、MQTT 5、透過 WebSocket 的 MQTT 5)，用於測試 IoT 裝置。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-protocol.png)

1. 在 **Step 2** (步驟 2) 中，您可以建立和設定自訂測試套件。一個自訂測試套件必須至少具有一個測試群組，而且每個測試群組必須至少具有一個測試案例。我們已新增 **MQTT Connect** 測試案例，供您開始使用。

   選擇 **Test suite properties** (測試套件屬性)。  
![\[Device Advisors 中的「建立測試套件」畫面，使用者可以在其中建立和設定測試群組和案例，以使用 MQTT 通訊協定測試 IoT 裝置。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-test-suite-create.png)

   當您建立測試套件時，請提供測試套件屬性。您可以設定以下套件層級屬性：
   + **Test suite name** (測試套件名稱)：輸入測試套件名稱。
   + **逾時** (選用)：目前測試套件中每個測試案例的逾時 (以秒為單位)。如果您未指定逾時值，則系統會使用預設值。
   + **Tags** (標籤) (選用)：將標籤新增至測試套件。

   完成後，請選擇 **Update properties** (更新屬性)。  
![\[更新測試套件屬性的表單，包括名稱、逾時和新增標籤的能力。包含「更新屬性」按鈕。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-test-suite-properties.png)

1. (選用) 若要更新測試套件群組組態，請選擇測試群組名稱旁邊的**編輯**按鈕。
   + **Name** (名稱)：輸入測試套件群組的自訂名稱。
   + **逾時** (選用)：目前測試套件中每個測試案例的逾時 (以秒為單位)。如果您未指定逾時值，則系統會使用預設值。

   完成時，請選擇**完成**以繼續。  
![\[會顯示名為「測試群組 1」的測試群組，其中包含設定逾時和新增更多測試群組的選項。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-test-suite-config.png)

1. (選用) 若要更新測試案例的測試案例組態，請選擇測試案例名稱旁邊的**編輯**按鈕。
   + **Name** (名稱)：輸入測試套件群組的自訂名稱。
   + **逾時** (選用)：所選測試案例的逾時 (以秒為單位)。如果您未指定逾時值，則系統會使用預設值。

   完成時，請選擇**完成**以繼續。  
![\[「建立測試套件」界面，顯示設定測試套件、測試群組和個別測試案例以測試 IoT 裝置的選項。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-test-case-config.png)

1. (選用) 若要將更多測試群組新增至測試套件，請選擇**新增測試群組**，然後遵循步驟 5 中的指示。

1. (選用) 若要新增更多測試案例，請將**測試案例**區段中的測試案例拖曳至到您的任何測試群組。  
![\[「建立測試套件」界面，使用者可以在其中設定測試群組和測試案例，以測試 IoT 裝置的 MQTT 通訊協定。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-drag.png)

1. 您可以變更測試群組和測試案例的順序。若要進行變更，請在清單中將列出的測試案例向上或向下拖曳。Device Advisor 會依照您列出測試的順序執行這些測試。

   在設定了您的測試套件之後，請選擇 **Next** (下一步)。

1. 在**步驟 3** 中，選取要使用 Device Advisor 測試的 AWS IoT 物件或憑證。如果沒有任何現有物件或憑證，請參閱[設定](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html)。  
![\[組態選項包括選取通訊協定、建立測試套件、設定裝置設定，以及檢閱測試執行和結果。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-device-settings.png)

1. 您可以設定 Device Advisor 用來代表測試裝置執行 AWS IoT MQTT 動作的裝置角色。僅針對 **MQTT Connect** 測試案例，才會自動選取 **Connect** 動作。這是因為裝置角色需要此許可才能執行測試套件。對於其他測試案例，系統會選取對應的動作。

   提供每個選取動作的資源值。例如，對於 **Connect** 動作，請提供裝置用來連線至 Device Advisor 端點的用戶端 ID。您可以使用逗號分隔值提供多個值，並以萬用字元 (\$1) 作為這些值的字首。例如，若要對以 `MyTopic` 為開頭的任何主題提供發佈許可，請輸入 **MyTopic\$1** 作為資源值。  
![\[Device Advisor 介面可讓您選取裝置角色，並定義連線、發佈、訂閱和管理 MQTT 主題和用戶端 IDs許可。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-device-role.png)

   若要從[設定](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html)使用先前建立的裝置角色，請選擇**選取現有角色**。然後在**選取角色**下選擇您的裝置角色。  
![\[用於選取裝置角色的 Web 表單界面，具有建立新角色或選取名為「DeviceAdvisorServiceRole」之現有角色的選項。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-select-device-role.png)

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

1. 在**測試端點**區段中，選取最適合使用案例的端點。若要使用相同的 同時執行多個測試套件 AWS 帳戶，請選取**裝置層級端點**。若要一次執行一個測試套件，請選取**帳戶層級端點**。  
![\[選取帳戶層級或裝置層級端點以供測試的選項，並提供端點 URL 和下一步按鈕。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-endpoint.png)

1. **步驟 4** 顯示所選測試裝置、測試端點、測試套件，以及所設定之測試裝置角色的概觀。若要對區段進行變更，請為要編輯的區段選擇**編輯**按鈕。一旦確認了您的測試組態，請選擇**執行**來建立測試套件並執行您的測試。
**注意**  
如需最佳結果，您可以在開始執行測試套件之前，將選取的測試裝置連線至 Device Advisor 測試端點。我們建議您為裝置建置一個機制，每隔五秒嘗試連接到我們的測試端點，最多持續一到兩分鐘。  
![\[裝置組態主控台，顯示裝置角色詳細資訊、測試端點，以及取消、返回或執行的選項。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-device-review.png)  
![\[裝置組態主控台，顯示裝置角色詳細資訊、測試端點，以及取消、返回或執行的選項。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-device-review-contd.png)

1. 在導覽窗格的**測試**下，選擇 **Device Advisor**，然後選擇**測試執行和結果**。選取測試套件執行，以檢視其執行詳細資訊和記錄。  
![\[表示裝置 "MyThing" 正在進行 MQTT 3.1.1 測試的測試套件界面。\]](http://docs.aws.amazon.com/zh_tw/iot/latest/developerguide/images/da-console-runs-results.png)

1. 若要存取套件執行的 Amazon CloudWatch Logs：
   + 選擇 **Test suite log** (測試套件記錄)，以檢視測試套件執行的 CloudWatch 記錄。
   + 選擇任何測試案例的 **Test case log** (測試案例記錄)，以檢視測試案例特定的 CloudWatch 記錄。

1. 根據您的測試結果，[疑難排解](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html#device-advisor-troubleshooting)您的裝置，直到所有測試都通過。