# Display Hat Mini with Pi Zero 2 W and Latest Raspberry Pi OS - Blank and/or Frozen Display **URL:** \ **Category:** Support\ **Created:** [August 31, 2022, 4:06pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168 "2022-08-31T16:06:44Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![Smeef](https://avatars.discourse-cdn.com/v4/letter/s/bbe5ce/32.png) [@Smeef](https://forums.pimoroni.com/u/Smeef)\ **Post date:** [August 31, 2022, 4:06pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/1 "2022-08-31T16:06:44Z")
I have tried using the directions from: > > > This is ST7789V2 based which is otherwise pretty 1:1 to the other ST7789 boards …except the controller has a 320x240 18-bit RAM region and doesn't need this hack (which confused me until I dived in and added ST7789V2 support): > > https://github.com/juj/fbcp-ili9341/blob/486a32e7f23b41d49b0e9da4845a86709f6f9c8a/st7735r.cpp#L89-L96 > > Supports landscape/portrait orientation. And 0/180 degree rotation. > > Configure: > \`\`\` > mkdir build > cd build > cmake .. -DPIMORONI\_DISPLAY\_HAT\_MINI=ON -DSPI\_BUS\_CLOCK\_DIVISOR=40 -DDISPLAY\_BREAK\_ASPECT\_RATIO\_WHEN\_SCALING=ON -DBACKLIGHT\_CONTROL=ON > \`\`\` > > ⚠️ Make sure you configure with \`-DBACKLIGHT\_CONTROL=ON\` to avoid a black screen (see below) > **[Setting up Pimoroni Display HAT Mini with Raspberry Pi Zero 2 W](https://jackgovier.co.uk/2022/01/20/setting-up-pimoroni-display-hat-mini-with-raspberry-pi-zero-2-w/)** > > I found this process more difficult than I originally expected, so I decided to write down the steps here, either to use again in the future when I inevitably forget how to do it, or in the event s… The Display HAT Mini works for approximately 1 minute then the image freezes and goes black shortly after. During the time that the display is black, if I type or make any mouse movements, the changes show up when I reinitialize the display over SSH using “sudo /home/pi/fbcp-ili9341/build/fbcp-ili9341”. Has anyone else experienced this behavior, knows how to fix it, or has a working SD Card image that I can flash to one of my SD cards? ---
**Author:** ![alphanumeric](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/alphanumeric/32/2729_2.png) [@alphanumeric](https://forums.pimoroni.com/u/alphanumeric)\ **Post date:** [August 31, 2022, 5:11pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/2 "2022-08-31T17:11:40Z")
All that’s needed is to run `sudo pip3 install displayhatmini` [pimoroni/displayhatmini-python: Python library for the Pimoroni Display HAT Mini (github.com)](https://github.com/pimoroni/displayhatmini-python) And test files can be found here. [displayhatmini-python/examples at main · pimoroni/displayhatmini-python (github.com)](https://github.com/pimoroni/displayhatmini-python/tree/main/examples) EDIT: It looks like your trying to use it as the main display? Missed that some how when I first read your post. I haven’t tried to do that myself. I do have that display and have used it to display text info with out any issues. ---
**Author:** ![gragib](https://avatars.discourse-cdn.com/v4/letter/g/f19dbf/32.png) [@gragib](https://forums.pimoroni.com/u/gragib)\ **Post date:** [December 25, 2022, 2:11pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/3 "2022-12-25T14:11:17Z")
Check my notes here: [Pimoroni Display Hat Mini + Raspberry Pi Zero 2W · GitHub](https://gist.github.com/gragib/5c2bd759f1fff258604becd755c0bfef) You may need to install a bunch of things like python3-pygame, python3-numpy and a few other things. ---
**Author:** ![bablokb](https://avatars.discourse-cdn.com/v4/letter/b/ee59a6/32.png) [@bablokb](https://forums.pimoroni.com/u/bablokb)\ **Post date:** [December 27, 2022, 4:31pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/4 "2022-12-27T16:31:06Z")
can you see anything in any logs? BTW: Everybody does copy and paste, but that does not make sense. Don’t start programs from /etc/rc.local. This was already outdated many years before the first iPhone was created. And that is a very long time ago (stone age of computing). If you really want to use that display as your main display, you should start it as early as possible. And rc-local.service is about the last thing a Linux system is starting (and only because of all these legacy-type of stuff which people put there). ---
**Author:** ![Gary.the.Trash.Cat](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/gary.the.trash.cat/32/12199_2.png) [@Gary.the.Trash.Cat](https://forums.pimoroni.com/u/Gary.the.Trash.Cat)\ **Post date:** [May 31, 2026, 9:42pm UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/5 "2026-05-31T21:42:51Z")
Raspberry Pi distros no longer have DispmanX active by default (as stated at `fbcp-ili9341` author’s repo). However, it is still possible to use the display HAT mini with `panel-mipi-dbi` DRM driver. I have an example `config.txt` parameters in [my repo](https://github.com/nimnull/display-hat-mini/tree/main), as well as the Python Slint UI demo, as proof of work. It works perfectly on my Raspberry Pi Zero 2 W. ![IMG_7722.HEIC](https://us1.discourse-cdn.com/flex016/uploads/pimoroni/original/2X/8/81d01831221e0e9cf3d30f3861189029bd620af5.jpeg) ---
**Author:** ![bablokb](https://avatars.discourse-cdn.com/v4/letter/b/ee59a6/32.png) [@bablokb](https://forums.pimoroni.com/u/bablokb)\ **Post date:** [June 1, 2026, 11:02am UTC](https://forums.pimoroni.com/t/display-hat-mini-with-pi-zero-2-w-and-latest-raspberry-pi-os-blank-and-or-frozen-display/20168/6 "2026-06-01T11:02:22Z")
Great repository. I love documentation. And I never heard of Slint but this really seems worth investigating. So thank you for taking the timing and posting this information.