用Adafruit_GFX为Arduino打造专业级OLED图形界面

那块不到两寸的OLED屏幕，可能是你硬件项目中最被低估的交互窗口。当大多数开发者还停留在简单的文本显示时，真正的高手已经在用Adafruit_GFX库将这块微型画布变成令人惊艳的视觉界面。我曾在一个环境监测项目中，用动态图表让枯燥的温湿度数据变成了会"呼吸"的视觉化展示，客户的第一反应是"这真的是用Arduino做的吗？"

1. 从基础图形到界面框架

1.1 硬件准备与库配置

选择正确的硬件组合是成功的第一步。SSD1306驱动的128x64 OLED是最平衡的选择——足够的分辨率又不会占用太多内存。接线时注意：

• I2C接口：SCL接A5，SDA接A4（Arduino Uno）
• SPI接口：需要额外连接RES、DC和CS引脚

安装库时，除了Adafruit_SSD1306，必须包含其依赖的Adafruit_GFX库。最新版本支持抗锯齿和高级混合模式：

cpp复制#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);

1.2 图形绘制基础技法

GFX库的绘图API看似简单，但组合使用能产生惊人效果。比如这个绘制渐变进度条的代码：

cpp复制void drawGradientBar(int x, int y, int width, int height, float percent) {
  display.drawRect(x, y, width, height, WHITE);
  for(int i=0; i<width*percent; i++) {
    int color = map(i, 0, width, 0, 255);
    display.drawLine(x+i, y+1, x+i, y+height-1, color);
  }
}

关键绘图函数对比：

| 函数 | 参数示例 | 特性 |
|---