Supported versions of Amazon IoT Device Tester for Amazon IoT Greengrass V2 - 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).

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

This topic lists supported versions of IDT for Amazon IoT Greengrass V2. As a best practice, we recommend that you use the latest version of IDT for Amazon IoT Greengrass V2 that supports your target version of Amazon IoT Greengrass V2. New releases of Amazon IoT Greengrass might require you to download a new version of IDT for Amazon IoT Greengrass V2. You receive a notification when you start a test run if IDT for Amazon IoT Greengrass V2 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.

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.

Latest IDT version for Amazon IoT Greengrass V2

You can use this version of IDT for Amazon IoT Greengrass V2 with the Amazon IoT Greengrass version listed here.

IDT v4.9.2 for Amazon IoT Greengrass
Supported Amazon IoT Greengrass versions:
IDT software downloads:
  • IDT v4.9.2 with test suite GGV2Q_2.5.2 for Linux

  • IDT v4.9.2 with test suite GGV2Q_2.5.2 for macOS

  • IDT v4.9.2 with test suite GGV2Q_2.5.2 for Windows

Release notes:
  • Fixes an issue where the Lambda test suite fails due to Java 8 being deprecated.

Additional notes:
  • If your device uses a HSM and you are using nucleus 2.10.x, migrate to Greengrass nucleus version 2.11.0 or later.

Test suite version:
GGV2Q_2.5.2
  • Released 2024.03.18

Unsupported versions of Amazon IoT Device Tester for Amazon IoT Greengrass V2

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

IDT v4.9.1 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software versions 2.12.0, 2.11.0, 2.10.0, and 2.9.5.

  • Minor bug fixes.

Test suite version:
GGV2Q_2.5.1
  • Released 2023.10.05

IDT v4.7.0 for Amazon IoT Greengrass
Supported Amazon IoT Greengrass versions:
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software versions 2.11.0, 2.10.0, and 2.9.5.

  • Adds support to store IDT userdata values in Amazon Systems Manager Parameter Store and fetch them into configuration using placeholder syntax.

  • Minor bug fixes.

Test suite version:
GGV2Q_2.5.0
  • Released 2022.12.13

IDT v4.5.11 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software versions 2.9.1, 2.9.0, 2.8.1, 2.8.0, 2.7.0, and 2.6.0.

  • Adds support to test PreInstalled Greengrass on a core device.

  • Minor bug fixes.

Test suite version:
GGV2Q_2.4.1
  • Released 2022.10.13

IDT v4.5.8 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software versions 2.7.0, 2.6.0, and 2.5.6.

  • Enables you to test with PreInstalled Greengrass on a core device.

  • Minor bug fixes.

Test suite version:
GGV2Q_2.4.0
  • Released 2022.08.12

IDT v4.5.3 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software versions 2.7.0, 2.6.0, 2.5.6, 2.5.5, 2.5.4, and 2.5.3.

  • Updates DockerApplicationManager test to use an ECR-based docker image.

  • Minor bug fixes.

Test suite version:
GGV2Q_2.3.1
  • Released 2022.04.15

IDT v4.5.1 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.5.3.

  • Adds support for validating and qualifying Linux-based devices that use a hardware security module (HSM) to store the private key and certificate that are used by Amazon IoT Greengrass Core software.

  • Implements the new IDT test orchestrator for configuring custom test suites. For more information, see Configure the IDT test orchestrator.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_2.3.0
  • Released 2022.01.11

IDT v4.4.1 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.5.2.

  • Adds support for using a user-defined IAM role as the token exchange role that the device under test assumes to interact with Amazon resources.

    You can specify the IAM role in the userdata.json file. If you specify a custom role, IDT uses that role instead of creating the default token exchange role during the test run.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_2.2.1
  • Released 2021.12.12

IDT v4.4.0 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.5.0.

  • Adds support for validating and qualifying devices running Amazon IoT Greengrass Core software on Windows.

  • Supports the use of public key validation for secure shell (SSH) device connections.

  • Improves the IDT permissions IAM policy with security best practices.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_2.1.0
  • Released 2021.11.19

IDT v4.2.0 for Amazon IoT Greengrass
Release notes:
  • Includes support for qualification of the following features on devices running Amazon IoT Greengrass Core software v2.2.0 and later versions:

    • Docker—Validates that devices can download a Docker container image from Amazon Elastic Container Registry (Amazon ECR).

    • Machine learning—Validates that devices can perform machine learning (ML) inference using the Deep Learning Runtime or TensorFlow Lite ML frameworks.

    • Stream manager—Validates that devices can download, install, and run the Amazon IoT Greengrass stream manager.

  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.4.0, v2.3.0, v2.2.0, and v2.1.0.

  • Groups the test logs for each test case in a separate <test-case-id> folder within the <device-tester-extract-location>/results/<execution-id>/logs/<test-group-id> directory.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_2.0.1
  • Released 2021.08.31

IDT v4.1.0 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.3.0, v2.2.0, v2.1.0, and v2.0.5.

  • Improves the userdata.json configuration by removing the requirement to specify the GreengrassNucleusVersion and GreengrassCLIVersion properties.

  • Includes support for Lambda and MQTT feature qualification for Amazon IoT Greengrass Core software v2.1.0 and later versions. You can now use IDT for Amazon IoT Greengrass V2 to validate that your core device can run Lambda functions and that the device can publish and subscribe to Amazon IoT Core MQTT topics.

  • Improves logging capabilities.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_1.1.1
  • Released 2021.06.18

IDT v4.0.2 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Core software v2.1.0.

  • Adds support for Lambda and MQTT feature qualification for Amazon IoT Greengrass Core software v2.1.0 and later versions. You can now use IDT for Amazon IoT Greengrass V2 to validate that your core device can run Lambda functions and that the device can publish and subscribe to Amazon IoT Core MQTT topics.

  • Improves logging capabilities.

  • Additional minor bug fixes.

Test suite version:
GGV2Q_1.1.1
  • Released 2021.05.05

IDT v4.0.1 for Amazon IoT Greengrass
Release notes:
  • Enables you to validate and qualify devices running Amazon IoT Greengrass Version 2 software.

  • 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. On macOS, you might need to grant a security exception for IDT. For more information, see Security exception on macOS.

Test suite version:
GGV2Q_1.0.0
  • Released 2020.12.22

  • The test suite runs only required tests for qualification, unless you set the corresponding value in the features array to yes.