手把手教你用Arduino Nano驱动0.96寸OLED（IIC接口，含完整库文件）-编程阁

手把手教你用Arduino Nano驱动0.96寸OLED（IIC接口，含完整库文件）

第一次拿到0.96寸OLED模块时，我被它小巧的尺寸和清晰的显示效果惊艳到了。这种微型显示屏在创客项目中特别实用，无论是制作便携式气象站、迷你游戏机，还是智能家居控制面板，都能派上大用场。本文将带你从零开始，一步步完成Arduino Nano与0.96寸OLED的IIC接口连接、库文件安装和基础编程，让你在30分钟内就能让屏幕亮起来显示自定义内容。

1. 硬件准备与连接

1.1 所需材料清单

在开始之前，请确保你已准备好以下物品：

Arduino Nano开发板（或其他兼容板如UNO）
0.96寸OLED显示屏（IIC接口，通常为4针）
杜邦线（母对母）4根
微型USB数据线
电脑（已安装Arduino IDE）

特别注意：市场上常见的0.96寸OLED模块主要有两种接口类型：

7针SPI/IIC兼容接口
4针纯IIC接口

本文针对的是更简单的4针IIC版本，它的引脚排列通常如下：

引脚标号	功能说明
GND	电源地
VCC	3.3V-5V电源输入
SCL	IIC时钟线
SDA	IIC数据线

1.2 接线示意图

将OLED模块与Arduino Nano连接非常简单，只需4根线：

OLED模块 → Arduino Nano ----------------------------- GND → GND VCC → 3.3V或5V SCL → A5（或标为SCL的引脚） SDA → A4（或标为SDA的引脚）

提示：虽然OLED模块支持3.3V-5V供电，但建议优先使用3.3V以避免潜在问题。如果使用5V供电，屏幕亮度会更高但发热量也会稍大。

2. 软件环境配置

2.1 安装必要的库文件

Arduino社区为OLED开发了多个优秀的库，我们推荐使用U8g2库，因为它支持最广泛的OLED控制器（包括SSD1306），且功能强大。

在Arduino IDE中安装库的步骤：

点击"工具"→"管理库..."
在搜索框中输入"U8g2"
找到"U8g2 by oliver"并点击安装
等待安装完成

2.2 验证库安装

安装完成后，可以通过以下方法验证：

打开Arduino IDE
点击"文件"→"示例"
在弹出菜单中查看是否存在"U8g2"分类
如果能看到多个U8g2示例程序，说明安装成功

3. 基础示例代码解析

3.1 Hello World示例

让我们从最简单的显示文本开始。打开Arduino IDE，新建一个项目，输入以下代码：

#include <U8g2lib.h> // 初始化U8g2库，根据你的OLED型号选择正确的构造函数 U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0); void setup() { u8g2.begin(); // 初始化显示屏 } void loop() { u8g2.clearBuffer(); // 清除内部缓冲区 u8g2.setFont(u8g2_font_ncenB08_tr); // 设置字体 u8g2.drawStr(0,20,"Hello World!"); // 在坐标(0,20)处绘制文字 u8g2.sendBuffer(); // 将缓冲区内容发送到显示屏 delay(1000); }

代码解析：

#include <U8g2lib.h>- 引入U8g2库头文件
U8G2_SSD1306_128X64_NONAME_F_HW_I2C- 指定OLED型号和通信方式
u8g2.begin()- 初始化显示屏
clearBuffer()和sendBuffer()- U8g2采用双缓冲机制，先清空缓冲区，绘制完成后统一发送

3.2 常见显示功能扩展

掌握了基础显示后，可以尝试更多功能：

void loop() { // 显示不同大小的文字 u8g2.clearBuffer(); u8g2.setFont(u8g2_font_6x10_tr); u8g2.drawStr(0,10,"Small Text"); u8g2.setFont(u8g2_font_10x20_tr); u8g2.drawStr(0,30,"Medium Text"); u8g2.setFont(u8g2_font_fub17_tr); u8g2.drawStr(0,60,"Large Text"); u8g2.sendBuffer(); delay(2000); // 绘制图形 u8g2.clearBuffer(); u8g2.drawFrame(5,5,118,54); // 绘制矩形框 u8g2.drawDisc(64,32,20); // 绘制实心圆 u8g2.drawHLine(10,32,108); // 绘制水平线 u8g2.sendBuffer(); delay(2000); }

4. 常见问题与解决方案

4.1 编译错误排查

问题1：编译时报错"U8g2lib.h: No such file or directory"

原因：U8g2库未正确安装
解决：重新按照2.1节步骤安装库

问题2：上传成功后屏幕无显示

检查电源连接是否正常（VCC和GND）
确认IIC线（SDA、SCL）连接正确
尝试调整OLED模块背面的电阻位置（有些模块需要手动选择IIC模式）

4.2 显示异常处理

现象1：屏幕显示乱码或部分显示

可能原因：缓冲区未正确清除
解决：确保每次更新显示前调用clearBuffer()

现象2：显示内容闪烁

可能原因：刷新频率过高
解决：在loop()中添加适当的delay()

4.3 性能优化技巧

减少刷新频率：OLED屏幕寿命与刷新次数相关，非必要不刷新
使用局部刷新：对于部分内容更新，可以使用setPartialUpdate()方法
选择合适的字体：大字体占用更多内存，可能影响性能

5. 高级应用实例

5.1 创建简易菜单系统

以下代码展示如何实现一个简单的两级菜单：

#include <U8g2lib.h> U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0); const char *menuItems[] = {"Temperature", "Humidity", "Settings"}; int currentSelection = 0; void drawMenu() { u8g2.clearBuffer(); u8g2.setFont(u8g2_font_6x10_tr); for(int i=0; i<3; i++) { if(i == currentSelection) { u8g2.drawBox(0, i*15, 128, 12); // 选中项背景高亮 u8g2.setDrawColor(0); // 设置绘制颜色为背景色 } u8g2.drawStr(5, 10 + i*15, menuItems[i]); u8g2.setDrawColor(1); // 恢复默认绘制颜色 } u8g2.sendBuffer(); } void setup() { u8g2.begin(); pinMode(2, INPUT_PULLUP); // 连接按钮到D2引脚 pinMode(3, INPUT_PULLUP); // 连接按钮到D3引脚 } void loop() { if(digitalRead(2) == LOW) { // 上移选择 currentSelection = (currentSelection + 2) % 3; drawMenu(); delay(200); } if(digitalRead(3) == LOW) { // 下移选择 currentSelection = (currentSelection + 1) % 3; drawMenu(); delay(200); } }

5.2 实时数据显示

结合传感器，可以创建实时数据显示界面。以下示例模拟温度数据显示：

float temperature = 25.0; void drawTempScreen() { u8g2.clearBuffer(); // 绘制标题 u8g2.setFont(u8g2_font_10x20_tr); u8g2.drawStr(15, 20, "Temperature"); // 绘制温度值 u8g2.setFont(u8g2_font_fub30_tr); char tempStr[10]; dtostrf(temperature, 4, 1, tempStr); u8g2.drawStr(25, 55, tempStr); // 绘制单位 u8g2.setFont(u8g2_font_10x20_tr); u8g2.drawStr(100, 55, "C"); // 绘制边框 u8g2.drawFrame(0, 0, 128, 64); u8g2.sendBuffer(); } void setup() { u8g2.begin(); // 这里可以添加温度传感器初始化代码 } void loop() { // 模拟温度变化 temperature += 0.1; if(temperature > 30.0) temperature = 25.0; drawTempScreen(); delay(500); }