SSD1306 + ESP32:十分钟点亮你的第一块屏
准备材料
- XK-OLED-096-YB — 0.96寸 I2C OLED(黄蓝双色)
- 任意 ESP32 开发板(C3 Super Mini 很好用)
- 杜邦线 4 根
接线
| OLED 引脚 | ESP32 |
|---|---|
| VCC | 3V3 |
| GND | GND |
| SCL | GPIO 22 |
| SDA | GPIO 21 |
代码
在 Arduino 库管理器安装 Adafruit SSD1306 和 Adafruit GFX,然后烧录:
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
Adafruit_SSD1306 display(128, 64, &Wire, -1);
void setup() {
display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(SSD1306_WHITE);
display.setCursor(0, 0);
display.println("Hello, DooMaker!");
display.display();
}
void loop() {}
上电,第一行字就亮在玻璃上了——就这么点事。
常见坑
- 完全不亮:约三分之一的模块出厂地址是
0x3D而不是0x3C,换一下再试。 - 花屏:先跑一遍 I2C 扫描例程确认地址,别急着怪屏幕。
- ESP32-C3 Super Mini:默认 I2C 引脚不同——在
display.begin()之前加Wire.begin(5, 6);(SDA=5,SCL=6)。