View a markdown version of this page

Microchip ATECC608A 安全元件以及 Windows 模拟器入门 - FreeRTOS

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

Microchip ATECC608A 安全元件以及 Windows 模拟器入门

重要

此参考集成托管在已弃用的 Amazon-FreeRTOS 存储库中。当您创建新项目时,我们建议从此处开始。如果您已经有一个基于现已 Amazon-FreeRTOS 弃用的存储库的 FreeRTOS 项目,请参阅。Amazon-FreeRTOS Github 存储库迁移

本教程提供了有关 Microchip ATECC608A 安全元件和 Windows 模拟器入门的说明。

您需要以下硬件:

在开始之前,您必须进行配置 AWS IoT 并下载 FreeRTOS 才能将您的设备连接到云端。 AWS 有关说明,请参阅初始步骤:在本教程中,FreeRTOS 下载目录的路径称为 freertos

概述

本教程包含以下步骤:

  1. 将主板连接到主机。

  2. 在主机上安装软件来开发和调试微控制器主板的嵌入式应用程序。

  3. Cross-compile 二进制图像的 FreeRTOS 演示应用程序。

  4. 将应用程序二进制映像加载到您的主板中,然后运行该应用程序。

设置 Microchip ATECC608A 硬件

您必须先对 SAMD21 进行编程,然后才能与 Microchip ATECC608A 设备进行交互。

设置 SAMD21 XPlained Pro 主板
  1. 点击 CryptoAuthSSH-XSTK (DM320109)-最新固件链接,下载包含指令 (PDF) 和二进制文件的.zip 文件,该文件可以编程到 D21 上。

  2. 下载并安装 Atmel Studio 7 IDP。请确保在安装过程中选择 SMART ARM MCU 驱动程序架构。

  3. 使用 USB 2.0 Micro B 电缆将“调试 USB”连接器连接到您的计算机,并按照 PDF 中的说明操作。(“调试 USB”连接器是最接近电源引线和引脚的 USB 端口。)

连接硬件
  1. 从调试 USB 中拔下微型 USB 电缆。

  2. 在 EXT1 位置,将 mikroBUS XPlained Pro 适配器插入 SAMD21 主板。

  3. 将 ATECC608A Secure 4 Click 主板插入 mikroBUSX XPlained Pro 适配器。确保 Click 主板的缺口角与适配器板上的缺口图标匹配。

  4. 将微型 USB 电缆插入到目标 USB 中。

您的设置应如下所示。

一个试验板,带有标有“目标 USB”的 USB 电缆,连接到标有“已连接到 EXT 1”的外部设备,板上凹槽与默认跳线位置匹配。

设置开发环境

注册获取 AWS 账户

要开始使用 AWS,你需要一个 AWS 账户。有关创建的信息 AWS 账户,请参阅《AWS 账户管理 参考指南》 AWS 账户中的入门指南

要提供访问权限,请为您的用户、组或角色添加权限:

设置
  1. 从 FreeRTOS 存储库中下载 FreeRTOS 存储库。 GitHub

    要从以下网址下载 FreeRTOS: GitHub

    1. 浏览到 FreeRTOS 存储库 GitHub

    2. 选择 Clone or download (克隆或下载)

    3. 从计算机的命令行中,将存储库克隆到主机上的一个目录中。

      git clone https://github.com/aws/amazon-freertos.git -\-recurse-submodules
      重要
      • 在本主题中,FreeRTOS 下载目录的路径称为 freertos

      • freertos 路径中的空格字符可能会导致构建失败。克隆或复制存储库时,请确保您创建的路径不包含空格字符。

      • Microsoft Windows 上的文件路径最大长度为 260 个字符。FreeRTOS 下载目录路径过长可能会导致构建操作失败。

      • 由于源代码可能包含符号链接,因此,如果您使用 Windows 提取存档,则可能必须:

        • 启用开发者模式,或者,

        • 使用已提升为管理员的控制台。

        这样,Windows 就可以在提取存档文件时正确创建符号链接。否则,符号链接将作为普通文件写入,该文件会将符号链接的路径作为文本,或者是空文件。有关更多信息,请参阅博客文章 Windows 10 中的符号链接

        如果您在 Windows 下使用 Git,则必须启用开发者模式,或者必须:

        • 使用以下命令将 core.symlinks 设置为 true:

          git config -\-global core.symlinks true
        • 每当您使用写入系统的 git 命令(例如,git pullgit clonegit submodule update -\-init -\-recursive)时,请使用具有管理员权限的控制台。

    4. freertos 目录中,检查要使用的分支。

  2. 设置开发环境。

    1. 安装最新版的 WinPCap

    2. 安装 Microsoft Visual Studio。

      Visual Studio 2017 和 2019 版已知可用。支持 Visual Studio 的所有版本(社区版、专业版或企业版)。

      在 IDE 之外,请安装 Desktop development with C++ (C++ 桌面开发)组件。然后,在 Optional (可选) 下安装最新的 Windows 10 开发工具包。

    3. 确保您有活动的有线以太网连接。

构建并运行 FreeRTOS 演示项目

重要

Microchip ATECC608A 设备具有一次性初始化功能,该功能在首次运行项目时(在调用 C_InitToken 期间)被锁定到设备上。但是,FreeRTOS 演示项目和测试项目的配置不同。如果设备在演示项目配置期间被锁定,则测试项目中的所有测试都不可能成功。

使用 Visual Studio IDE 构建并运行 FreeRTOS 演示项目
  1. 在 Visual Studio 中加载项目。

    File (文件) 菜单上,选择 Open (打开)。选择 File/Solution,导航到该freertos\projects\microchip\ecc608a_plus_winsim\visual_studio\aws_demos\aws_demos.sln文件,然后选择 “打开”。

  2. 重新定位演示项目。

    此演示项目取决于 Windows 开发工具包,但未指定 Windows 开发工具包版本。默认情况下,IDE 可能会尝试使用计算机上不存在的开发工具包版本构建演示。要设置 Windows 开发工具包版本,请右键单击 aws_demos,然后选择 Retarget Projects (重新定位项目)。这将打开 Review Solution Actions (审核解决方案操作) 窗口。选择计算机上现有的一个 Windows 开发工具包版本(使用下拉列表中的初始值),然后选择 OK (确定)

  3. 构建并运行项目。

    构建菜单中选择构建解决方案,确保解决方案已构建且没有错误。选择 Debug (调试)、Start Debugging (开始调试) 以运行项目。在第一次运行时,您需要配置您的设备接口并重新编译。有关更多信息,请参阅 配置网络接口

  4. 预置 Microchip ATECC608A。

    Microchip 提供了多种脚本工具来帮助设置 ATECC608A 部件。导航到freertos\vendors\microchip\secure_elements\app\example_trust_chain_tool该 README.md 文件并将其打开。

    请按照 README.md 文件中的说明预置您的设备。相应步骤包括:

    1. 创建并注册证书颁发机构 AWS。

    2. 在 Microchip ATECC608A 上生成您的密钥,并导出公有密钥和设备序列号。

    3. 为设备生成证书并向注册该证书 AWS。

    4. 将 CA 证书和设备证书加载到设备上。

  5. 构建并运行 FreeRTOS 示例。

    Re-run 又是演示项目。这次应该能成功连接!

问题排查

有关一般故障排除信息,请参阅问题排查入门