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

# 开始使用适用于 N-2MB 的瑞萨电子入门套件\$1 RX65
<a name="getting_started_renesas"></a>

**重要**  <a name="deprecation-message"></a>
该参考集成托管在已弃用的 Amazon-FreeRTOS 存储库中。当您创建新项目时，我们建议[从此处开始](freertos-getting-started-modular.md)。如果您已经有一个基于现已弃用的 Amazon-FreeRTOS 存储库的 FreeRTOS 项目，请参阅 [Amazon-FreeRTOS Github 存储库迁移指南](github-repo-migration.md)。

本教程提供了如何开始使用适用于 N-2MB 的瑞萨电子入门套件\$1 的说明。 RX65[如果您没有适用于 RX65 N-2MB 的瑞萨 RSK\$1，请访问 Amazon 合作伙伴设备目录，然后从我们的合作伙伴处购买。](https://devices.amazonaws.com/detail/a3G0L00000AAOkeUAH/Renesas-Starter-Kit+-for-RX65N-2MB)

在开始之前，您必须进行配置 Amazon IoT 并下载 FreeRTOS 才能将您的设备连接到云端。 Amazon 有关说明，请参阅[初始步骤](freertos-prereqs.md)：在本教程中，FreeRTOS 下载目录的路径称为 `freertos`。

## 概述
<a name="gsg-renesas-overview"></a>

本教程包含有关以下入门步骤的说明：

1. 将主板连接到主机。

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

1. 将 FreeRTOS 演示应用程序交叉编译为二进制映像。

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

## 设置 Renesas 硬件
<a name="renesas-setup-hardware"></a>

**要为 N-2MB 设置 RSK\$1 RX65**

1. 将 \$15V 正极电源适配器连接到 N-2MB 的 RSK\$1 上的 PWR 连接器。 RX65

1. 将您的计算机连接到 N-2MB 版 RSK\$1 上的 USB2 .0 FS 端口。 RX65

1. 将您的计算机连接到适用 RX65于 N-2MB 的 RSK\$1 上的 USB-to-serial端口。

1. 将路由器或连接互联网的以太网端口连接到 N-2MB 的 RSK\$1 上的以太网端口。 RX65

**设置 E2 Lite 调试器模块**

1. 使用 14 针带状电缆将 E2 Lite 调试器模块连接到 N-2MB 的 RSK\$1 上的 “E1/E2 Lite” 端口。 RX65

1. 使用 USB 电缆将 E2 Lite 调试器模块连接到主机。当 E2 Lite 调试器连接到主板和计算机时，调试器上绿色的“ACT”LED 会闪烁。

1. 将调试器连接到您的主机并连接到 RX65 N-2MB 的 RSK\$1 之后，E2 Lite 调试器驱动程序开始安装。

   请注意，安装驱动程序需要管理员权限。

![\[带有各种接口和已连接外围设备的嵌入式系统主板。\]](http://docs.amazonaws.cn/freertos/latest/userguide/images/renesas-board3.png)


## 设置开发环境
<a name="renesas-setup-env"></a>

要为 N-2MB 的 RSK\$1 设置 FreeR RX65 TOS 配置，请使用瑞萨 e 2 studio IDE 和 CC-RX 编译器。

**注意**  
仅 Windows 7、8 和 10 操作系统支持 Renesas e2studio IDE 和 CC-RX 编译器。

**下载并安装 e2studio**

1. 转到 [ Renesas e2studio 安装程序](https://www.renesas.com/us/en/document/uid/e-studio-2020-10-installer-offline-installer)下载页面，并下载脱机安装程序。

1. 您将会转到 Renesas 登录页面。

   如果您拥有 Renesas 账户，请输入您的登录凭证，然后选择**登录**。

   如果您没有账户，请选择 **Register now (立即注册)**，并按照第一次注册步骤操作。您应该收到一封电子邮件，其中包含用于激活您的 Renesas 账户的链接。按照此链接完成 Renesas 注册，然后登录到 Renesas。

1. 登录后，将 e2studio 安装程序下载到您的计算机。

1. 打开安装程序并按照步骤完成操作。

有关更多信息，请参阅 Renesas 网站上的 [e2studio](https://www.renesas.com/us/en/products/software-tools/tools/ide/e2studio.html#productInfo)。

**下载并安装 RX 系列 C/C\$1\$1 编译器包**

1. 转到 [RX 系列 C/C\$1\$1 编译器包](https://www.renesas.com/us/en/document/esw/rx-family-cc-compiler-package-v3-without-ide-v30000)下载页面，并下载 V3.00.00 包。

1. 打开可执行文件并安装编译器。

有关更多信息，请参阅 Renesas 网站上的 [RX 系列 C/C\$1\$1 编译器包](https://www.renesas.com/us/en/products/software-tools/tools/compiler-assembler/compiler-package-for-rx-family.html#productInfo)。

**注意**  
编译器仅评估版本可免费使用，有效期为 60 天。在第 61 天，您需要获取许可证密钥。有关更多信息，请参阅[评估软件工具](https://www.renesas.com/us/en/products/software-tools/evaluation-software-tools.html)。

## 构建并运行 FreeRTOS 示例。
<a name="renesas-build-and-run-example"></a>

现在您已配置演示项目，可以在主板上构建和运行项目。

### 在 e2studio 中构建 FreeRTOS 演示
<a name="renesas-freertos-import-project"></a>

**在 e2studio 中导入和构建演示**

1. 从“开始”菜单启动 e2studio。

1. 在 **Select a directory as a workspace (选择一个目录作为工作区)** 窗口中，浏览到要在其中工作的文件夹，然后选择 **Launch (启动)**。

1. 当您首次打开 e2studio 时，**Toolchain Registry (工具链注册表)** 窗口会打开。选择 **Renesas Toolchains (Renesas 工具链)**，并确认已选择 **CC-RX v3.00.00**。选择 **Register (注册)**，然后选择 **OK (确定)**。

1. 如果您是首次打开 e2studio，将显示 **Code Generator Registration (代码生成器注册)** 窗口。选择**确定**。

1. 将显示 **Code Generator COM component register (代码生成器 COM 组件注册)** 窗口。在**请重启 e2studio 以使用代码生成器**下，选择**确定**。

1. 此时将显示**重启 e2studio**窗口。选择**确定**。

1. e2studio 将重启。在 **Select a directory as a workspace (选择一个目录作为工作区)** 窗口中，选择 **Launch (启动)**。

1. 在 e2studio 欢迎屏幕上，选择 **Go to the e2studio workbench (转到 e2studio 工作台)** 箭头图标。

1. 右键单击 **Project Explorer (项目资源管理器)** 窗口，然后选择 **Import (导入)**。

1. 在导入向导中，选择 **General (常规)**、**Existing Projects into Workspace (现有项目到工作区)**，然后选择 **Next (下一步)**。

1. 选择 **Browse (浏览)**，找到目录 `projects/renesas/rx65n-rsk/e2studio/aws_demos`，然后选择 **Finish (完成)**。

1. 从**项目**菜单中，选择**项目**、**全部生成**。

   生成控制台将发出未安装许可证管理器的警告消息。您可以忽略此消息，除非您有 CC-RX 编译器的许可证密钥。要安装许可证管理器，请参阅[许可证管理器](https://www.renesas.com/us/en/document/swr/license-manager-v20301)下载页面。

### 在云上监控 MQTT 消息
<a name="gsg-renesas-monitor-mqtt"></a>

在运行 FreeRTOS 演示项目之前，您可以在控制台中 Amazon IoT 设置 MQTT 客户端，以监控您的设备发送到云端的消息。 Amazon 

**使用 MQTT 客户端订阅 M Amazon IoT QTT 主题**

1. 登录 [Amazon IoT 控制台](https://console.amazonaws.cn/iotv2/)。

1. 在导航窗格中选择**测试**，然后选择 **MQTT 测试客户端**，以便打开 MQTT 客户端。

1. 在 **Subscription topic (订阅主题)**中，输入 ***your-thing-name*/example/topic**，然后选择 **Subscribe to topic (订阅主题)**。

当演示项目在您的设备上成功运行时，您会多次看到“Hello World！” 发送到您订阅的主题。

### 运行 FreeRTOS 项目
<a name="renesas-run"></a>

**在 e2studio 中运行项目**

1. 确认你已将 E2 Lite 调试器模块连接到适用于 N-2MB 的 RSK\$1 RX65

1. 从顶部菜单中，选择 **Run (运行)**、**Debug Configuration (调试配置)**。

1. **展开**瑞萨电子 GDB 硬件调试，**然后选择 aws\$1demos。 HardwareDebug**

1. 选择 **Debugger (调试器)** 选项卡，然后选择 **Connection Settings (连接设置)** 选项卡。确认您的连接设置正确。

1. 选择 **Debug (调试)** 来将代码下载到主板并开始调试。

   系统可能会通过 `e2-server-gdb.exe` 的防火墙警告提示您。选中 **Private networks, such as my home or work network (私有网络，如我的家庭或工作网络)**，然后选择 **Allow access (允许访问)**。

1. e2studio 可能会要求更改为 **Renesas Debug Perspective (Renesas 调试模式)**。请选择**是**。

   E2 Lite 调试器上绿色的“ACT”LED 会亮起。

1. 在代码下载到主板后，选择 **Resume (恢复)** 以使代码运行到主函数的第一行。再次选择 **Resume (恢复)** 以运行其余代码。

有关瑞萨电子发布的最新项目，请参阅上`amazon-freertos`存储库的`renesas-rx`分支。[GitHub](https://github.com/renesas-rx/amazon-freertos)

## 问题排查
<a name="renesas-troubleshooting"></a>

有关 FreeRTOS 入门的常规故障排除信息，请参阅[问题排查入门](gsg-troubleshooting.md)。