跳转到内容

SSD1331 OLED 显示

ssd1331_spi 显示平台允许你使用 ESPHome 的 SSD1331(数据手册、 Adafruit)。此组件用于通过 4 线 SPI 总线 连接的显示。

SSD1331 96x64 OLED 显示

将 CLK(CK)、MOSI(SI)、CS(OC)、DC 和 RST(R)连接到 ESP 的引脚。对于电源,Adafruit 模块 需要将 5 伏特连接到它们的 + 引脚。将 GND 或 G 引脚连接到地。

# 示例配置条目
spi:
clk_pin: D5
mosi_pin: D7
display:
- platform: ssd1331_spi
reset_pin: D0
cs_pin: D8
dc_pin: D1
lambda: |-
it.print(0, 0, id(font), "Hello World!");
  • dc_pin (必需, Pin Schema): DC 引脚。

  • reset_pin (可选, Pin Schema): RESET 引脚。

  • cs_pin (可选, Pin Schema): ESP 上 CS 线连接的引脚。 如果这是 SPI 总线上唯一的设备,CS 线可以连接到 GND。

  • lambda (可选, lambda): 用于在显示上渲染内容的 lambda。 更多信息请参见 显示渲染引擎。

  • update_interval (可选, Time): 重新绘制屏幕的间隔。默认为 5s。

  • pages (可选, list): 显示页面而非单个 lambda。请参见 显示页面。

  • id (可选, ID): 手动指定用于代码生成的 ID。

你可能希望在你的 YAML 配置中添加一个 color: 部分,以便更容易使用颜色;请参见 颜色 了解此可选配置部分的更多详细信息。

color:
- id: my_red
red: 100%
green: 3%
blue: 5%
...
display:
...
lambda: |-
it.rectangle(0, 0, it.get_width(), it.get_height(), id(my_red));

引入彩色图像:

image:
- platform: file
file: "image.jpg"
id: my_image
resize: 96x64
type: RGB
...
display:
...
lambda: |-
it.image(0, 0, id(my_image));