Hyperpixel 4 Rect. with Raspberry pi Zero 2W install process


I am trying to make a Hyperpixel 4.0 rectangular screen work with a Raspberry Pi Zero 2W. According to the product page on Pimoroni webshop it should work with a RPI Zero W but unsure with a 2W, so maybe that’s why I am not succeeding in making the screen show anything following the 117 method.

All the documentation or support/forum pages I found aren’t clear about the process for installing the drivers for a RPI Zero 2W and if it actually need drivers with new Legacy OS because these pages are often from 2 years ago at least or only concern RPI3/4 or Zero but not Zero 2W…

Any help would be much appreciated,

Thank you very much,


Comments on that thread suggest that others have successfully used it on a Zero 2W, just by adding the appropriate dtoverlay stuff, as per #177.

(one post said they had to “enable GL drivers in raspi-config”, which doesn’t make a whole lot of sense but I guess worth a try?)

Thank you for your reply.

I have tried the 177 method but wonder if I might be doing something wrong as the github page hasn’t been updated since 2022 and the OS suggested can’t be found in others anymore. I tried multiple OS (debian bullseye 32 and 64 bit normal and Lite) and adding the line dtoverlay=vc4-kms-dpi-hyperpixel4 into the /boot/config.txt but in vain… also some threads suggest to comment it out, which makes it even more confusing.

Will look into enabling GL drivers, do you mind sharing any relevant thread you might have found please?

It was further down in that issue.

In theory, it should Just Work with a recent OS (Raspberry Pi OS - bookworm, or Raspberry Pi OS Legacy - bullseye); just add the dtoverlay to config.txt and reboot.

(note that I believe in bookworm config.txt has moved to /boot/firmware/config.txt)

I only mentioned the “enable GL drivers” bit because it was the first mention of it, and there has been a bit of a run of similar posts; makes me wonder if something subtle has changed in the OS, and it’d be nice to work out the currently required magic incantation :)