Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Use IDT to develop and run your own test suites

Focus mode
Use IDT to develop and run your own test suites - AWS IoT Greengrass

Starting in IDT v4.0.1, IDT for AWS IoT Greengrass V2 combines a standardized configuration setup and result format with a test suite environment that enables you to develop custom test suites for your devices and device software. You can add custom tests for your own internal validation or provide them to your customers for device verification.

Use IDT to develop and run custom test suites, as follows:

To develop custom test suites
  • Create test suites with custom test logic for the Greengrass device that you want to test.

  • Provide IDT with your custom test suites to test runners. Include information about specific settings configurations for your test suites.

To run custom test suites
  • Set up the device that you want to test.

  • Implement the settings configurations as required by the test suites that you want to use.

  • Use IDT to run your custom test suites.

  • View the test results and execution logs for the tests run by IDT.

Download the latest version of AWS IoT Device Tester for AWS IoT Greengrass

Download the latest version of IDT and extract the software into a location (<device-tester-extract-location>) on your file system where you have read/write permissions.

Note

IDT does not support being run by multiple users from a shared location, such as an NFS directory or a Windows network shared folder. We recommend that you extract the IDT package to a local drive and run the IDT binary on your local workstation.

Windows has a path length limitation of 260 characters. If you are using Windows, extract IDT to a root directory like C:\ or D:\ to keep your paths under the 260 character limit.

Test suite creation workflow

Test suites are composed of three types of files:

  • Configuration files that provide IDT with information about how to run the test suite.

  • Test executable files that IDT uses to run test cases.

  • Additional files required to run tests.

Complete the following basic steps to create custom IDT tests:

  1. Create configuration files for your test suite.

  2. Create test case executables that contain the test logic for your test suite.

  3. Verify and document the configuration information required for test runners to run the test suite.

  4. Verify that IDT can run your test suite and produce test results as expected.

To quickly build a sample custom suite and run it, follow the instructions in Tutorial: Build and run the sample IDT test suite.

To get started creating a custom test suite in Python, see Tutorial: Develop a simple IDT test suite.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.