RDK X5 ST7789 SPI 液晶屏

要解决什么问题

在 地瓜（Horizon Robotics）RDK X5 上接 ST7789 的 SPI 小屏时，常见痛点是：初始化序列冗长、颜色格式与 BGR 位序容易搞错，以及 DC/RST/背光引脚与 SPI 设备节点要对上板子才能出图。本技能把已在板子上验证过的驱动逻辑和推荐工作流收拢成可复用的说明，方便你直接生成可跑的脚本，而不是从零翻 datasheet。

技能如何工作

• 完整驱动实现：提供可直接复制使用的 ST7789 类，包含初始化流程与颜色转换逻辑，适合作为代码生成的模板。
• Prompt 模式工作流：当需要「亮屏、填色、画图」时，优先生成单文件脚本——例如全屏填充某色，或用 PIL.ImageDraw 绘制后再 lcd.show() 刷到屏上。
• 硬件对照：默认走 SPI1 设备 /dev/spidev1.1（CS1）；BOARD 编号下 DC=22、RST=31、BL=33、DIN=19、CLK=23。

适用边界与注意点

• 脚本访问 SPI 与 GPIO 时必须用 sudo 运行。
• 白屏：先确认 srpi-config 已启用 SPI，并检查 DC/RST 接线。
• 颜色错乱：可在初始化里尝试 bgr=False（或按屏厂参数调整）以匹配 RGB/BGR 顺序。
• 本技能聚焦 ST7789 + RDK X5 的 SPI 接线场景；换屏型号或走并口/I2C 时需另选驱动方案。