Microchip Curiosity PIC32MZ EF 入门 - FreeRTOS
概览设置 Microchip Curiosity PIC32MZ EF 硬件使用板载 PICkit (PKOB) 设置 Microchip Curiosity PIC32MZ EF 硬件设置开发环境监控 MQTT 消息生成并运行 FreeRTOS 演示项目问题排查
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Microchip Curiosity PIC32MZ EF 入门

重要

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

注意

根据与 Microchip 的协议，我们将从 FreeRTOS 参考集成存储库的主分支中删除 Curiosity PIC32MZEF (DM320104)，并将不再在新版本中使用它。Microchip 已发布官方通知，不再推荐 PIC32MZEF (DM320104) 用于新设计。仍可通过之前的版本标签访问 PIC32MZEF 项目和源代码。Microchip 建议客户使用好奇号 PIC32MZ-EF-2.0 开发板 (DM320209) 进行新设计。pic32mzv1 平台仍然可以在 FreeRTOS 参考集成存储库的 v202012.00 中找到。但是，FreeRTOS 参考的 v202107.00 不再支持该平台。

本教程提供有关 Microchip Curiosity PIC32MZ EF 入门的说明。如果您没有 Microchip Curiosity PIC32MZ EF 套装，请访问Amazon合作伙伴设备目录从我们的合作伙伴处购买。

该包包含以下项目：

您还需要以下项目以进行调试：

在开始之前，您必须进行配置Amazon IoT并下载 FreeRTOS 才能将设备连接到Amazon云端。有关说明，请参阅初始步骤：

重要

  • 在本主题中，FreeRTOS 下载目录的路径被称为freertos。

  • freertos 路径中的空格字符可能会导致构建失败。克隆或复制存储库时，请确保您创建的路径不包含空格字符。

  • Microsoft Windows 上的文件路径最大长度为 260 个字符。FreeRTOS 下载目录路径过长可能会导致构建失败。

  • 由于源代码可能包含符号链接，因此如果您使用 Windows 提取存档，则可能必须：

    这样，Windows 可以在提取存档时正确创建符号链接。否则，符号链接将被写成普通文件，其中包含符号链接的路径为文本或为空。有关更多信息，请参阅 S ystem Links! 。

    如果你在 Windows 下使用 Git，则必须启用开发者模式，或者必须：

    • 使用以下core.symlinks命令设置为 true：

      git config --global core.symlinks true

    • 每当你使用写入系统的 git 命令（例如、、git pull和git submodule update --init --recursive）时，都要使用升级为管理员的控制台。git clone

概览

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

  1. 将主板连接到主机。

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

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

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

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

设置 Microchip Curiosity PIC32MZ EF 硬件

  1. 将 MikroElectronika USB UART click Board Connect 到 Microchip Curiosity PIC32MZ EF 上的 microBUS 1 连接器。

  2. 将 PIC32 LAN8720 PHY 子板连接到 Microchip Curiosity PIC32MZ EF 上的 J18 接头。

  3. 使用 USB A MikroElectronika 转 USB mini-B 电缆Connect USB UART click Board 连接到您的计算机。

  4. 要将主板连接到 Internet，请使用以下选项之一：

    • 要使用 Wi-Fi，请将 Wi- MikroElectronika Fi 7 click Board 连接到 Microchip Curiosity PIC32MZ EF 上的 microBUS 2 连接器。请参阅 配置 FreeRTOS 演示。

    • 要使用以太网将 Microchip Curiosity PIC32MZ EF Board 连接到 Internet，请将 PIC32 LAN8720 PHY 子板连接至 Microchip Curiosity PIC32MZ EF 上的 J18 接头。将以太网电缆的一端连接到 LAN8720 PHY 子板。将另一端连接到路由器或其他 Internet 端口。您还必须定义预处理器宏PIC32_USE_ETHERNET。

  5. 将角度连接器焊接到 Microchip Curiosity PIC32MZ EF 上的 ICSP 接头。

  6. 将 PICkit 3 Programming Cable Kit 中的 ICSP 线缆的一端连接到 Microchip Curiosity PIC32MZ EF。

    如果您没有 PICkit 3 Programming Cable Kit，则可以改用 M-F Dupont 跳线进行连接。请注意，白色圆圈表示针脚 1 的位置。

  7. 将 ICSP 线缆的另一端（或跳线）连接到 MPLAB Snap Debugger。8 针 SIL 编程连接器的针脚 1 由板右下部上的黑色三角形标记。

    确保 Microchip Curiosity PIC32MZ EF 上到针脚 1 的任何线缆连接（由白色圆圈指示）与 MPLAB Snap Debugger 上的针脚 1 对齐。

    有关 MPLAB 快照调试器的更多信息，请参阅 MPLAB S nap In-Circuit 调试器信息表。

使用板载 PICkit (PKOB) 设置 Microchip Curiosity PIC32MZ EF 硬件

我们建议您按照上一节中的安装过程进行操作。但是，您可以按照以下步骤使用集成的 PicKit On Board (PKOB) 程序员/调试器评估和运行具有基本调试功能的 FreeRTOS 演示。

  1. 将 MikroElectronika USB UART click Board Connect 到 Microchip Curiosity PIC32MZ EF 上的 microBUS 1 连接器。

  2. 要将主板连接到 Internet，请执行以下操作之一：

    • 要使用 Wi-Fi，请将 Wi- MikroElectronika Fi 7 click Board 连接到 Microchip Curiosity PIC32MZ EF 上的 microBUS 2 连接器。（按照 配置 FreeRTOS 演示 中的步骤“配置您的 Wi-Fi”操作。

    • 要使用以太网将 Microchip Curiosity PIC32MZ EF Board 连接到 Internet，请将 PIC32 LAN8720 PHY 子板连接至 Microchip Curiosity PIC32MZ EF 上的 J18 接头。将以太网电缆的一端连接到 LAN8720 PHY 子板。将另一端连接到路由器或其他 Internet 端口。您还必须定义预处理器宏PIC32_USE_ETHERNET。

  3. 使用 A 型 USB 到 USB micro-B 电缆将 Microchip Curiosity PIC32MZ EF Board 上的 USB micro-B 端口“USB DEBUG”连接到计算机。

  4. 使用 USB A MikroElectronika 转 USB mini-B 电缆Connect USB UART click Board 连接到您的计算机。

设置开发环境

注意

这款设备的 FreeRTOS 项目基于 MPLAB Harmony v2。要构建项目，您需要使用与 Harmony v2 兼容的 MPLAB 工具版本，例如 MPLAB XC32 编译器的 v2.10，以及 MPLAB Harmony Configurator (MHC) 的版本 2.X.X。

  1. 安装 Python 版本 3.x 或更高版本。

  2. 安装 MPLAB X IDE：

    注意

    FreeRTOSAmazon 参考集成 v202007.00 目前仅支持 mplabv5.35。mplabv5.40 支持以前版本的 FreeRTOSAmazon 参考集成。

    mplabv5.35 下载
    最新 mpLab 下载 (mplabv5.40)

  3. 安装 MPLAB XC32 编译器：

  4. 启动一个 UART 终端仿真器，使用以下设置建立连接：

    • 波特率：115200

    • 数据：8 位

    • 奇偶校验：无

    • 停止位：1

    • 流控制：无

监控 MQTT 消息

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

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

  1. 登录到 Amazon IoT 控制台。

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

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

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

生成并运行 FreeRTOS 演示项目

在 MPLAB IDE 中打开 FreeRTOS 演示

  1. 打开 MPLAB IDE。如果您要安装多个版本的编译器，则需要选择要在 IDE 中使用的编译器。

  2. 从 File (文件) 菜单中，选择 New Project (新建项目)。

  3. 浏览到并打开 projects/microchip/curiosity_pic32mzef/mplab/aws_demos。

  4. 选择 Open project (打开项目)。

注意

当您首次打开项目时，可能会收到一条有关编译器的错误消息。在 IDE 中，导航到 Tools (工具)、Options (选项)、Embedded (嵌入式)，然后选择您要用于项目的编译器。

要使用以太网进行连接，必须定义预处理器宏PIC32_USE_ETHERNET。

使用 MPLAB IDE 使用以太网进行连接

  1. 在 MPLAB IDE (MPLAB IDE) 中，右键单击项目并选择 Prop er ts

  2. 在 “项目属性” 对话框中，选择 “编译器名称（全局选项）” 将其展开，然后选择 “编译器名称- gcc”。

  3. 对于 “选项” 类别，选择 “预处理和消息”，然后将PIC32_USE_ETHERNET字符串添加到预处理器宏中。

运行 FreeRTOS 演示项目

  1. 重新生成您的项目。

  2. 在项目选项卡上，右键单击 aws_demos 顶级文件夹，然后选择调试。

  3. 当调试器在 main() 中的断点停止时，在 Run (运行) 菜单中选择 Resume (恢复)。

使用 CMake 构建 FreeRTOS 演示

如果您不想使用 IDE 进行 FreeRTOS 开发，也可以使用 CMake 来构建和运行演示应用程序或使用第三方代码编辑器和调试工具开发的应用程序。

使用 CMake 构建 FreeRTOS 演示

  1. 创建一个包含生成的构建文件的目录，例如 build-directory。

  2. 使用以下命令从源代码生成构建文件。

    cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin  -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder
    注意

    必须指定 Hexmate 和工具链二进制文件的正确路径，例如C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin和C:\Program Files\Microchip\xc32\v2.40\bin路径。

  3. 将目录更改为构建目录（build-directory），然后make从该目录运行。

有关更多信息，请参阅 在 FreeRTOS 中使用 cMake。

要使用以太网进行连接，必须定义预处理器宏PIC32_USE_ETHERNET。

问题排查

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