MediaTek MT7697Hx 开发工具包入门 - FreeRTOS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

MediaTek MT7697Hx 开发工具包入门

该教程提供有关 MediaTek MT7697Hx 开发工具包入门的说明。如果您没有 MediaTek MT7697Hx Development Kit,请访问 AWS Partner Device Catalog,从我们的合作伙伴购买一个。

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

概览

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

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

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

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

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

设置开发环境

在您设置环境之前,请将计算机连接到 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 Getting Started (Keil MDK 入门) 页面,然后选择 Download MDK-Core (下载 MDK-Core)

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

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

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

建立串行连接

要建立与 MediaTek MT7697Hx 开发工具包的串行连接,您必须安装 Arm Mbed Windows 串行端口驱动程序。您可从 Mbed 下载驱动程序。在 Windows serial driver (Windows 串行驱动程序) 页面上,下载并安装 MediaTek MT7697Hx 开发工具包的驱动程序。

安装驱动程序后,COM 端口显示在 Windows 设备管理器上。如需调试,您可以使用终端实用工具(例如 HyperTerminal 或 TeraTerm)打开与端口的会话。

注意

如果在安装驱动程序后无法连接到主板,则可能需要重新启动计算机。

使用 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 模式。

    要将工具包设置为 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. 在 MT7697Hx MediaTek 开发工具包上选择 RESET 按钮。

在云上监控 MQTT 消息

您可以使用 AWS IoT 控制台中的 MQTT 客户端监控您的设备发送到 AWS 云的消息。

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

  1. 登录 AWS IoT 控制台

  2. 在导航窗格中,选择测试以打开 MQTT 客户端。

  3. Subscription topic (订阅主题)中,输入 iotdemo/#,然后选择 Subscribe to topic (订阅主题)

故障排除

在 Keil μVision 中调试 FreeRTOS 项目

目前,您先必须编辑 Keil μVision 中包含的 MediaTek 包,然后才能调试 MediaTek 与 Keil μVision 的 FreeRTOS 演示项目。

编辑 MediaTek 包用于调试 FreeRTOS 项目

  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 模式。

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

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

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

  8. 在您的 MediaTek MT7697Hx 开发工具包上按 RESET (重置) 按钮。

  9. 从 μVision 菜单,选择 Debug (调试),然后选择 Start/Stop Debug Session (启动/停止调试会话)。在启动调试会话时,将打开 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 项目,选择 Options (选项),然后在 Utilities (实用程序) 选项卡下,选择 “-- Use Debug Driver --”(“-- 使用调试驱动程序 --”) 旁边的 Settings (设置)

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

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

有关 FreeRTOS 入门的常规故障排除信息,请参阅 问题排查入门