企业官网建设流程全解析

1. 项目概述：1.5英寸OLED模块（B型）是什么？

如果你正在寻找一款小巧、高对比度、低功耗的显示方案，用于你的嵌入式项目、智能穿戴设备或者桌面小工具，那么1.5英寸的OLED模块（B型）很可能就是你正在寻找的“那块屏”。我手头这块模块，尺寸刚好，分辨率是128x64像素，采用SSD1306驱动芯片，通过I2C或SPI接口与主控（比如Arduino、ESP32、树莓派Pico）通信。它不像大屏那样耗电和占地方，但显示文字、图标、简单动画的效果却非常惊艳，纯黑背景下的白色像素点，对比度极高，视觉上很舒服。

这个“B型”通常指的是带蓝色滤光片的单色OLED，显示内容为白底蓝字（或蓝底白字），有一种复古的科技感。相比于更常见的0.96英寸OLED，1.5英寸在可视面积上大了不少，能显示更多行文字或更复杂的图形，但又比2英寸以上的屏幕更省电、更易于集成到紧凑型设备中。它解决的，就是在有限的空间和功耗预算内，提供一个清晰、可视角度广、刷新率不错的显示窗口。无论是做一块便携式传感器的读数屏，还是一个迷你游戏机的画面输出，亦或是智能家居中控的状态指示器，它都能胜任。接下来，我就结合自己多次使用的经验，从硬件连接到软件驱动，再到实际应用中的坑点，为你完整拆解这块小屏的玩法。

2. 核心硬件解析与接口选择

拿到一块1.5英寸OLED（B），第一步不是急着写代码，而是先看清楚它的硬件构成和接口定义。这决定了你后续的接线方式和驱动库的选择。

2.1 模块硬件构成与驱动芯片

这块屏的核心是OLED面板本身和驱动芯片SSD1306。SSD1306是一颗非常经典的OLED驱动控制器，它内部集成了显存（GRAM），我们通过单片机发送命令和数据，实际上就是在操作这片显存，SSD1306则会自动、持续地将显存内容扫描到OLED面板上显示出来。1.5英寸、128x64的分辨率，意味着显存大小为128 * 64 / 8 = 1024字节。因为它是单色显示，每个像素用1个bit表示（0熄灭，1点亮），所以8个像素占用1个字节。

模块背面通常会有几个关键元件：SSD1306芯片本身、用于电平转换的稳压芯片（如AMS1117-3.3，将5V输入降至3.3V给屏供电）、以及一组决定通信模式的电阻或跳线帽。这里有一个非常重要的细节：OLED屏本身是3.3V器件，但其逻辑电平兼容性因模块设计而异。很多模块虽然供电是3.3V，但I/O口可以容忍5V输入（因为SSD1306芯片支持5V容忍），但为了保险起见，特别是使用5V逻辑的Arduino Uno时，我强烈建议在SCL和SDA线上串联一个1k-4.7k的电阻作为简单限流，或者直接使用逻辑电平转换模块。

2.2 I2C与SPI接口详解与选型

模块通常支持I2C和SPI两种通信方式，通过焊接背面的电阻或拨动跳线帽来选择。这是第一个需要你做出的关键决策。

I2C模式：

• 优点：接线极其简单，只需要2根信号线（SCL时钟线、SDA数据线），加上电源和地，总共4根线即可工作。节省单片机IO口，适合IO资源紧张的项目。
• 缺点：通信速度相对较慢。对于128x64全屏刷新，需要传输1024字节数据，在标准100kHz的I2C速率下，会感觉到明显的刷屏延迟，不适合需要快速动态画面的应用。
• 引脚：通常标为SDA、SCL、VCC、GND。I2C地址通常是0x3C或0x3D，需要通过一个电阻（或模块上的0Ω电阻）来配置。

SPI模式：

• 优点：通信速度飞快，可以实现很高的刷新率，动画效果流畅。
• 缺点：需要更多的连线。除了电源和地，通常需要SCK（时钟）、SDA/MOSI（数据输入）、CS（片选，低电平有效）、DC（数据/命令选择，高电平为数据，低电平为命令）。有些模块还支持RST（复位）引脚，用于硬件复位屏幕。
• 引脚：通常标为SCK、SDA/MOSI、CS、DC、RST、VCC、GND。

如何选择？

• 追求接线简单、显示静态或慢速更新内容（如传感器数据、菜单）：选I2C。这是最常用、最省事的方式。
• 需要显示动画、游戏画面或进行快速图形刷新：选SPI。虽然线多，但性能提升是质的飞跃。
• 单片机IO口非常充裕：可以优先考虑SPI，为未来可能的功能扩展留出性能余量。
• 单片机IO口紧张（如只用ATtiny85）：只能选I2C。

在我的大多数项目中，如果只是显示文本和简单图标，I2C足矣。但有一次做一个需要显示滚动波形图的项目，I2C的刷新率就成了瓶颈，有明显的闪烁和拖影，后来切换到SPI模式问题立刻解决。所以，选择前一定要明确你的应用对刷新率的要求。

注意：很多模块默认是I2C模式。切换到SPI模式需要你动手焊接或拨动跳线，具体方法一定要查看模块供应商提供的资料，不同厂家的设计可能有细微差别。

3. 软件驱动与环境搭建

硬件连接好后，下一步就是让单片机“认识”并“驱动”这块屏幕。我们以最流行的Arduino平台和ESP32为例，讲解驱动库的安装和基础使用。

3.1 驱动库的选择与安装

对于SSD1306驱动的OLED，Arduino社区有几个非常优秀的库，最常用的是Adafruit SSD1306和Adafruit GFX库。Adafruit SSD1306库负责底层的与SSD1306芯片的通信（I2C或SPI），而Adafruit GFX库则是一个强大的图形库，提供了画点、线、圆、矩形、显示文字等高级功能。

安装步骤：

1. 打开Arduino IDE。
2. 点击“工具” -> “管理库...”。
3. 在搜索框中输入“Adafruit SSD1306”，找到并安装它。通常，安装Adafruit SSD1306库时，它会提示你安装依赖库Adafruit GFX和Adafruit BusIO，一定要一并安装。这是最稳妥的方式。
4. 同样地，你也可以搜索并安装Adafruit GFX库以确保版本最新。

库的配置（关键步骤！）：安装完库后，直接运行示例代码可能会失败。因为我们需要根据自己模块的硬件配置来修改代码中的几个关键参数。打开文件->示例->Adafruit SSD1306->ssd1306_128x64_i2c（如果你用I2C）。

在代码开头，你会看到这样的定义：

#define SCREEN_WIDTH 128 // OLED显示宽度，像素 #define SCREEN_HEIGHT 64 // OLED显示高度，像素 #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);

• SCREEN_ADDRESS：这是I2C地址。用I2C时，先用I2C扫描工具（Arduino IDE有示例代码Wire->scanner）扫描一下，确认你的模块地址是0x3C还是0x3D，然后修改这里。
• OLED_RESET：如果模块有独立的RST引脚连接到单片机某个GPIO，就把-1改成那个引脚编号（如4）。如果没有连接，就保持-1（使用软件复位）。
• 最后一行Adafruit_SSD1306 display(...)：这是创建显示对象。对于I2C，第四个参数是&Wire（表示使用Wire硬件I2C）。对于SPI，你需要使用另一个示例ssd1306_128x64_spi，并且对象创建方式不同，需要传入CS、DC、RST的引脚号。

3.2 基础显示功能实现与API详解

驱动库安装配置好后，就可以开始编写第一个显示程序了。所有的操作都围绕display这个对象进行。

基础流程框架：

#include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> // ... 引脚和地址定义 ... Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); void setup() { Serial.begin(9600); // 初始化OLED，如果失败则卡住 if(!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) { Serial.println(F("SSD1306 allocation failed")); for(;;); // 死循环，停止执行 } // 清除缓冲区（全黑） display.clearDisplay(); // 设置一些基础属性 display.setTextSize(1); // 字体大小 1（6x8像素） display.setTextColor(SSD1306_WHITE); // 绘制白色文字（在单色屏上就是点亮像素） display.setCursor(0, 0); // 设置光标起始位置为(0,0)左上角 display.cp437(true); // 使用完整的Code Page 437字符集（推荐） // 你的显示代码... display.display(); // 将缓冲区内容真正发送到屏幕显示！这一步必不可少！ } void loop() { // 动态更新内容放在这里 }

核心API解析：

• display.clearDisplay()：清空内部的显示缓冲区（GRAM的软件映射），让整个屏幕变黑。它只操作缓冲区，不立即更新屏幕。
• display.setTextSize(n)：设置文本大小，n为整数倍放大。1是原始大小（6x8），2就是12x16，以此类推。放大是整像素放大，可能会有锯齿。
• display.setTextColor(color)：设置文本颜色。对于单色屏，通常就是SSD1306_WHITE（点亮）和SSD1306_BLACK（熄灭）。有些库支持SSD1306_INVERSE（反色）。
• display.setCursor(x, y)：设置接下来打印文本的起始坐标（像素单位）。原点(0,0)在屏幕左上角。
• display.print()或display.println()：打印文本或变量，和Serial的用法一样。
• display.display()：这是最关键的一步！前面所有draw或print操作都只是在内存缓冲区里画画。只有调用display()，才会把整个缓冲区的内容一次性发送到SSD1306的显存中，屏幕画面才会更新。频繁调用display()会影响刷新率，通常是一帧画面所有元素画完后调用一次。

图形绘制示例：

// 画一个矩形框 display.drawRect(10, 10, 50, 30, SSD1306_WHITE); // 画一个实心矩形 display.fillRect(70, 10, 40, 20, SSD1306_WHITE); // 画一条线 display.drawLine(0, 0, 127, 63, SSD1306_WHITE); // 画一个圆 display.drawCircle(64, 32, 20, SSD1306_WHITE); // 画一个单像素点 display.drawPixel(100, 40, SSD1306_WHITE);

掌握了这些基础API，你已经可以完成80%的显示需求了。记住一个原则：先构思好整帧画面，在缓冲区里用各种draw和print命令“画”出来，最后用一条display()命令“拍板”更新到屏幕。

4. 高级应用与性能优化技巧

当基础显示满足不了你，或者你遇到了闪烁、残影、内存不足等问题时，就需要用到一些高级技巧和优化手段了。

4.1 双缓冲与局部刷新以消除闪烁

直接频繁调用display()进行全屏刷新，尤其是在绘制动画时，会导致明显的屏幕闪烁。这是因为display()函数在向屏幕传输数据时，屏幕会有一个短暂的更新过程。

解决方案：双缓冲。但SSD1306本身硬件不支持双缓冲，我们可以在软件层面模拟。不过，更简单有效的方法是局部刷新。Adafruit库的display()函数默认是全屏刷新。我们可以通过修改底层库（有一定难度），或者优化我们的绘制逻辑来减少不必要的全局刷新。

优化策略1：只更新变化的部分。比如一个数字时钟，只有秒位在快速变化。你可以这样做：

1. 在旧秒数显示的位置，用fillRect画一个黑色矩形块覆盖旧数字。
2. 在新位置打印新的秒数。
3. 调用display()。由于你只修改了屏幕上很小的一块区域对应的缓冲区，传输的数据量远小于全屏，刷新速度更快，闪烁感大大降低。

优化策略2：使用display.display()的重载函数。有些版本的Adafruit库（或U8g2库）支持指定刷新区域。但标准Adafruit SSD1306库不直接支持。这时可以考虑换用U8g2库。U8g2库对SSD1306的支持同样优秀，并且内置了更强大的缓冲区和页面刷新机制，能更好地处理动画和闪烁问题。切换到U8g2库需要重新学习一套API，但其功能更全面，字体资源也更丰富。

4.2 自定义字体与图形创建

系统默认的字体很小（6x8），想要显示大号、炫酷的字体或自己的Logo，就需要使用自定义字体和位图。

使用自定义字体：Adafruit GFX库支持使用setFont()函数加载其他字体。字体需要事先从.ttf文件转换过来。Adafruit提供了一个在线工具“GFX Font Converter”和离线工具fontconvert（在库的fontconvert文件夹内）。你可以选择几个关键字符生成一个字体文件，以节省内存。生成的是一个.h头文件，将其放入你的项目文件夹，然后在代码中#include它，并使用display.setFont(&your_font_name)来切换。

创建与显示位图：

1. 准备图片：找一张黑白图片，或用画图工具制作，尺寸不要超过128x64。
2. 转换位图：使用Adafruit提供的“Image2Code”在线工具或lcd-image-converter等软件，将图片转换为C语言数组格式的位图数据。输出格式选择“Arduino Code”，色彩深度选择“Monochrome”。
3. 在代码中使用：

   // 1. 包含位图数组（工具生成的代码会包含一个数组，如 `const unsigned char myBitmap [] PROGMEM = {...}`） // 2. 使用 drawBitmap 函数显示 display.drawBitmap(x, y, myBitmap, width, height, SSD1306_WHITE); // x, y是位图左上角位置 // width, height是位图的宽和高（像素）

注意：大尺寸的位图会占用大量的程序存储空间（Flash）。一个128x64的全屏单色位图需要1024字节。务必注意你的单片机（如ATmega328P的Arduino Uno只有32KB Flash）的剩余空间。

4.3 低功耗设计与屏幕管理

OLED屏的特性是每个像素独立发光，显示黑色时像素点不工作。因此，显示大面积黑色背景本身就是一种省电。但还有进一步的优化空间：

1. 彻底关闭屏幕：SSD1306有一个深度睡眠命令。通过库函数可以调用。例如，使用display.ssd1306_command(SSD1306_DISPLAYOFF)来关闭显示。需要显示时再用display.ssd1306_command(SSD1306_DISPLAYON)打开。这比清屏更省电。
2. 降低刷新率：对于静态显示内容，可以大幅降低loop()中display()的调用频率，比如每秒只更新一次。减少通信次数也能节省功耗。
3. 动态调整亮度：SSD1306支持通过命令设置对比度（亮度）。display.dim(true)可以调低对比度（变暗），display.dim(false)恢复正常。在环境光暗的时候调暗屏幕可以省电。更精细的控制可以使用display.ssd1306_command(SSD1306_SETCONTRAST)后跟一个0-255的对比度值。
4. 硬件断电：如果项目允许，最省电的方式是通过一个MOSFET管或逻辑电平控制的电源模块，直接切断OLED模块的VCC供电。需要显示时再上电并重新初始化。这需要额外的电路，但功耗可以降到几乎为零。

在我的一个太阳能供电的户外气象站项目中，屏幕大部分时间只显示时间，每分钟更新一次数据。我采用了组合策略：正常显示时使用低对比度，在夜间模式（通过光敏电阻判断）下，直接关闭屏幕显示，只有按下按钮时才亮起2秒钟。这使得整个系统的待机时间延长了数倍。

5. 典型项目实战：打造一个桌面系统状态监视器

理论说再多，不如动手做一个项目。我们来用1.5英寸OLED（B）和ESP32，制作一个能显示时间、天气、CPU使用率等信息的桌面小监视器。这个项目会综合运用到网络通信、数据解析和OLED显示刷新。

5.1 硬件连接与项目架构

我们选择ESP32作为主控，因为它自带Wi-Fi，性能强大，且IO口丰富。我们使用I2C连接OLED以简化接线。

接线图（I2C）：

• ESP32 GPIO 21 (SDA) -> OLED SDA
• ESP32 GPIO 22 (SCL) -> OLED SCL
• ESP32 3.3V -> OLED VCC
• ESP32 GND -> OLED GND （如果模块带复位引脚RST，可以接到ESP32的某个GPIO，如GPIO 16，并在代码中配置）

软件架构：

1. 初始化：连接Wi-Fi，初始化OLED屏幕，同步网络时间（NTP）。
2. 主循环：
   • 从网络API获取天气数据（如心知天气、和风天气）。
   • 从系统获取或模拟CPU/内存数据（ESP32上可能需要通过其他方式获取，这里我们先模拟）。
   • 在OLED缓冲区绘制界面：顶部显示时间、日期；中间显示天气图标和温度；底部显示系统状态条。
   • 调用display()更新屏幕。
   • 延时一段时间（如10秒），然后重复。

5.2 代码实现与分步解析

这里给出核心代码框架和关键部分解析。你需要先在Arduino IDE中安装Adafruit SSD1306、Adafruit GFX、WiFi、NTPClient和ArduinoJson库。

#include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #include <WiFi.h> #include <NTPClient.h> #include <WiFiUdp.h> #include <ArduinoJson.h> // OLED配置 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 #define SCREEN_ADDRESS 0x3C Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); // WiFi配置 const char* ssid = "你的WiFi名称"; const char* password = "你的WiFi密码"; // NTP配置 WiFiUDP ntpUDP; NTPClient timeClient(ntpUDP, "ntp.ntsc.ac.cn", 8*3600, 60000); // 中国NTP服务器，东八区 // 天气数据变量 String city = "Beijing"; int temperature = 25; String weather = "Clear"; // 模拟系统数据 int cpuUsage = 42; // % int memoryUsage = 65; // % void setup() { Serial.begin(115200); // 初始化OLED if(!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) { Serial.println("OLED初始化失败！"); while(1); } display.clearDisplay(); display.setTextColor(SSD1306_WHITE); // 连接WiFi display.setCursor(0, 0); display.print("Connecting to WiFi"); display.display(); WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); display.print("."); display.display(); } display.clearDisplay(); display.setCursor(0, 0); display.println("WiFi Connected!"); display.display(); delay(1000); // 初始化NTP客户端 timeClient.begin(); timeClient.update(); } void loop() { // 1. 更新NTP时间 timeClient.update(); String formattedTime = timeClient.getFormattedTime(); String weekDays[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"}; String dayOfWeek = weekDays[timeClient.getDay()]; // 这里简化日期获取，实际应从NTP或RTC获取完整日期 String dateStr = "2023-10-27"; // 示例，应动态获取 // 2. 获取天气数据（这里用模拟数据，实际应调用HTTP API） // simulateFetchWeather(); // 假设我们已经更新了全局变量 temperature, weather // 3. 更新模拟系统数据 cpuUsage = (cpuUsage + random(-5, 5)) % 100; if(cpuUsage < 0) cpuUsage = 0; memoryUsage = (memoryUsage + random(-2, 2)) % 100; if(memoryUsage < 0) memoryUsage = 0; // 4. 绘制界面到OLED缓冲区 display.clearDisplay(); // 4.1 绘制顶部状态栏（时间、日期） display.setTextSize(1); display.setCursor(0, 0); display.print(formattedTime); display.setCursor(90, 0); display.print(dayOfWeek); // 在第二行显示日期 display.setCursor(0, 10); display.print(dateStr); // 画一条分隔线 display.drawLine(0, 20, 127, 20, SSD1306_WHITE); // 4.2 绘制中部天气信息 display.setTextSize(2); display.setCursor(0, 25); display.print(temperature); display.print(" C"); display.setTextSize(1); display.setCursor(0, 50); display.print(weather); // 这里可以添加一个简单的天气图标，用drawBitmap显示预先转换好的位图 // 4.3 绘制底部系统状态条 // 画CPU使用率条 display.setCursor(0, 55); display.print("CPU:"); int cpuBarWidth = map(cpuUsage, 0, 100, 0, 50); display.drawRect(25, 55, 52, 8, SSD1306_WHITE); // 外框 display.fillRect(26, 56, cpuBarWidth, 6, SSD1306_WHITE); // 填充条 display.setCursor(80, 55); display.print(cpuUsage); display.print("%"); // 5. 将缓冲区内容发送到屏幕 display.display(); // 6. 延时，控制刷新频率（例如每10秒更新一次天气，但时间每秒更新） // 更精细的控制可以将时间更新和天气/系统更新放在不同间隔的定时器里 delay(10000); // 本例简化为每10秒全刷新一次 }

关键点解析：

• 数据获取：天气数据需要从免费API获取，会涉及HTTPClient和JSON解析。为了代码清晰，本例中模拟了数据。实际应用中，你需要编写一个fetchWeatherData()函数，在其中发起HTTP请求，并用ArduinoJson库解析返回的JSON数据，填充temperature和weather变量。注意API有调用频率限制。
• 界面布局：在128x64的有限空间内布局信息需要精心设计。使用setCursor定位文本，使用drawRect和fillRect绘制进度条。像素坐标需要反复调试以达到最佳视觉效果。
• 刷新优化：本例为了简单，每10秒全屏刷新一次。更优的做法是使用非阻塞定时，将时间（每秒更新）、天气（每10分钟更新）、系统状态（每5秒更新）的刷新逻辑分开，并只局部更新屏幕上变化的部分。这能有效减少闪烁和功耗。
• 错误处理：网络请求可能会失败。在实际代码中，必须为WiFi.begin()、timeClient.update()和HTTP请求添加超时和重试机制，并在OLED上显示相应的错误状态（如“WiFi Fail”、“API Error”），而不是让程序卡死。

这个项目麻雀虽小，五脏俱全，涵盖了硬件连接、库使用、网络通信、数据解析和用户界面设计，是巩固1.5英寸OLED模块使用的绝佳练习。你可以在此基础上扩展，比如增加更多的传感器数据显示（室内温湿度）、加入按钮进行界面切换、或者让天气图标动起来。

6. 常见问题排查与调试心得

即使按照教程一步步来，也难免会遇到屏幕不亮、显示乱码、内容错位等问题。下面是我在多年使用中总结的一些常见问题及其解决方法。

6.1 硬件连接与电源问题

这是新手最容易出问题的地方。

• 问题：屏幕完全不亮，无任何显示。

  • 检查供电：首先用万用表测量模块VCC和GND之间的电压，确保在3.3V左右。电压过低（<3.0V）可能导致无法启动。注意，有些模块虽然标称3.3V，但接5V也能工作（因为板载稳压芯片），但长期使用有风险，建议按规格书来。
  • 检查接线：确认I2C的SDA、SCL线没有接反，并且接触良好。特别是使用杜邦线时，容易接触不良。可以尝试按压接头或更换线材。
  • 检查地址：运行I2C扫描程序，确认是否能扫描到设备地址（0x3C或0x3D）。如果扫描不到，可能是接线问题、模块损坏，或者I2C/SPI模式跳线设置错误。
  • 检查复位：如果使用了RST引脚，确保它在初始化时有一个正确的复位脉冲（先低后高）。可以尝试在setup()开始时，手动控制该引脚产生一个复位信号。

• 问题：屏幕亮起但显示杂乱的白点或条纹。

  • 初始化失败：这通常是display.begin()函数执行失败，但程序没有正确检测到并停止。确保你的SCREEN_WIDTH、SCREEN_HEIGHT、SCREEN_ADDRESS参数设置正确。
  • 电源噪声：单片机和其他大电流设备（如电机、舵机）共用电源，可能会引入噪声干扰显示。尝试给OLED模块单独供电，或者在VCC和GND之间并联一个10uF-100uF的电解电容进行滤波。
  • 通信干扰：I2C线路过长或靠近干扰源。尽量缩短连线，并在SCL和SDA线上各加一个4.7kΩ的上拉电阻到3.3V（很多模块已经集成，如果通信不稳定可以外接试试）。

6.2 软件库与驱动配置问题

• 问题：编译时报错，提示找不到Adafruit_SSD1306.h或Adafruit_GFX.h。

  • 库未安装：通过库管理器重新安装。注意库名要完全一致。
  • 库版本冲突：有时安装了多个版本。尝试在Arduino IDE的“项目”菜单中“加载库”->“管理库”，卸载所有相关库，然后重新安装最新稳定版。
  • Arduino IDE版本太旧：更新到较新版本。

• 问题：显示内容错位、滚动或镜像。

  • 扫描模式设置：SSD1306支持不同的扫描方向（COM扫描方向、段重映射）。Adafruit库在begin()函数中通常会进行默认设置。如果出现上下颠倒、左右镜像，你可以在setup()中display.begin()之后，使用display.ssd1306_command()发送特定的命令来调整。例如：

    display.ssd1306_command(SSD1306_SEGREMAP | 0x01); // 水平翻转 display.ssd1306_command(SSD1306_COMSCANDEC); // 垂直翻转

    但请谨慎使用，最好先查阅SSD1306数据手册中关于“Set COM Output Scan Direction”和“Set Segment Re-map”的命令。
  • 缓冲区与屏幕尺寸不匹配：确认SCREEN_WIDTH和SCREEN_HEIGHT与你的物理屏幕一致。1.5英寸128x64的模块，就是128和64。

• 问题：显示内容有残影或刷新慢。

  • 全屏刷新频繁：检查代码中是否在loop()里无节制地调用display.display()且前面有大量绘制操作。优化为局部刷新或降低刷新频率。
  • 通信速度慢：对于I2C，尝试提升通信速率。在Wire.begin()之后，可以尝试Wire.setClock(400000L)将I2C时钟设置为400kHz（快速模式）。前提是你的单片机和支持，且接线质量好。
  • 使用SPI模式：如果对刷新率要求高，这是根本解决方案。

6.3 显示内容与内存优化

• 问题：文字显示不全或乱码。

  • 字体设置：确保使用了正确的字体。默认字体只包含ASCII字符。如果你需要显示中文或特殊符号，必须使用包含这些字形的自定义字体，并且用display.setFont()切换到该字体。
  • 编码问题：在代码中直接写中文字符串，需要确保Arduino IDE的文件编码是UTF-8。在“文件”->“首选项”中勾选“显示详细输出”下的“编译”，查看编译信息中是否有编码警告。
  • 光标越界：setCursor设置的坐标超出了屏幕范围。比如在y=60的位置用textSize(2)打印文字，textSize(2)的字符高度约16像素，60+16>64，部分内容就会显示在屏幕之外。

• 问题：程序太大，编译后提示存储空间不足。

  • 自定义字体和位图是空间杀手：检查是否导入了整个中文字库（几MB），或者嵌入了多张全屏位图。只导入项目必需的字符和最小尺寸的位图。
  • 使用F()宏存储字符串：将显示用的固定字符串放入Flash存储，而非RAM。例如：display.print(F(“Hello World”));。这能节省宝贵的RAM空间。
  • 精简库：如果极度紧张，可以考虑使用更轻量级的驱动库，如U8g2的U8x8模式（无图形缓冲区，纯字符模式）或自己编写最基础的驱动函数。

调试OLED模块，串口打印是你的好朋友。在代码关键位置（如初始化成功/失败、WiFi连接状态、数据获取结果）添加Serial.print()语句，能帮你快速定位问题所在。耐心和细致的检查，能解决99%的问题。