# Getting started with Device Advisor in the console
<a name="da-console-guide"></a>

This tutorial helps you get started with AWS IoT Core Device Advisor on the console. Device Advisor offers features such as required tests and signed qualification reports. You can use these tests and reports to qualify and list devices in the [AWS Partner Device Catalog](https://devices.amazonaws.com/) as detailed in the [AWS IoT Core qualification program](https://aws.amazon.com/partners/dqp/).

For more information about using Device Advisor, see [Device Advisor workflow](device-advisor-workflow.md) and [Device Advisor detailed console workflow](device-advisor-console-tutorial.md).

To complete this tutorial, follow the steps outlined in [Setting up](device-advisor-setting-up.md).

**Note**  
Device Advisor is supported in the following AWS Regions:  
US East (N. Virginia)
US West (Oregon)
Asia Pacific (Tokyo)
Europe (Ireland)

**Getting started**

1. In the [AWS IoT console's](https://console.aws.amazon.com//iot) navigation pane under **Test**, choose **Device Advisor**. Then, choose the **Start walkthrough** button on the console.  
![\[Device Advisor is a fully managed test capability for IoT devices to validate secure interaction with AWS IoT Core, identify software issues, and get test results.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-gs.png)

1. The **Getting started with Device Advisor** page provides an overview of the steps required to create a test suite and run tests against your device. You can also find the Device Advisor test endpoint for your account here. You must configure the firmware or software on the device used for testing to connect to this test endpoint.

   To complete this tutorial, first [ create a thing and certificate](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html#da-create-thing-certificate). After you review the information under **How it works**, choose **Next**.  
![\[Steps to test IoT devices' connectivity: select protocol, create test suite, configure device settings.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-gs1.png)

1.  In **Step 1: Select a protocol**, select a protocol from the options listed. Then, choose **Next**.  
![\[Device Advisor interface showing options to select a communication protocol (MQTT 3.1.1, MQTT 3.1.1 over WebSocket, MQTT 5, MQTT 5 over WebSocket) for testing an IoT device.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-protocol.png)

1. In **Step 2**, you create and configure a custom test suite. A custom test suite must have at least one test group, and each test group must have at least one test case. We've added the **MQTT Connect** test case for you to get started.

   Choose **Test suite properties**.   
![\[The "Create test suite" screen in Device Advisors, where users can create and configure test groups and cases for testing IoT devices with MQTT protocol.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-test-suite-create.png)

   Supply the test suite properties when you create your test suite. You can configure the following suite-level properties:
   + **Test suite name**: Enter a name for your test suite.
   + **Timeout** (optional): The timeout (in seconds) for each test case in the current test suite. If you don't specify a timeout value, the default value is used.
   + **Tags** (optional): Add tags to the test suite.

   When you’ve finished, choose **Update properties**.  
![\[Form to update properties of a test suite, including name, timeout, and ability to add tags. Contains a "Update properties" button.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-test-suite-properties.png)

1. (Optional) To update the test suite group configuration, choose the **Edit** button next to the test group name.
   + **Name**: Enter a custom name for the test suite group.
   + **Timeout** (optional): The timeout (in seconds) for each test case in the current test suite. If you don't specify a timeout value, the default value is used.

   When finished, choose **Done** to continue.  
![\[A test group named "Test group 1" is displayed with options to configure timeout and add more test groups.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-test-suite-config.png)

1. (Optional) To update the test case configuration for a test case, choose the **Edit** button next to the test case name.
   + **Name**: Enter a custom name for the test suite group.
   + **Timeout** (optional): The timeout (in seconds) for the selected test case. If you don't specify a timeout value, the default value is used.

   When finished, choose **Done** to continue.  
![\[The "Create test suite" interface that shows options to configure a test suite, test groups, and individual test cases for testing IoT devices.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-test-case-config.png)

1. (Optional) To add more test groups to the test suite, choose **Add test group**, then follow the instructions in Step 5.

1. (Optional) To add more test cases, drag the test cases in the **Test cases** section into any of your test groups.  
![\[The "Create test suite" interface where users can configure test groups and test cases for MQTT protocol testing of IoT devices.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-drag.png)

1. You can change the order of your test groups and test cases. To make changes, drag the listed test cases up or down the list. Device Advisor runs tests in the order you listed them in.

   After you've configured your test suite, choose **Next**.

1. In **Step 3**, select an AWS IoT thing or certificate to test using Device Advisor. If you don't have any existing things or certificates, see [Setting up](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html).   
![\[The configuration options that include selecting a protocol, creating a test suite, configuring device settings, and reviewing test runs and results.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-device-settings.png)

1. You can configure a device role that Device Advisor uses to perform AWS IoT MQTT actions on behalf of your test device. For **MQTT Connect** test case only, the **Connect** action is selected automatically. This is because the device role requires this permission to run the test suite. For other test cases, the corresponding actions are selected. 

   Provide the resource values for each of the selected actions. For example, for the **Connect** action, provide the client ID your device uses to connect to the Device Advisor endpoint. You can provide multiple values with comma seperated values, and prefix values with a wildcard (\$1) character. For example, to provide permission to publish on any topic beginning with `MyTopic`, enter **MyTopic\$1** as the resource value.  
![\[The Device Advisor interface where you can select a device role and define permissions for connecting, publishing, subscribing, and managing MQTT topics and client IDs.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-device-role.png)

   To use a previously created device role from [Setting up](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html), choose **Select an existing role**. Then choose your device role under **Select role**.  
![\[A web form interface for selecting a device role, with options to create a new role or select an existing role named "DeviceAdvisorServiceRole".\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-select-device-role.png)

   Configure your device role with one of the two provided options, and then choose **Next**.

1. In the **Test endpoint** section, select the endpoint that best fits your use case. To run multiple test suites simultaneously with the same AWS account, select **Device-level endpoint**. To run one test suite at a time, select **Account-level endpoint**.  
![\[Options to select Account-level or Device-level endpoint for testing, with an endpoint URL provided and Next button.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-endpoint.png)

1. **Step 4** shows an overview of the selected test device, test endpoint, test suite, and test device role configured. To make changes to a section, choose the **Edit** button for the section you want to edit. Once you've confirmed your test configuration, choose **Run** to create the test suite and run your tests.
**Note**  
For best results, you can connect your selected test device to the Device Advisor test endpoint before you start the test suite run. We recommend that you have a mechanism built for your device to try connecting to our test endpoint every five seconds for up to one to two minutes.  
![\[A device configuration console that shows device role details, test endpoint, and options to cancel, go back, or run.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-device-review.png)  
![\[A device configuration console that shows device role details, test endpoint, and options to cancel, go back, or run.\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-device-review-contd.png)

1. In the navigation pane under **Test**, choose **Device Advisor**, and then choose **Test runs and results**. Select a test suite run to view its run details and logs.  
![\[The test suite interface that indicates an MQTT 3.1.1 test is in progress for the device "MyThing".\]](http://docs.aws.amazon.com/iot/latest/developerguide/images/da-console-runs-results.png)

1. To access the Amazon CloudWatch logs for the suite run:
   + Choose **Test suite log** to view the CloudWatch logs for the test suite run.
   + Choose **Test case log** for any test case to view test case-specific CloudWatch logs.

1. Based on your test results, [troubleshoot](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html#device-advisor-troubleshooting) your device until all tests pass.