

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

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

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

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

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

IDT-FreeRTOS UI 支持以下 Web 浏览器。


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

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

**注意**  
IDT-FreeRTOS UI 不支持 Microsoft 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> 是与 [支持的版本 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 资格认证的注意事项（使用 LTS 库的 FreeRTOS 的资格认证）
<a name="ui-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="ui-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:\`。

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

## 创建和配置 Amazon 账户
<a name="ui-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="ui-managed-policy"></a>

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

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

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

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

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

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