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

问题背景

在Pwnagotchi项目中使用Display Hat Mini显示屏时，部分用户遇到了设备启动后屏幕空白的问题。这个问题主要出现在全新刷写系统镜像后，通过配置向导构建配置时，设备重启后屏幕无法正常显示内容。

错误分析

从错误日志中可以看到，系统在初始化Display Hat Mini时抛出了"FileNotFoundError: [Errno 2] No such file or directory"异常。这表明系统无法找到SPI设备，通常与SPI接口配置或显示驱动参数设置不当有关。

解决方案

1. 修改SPI配置

首先需要检查并修改/boot/firmware/config.txt文件中的SPI相关配置。建议使用以下配置：

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

2. 调整显示驱动参数

需要修改ST7789驱动文件（位于/usr/local/lib/python3.11/dist-packages/pwnagotchi/ui/hw/libs/pimoroni/displayhatmini/ST7789.py）中的初始化参数：

def __init__(self, port, cs, dc, backlight=None, rst=None, width=320,
             height=240, rotation=0, invert=True, spi_speed_hz=60 * 1000 * 1000,
             offset_left=0,
             offset_top=0):

关键修改点包括：

• 将旋转角度(rotation)设置为0而非默认的90
• 将宽度(width)设置为320而非240
• 将SPI速度(spi_speed_hz)调整为60MHz（60 * 1000 * 1000）而非默认的4MHz

3. 配置文件调整

确保/etc/pwnagotchi/config.toml中包含正确的显示配置：

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

注意事项

1. 目前解决方案中GPIO按钮功能可能无法正常工作，这是已知限制
2. 如果同时使用PiSugar2电源管理模块，建议先不连接它进行测试，以排除可能的配置冲突
3. 修改配置文件后需要重启设备使更改生效

技术原理

这个问题主要源于SPI接口的初始化失败。Display Hat Mini使用SPI接口与树莓派通信，当SPI配置不正确或驱动参数不匹配时，会导致显示初始化失败。通过调整SPI总线速度和显示参数，可以确保显示模块能够正确初始化并与主控板通信。

总结

通过正确配置SPI接口参数和调整显示驱动设置，可以解决Pwnagotchi项目中Display Hat Mini显示屏的初始化问题。虽然目前按钮功能可能受限，但至少可以确保显示屏正常工作，为后续功能完善奠定了基础。