Using Amazon IoT Device Tester for Amazon IoT Greengrass V1 - Amazon IoT Greengrass
Amazon IoT Greengrass qualification suiteCustom test suites
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

End of support notice: On October 7th, 2026, Amazon will discontinue support for Amazon IoT Greengrass Version 1. After October 7th, 2026, you will no longer be able to access the Amazon IoT Greengrass V1 resources. For more information, please visit Migrate from Amazon IoT Greengrass Version 1.

Using Amazon IoT Device Tester for Amazon IoT Greengrass V1

Amazon IoT Device Tester (IDT) is a downloadable testing framework that lets you validate IoT devices. Because Amazon IoT Greengrass Version 1 has been moved into maintenance mode, IDT for Amazon IoT Greengrass V1 no longer generates signed qualification reports. You will no longer be able to qualify new Amazon IoT Greengrass V1 devices to list in the Amazon Partner Device Catalog through the Amazon Device Qualification Program. However, you can continue to use IDT for Amazon IoT Greengrass V1 to test your Greengrass V1 devices. We recommend that you use IDT for Amazon IoT Greengrass V2 to qualify and list Greengrass devices in the Amazon Partner Device Catalog.

IDT for Amazon IoT Greengrass runs on your host computer (Windows, macOS, or Linux) connected to the device to be tested. It runs tests and aggregates results. It also provides a command line interface to manage the testing process.

Amazon IoT Greengrass qualification suite

Use IDT for Amazon IoT Greengrass to verify that the Amazon IoT Greengrass Core software runs on your hardware and can communicate with the Amazon Web Services Cloud. It also performs end-to-end tests with Amazon IoT Core. For example, it verifies that your device can send and receive MQTT messages and process them correctly.

An overview of how the Amazon IoT Device Tester verifies that the Amazon IoT Greengrass core software runs on your hardware and can communicate with the Amazon Web Services Cloud.

Amazon IoT Device Tester for Amazon IoT Greengrass organizes tests using the concepts of test suites and test groups.

  • A test suite is the set of test groups used to verify that a device works with particular versions of Amazon IoT Greengrass.

  • A test group is the set of individual tests related to a particular feature, such as Greengrass group deployments and MQTT messaging.

For more information, see Use IDT to run the Amazon IoT Greengrass qualification suite.

Custom test suites

Starting in IDT v4.0.0, IDT for Amazon IoT Greengrass 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.

How a test writer configures a custom test suite determines the settings configurations that are required to run custom test suites. For more information, see Use IDT to develop and run your own test suites.