跳转到内容

SSD1351 OLED 显示屏

ssd1351_spi 显示平台允许您在 ESPHome 中使用 SSD1351(数据手册Adafruit 128x128Adafruit 128x96Waveshare 128x128) 显示屏。此组件适用于通过 4 线 SPI 总线连接的显示屏。

SSD1351 OLED 显示屏

将 CLK、DIN、CS、DC 和 RST 连接到 ESP 上的引脚。对于电源,Adafruit 模块有两个引脚;将 3.3 伏连接到它们的 3v 将 5 伏连接到它们的 + 引脚。Waveshare 模块只有一个 Vcc 引脚,应仅连接到 3.3 伏。将 GND 或 G 引脚连接到 GND。

# 配置示例
spi:
clk_pin: D5
mosi_pin: D7
display:
- platform: ssd1351_spi
model: "SSD1351 128x128"
reset_pin: D0
cs_pin: D8
dc_pin: D1
lambda: |-
it.print(0, 0, id(font), "Hello World!");
  • model (必填):显示屏型号。选项有:

    • SSD1351 128x128 - SSD1351,128 列 128 行
    • SSD1351 128x96 - SSD1351,128 列 96 行
  • dc_pin (**必填”, 引脚模式):DC 引脚。

  • cs_pin (**必填”, 引脚模式):CS 线连接到的 ESP 引脚。

  • reset_pin (可选, 引脚模式):RESET 引脚。

  • lambda (可选, lambda):用于在显示屏上渲染内容的 lambda。 详见显示渲染引擎

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

  • pages (可选, 列表):显示页面而不是单个 lambda。详见显示页面

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

在 YAML 配置中添加 color: 部分;有关此配置部分的更多详细信息,请参阅 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:
- file: "image.jpg"
id: my_image
resize: 120x120
type: RGB24
...
display:
...
lambda: |-
it.image(0, 0, id(my_image));