Pwnagotchi项目Display Hat Mini显示问题解决方案

问题背景

在Pwnagotchi项目中，用户在使用Display Hat Mini显示屏时遇到了启动后屏幕空白的问题。该问题主要出现在最新2.8.9 64位版本上，硬件配置为Pi zero 2w搭配Display Hat Mini和PiSugar2电源管理模块。

错误分析

从错误日志中可以观察到几个关键问题点：

1. SPI设备初始化失败，显示"No such file or directory"错误
2. 显示驱动初始化过程中出现异常
3. UI帧率被设置为0，导致显示更新受限

根本原因

经过技术分析，该问题主要由以下因素导致：

1. SPI总线配置不正确，导致驱动无法正常访问硬件
2. 显示参数设置不当，包括旋转角度和分辨率
3. SPI通信速率设置过低，影响显示性能

解决方案

1. 修改ST7789驱动参数

需要编辑显示驱动文件，路径为：

/usr/local/lib/python3.11/dist-packages/pwnagotchi/ui/hw/libs/pimoroni/displayhatmini/ST7789.py

修改以下参数：

• 将rotation参数默认值从90改为0
• 将width参数默认值从240改为320
• 将spi_speed_hz参数从4000000改为6010001000

2. 调整boot配置文件

编辑/boot/firmware/config.txt文件，确保包含以下配置：

dtparam=audio=on
camera_auto_detect=1
display_auto_detect=1
auto_initramfs=1
dtoverlay=vc4-kms-v3d
max_framebuffers=2
disable_fw_kms_setup=1
arm_64bit=1
disable_overscan=1
arm_boost=1

[cm4]
otg_mode=1

[all]
dtparam=i2c1=on
dtparam=i2c_arm=on
dtparam=spi=on
gpu_mem=1
dtoverlay=dwc2

3. 配置Pwnagotchi显示设置

在/etc/pwnagotchi/config.toml中添加或修改以下配置：

ui.display.enabled = true
ui.display.rotation = 0
ui.display.type = "displayhatmini"

注意事项

1. 当前解决方案下，GPIO按钮功能可能无法正常工作
2. 如果使用PiSugar2电源管理模块，建议先测试不连接该模块的情况
3. 修改配置文件后需要重启设备使更改生效

技术原理

Display Hat Mini使用ST7789显示驱动芯片，通过SPI接口与树莓派通信。正确的SPI总线配置和参数设置对于显示正常工作至关重要。旋转角度和分辨率参数需要与物理显示屏特性匹配，而SPI通信速率则影响显示刷新性能。

通过上述调整，可以确保显示驱动正确初始化并与硬件匹配，从而解决显示空白的问题。