fbcp-ili9341项目：解决Raspberry Pi 3B+在Bookworm系统下ST7789显示驱动与KMS冲突问题

问题背景

在Raspberry Pi 3B+设备上运行32位Bookworm系统时，用户尝试通过fbcp-ili9341项目驱动ST7789显示屏时遇到了显示输出异常。具体表现为：当启用vc4-kms-v3d显示驱动时，HDMI输出正常但SPI连接的ST7789显示屏无法初始化；而禁用该驱动后，虽然显示屏能初始化，但HDMI输出丢失且无法显示桌面环境。

技术分析

这种情况本质上是Raspberry Pi的显示子系统架构冲突导致的。vc4-kms-v3d是树莓派默认的KMS（Kernel Mode Setting）驱动，它会接管所有显示输出设备。而fbcp-ili9341这类基于SPI的帧缓冲复制工具需要直接访问显示硬件，两者在资源访问上会产生冲突。

解决方案

通过将dtoverlay=vc4-kms-v3d修改为dtoverlay=vc4-fkms-v3d可以完美解决问题。这是因为：

1. fkms驱动特性：fkms（Fake KMS）是KMS的轻量级实现，它保留了基本的显示功能但不会完全接管显示硬件
2. 资源占用差异：fkms驱动对底层硬件的控制较为宽松，为SPI显示驱动保留了必要的硬件访问权限
3. 性能平衡：在保持HDMI输出的同时，允许第三方显示驱动通过SPI接口工作

配置建议

对于类似场景，建议采用以下配置组合：

dtoverlay=vc4-fkms-v3d
max_framebuffers=2
disable_fw_kms_setup=1

同时确保SPI相关参数正确设置：

• GPIO_TFT_DATA_CONTROL=25
• GPIO_TFT_RESET_PIN=27
• GPIO_TFT_BACKLIGHT=18
• SPI_BUS_CLOCK_DIVISOR=30

深入理解

这个问题揭示了树莓派显示系统的分层架构：

1. 底层硬件层：包括GPU和显示接口
2. 驱动中间层：KMS/fkms驱动
3. 用户空间：X11/Wayland等显示服务器

当使用非标准显示设备时，选择合适的驱动层级至关重要。fkms提供了硬件加速和第三方驱动兼容性之间的最佳平衡点。

注意事项

1. 不同树莓派型号可能需要调整时钟分频参数
2. 在Bookworm系统上，建议使用最新版的fbcp-ili9341驱动
3. 如果遇到显示闪烁问题，可以尝试调整SPI时钟分频系数
4. 确保/boot/config.txt中相关SPI接口已启用

这种解决方案不仅适用于ST7789显示屏，对于其他基于SPI接口的显示设备也具有参考价值，特别是在需要同时使用HDMI和外接显示屏的场景下。