树莓派4B连接I2C显示屏无显示问题求助

问题描述 #

将I2C OLED显示屏通过GPIO连接到树莓派4B，已确认：

• 连线无误
• I2C设备地址正确（0x27或0x3D）
• 已通过raspi-config开启I2C功能

设备未运行程序时蓝灯常亮，运行测试程序后蓝灯熄灭；程序输出I2C device initialized successfully.和Message displayed successfully.，但屏幕无内容，仅偶尔闪烁。测试代码如下：

from luma.core.interface.serial import i2c
from luma.oled.device import ssd1306
from luma.core.render import canvas
from PIL import ImageFont


try:
    serial = i2c(port=1, address=0x27)  # or 0x3D
    device = ssd1306(serial)
    print("I2C device initialized successfully.")
except Exception as e:
    print(f"Failed to initialize I2C device: {e}")


def display_message():
    try:
        with canvas(device) as draw:
            draw.rectangle(device.bounding_box, outline="white", fill="black")
            draw.text((10, 10), "1", fill="white")
        print("Message displayed successfully.")
    except Exception as e:
        print(f"Failed to draw on display: {e}")


display_message()

排查与修复方案 #

• 核对驱动与显示屏型号匹配
  很多外观类似的OLED实际是SH1106而非SSD1306，两者驱动不兼容。尝试将代码中的ssd1306替换为sh1106：

  from luma.oled.device import sh1106
  # ...
  device = sh1106(serial)
  

• 添加复位引脚配置
  多数廉价OLED模块需要外部复位信号才能正常工作。将模块的RST引脚连接到树莓派的GPIO25（或其他空闲GPIO），然后在初始化设备时指定复位引脚：

  device = ssd1306(serial, reset=25)
  

• 降低I2C通信速率
  树莓派默认I2C速率（400kHz）可能超出部分模块的承受范围，导致通信不稳定。修改/boot/config.txt文件，添加或修改：

  dtparam=i2c_arm_baudrate=100000
  

  保存后重启树莓派，将速率降至100kHz。

• 简化测试代码
  先去除画矩形的逻辑，用最基础的代码测试显示：

  from luma.core.interface.serial import i2c
  from luma.oled.device import ssd1306
  from luma.core.render import canvas
  
  serial = i2c(port=1, address=0x27)
  device = ssd1306(serial, reset=25)
  
  with canvas(device) as draw:
      draw.text((0, 0), "Hello", fill="white")
  

• 排查供电问题
  确保树莓派电源输出稳定（至少5V 2A），或者尝试给OLED模块单独提供3.3V电源，避免GPIO引脚供电不足导致的异常。

• 硬件故障排查
  更换其他OLED模块测试，或用其他设备验证当前模块是否正常，排除模块本身损坏的可能。

内容的提问来源于stack exchange，提问作者paritoshnitc