1. 项目概述如果你玩过Arduino、ESP32或者树莓派Pico这类微控制器肯定遇到过一个问题怎么把程序运行的状态、传感器的数据或者一些简单的交互界面直观地展示出来用串口监视器看数据流当然可以但不够“酷”也不够便携。这时候一块小巧、清晰又省电的显示屏就成了刚需。在众多选择中基于SSD1306驱动芯片的单色OLED显示屏绝对是嵌入式玩家绕不开的经典。我手头这块Adafruit的128x64像素OLED对角线只有0.96英寸比一枚硬币大不了多少但它的显示效果却让人印象深刻。OLED有机发光二极管和LCD液晶显示器最大的不同在于它是自发光体。每个像素点都是一颗独立的、可以单独开关的白色LED。这意味着它不需要背光板显示纯黑色时像素点完全关闭因此能实现近乎无限的对比度文字和图形看起来异常锐利。这种特性加上它极低的功耗全亮状态下也就20mA左右让它成为了电池供电项目或空间受限设备的绝配。SSD1306这颗驱动芯片是幕后的功臣它负责管理这8192个128x64或4096个128x32像素点并提供了I2C和SPI两种通信方式与主控“对话”。I2C省引脚但速度慢SPI速度快能胜任更复杂的图形刷新但多用几根线。这篇文章我就结合自己多年的折腾经验带你从硬件焊接、协议选择、库安装到用Arduino和CircuitPython写出第一个“Hello World”把这块小屏幕玩转。无论你是刚入门的新手还是想寻找更优驱动方案的老鸟相信都能找到有用的东西。2. 硬件解析与连接方案拿到一块OLED模块第一步不是急着写代码而是搞清楚怎么把它和你的开发板正确地连起来。这一步错了后面全是白费功夫。2.1 认识你的OLED模块市面上常见的SSD1306 OLED模块主要有两种分辨率128x64和128x32。从外观上看128x64的屏幕更长一些。除了分辨率你还需要留意它的版本。新旧版本识别早期的0.96英寸128x64模块我们姑且叫它V1版对电压比较挑剔逻辑和供电都必须严格使用3.3V。而较新的版本包括1.3英寸款和大多数128x32模块以及后期生产的0.96英寸V2版通常在屏幕正面丝印有“5V ready”标记这意味着它们内部集成了电平转换电路可以兼容3.3V和5V系统。如果你不确定手头的版本最保险的做法是先按3.3V供电来连接。接口模式模块背面通常有两组焊盘跳线标记为J1、J2用于选择I2C或SPI通信模式。对于新的STEMMA QT版本带防反插的Qwiic兼容接口出厂默认跳线是闭合的即I2C模式。如果你想用SPI需要用刀片或烙铁小心地割断这两个跳线。老版本则通常是SPI模式出厂需要焊接跳线来启用I2C。2.2 焊接排针与引脚定义模块买来通常是不带排针的第一步永远是焊接。取一段8Pin对于128x64 I2C/SPI或7Pin对于128x32 SPI的直针排母将长脚插入面包板固定然后将OLED模块的孔位对准排针短脚放上去确保模块贴紧面包板以保持垂直最后逐一焊牢。这一步没什么技巧就是手要稳焊锡不要过多导致桥接。焊接好后认清引脚定义至关重要。以最常见的128x64 SPI模块为例引脚通常如下排列从屏幕正面看引脚朝下从左至右GND 电源地。VCC/Vin 电源正极。对于5V兼容版接3.3V或5V均可对于老版务必接3.3V。D0/SCLK SPI时钟线。D1/MOSI SPI数据线主设备输出从设备输入。RES/RST 复位引脚低电平有效。用于硬件复位屏幕。DC 数据/命令选择引脚。这是SPI特有的用于告诉驱动器接下来发送的是命令如设置对比度还是显示数据要画的像素。CS 片选引脚低电平有效。当总线上挂有多个SPI设备时用此引脚选择要通信的OLED。如果是I2C版本引脚会简化很多GND 电源地。VCC/Vin 电源正极。SDA I2C数据线。SCL I2C时钟线。RES/RST 复位引脚部分新款STEMMA QT模块已集成自动复位电路此引脚可省略。2.3 I2C与SPI连接实战I2C连接以Arduino Uno为例 这是最省线的方式只需要4根线如果不用RST则只需2根数据线和2根电源线。OLEDGND- ArduinoGNDOLEDVCC- Arduino5V(或3.3V根据模块版本)OLEDSDA- ArduinoA4(Uno的I2C SDA引脚)OLEDSCL- ArduinoA5(Uno的I2C SCL引脚)OLEDRST- ArduinoDigital 4(可选代码中需对应修改)连接好后你可以通过I2C地址扫描程序Arduino IDE示例中有Wire库的scanner来确认模块是否被正确识别SSD1306的常见地址是0x3C128x32或0x3D128x64。SPI连接以Arduino Uno为例 SPI需要更多连线但换来的是更快的刷新率。Uno的硬件SPI引脚是固定的OLEDGND- ArduinoGNDOLEDVCC- Arduino5V(或3.3V)OLEDD0/SCLK- ArduinoDigital 13(SCK)OLEDD1/MOSI- ArduinoDigital 11(MOSI)OLEDRES/RST- ArduinoDigital 8(可自定义但需与代码一致)OLEDDC- ArduinoDigital 9(可自定义)OLEDCS- ArduinoDigital 10(可自定义但需与代码一致)注意RESET、DC、CS这三个引脚是可以根据你的项目需要连接到任何空闲的数字IO口的只需要在代码初始化时指定正确的引脚号即可。但SCLK和MOSI在Arduino Uno上通常建议使用硬件SPI引脚13和11以获得最佳性能。电源注意事项确认电压 如果是不确定版本的老模块先用3.3V供电测试避免烧毁。电流供应 虽然OLED本身耗电不大但确保你的电源如USB口或稳压模块能提供至少100mA的余量为微控制器和其他传感器留出空间。逻辑电平 即使模块是5V供电其通信引脚SDA/SCL或SPI各线也必须与主控的逻辑电平匹配。如果使用3.3V逻辑的主控如ESP32、树莓派Pico而模块是5V系统中间必须加电平转换器否则可能损坏主控GPIO。3. Arduino开发环境搭建与基础驱动硬件连好了接下来就是让屏幕亮起来。在Arduino世界里Adafruit为我们封装好了几乎一切让驱动OLED变得像调用Serial.print()一样简单。3.1 库的安装与选择你需要安装两个核心库Adafruit_SSD1306和Adafruit_GFX。前者是SSD1306芯片的底层驱动负责处理像素数据发送、初始化序列等脏活累活后者是一个强大的图形库提供了画点、线、圆、矩形、显示文字等高级功能Adafruit_SSD1306库依赖于它。安装方法非常简单打开Arduino IDE依次点击工具 - 管理库...在搜索框中分别输入“Adafruit SSD1306”和“Adafruit GFX”找到后点击安装即可。IDE会自动处理依赖关系如果版本较新它可能还会提示你安装Adafruit_BusIO这个通用总线IO库一并安装就好。安装完成后重启Arduino IDE你就可以在文件 - 示例 - Adafruit SSD1306下找到一大堆示例程序。我强烈建议你首先运行ssd1306_128x64_i2c如果你用的是I2C或ssd1306_128x64_spi如果你用的是SPI。这是验证硬件连接是否正确的“试金石”。3.2 代码解析从初始化到第一幅图像让我们以I2C连接为例拆解一下示例代码的核心部分。理解这些你就能自己写程序了。#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h // 定义屏幕尺寸 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 // 声明一个SSD1306显示对象 // 参数宽度高度Wire对象复位引脚号-1表示不使用硬件复位 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, -1);首先包含必要的头文件并定义屏幕尺寸。最关键的是Adafruit_SSD1306对象的声明。对于I2C我们传入Wire即硬件I2C对象和复位引脚号如果没接就填-1。void setup() { Serial.begin(9600); // 初始化OLEDSSD1306_SWITCHCAPVCC表示使用内部电荷泵生成驱动电压 if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // 地址0x3C或0x3D Serial.println(F(SSD1306分配失败)); for(;;); // 卡住 } // 清空缓冲区 display.clearDisplay(); // 在坐标(10,10)处画一个白点 display.drawPixel(10, 10, SSD1306_WHITE); // 将缓冲区内容发送到屏幕显示 display.display(); }在setup()函数中我们调用display.begin()来初始化屏幕。SSD1306_SWITCHCAPVCC是一个常量它告诉驱动芯片使用内部的开关电容电荷泵来产生OLED所需的高电压这样我们只需要提供3.3V逻辑电源即可非常方便。第二个参数是I2C地址根据你的屏幕型号填写0x3C或0x3D。初始化成功后所有绘图操作都发生在内存中的一个“显示缓冲区”里这个缓冲区大小正好是128x64/81024字节因为1字节存储8个像素。drawPixel()函数修改了缓冲区但屏幕本身还没变化。必须调用display.display()才会把整个缓冲区的内容一次性发送到OLED上显示出来。这种“双缓冲”机制避免了屏幕刷新时的闪烁。3.3 图形与文本绘制实战Adafruit_GFX库的功能非常丰富下面列举几个最常用的函数绘制基本图形// 画线 (起点x, 起点y, 终点x, 终点y, 颜色) display.drawLine(0, 0, 127, 63, SSD1306_WHITE); // 画矩形框 (左上角x, 左上角y, 宽, 高, 颜色) display.drawRect(10, 10, 50, 30, SSD1306_WHITE); // 画实心矩形 display.fillRect(70, 10, 50, 30, SSD1306_WHITE); // 画圆 (圆心x, 圆心y, 半径, 颜色) display.drawCircle(64, 32, 20, SSD1306_WHITE); // 画三角形 (三个顶点的x,y坐标, 颜色) display.drawTriangle(30, 50, 50, 10, 70, 50, SSD1306_WHITE);显示文本 显示文本前通常需要设置字体、大小、颜色和起始光标位置。display.clearDisplay(); display.setTextSize(1); // 设置字体大小1为默认每个字符6x8像素 display.setTextColor(SSD1306_WHITE); // 设置文本颜色白底黑字用SSD1306_BLACK display.setCursor(0, 0); // 设置文本起始坐标左上角 display.println(Hello, World!); // 打印并换行 display.print(Sensor: ); display.print(25.6); display.print( C); display.display();setTextSize()可以放大字体例如设置为2则字符变为12x16像素但屏幕能显示的行数和列数相应减少。显示自定义位图 如果你想显示Logo或小图标需要先将图片转换为C语言数组。这里推荐一个在线工具image2cpp网址javl.github.io/image2cpp。上传你的图片最好是黑白或高对比度设置好尺寸不超过屏幕大小、扫描方式通常选Vertical和输出格式Arduino Code它就会生成一个const unsigned char数组。把这个数组复制到你的代码里然后用drawBitmap()函数显示// 假设你的位图数组叫 myLogo宽32高32 display.drawBitmap((display.width() - 32) / 2, // 居中计算X坐标 (display.height() - 32) / 2, // 居中计算Y坐标 myLogo, 32, 32, SSD1306_WHITE); display.display();3.4 SPI模式下的代码调整如果你使用SPI连接代码的初始化部分有所不同#include SPI.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 // 软件SPI引脚定义可以自定义 #define OLED_MOSI 11 #define OLED_CLK 13 #define OLED_DC 9 #define OLED_CS 10 #define OLED_RESET 8 // 使用软件SPI初始化 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS); // 或者使用硬件SPI速度更快引脚固定 // #define OLED_DC 9 // #define OLED_CS 10 // #define OLED_RESET 8 // Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, // SPI, OLED_DC, OLED_RESET, OLED_CS); void setup() { // 初始化注意这里没有I2C地址参数 if(!display.begin(SSD1306_SWITCHCAPVCC)) { // ... 错误处理 } // ... 其余代码相同 }关键区别在于构造函数的参数。软件SPI需要你指定所有引脚硬件SPI则传入SPI对象并指定DC、RESET、CS这三个控制引脚SCK和MOSI会由硬件SPI接口自动管理在Uno上是13和11脚。4. CircuitPython开发全攻略对于喜欢Python的开发者或者使用像Adafruit ItsyBitsy、Feather M4、树莓派Pico这类支持CircuitPython的板子驱动SSD1306同样简单优雅。CircuitPython的displayio库提供了硬件加速的图形原语支持用起来别有风味。4.1 环境准备与库安装首先确保你的开发板已经刷好了CircuitPython固件。将板子通过USB连接到电脑它会显示为一个名为CIRCUITPY的U盘。驱动SSD1306需要两个库文件adafruit_displayio_ssd1306.mpy和它的依赖adafruit_bus_device。获取它们最简单的方法是使用CircuitPython的库捆绑包CircuitPython Library Bundle。去Adafruit的GitHub发布页面下载对应你CircuitPython版本号的捆绑包解压后找到上述两个.mpy文件将它们复制到CIRCUITPY磁盘的lib文件夹内。如果lib文件夹不存在就新建一个。4.2 硬件连接与I2C初始化在CircuitPython中我们使用board模块来引用板子上的特定引脚这使得代码在不同板子间有很好的可移植性。以下是一个连接I2C OLED到Feather M4 Express的示例import board import displayio import terminalio from adafruit_display_text import label import adafruit_displayio_ssd1306 # 释放任何先前可能占用的显示资源重要 displayio.release_displays() # 创建I2C对象 i2c board.I2C() # 使用板子的默认I2C引脚 # 创建SSD1306 I2C显示对象 display_bus displayio.I2CDisplay(i2c, device_address0x3C) # 地址可能是0x3D display adafruit_displayio_ssd1306.SSD1306(display_bus, width128, height64) # 创建一个显示组Group可以把它想象成一个图层容器 splash displayio.Group() display.show(splash) # 将这个组设置为根组并显示 # 创建一个位图Bitmap尺寸为整个屏幕颜色深度为1单色 color_bitmap displayio.Bitmap(display.width, display.height, 1) # 创建一个调色板Palette单色显示只需要两种颜色 color_palette displayio.Palette(1) color_palette[0] 0xFFFFFF # 白色 # 创建一个TileGrid将位图和调色板关联起来并填充整个屏幕 bg_sprite displayio.TileGrid(color_bitmap, pixel_shadercolor_palette, x0, y0) splash.append(bg_sprite) # 将这个TileGrid添加到组中 # 现在屏幕上应该是一片白色这段代码看起来比Arduino的复杂因为它采用了更现代、更灵活的“显示组Group-位图Bitmap-TileGrid”架构。简单理解Bitmap是内存中的像素数据Palette定义了颜色索引TileGrid将位图“贴”到屏幕的某个位置而Group可以管理多个TileGrid如图层最终display.show()展示这个根组。4.3 显示文本与图形在displayio体系下显示文本需要额外的adafruit_display_text库。复制到lib文件夹后可以这样显示文字# 接上面的代码 # 创建文本标签 text_area label.Label(terminalio.FONT, textHello World!, color0x000000, x10, y10) splash.append(text_area) # 更新文本内容 text_area.text Temp: {:.1f}C.format(24.5) # 如果你想画一个实心矩形可以创建一个新的位图和TileGrid rect_bitmap displayio.Bitmap(50, 30, 1) rect_palette displayio.Palette(1) rect_palette[0] 0x000000 # 黑色 rect_sprite displayio.TileGrid(rect_bitmap, pixel_shaderrect_palette, x40, y20) splash.append(rect_sprite)displayio原生支持绘制基本形状通过vectorio模块但更复杂的图形通常通过加载位图文件.bmp来实现。你可以将一个小尺寸的BMP文件放在CIRCUITPY磁盘上然后用displayio.OnDiskBitmap加载并显示。4.4 SPI连接与性能优化对于SPI连接初始化部分有所不同import board import displayio import busio import adafruit_displayio_ssd1306 displayio.release_displays() # 定义SPI引脚 spi busio.SPI(board.SCK, board.MOSI) # 使用硬件SPI引脚 # 定义控制引脚 dc_pin board.D9 cs_pin board.D10 reset_pin board.D8 # 创建SPI显示总线 display_bus displayio.FourWire(spi, commanddc_pin, chip_selectcs_pin, resetreset_pin) display adafruit_displayio_ssd1306.SSD1306(display_bus, width128, height64)性能提示CircuitPython的displayio在刷新复杂图形时可能不如Arduino的本地代码快。为了获得最佳性能尽量减少display.refresh()或display.show()的调用频率只在内容确实改变时更新。对于动态内容考虑只更新发生变化的部分例如只重绘文本区域而不是整个屏幕。使用display.auto_refresh False手动控制刷新时机在完成所有绘制操作后调用display.refresh()。5. 高级应用与深度优化技巧当基础显示功能满足后你会开始追求更流畅的动画、更低的功耗或者更复杂的UI。这部分分享一些我踩过坑才总结出来的进阶经验。5.1 实现流畅动画与双缓冲在Arduino环境中直接连续调用绘图函数然后display()复杂图形会导致明显的闪烁。这是因为屏幕在逐帧绘制过程中用户能看到中间状态。解决方法是手动实现双缓冲。思路是创建两个与屏幕缓冲区大小相同的数组或使用Adafruit_SSD1306库的底层getBuffer()函数获取指针在一个缓冲区后台缓冲区中完成下一帧的所有绘制计算计算完成后一次性用memcpy或循环快速将这个缓冲区的数据复制到显示库的缓冲区然后调用display.display()。这样屏幕刷新只发生在一瞬间视觉上就流畅了。对于简单的位移动画还有一个技巧不要清空整个屏幕再重画。比如一个小球移动你只需要在旧位置用背景色黑色画一个圆“擦除”它然后在新位置用前景色白色再画一次。这比clearDisplay()drawCircle()display()三步要快得多。5.2 自定义字体与图标管理Adafruit_GFX库自带一种等宽字体但如果你想用更美观的字体就需要使用自定义字体。你需要将TTF或OTF字体文件通过像Adafruit GFX Font Converter这样的工具在线或离线转换成C语言头文件。这个头文件会定义一个很大的字体数据数组和一些字体属性结构体。在代码中包含这个头文件后调用display.setFont(myCustomFont)即可切换字体。需要注意的是自定义字体会占用大量的程序存储空间Flash尤其是中文字体。务必在项目初期评估Flash容量对于ATmega328PUno这种只有32KB Flash的芯片要非常节俭。对于图标建议将所有项目用到的图标合并到一张“精灵图Sprite Sheet”中然后通过drawBitmap()函数配合坐标偏移来显示其中某一个。这比每个图标单独一个数组更节省内存也便于管理。5.3 低功耗设计与睡眠模式在电池供电的物联网传感器项目中显示屏往往是耗电大户。SSD1306 OLED有一个非常实用的特性它支持硬件睡眠模式。在Arduino中你可以通过发送特定的命令来开启或关闭显示而无需断电// 进入睡眠模式极低功耗屏幕关闭 display.ssd1306_command(SSD1306_DISPLAYOFF); // 退出睡眠模式恢复正常显示 display.ssd1306_command(SSD1306_DISPLAYON);更精细的控制可以通过display.dim(true)来调低对比度进而降低功耗或者使用display.clearDisplay()清空缓冲区后再进入睡眠这样唤醒后能快速恢复之前的内容。一个常见的省电策略是微控制器大部分时间处于深度睡眠定时被唤醒如每秒一次。唤醒后读取传感器数据更新OLED显示仅更新变化部分然后立即让OLED进入睡眠最后微控制器自己也再次进入深度睡眠。这样系统平均电流可以降到几十甚至几百微安级别。5.4 多屏管理与SPI总线共享一个项目中用到多个OLED或者OLED与其他SPI设备如SD卡、无线模块共用总线很常见。关键在于处理好片选CS引脚。每个SPI从设备都必须有一个独立的CS引脚。在代码中操作任何一个设备前先将其CS引脚拉低选中操作完成后立即拉高取消选中。Adafruit_SSD1306库在初始化时会要求你指定CS引脚并在内部管理它。你需要确保不同设备的CS引脚不同并且在初始化其他SPI设备如SD库时不要意外地占用或影响了OLED的CS引脚状态。对于I2C地址冲突是主要问题。SSD1306的地址可以通过模块背面的一个电阻或焊盘来修改但大多数模块固定为0x3C或0x3D。如果一定要接两个地址相同的I2C OLED就需要使用I2C多路复用器芯片如TCA9548A或者干脆其中一个改用SPI接口。6. 常见问题排查与实战心得玩硬件没有不踩坑的。下面是我和社区里朋友们常遇到的一些问题及解决办法希望能帮你节省时间。6.1 屏幕不亮或显示乱码这是最常见的问题排查思路如下检查电源和接地万用表量一下VCC和GND之间是不是3.3V或5V。确保GND和开发板的GND是连通的。电源接反会瞬间烧毁模块。检查通信引脚再三确认SDA/SCL或SPI各线是否接对了开发板的引脚特别是那些可自定义的引脚代码里的定义和实际接线必须一致。检查I2C地址用I2C扫描程序确认地址。如果是0x00或扫描不到通常是接线错误、电源问题或模块损坏。SSD1306常见地址是0x3C但有些是0x3D。在代码begin()函数里改一下试试。检查复位引脚如果使用了硬件复位RST确保它在初始化时有一个从低到高的跳变过程。有些库的示例代码将复位引脚设为-1共享MCU复位如果你的RST接了单独引脚这里必须改成对应的引脚号。检查库版本和初始化参数确保Adafruit_SSD1306和Adafruit_GFX库是最新的。初始化时屏幕尺寸SCREEN_WIDTH,SCREEN_HEIGHT必须与实际模块匹配。128x32的屏用了128x64的初始化可能会显示错乱。SPI模式下的特殊问题确认DC和CS引脚是否接对且初始化正确。如果屏幕上出现规律的纵向条纹或错位很可能是SPI时钟频率太高。可以尝试在begin()之后调用display.setClock(frequency)降低SPI时钟速度比如降到1MHz试试。6.2 显示内容闪烁或残影刷新太快在loop()中不加延迟地连续调用clearDisplay()- 绘图 -display()可能会因为刷新过快导致电源不稳或控制器响应不及。在每次display()后加一个短暂的delay(1)或许能改善。电源不足OLED在点亮大量像素时瞬时电流较大。如果使用开发板的3.3V输出同时还在驱动其他传感器可能导致电压被拉低。尝试给OLED单独供电或者给开发板接上更稳定的电源如2A以上的USB适配器。对比度问题有时不是闪烁而是对比度太低看起来像残影。尝试在初始化后调用display.setContrast(255)把对比度调到最高看看。display.dim(false)可以关闭低对比度模式。6.3 内存不足与优化在Arduino Uno2KB RAM上驱动128x64 OLED需要1KB显示缓冲区再加上一些变量和字符串内存会非常紧张。编译通过但运行异常如重启、乱码往往是内存溢出堆栈冲突导致的。优化策略使用F()宏将字符串常量存放到程序存储空间Flash而不是RAM。例如display.println(F(Temperature:));。减少全局变量尽量使用局部变量函数执行完即释放。精简缓冲区Adafruit_SSD1306库默认分配全尺寸缓冲区。如果你的应用只显示文本可以考虑使用Adafruit_SSD1306库的“内存节约”模式但某些图形功能会受限。分段处理避免在内存中构建巨大的字符串或图形缓冲区。需要显示动态数据时分部分生成和显示。6.4 关于“白屏”或“全亮”有时上电后屏幕全白但程序似乎运行正常。这通常是初始化序列没有正确执行。确保display.begin()函数返回true。如果返回false检查I2C/SPI通信。对于某些克隆模块或特定批次标准的初始化命令可能不兼容。可以尝试在begin()之前手动发送复位脉冲pinMode(OLED_RESET, OUTPUT); digitalWrite(OLED_RESET, LOW); delay(10); digitalWrite(OLED_RESET, HIGH); delay(10);在极少数情况下可能需要修改库中的初始化命令序列。这涉及深入库文件不到万不得已不要尝试优先考虑更换模块或查找针对该模块的特定分支库。最后分享一个我个人的习惯在项目初期我会单独写一个最简单的“点亮测试”程序只包含初始化和显示一个固定图案。用这个程序来验证硬件连接和基础功能隔离问题。当这个测试通过后再把复杂的业务逻辑加进去这样能最大程度地避免软硬件问题纠缠在一起无从下手。
SSD1306 OLED屏幕驱动全攻略：从Arduino到CircuitPython实战
发布时间：2026/5/18 14:23:31
1. 项目概述如果你玩过Arduino、ESP32或者树莓派Pico这类微控制器肯定遇到过一个问题怎么把程序运行的状态、传感器的数据或者一些简单的交互界面直观地展示出来用串口监视器看数据流当然可以但不够“酷”也不够便携。这时候一块小巧、清晰又省电的显示屏就成了刚需。在众多选择中基于SSD1306驱动芯片的单色OLED显示屏绝对是嵌入式玩家绕不开的经典。我手头这块Adafruit的128x64像素OLED对角线只有0.96英寸比一枚硬币大不了多少但它的显示效果却让人印象深刻。OLED有机发光二极管和LCD液晶显示器最大的不同在于它是自发光体。每个像素点都是一颗独立的、可以单独开关的白色LED。这意味着它不需要背光板显示纯黑色时像素点完全关闭因此能实现近乎无限的对比度文字和图形看起来异常锐利。这种特性加上它极低的功耗全亮状态下也就20mA左右让它成为了电池供电项目或空间受限设备的绝配。SSD1306这颗驱动芯片是幕后的功臣它负责管理这8192个128x64或4096个128x32像素点并提供了I2C和SPI两种通信方式与主控“对话”。I2C省引脚但速度慢SPI速度快能胜任更复杂的图形刷新但多用几根线。这篇文章我就结合自己多年的折腾经验带你从硬件焊接、协议选择、库安装到用Arduino和CircuitPython写出第一个“Hello World”把这块小屏幕玩转。无论你是刚入门的新手还是想寻找更优驱动方案的老鸟相信都能找到有用的东西。2. 硬件解析与连接方案拿到一块OLED模块第一步不是急着写代码而是搞清楚怎么把它和你的开发板正确地连起来。这一步错了后面全是白费功夫。2.1 认识你的OLED模块市面上常见的SSD1306 OLED模块主要有两种分辨率128x64和128x32。从外观上看128x64的屏幕更长一些。除了分辨率你还需要留意它的版本。新旧版本识别早期的0.96英寸128x64模块我们姑且叫它V1版对电压比较挑剔逻辑和供电都必须严格使用3.3V。而较新的版本包括1.3英寸款和大多数128x32模块以及后期生产的0.96英寸V2版通常在屏幕正面丝印有“5V ready”标记这意味着它们内部集成了电平转换电路可以兼容3.3V和5V系统。如果你不确定手头的版本最保险的做法是先按3.3V供电来连接。接口模式模块背面通常有两组焊盘跳线标记为J1、J2用于选择I2C或SPI通信模式。对于新的STEMMA QT版本带防反插的Qwiic兼容接口出厂默认跳线是闭合的即I2C模式。如果你想用SPI需要用刀片或烙铁小心地割断这两个跳线。老版本则通常是SPI模式出厂需要焊接跳线来启用I2C。2.2 焊接排针与引脚定义模块买来通常是不带排针的第一步永远是焊接。取一段8Pin对于128x64 I2C/SPI或7Pin对于128x32 SPI的直针排母将长脚插入面包板固定然后将OLED模块的孔位对准排针短脚放上去确保模块贴紧面包板以保持垂直最后逐一焊牢。这一步没什么技巧就是手要稳焊锡不要过多导致桥接。焊接好后认清引脚定义至关重要。以最常见的128x64 SPI模块为例引脚通常如下排列从屏幕正面看引脚朝下从左至右GND 电源地。VCC/Vin 电源正极。对于5V兼容版接3.3V或5V均可对于老版务必接3.3V。D0/SCLK SPI时钟线。D1/MOSI SPI数据线主设备输出从设备输入。RES/RST 复位引脚低电平有效。用于硬件复位屏幕。DC 数据/命令选择引脚。这是SPI特有的用于告诉驱动器接下来发送的是命令如设置对比度还是显示数据要画的像素。CS 片选引脚低电平有效。当总线上挂有多个SPI设备时用此引脚选择要通信的OLED。如果是I2C版本引脚会简化很多GND 电源地。VCC/Vin 电源正极。SDA I2C数据线。SCL I2C时钟线。RES/RST 复位引脚部分新款STEMMA QT模块已集成自动复位电路此引脚可省略。2.3 I2C与SPI连接实战I2C连接以Arduino Uno为例 这是最省线的方式只需要4根线如果不用RST则只需2根数据线和2根电源线。OLEDGND- ArduinoGNDOLEDVCC- Arduino5V(或3.3V根据模块版本)OLEDSDA- ArduinoA4(Uno的I2C SDA引脚)OLEDSCL- ArduinoA5(Uno的I2C SCL引脚)OLEDRST- ArduinoDigital 4(可选代码中需对应修改)连接好后你可以通过I2C地址扫描程序Arduino IDE示例中有Wire库的scanner来确认模块是否被正确识别SSD1306的常见地址是0x3C128x32或0x3D128x64。SPI连接以Arduino Uno为例 SPI需要更多连线但换来的是更快的刷新率。Uno的硬件SPI引脚是固定的OLEDGND- ArduinoGNDOLEDVCC- Arduino5V(或3.3V)OLEDD0/SCLK- ArduinoDigital 13(SCK)OLEDD1/MOSI- ArduinoDigital 11(MOSI)OLEDRES/RST- ArduinoDigital 8(可自定义但需与代码一致)OLEDDC- ArduinoDigital 9(可自定义)OLEDCS- ArduinoDigital 10(可自定义但需与代码一致)注意RESET、DC、CS这三个引脚是可以根据你的项目需要连接到任何空闲的数字IO口的只需要在代码初始化时指定正确的引脚号即可。但SCLK和MOSI在Arduino Uno上通常建议使用硬件SPI引脚13和11以获得最佳性能。电源注意事项确认电压 如果是不确定版本的老模块先用3.3V供电测试避免烧毁。电流供应 虽然OLED本身耗电不大但确保你的电源如USB口或稳压模块能提供至少100mA的余量为微控制器和其他传感器留出空间。逻辑电平 即使模块是5V供电其通信引脚SDA/SCL或SPI各线也必须与主控的逻辑电平匹配。如果使用3.3V逻辑的主控如ESP32、树莓派Pico而模块是5V系统中间必须加电平转换器否则可能损坏主控GPIO。3. Arduino开发环境搭建与基础驱动硬件连好了接下来就是让屏幕亮起来。在Arduino世界里Adafruit为我们封装好了几乎一切让驱动OLED变得像调用Serial.print()一样简单。3.1 库的安装与选择你需要安装两个核心库Adafruit_SSD1306和Adafruit_GFX。前者是SSD1306芯片的底层驱动负责处理像素数据发送、初始化序列等脏活累活后者是一个强大的图形库提供了画点、线、圆、矩形、显示文字等高级功能Adafruit_SSD1306库依赖于它。安装方法非常简单打开Arduino IDE依次点击工具 - 管理库...在搜索框中分别输入“Adafruit SSD1306”和“Adafruit GFX”找到后点击安装即可。IDE会自动处理依赖关系如果版本较新它可能还会提示你安装Adafruit_BusIO这个通用总线IO库一并安装就好。安装完成后重启Arduino IDE你就可以在文件 - 示例 - Adafruit SSD1306下找到一大堆示例程序。我强烈建议你首先运行ssd1306_128x64_i2c如果你用的是I2C或ssd1306_128x64_spi如果你用的是SPI。这是验证硬件连接是否正确的“试金石”。3.2 代码解析从初始化到第一幅图像让我们以I2C连接为例拆解一下示例代码的核心部分。理解这些你就能自己写程序了。#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h // 定义屏幕尺寸 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 // 声明一个SSD1306显示对象 // 参数宽度高度Wire对象复位引脚号-1表示不使用硬件复位 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, -1);首先包含必要的头文件并定义屏幕尺寸。最关键的是Adafruit_SSD1306对象的声明。对于I2C我们传入Wire即硬件I2C对象和复位引脚号如果没接就填-1。void setup() { Serial.begin(9600); // 初始化OLEDSSD1306_SWITCHCAPVCC表示使用内部电荷泵生成驱动电压 if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // 地址0x3C或0x3D Serial.println(F(SSD1306分配失败)); for(;;); // 卡住 } // 清空缓冲区 display.clearDisplay(); // 在坐标(10,10)处画一个白点 display.drawPixel(10, 10, SSD1306_WHITE); // 将缓冲区内容发送到屏幕显示 display.display(); }在setup()函数中我们调用display.begin()来初始化屏幕。SSD1306_SWITCHCAPVCC是一个常量它告诉驱动芯片使用内部的开关电容电荷泵来产生OLED所需的高电压这样我们只需要提供3.3V逻辑电源即可非常方便。第二个参数是I2C地址根据你的屏幕型号填写0x3C或0x3D。初始化成功后所有绘图操作都发生在内存中的一个“显示缓冲区”里这个缓冲区大小正好是128x64/81024字节因为1字节存储8个像素。drawPixel()函数修改了缓冲区但屏幕本身还没变化。必须调用display.display()才会把整个缓冲区的内容一次性发送到OLED上显示出来。这种“双缓冲”机制避免了屏幕刷新时的闪烁。3.3 图形与文本绘制实战Adafruit_GFX库的功能非常丰富下面列举几个最常用的函数绘制基本图形// 画线 (起点x, 起点y, 终点x, 终点y, 颜色) display.drawLine(0, 0, 127, 63, SSD1306_WHITE); // 画矩形框 (左上角x, 左上角y, 宽, 高, 颜色) display.drawRect(10, 10, 50, 30, SSD1306_WHITE); // 画实心矩形 display.fillRect(70, 10, 50, 30, SSD1306_WHITE); // 画圆 (圆心x, 圆心y, 半径, 颜色) display.drawCircle(64, 32, 20, SSD1306_WHITE); // 画三角形 (三个顶点的x,y坐标, 颜色) display.drawTriangle(30, 50, 50, 10, 70, 50, SSD1306_WHITE);显示文本 显示文本前通常需要设置字体、大小、颜色和起始光标位置。display.clearDisplay(); display.setTextSize(1); // 设置字体大小1为默认每个字符6x8像素 display.setTextColor(SSD1306_WHITE); // 设置文本颜色白底黑字用SSD1306_BLACK display.setCursor(0, 0); // 设置文本起始坐标左上角 display.println(Hello, World!); // 打印并换行 display.print(Sensor: ); display.print(25.6); display.print( C); display.display();setTextSize()可以放大字体例如设置为2则字符变为12x16像素但屏幕能显示的行数和列数相应减少。显示自定义位图 如果你想显示Logo或小图标需要先将图片转换为C语言数组。这里推荐一个在线工具image2cpp网址javl.github.io/image2cpp。上传你的图片最好是黑白或高对比度设置好尺寸不超过屏幕大小、扫描方式通常选Vertical和输出格式Arduino Code它就会生成一个const unsigned char数组。把这个数组复制到你的代码里然后用drawBitmap()函数显示// 假设你的位图数组叫 myLogo宽32高32 display.drawBitmap((display.width() - 32) / 2, // 居中计算X坐标 (display.height() - 32) / 2, // 居中计算Y坐标 myLogo, 32, 32, SSD1306_WHITE); display.display();3.4 SPI模式下的代码调整如果你使用SPI连接代码的初始化部分有所不同#include SPI.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 // 软件SPI引脚定义可以自定义 #define OLED_MOSI 11 #define OLED_CLK 13 #define OLED_DC 9 #define OLED_CS 10 #define OLED_RESET 8 // 使用软件SPI初始化 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, OLED_MOSI, OLED_CLK, OLED_DC, OLED_RESET, OLED_CS); // 或者使用硬件SPI速度更快引脚固定 // #define OLED_DC 9 // #define OLED_CS 10 // #define OLED_RESET 8 // Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, // SPI, OLED_DC, OLED_RESET, OLED_CS); void setup() { // 初始化注意这里没有I2C地址参数 if(!display.begin(SSD1306_SWITCHCAPVCC)) { // ... 错误处理 } // ... 其余代码相同 }关键区别在于构造函数的参数。软件SPI需要你指定所有引脚硬件SPI则传入SPI对象并指定DC、RESET、CS这三个控制引脚SCK和MOSI会由硬件SPI接口自动管理在Uno上是13和11脚。4. CircuitPython开发全攻略对于喜欢Python的开发者或者使用像Adafruit ItsyBitsy、Feather M4、树莓派Pico这类支持CircuitPython的板子驱动SSD1306同样简单优雅。CircuitPython的displayio库提供了硬件加速的图形原语支持用起来别有风味。4.1 环境准备与库安装首先确保你的开发板已经刷好了CircuitPython固件。将板子通过USB连接到电脑它会显示为一个名为CIRCUITPY的U盘。驱动SSD1306需要两个库文件adafruit_displayio_ssd1306.mpy和它的依赖adafruit_bus_device。获取它们最简单的方法是使用CircuitPython的库捆绑包CircuitPython Library Bundle。去Adafruit的GitHub发布页面下载对应你CircuitPython版本号的捆绑包解压后找到上述两个.mpy文件将它们复制到CIRCUITPY磁盘的lib文件夹内。如果lib文件夹不存在就新建一个。4.2 硬件连接与I2C初始化在CircuitPython中我们使用board模块来引用板子上的特定引脚这使得代码在不同板子间有很好的可移植性。以下是一个连接I2C OLED到Feather M4 Express的示例import board import displayio import terminalio from adafruit_display_text import label import adafruit_displayio_ssd1306 # 释放任何先前可能占用的显示资源重要 displayio.release_displays() # 创建I2C对象 i2c board.I2C() # 使用板子的默认I2C引脚 # 创建SSD1306 I2C显示对象 display_bus displayio.I2CDisplay(i2c, device_address0x3C) # 地址可能是0x3D display adafruit_displayio_ssd1306.SSD1306(display_bus, width128, height64) # 创建一个显示组Group可以把它想象成一个图层容器 splash displayio.Group() display.show(splash) # 将这个组设置为根组并显示 # 创建一个位图Bitmap尺寸为整个屏幕颜色深度为1单色 color_bitmap displayio.Bitmap(display.width, display.height, 1) # 创建一个调色板Palette单色显示只需要两种颜色 color_palette displayio.Palette(1) color_palette[0] 0xFFFFFF # 白色 # 创建一个TileGrid将位图和调色板关联起来并填充整个屏幕 bg_sprite displayio.TileGrid(color_bitmap, pixel_shadercolor_palette, x0, y0) splash.append(bg_sprite) # 将这个TileGrid添加到组中 # 现在屏幕上应该是一片白色这段代码看起来比Arduino的复杂因为它采用了更现代、更灵活的“显示组Group-位图Bitmap-TileGrid”架构。简单理解Bitmap是内存中的像素数据Palette定义了颜色索引TileGrid将位图“贴”到屏幕的某个位置而Group可以管理多个TileGrid如图层最终display.show()展示这个根组。4.3 显示文本与图形在displayio体系下显示文本需要额外的adafruit_display_text库。复制到lib文件夹后可以这样显示文字# 接上面的代码 # 创建文本标签 text_area label.Label(terminalio.FONT, textHello World!, color0x000000, x10, y10) splash.append(text_area) # 更新文本内容 text_area.text Temp: {:.1f}C.format(24.5) # 如果你想画一个实心矩形可以创建一个新的位图和TileGrid rect_bitmap displayio.Bitmap(50, 30, 1) rect_palette displayio.Palette(1) rect_palette[0] 0x000000 # 黑色 rect_sprite displayio.TileGrid(rect_bitmap, pixel_shaderrect_palette, x40, y20) splash.append(rect_sprite)displayio原生支持绘制基本形状通过vectorio模块但更复杂的图形通常通过加载位图文件.bmp来实现。你可以将一个小尺寸的BMP文件放在CIRCUITPY磁盘上然后用displayio.OnDiskBitmap加载并显示。4.4 SPI连接与性能优化对于SPI连接初始化部分有所不同import board import displayio import busio import adafruit_displayio_ssd1306 displayio.release_displays() # 定义SPI引脚 spi busio.SPI(board.SCK, board.MOSI) # 使用硬件SPI引脚 # 定义控制引脚 dc_pin board.D9 cs_pin board.D10 reset_pin board.D8 # 创建SPI显示总线 display_bus displayio.FourWire(spi, commanddc_pin, chip_selectcs_pin, resetreset_pin) display adafruit_displayio_ssd1306.SSD1306(display_bus, width128, height64)性能提示CircuitPython的displayio在刷新复杂图形时可能不如Arduino的本地代码快。为了获得最佳性能尽量减少display.refresh()或display.show()的调用频率只在内容确实改变时更新。对于动态内容考虑只更新发生变化的部分例如只重绘文本区域而不是整个屏幕。使用display.auto_refresh False手动控制刷新时机在完成所有绘制操作后调用display.refresh()。5. 高级应用与深度优化技巧当基础显示功能满足后你会开始追求更流畅的动画、更低的功耗或者更复杂的UI。这部分分享一些我踩过坑才总结出来的进阶经验。5.1 实现流畅动画与双缓冲在Arduino环境中直接连续调用绘图函数然后display()复杂图形会导致明显的闪烁。这是因为屏幕在逐帧绘制过程中用户能看到中间状态。解决方法是手动实现双缓冲。思路是创建两个与屏幕缓冲区大小相同的数组或使用Adafruit_SSD1306库的底层getBuffer()函数获取指针在一个缓冲区后台缓冲区中完成下一帧的所有绘制计算计算完成后一次性用memcpy或循环快速将这个缓冲区的数据复制到显示库的缓冲区然后调用display.display()。这样屏幕刷新只发生在一瞬间视觉上就流畅了。对于简单的位移动画还有一个技巧不要清空整个屏幕再重画。比如一个小球移动你只需要在旧位置用背景色黑色画一个圆“擦除”它然后在新位置用前景色白色再画一次。这比clearDisplay()drawCircle()display()三步要快得多。5.2 自定义字体与图标管理Adafruit_GFX库自带一种等宽字体但如果你想用更美观的字体就需要使用自定义字体。你需要将TTF或OTF字体文件通过像Adafruit GFX Font Converter这样的工具在线或离线转换成C语言头文件。这个头文件会定义一个很大的字体数据数组和一些字体属性结构体。在代码中包含这个头文件后调用display.setFont(myCustomFont)即可切换字体。需要注意的是自定义字体会占用大量的程序存储空间Flash尤其是中文字体。务必在项目初期评估Flash容量对于ATmega328PUno这种只有32KB Flash的芯片要非常节俭。对于图标建议将所有项目用到的图标合并到一张“精灵图Sprite Sheet”中然后通过drawBitmap()函数配合坐标偏移来显示其中某一个。这比每个图标单独一个数组更节省内存也便于管理。5.3 低功耗设计与睡眠模式在电池供电的物联网传感器项目中显示屏往往是耗电大户。SSD1306 OLED有一个非常实用的特性它支持硬件睡眠模式。在Arduino中你可以通过发送特定的命令来开启或关闭显示而无需断电// 进入睡眠模式极低功耗屏幕关闭 display.ssd1306_command(SSD1306_DISPLAYOFF); // 退出睡眠模式恢复正常显示 display.ssd1306_command(SSD1306_DISPLAYON);更精细的控制可以通过display.dim(true)来调低对比度进而降低功耗或者使用display.clearDisplay()清空缓冲区后再进入睡眠这样唤醒后能快速恢复之前的内容。一个常见的省电策略是微控制器大部分时间处于深度睡眠定时被唤醒如每秒一次。唤醒后读取传感器数据更新OLED显示仅更新变化部分然后立即让OLED进入睡眠最后微控制器自己也再次进入深度睡眠。这样系统平均电流可以降到几十甚至几百微安级别。5.4 多屏管理与SPI总线共享一个项目中用到多个OLED或者OLED与其他SPI设备如SD卡、无线模块共用总线很常见。关键在于处理好片选CS引脚。每个SPI从设备都必须有一个独立的CS引脚。在代码中操作任何一个设备前先将其CS引脚拉低选中操作完成后立即拉高取消选中。Adafruit_SSD1306库在初始化时会要求你指定CS引脚并在内部管理它。你需要确保不同设备的CS引脚不同并且在初始化其他SPI设备如SD库时不要意外地占用或影响了OLED的CS引脚状态。对于I2C地址冲突是主要问题。SSD1306的地址可以通过模块背面的一个电阻或焊盘来修改但大多数模块固定为0x3C或0x3D。如果一定要接两个地址相同的I2C OLED就需要使用I2C多路复用器芯片如TCA9548A或者干脆其中一个改用SPI接口。6. 常见问题排查与实战心得玩硬件没有不踩坑的。下面是我和社区里朋友们常遇到的一些问题及解决办法希望能帮你节省时间。6.1 屏幕不亮或显示乱码这是最常见的问题排查思路如下检查电源和接地万用表量一下VCC和GND之间是不是3.3V或5V。确保GND和开发板的GND是连通的。电源接反会瞬间烧毁模块。检查通信引脚再三确认SDA/SCL或SPI各线是否接对了开发板的引脚特别是那些可自定义的引脚代码里的定义和实际接线必须一致。检查I2C地址用I2C扫描程序确认地址。如果是0x00或扫描不到通常是接线错误、电源问题或模块损坏。SSD1306常见地址是0x3C但有些是0x3D。在代码begin()函数里改一下试试。检查复位引脚如果使用了硬件复位RST确保它在初始化时有一个从低到高的跳变过程。有些库的示例代码将复位引脚设为-1共享MCU复位如果你的RST接了单独引脚这里必须改成对应的引脚号。检查库版本和初始化参数确保Adafruit_SSD1306和Adafruit_GFX库是最新的。初始化时屏幕尺寸SCREEN_WIDTH,SCREEN_HEIGHT必须与实际模块匹配。128x32的屏用了128x64的初始化可能会显示错乱。SPI模式下的特殊问题确认DC和CS引脚是否接对且初始化正确。如果屏幕上出现规律的纵向条纹或错位很可能是SPI时钟频率太高。可以尝试在begin()之后调用display.setClock(frequency)降低SPI时钟速度比如降到1MHz试试。6.2 显示内容闪烁或残影刷新太快在loop()中不加延迟地连续调用clearDisplay()- 绘图 -display()可能会因为刷新过快导致电源不稳或控制器响应不及。在每次display()后加一个短暂的delay(1)或许能改善。电源不足OLED在点亮大量像素时瞬时电流较大。如果使用开发板的3.3V输出同时还在驱动其他传感器可能导致电压被拉低。尝试给OLED单独供电或者给开发板接上更稳定的电源如2A以上的USB适配器。对比度问题有时不是闪烁而是对比度太低看起来像残影。尝试在初始化后调用display.setContrast(255)把对比度调到最高看看。display.dim(false)可以关闭低对比度模式。6.3 内存不足与优化在Arduino Uno2KB RAM上驱动128x64 OLED需要1KB显示缓冲区再加上一些变量和字符串内存会非常紧张。编译通过但运行异常如重启、乱码往往是内存溢出堆栈冲突导致的。优化策略使用F()宏将字符串常量存放到程序存储空间Flash而不是RAM。例如display.println(F(Temperature:));。减少全局变量尽量使用局部变量函数执行完即释放。精简缓冲区Adafruit_SSD1306库默认分配全尺寸缓冲区。如果你的应用只显示文本可以考虑使用Adafruit_SSD1306库的“内存节约”模式但某些图形功能会受限。分段处理避免在内存中构建巨大的字符串或图形缓冲区。需要显示动态数据时分部分生成和显示。6.4 关于“白屏”或“全亮”有时上电后屏幕全白但程序似乎运行正常。这通常是初始化序列没有正确执行。确保display.begin()函数返回true。如果返回false检查I2C/SPI通信。对于某些克隆模块或特定批次标准的初始化命令可能不兼容。可以尝试在begin()之前手动发送复位脉冲pinMode(OLED_RESET, OUTPUT); digitalWrite(OLED_RESET, LOW); delay(10); digitalWrite(OLED_RESET, HIGH); delay(10);在极少数情况下可能需要修改库中的初始化命令序列。这涉及深入库文件不到万不得已不要尝试优先考虑更换模块或查找针对该模块的特定分支库。最后分享一个我个人的习惯在项目初期我会单独写一个最简单的“点亮测试”程序只包含初始化和显示一个固定图案。用这个程序来验证硬件连接和基础功能隔离问题。当这个测试通过后再把复杂的业务逻辑加进去这样能最大程度地避免软硬件问题纠缠在一起无从下手。
