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).

First test of your microcontroller board

You can use IDT for FreeRTOS to test your implementation of the FreeRTOS libraries. After you have ported the FreeRTOS libraries for your board’s device drivers, use Amazon IoT Device Tester to run the qualification tests on your microcontroller board.

Add library porting layers

To port FreeRTOS for your device, see the FreeRTOS Porting Guide. When implementing the FreeRTOS tests repository and porting the FreeRTOS layers, you must provide a manifest.yml with paths to each library, including the tests repository. This file will be in the root directory of your source code. See manifest file instructions for details.

Configure your Amazon credentials for Amazon IoT Device Tester to communicate with the Amazon Cloud

You need to configure your Amazon credentials for Amazon IoT Device Tester to communicate with the Amazon Cloud. For more information, see Set up Amazon Credentials and Region for Development. Valid Amazon credentials are specified in the devicetester_extract_location/devicetester_freertos_[win|mac|linux]/configs/config.json configuration file.

"auth": {
   "method": "environment"
}

"auth": {
    "method": "file",
    "credentials": {
        "profile": "<your-aws-profile>"
    }
}

The auth attribute of the config.json file has a method field that controls Amazon authentication, and can be declared as either file or environment. Setting the field to environment pulls your Amazon credentials from your host machine’s environment variables. Setting the field to file imports a specified profile from the .aws/credentials config file.