

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

# 设置 1.0 资格认证先决条件
<a name="dev-tester-prereqs"></a>

本节介绍使用测试微控制器的 Amazon IoT Device Tester先决条件。

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

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

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

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

**注意**  
我们不建议多个用户从共享位置（如 NFS 目录或 Windows 网络共享文件夹）运行 IDT。这可能会导致崩溃或数据损坏。我们建议您将 IDT 包解压缩到本地驱动器。

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

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

如果您没有 Amazon Web Services 账户，请完成以下步骤来创建一个。

**要注册 Amazon Web Services 账户**

1. 打开[https://portal.aws.amazon.com/billing/注册。](https://portal.amazonaws.cn/billing/signup)

1. 按照屏幕上的说明操作。

   在注册时，将接到电话或收到短信，要求使用电话键盘输入一个验证码。

   当您注册时 Amazon Web Services 账户，就会创建*Amazon Web Services 账户根用户*一个。根用户有权访问该账户中的所有 Amazon Web Services 服务 和资源。作为最佳安全实践，请为用户分配管理访问权限，并且只使用根用户来执行[需要根用户访问权限的任务](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。

Amazon 注册过程完成后会向您发送一封确认电子邮件。您可以随时前往 [https://aws.amazon.com/](https://www.amazonaws.cn/)并选择 “**我的账户”，查看您当前的账户活动并管理您的账户**。

### 保护 IAM 用户
<a name="secure-an-admin"></a>

注册后 Amazon Web Services 账户，开启多重身份验证 (MFA)，保护您的管理用户。有关说明，请参阅《IAM 用户指南》**中的 [为 IAM 用户启用虚拟 MFA 设备（控制台）](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-iam-user)。

要允许其他用户访问您的 Amazon Web Services 账户 资源，请创建 IAM 用户。为了保护您的 IAM 用户，请启用 MFA 并仅向 IAM 用户授予执行任务所需的权限。

有关创建和保护 IAM 用户的更多信息，请参阅《IAM 用户指南》中的以下主题：**
+ [在你的 IAM 用户中创建 Amazon Web Services 账户](https://docs.amazonaws.cn//IAM/latest/UserGuide/id_users_create.html)
+ [适用于 Amazon 资源的访问权限管理](https://docs.amazonaws.cn/IAM/latest/UserGuide/access.html)
+ [基于 IAM 身份的策略示例](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_examples.html)

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

`AWSIoTDeviceTesterForFreeRTOSFullAccess`托管策略包含版本检查、auto update 功能和指标收集的以下 Amazon IoT Device Tester 权限。
+ `iot-device-tester:SupportedVersion`

  授 Amazon IoT Device Tester 予获取受支持产品、测试套件和 IDT 版本列表的权限。
+ `iot-device-tester:LatestIdt`

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

  授 Amazon IoT Device Tester 予检查 IDT、测试套件和产品的版本兼容性的权限。
+ `iot-device-tester:DownloadTestSuite`

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

  授 Amazon 予收集 Amazon IoT Device Tester 内部使用情况指标的权限。

## （可选）安装 Amazon Command Line Interface
<a name="install-cli"></a>

您可能更喜欢使用 Amazon CLI 来执行某些操作。如果您没有安装 Amazon CLI ，请按照[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/installing.html) 中的说明执行操作。

通过 Amazon CLI **aws configure**从命令行运行来配置要使用的 Amazon 区域。[有关支持 IDT for FreeRTOS 的 Amazon 区域的信息，Amazon 请参阅区域和终端节点。](https://docs.amazonaws.cn/general/latest/gr/rande.html#amazon-freertos-ota-control)有关 **aws configure** 的更多信息，请参阅[使用 **aws configure** 进行快速配置](https://docs.amazonaws.cn/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)。