ST7701S 显示驱动

型号

此显示驱动程序支持具有 16 位并行接口的显示屏，通常称为”RGB”。目前支持 ST7701S 芯片。

WARNING

此组件已变得多余，因为 ST7701S 现在由 Mipi Rgb 支持。此组件可能会在未来版本中移除。

此驱动程序已使用以下显示屏进行测试：

Seeed Sensecap Indicator
Makerfabs 4” 显示屏

用法

此组件需要 ESP32（通常是 ESP32-S3，因为需要大量 GPIO 引脚）并使用 ESP-IDF。由于显示缓冲区的大小，PSRAM 是必需的。

# 最小配置示例
display:
  - platform: st7701s
    dimensions:
      width: 480
      height: 480
    cs_pin: GPIOXX
    reset_pin: GPIOXX
    de_pin: GPIOXX
    hsync_pin: GPIOXX
    vsync_pin: GPIOXX
    pclk_pin: GPIOXX
    # 将 XX 替换为正确的引脚号

    data_pins:
      red:
        - XX        #r1
        - XX        #r2
        - XX        #r3
        - XX        #r4
        - XX        #r5
      green:
        - XX        #g0
        - XX        #g1
        - XX        #g2
        - XX        #g3
        - XX        #g4
        - XX        #g5
      blue:
        - XX        #b1
        - XX        #b2
        - XX        #b3
        - XX        #b4
        - XX        #b5

配置变量

init_sequence (可选, 字节数组列表)：指定显示屏的初始化序列
data_pins (**必填”)：用于数据总线的引脚列表。分为 3 组指定。
- red (**必填”, 引脚模式)：红色数据位正好 5 个引脚号，从最低有效位到最高有效位列出。
- green (**必填”, 引脚模式)：绿色数据位正好 6 个引脚号，从最低有效位到最高有效位列出。
- blue (**必填”, 引脚模式)：蓝色数据位正好 5 个引脚号，从最低有效位到最高有效位列出。
de_pin (**必填”, 引脚模式)：DE 引脚。
dc_pin (可选, 引脚模式)：DC 引脚。
pclk_pin (**必填”, 引脚模式)：PCLK 引脚。
hsync_pin (**必填”, 引脚模式)：水平同步引脚。
vsync_pin (**必填”, 引脚模式)：垂直同步引脚。
reset_pin (可选, 引脚模式)：RESET 引脚。
hsync_pulse_width (可选, int)：水平同步脉冲宽度。
hsync_front_porch (可选, int)：水平前肩长度。
hsync_back_porch (可选, int)：水平后肩长度。
vsync_pulse_width (可选, int)：垂直同步脉冲宽度。
vsync_front_porch (可选, int)：垂直前肩长度。
vsync_back_porch (可选, int)：垂直后肩长度。
pclk_frequency (可选)：设置像素时钟速度。默认为 8MHz。
pclk_inverted (可选, 布尔值)：pclk 是否为负有效（默认为 True）
update_interval (可选, 时间)：重新绘制屏幕的间隔。默认为 5s。
auto_clear_enabled (可选, 布尔值)：是否在每次更新之前清除显示屏。如果配置了 lambda 或页面，默认为 true，否则为 false。
pages (可选, 列表)：显示页面而不是单个 lambda。详见显示页面。
id (可选, ID)：手动指定用于代码生成的 ID。
color_order (可选)：应为 bgr（默认）或 rgb 之一。
dimensions (**必填”)：屏幕尺寸，指定为宽度 x 高度（如 320x240）或使用单独的配置键。
- height (**必填”, int)：指定显示屏高度（像素）。
- width (**必填”, int)：指定显示屏宽度。
- offset_width (可选, int)：指定显示屏 x 方向的偏移量，通常用于 LCD 小于驱动芯片支持的最大尺寸时。默认为 0
- offset_height (可选, int)：指定显示屏 y 方向的偏移量。默认为 0。
data_rate (可选)：设置显示屏 SPI 接口的数据速率。可选 80MHz、40MHz、20MHz、10MHz、5MHz、2MHz、1MHz（默认）、200kHz、75kHz 或 1kHz。
spi_mode (可选)：设置显示屏 SPI 接口的模式。默认为 MODE0，但某些显示屏需要 MODE3。
invert_colors (可选)：使用此布尔选项可以反转显示屏颜色。注意某些显示屏此选项自动设置为 true，无法更改。
rotation (可选)：在软件中旋转显示屏显示。选择 0°、90°、180° 或 270° 之一。此选项不能与 transform 同时使用。
transform (可选)：使用硬件变换显示屏显示。所有默认值均为 false。此选项不能与 rotation 同时使用。
- mirror_x (可选, 布尔值)：如果为 true，镜像 x 轴。
- mirror_y (可选, 布尔值)：如果为 true，镜像 y 轴。
lambda (可选, lambda)：用于在显示屏上渲染内容的 lambda。详见显示渲染引擎。

注意： 要在硬件上将显示屏旋转 180 度，请将 mirror_x 和 mirror_y 都设置为 true。st7701s 不支持 90 或 270 度的硬件旋转。

水平和垂直 pulse_width、front_porch 和 back_porch 值是可选的，但特定显示屏可能需要更改。请参阅制造商的示例代码获取合适的值。这些指定了显示屏的时序要求。

init_sequence 需要一个元素列表，其中一个可以是选择预定义初始化序列的单个整数（默认且当前唯一的序列是 1），其余必须是提供额外初始化命令的字节数组，每个命令由一个命令字节后跟零个或多个数据字节组成。

可以使用 delay <N>ms 指定延迟

这些将被收集并在初始化期间通过 SPI 发送到显示屏。

配置示例

Seeed Sensecap Indicator

display:
  - platform: st7701s
    update_interval: never
    spi_mode: MODE3
    color_order: RGB
    dimensions:
      width: 480
      height: 480
    invert_colors: true
    transform:
      mirror_x: true
      mirror_y: true
    cs_pin:
      pca9554: p_c_a
      number: 4
    reset_pin:
      pca9554: p_c_a
      number: 5
    de_pin: 18
    hsync_pin: 16
    vsync_pin: 17
    pclk_pin: 21
    init_sequence:
      - 1 # 选择预定义初始化序列编号 1
      - delay 5ms
      - [ 0xE0, 0x1F ]  # 设置阳光可读增强
    data_pins:
      red:
        - 4         #r1
        - 3         #r2
        - 2         #r3
        - 1         #r4
        - 0         #r5
      green:
        - 10        #g0
        - 9         #g1
        - 8         #g2
        - 7         #g3
        - 6         #g4
        - 5         #g5
      blue:
        - 15        #b1
        - 14        #b2
        - 13        #b3
        - 12        #b4
        - 11        #b5
    lambda: |-
      it.fill(COLOR_BLACK);
      it.print(0, 0, id(my_font), id(my_red), TextAlign::TOP_LEFT, "Hello World!");

ST7701S 显示驱动

型号

用法

配置变量

配置示例

Seeed Sensecap Indicator

另见