树莓派4B实战指南——I2C驱动OLED屏幕全解析

1. 从零开始：为什么选择树莓派和OLED屏幕？

如果你手头有一块树莓派4B，正琢磨着用它做点有趣的小项目，但又觉得直接操作Linux系统或者写复杂的网络应用有点门槛，那么从硬件入手，点亮一块小小的OLED屏幕，绝对是一个成就感爆棚的起点。我自己刚开始玩树莓派的时候，也是从驱动各种小屏幕、小传感器开始的，那种几行代码就让硬件“活”过来的感觉，特别能激发继续探索的兴趣。今天，我就带你用最通俗的方式，搞定树莓派4B通过I2C协议驱动0.96寸OLED屏幕这件事。

简单来说，这就像给你的树莓派装上一个迷你显示屏。它不像HDMI接口的大显示器那样需要复杂的配置和驱动，而是通过两根线（没错，就两根！）和树莓派“说悄悄话”，告诉它该显示什么。这个“悄悄话”的协议，就是我们今天的主角——I2C。你可能会问，这有什么用？用处可大了。你可以用它来显示系统状态（比如CPU温度、IP地址）、做一个迷你天气预报站、或者作为智能家居控制面板的显示部分。它体积小、功耗低，非常适合嵌入式项目。

那么，为什么是I2C呢？在树莓派的世界里，和外设通信有好几种方式，比如SPI、UART。I2C最大的优点就是“省线”。它只需要两根线（一根时钟线SCL，一根数据线SDA），就能连接多个设备，特别适合树莓派这种GPIO引脚数量有限的板子。对于0.96寸OLED这种常见的小屏，I2C驱动方案非常成熟，网上资料多，库函数丰富，对新手极其友好。所以，无论你是想入门嵌入式开发的学生，还是想给智能家居项目加个显示的爱好者，这个实战指南都能让你快速上手。

2. 硬件准备与连接：别让线接错了

万事开头难，但硬件连接这一步，我们争取让它变得最简单。你需要准备的东西不多：一块树莓派4B（其他型号如3B+也基本通用）、一块0.96寸I2C接口的OLED屏幕（通常是SSD1306驱动芯片）、几根母对母的杜邦线。这里有个小坑我踩过：市面上有些OLED屏的引脚顺序可能略有不同，最常见的是四针的：VCC、GND、SCL、SDA。拿到屏幕后，最好先看一眼产品说明或者PCB板上的丝印。

现在，我们来接线。记住一个原则：电源线（VCC和GND）绝对不能接错，信号线（SDA和SCL）接对了才能通信。对于树莓派4B，我们通常使用其物理引脚编号为3和5的那一组I2C接口，它们对应的功能就是SDA和SCL。具体连接如下：

• OLED的VCC -> 树莓派的Pin 2 (5V)。这里注意，有些OLED模块工作电压是3.3V，接5V可能会烧坏！一定要确认你的屏幕支持5V输入。大多数常见的0.96寸屏是支持3.3V-5V宽电压的，接5V没问题，亮度还更高。如果不确定，保险起见接在树莓派的Pin 1 (3.3V)上。
• OLED的GND -> 树莓派的Pin 6 (GND)。接地，这个没得商量，必须接。
• OLED的SDA -> 树莓派的Pin 3 (SDA1)。这是数据线。
• OLED的SCL -> 树莓派的Pin 5 (SCL1)。这是时钟线。

接好之后，最好检查两遍。硬件连接是基础，这里错了，后面软件怎么调都没用。我遇到过好几次屏幕不亮，最后发现是GND线虚接了。接好后，就可以给树莓派上电了。

2.1 确认I2C接口是否就绪

线接好了，我们得先确认树莓派系统本身已经准备好了I2C这个“聊天工具”。树莓派的Raspbian系统默认可能没有开启I2C接口，我们需要手动开启它。有两种主流方法，图形界面和命令行，任选其一就行。

如果你用的是带桌面的完整版系统，方法很简单：点击左上角的树莓派图标 -> Preferences -> Raspberry Pi Configuration。在弹出的窗口里，切换到 Interfaces 标签页，找到 I2C 这一项，选择 Enable，然后点击 OK。系统会提示你需要重启，照做就行。

我更习惯用命令行，因为更快捷，而且对于用SSH远程操作树莓派的朋友来说，这是唯一的方法。打开终端，输入下面这个命令：

sudo raspi-config

你会看到一个蓝色的配置界面。用键盘上下键移动到 3 Interface Options，回车。然后再选择 I5 I2C，回车。系统会问你是否要启用ARM I2C接口，果断选择 <Yes> 再回车。接着可能会有一个关于是否自动加载内核模块的提示，同样选是。最后按几次 Tab 键让光标移动到 Finish 上，回车退出。它也会问你是否重启，选择重启。等树莓派重新启动，I2C功能就激活了。

3. 软件环境搭建：安装必要的工具和库

硬件通道打通了，我们还需要软件上的“翻译官”和“侦察兵”。翻译官就是编程库，它把我们要显示的文字、图片翻译成屏幕能懂的I2C命令。侦察兵就是检测工具，帮我们看看屏幕是否真的挂载到了I2C总线上，以及它的“门牌号”（设备地址）是多少。

首先，我们来安装“侦察兵” i2c-tools。打开终端，输入：

sudo apt update
sudo apt install i2c-tools -y