本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Renesas Starter Kit\+ for RX65N-2MB 入門
<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)。 FreeRTOS 

本教學課程提供 RX65N-2MB 的 Renesas Starter Kit\+ 入門指示。如果您沒有 Renesas RSK\+ for RX65N-2MB，請造訪 AWS Partner Device Catalog，並向[我們的合作夥伴](https://devices.amazonaws.com/detail/a3G0L00000AAOkeUAH/Renesas-Starter-Kit+-for-RX65N-2MB)購買。

開始之前，您必須設定 AWS IoT 和 FreeRTOS 下載，將您的裝置 AWS 連線至 雲端。如需說明，請參閱 [首要步驟](freertos-prereqs.md)。在本教學課程中，FreeRTOS 下載目錄的路徑稱為 `{{freertos}}`。

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

本教學課程包含以下入門步驟的指示：

1. 將主機板連線到主機機器。

1. 在主機機器上安裝軟體以對微控制器主機板的內嵌應用程式進行開發和除錯。

1. 將 FreeRTOS 示範應用程式跨編譯至二進位映像。

1. 將應用程式二進位映像載入主機板，然後執行應用程式。

## 設定 Renesas 硬體
<a name="renesas-setup-hardware"></a>

**設定 RSK\+ for RX65N-2MB**

1. 將正極 \+5V 電源整流器連接到 RSK\+RX65N-2MB 的 PWR 連接器。

1. 將您的電腦連線至 RSK\+ for RX65N-2MB 上的 USB 2.0 FS 連接埠。

1. 將您的電腦連線至 RSK\+ for RX65N-2MB 上的 USB 序列連接埠。

1. 將路由器或連接網際網路的乙太網路連接埠連接至 RSK\+ for RX65N-2MB 上的乙太網路連接埠。

**設定 E2 Lite Debugger 模組**

1. 使用 14 針排線將 E2 Lite Debugger 模組連接至 RSK\+ for RX65N-2MB 的「E1/E2 Lite」連接埠。

1. 使用 USB 纜線將 E2 Lite 偵錯工具模組連接到您的主機。當 E2 Lite 偵錯工具連接至開發板與您的電腦，偵錯工具上的綠色「ACT」LED 將會閃爍。

1. 將偵錯工具連接到您的主機和 RSK\+ for RX65N-2MB 之後，E2 Lite 偵錯工具驅動程式將會開始安裝。

   請注意，安裝驅動程式需要管理員的權限。

![具有各種介面和連線周邊裝置的內嵌系統主機板。](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/renesas-board3.png)


## 設定開發環境
<a name="renesas-setup-env"></a>

若要設定 RSK\+ for RX65N-2MB 的 FreeRTOS 組態，請使用 Renesas e2studio IDE 和 CC-RX 編譯器。

**注意**  
支援 Renesas e2studio IDE 和 CC-RX 編譯器的只有 Windows 7、8 及 10 作業系統。

**下載並安裝 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 Family C/C\+\+ 編譯器套件**

1. 前往 [ RX 系列 C/C\+\+ 編譯器套件](https://www.renesas.com/us/en/document/esw/rx-family-cc-compiler-package-v3-without-ide-v30000)下載頁面，並下載 V3.00.00 套件。

1. 開啟可執行檔並安裝編譯器。

如需詳細資訊，請參閱 Renesas 網站上的[適用於 RX Family 的 C/C\+\+ 編譯器套件](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 以使用 Code Generator** 下，選擇**確定**。

1. **重新啟動 e2studio** 視窗隨即出現。選擇**確定**。

1. e2studio 重新啟動。在 **Select a directory as a workspace (選擇目錄做為工作空間)** 視窗中，選擇 **Launch (啟動)**。

1. 在 e2studio 歡迎畫面上，選擇**前往 e2studio 工作台**箭頭圖示。

1. 在 **Project Explorer (專案瀏覽器)** 視窗上按一下滑鼠右鍵，然後選擇 **Import (匯入)**。

1. 在匯入精靈中，選擇 **General (一般)**、**Existing Projects into Workspace (現有專案到工作空間)**，然後選擇 **Next (下一步)**。

1. 選擇 **Browse (瀏覽)**，找到目錄 `projects/renesas/rx65n-rsk/e2studio/aws_demos`，然後選擇 **Finish (完成)**。

1. 在 **Project (專案)** 功能表中，選擇 **Project (專案)**、**Build All (全部建置)**。

   建置主控台會發出警告訊息，指出尚未安裝 License Manager。您可以忽略此訊息，除非您有 CC-RX 編譯器的授權金鑰。若要安裝 License Manager，請參閱 [License Manager](https://www.renesas.com/us/en/document/swr/license-manager-v20301) 下載頁面。

### 監控雲端的 MQTT 訊息
<a name="gsg-renesas-monitor-mqtt"></a>

在執行 FreeRTOS 示範專案之前，您可以在 AWS IoT 主控台中設定 MQTT 用戶端，以監控裝置傳送至 AWS 雲端的訊息。

**使用 MQTT 用戶端訂閱 AWS IoT MQTT 主題**

1. 登入 [AWS IoT 主控台](https://console.aws.amazon.com/iotv2/)。

1. 在導覽窗格中，選擇**測試**，然後選擇 **MQTT 測試用戶端**以開啟 MQTT 用戶端。

1. 在**訂閱主題**中輸入 **{{your-thing-name}}/example/topic**，然後選擇**訂閱主題**。

當示範專案在您的裝置上成功執行時，您會看到「Hello World！」 多次傳送到您訂閱的主題。

### 執行 FreeRTOS 專案
<a name="renesas-run"></a>

**在 e2studio 中執行專案**

1. 確認您已將 E2 Lite Debugger 模組連接到 RSK\+ for RX65N-2MB

1. 在最上層功能表中，選擇 **Run (執行)**、**Debug Configuration (偵錯設定)**。

1. 展開 **Renesas GDB Hardware Debugging (Renesas GDB 硬體偵錯)**，然後選擇 **aws\_demos 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 偵錯觀點)**。選擇 **Yes (是)**。

   E2 Lite Debugger 上的「ACT」LED 燈號將會亮起。

1. 將程式碼下載到開發板之後，請選擇 **Resume (恢復)** 將程式碼執行到主要函數的第一行。再次選擇 **Resume (恢復)** 以執行其餘程式碼。

如需 Renesas 發佈的最新專案，請參閱 [GitHub](https://github.com/renesas-rx/amazon-freertos) 上`amazon-freertos`儲存庫的`renesas-rx`分支。

## 疑難排解
<a name="renesas-troubleshooting"></a>

如需 FreeRTOS 入門的一般疑難排解資訊，請參閱 [故障診斷入門](gsg-troubleshooting.md)。