Supported versions of 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.

Supported versions of Amazon IoT Device Tester for Amazon IoT Greengrass V1

Because Amazon IoT Greengrass Version 1 has been moved into maintenance mode, IDT for Amazon IoT Greengrass V1 no longer generates signed qualification reports. We recommend that you use IDT for Amazon IoT Greengrass V2.

For information about IDT for Amazon IoT Greengrass V2, see Using Amazon IoT Device Tester for Amazon IoT Greengrass V2 in the Amazon IoT Greengrass V2 Developer Guide.

Note

You receive a notification when you start a test run if IDT for Amazon IoT Greengrass is not compatible with the version of Amazon IoT Greengrass you are using.

By downloading the software, you agree to the Amazon IoT Device Tester License Agreement.

Unsupported IDT versions for for Amazon IoT Greengrass

This topic lists unsupported versions of IDT for Amazon IoT Greengrass. Unsupported versions do not receive bug fixes or updates. For more information, see Support policy for Amazon IoT Device Tester for Amazon IoT Greengrass V1.

IDT v4.4.1 for Amazon IoT Greengrass versions v1.11.6, v1.10.5
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass core software v1.11.6 and v1.10.5.

  • Contains minor bug fixes.

Test suite version:
GGQ_1.3.1
  • Released 2021.12.20

IDT v4.1.0 for Amazon IoT Greengrass versions v1.11.4, v1.10.4
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass core software v1.11.4 and v1.10.4.

  • Fixes an issue that caused the logs that are displayed during a test run to use redundant tags.

Test suite version:
GGQ_1.3.0
  • Released 2021.06.23

  • Adds retries for API calls to Lambda, IAM, and Amazon STS to improve handling for throttling or server issues.

  • Adds support for Python 3.8 to the ML and Docker test cases.

IDT v4.0.2 for Amazon IoT Greengrass versions v1.11.1, v1.11.0, v1.10.3

Release notes:

  • Fixed an issue that caused IDT to mask Hardware Security Integration (HSI) errors.

  • Enables you to develop and run your custom test suites using Amazon IoT Device Tester for Amazon IoT Greengrass. For more information, see Use IDT to develop and run your own test suites.

  • Provides code signed IDT applications for macOS and Windows. In macOS, if a security warning message displays, you might need to grant a security exception for IDT. For more information, see Security exception on macOS.

Note

Amazon IoT Greengrass doesn't provide a Dockerfile or a Docker image for version 1.11.1 of the Amazon IoT Greengrass core software. To test your device for Docker qualification, use an earlier version of Amazon IoT Greengrass core software.

 

IDT v3.2.0 for Amazon IoT Greengrass versions v1.11.0, v1.10.1, v1.10.0

Release notes:

  • By default, IDT runs only required tests for qualification. To qualify for additional features, you can modify the device.json file.

  • Added a port number in device.json that you can configure for SSH connections.

  • Docker supports only stream manager and machine learning (ML) without containerization. Container, Docker, and Hardware Security Integration (HSI) are not available for Docker devices.

  • We merged device-ml.json and device-hsm.json into device.json.

 

IDT v3.1.3 for Amazon IoT Greengrass versions: v1.10.x, v1.9.x, v1.8.x

Release notes:

  • Added support for ML feature qualification for Amazon IoT Greengrass v1.10.x and v1.9.x. You can now use IDT to validate that your devices can perform ML inference locally with models stored and trained in the cloud.

  • Added --stop-on-first-failure for the run-suite command. You can use this option to configure IDT to stop running on the first failure. We recommend using this option during the debugging stage at the test groups level.

  • Added a clock drift check for MQTT tests to ensure that the device under test uses the correct system time. The time used must be within an acceptable time range.

  • Added --update-idt for the run-suite command. You can use this option to set the response for the prompt to update IDT.

  • Added --update-managed-policy for the run-suite command. You can use this option to set the response for the prompt to update the managed policy.

  • Added a bug fix for automatic updates of IDT test suite versions. The fix ensures that IDT can run the latest test suites that are available for your Amazon IoT Greengrass version.

 

IDT v3.0.1 for Amazon IoT Greengrass

Release notes:

  • Added support for Amazon IoT Greengrass v1.10.1.

  • Automatic updates of IDT test suite versions. IDT can download the latest test suites that are available for your Amazon IoT Greengrass version. With this feature:

    • Test suites are versioned using a major.minor.patch format. The initial test suite version is GGQ_1.0.0.

    • You can download new test suites interactively in the command line interface or set the upgrade-test-suite flag when you start IDT.

    For more information, see Test suite versions.

  • Added list-supported-products. You can use this command to list the Amazon IoT Greengrass and test suite versions that are supported by the installed version of IDT.

  • Added list-test-cases. You can use this command to list the test cases that are available in a test group.

  • Added test-id for the run-suite command. You can use this option to run individual test cases in a test group.

 

IDT v2.3.0 for Amazon IoT Greengrass v1.10, v1.9.x, and v1.8.x

When testing on a physical device, Amazon IoT Greengrass v1.10, v1.9.x, and v1.8.x are supported.

When testing in a Docker container, Amazon IoT Greengrass v1.10 and v1.9.x are supported.

Release notes:

  • Added support for Running Amazon IoT Greengrass in a Docker container. You can now use IDT to qualify and validate that your devices can run Amazon IoT Greengrass in a Docker container.

  • Added an Amazon managed policy (AWSIoTDeviceTesterForGreengrassFullAccess) that defines the permissions required to run Amazon IoT Device Tester. If new releases require additional permissions, Amazon adds them to this managed policy so you don't have to update your IAM permissions.

  • Introduced checks to validate that your environment (for example, device connectivity and internet connectivity) is set up correctly before you run the test cases.

  • Improved the Greengrass dependency checker in IDT to make it more flexible while checking for libc on devices.

 

IDT v2.2.0 for Amazon IoT Greengrass v1.10, v1.9.x, and v1.8.x

Release notes:

 

IDT v2.1.0 for Amazon IoT Greengrass v1.9.x, v1.8.x, and v1.7.x

Release notes:

  • Added support for Amazon IoT Greengrass v1.9.4.

  • Added support for Linux-ARMv6l devices.

 

IDT v2.0.0 for Amazon IoT Greengrass v1.9.3, v1.9.2, v.1.9.1, v1.9.0, v1.8.4, v1.8.3, and v1.8.2

Release notes:

  • Removed dependency on Python for device under test.

  • Test suite execution time reduced by more than 50 percent, which makes the qualification process faster.

  • Executable size reduced by more than 50 percent, which makes download and installation faster.

  • Improved timeout multiplier support for all test cases.

  • Enhanced post-diagnostics messages to troubleshoot errors faster.

  • Updated the permissions policy template required to run IDT.

  • Added support for Amazon IoT Greengrass v1.9.3.

 

IDT v1.3.3 for Amazon IoT Greengrass v1.9.2, v1.9.1, v1.9.0, v1.8.3, and v1.8.2

Release notes:

  • Added support for Greengrass v1.9.2 and v1.8.3.

  • Added support for Greengrass OpenWrt.

  • Added SSH user name and password device sign-in.

  • Added native test bug fix for OpenWrt-ARMv7l platform.

 

IDT v1.2 for Amazon IoT Greengrass v1.8.1

Release notes:

  • Added a configurable timeout multiplier to address and troubleshoot timeout issues (for example, low bandwidth connections).

 

IDT v1.1 for Amazon IoT Greengrass v1.8.0

Release notes:

  • Added support for Amazon IoT Greengrass Hardware Security Integration (HSI).

  • Added support for Amazon IoT Greengrass container and no container.

  • Added automated Amazon IoT Greengrass service role creation.

  • Improved test resource cleanup.

  • Added test execution summary report.

 

IDT v1.1 for Amazon IoT Greengrass v1.7.1

Release notes:

  • Added support for Amazon IoT Greengrass Hardware Security Integration (HSI).

  • Added support for Amazon IoT Greengrass container and no container.

  • Added automated Amazon IoT Greengrass service role creation.

  • Improved test resource cleanup.

  • Added test execution summary report.

 

IDT v1.0 for Amazon IoT Greengrass v1.6.1

Release notes:

  • Added OTA test bug fix for future Amazon IoT Greengrass version compatibility.

Note

If you're using IDT v1.0 for Amazon IoT Greengrass v1.6.1, you must create a Greengrass service role. In later versions, IDT creates the service role for you.