Using Amazon IoT Device Tester for Amazon IoT Greengrass V1 - Amazon IoT Greengrass
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).

Amazon IoT Greengrass Version 1 entered the extended life phase on June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. After this date, Amazon IoT Greengrass V1 won't release updates that provide features, enhancements, bug fixes, or security patches. Devices that run on Amazon IoT Greengrass V1 won't be disrupted and will continue to operate and to connect to the cloud. We strongly recommend that you migrate to Amazon IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

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.