Microchip Curiosity PIC32 MZ EF 入门 - FreeRTOS
概览设置 Microchip Curiosity PIC32 MZ EF 硬件使用 PICkit On Board (PKOB) 设置 PIC32 Microchip Curiosity MZ EF 硬件设置开发环境构建并运行 FreeRTOS 演示项目故障排除

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

Microchip Curiosity PIC32 MZ EF 入门

重要

这是《FreeRTOS 用户指南》的存档版本，可用于 FreeRTOS 版本 202012.00。有关本文档的最新版本，请参阅《FreeRTOS 用户指南》。

本教程提供了 Microchip Curiosity PIC32 MZ EF 入门的说明。如果您没有 Microchip Curios PIC32 ity MZ EF 捆绑包，请访问 AWS 合作伙伴设备目录从我们的合作伙伴处购买。

该包包含以下项目：

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

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

重要

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

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

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

概览

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

  1. 将主板连接到主机。

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

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

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

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

设置 Microchip Curiosity PIC32 MZ EF 硬件

  1. 将 MikroElectronika USB UART click Board 连接到 Microchip Curiosity MZ EF 上的 micro PIC32 Bus 1 连接器。

  2. 将 PIC32 LAN872 0 PHY 子板连接到 Microchip Curiosity PIC32 MZ EF 上的 J18 接头。

  3. 使用 USB A MikroElectronika 转 USB mini-B 电缆将 USB UART click Board 连接到电脑。

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

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

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

  5. 如果还没有完成，请将角度连接器焊接到 Microchip Curiosity PIC32 MZ EF 上的 ICSP 接头上。

  6. 将 ICSP 电缆的一端从 PICkit 3 编程电缆套件连接到 Microchip Curiosity PIC32 MZ EF。

    如果你没有 PICkit 3 个编程电缆套件，你可以改用 M-F Dupont 跳线来接线。请注意，白色圆圈表示针脚 1 的位置。

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

    确保 Microchip Curiosity PIC32 MZ EF 上引脚 1 的所有电缆（以白色圆圈表示）都与 MPLAB Snap Debugger 上的引脚 1 对齐。

    有关 MPLAB Snap Debugger 的更多信息，请参阅 MPLAB Snap 电路内置调试器信息表。

使用 PICkit On Board (PKOB) 设置 PIC32 Microchip Curiosity MZ EF 硬件

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

  1. 将 MikroElectronika USB UART click Board 连接到 Microchip Curiosity MZ EF 上的 micro PIC32 Bus 1 连接器。

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

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

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

  3. 使用 USB A 型转 USB micro-B 电缆将 Microchip Curiosity PIC32 MZ EF 板上名为 “USB DEBUG” 的 USB micro-B 端口连接到电脑。

  4. 使用 USB A MikroElectronika 转 USB mini-B 电缆将 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：

    注意

    FreeRTO AWS S 参考集成 v202007.00 目前仅在 .35 上支持。 MPLabv5.40 支持以前版本的 F AWS reeRTOS 参考集成。 MPLabv5

    MPLabv5.35 次下载
    最新 MPLab 下载次数 (MPLabv5.40)

  3. 安装 MPLAB XC32 编译器：

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

    • 波特率：115200

    • 数据：8 位

    • 奇偶校验：无

    • 停止位：1

    • 流控制：无

构建并运行 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 中右键单击项目，然后选择属性。

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

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

运行 FreeRTOS 演示项目

  1. 重新生成您的项目。

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

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

使用以下方法构建 FreeRTOS 演示 CMake

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

要使用构建 FreeRTOS 演示 CMake

  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从该目录运行。

有关更多信息，请参阅 CMake 与 FreeRTOS 一起使用。

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

在云上监控 MQTT 消息

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

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

  1. 登录 AWS IoT 控制台。

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

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

故障排除

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