MediaTek mt7697Hx 开发套件入门 - FreeRTOS
概览设置开发环境建立串行连接在云上监控 MQTT 消息使用 Keil MDK 构建和运行 FreeRTOS 演示项目故障排除
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

MediaTek mt7697Hx 开发套件入门

重要

此参考集成托管在 Amazon-FreeRTOS 存储库中，该存储库已过时。建议您从这里开始。如果您已经有一个基于现已弃用的 Amazon-FreeRTOS 存储库的 FreeRTOS 项目，请参阅亚马逊 FreeRTOS Github 存储库迁移指南。

本教程提供了 MediaTek mt7697Hx 开发套件的入门说明。如果您没有 MediaTek mt7697Hx 开发套件，请访问Amazon合作伙伴设备目录从我们的合作伙伴处购买。

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

概览

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

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

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

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

  4. 跨串行连接与主板上运行的应用程序进行交互，以便进行监视和调试。

设置开发环境

在设置环境之前，请将计算机连接到 MediaTek mt7697HX 开发套件上的 USB 端口。

下载并安装 Keil MDK。

您可以使用基于 GUI 的 Keil 微控制器开发套件 (MDK) 在主板上配置、构建和运行 FreeRTOS 项目。Keil MDK 包括 μVision IDE 和 μVision 调试器。

注意

只有 Windows 7、Windows 8 和 Windows 10 64 位计算机上支持 Keil MDK。

下载并安装 Keil MDK

  1. 转到 Keil MDK Getting Started (Keil MDK 入门) 页面，然后选择 Download MDK-Core (下载 MDK-Core)。

  2. 输入并提交信息以注册到 Keil。

  3. 右键单击 MDK 可执行文件并将 Keil MDK 安装程序保存到您的计算机。

  4. 打开 Keil MDK 安装程序并按照步骤完成操作。确保您安装了 MediaTek 设备包（MT76x7 系列）。

建立串行连接

使用 USB 电缆将主板Connect 主计算机。Windows 设备管理器中出现COM 端口的互演互演示。要进行调试，您可以使用终端实用工具（例如 HyperTerminal 或）打开与端口的会话 TeraTerm。

在云上监控 MQTT 消息

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

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

  1. 登录到 Amazon IoT 控制台。

  2. 在导航窗格中，选择 “测试”，然后选择 MQTT 测试客户端打开 MQTT 客户端。

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

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

使用 Keil MDK 构建和运行 FreeRTOS 演示项目

在 Keil μVision 中构建 FreeRTOS 演示项目

  1. 从 “开始” 菜单中打开 Keil μVision 5。

  2. 打开 projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx 项目文件。

  3. 从菜单中，选择 Project (项目)，然后选择 Build target (生成目标)。

    生成代码之后，您可以看到位于 projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf 的演示可执行文件。

要运行交互演FreeRTOS 示的项目

  1. 将 MediaTek mt7697Hx 开发套件设置为程序模式。

    要将工具包设置为 PROGRAM 模式，请按住 PROG 按钮。按住 PROG 按钮的同时，按下并释放 RESET 按钮，然后释放 PROG 按钮。

  2. 从菜单中，选择 Flash (闪存)，然后选择 Configure Flash Tools (配置闪存工具)。

  3. 在 Options for Target 'aws_demo' (目标“aws_demo”的选项) 中，选择 Debug (调试) 选项卡。选择 Use (使用)，将调试器设置为 CMSIS-DAP Debugger (CMSIS-DAP 调试器)，然后选择 OK (确定)。

  4. 从菜单中，选择 Flash (闪存)，然后选择 Download (下载)。

    μVision 在下载完成后通知您。

  5. 使用终端实用程序打开串行控制台窗口。将串行端口设置为 115200 bps、无奇偶校验、8 位和 1 个停止位。

  6. 选择 MediaTek mt7697Hx 开发套件上的 “重置” 按钮。

故障排除

在 Keil μVision 中调试 FreeRTOS 项目

目前，必须编辑 Keil μVision 中包含的 MediaTek 软件包，然后才能使用 Keil μVision 调试 Fre MediaTek eRTOS 演示项目。

编辑用于调试 FreeRTOS 项目的 MediaTek 软件包

  1. 查找并打开位于您 Keil MDK 安装程序文件夹中的 Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc 文件。

  2. 将出现的所有 flag = Read32(0x20000000); 替换为 flag = Read32(0x0010FBFC);。

  3. 将出现的所有 Write32(0x20000000, 0x76877697); 替换为 Write32(0x0010FBFC, 0x76877697);。

开始调试项目

  1. 从菜单中，选择 Flash (闪存)，然后选择 Configure Flash Tools (配置闪存工具)。

  2. 选择 Target (目标) 选项卡，然后选择 Read/Write Memory Areas (读/写内存区域)。确认 IRAM1 和 IRAM2 均已选中。

  3. 选择 Debug (调试) 选项卡，然后选择 CMSIS-DAP Debugger (调试器)。

  4. 打开 vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c，并将宏 MTK_DEBUGGER 设置为 1。

  5. 在 μVision 中重建演示项目。

  6. 将 MediaTek mt7697Hx 开发套件设置为程序模式。

    要将工具包设置为 PROGRAM 模式，请按住 PROG 按钮。按住 PROG 按钮的同时，按下并释放 RESET 按钮，然后释放 PROG 按钮。

  7. 从菜单中，选择 Flash (闪存)，然后选择 Download (下载)。

    μVision 在下载完成后通知您。

  8. 按下 MediaTek mt7697Hx 开发套件上的重置按钮。

  9. 从 μVision 菜单中选择 “调试”，然后选择 “启动/停止调试会话”。在您启动调试会话时将打开 Call Stack + Locals (调用堆栈 + 本地) 窗口。

  10. 从菜单中，选择 Debug (调试)，然后选择 Stop (停止) 以暂停代码执行。程序计数器在以下行停止：

    { volatile int wait_ice = 1 ; while ( wait_ice ) ; }

  11. 在 Call Stack + Locals (调用堆栈 + 局部变量) 窗口上，将 wait_ice 的值更改为 0。

  12. 在项目源代码中设置断点，然后运行代码。

解决 IDE 调试器设置的问题

如果您在调试应用程序时遇到问题，则调试器设置可能不正确。

验证您的调试器设置是否正确

  1. 打开 Keil μVision。

  2. 右键单击aws_demos项目，选择 “选项”，然后在 “实用工具” 选项卡下选择 “--使用调试驱动程序--” 旁边的设置。

  3. 验证 Debug (调试) 选项卡下的设置是否如下所示：

  4. 验证 Flash Download (闪存下载) 选项卡下的设置是否如下所示：

有关 FreeRTOS 入门的一般故障排除信息，请参阅问题排查入门。