树莓派在 OLED 显示屏上输出文字

本文记录如何用树莓派和下图的显示屏展示内容。

用到的设备：

• OLED显示屏模块，IIC接口，128*32点阵，驱动芯片SSD1306（购买链接）
• 树莓派 3 Model B+，有外接显示屏、鼠标（如果没有可以用个人电脑连接树莓派，Mac 系统的可点击参考《Mac 通过 VNC 打开树莓派远程桌面（不用独立显示屏）》）

连接设备

 

如上图所示，这个 OLED 有五个 Pin，和树莓派引脚分别对映如下：

OLED Pin	树莓派 GPIO Pin (Board 编码）	备注
3.3v	1 或 17	3.3 v
GND	6 或 9/14/20/25/30/34/39	Ground
SCL	5	I2C SCL
SDA	3	I2C SCA
RES	可以不连	Reset，我的代码中没有用到这个

市面上大多数 OLED 有4个或6个 Pin，连接方式略有不同，4个的少一个 RES，其他都一样，如下图。

Enable I2C Interface

有两种方式：

1. 树莓派终端中执行 sudo raspi-config ，选择 Interfacing Options > I2C ，出现如下界面，确认后重启。

2. 桌面版树莓派可点击桌面左上角菜单键，再选择“首选项/Preferences" > "Raspberry Pi Configuration"，然后再弹出的窗口中选择 Interfaces 标签，I2C 选项中选择 Enable，如下图。