Divoom Pixoo 显示

pixoo 显示平台允许你在 ESPHome 中使用 Divoom Pixoo 64 —— 一个 64×64 RGB LED 矩阵。ESPHome 直接在面板板载 ESP32 上运行，它通过 内部 SPI 总线 驱动 LED 板。帧由 ESPHome 的标准显示引擎（lambda、 图像、LVGL）渲染，并作为 RGB888 数据发送到面板。

面板亮度通过 pixoo 灯光平台 单独暴露。

Pixoo 通过 SPI 总线 通信，必须单独设置。面板是 只写的，因此总线需要 mosi_pin 但不需要 miso_pin。

# 示例配置条目
display:
  - platform: pixoo
    id: pixoo_display
    cs_pin: GPIOXX
    lambda: |-
      it.line(0, 0, it.get_width() - 1, it.get_height() - 1, Color(0, 255, 0));

NOTE

Pixoo 64 将 ESP32 在固定的内部引脚上连接到 LED 驱动板。有关 实际引脚编号，请参见下面的完整配置示例。

配置变量

• model (可选, enum): Pixoo 面板型号。目前仅支持 64x64。默认为 64x64。
• cs_pin (必需, Pin Schema): 连接到 LED 驱动板的 SPI 片选引脚。
• data_rate (可选, frequency): SPI 数据速率。默认为 8MHz。
• lambda (可选, lambda): 用于在显示上渲染内容的 lambda。 更多信息请参见 显示渲染引擎。
• update_interval (可选, Time): 重新绘制屏幕的间隔。 默认为 1s。
• pages (可选, list): 显示页面而非单个 lambda。 请参见 显示页面。
• id (可选, ID): 手动指定用于代码生成的 ID。
• 所有其他选项参见 显示组件。

完整配置示例

以下配置使用 Pixoo 64 的固定内部引脚，并添加 pixoo 灯光平台 用于亮度控制：

spi:
  clk_pin: GPIO25
  mosi_pin: GPIO33

display:
  - platform: pixoo
    id: pixoo_display
    model: 64x64
    cs_pin: GPIO26
    lambda: |-
      it.line(0, 0, it.get_width() - 1, it.get_height() - 1, Color(0, 255, 0));

light:
  - platform: pixoo
    pixoo_id: pixoo_display
    name: "Pixoo Brightness"

参见

• 显示组件
• Pixoo 灯光
• SPI 总线
• LVGL 组件
• API 参考：pixoo.h