Using AWS IoT Device Tester for AWS IoT Greengrass V1 - AWS IoT Greengrass

AWS IoT Greengrass Version 1 entered the extended life phase on June 30, 2023. For more information, see the AWS IoT Greengrass V1 maintenance policy. After this date, AWS IoT Greengrass V1 won't release updates that provide features, enhancements, bug fixes, or security patches. Devices that run on AWS 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 AWS IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

Using AWS IoT Device Tester for AWS IoT Greengrass V1

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

IDT for AWS 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.

AWS IoT Greengrass qualification suite

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

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

AWS IoT Device Tester for AWS 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 AWS 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 AWS IoT Greengrass qualification suite.

Custom test suites

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