本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
本节介绍使用测试微控制器的 AWS IoT Device Tester先决条件。
下载 FreeRTOS
你可以使用以下命令GitHub
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 中列出的 IDT 版本对应的 FreeRTOS 版本(例如 202007.00)。这样可以确保您拥有完整的源代码,包括子模块,并且使用适用于您的 FreeRTOS 版本的 IDT 的正确版本,反之亦然。
Windows 的路径长度限制为 260 个字符。FreeRTOS 的路径结构是多级深层结构,因此如果您使用 Windows,请确保文件路径不超过 260 个字符的限制。例如,将 FreeRTOS 克隆到 C:\FreeRTOS
而不是 C:\Users\username\programs\projects\myproj\FreeRTOS\
。
使用 LTS 库获得 FreeRTOS 资格
-
要在 AWS 合作伙伴设备目录中将您的微控制器指定为支持基于长期支持 (LTS) 的 FreeRTOS 版本,您必须提供清单文件。有关更多信息,请参阅《FreeRTOS 资格认证指南》中的 FreeRTOS 资格认证检查清单。
-
为了验证您的微控制器是否支持基于 LTS 的 FreeRTOS 版本并使其有资格提交到 AWS 合作伙伴设备目录,您必须使用 ( AWS IoT Device Tester IDT) 和 FreeRTOS 资格认证 (FRQ) 测试套件版本 v1.4.x。
-
对基于 LTS 的 FreeRTOS 版本的支持仅限于 202012.xx 版本的 FreeRTOS。
下载适用于 FreeRTOS 的 IDT
为了执行资格认证测试,FreeRTOS 的每个版本都有对应的适用于 FreeRTOS 的 IDT 版本。从 支持的版本 AWS IoT Device Tester 下载适用于 FreeRTOS 的 ITD 的相应版本。
将适用于 FreeRTOS 的 IDT 提取到文件系统上您具有读写权限的位置。由于 Microsoft Windows 对路径长度具有字符数限制,因此将适用于 FreeRTOS 的 IDT 提取到根目录,如 C:\
或 D:\
。
注意
我们不建议多个用户从共享位置(如 NFS 目录或 Windows 网络共享文件夹)运行 IDT。这可能会导致崩溃或数据损坏。我们建议您将 IDT 包解压缩到本地驱动器。
创建和配置 AWS 账户
注册获取 AWS 账户
如果您没有 AWS 账户,请完成以下步骤来创建一个。
要注册 AWS 账户
按照屏幕上的说明操作。
在注册时,将接到电话,要求使用电话键盘输入一个验证码。
当您注册时 AWS 账户,就会创建AWS 账户根用户一个。根用户有权访问该账户中的所有 AWS 服务 和资源。作为最佳安全实践,请为用户分配管理访问权限,并且只使用根用户来执行需要根用户访问权限的任务。
AWS 注册过程完成后会向您发送一封确认电子邮件。您可以随时前往 https://aws.amazon.com/
创建具有管理访问权限的用户
注册后,请保护您的安全 AWS 账户 AWS 账户根用户 AWS IAM Identity Center,启用并创建管理用户,这样您就不会使用 root 用户执行日常任务。
保护你的 AWS 账户根用户
-
选择 Root 用户并输入您的 AWS 账户 电子邮件地址,以账户所有者的身份登录。AWS Management Console
在下一页上,输入您的密码。 要获取使用根用户登录方面的帮助,请参阅《AWS 登录 用户指南》中的 Signing in as the root user。
-
为您的根用户启用多重身份验证(MFA)。
有关说明,请参阅 I A M 用户指南中的为 AWS 账户 根用户启用虚拟 MFA 设备(控制台)。
创建具有管理访问权限的用户
-
启用 IAM Identity Center。
有关说明,请参阅《AWS IAM Identity Center 用户指南》中的 Enabling AWS IAM Identity Center。
-
在 IAM Identity Center 中,为用户授予管理访问权限。
有关使用 IAM Identity Center 目录 作为身份源的教程,请参阅《用户指南》 IAM Identity Center 目录中的使用默认设置配置AWS IAM Identity Center 用户访问权限。
以具有管理访问权限的用户身份登录
-
要使用您的 IAM Identity Center 用户身份登录,请使用您在创建 IAM Identity Center 用户时发送到您的电子邮件地址的登录网址。
有关使用 IAM Identity Center 用户登录的帮助,请参阅AWS 登录 用户指南中的登录 AWS 访问门户。
将访问权限分配给其他用户
-
在 IAM Identity Center 中,创建一个权限集,该权限集遵循应用最低权限的最佳做法。
有关说明,请参阅《AWS IAM Identity Center 用户指南》中的 Create a permission set。
-
将用户分配到一个组,然后为该组分配单点登录访问权限。
有关说明,请参阅《AWS IAM Identity Center 用户指南》中的 Add groups。
AWS IoT Device Tester 托管策略
AWSIoTDeviceTesterForFreeRTOSFullAccess
托管策略包含版本检查、auto update 功能和指标收集的以下 AWS IoT Device Tester 权限。
-
iot-device-tester:SupportedVersion
授 AWS IoT Device Tester 予获取受支持产品、测试套件和 IDT 版本列表的权限。
-
iot-device-tester:LatestIdt
授 AWS IoT Device Tester 予获取可供下载的最新 IDT 版本的权限。
-
iot-device-tester:CheckVersion
授 AWS IoT Device Tester 予检查 IDT、测试套件和产品的版本兼容性的权限。
-
iot-device-tester:DownloadTestSuite
授 AWS IoT Device Tester 予下载测试套件更新的权限。
-
iot-device-tester:SendMetrics
授 AWS 予收集有关 AWS IoT Device Tester 内部使用情况的指标的权限。
(可选)安装 AWS Command Line Interface
您可能更喜欢使用 AWS CLI 来执行某些操作。如果您没有安装 AWS CLI ,请按照安装 AWS CLI 中的说明执行操作。
通过aws configure从命令行运行来为要使用的 AWS 区域进行配置。 AWS CLI 有关支持 IDT for FreeRTOS 的 AWS 区域的信息,AWS 请参阅区域和终端节点。有关 aws configure 的更多信息,请参阅使用 aws configure 进行快速配置。