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

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

2025-07-09 21:49:08作者:虞亚竹Luna

问题背景

在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通信速率则影响显示刷新性能。

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

登录后查看全文
热门项目推荐
相关项目推荐