Agent Skills
返回列表
RDK X5 ST7796S SPI 屏与 GT911 触控驱动

RDK X5 ST7796S SPI 屏与 GT911 触控驱动

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_171341e7/rdk-x5-st7796s-spi-lcd-gt911。

技能介绍

要解决什么问题

在 RDK X5 上接一块 3.5 寸 ST7796S SPI 液晶(480×320) 和 GT911 电容触控,通常要手工推 device tree overlay、面板固件、内核模块,再配 X11 显示与触控校准、背光 GPIO 服务,并确认板子能进图形桌面。接线还容易踩坑(例如 LCD 片选必须接 pin 26 CS1,电源必须是 3.3V)。本技能把 Cathay-Launch-UI 仓库里已验证的流程收成可重复执行的自动化步骤。

技能如何工作

运行前会与用户确认 硬件接线、SSH 可达、内核是否为 6.1.83、是否为带 LightDM/桌面的 Desktop 镜像(非纯 Server),以及本机是否具备 sshpass。通过后依次:拉取或复用 ~/Cathay-Launch-UI、校验内核版本、推送 .dtbo 与 panel 固件、安装预编译 .ko、写入 X11 显示与 GT911 横屏校准矩阵、配置背光 systemd 服务、清理旧的 userspace SPI 服务、确保 graphical.target 与显示管理器启用,最后重启并通过 SSH 做一整套验收(fb0/drm、模块加载、goodix 输入设备、背光、xdpyinfo、校准矩阵等),必要时截桌面图做冒烟证明。

适用边界与注意点

  • 预编译内核模块仅适用于 6.1.83;其它内核需按仓库 SPI-LCD-SETUP.md 自行重编 .ko,overlay 与 .bin 固件仍可复用。
  • 无显示管理器时会提前中止,需刷 Desktop 镜像或自行安装 LightDM 等。
  • 故障排查(黑屏、触控方向、SPI 花屏、I2C 总线号)以 Cathay-Launch-UI 文档为准;整体流程幂等,重复执行不会重复写入 dtoverlay 行。

使用场景

  • 首次在 RDK X5 上接 Cathay 3.5 寸 ST7796S 屏,需要按官方引脚把 overlay、固件和模块一次性部署到板子。
  • 刚重刷 Desktop 镜像或换板子,想复用 Cathay-Launch-UI 预编译 `.ko`,避免自己交叉编译 6.1.83 内核模块。
  • 接线改过 CS 或 I2C 后黑屏/触控方向不对,需要按文档流程重做 X11 与 GT911 校准并跑 SSH 验收。
  • 要在 SPI 小屏上跑 LightDM 桌面做现场演示,需确认 graphical.target、显示管理器和 `xdpyinfo` 都正常。

适合人员

  • 负责 RDK X5 人机界面联调、希望用现成模块而不是本地编内核的嵌入式软件工程师
  • 按 Cathay-Launch-UI 搭 3.5 寸 SPI 屏原型、从 Ubuntu 主机 SSH 推驱动到板子的硬件创客
  • 维护 RDK X5 Desktop 镜像、要在小屏上稳定出桌面并截图为验收证据的机器人或边缘设备集成人员
  • 内核已锁定 6.1.83、只需重复执行 SPI-LCD-SETUP 文档步骤并做 dmesg/fb0 检查的 BSP 支持工程师