本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# MediaTek MT7697Hx 開發套件入門
**重要**
此參考整合託管在已棄用的 Amazon-FreeRTOS 儲存庫上。我們建議您在建立新專案時從[這裡開始](freertos-getting-started-modular.md)。如果您已經有以現在已棄用的 Amazon-FreeRTOS 儲存庫為基礎的現有 FreeRTOS 專案，請參閱 [Amazon-FreeRTOS Github 儲存庫遷移指南](github-repo-migration.md)。 FreeRTOS
本教學課程提供 MediaTek MT7697Hx 開發套件入門指示。如果您沒有 MediaTek MT7697Hx 開發套件，請造訪 AWSPartner Device Catalog 向[我們的合作夥伴](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit)購買。
開始之前，您必須設定 AWS IoT和 FreeRTOS 下載，將您的裝置AWS連線至 雲端。如需說明，請參閱 [首要步驟](freertos-prereqs.md)。在本教學課程中，FreeRTOS 下載目錄的路徑稱為 `freertos`。
## 概觀
本教學課程包含以下入門步驟的指示：
1. 在主機機器上安裝軟體以對微控制器主機板的內嵌應用程式進行開發和除錯。
1. 將 FreeRTOS 示範應用程式跨編譯至二進位映像。
1. 將應用程式二進位映像載入主機板，然後執行應用程式。
1. 透過序列連線與在開發板上執行的應用程式互動，以便進行監控和除錯。
## 設定開發環境
在設定您的環境之前，請將您的電腦連接至 MediaTek MT7697Hx 開發套件上的 USB 連接埠。
### 下載並安裝 Keil MDK
您可以使用 GUI 型 Keil 微控制器開發套件 (MDK) 在主機板上設定、建置和執行 FreeRTOS 專案。Keil MDK 包含 μVision IDE 和 μVision Debugger。
**注意**
僅 Windows 7、Windows 8 和 Windows 10 64 位元機器支援 Keil MDK。
**下載並安裝 Keil MDK**
1. 移至 [Keil MDK 入門](http://www2.keil.com/mdk5/install/)頁面，然後選擇 **Download MDK-Core (下載 MDK 核心)**。
1. 輸入並提交您的資訊，以向 Keil 註冊。
1. 用滑鼠右鍵按一下 MDK 可執行檔，並將 Keil MDK 安裝程式儲存到您的電腦。
1. 開啟 Keil MDK 安裝程式並遵循步驟來完成。確定您安裝 MediaTek 裝置套件 (MT76x7 系列)。
## 建立序列連線
使用 USB 纜線將主機板連接至主機電腦。COM 連接埠會出現在 Windows Device Manager 中。如需偵錯，您可以使用終端機公用程式工具 (例如 HyperTerminal 或 TeraTerm)，將工作階段開啟至連接埠。
## 監控雲端的 MQTT 訊息
在執行 FreeRTOS 示範專案之前，您可以在 AWS IoT主控台中設定 MQTT 用戶端，以監控裝置傳送至 AWS雲端的訊息。
**使用 MQTT 用戶端訂閱 AWS IoTMQTT 主題**
1. 登入 [AWS IoT 主控台](https://console.aws.amazon.com/iotv2/)。
1. 在導覽窗格中，選擇**測試**，然後選擇 **MQTT 測試用戶端**以開啟 MQTT 用戶端。
1. 在**訂閱主題**中輸入 ***your-thing-name*example/topic**，然後選擇**訂閱主題**。
當示範專案在您的裝置上成功執行時，您會看到「Hello World！」 多次傳送到您訂閱的主題。
## 使用 Keil MDK 建置和執行 FreeRTOS 示範專案
**在 Keil μVision 中建置 FreeRTOS 示範專案**
1. 從**開始**功能表中，開啟 Keil μVision 5。
1. 開啟 `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx` 專案檔案。
1. 從功能表中，選擇 **Project (專案)**，然後選擇 **Build target (建置目標)**。
程式碼建置完畢後，您即可在 `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf` 中查看示範可執行檔。
**執行 FreeRTOS 示範專案**
1. 將 MediaTek MT7697Hx 開發套件設定為 PROGRAM 模式。
若要將套件設定為 PROGRAM 模式，請按住 **PROG** 按鈕。在 **PROG ** 按鈕仍然按住的情況下，按下並放開 **RESET** 按鈕，然後放開 **PROG** 按鈕。
1. 從功能表中，選擇 **Flash**，然後選擇 **Configure Flash Tools (設定 Flash 工具)**。
1. 在**目標 '`aws_demo`' 的選項**中，選擇**偵錯**索引標籤。選取 **Use (使用)**、將偵錯工具設定為 **CMSIS-DAP Debugger (CMSIS-DAP 偵錯器)**，然後選擇 **OK (確定)**。
1. 從功能表中，選擇 **Flash**，然後選擇 **Download (下載)**。
下載完成時 μVision 會通知您。
1. 使用終端機公用程式來開啟序列主控台視窗。將序列連接埠設定為 115200 bps、非同位、8 位元和 1 個停止位元。
1. 在 MediaTek MT7697Hx 開發套件上，選擇 **RESET (重設)** 按鈕。
## 疑難排解
### 在 Keil μVision 中偵錯 FreeRTOS 專案
目前，您必須先編輯 Keil μVision 隨附的 MediaTek 套件，才能使用 Keil μVision 偵錯 MediaTek 的 FreeRTOS 示範專案。
**編輯 MediaTek 套件以偵錯 FreeRTOS 專案**
1. 在 Keil MDK 安裝資料夾中尋找並開啟 `Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc` 檔案。
1. 將 `flag = Read32(0x20000000);` 的所有執行個體取代為 `flag = Read32(0x0010FBFC);`。
1. 將 `Write32(0x20000000, 0x76877697);` 的所有執行個體取代為 `Write32(0x0010FBFC, 0x76877697);`。
**開始偵錯專案**
1. 從功能表中，選擇 **Flash**，然後選擇 **Configure Flash Tools (設定 Flash 工具)**。
1. 選擇 **Target (目標)** 標籤，然後選擇 **Read/Write Memory Areas (讀取/寫入記憶體區域)**。確認已選取 IRAM1 和 IRAM2 兩者。
1. 選擇 **Debug (偵錯)** 標籤，然後選擇 **CMSIS-DAP Debugger (CMSIS-DAP 偵錯器)**。
1. 開啟 `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c`，並將 `MTK_DEBUGGER` 巨集設定為 `1`。
1. 在 μVision 中重建示範專案。
1. 將 MediaTek MT7697Hx 開發套件設定為 PROGRAM 模式。
若要將套件設定為 PROGRAM 模式，請按住 **PROG** 按鈕。在 **PROG ** 按鈕仍然按住的情況下，按下並放開 **RESET** 按鈕，然後放開 **PROG** 按鈕。
1. 從功能表中，選擇 **Flash**，然後選擇 **Download (下載)**。
下載完成時 μVision 會通知您。
1. 在 MediaTek MT7697Hx 開發套件上，按下 **RESET (重設)** 按鈕。
1. 從 μVision 功能表中，選擇**偵錯**，然後選擇**開始/停止偵錯工作階段**。當您啟動偵錯工作階段時，**Call Stack \$1 Locals (呼叫堆疊 \$1 本機)** 視窗即會開啟。
1. 從選單中選擇 **Debug (偵錯)**，然後選擇 **Stop (停止)** 暫停執行程式碼。程式計數器會停在以下一行：
```
{ volatile int wait_ice = 1 ; while ( wait_ice ) ; }
```
1. 在 **Call Stack \$1 Locals (呼叫堆疊 \$1 本機)** 視窗中，將 `wait_ice` 的值變更為 `0`。
1. 在專案的原始程式碼中設定中斷點，然後執行程式碼。
### 故障診斷 IDE 除錯器設定
如果您無法除錯應用程式，您的除錯器設定可能不正確。
**驗證您的除錯器設定是否正確**
1. 開啟 Keil μVision。
1. 在`aws_demos`專案上按一下滑鼠右鍵，選擇**選項**，然後在**公用程式**索引標籤下，選擇**「-- 使用偵錯驅動程式 --」**旁的**設定**。
1. 驗證 **Debug (除錯)** 索引標籤中的設定如下所示：
![\[具有序號、韌體版本、轉接器類型、SW 裝置選項和組態設定的 CMSIS-DAP Cortex-M 目標驅動程式設定對話方塊。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/mediatek-debug-2.png)
1. 驗證 **Flash Download (Flash 下載)** 索引標籤中的設定如下所示：
![\[Cortex-M 目標驅動程式設定視窗，包含下載函數、演算法的 RAM、程式設計演算法描述和裝置詳細資訊的選項。\]](http://docs.aws.amazon.com/zh_tw/freertos/latest/userguide/images/mediatek-debug-3.png)
如需 FreeRTOS 入門的一般疑難排解資訊，請參閱 [故障診斷入門](gsg-troubleshooting.md)。