Arduino项目实战：用U8g2库+Bounce2为你的OLED屏打造丝滑滚动菜单（避坑SH1106驱动）

Arduino实战：U8g2库与SH1106驱动的OLED菜单系统开发指南

在嵌入式设备开发中，用户界面的设计往往决定了产品的易用性和专业感。对于Arduino爱好者来说，利用OLED屏幕打造流畅的菜单系统是一个既实用又有趣的挑战。本文将深入探讨如何基于U8g2图形库和Bounce2按键库，为SH1106驱动的OLED屏幕构建一个响应迅速、视觉效果专业的菜单系统。

1. 硬件选型与库准备

选择适合的硬件和软件库是项目成功的第一步。市面上常见的OLED屏幕主要采用SSD1306或SH1106驱动芯片，两者在接口和显示效果上略有差异。

SH1106与SSD1306的关键区别：

对于1.3英寸OLED屏幕，SH1106是更常见的选择。在代码中初始化时，需要使用对应的构造函数：

// 对于SH1106驱动的1.3寸OLED U8G2_SH1106_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE); // 对比SSD1306的初始化 U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);

提示：如果屏幕显示异常，首先检查I2C地址是否正确。SH1106通常使用0x3C地址，但某些模块可能需要0x3D。

2. 菜单系统基础架构

一个完整的菜单系统需要处理显示逻辑和用户输入两个核心部分。下面是一个基本的菜单结构实现：

#define MENU_ITEMS 5 const char *menuItems[MENU_ITEMS] = { "系统设置", "网络配置", "传感器校准", "数据记录", "关于" }; int currentSelection = 0; int previousSelection = -1; void drawMenu() { u8g2.clearBuffer(); u8g2.setFont(u8g2_font_wqy16_t_gb2312); // 中文字体 for(int i = 0; i < MENU_ITEMS; i++) { if(i == currentSelection) { u8g2.drawButtonUTF8(10, 20 + i*15, U8G2_BTN_INV, 100, 1, 1, menuItems[i]); } else { u8g2.drawButtonUTF8(10, 20 + i*15, U8G2_BTN_BW0, 100, 1, 1, menuItems[i]); } } u8g2.sendBuffer(); }

这个基础实现创建了一个包含5个选项的垂直菜单，当前选中的项会反色显示。接下来我们需要添加按键交互功能。

3. 按键处理与防抖实现

机械按键的抖动问题会影响菜单操作的准确性。Bounce2库提供了简单有效的防抖解决方案。首先设置按键引脚并初始化：

#include <Bounce2.h> #define BUTTON_UP 2 #define BUTTON_DOWN 3 #define BUTTON_SELECT 4 Bounce upButton = Bounce(); Bounce downButton = Bounce(); Bounce selectButton = Bounce(); void setupButtons() { pinMode(BUTTON_UP, INPUT_PULLUP); pinMode(BUTTON_DOWN, INPUT_PULLUP); pinMode(BUTTON_SELECT, INPUT_PULLUP); upButton.attach(BUTTON_UP); upButton.interval(25); // 25ms防抖间隔 downButton.attach(BUTTON_DOWN); downButton.interval(25); selectButton.attach(BUTTON_SELECT); selectButton.interval(25); }

在主循环中处理按键事件：

void loop() { // 更新按键状态 upButton.update(); downButton.update(); selectButton.update(); // 处理上键按下 if(upButton.fell()) { previousSelection = currentSelection; currentSelection--; if(currentSelection < 0) { currentSelection = MENU_ITEMS - 1; } drawMenu(); } // 处理下键按下 if(downButton.fell()) { previousSelection = currentSelection; currentSelection++; if(currentSelection >= MENU_ITEMS) { currentSelection = 0; } drawMenu(); } // 处理选择键按下 if(selectButton.fell()) { executeMenuItem(currentSelection); } }

4. 高级菜单效果实现

基础菜单功能实现后，我们可以添加更高级的视觉效果提升用户体验。下面实现一个平滑滚动的菜单效果：

int scrollPosition = 0; int targetScrollPosition = 0; const int itemHeight = 15; const int visibleItems = 4; void drawSmoothScrollMenu() { u8g2.clearBuffer(); u8g2.setFont(u8g2_font_wqy16_t_gb2312); // 计算需要显示的菜单项范围 int firstVisible = scrollPosition / itemHeight; int yOffset = -(scrollPosition % itemHeight); for(int i = 0; i < visibleItems + 1; i++) { int itemIndex = firstVisible + i; if(itemIndex >= 0 && itemIndex < MENU_ITEMS) { int yPos = 15 + i * itemHeight + yOffset; if(itemIndex == currentSelection) { u8g2.drawButtonUTF8(10, yPos, U8G2_BTN_INV, 100, 1, 1, menuItems[itemIndex]); } else { u8g2.drawButtonUTF8(10, yPos, U8G2_BTN_BW0, 100, 1, 1, menuItems[itemIndex]); } } } u8g2.sendBuffer(); } void updateScrollPosition() { // 平滑滚动到目标位置 if(scrollPosition < targetScrollPosition) { scrollPosition += min(3, targetScrollPosition - scrollPosition); } else if(scrollPosition > targetScrollPosition) { scrollPosition -= min(3, scrollPosition - targetScrollPosition); } // 更新显示 if(scrollPosition != targetScrollPosition) { drawSmoothScrollMenu(); } } void handleMenuNavigation() { // 确保当前选项在可见范围内 int currentPos = currentSelection * itemHeight; if(currentPos < scrollPosition) { targetScrollPosition = currentPos; } else if(currentPos > scrollPosition + (visibleItems - 1) * itemHeight) { targetScrollPosition = currentPos - (visibleItems - 1) * itemHeight; } updateScrollPosition(); }

这种实现方式创建了一个视口只显示部分菜单项，当选择超出当前显示范围时，菜单会平滑滚动到正确位置，大大提升了视觉效果。

5. SH1106驱动特殊问题解决

SH1106驱动在使用过程中可能会遇到一些特殊问题，以下是常见问题及解决方案：

1. 显示偏移问题

部分SH1106模块会出现显示内容向右偏移的情况，可以通过修改U8g2库的初始化参数解决：

// 在setup()中添加以下代码调整显示偏移 u8g2.sendF("ca", 0x02, 0x10); // 设置列地址低位 u8g2.sendF("ca", 0x10, 0x00); // 设置列地址高位

2. 对比度设置

SH1106的对比度调节范围与SSD1306不同，可能需要调整：

void setOptimalContrast() { u8g2.setContrast(150); // SH1106通常需要更高的对比度值 }

3. 屏幕闪烁问题

如果遇到屏幕闪烁，可以尝试降低刷新频率：

u8g2.setBusClock(400000); // 将I2C时钟频率设为400kHz

6. 菜单系统优化技巧

一个专业的菜单系统还需要考虑以下优化点：

1. 多级菜单实现

通过堆栈结构实现多级菜单导航：

#define MAX_MENU_DEPTH 5 int menuStack[MAX_MENU_DEPTH]; int currentDepth = -1; void pushMenu(int newMenu) { if(currentDepth < MAX_MENU_DEPTH - 1) { currentDepth++; menuStack[currentDepth] = newMenu; } } void popMenu() { if(currentDepth > 0) { currentDepth--; } }

2. 长按/短按区分

利用Bounce2库检测按键时长，实现不同功能：

if(selectButton.read() == LOW) { if(selectButton.currentDuration() > 1000) { // 长按1秒以上 handleLongPress(); } }

3. 动态菜单项

根据系统状态动态改变菜单内容：

void updateMenuItems() { if(systemMode == CONFIG_MODE) { menuItems[0] = "退出配置模式"; } else { menuItems[0] = "进入配置模式"; } }

7. 性能优化与内存管理

在资源有限的Arduino设备上，优化尤为重要：

1. 部分刷新技术

只刷新变化的区域减少闪烁：

void updateMenuSelection() { // 只刷新上一个和当前选中项 if(previousSelection >= 0) { drawMenuItem(previousSelection, false); } drawMenuItem(currentSelection, true); previousSelection = currentSelection; }

2. 使用PROGMEM存储菜单文本

将常量字符串存入程序存储器节省RAM：

const char menuItem1[] PROGMEM = "系统设置"; const char menuItem2[] PROGMEM = "网络配置"; const char* const menuItems[MENU_ITEMS] PROGMEM = { menuItem1, menuItem2, // ... }; void drawMenuItem(int index) { char buffer[20]; strcpy_P(buffer, (char*)pgm_read_word(&(menuItems[index]))); u8g2.drawStr(10, 15 + index*15, buffer); }

3. 合理设置刷新率

通过控制帧率平衡流畅度和性能：

unsigned long lastRefresh = 0; const int REFRESH_INTERVAL = 50; // 20fps void loop() { if(millis() - lastRefresh >= REFRESH_INTERVAL) { drawMenu(); lastRefresh = millis(); } // 其他处理... }

在实际项目中，我发现SH1106驱动的OLED在对比度表现上确实优于SSD1306，特别是在光线较强的环境中。但要注意不同厂商的SH1106模块可能存在初始化参数差异，遇到显示问题时，查阅具体模块的数据手册往往能快速找到解决方案。