树莓派4B-Python-使用SSD1306 OLED

た入场券 2022-10-21 11:42 655阅读 0赞

# 树莓派4B-Python-使用SSD1306 OLED #

--------------------

### 文章目录 ###

*  树莓派4B-Python-使用SSD1306 OLED
 *  前言
 *  一、SSD1306 OLED
 *  二、参数介绍
 *  三、与树莓派接线
 *   *  1.开启I2C
     *  2.下载Luma.oled库（用于Python3版本的）
     *  3.屏幕与树莓派连接
 *  四、代码
 *  总结

--------------------

# 前言 #

该文章主要是搞清楚如何使用新网购入手的OLED模块，打算将其装在V4小车上作为小车状态的输出屏，当然这第一次买所以买的屏幕有点太迷你了，凑近了才能看清屏幕上的内容，这次研究顺利的话下次再买个大一些的OLED屏。

--------------------

# 一、SSD1306 OLED #

![SSD1306][]  
该OLED 屏幕为0.96寸，分辨率128 \* 64，四线制，屏幕上四分之一显示黄色，屏幕下四分之三显示蓝色。

[树莓派驱动OLED的两种库][OLED]

# 二、参数介绍 #

GND————接地  
VCC————3.3 ~ 5V  
SCL————串行时钟  
SDA————串行数据

驱动芯片————SSD1306  
通信方式————IIC

分辨率————128 \* 64  
支持显示————一般为数字、大小写英文

# 三、与树莓派接线 #

## 1.开启I2C ##

先下载：

sudo apt-get install -y python-smbus

sudo apt-get install -y i2c-tools

再开启i2c  
![开启i2c][i2c]

## 2.下载Luma.oled库（用于Python3版本的） ##

[关于Luma.oled库的使用文档][Luma.oled]

sudo apt-get install python3-dev python3-pip libfreetype6-dev libjpeg-dev

sudo -H pip3 install --upgrade pip3

sudo apt-get purge python3-pip

sudo -H pip3 install --upgrade luma.oled

若出现一大堆红字时，是因为网络不给力，多试几次就好了

## 3.屏幕与树莓派连接 ##

![OLED 屏幕与树莓派连接][OLED 1]  
红色线————5V  
黑色线————GND  
黄色线————SCL  
绿色线————SDA

输入以下内容会得知是否已成功开启i2c

sudo i2cdetect -y 1

得到的结果：  
![查看是否已开启i2c][i2c 1]  
其中显示了“ 3C ”就说明是成功开启i2c了。

# 四、代码 #

代码如下：

from luma.core.interface.serial import i2c, spi
    from luma.core.render import canvas
    from luma.oled.device import ssd1306, ssd1325, ssd1331, sh1106
     
    serial = i2c(port=1, address=0x3C)
    device = ssd1306(serial)
     
    with canvas(device) as draw:
        draw.rectangle(device.bounding_box, outline="white", fill="black") # 让屏幕周围显示一个框
        draw.text((30, 10), "Hello World", fill="white") # 将Hello World显示在屏幕第30列、第10行，显示的内容颜色为white（白色），但该屏幕无法呈现白色，只能显示当前LED灯的颜色

--------------------

# 总结 #

之后就发现了一个关键但不致命的问题，那就是想显示中文字幕时就会报错。  
![显示中文时报错][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ2NDc2MTYz_size_16_color_FFFFFF_t_70_pic_center]  
有待解决！

**之后经过一上午的深入探讨、研究、尝试，最终解决了“ 显示中文字幕时就会报错 ”的问题，解决方案在下面的文章链接中：**  
[解决方案写在了该文章的最后][Link 1]

[SSD1306]: /images/20221021/117d99c94f26491eab4f4d8e8e226e9e.png
[OLED]: https://shumeipai.nxez.com/2017/09/13/solve-the-raspberry-pi-drive-oled-problem.html
[i2c]: /images/20221021/0d84639038464c7594447e331c131bd4.png
[Luma.oled]: https://luma-oled.readthedocs.io/en/latest/api-documentation.html
[OLED 1]: /images/20221021/d3e6211a1ec6408bba56e02733181321.png
[i2c 1]: /images/20221021/75732967bf314eb6ac73040b03d5bcfe.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQ2NDc2MTYz_size_16_color_FFFFFF_t_70_pic_center]: /images/20221021/f1c9fd4a86d94c8998cb95eeee97cccd.png
[Link 1]: https://blog.csdn.net/qq_46476163/article/details/116573746