

# First test of your microcontroller board
<a name="lts-qual-steps"></a>

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
<a name="lts-add-port-layer"></a>

To port FreeRTOS for your device, see the [FreeRTOS Porting Guide](https://docs.amazonaws.cn/freertos/latest/portingguide/porting-guide.html). 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](https://docs.amazonaws.cn/freertos/latest/qualificationguide/afq-checklist-manifest-instr.html) for details.

## Configure your Amazon credentials for Amazon IoT Device Tester to communicate with the Amazon Cloud
<a name="lts-cfg-aws-afr"></a>

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](https://docs.amazonaws.cn/sdk-for-java/v1/developer-guide/setup-credentials.html). 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.

**Topics**
+ [Add library porting layers](#lts-add-port-layer)
+ [Configure your Amazon credentials for Amazon IoT Device Tester to communicate with the Amazon Cloud](#lts-cfg-aws-afr)
+ [Create a device pool in IDT for FreeRTOS](lts-cfg-dt-dp.md)
+ [Configure build, flash, and test settings](lts-cfg-dt-ud.md)