本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置运行 FreeRTOS 资格认证套件的先决条件
<a name="dev-tester-ui-prereqs"></a>

本节介绍通过 AWS IoT Device Tester测试微控制器的先决条件。

**Topics**
+ [使用支持的 Web 浏览器](#idt-ui-supported-web-browser)
+ [下载 FreeRTOS](#ui-download-afr)
+ [下载适用于 FreeRTOS 的 IDT](#ui-download-dev-tester-afr)
+ [创建和配置 AWS 账户](#ui-config-aws-account)
+ [AWS IoT Device Tester 托管策略](#ui-managed-policy)

## 使用支持的 Web 浏览器
<a name="idt-ui-supported-web-browser"></a>

 IDT-FreeRTOS 用户界面支持以下 Web 浏览器。


| 浏览器 | 版本 | 
| --- | --- | 
| Google Chrome | 最新的三个主要版本 | 
| Mozilla Firefox | 最新的三个主要版本 | 
| Microsoft Edge | 最新的三个主要版本 | 
| Apple Safari for macOS | 最新的三个主要版本 | 

为了获得更好的体验，我们建议您使用 Google Chrome 或 Mozilla Firefox。

**注意**  
 IDT-FreeRTOS 用户界面不支持微软 Internet Explorer。

## 下载 FreeRTOS
<a name="ui-download-afr"></a>

你可以使用以下命令[GitHub](https://github.com/aws/amazon-freertos)从中下载 FreeRTOS 的发行版：

```
git clone --branch <{{FREERTOS_RELEASE_VERSION}}> --recurse-submodules https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout --init --recursive
```

其中 <FREERTOS\_RELEASE\_VERSION> 是与 [支持的版本 AWS IoT Device Tester](dev-test-versions-afr.md) 中列出的 IDT 版本对应的 FreeRTOS 版本（例如 202007.00）。这样可以确保您拥有完整的源代码，包括子模块，并且使用适用于您的 FreeRTOS 版本的 IDT 的正确版本，反之亦然。

Windows 的路径长度限制为 260 个字符。FreeRTOS 的路径结构是多级深层结构，因此，如果您使用 Windows，请确保文件路径不超过 260 个字符的限制。例如，将 FreeRTOS 克隆到 `C:\FreeRTOS` 而不是 `C:\Users\username\programs\projects\myproj\FreeRTOS\`。

### LTS 资格认证的注意事项（使用 LTS 库的 FreeRTOS 的资格认证）
<a name="ui-lts-qualification-dev-tester-afr"></a>
+ 要在 AWS 合作伙伴设备目录中将您的微控制器指定为支持基于长期支持 (LTS) 的 FreeRTOS 版本，您必须提供清单文件。有关更多信息，请参阅《FreeRTOS 资格认证指南》中的 [FreeRTOS 资格认证检查清单](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afq-checklist.html)。**
+ 为了验证您的微控制器是否支持基于 LTS 的 FreeRTOS 版本并使其有资格提交到 AWS 合作伙伴设备目录，您必须使用 ( AWS IoT Device Tester IDT) 和 FreeRTOS 资格认证 (FRQ) 测试套件版本 v1.4.x。
+ 对基于 LTS 的 FreeRTOS 版本的支持仅限于 202012.xx 版本的 FreeRTOS。

## 下载适用于 FreeRTOS 的 IDT
<a name="ui-download-dev-tester-afr"></a>

为了执行资格认证测试，FreeRTOS 的每个版本都有对应的适用于 FreeRTOS 的 IDT 版本。从 [支持的版本 AWS IoT Device Tester](dev-test-versions-afr.md) 下载适用于 FreeRTOS 的 ITD 的相应版本。

将适用于 FreeRTOS 的 IDT 提取到文件系统上您具有读写权限的位置。由于 Microsoft Windows 对路径长度具有字符数限制，因此将适用于 FreeRTOS 的 IDT 提取到根目录，如 `C:\` 或 `D:\`。

**注意**  
我们建议您将 IDT 程序包提取到本地驱动器。允许多个用户从共享位置（例如 NFS 目录或 Windows 网络共享文件夹）运行 IDT 可能会导致系统无响应或数据损坏。

## 创建和配置 AWS 账户
<a name="ui-config-aws-account"></a>

### 注册获取 AWS 账户
<a name="sign-up-for-aws"></a>

要开始使用 AWS，你需要一个 AWS 账户。有关创建的信息 AWS 账户，请参阅《*AWS 账户管理 参考指南》 AWS 账户中的[入门](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html)指南*。

## AWS IoT Device Tester 托管策略
<a name="ui-managed-policy"></a>

为了支持设备测试程序运行和收集指标，`AWSIoTDeviceTesterForFreeRTOSFullAccess` 托管策略包含了以下权限：
+ `iot-device-tester:SupportedVersion`

  授予权限以获取 IDT 支持的 FreeRTOS 版本和测试套件版本的列表，以便它们可以从 AWS CLI获取。
+ `iot-device-tester:LatestIdt`

  授予获取可供下载的最新 AWS IoT Device Tester 版本的权限。
+ `iot-device-tester:CheckVersion`

  授予权限以检查产品、测试套件和 AWS IoT Device Tester 版本组合是否兼容。
+ `iot-device-tester:DownloadTestSuite`

  授 AWS IoT Device Tester 予下载测试套件的权限。
+ `iot-device-tester:SendMetrics`

  授予发布 AWS IoT Device Tester 使用率指标数据的权限。