esp32驱动oled显示屏

### ESP32 驱动 OLED 显示屏教程

为了使 ESP32 成功驱动 OLED 显示屏，需按照特定步骤配置硬件和软件环境。当准备就绪后，在 Arduino IDE 中编写并上传代码来控制显示内容。

#### 硬件连接
对于Lolin32 OLED板或其他兼容设备，应确保正确连接 I2C 接口至 OLED 屏幕。通常情况下，SDA 和 SCL 引脚会自动匹配开发板上的默认设置；然而，如果需要自定义，则可以修改代码中的引脚分配[^2]。

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels

// Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)
#define OLED_RESET    -1 // Reset pin # (or -1 if sharing Arduino reset pin)
#define SCREEN_ADDRESS 0x3C ///< See datasheet for Address; 0x3D for 128x64, 0x3C for 128x32
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

此段程序初始化了一个基于 Adafruit 库的SSD1306对象实例，并指定了屏幕尺寸以及I2C地址。注意这里假设使用的OLED分辨率为128×64像素，如果是其他分辨率则需调整相应参数。

#### 初始化与测试绘制图形
接下来的部分展示了如何启动显示器并与之交互：

void setup() {
  Serial.begin(115200);

  // Initialize the OLED display using Wire library object
  if(!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) {
    Serial.println(F("SSD1306 allocation failed"));
    for(;;); // Don't proceed, loop forever
  }
  
  delay(2000); // Pause after any errors to read them
  
  // Show initial display buffer contents on the screen --
  // the library initializes this with an Adafruit splash screen.
  display.display();
  delay(2000); // Pause for two seconds
  
  // Clear the buffer
  display.clearDisplay();

  // Draw a single pixel in white
  display.drawPixel(10, 10, WHITE);
}

void loop() {
}

上述代码片段实现了基本的功能验证——即通过串行监视器输出错误消息（如果有），接着展示库自带的欢迎画面两秒钟后再清除画布并在指定位置绘制单个白色像素点作为简单的视觉反馈。

#### 完整示例：显示文字信息
下面给出一段完整的例子用来说明怎样向屏幕上打印字符串：

void setup() { 
  // ... 上述setup部分省略 ...
    
  // Set text size and color
  display.setTextSize(1);
  display.setTextColor(WHITE);
  display.setCursor(0,0);
  
  // Display some test messages
  display.print("Hello, world!");
  display.display(); // Actually send the data to be shown on screen
}

void loop() {}

这段扩展后的 `setup()` 函数设置了字体大小、颜色，并定位光标起始坐标以便后续书写操作。最后调用了`print()`方法传入想要呈现的文字序列，再由`display()`函数负责刷新缓冲区使得更改立即生效于物理显示屏上。