跳转到内容

SSD1351 OLED 显示

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

SSD1351 OLED 显示

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

# 示例配置条目
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 - 128 列 128 行的 SSD1351
    • SSD1351 128x96 - 128 列 96 行的 SSD1351
  • dc_pin (必需, Pin Schema): DC 引脚。

  • cs_pin (必需, Pin Schema): ESP 上 CS 线连接的引脚。

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

  • 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: 120x120
type: RGB
...
display:
...
lambda: |-
it.image(0, 0, id(my_image));