2. 搭建PIC32 USB开发环境
PIC32 USB设备开发的第一步不是写代码，而是把“工具链—框架—硬件”三者的关系理顺。很多初学者在安装完 MPLAB X IDE 后直接新建工程，结果在 Harmony 配置阶段遇到器件支持包缺失、编译器版本不匹配、USB 时钟无法锁定等问题，最终卡在枚举阶段。本节围绕一条可复现的环境搭建路径展开：先确定硬件平台，再安装 IDE 与编译器，最后用 Harmony 生成一个可编译、可下载、可枚举的 USB 工程骨架。
一、硬件平台选型：先看USB外设与时钟能力
PIC32 家族中并非所有型号都带 USB 模块。选型时优先确认三点：是否集成 USB Device/Host/OTG 控制器、是否有独立的 USB PLL、封装是否便于调试。以教学与原型验证为目标，常见选择如下：
| 开发板/器件 | USB能力 | 典型用途 | 注意事项 |
|---|---|---|---|
| PIC32MX250F128B | USB Device/Host/OTG | 入门HID、CDC | 需外部12MHz晶振，USB PLL需正确配置 |
| PIC32MX470F512L | USB OTG | 音频、复合设备 | 引脚多，适合扩展 |
| PIC32MZ EF系列 | USB HS/FS | 高速数据采集 | Harmony 3 支持较新，注意器件包版本 |
| Curiosity PIC32MX470开发板 | USB Micro-B | 官方示例直接运行 | 板载调试器，无需额外工具 |
若目标是快速验证 USB 通信，建议选择带板载调试器的 Curiosity 或 Starter Kit 系列，避免额外购买 PICkit/ICD 调试器。硬件确定后，记录两个关键参数：主晶振频率（常见 8MHz 或 12MHz）和 USB 所需时钟（全速 48MHz）。这两个值将直接决定 Harmony 中时钟树的配置。
二、MPLAB X IDE 与编译器安装
MPLAB X IDE 是 Microchip 官方集成开发环境，当前主流版本为 v6.x。安装时注意：IDE 本身不包含编译器，需要单独安装 XC32 编译器。PIC32 使用 XC32，而非 XC8/XC16。推荐组合为 MPLAB X IDE v6.15 + XC32 v4.35，二者兼容性经过验证。
安装顺序建议：先装 XC32，再装 MPLAB X IDE。这样 IDE 启动后能自动扫描到编译器路径。安装完成后，在 Tools → Options → Embedded → Build Tools 中确认 XC32 已被识别。若显示红色感叹号，手动指定安装目录下的 bin 文件夹即可。
-O1 或 -O0 即可。三、Harmony 框架的获取与工程创建
Harmony 是 Microchip 的固件框架，提供 USB 协议栈、外设驱动和中间件。PIC32 上主要使用 Harmony 3（MHC，MPLAB Harmony Configurator）。它不是一个独立安装的软件，而是以插件形式集成在 MPLAB X IDE 中。
安装方式：在 MPLAB X IDE 中打开 Tools → Plugins，在 Available Plugins 中勾选 MPLAB Harmony 3 Configurator 并安装。安装后重启 IDE。随后还需要下载 Harmony 3 的器件支持包（Device Family Pack）和 USB 组件包。推荐通过 Tools → Embedded → MPLAB Harmony 3 Content Manager 在线获取，选择 csp（芯片支持包）和 usb 两个仓库。
创建工程的正确流程是：File → New Project → Microchip Embedded → 32-bit MPLAB Harmony 3 Project。在向导中选择目标器件（如 PIC32MX470F512L），指定 Harmony 框架路径，然后进入 MHC 配置界面。此时工程结构会自动生成，包含 config、firmware 等目录。
四、时钟与USB模块配置要点
Harmony 中最容易出错的是时钟树。以 12MHz 晶振、目标 48MHz USB 时钟为例，典型配置为：
SPLL 输入：12 MHz / 3 = 4 MHz
SPLL 倍频：4 MHz × 24 = 96 MHz
系统时钟：96 MHz / 2 = 48 MHz
USB 时钟源：SPLL 输出，经 USB 分频器得到 48 MHz在 MHC 的 Clock Configuration 中，需要确保 USB 时钟分支显示为 48MHz，且没有红色警告。若 USB 时钟偏离 48MHz，设备枚举会失败，主机端表现为“未知设备”或反复断开重连。
USB 模块配置在 Harmony → USB 中完成。选择 USB Device 模式，根据应用选择功能类：HID 用于键盘鼠标，CDC 用于虚拟串口，Audio 用于音频流。配置完成后点击 Generate Code，Harmony 会生成初始化代码和 USB 描述符框架。
五、编译、下载与枚举验证
代码生成后，直接点击 Build。若出现 undefined reference to USB_DEVICE_... 之类的链接错误，通常是 USB 组件包未正确加载，回到 Content Manager 确认 usb 仓库已勾选并重新生成代码。
下载使用板载调试器时，在工程属性中确认 Hardware Tool 选择正确。下载成功后，将 USB 线插入主机。在 Windows 设备管理器中观察：若出现“未知 USB 设备（设备描述符请求失败）”，说明枚举未完成，优先检查时钟是否为 48MHz；若出现正确的设备名称（如 HID Keyboard），说明枚举成功。
进一步验证通信：对于 CDC 设备，打开串口助手，选择对应的 COM 口，发送任意字符，若设备端回显，则数据通路正常。对于 HID 设备，可用在线 HID 测试工具查看报告描述符是否被正确解析。
Clock Configuration 中确认 Primary Oscillator 已使能，且 USB Clock 分支显示为 48MHz 绿色状态。六、环境搭建检查清单
在进入下一阶段开发前，逐项确认以下内容，可避免绝大多数环境类问题：
- XC32 编译器版本与 MPLAB X IDE 兼容，且在 Build Tools 中显示为可用。
- Harmony 3 的
csp与usb组件包已下载，器件支持包与目标芯片一致。 - 时钟树中 USB 分支为 48MHz，无红色警告。
- USB 模式选择正确（Device/Host/OTG），功能类与目标应用匹配。
- 工程编译无错误，下载后主机能识别设备，无“未知设备”提示。
- 串口/HID 测试工具能正常收发数据。