3. 开发环境搭建与第一个图形工程
PIC32 图形 HMI 的开发环境不是单一软件，而是一条从“编译器 → IDE → 外设配置与中间件 → 图形库 → 硬件下载调试”的完整工具链。理解这条链上每个环节的职责，比记住安装顺序更重要：MPLAB X IDE 是承载工程与调试的容器，XC32 编译器把 C 代码翻译成 PIC32 可执行的机器码，MPLAB Harmony v3 提供外设驱动、中间件与代码生成框架，图形库（如 Microchip 的 Legato 或第三方 LVGL）则负责把像素画到屏幕上。四者版本必须相互匹配，否则最常见的现象就是工程能编译、但屏幕不亮或花屏。
工具链的组成与依赖关系
下表给出本节使用的工具链角色与典型版本示例。版本号仅为示例，实际应以 Harmony v3 对应器件系列的发布说明为准。
| 组件 | 作用 | 示例版本 |
|---|---|---|
| MPLAB X IDE | 工程管理、代码编辑、调试与烧录 | v6.20 |
| XC32 编译器 | 将 C 源码编译为 PIC32 目标代码 | v4.35 |
| MPLAB Harmony v3 | 外设驱动、中间件、代码配置器（MCC） | v3.18 |
| 图形库 | 图形绘制、控件、图层与显示驱动适配 | Legato / LVGL |
| 器件支持包（DFP） | 器件头文件、链接脚本、启动代码 | PIC32MZ DFP |
安装顺序建议为：先装 MPLAB X IDE，再装 XC32 编译器，随后安装 Harmony v3 与器件支持包，最后引入图形库。Harmony v3 通过 MCC（MPLAB Code Configurator）以插件形式集成在 IDE 中，安装完成后需在 IDE 的 Tools → Plugins 中确认 MCC 已启用。
创建第一个图形工程的完整过程
下面以 PIC32MZ EF 系列搭配 RGB565 并口 TFT 为例，说明从零到点亮屏幕的关键操作。示例参数属于教学假设，实际引脚与时钟需按开发板原理图调整。
- 新建工程：File → New Project → 32-bit MPLAB Harmony Project，选择目标器件（如 PIC32MZ2048EFM100），编译器选择 XC32，工程名设为
gfx_hello。 - 启动 MCC：在项目树中点击 MCC 图标，进入 Harmony 配置界面。首先配置时钟：外部晶振 24 MHz，经 PLL 倍频至 200 MHz 系统时钟，确保外设时钟满足显示控制器时序要求。
- 配置显示接口：在 Peripheral 中启用 PMP（并行主端口）或 EBI，数据宽度设为 16 位，配置读写时序的等待周期。若使用 SPI 屏，则改为配置 SPI 与 GPIO 的 DC、CS、RST 引脚。
- 添加图形组件：在 Middleware 中选择 Graphics，添加 Display Driver 与 Graphics Library，绑定到已配置的显示接口，设置分辨率（如 480×272）与像素格式 RGB565。
- 生成代码：点击 Generate，MCC 会生成
config/default/下的初始化代码与app.c框架。 - 编写显示逻辑：在应用层调用图形库 API 绘制内容。
// app.c 中初始化后绘制一个填充矩形与文字
GFX_SetColor(GFX_COLOR_BLUE);
GFX_RectangleFillDraw(0, 0, 480, 272);
GFX_SetColor(GFX_COLOR_WHITE);
GFX_SetFont(GFX_FONT_DEFAULT);
GFX_TextDraw("PIC32 HMI Ready", 120, 130, 0);
编译通过后，通过 ICD4 或 PKOB 调试器连接目标板，点击 Make and Program Device。若屏幕出现蓝色背景与白色文字，说明工具链、显示驱动与图形库已正确贯通。
常见问题与判断依据
屏幕不亮时，按以下顺序排查：先确认背光与电源引脚电压是否正常；再用示波器观察 PMP 的写信号与片选是否有波形；若波形正常但无显示，检查初始化序列中的复位延时是否满足数据手册要求；若显示花屏，多为像素格式或时序等待周期不匹配。编译报错则优先检查 Harmony 与 DFP 版本是否对应，以及 XC32 是否被 IDE 正确识别。