1. 硬件准备与连接
ESP32-S3搭配1.3寸OLED(SH1306)是一个性价比很高的组合,特别适合需要显示中文或复杂图形的物联网项目。我实际测试过好几款OLED屏,发现1.3寸的SH1306在显示面积上比常见的0.96寸大了30%,但分辨率保持128x64不变,这意味着每个像素点更大,显示效果更清晰。
1.1 硬件对比
市面上常见的OLED主要有两种驱动芯片:SSD1306和SH1306。很多人以为它们完全兼容,其实有些细微差别。SH1306内部自带升压电路,对电压波动更宽容,实测中即使用3.3V供电也能稳定工作。而SSD1306在电压低于3.5V时容易出现显示异常。另一个区别是SH1306的显示缓冲区管理方式更高效,刷新率可以做到更高。
我对比过几种常见的OLED尺寸:
- 0.96寸:最普及,但显示面积小,适合简单信息
- 1.3寸:显示面积增加30%,适合中文和图形显示
- 1.5寸:分辨率提升到128x128,但需要更多驱动资源
对于大多数项目,1.3寸是个甜点选择,既能显示足够内容,又不会占用太多GPIO资源。
1.2 硬件连接方案
接线其实很简单,但有几个坑我踩过,你们可以避免。OLED一般有4个引脚:GND、VCC、SCL、SDA。ESP32-S3的GPIO矩阵很灵活,几乎任何引脚都可以用作I2C,但要注意有些引脚有特殊功能。
推荐接线方案:
OLED → ESP32-S3
GND → GND
VCC → 3.3V (实测5V也能用,但3.3V更稳定)
SCL → GPIO21
SDA → GPIO47
为什么选21和47?这两个引脚默认没有其他功能,不容易冲突。有些教程推荐用默认的I2C引脚(GPIO8和9),但这些引脚经常被其他外设占用,比如SD卡模块。我一开始用默认引脚,结果插上SD卡后OLED就不工作了,调试了半天才发现是引脚冲突。
电源方面要注意:虽然OLED标称工作电压是3.3V-5V,但我实测发现用3.3V供电更稳定。用5V时偶尔会出现显示乱码,特别是当ESP32-S3高负载运行时。建议始终使用3.3V供电,避免不必要的麻烦。
2. 开发环境配置
2.1 Arduino IDE设置
首先确保你的Arduino IDE已经安装了ESP32-S3支持。打开IDE,进入"文件→首选项",在"附加开发板管理器网址"中添加:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
然后到"工具→开发板→开发板管理器",搜索"esp32"并安装最新版本。安装完成后,在开发板列表中选择"ESP32S3 Dev Module"。
重要设置:
- USB Mode: USB-OTG
- USB CDC On Boot: Enabled
- CPU Frequency: 240MHz
- Flash Size: 根据你的板子选择,一般是8MB
- Partition Scheme: Default 8MB with spiffs
这些设置影响程序运行稳定性,特别是USB CDC选项必须开启,否则串口输出可能不正常。
2.2 安装必要的库
我们需要两个库:Wire(I2C通信)和OLED驱动库。Wire库通常已经内置,不需要额外安装。
对于SH1306,我测试过几个驱动库,最稳定的是"ThingPulse OLED SSD1306"库。在Arduino IDE中,点击"项目→加载库→管理库",搜索"SSD1306",找到"SSD1306 by ThingPulse"并安装。
这个库对SH1306兼容性更好,而且支持中文显示。安装完成后,记得重启IDE让库生效。
3. I2C地址扫描与验证
3.1 I2C扫描代码
在写完整驱动之前,一定要先确认硬件连接正确。我养成了习惯,任何I2C设备先跑一遍扫描程序,这样可以避免很多不必要的调试时间。
这里有个增强版的I2C扫描代码,不仅能发现设备,还能检测常见的连接问题:
#include <Wire.h>
#define SDA_PIN 47
#define SCL_PIN 21
void setup() {
Serial.begin(115200);
wh
1094



被折叠的 条评论
为什么被折叠?



